refactor: rename request methods to remove send prefix (#161)

* refactor: rename request methods to remove send prefix

Following the MCP TS SDK convention where request methods don't have
the "send" prefix (reserved for notifications):

- App.sendMessage() → App.message()
- App.sendOpenLink() → App.openLink()
- AppBridge.sendResourceTeardown() → AppBridge.resourceTeardown()

The old method names are kept as deprecated aliases for backwards
compatibility.

Updated all examples to use the new method names.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* test: add tests for deprecated method aliases

- Update existing tests to use new method names (message, openLink)
- Add tests verifying deprecated aliases are same reference as new methods
- Add tests verifying deprecated aliases still work functionally

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* refactor: rename message→sendMessage, resourceTeardown→teardownResource

- App.message() → App.sendMessage() (with deprecated message alias)
- AppBridge.resourceTeardown() → AppBridge.teardownResource() (with deprecated aliases)

This better follows the pattern where methods that send data have 'send' or action verb prefix.

* fix: update examples to use sendMessage instead of message

* fix: update basic-host to use teardownResource

* fix: update threejs-server to use sendMessage

* refactor: remove deprecated app.message alias

The app.message alias was removed since sendMessage is the correct name.
sendResourceTeardown already exists in AppBridge.

* refactor: remove resourceTeardown alias, keep only sendResourceTeardown

---------

Co-authored-by: Claude <[email protected]>

Author: ochafik

examples/basic-host/src/index.tsx

@@ -289,7 +289,7 @@ function AppIFramePanel({ toolCallInfo, isDestroying, onTeardownComplete }: AppI
     }
 
     log.info("Sending teardown notification to MCP App");
-    appBridgeRef.current.sendResourceTeardown({})
+    appBridgeRef.current.teardownResource({})
       .catch((err) => {
         log.warn("Teardown request failed (app may have already closed):", err);
       })

examples/basic-server-react/README.md

@@ -9,7 +9,7 @@ An MCP App example with a React UI.
 
 - Tool registration with a linked UI resource
 - React UI using the [`useApp()`](https://modelcontextprotocol.github.io/ext-apps/api/functions/_modelcontextprotocol_ext-apps_react.useApp.html) hook
-- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`sendMessage`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendmessage), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`sendOpenLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendopenlink)
+- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`sendMessage`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendmessage), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`openLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#openlink)
 
 ## Key Files
 

examples/basic-server-react/src/mcp-app.tsx

@@ -110,7 +110,7 @@ function GetTimeAppInner({ app, toolResult }: GetTimeAppInnerProps) {
 
   const handleOpenLink = useCallback(async () => {
     log.info("Sending open link request to Host:", linkUrl);
-    const { isError } = await app.sendOpenLink({ url: linkUrl });
+    const { isError } = await app.openLink({ url: linkUrl });
     log.info("Open link request", isError ? "rejected" : "accepted");
   }, [app, linkUrl]);
 

examples/basic-server-vanillajs/README.md

@@ -9,7 +9,7 @@ An MCP App example with a vanilla JavaScript UI (no framework).
 
 - Tool registration with a linked UI resource
 - Vanilla JS UI using the [`App`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html) class directly
-- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`sendMessage`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendmessage), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`sendOpenLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendopenlink)
+- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`sendMessage`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendmessage), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`openLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#openlink)
 
 ## Key Files
 

examples/basic-server-vanillajs/src/mcp-app.ts

@@ -92,7 +92,7 @@ sendLogBtn.addEventListener("click", async () => {
 
 openLinkBtn.addEventListener("click", async () => {
   log.info("Sending open link request to Host:", linkUrl.value);
-  const { isError } = await app.sendOpenLink({ url: linkUrl.value });
+  const { isError } = await app.openLink({ url: linkUrl.value });
   log.info("Open link request", isError ? "rejected" : "accepted");
 });
 

examples/threejs-server/src/mcp-app-wrapper.tsx

@@ -32,7 +32,7 @@ export interface WidgetProps<TToolInput = Record<string, unknown>> {
   /** Send a message to the host's chat */
   sendMessage: App["sendMessage"];
   /** Request the host to open a URL */
-  sendOpenLink: App["sendOpenLink"];
+  openLink: App["openLink"];
   /** Send log messages to the host */
   sendLog: App["sendLog"];
 }
@@ -81,8 +81,8 @@ function McpAppWrapper() {
     (params, options) => app!.sendMessage(params, options),
     [app],
   );
-  const sendOpenLink = useCallback<App["sendOpenLink"]>(
-    (params, options) => app!.sendOpenLink(params, options),
+  const openLink = useCallback<App["openLink"]>(
+    (params, options) => app!.openLink(params, options),
     [app],
   );
   const sendLog = useCallback<App["sendLog"]>(
@@ -106,7 +106,7 @@ function McpAppWrapper() {
       hostContext={hostContext}
       callServerTool={callServerTool}
       sendMessage={sendMessage}
-      sendOpenLink={sendOpenLink}
+      openLink={openLink}
       sendLog={sendLog}
     />
   );

examples/threejs-server/src/threejs-app.tsx

@@ -143,7 +143,7 @@ export default function ThreeJSApp({
   hostContext: _hostContext,
   callServerTool: _callServerTool,
   sendMessage: _sendMessage,
-  sendOpenLink: _sendOpenLink,
+  openLink: _openLink,
   sendLog: _sendLog,
 }: ThreeJSAppProps) {
   const [error, setError] = useState<string | null>(null);

examples/wiki-explorer-server/src/mcp-app.ts

@@ -270,7 +270,7 @@ resetBtn.addEventListener("click", async () => {
 // Open button - opens the Wikipedia page in browser
 openBtn.addEventListener("click", async () => {
   if (selectedNodeUrl) {
-    await app.sendOpenLink({ url: selectedNodeUrl });
+    await app.openLink({ url: selectedNodeUrl });
     hidePopup();
   }
 });

src/app-bridge.test.ts

@@ -373,20 +373,20 @@ describe("App <-> AppBridge integration", () => {
       await newBridgeTransport.close();
     });
 
-    it("sendResourceTeardown triggers app.onteardown", async () => {
+    it("teardownResource triggers app.onteardown", async () => {
       let teardownCalled = false;
       app.onteardown = async () => {
         teardownCalled = true;
         return {};
       };
 
       await app.connect(appTransport);
-      await bridge.sendResourceTeardown({});
+      await bridge.teardownResource({});
 
       expect(teardownCalled).toBe(true);
     });
 
-    it("sendResourceTeardown waits for async cleanup", async () => {
+    it("teardownResource waits for async cleanup", async () => {
       const cleanupSteps: string[] = [];
       app.onteardown = async () => {
         cleanupSteps.push("start");
@@ -396,7 +396,7 @@ describe("App <-> AppBridge integration", () => {
       };
 
       await app.connect(appTransport);
-      await bridge.sendResourceTeardown({});
+      await bridge.teardownResource({});
 
       expect(cleanupSteps).toEqual(["start", "done"]);
     });
@@ -481,32 +481,59 @@ describe("App <-> AppBridge integration", () => {
       expect(result.isError).toBe(true);
     });
 
-    it("app.sendOpenLink triggers bridge.onopenlink and returns result", async () => {
+    it("app.openLink triggers bridge.onopenlink and returns result", async () => {
       const receivedLinks: string[] = [];
       bridge.onopenlink = async (params) => {
         receivedLinks.push(params.url);
         return {};
       };
 
       await app.connect(appTransport);
-      const result = await app.sendOpenLink({ url: "https://example.com" });
+      const result = await app.openLink({ url: "https://example.com" });
 
       expect(receivedLinks).toEqual(["https://example.com"]);
       expect(result).toEqual({});
     });
 
-    it("app.sendOpenLink returns error when host denies", async () => {
+    it("app.openLink returns error when host denies", async () => {
       bridge.onopenlink = async () => {
         return { isError: true };
       };
 
       await app.connect(appTransport);
-      const result = await app.sendOpenLink({ url: "https://blocked.com" });
+      const result = await app.openLink({ url: "https://blocked.com" });
 
       expect(result.isError).toBe(true);
     });
   });
 
+  describe("deprecated method aliases", () => {
+    beforeEach(async () => {
+      await bridge.connect(bridgeTransport);
+      await app.connect(appTransport);
+    });
+
+    it("app.sendOpenLink is an alias for app.openLink", async () => {
+      expect(app.sendOpenLink).toBe(app.openLink);
+    });
+
+    it("bridge.sendResourceTeardown is a deprecated alias for bridge.teardownResource", () => {
+      expect(bridge.sendResourceTeardown).toBe(bridge.teardownResource);
+    });
+
+    it("app.sendOpenLink works as deprecated alias", async () => {
+      const receivedLinks: string[] = [];
+      bridge.onopenlink = async (params) => {
+        receivedLinks.push(params.url);
+        return {};
+      };
+
+      await app.sendOpenLink({ url: "https://example.com" });
+
+      expect(receivedLinks).toEqual(["https://example.com"]);
+    });
+  });
+
   describe("ping", () => {
     it("App responds to ping from bridge", async () => {
       await bridge.connect(bridgeTransport);

src/app-bridge.ts

@@ -176,7 +176,7 @@ type RequestHandlerExtra = Parameters<
  * 2. **Connect**: Call `connect()` with transport to establish communication
  * 3. **Wait for init**: Guest UI sends initialize request, bridge responds
  * 4. **Send data**: Call `sendToolInput()`, `sendToolResult()`, etc.
- * 5. **Teardown**: Call `sendResourceTeardown()` before unmounting iframe
+ * 5. **Teardown**: Call `teardownResource()` before unmounting iframe
  *
  * @example Basic usage
  * ```typescript
@@ -1219,15 +1219,15 @@ export class AppBridge extends Protocol<
    * @example
    * ```typescript
    * try {
-   *   await bridge.sendResourceTeardown({});
+   *   await bridge.teardownResource({});
    *   // Guest UI is ready, safe to unmount iframe
    *   iframe.remove();
    * } catch (error) {
    *   console.error("Teardown failed:", error);
    * }
    * ```
    */
-  sendResourceTeardown(
+  teardownResource(
     params: McpUiResourceTeardownRequest["params"],
     options?: RequestOptions,
   ) {
@@ -1241,6 +1241,9 @@ export class AppBridge extends Protocol<
     );
   }
 
+  /** @deprecated Use {@link teardownResource} instead */
+  sendResourceTeardown: AppBridge["teardownResource"] = this.teardownResource;
+
   /**
    * Connect to the Guest UI via transport and optionally set up message forwarding.
    *