Align spec terminology to teardown/termination instead of close/clearnup

Author: fredericbarthelet

specification/draft/apps.mdx

@@ -521,30 +521,26 @@ describe("App <-> AppBridge integration", () => {
       ).rejects.toThrow("Context update failed");
     });
 
-    it("app.requestClose allows host to initiate teardown flow", async () => {
+    it("app.requestTeardown allows host to initiate teardown flow", async () => {
       const events: string[] = [];
 
-      // Host handles close request by initiating teardown
-      bridge.onrequestclose = async () => {
-        events.push("close-requested");
-        // Host decides to proceed with close - initiate teardown
+      bridge.onrequestteardown = async () => {
+        events.push("teardown-requested");
         await bridge.teardownResource({});
         events.push("teardown-complete");
       };
 
-      // App handles teardown (cleanup before unmount)
       app.onteardown = async () => {
         events.push("app-cleanup");
         return {};
       };
 
       await app.connect(appTransport);
-      await app.requestClose();
+      await app.requestTeardown();
       await flush();
 
-      // Verify the full flow: request → teardown → cleanup
       expect(events).toEqual([
-        "close-requested",
+        "teardown-requested",
         "app-cleanup",
         "teardown-complete",
       ]);

src/app-bridge.test.ts

@@ -74,8 +74,8 @@ import {
   McpUiDownloadFileResult,
   McpUiResourceTeardownRequest,
   McpUiResourceTeardownResultSchema,
-  McpUiRequestCloseNotification,
-  McpUiRequestCloseNotificationSchema,
+  McpUiRequestTeardownNotification,
+  McpUiRequestTeardownNotificationSchema,
   McpUiSandboxProxyReadyNotification,
   McpUiSandboxProxyReadyNotificationSchema,
   McpUiSizeChangedNotificationSchema,
@@ -676,20 +676,20 @@ export class AppBridge extends Protocol<
   }
 
   /**
-   * Register a handler for app-initiated close request notifications from the view.
+   * Register a handler for app-initiated teardown request notifications from the view.
    *
-   * The view sends `ui/notifications/request-close` when it wants the host to close it.
-   * If the host decides to proceed with the close, it should send
+   * The view sends `ui/notifications/request-teardown` when it wants the host to tear it down.
+   * If the host decides to proceed, it should send
    * `ui/resource-teardown` (via {@link teardownResource `teardownResource`}) to allow
    * the view to perform cleanup, then unmount the iframe after the view responds.
    *
-   * @param callback - Handler that receives close request params
+   * @param callback - Handler that receives teardown request params
    *   - params - Empty object (reserved for future use)
    *
    * @example
    * ```typescript
-   * bridge.onrequestclose = async (params) => {
-   *   console.log("App requested close");
+   * bridge.onrequestteardown = async (params) => {
+   *   console.log("App requested teardown");
    *   // Initiate teardown to allow the app to clean up
    *   // Alternatively, the callback can early return to prevent teardown
    *   await bridge.teardownResource({});
@@ -698,14 +698,14 @@ export class AppBridge extends Protocol<
    * };
    * ```
    *
-   * @see {@link McpUiRequestCloseNotification `McpUiRequestCloseNotification`} for the notification type
+   * @see {@link McpUiRequestTeardownNotification `McpUiRequestTeardownNotification`} for the notification type
    * @see {@link teardownResource `teardownResource`} for initiating teardown
    */
-  set onrequestclose(
-    callback: (params: McpUiRequestCloseNotification["params"]) => void,
+  set onrequestteardown(
+    callback: (params: McpUiRequestTeardownNotification["params"]) => void,
   ) {
     this.setNotificationHandler(
-      McpUiRequestCloseNotificationSchema,
+      McpUiRequestTeardownNotificationSchema,
       (request) => callback(request.params),
     );
   }

src/app-bridge.ts

@@ -44,7 +44,7 @@ import {
   McpUiResourceTeardownRequest,
   McpUiResourceTeardownRequestSchema,
   McpUiResourceTeardownResult,
-  McpUiRequestCloseNotification,
+  McpUiRequestTeardownNotification,
   McpUiSizeChangedNotification,
   McpUiToolCancelledNotification,
   McpUiToolCancelledNotificationSchema,
@@ -1136,45 +1136,45 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
   }
 
   /**
-   * Request the host to close this app.
+   * Request the host to tear down this app.
    *
-   * Apps call this method to request that the host close them. The host decides
-   * whether to proceed with the close - if approved, the host will send
+   * Apps call this method to request that the host tear them down. The host
+   * decides whether to proceed - if approved, the host will send
    * `ui/resource-teardown` to allow the app to perform cleanup before being
    * unmounted. This piggybacks on the existing teardown mechanism, ensuring
    * the app only needs a single shutdown procedure (via {@link onteardown `onteardown`})
-   * regardless of whether the close was initiated by the app or the host.
+   * regardless of whether the teardown was initiated by the app or the host.
    *
    * This is a fire-and-forget notification - no response is expected.
-   * If the host approves the close, the app will receive a `ui/resource-teardown`
+   * If the host approves, the app will receive a `ui/resource-teardown`
    * request via the {@link onteardown `onteardown`} handler to perform cleanup.
    *
    * @param params - Empty params object (reserved for future use)
    * @returns Promise that resolves when the notification is sent
    *
-   * @example App-initiated close after user action
+   * @example App-initiated teardown after user action
    * ```typescript
    * // User clicks "Done" button in the app
    * async function handleDoneClick() {
-   *   // Request the host to close the app
-   *   await app.requestClose();
+   *   // Request the host to tear down the app
+   *   await app.requestTeardown();
    *   // If host approves, onteardown handler will be called for cleanup
    * }
    *
-   * // Set up teardown handler (called for both app-initiated and host-initiated close)
+   * // Set up teardown handler (called for both app-initiated and host-initiated teardown)
    * app.onteardown = async () => {
    *   await saveState();
    *   closeConnections();
    *   return {};
    * };
    * ```
    *
-   * @see {@link McpUiRequestCloseNotification `McpUiRequestCloseNotification`} for notification structure
+   * @see {@link McpUiRequestTeardownNotification `McpUiRequestTeardownNotification`} for notification structure
    * @see {@link onteardown `onteardown`} for the cleanup handler
    */
-  requestClose(params: McpUiRequestCloseNotification["params"] = {}) {
-    return this.notification(<McpUiRequestCloseNotification>{
-      method: "ui/notifications/request-close",
+  requestTeardown(params: McpUiRequestTeardownNotification["params"] = {}) {
+    return this.notification(<McpUiRequestTeardownNotification>{
+      method: "ui/notifications/request-teardown",
       params,
     });
   }

src/app.ts

@@ -475,15 +475,15 @@ export interface McpUiSupportedContentBlockModalities {
 }
 
 /**
- * @description Notification for app-initiated close request (View -> Host).
- * Views send this to request that the host close them. The host decides
- * whether to proceed with the close - if approved, the host will send
+ * @description Notification for app-initiated teardown request (View -> Host).
+ * Views send this to request that the host tear them down. The host decides
+ * whether to proceed - if approved, the host will send
  * `ui/resource-teardown` to allow the view to perform cleanup before being
  * unmounted.
- * @see {@link app.App.requestClose} for the app method that sends this
+ * @see {@link app.App.requestTeardown} for the app method that sends this
  */
-export interface McpUiRequestCloseNotification {
-  method: "ui/notifications/request-close";
+export interface McpUiRequestTeardownNotification {
+  method: "ui/notifications/request-teardown";
   params?: {};
 }
 
@@ -813,8 +813,8 @@ export const TOOL_CANCELLED_METHOD: McpUiToolCancelledNotification["method"] =
   "ui/notifications/tool-cancelled";
 export const HOST_CONTEXT_CHANGED_METHOD: McpUiHostContextChangedNotification["method"] =
   "ui/notifications/host-context-changed";
-export const REQUEST_CLOSE_METHOD: McpUiRequestCloseNotification["method"] =
-  "ui/notifications/request-close";
+export const REQUEST_TEARDOWN_METHOD: McpUiRequestTeardownNotification["method"] =
+  "ui/notifications/request-teardown";
 export const RESOURCE_TEARDOWN_METHOD: McpUiResourceTeardownRequest["method"] =
   "ui/resource-teardown";
 export const INITIALIZE_METHOD: McpUiInitializeRequest["method"] =

src/generated/schema.json

@@ -23,7 +23,7 @@ export {
   TOOL_RESULT_METHOD,
   TOOL_CANCELLED_METHOD,
   HOST_CONTEXT_CHANGED_METHOD,
-  REQUEST_CLOSE_METHOD,
+  REQUEST_TEARDOWN_METHOD,
   RESOURCE_TEARDOWN_METHOD,
   INITIALIZE_METHOD,
   INITIALIZED_METHOD,
@@ -53,7 +53,7 @@ export {
   type McpUiHostContextChangedNotification,
   type McpUiResourceTeardownRequest,
   type McpUiResourceTeardownResult,
-  type McpUiRequestCloseNotification,
+  type McpUiRequestTeardownNotification,
   type McpUiHostCapabilities,
   type McpUiAppCapabilities,
   type McpUiInitializeRequest,
@@ -87,7 +87,7 @@ import type {
   McpUiInitializedNotification,
   McpUiSizeChangedNotification,
   McpUiSandboxProxyReadyNotification,
-  McpUiRequestCloseNotification,
+  McpUiRequestTeardownNotification,
   McpUiInitializeResult,
   McpUiOpenLinkResult,
   McpUiDownloadFileResult,
@@ -121,7 +121,7 @@ export {
   McpUiHostContextChangedNotificationSchema,
   McpUiResourceTeardownRequestSchema,
   McpUiResourceTeardownResultSchema,
-  McpUiRequestCloseNotificationSchema,
+  McpUiRequestTeardownNotificationSchema,
   McpUiHostCapabilitiesSchema,
   McpUiAppCapabilitiesSchema,
   McpUiInitializeRequestSchema,
@@ -193,7 +193,7 @@ export type AppRequest =
  * - Sandbox resource ready
  *
  * App to host:
- * - Initialized, size-changed, sandbox-proxy-ready, request-close
+ * - Initialized, size-changed, sandbox-proxy-ready, request-teardown
  * - Logging messages
  */
 export type AppNotification =
@@ -211,7 +211,7 @@ export type AppNotification =
   | McpUiInitializedNotification
   | McpUiSizeChangedNotification
   | McpUiSandboxProxyReadyNotification
-  | McpUiRequestCloseNotification
+  | McpUiRequestTeardownNotification
   | LoggingMessageNotification;
 
 /**