* feat: implement ui/notifications/tool-cancelled throughout SDK Wire the tool-cancelled notification that hosts MUST send when tool execution is cancelled (user action, timeout, classifier intervention, etc.): - Add McpUiToolCancelledNotification type in spec.types.ts - Generate Zod schema via ts-to-zod - Add AppBridge.sendToolCancelled() method for hosts - Add App.ontoolcancelled setter for guest UIs - Export type and schema from types.ts - Add tests for notification with/without reason 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: add App.onteardown handler for graceful shutdown Wire the guest UI side of ui/resource-teardown request: - Add onteardown setter in App class for guest UIs to handle teardown - Allow ui/resource-teardown in assertRequestHandlerCapability - Import McpUiResourceTeardownRequest/Result types - Add tests for sync and async cleanup handlers 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat(example): wire tool-cancelled and teardown in basic-host Update basic-host example to properly use the new notifications: - Send sendToolCancelled when tool call promise rejects - Send sendResourceTeardown when React component unmounts - Store appBridge ref for cleanup access 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix(example): implement graceful teardown per spec recommendation Address review feedback: the host now waits for guest's teardown response before unmounting, following the spec: "Host SHOULD wait for a response before tearing down the resource (to prevent data loss)." Changes: - Add close button to tool call panels - Two-phase unmount: isDestroying state dims panel and disables events - sendResourceTeardown() completes before component removal - Non-app tool results close immediately 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat(examples): add onteardown handlers to demo apps Demonstrate graceful shutdown with simulated 500ms cleanup work. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>
101 lines
3.2 KiB
TypeScript
101 lines
3.2 KiB
TypeScript
/**
|
|
* @file App that demonstrates a few features using MCP Apps SDK with vanilla JS.
|
|
*/
|
|
import { App, PostMessageTransport } from "@modelcontextprotocol/ext-apps";
|
|
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
import "./global.css";
|
|
import "./mcp-app.css";
|
|
|
|
|
|
const log = {
|
|
info: console.log.bind(console, "[APP]"),
|
|
warn: console.warn.bind(console, "[APP]"),
|
|
error: console.error.bind(console, "[APP]"),
|
|
};
|
|
|
|
|
|
function extractTime(result: CallToolResult): string {
|
|
const text = result.content!
|
|
.filter((c): c is { type: "text"; text: string } => c.type === "text")
|
|
.map((c) => c.text)
|
|
.join("");
|
|
const { time } = JSON.parse(text) as { time: string };
|
|
return time;
|
|
}
|
|
|
|
|
|
// Get element references
|
|
const serverTimeEl = document.getElementById("server-time")!;
|
|
const getTimeBtn = document.getElementById("get-time-btn")!;
|
|
const messageText = document.getElementById("message-text") as HTMLTextAreaElement;
|
|
const sendMessageBtn = document.getElementById("send-message-btn")!;
|
|
const logText = document.getElementById("log-text") as HTMLInputElement;
|
|
const sendLogBtn = document.getElementById("send-log-btn")!;
|
|
const linkUrl = document.getElementById("link-url") as HTMLInputElement;
|
|
const openLinkBtn = document.getElementById("open-link-btn")!;
|
|
|
|
|
|
// Create app instance
|
|
const app = new App({ name: "Get Time App", version: "1.0.0" });
|
|
|
|
app.onteardown = async () => {
|
|
log.info("App is being torn down");
|
|
await new Promise((resolve) => setTimeout(resolve, 500)); // Simulate cleanup work
|
|
log.info("App teardown complete");
|
|
return {};
|
|
};
|
|
|
|
// Register handlers BEFORE connecting
|
|
app.ontoolinput = (params) => {
|
|
log.info("Received tool call input:", params);
|
|
};
|
|
|
|
app.ontoolresult = (result) => {
|
|
log.info("Received tool call result:", result);
|
|
serverTimeEl.textContent = extractTime(result);
|
|
};
|
|
|
|
app.onerror = log.error;
|
|
|
|
|
|
// Add event listeners
|
|
getTimeBtn.addEventListener("click", async () => {
|
|
try {
|
|
log.info("Calling get-time tool...");
|
|
const result = await app.callServerTool({ name: "get-time", arguments: {} });
|
|
log.info("get-time result:", result);
|
|
serverTimeEl.textContent = extractTime(result);
|
|
} catch (e) {
|
|
log.error(e);
|
|
serverTimeEl.textContent = "[ERROR]";
|
|
}
|
|
});
|
|
|
|
sendMessageBtn.addEventListener("click", async () => {
|
|
const signal = AbortSignal.timeout(5000);
|
|
try {
|
|
log.info("Sending message text to Host:", messageText.value);
|
|
const { isError } = await app.sendMessage(
|
|
{ role: "user", content: [{ type: "text", text: messageText.value }] },
|
|
{ signal },
|
|
);
|
|
log.info("Message", isError ? "rejected" : "accepted");
|
|
} catch (e) {
|
|
log.error("Message send error:", signal.aborted ? "timed out" : e);
|
|
}
|
|
});
|
|
|
|
sendLogBtn.addEventListener("click", async () => {
|
|
log.info("Sending log text to Host:", logText.value);
|
|
await app.sendLog({ level: "info", data: logText.value });
|
|
});
|
|
|
|
openLinkBtn.addEventListener("click", async () => {
|
|
log.info("Sending open link request to Host:", linkUrl.value);
|
|
const { isError } = await app.sendOpenLink({ url: linkUrl.value });
|
|
log.info("Open link request", isError ? "rejected" : "accepted");
|
|
});
|
|
|
|
|
|
// Connect to host
|
|
app.connect(new PostMessageTransport(window.parent));
|