@blade-hq/agent-react 2612.0.0-beta.8 → 2612.0.0-beta.80

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/app.examples.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type-checked examples for {@link App `App`} and constants in {@link ./app.ts `app.ts`}.
+ *
+ * These examples are included in the API documentation via `@includeCode` tags.
+ * Each function's region markers define the code snippet that appears in the docs.
+ *
+ * @module
+ */
+export {};

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/app.js

@@ -0,0 +1,39 @@
+import{Protocol as gQ}from"@modelcontextprotocol/client";import{EmptyResultSchema as vQ}from"@modelcontextprotocol/core";var n="ui/resourceUri",o="text/html;profile=mcp-app";class L{_eventSlots=new Map;setHandler(X,Y){let Z=this._ensureEventSlot(X);if(Z.onHandler&&Y)console.warn(`[MCP Apps] on${String(X)} handler replaced. Use addEventListener("${String(X)}", …) to add multiple listeners without replacing.`);Z.onHandler=Y}getHandler(X){return this._eventSlots.get(X)?.onHandler}addEventListener(X,Y){this._ensureEventSlot(X).listeners.push(Y)}removeEventListener(X,Y){let Z=this._eventSlots.get(X);if(!Z)return;let $=Z.listeners.indexOf(Y);if($!==-1)Z.listeners.splice($,1)}dispatch(X,Y){let Z=this._eventSlots.get(X);if(!Z)return;Z.onHandler?.(Y);for(let $ of[...Z.listeners])$(Y)}_ensureEventSlot(X){let Y=this._eventSlots.get(X);if(!Y)Y={listeners:[]},this._eventSlots.set(X,Y);return Y}}class _{_methods=new Set;claim(X,Y){if(this._methods.has(X))throw Error(`Handler for "${X}" already registered (via ${Y}). Use addEventListener() to attach multiple listeners, or the on* setter for replace semantics.`);this._methods.add(X)}replace(X){this._methods.add(X)}release(X){this._methods.delete(X)}has(X){return this._methods.has(X)}}var f=new Set;function O(X,Y){let[Z,$]=Y,D=Z?.shape;if(typeof D?.method?.value!=="string")return;let K=D.method.value,W=X==="request"?"setRequestHandler":"setNotificationHandler";if(!f.has(W))f.add(W),console.warn(`[ext-apps] ${W}(Schema, handler) is deprecated; use ${W}("${K}", { params: Schema.shape.params }, handler).`);let G=$;return[K,{params:D.params},X==="request"?(J,N)=>G({method:K,params:J},a(N)):(J)=>G({method:K,params:J})]}function a(X){return{signal:X.mcpReq.signal,requestId:X.mcpReq.id,sessionId:X.sessionId,_meta:X.mcpReq._meta,sendRequest:X.mcpReq.send,sendNotification:X.mcpReq.notify,authInfo:X.http?.authInfo}}import{JSONRPCMessageSchema as LQ}from"@modelcontextprotocol/core";var E="2026-01-26",s="ui/open-link",t="ui/download-file",e="ui/message",QQ="ui/notifications/sandbox-proxy-ready",XQ="ui/notifications/sandbox-resource-ready",YQ="ui/notifications/size-changed",ZQ="ui/notifications/tool-input",q="ui/notifications/tool-input-partial",$Q="ui/notifications/tool-result",DQ="ui/notifications/tool-cancelled",KQ="ui/notifications/host-context-changed",WQ="ui/notifications/request-teardown",GQ="ui/resource-teardown",JQ="ui/initialize",NQ="ui/notifications/initialized",VQ="ui/request-display-mode";class j{eventTarget;eventSource;messageListener;constructor(X=window.parent,Y){this.eventTarget=X;this.eventSource=Y;this.messageListener=(Z)=>{if(Y&&Z.source!==this.eventSource){console.debug("Ignoring message from unknown source",Z);return}let $=LQ.safeParse(Z.data);if($.success)console.debug("Parsed message",$.data),this.onmessage?.($.data);else if(Z.data?.jsonrpc!=="2.0")console.debug("Ignoring non-JSON-RPC message",$.error.message,Z);else console.error("Failed to parse message",$.error.message,Z),this.onerror?.(Error("Invalid JSON-RPC message received: "+$.error.message))}}async start(){window.addEventListener("message",this.messageListener)}async send(X,Y){if(X.method!==q)console.debug("Sending message",X);this.eventTarget.postMessage(X,"*")}async close(){window.removeEventListener("message",this.messageListener),this.onclose?.()}onclose;onerror;onmessage;sessionId;setProtocolVersion}import{z as Q}from"zod/v4";import{ContentBlockSchema as g,CallToolResultSchema as jQ,EmbeddedResourceSchema as zQ,ImplementationSchema as v,RequestIdSchema as BQ,ResourceLinkSchema as _Q,ToolSchema as OQ}from"@modelcontextprotocol/core";var d=Q.union([Q.literal("light"),Q.literal("dark")]).describe("Color theme preference for the host environment."),V=Q.union([Q.literal("inline"),Q.literal("fullscreen"),Q.literal("pip")]).describe("Display mode for UI presentation."),EQ=Q.union([Q.literal("--color-background-primary"),Q.literal("--color-background-secondary"),Q.literal("--color-background-tertiary"),Q.literal("--color-background-inverse"),Q.literal("--color-background-ghost"),Q.literal("--color-background-info"),Q.literal("--color-background-danger"),Q.literal("--color-background-success"),Q.literal("--color-background-warning"),Q.literal("--color-background-disabled"),Q.literal("--color-text-primary"),Q.literal("--color-text-secondary"),Q.literal("--color-text-tertiary"),Q.literal("--color-text-inverse"),Q.literal("--color-text-ghost"),Q.literal("--color-text-info"),Q.literal("--color-text-danger"),Q.literal("--color-text-success"),Q.literal("--color-text-warning"),Q.literal("--color-text-disabled"),Q.literal("--color-border-primary"),Q.literal("--color-border-secondary"),Q.literal("--color-border-tertiary"),Q.literal("--color-border-inverse"),Q.literal("--color-border-ghost"),Q.literal("--color-border-info"),Q.literal("--color-border-danger"),Q.literal("--color-border-success"),Q.literal("--color-border-warning"),Q.literal("--color-border-disabled"),Q.literal("--color-ring-primary"),Q.literal("--color-ring-secondary"),Q.literal("--color-ring-inverse"),Q.literal("--color-ring-info"),Q.literal("--color-ring-danger"),Q.literal("--color-ring-success"),Q.literal("--color-ring-warning"),Q.literal("--font-sans"),Q.literal("--font-mono"),Q.literal("--font-weight-normal"),Q.literal("--font-weight-medium"),Q.literal("--font-weight-semibold"),Q.literal("--font-weight-bold"),Q.literal("--font-text-xs-size"),Q.literal("--font-text-sm-size"),Q.literal("--font-text-md-size"),Q.literal("--font-text-lg-size"),Q.literal("--font-heading-xs-size"),Q.literal("--font-heading-sm-size"),Q.literal("--font-heading-md-size"),Q.literal("--font-heading-lg-size"),Q.literal("--font-heading-xl-size"),Q.literal("--font-heading-2xl-size"),Q.literal("--font-heading-3xl-size"),Q.literal("--font-text-xs-line-height"),Q.literal("--font-text-sm-line-height"),Q.literal("--font-text-md-line-height"),Q.literal("--font-text-lg-line-height"),Q.literal("--font-heading-xs-line-height"),Q.literal("--font-heading-sm-line-height"),Q.literal("--font-heading-md-line-height"),Q.literal("--font-heading-lg-line-height"),Q.literal("--font-heading-xl-line-height"),Q.literal("--font-heading-2xl-line-height"),Q.literal("--font-heading-3xl-line-height"),Q.literal("--border-radius-xs"),Q.literal("--border-radius-sm"),Q.literal("--border-radius-md"),Q.literal("--border-radius-lg"),Q.literal("--border-radius-xl"),Q.literal("--border-radius-full"),Q.literal("--border-width-regular"),Q.literal("--shadow-hairline"),Q.literal("--shadow-sm"),Q.literal("--shadow-md"),Q.literal("--shadow-lg")]).describe("CSS variable keys available to MCP apps for theming."),qQ=Q.record(EQ.describe(`Style variables for theming MCP apps.
+
+Individual style keys are optional - hosts may provide any subset of these values.
+Values are strings containing CSS values (colors, sizes, font stacks, etc.).
+
+Note: This type uses \`Record<K, string | undefined>\` rather than \`Partial<Record<K, string>>\`
+for compatibility with Zod schema generation. Both are functionally equivalent for validation.`),Q.union([Q.string(),Q.undefined()]).describe(`Style variables for theming MCP apps.
+
+Individual style keys are optional - hosts may provide any subset of these values.
+Values are strings containing CSS values (colors, sizes, font stacks, etc.).
+
+Note: This type uses \`Record<K, string | undefined>\` rather than \`Partial<Record<K, string>>\`
+for compatibility with Zod schema generation. Both are functionally equivalent for validation.`)).describe(`Style variables for theming MCP apps.
+
+Individual style keys are optional - hosts may provide any subset of these values.
+Values are strings containing CSS values (colors, sizes, font stacks, etc.).
+
+Note: This type uses \`Record<K, string | undefined>\` rather than \`Partial<Record<K, string>>\`
+for compatibility with Zod schema generation. Both are functionally equivalent for validation.`),FQ=Q.object({method:Q.literal("ui/open-link"),params:Q.object({url:Q.string().describe("URL to open in the host's browser")})}),I=Q.object({isError:Q.boolean().optional().describe("True if the host failed to open the URL (e.g., due to security policy).")}).passthrough(),P=Q.object({isError:Q.boolean().optional().describe("True if the download failed (e.g., user cancelled or host denied).")}).passthrough(),R=Q.object({isError:Q.boolean().optional().describe("True if the host rejected or failed to deliver the message.")}).passthrough(),IQ=Q.object({method:Q.literal("ui/notifications/sandbox-proxy-ready"),params:Q.object({})}),z=Q.object({connectDomains:Q.array(Q.string()).optional().describe(`Origins for network requests (fetch/XHR/WebSocket).
+
+- Maps to CSP \`connect-src\` directive
+- Empty or omitted → no network connections (secure default)`),resourceDomains:Q.array(Q.string()).optional().describe("Origins for static resources (images, scripts, stylesheets, fonts, media).\n\n- Maps to CSP `img-src`, `script-src`, `style-src`, `font-src`, `media-src` directives\n- Wildcard subdomains supported: `https://*.example.com`\n- Empty or omitted → no network resources (secure default)"),frameDomains:Q.array(Q.string()).optional().describe("Origins for nested iframes.\n\n- Maps to CSP `frame-src` directive\n- Empty or omitted → no nested iframes allowed (`frame-src 'none'`)"),baseUriDomains:Q.array(Q.string()).optional().describe("Allowed base URIs for the document.\n\n- Maps to CSP `base-uri` directive\n- Empty or omitted → only same origin allowed (`base-uri 'self'`)")}),B=Q.object({camera:Q.object({}).optional().describe("Request camera access.\n\nMaps to Permission Policy `camera` feature."),microphone:Q.object({}).optional().describe("Request microphone access.\n\nMaps to Permission Policy `microphone` feature."),geolocation:Q.object({}).optional().describe("Request geolocation access.\n\nMaps to Permission Policy `geolocation` feature."),clipboardWrite:Q.object({}).optional().describe("Request clipboard write access.\n\nMaps to Permission Policy `clipboard-write` feature.")}),PQ=Q.object({method:Q.literal("ui/notifications/size-changed"),params:Q.object({width:Q.number().optional().describe("New width in pixels."),height:Q.number().optional().describe("New height in pixels.")})}),w=Q.object({method:Q.literal("ui/notifications/tool-input"),params:Q.object({arguments:Q.record(Q.string(),Q.unknown().describe("Complete tool call arguments as key-value pairs.")).optional().describe("Complete tool call arguments as key-value pairs.")})}),A=Q.object({method:Q.literal("ui/notifications/tool-input-partial"),params:Q.object({arguments:Q.record(Q.string(),Q.unknown().describe("Partial tool call arguments (incomplete, may change).")).optional().describe("Partial tool call arguments (incomplete, may change).")})}),H=Q.object({method:Q.literal("ui/notifications/tool-cancelled"),params:Q.object({reason:Q.string().optional().describe('Optional reason for the cancellation (e.g., "user action", "timeout").')})}),h=Q.object({fonts:Q.string().optional()}),m=Q.object({variables:qQ.optional().describe("CSS variables for theming the app."),css:h.optional().describe("CSS blocks that apps can inject.")}),U=Q.object({method:Q.literal("ui/resource-teardown"),params:Q.object({})}),T=Q.record(Q.string(),Q.unknown()),F=Q.object({text:Q.object({}).optional().describe("Host supports text content blocks."),image:Q.object({}).optional().describe("Host supports image content blocks."),audio:Q.object({}).optional().describe("Host supports audio content blocks."),resource:Q.object({}).optional().describe("Host supports resource content blocks."),resourceLink:Q.object({}).optional().describe("Host supports resource link content blocks."),structuredContent:Q.object({}).optional().describe("Host supports structured content.")}),RQ=Q.object({method:Q.literal("ui/notifications/request-teardown"),params:Q.object({}).optional()}),c=Q.object({experimental:Q.record(Q.string(),Q.record(Q.string(),Q.any()).describe("Experimental features keyed by identifier.")).optional().describe("Experimental features keyed by identifier."),openLinks:Q.object({}).optional().describe("Host supports opening external URLs."),downloadFile:Q.object({}).optional().describe("Host supports file downloads via ui/download-file."),serverTools:Q.object({listChanged:Q.boolean().optional().describe("Host supports tools/list_changed notifications.")}).optional().describe("Host can proxy tool calls to the MCP server."),serverResources:Q.object({listChanged:Q.boolean().optional().describe("Host supports resources/list_changed notifications.")}).optional().describe("Host can proxy resource reads to the MCP server."),logging:Q.object({}).optional().describe("Host accepts log messages."),sandbox:Q.object({permissions:B.optional().describe("Permissions granted by the host (camera, microphone, geolocation)."),csp:z.optional().describe("CSP domains approved by the host.")}).optional().describe("Sandbox configuration applied by the host."),updateModelContext:F.optional().describe("Host accepts context updates (ui/update-model-context) to be included in the model's context for future turns."),message:F.optional().describe("Host supports receiving content messages (ui/message) from the view."),sampling:Q.object({tools:Q.object({}).optional().describe("Host supports tool use via `tools` and `toolChoice` parameters.")}).optional().describe("Host supports LLM sampling (sampling/createMessage) from the view.\nMirrors the MCP `ClientCapabilities.sampling` shape so hosts can pass it through.")}),p=Q.object({experimental:Q.record(Q.string(),Q.record(Q.string(),Q.any()).describe("Experimental features keyed by identifier.")).optional().describe("Experimental features keyed by identifier."),tools:Q.object({listChanged:Q.boolean().optional().describe("App supports tools/list_changed notifications.")}).optional().describe("App exposes MCP-style tools that the host can call."),availableDisplayModes:Q.array(V).optional().describe("Display modes the app supports.")}),wQ=Q.object({method:Q.literal("ui/notifications/initialized"),params:Q.object({}).optional()}),AQ=Q.object({csp:z.optional().describe("Content Security Policy configuration for UI resources."),permissions:B.optional().describe("Sandbox permissions requested by the UI resource."),domain:Q.string().optional().describe(`Dedicated origin for view sandbox.
+
+Useful when views need stable, dedicated origins for OAuth callbacks, CORS policies, or API key allowlists.
+
+**Host-dependent:** The format and validation rules for this field are determined by each host. Servers MUST consult host-specific documentation for the expected domain format. Common patterns include:
+- Hash-based subdomains (e.g., \`{hash}.claudemcpcontent.com\`)
+- URL-derived subdomains (e.g., \`www-example-com.oaiusercontent.com\`)
+
+If omitted, host uses default sandbox origin (typically per-conversation).`),prefersBorder:Q.boolean().optional().describe(`Visual boundary preference - true if view prefers a visible border.
+
+Boolean requesting whether a visible border and background is provided by the host. Specifying an explicit value for this is recommended because hosts' defaults may vary.
+
+- \`true\`: request visible border + background
+- \`false\`: request no visible border + background
+- omitted: host decides border`)}),HQ=Q.object({method:Q.literal("ui/request-display-mode"),params:Q.object({mode:V.describe("The display mode being requested.")})}),C=Q.object({mode:V.describe("The display mode that was actually set. May differ from requested if not supported.")}).passthrough(),i=Q.union([Q.literal("model"),Q.literal("app")]).describe("Tool visibility scope - who can access the tool."),UQ=Q.object({resourceUri:Q.string().optional(),visibility:Q.array(i).optional().describe(`Who can access this tool. Default: ["model", "app"]
+- "model": Tool visible to and callable by the agent
+- "app": Tool callable by the app from this server only`),csp:Q.never().optional(),permissions:Q.never().optional()}),sQ=Q.object({mimeTypes:Q.array(Q.string()).optional().describe('Array of supported MIME types for UI resources.\nMust include `"text/html;profile=mcp-app"` for MCP Apps support.')}),TQ=Q.object({method:Q.literal("ui/download-file"),params:Q.object({contents:Q.array(Q.union([zQ,_Q])).describe("Resource contents to download — embedded (inline data) or linked (host fetches). Uses standard MCP resource types.")})}),CQ=Q.object({method:Q.literal("ui/message"),params:Q.object({role:Q.literal("user").describe('Message role, currently only "user" is supported.'),content:Q.array(g).describe("Message content blocks (text, image, etc.).")})}),MQ=Q.object({method:Q.literal("ui/notifications/sandbox-resource-ready"),params:Q.object({html:Q.string().describe("HTML content to load into the inner iframe."),sandbox:Q.string().optional().describe("Optional override for the inner iframe's sandbox attribute."),csp:z.optional().describe("CSP configuration from resource metadata."),permissions:B.optional().describe("Sandbox permissions from resource metadata.")})}),M=Q.object({method:Q.literal("ui/notifications/tool-result"),params:jQ.describe("Standard MCP tool execution result.")}),k=Q.object({toolInfo:Q.object({id:BQ.optional().describe("JSON-RPC id of the tools/call request."),tool:OQ.describe("Tool definition including name, inputSchema, etc.")}).optional().describe("Metadata of the tool call that instantiated this App."),theme:d.optional().describe("Current color theme preference."),styles:m.optional().describe("Style configuration for theming the app."),displayMode:V.optional().describe("How the UI is currently displayed."),availableDisplayModes:Q.array(V).optional().describe("Display modes the host supports."),containerDimensions:Q.union([Q.object({height:Q.number().describe("Fixed container height in pixels.")}),Q.object({maxHeight:Q.union([Q.number(),Q.undefined()]).optional().describe("Maximum container height in pixels.")})]).and(Q.union([Q.object({width:Q.number().describe("Fixed container width in pixels.")}),Q.object({maxWidth:Q.union([Q.number(),Q.undefined()]).optional().describe("Maximum container width in pixels.")})])).optional().describe(`Container dimensions. Represents the dimensions of the iframe or other
+container holding the app. Specify either width or maxWidth, and either height or maxHeight.`),locale:Q.string().optional().describe("User's language and region preference in BCP 47 format."),timeZone:Q.string().optional().describe("User's timezone in IANA format."),userAgent:Q.string().optional().describe("Host application identifier."),platform:Q.union([Q.literal("web"),Q.literal("desktop"),Q.literal("mobile")]).optional().describe("Platform type for responsive design decisions."),deviceCapabilities:Q.object({touch:Q.boolean().optional().describe("Whether the device supports touch input."),hover:Q.boolean().optional().describe("Whether the device supports hover interactions.")}).optional().describe("Device input capabilities."),safeAreaInsets:Q.object({top:Q.number().describe("Top safe area inset in pixels."),right:Q.number().describe("Right safe area inset in pixels."),bottom:Q.number().describe("Bottom safe area inset in pixels."),left:Q.number().describe("Left safe area inset in pixels.")}).optional().describe("Mobile safe area boundaries in pixels.")}).passthrough(),b=Q.object({method:Q.literal("ui/notifications/host-context-changed"),params:k.describe("Partial context update containing only changed fields.")}),kQ=Q.object({method:Q.literal("ui/update-model-context"),params:Q.object({content:Q.array(g).optional().describe("Context content blocks (text, image, etc.)."),structuredContent:Q.record(Q.string(),Q.unknown().describe("Structured content for machine-readable context data.")).optional().describe("Structured content for machine-readable context data.")})}),bQ=Q.object({method:Q.literal("ui/initialize"),params:Q.object({appInfo:v.describe("App identification (name and version)."),appCapabilities:p.describe("Features and capabilities this app provides."),protocolVersion:Q.string().describe("Protocol version this app supports.")})}),S=Q.object({protocolVersion:Q.string().describe('Negotiated protocol version string (e.g., "2025-11-21").'),hostInfo:v.describe("Host application identification and version."),hostCapabilities:c.describe("Features and capabilities provided by the host."),hostContext:k.describe("Rich context about the host environment.")}).passthrough();var SQ={target:"draft-2020-12"};async function y(X,Y){let Z=X["~standard"];if(Z.jsonSchema)return Z.jsonSchema[Y](SQ);throw Error(`Schema (vendor: ${Z.vendor}) does not implement Standard JSON Schema (~standard.jsonSchema). Use a library that does (zod v4, ArkType, Valibot) or wrap your schema accordingly.`)}async function x(X,Y,Z=""){let $=await X["~standard"].validate(Y);if($.issues){let D=$.issues.map((K)=>{let W=K.path?.map((G)=>typeof G==="object"?G.key:G).join(".");return W?`${W}: ${K.message}`:K.message}).join("; ");throw Error(Z+D)}return $.value}import{z as dQ}from"zod/v4";function yQ(){let X=document.documentElement.getAttribute("data-theme");if(X==="dark"||X==="light")return X;return document.documentElement.classList.contains("dark")?"dark":"light"}function xQ(X){let Y=document.documentElement;Y.setAttribute("data-theme",X),Y.style.colorScheme=X}function uQ(X,Y=document.documentElement){for(let[Z,$]of Object.entries(X))if($!==void 0)Y.style.setProperty(Z,$)}function fQ(X){if(document.getElementById("__mcp-host-fonts"))return;let Z=document.createElement("style");Z.id="__mcp-host-fonts",Z.textContent=X,document.head.appendChild(Z)}function hQ(X,Y){let Z={...X,...Y};if(Y.experimental!==void 0)Z.experimental={...X.experimental,...Y.experimental};if(Y.tools!==void 0)Z.tools={...X.tools,...Y.tools};return Z}class l extends gQ{_appInfo;_appCapabilities;options;_hostCapabilities;_hostInfo;_hostContext;_registeredTools={};_initializedSent=!1;_registeredEvents=new Set;_events=new L;_methods=new _;setRequestHandler=(...X)=>{let[Y,...Z]=O("request",X)??X;this._methods.claim(Y,"setRequestHandler"),super.setRequestHandler.call(this,Y,...Z)};setNotificationHandler=(...X)=>{let[Y,...Z]=O("notification",X)??X;this._methods.claim(Y,"setNotificationHandler"),super.setNotificationHandler.call(this,Y,...Z)};removeRequestHandler=(X)=>{this._methods.release(X),super.removeRequestHandler(X)};removeNotificationHandler=(X)=>{this._methods.release(X),super.removeNotificationHandler(X)};replaceRequestHandler=(X,...Y)=>{this._methods.replace(X),super.setRequestHandler.call(this,X,...Y)};_assertInitialized(X){if(this._initializedSent)return;let Y=`[ext-apps] App.${X}() called before connect() completed the ui/initialize handshake. Await app.connect() before calling this method, or move data loading to an ontoolresult handler.`;if(this.options?.strict)throw Error(Y);console.warn(`${Y}. This will throw in a future release.`)}eventSchemas={toolinput:w,toolinputpartial:A,toolresult:M,toolcancelled:H,hostcontextchanged:b};static ONE_SHOT_EVENTS=new Set(["toolinput","toolinputpartial","toolresult","toolcancelled"]);_everHadListener=new Set;_assertHandlerTiming(X){if(!l.ONE_SHOT_EVENTS.has(X)||this._everHadListener.has(X))return;if(this._everHadListener.add(X),!this._initializedSent)return;let Y=`[ext-apps] "${String(X)}" handler registered after connect() completed the ui/initialize handshake. The host may have already sent this notification. Register handlers before calling app.connect().`;if(this.options?.strict)throw Error(Y);console.warn(Y)}setEventHandler(X,Y){if(Y)this._assertHandlerTiming(X);this._ensureEventSlot(X),this._events.setHandler(X,Y)}addEventListener(X,Y){this._assertHandlerTiming(X),this._ensureEventSlot(X),this._events.addEventListener(X,Y)}removeEventListener(X,Y){this._events.removeEventListener(X,Y)}_ensureEventSlot(X){if(this._registeredEvents.has(X))return;let Y=this.eventSchemas[X];if(!Y)throw Error(`Unknown event: ${String(X)}`);this.setNotificationHandler(Y.shape.method.value,{params:Y.shape.params},(Z)=>{let $=Z;if(X==="hostcontextchanged")this._hostContext={...this._hostContext,...$};this._events.dispatch(X,$)}),this._registeredEvents.add(X)}getEventHandler(X){return this._events.getHandler(X)}warnIfRequestHandlerReplaced(X,Y,Z){if(Y&&Z)console.warn(`[MCP Apps] ${X} handler replaced. Previous handler will no longer be called.`)}constructor(X,Y={},Z={autoResize:!0}){super(Z);this._appInfo=X;this._appCapabilities=Y;this.options=Z;if(this._methods.replace("notifications/cancelled"),this._methods.replace("notifications/progress"),!Z.allowUnsafeEval)dQ.config({jitless:!0});this.replaceRequestHandler("ping",($)=>{return console.log("Received ping:",$.params),{}}),this.setEventHandler("hostcontextchanged",void 0)}buildContext(X){return X}registerAppCapabilities(X){if(this.transport)throw Error("Cannot register capabilities after transport is established");this._appCapabilities=hQ(this._appCapabilities,X)}registerTool(X,Y,Z){if(this._registeredTools[X])throw Error(`Tool ${X} is already registered`);let $=this,D=()=>{if($._initializedSent&&$._appCapabilities.tools?.listChanged)$.sendToolListChanged()},K=Y.inputSchema!==void 0,W={title:Y.title,description:Y.description,inputSchema:Y.inputSchema,outputSchema:Y.outputSchema,annotations:Y.annotations,_meta:Y._meta,enabled:!0,enable(){this.enabled=!0,D()},disable(){this.enabled=!1,D()},update(G){Object.assign(this,G),D()},remove(){if($._registeredTools[X]!==W)return;delete $._registeredTools[X],D()},handler:async(G,J)=>{if(!W.enabled)throw Error(`Tool ${X} is disabled`);let N;if(K){let u=W.inputSchema,r=u?await x(u,G??{},`Invalid input for tool ${X}: `):G??{};N=await Z(r,J)}else N=await Z(J);if(W.outputSchema&&!N.isError)N.structuredContent=await x(W.outputSchema,N.structuredContent,`Invalid output for tool ${X}: `);return N}};if(this._registeredTools[X]=W,!this._appCapabilities.tools&&!this.transport)this.registerAppCapabilities({tools:{listChanged:!0}});return this.ensureToolHandlersInitialized(),D(),W}_toolHandlersInitialized=!1;ensureToolHandlersInitialized(){if(this._toolHandlersInitialized)return;this._toolHandlersInitialized=!0,this.oncalltool=async(X,Y)=>{let Z=this._registeredTools[X.name];if(!Z)throw Error(`Tool ${X.name} not found`);return Z.handler(X.arguments,Y)},this.onlisttools=async(X,Y)=>{return{tools:await Promise.all(Object.entries(this._registeredTools).filter(([$,D])=>D.enabled).map(async([$,D])=>{let K={name:$,title:D.title,description:D.description,inputSchema:D.inputSchema?await y(D.inputSchema,"input"):{type:"object",properties:{}}};if(D.outputSchema)K.outputSchema=await y(D.outputSchema,"output");if(D.annotations)K.annotations=D.annotations;if(D._meta)K._meta=D._meta;return K}))}}}async sendToolListChanged(X={}){this._assertInitialized("sendToolListChanged"),await this.notification({method:"notifications/tools/list_changed",params:X})}getHostCapabilities(){return this._hostCapabilities}getHostVersion(){return this._hostInfo}getHostContext(){return this._hostContext}get ontoolinput(){return this.getEventHandler("toolinput")}set ontoolinput(X){this.setEventHandler("toolinput",X)}get ontoolinputpartial(){return this.getEventHandler("toolinputpartial")}set ontoolinputpartial(X){this.setEventHandler("toolinputpartial",X)}get ontoolresult(){return this.getEventHandler("toolresult")}set ontoolresult(X){this.setEventHandler("toolresult",X)}get ontoolcancelled(){return this.getEventHandler("toolcancelled")}set ontoolcancelled(X){this.setEventHandler("toolcancelled",X)}get onhostcontextchanged(){return this.getEventHandler("hostcontextchanged")}set onhostcontextchanged(X){this.setEventHandler("hostcontextchanged",X)}_onteardown;get onteardown(){return this._onteardown}set onteardown(X){this.warnIfRequestHandlerReplaced("onteardown",this._onteardown,X),this._onteardown=X,this.replaceRequestHandler("ui/resource-teardown",{params:U.shape.params,result:T},(Y,Z)=>{if(!this._onteardown)throw Error("No onteardown handler set");return this._onteardown(Y,Z)})}_oncalltool;get oncalltool(){return this._oncalltool}set oncalltool(X){this.warnIfRequestHandlerReplaced("oncalltool",this._oncalltool,X),this._oncalltool=X,this.replaceRequestHandler("tools/call",(Y,Z)=>{if(!this._oncalltool)throw Error("No oncalltool handler set");return this._oncalltool(Y.params,Z)})}_onlisttools;get onlisttools(){return this._onlisttools}set onlisttools(X){this.warnIfRequestHandlerReplaced("onlisttools",this._onlisttools,X),this._onlisttools=X,this.replaceRequestHandler("tools/list",(Y,Z)=>{if(!this._onlisttools)throw Error("No onlisttools handler set");return this._onlisttools(Y.params,Z)})}assertCapabilityForMethod(X){switch(X){case"sampling/createMessage":if(!this._hostCapabilities?.sampling)throw Error(`Host does not support sampling (required for ${X})`);break}}assertRequestHandlerCapability(X){switch(X){case"tools/call":case"tools/list":if(!this._appCapabilities.tools)throw Error(`Client does not support tool capability (required for ${X})`);return;default:return}}assertNotificationCapability(X){}async callServerTool(X,Y){if(this._assertInitialized("callServerTool"),typeof X==="string")throw Error(`callServerTool() expects an object as its first argument, but received a string ("${X}"). Did you mean: callServerTool({ name: "${X}", arguments: { ... } })?`);return await this.request({method:"tools/call",params:X},{onprogress:()=>{},resetTimeoutOnProgress:!0,...Y})}async readServerResource(X,Y){return this._assertInitialized("readServerResource"),await this.request({method:"resources/read",params:X},Y)}async listServerResources(X,Y){return this._assertInitialized("listServerResources"),await this.request({method:"resources/list",params:X},Y)}async createSamplingMessage(X,Y){return this._assertInitialized("createSamplingMessage"),await this.request({method:"sampling/createMessage",params:X},Y)}sendMessage(X,Y){return this._assertInitialized("sendMessage"),this.request({method:"ui/message",params:X},R,Y)}sendLog(X){return this.notification({method:"notifications/message",params:X})}updateModelContext(X,Y){return this._assertInitialized("updateModelContext"),this.request({method:"ui/update-model-context",params:X},vQ,Y)}openLink(X,Y){return this._assertInitialized("openLink"),this.request({method:"ui/open-link",params:X},I,Y)}sendOpenLink=this.openLink;downloadFile(X,Y){return this._assertInitialized("downloadFile"),this.request({method:"ui/download-file",params:X},P,Y)}requestTeardown(X={}){return this.notification({method:"ui/notifications/request-teardown",params:X})}requestDisplayMode(X,Y){return this._assertInitialized("requestDisplayMode"),this.request({method:"ui/request-display-mode",params:X},C,Y)}sendSizeChanged(X){return this.notification({method:"ui/notifications/size-changed",params:X})}setupSizeChangedNotifications(){let X=!1,Y=0,Z=0,$=()=>{if(X)return;X=!0,requestAnimationFrame(()=>{X=!1;let K=document.documentElement,W=K.style.height;K.style.height="max-content";let G=Math.ceil(K.getBoundingClientRect().height);K.style.height=W;let J=Math.ceil(window.innerWidth);if(J!==Y||G!==Z)Y=J,Z=G,this.sendSizeChanged({width:J,height:G})})};$();let D=new ResizeObserver($);return D.observe(document.documentElement),D.observe(document.body),()=>D.disconnect()}async connect(X=new j(window.parent,window.parent),Y){if(this.transport)throw Error("App is already connected. Call close() before connecting again.");this._initializedSent=!1;try{await super.connect(X);let Z=await this.request({method:"ui/initialize",params:{appCapabilities:this._appCapabilities,appInfo:this._appInfo,protocolVersion:E}},S,Y);if(Z===void 0)throw Error(`Server sent invalid initialize result: ${Z}`);if(this._hostCapabilities=Z.hostCapabilities,this._hostInfo=Z.hostInfo,this._hostContext=Z.hostContext,await this.notification({method:"ui/notifications/initialized"}),this._initializedSent=!0,this.options?.autoResize)this.setupSizeChangedNotifications()}catch(Z){throw this.close(),Z}}}export{yQ as getDocumentTheme,uQ as applyHostStyleVariables,fQ as applyHostFonts,xQ as applyDocumentTheme,$Q as TOOL_RESULT_METHOD,q as TOOL_INPUT_PARTIAL_METHOD,ZQ as TOOL_INPUT_METHOD,DQ as TOOL_CANCELLED_METHOD,YQ as SIZE_CHANGED_METHOD,XQ as SANDBOX_RESOURCE_READY_METHOD,QQ as SANDBOX_PROXY_READY_METHOD,n as RESOURCE_URI_META_KEY,GQ as RESOURCE_TEARDOWN_METHOD,o as RESOURCE_MIME_TYPE,WQ as REQUEST_TEARDOWN_METHOD,VQ as REQUEST_DISPLAY_MODE_METHOD,j as PostMessageTransport,s as OPEN_LINK_METHOD,kQ as McpUiUpdateModelContextRequestSchema,i as McpUiToolVisibilitySchema,M as McpUiToolResultNotificationSchema,UQ as McpUiToolMetaSchema,A as McpUiToolInputPartialNotificationSchema,w as McpUiToolInputNotificationSchema,H as McpUiToolCancelledNotificationSchema,d as McpUiThemeSchema,F as McpUiSupportedContentBlockModalitiesSchema,PQ as McpUiSizeChangedNotificationSchema,MQ as McpUiSandboxResourceReadyNotificationSchema,IQ as McpUiSandboxProxyReadyNotificationSchema,T as McpUiResourceTeardownResultSchema,U as McpUiResourceTeardownRequestSchema,B as McpUiResourcePermissionsSchema,AQ as McpUiResourceMetaSchema,z as McpUiResourceCspSchema,RQ as McpUiRequestTeardownNotificationSchema,C as McpUiRequestDisplayModeResultSchema,HQ as McpUiRequestDisplayModeRequestSchema,I as McpUiOpenLinkResultSchema,FQ as McpUiOpenLinkRequestSchema,R as McpUiMessageResultSchema,CQ as McpUiMessageRequestSchema,wQ as McpUiInitializedNotificationSchema,S as McpUiInitializeResultSchema,bQ as McpUiInitializeRequestSchema,m as McpUiHostStylesSchema,h as McpUiHostCssSchema,k as McpUiHostContextSchema,b as McpUiHostContextChangedNotificationSchema,c as McpUiHostCapabilitiesSchema,P as McpUiDownloadFileResultSchema,TQ as McpUiDownloadFileRequestSchema,V as McpUiDisplayModeSchema,p as McpUiAppCapabilitiesSchema,e as MESSAGE_METHOD,E as LATEST_PROTOCOL_VERSION,JQ as INITIALIZE_METHOD,NQ as INITIALIZED_METHOD,KQ as HOST_CONTEXT_CHANGED_METHOD,L as EventDispatcher,t as DOWNLOAD_FILE_METHOD,l as App};

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/app.test.d.ts

@@ -0,0 +1 @@
+export {};

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/constants.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Metadata key for associating a UI resource URI with a tool.
+ *
+ * MCP servers include this key in tool definition metadata (via `tools/list`)
+ * to indicate which UI resource should be displayed when the tool is called.
+ * When hosts see a tool with this metadata, they fetch and render the
+ * corresponding {@link app!App `App`}.
+ *
+ * **Note**: This constant is provided for reference and backwards compatibility.
+ * Server developers should use {@link server-helpers!registerAppTool `registerAppTool`}
+ * with the `_meta.ui.resourceUri` format instead. Host developers must check both
+ * formats for compatibility.
+ *
+ * @example Modern format (server-side, not in Apps)
+ * ```ts source="./app.examples.ts#RESOURCE_URI_META_KEY_modernFormat"
+ * // Preferred: Use registerAppTool with nested ui.resourceUri
+ * registerAppTool(
+ *   server,
+ *   "weather",
+ *   {
+ *     description: "Get weather forecast",
+ *     _meta: {
+ *       ui: { resourceUri: "ui://weather/forecast" },
+ *     },
+ *   },
+ *   handler,
+ * );
+ * ```
+ *
+ * @example Legacy format (deprecated, for backwards compatibility)
+ * ```ts source="./app.examples.ts#RESOURCE_URI_META_KEY_legacyFormat"
+ * // Deprecated: Direct use of RESOURCE_URI_META_KEY
+ * server.registerTool(
+ *   "weather",
+ *   {
+ *     description: "Get weather forecast",
+ *     _meta: {
+ *       [RESOURCE_URI_META_KEY]: "ui://weather/forecast",
+ *     },
+ *   },
+ *   handler,
+ * );
+ * ```
+ *
+ * @example How hosts check for this metadata (must support both formats)
+ * ```ts source="./app.examples.ts#RESOURCE_URI_META_KEY_hostSide"
+ * // Hosts should check both modern and legacy formats
+ * const meta = tool._meta;
+ * const uiMeta = meta?.ui as McpUiToolMeta | undefined;
+ * const legacyUri = meta?.[RESOURCE_URI_META_KEY] as string | undefined;
+ * const uiUri = uiMeta?.resourceUri ?? legacyUri;
+ * if (typeof uiUri === "string" && uiUri.startsWith("ui://")) {
+ *   // Fetch the resource and display the UI
+ * }
+ * ```
+ */
+export declare const RESOURCE_URI_META_KEY = "ui/resourceUri";
+/**
+ * MIME type for MCP UI resources.
+ *
+ * Identifies HTML content as an MCP App UI resource.
+ *
+ * Used by {@link server-helpers!registerAppResource `registerAppResource`} as the default MIME type for app resources.
+ */
+export declare const RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/events.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Protocol-independent DOM-style event fan-out.
+ *
+ * Owners perform event-specific state updates before calling
+ * {@link dispatch}. Dispatch then invokes the singular handler followed by a
+ * snapshot of listeners in insertion order.
+ *
+ * @typeParam EventMap - Maps event names to their listener parameter types.
+ */
+export declare class EventDispatcher<EventMap extends Record<string, unknown>> {
+    private readonly _eventSlots;
+    /** Set, replace, or clear the singular handler for an event. */
+    setHandler<K extends keyof EventMap>(event: K, handler: ((params: EventMap[K]) => void) | undefined): void;
+    /** Get the singular handler for an event, if one is set. */
+    getHandler<K extends keyof EventMap>(event: K): ((params: EventMap[K]) => void) | undefined;
+    /** Add a listener. Listeners run in insertion order after the handler. */
+    addEventListener<K extends keyof EventMap>(event: K, handler: (params: EventMap[K]) => void): void;
+    /** Remove the first matching listener, if present. */
+    removeEventListener<K extends keyof EventMap>(event: K, handler: (params: EventMap[K]) => void): void;
+    /**
+     * Dispatch an event to its singular handler and a listener snapshot.
+     * Listener mutations during dispatch take effect on the next dispatch.
+     */
+    dispatch<K extends keyof EventMap>(event: K, params: EventMap[K]): void;
+    private _ensureEventSlot;
+}
+/**
+ * Tracks which JSON-RPC methods already have a handler registered through the
+ * owning `App` / `AppBridge`, so a second direct `setRequestHandler` /
+ * `setNotificationHandler` call for the same method throws instead of
+ * silently replacing the first handler (the base SDK `Protocol` replaces).
+ *
+ * The `on*` setters use {@link replace} for DOM-style replace semantics, and
+ * `removeRequestHandler` / `removeNotificationHandler` use {@link release}.
+ *
+ * @internal
+ */
+export declare class MethodRegistry {
+    private readonly _methods;
+    /** Claim `method`. Throws if a handler is already registered for it. */
+    claim(method: string, via: string): void;
+    /** Claim `method` with replace semantics (never throws). */
+    replace(method: string): void;
+    /** Release `method` so it can be claimed again. */
+    release(method: string): void;
+    has(method: string): boolean;
+}

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/events.test.d.ts

@@ -0,0 +1 @@
+export {};