@explyt/ai-agent 0.1.0-rc.1

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

@@ -0,0 +1,9 @@
+/**
+ * Type-checked examples for {@link AppBridge `AppBridge`}.
+ *
+ * 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-bridge.js

@@ -0,0 +1,39 @@
+var ZQ=((X)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(X,{get:(Y,Z)=>(typeof require<"u"?require:Y)[Z]}):X)(function(X){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+X+'" is not supported')});import{CallToolRequestSchema as iQ,CallToolResultSchema as XQ,CreateMessageRequestSchema as nQ,ListPromptsRequestSchema as cQ,ListPromptsResultSchema as lQ,ListResourcesRequestSchema as rQ,ListResourcesResultSchema as oQ,ListResourceTemplatesRequestSchema as sQ,ListResourceTemplatesResultSchema as tQ,ListToolsResultSchema as aQ,LoggingMessageNotificationSchema as eQ,PingRequestSchema as QX,PromptListChangedNotificationSchema as XX,ReadResourceRequestSchema as YX,ReadResourceResultSchema as ZX,ResourceListChangedNotificationSchema as $X,ToolListChangedNotificationSchema as JX}from"@modelcontextprotocol/sdk/types.js";import{Protocol as $Q}from"@modelcontextprotocol/sdk/shared/protocol.js";class _ extends $Q{_registeredMethods=new Set;_eventSlots=new Map;onEventDispatch(X,Y){}_ensureEventSlot(X){let Y=this._eventSlots.get(X);if(!Y){let Z=this.eventSchemas[X];if(!Z)throw Error(`Unknown event: ${String(X)}`);Y={listeners:[]},this._eventSlots.set(X,Y);let $=Z.shape.method.value;this._registeredMethods.add($);let J=Y;super.setNotificationHandler(Z,(K)=>{let D=K.params;this.onEventDispatch(X,D),J.onHandler?.(D);for(let G of[...J.listeners])G(D)})}return Y}setEventHandler(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}getEventHandler(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)}setRequestHandler=(X,Y)=>{this._assertMethodNotRegistered(X,"setRequestHandler"),super.setRequestHandler(X,Y)};setNotificationHandler=(X,Y)=>{this._assertMethodNotRegistered(X,"setNotificationHandler"),super.setNotificationHandler(X,Y)};warnIfRequestHandlerReplaced(X,Y,Z){if(Y&&Z)console.warn(`[MCP Apps] ${X} handler replaced. Previous handler will no longer be called.`)}replaceRequestHandler=(X,Y)=>{let Z=X.shape.method.value;this._registeredMethods.add(Z),super.setRequestHandler(X,Y)};_assertMethodNotRegistered(X,Y){let Z=X.shape.method.value;if(this._registeredMethods.has(Z))throw Error(`Handler for "${Z}" already registered (via ${Y}). Use addEventListener() to attach multiple listeners, or the on* setter for replace semantics.`);this._registeredMethods.add(Z)}}var j="2026-01-26",JQ="ui/open-link",KQ="ui/download-file",DQ="ui/message",GQ="ui/notifications/sandbox-proxy-ready",NQ="ui/notifications/sandbox-resource-ready",WQ="ui/notifications/size-changed",jQ="ui/notifications/tool-input",V="ui/notifications/tool-input-partial",BQ="ui/notifications/tool-result",_Q="ui/notifications/tool-cancelled",EQ="ui/notifications/host-context-changed",OQ="ui/notifications/request-teardown",zQ="ui/resource-teardown",IQ="ui/initialize",VQ="ui/notifications/initialized",FQ="ui/request-display-mode";import{z as Q}from"zod/v4";import{ContentBlockSchema as c,CallToolResultSchema as LQ,EmbeddedResourceSchema as PQ,ImplementationSchema as l,RequestIdSchema as AQ,ResourceLinkSchema as UQ,ToolSchema as wQ}from"@modelcontextprotocol/sdk/types.js";var r=Q.union([Q.literal("light"),Q.literal("dark")]).describe("Color theme preference for the host environment."),B=Q.union([Q.literal("inline"),Q.literal("fullscreen"),Q.literal("pip")]).describe("Display mode for UI presentation."),HQ=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."),RQ=Q.record(HQ.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.`),L=Q.object({method:Q.literal("ui/open-link"),params:Q.object({url:Q.string().describe("URL to open in the host's browser")})}),P=Q.object({isError:Q.boolean().optional().describe("True if the host failed to open the URL (e.g., due to security policy).")}).passthrough(),A=Q.object({isError:Q.boolean().optional().describe("True if the download failed (e.g., user cancelled or host denied).")}).passthrough(),U=Q.object({isError:Q.boolean().optional().describe("True if the host rejected or failed to deliver the message.")}).passthrough(),w=Q.object({method:Q.literal("ui/notifications/sandbox-proxy-ready"),params:Q.object({})}),O=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'`)")}),z=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.")}),H=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.")})}),R=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.")})}),T=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).")})}),M=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").')})}),o=Q.object({fonts:Q.string().optional()}),s=Q.object({variables:RQ.optional().describe("CSS variables for theming the app."),css:o.optional().describe("CSS blocks that apps can inject.")}),C=Q.object({method:Q.literal("ui/resource-teardown"),params:Q.object({})}),S=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.")}),q=Q.object({method:Q.literal("ui/notifications/request-teardown"),params:Q.object({}).optional()}),t=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:z.optional().describe("Permissions granted by the host (camera, microphone, geolocation)."),csp:O.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.")}),a=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(B).optional().describe("Display modes the app supports.")}),y=Q.object({method:Q.literal("ui/notifications/initialized"),params:Q.object({}).optional()}),TQ=Q.object({csp:O.optional().describe("Content Security Policy configuration for UI resources."),permissions:z.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`)}),I=Q.object({method:Q.literal("ui/request-display-mode"),params:Q.object({mode:B.describe("The display mode being requested.")})}),g=Q.object({mode:B.describe("The display mode that was actually set. May differ from requested if not supported.")}).passthrough(),e=Q.union([Q.literal("model"),Q.literal("app")]).describe("Tool visibility scope - who can access the tool."),MQ=Q.object({resourceUri:Q.string().optional(),visibility:Q.array(e).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()}),OX=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.')}),f=Q.object({method:Q.literal("ui/download-file"),params:Q.object({contents:Q.array(Q.union([PQ,UQ])).describe("Resource contents to download — embedded (inline data) or linked (host fetches). Uses standard MCP resource types.")})}),k=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(c).describe("Message content blocks (text, image, etc.).")})}),CQ=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:O.optional().describe("CSP configuration from resource metadata."),permissions:z.optional().describe("Sandbox permissions from resource metadata.")})}),v=Q.object({method:Q.literal("ui/notifications/tool-result"),params:LQ.describe("Standard MCP tool execution result.")}),x=Q.object({toolInfo:Q.object({id:AQ.optional().describe("JSON-RPC id of the tools/call request."),tool:wQ.describe("Tool definition including name, inputSchema, etc.")}).optional().describe("Metadata of the tool call that instantiated this App."),theme:r.optional().describe("Current color theme preference."),styles:s.optional().describe("Style configuration for theming the app."),displayMode:B.optional().describe("How the UI is currently displayed."),availableDisplayModes:Q.array(B).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:x.describe("Partial context update containing only changed fields.")}),d=Q.object({method:Q.literal("ui/update-model-context"),params:Q.object({content:Q.array(c).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.")})}),u=Q.object({method:Q.literal("ui/initialize"),params:Q.object({appInfo:l.describe("App identification (name and version)."),appCapabilities:a.describe("Features and capabilities this app provides."),protocolVersion:Q.string().describe("Protocol version this app supports.")})}),h=Q.object({protocolVersion:Q.string().describe('Negotiated protocol version string (e.g., "2025-11-21").'),hostInfo:l.describe("Host application identification and version."),hostCapabilities:t.describe("Features and capabilities provided by the host."),hostContext:x.describe("Rich context about the host environment.")}).passthrough();import{mergeCapabilities as yQ}from"@modelcontextprotocol/sdk/shared/protocol.js";import{CallToolRequestSchema as gQ,CallToolResultSchema as fQ,CreateMessageResultSchema as kQ,CreateMessageResultWithToolsSchema as vQ,EmptyResultSchema as xQ,ListResourcesResultSchema as bQ,ListToolsRequestSchema as dQ,PingRequestSchema as uQ,ReadResourceResultSchema as hQ}from"@modelcontextprotocol/sdk/types.js";import{JSONRPCMessageSchema as SQ}from"@modelcontextprotocol/sdk/types.js";class E{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 $=SQ.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!==V)console.debug("Sending message",X);this.eventTarget.postMessage(X,"*")}async close(){window.removeEventListener("message",this.messageListener),this.onclose?.()}onclose;onerror;onmessage;sessionId;setProtocolVersion}var qQ={target:"draft-2020-12"};async function m(X,Y){let Z=X["~standard"];if(Z.jsonSchema)return Z.jsonSchema[Y](qQ);if(Z.vendor==="zod"){let{z:$}=await import("zod/v4");return $.toJSONSchema(X,{io:Y})}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 p(X,Y,Z=""){let $=await X["~standard"].validate(Y);if($.issues){let J=$.issues.map((K)=>{let D=K.path?.map((G)=>typeof G==="object"?G.key:G).join(".");return D?`${D}: ${K.message}`:K.message}).join("; ");throw Error(Z+J)}return $.value}import{z as mQ}from"zod/v4";var i="ui/resourceUri",pQ="text/html;profile=mcp-app";class QQ extends _{_appInfo;_capabilities;options;_hostCapabilities;_hostInfo;_hostContext;_registeredTools={};_initializedSent=!1;_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:R,toolinputpartial:T,toolresult:v,toolcancelled:M,hostcontextchanged:b};static ONE_SHOT_EVENTS=new Set(["toolinput","toolinputpartial","toolresult","toolcancelled"]);_everHadListener=new Set;_assertHandlerTiming(X){if(!QQ.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);super.setEventHandler(X,Y)}addEventListener(X,Y){this._assertHandlerTiming(X),super.addEventListener(X,Y)}onEventDispatch(X,Y){if(X==="hostcontextchanged")this._hostContext={...this._hostContext,...Y}}constructor(X,Y={},Z={autoResize:!0}){super(Z);this._appInfo=X;this._capabilities=Y;this.options=Z;if(!Z.allowUnsafeEval)mQ.config({jitless:!0});this.setRequestHandler(uQ,($)=>{return console.log("Received ping:",$.params),{}}),this.setEventHandler("hostcontextchanged",void 0)}registerCapabilities(X){if(this.transport)throw Error("Cannot register capabilities after transport is established");this._capabilities=yQ(this._capabilities,X)}registerTool(X,Y,Z){if(this._registeredTools[X])throw Error(`Tool ${X} is already registered`);let $=this,J=()=>{if($._initializedSent&&$._capabilities.tools?.listChanged)$.sendToolListChanged()},K=Y.inputSchema!==void 0,D={title:Y.title,description:Y.description,inputSchema:Y.inputSchema,outputSchema:Y.outputSchema,annotations:Y.annotations,_meta:Y._meta,enabled:!0,enable(){this.enabled=!0,J()},disable(){this.enabled=!1,J()},update(G){Object.assign(this,G),J()},remove(){if($._registeredTools[X]!==D)return;delete $._registeredTools[X],J()},handler:async(G,N)=>{if(!D.enabled)throw Error(`Tool ${X} is disabled`);let W;if(K){let n=D.inputSchema,YQ=n?await p(n,G??{},`Invalid input for tool ${X}: `):G??{};W=await Z(YQ,N)}else W=await Z(N);if(D.outputSchema&&!W.isError)W.structuredContent=await p(D.outputSchema,W.structuredContent,`Invalid output for tool ${X}: `);return W}};if(this._registeredTools[X]=D,!this._capabilities.tools&&!this.transport)this.registerCapabilities({tools:{listChanged:!0}});return this.ensureToolHandlersInitialized(),J(),D}_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(([$,J])=>J.enabled).map(async([$,J])=>{let K={name:$,title:J.title,description:J.description,inputSchema:J.inputSchema?await m(J.inputSchema,"input"):{type:"object",properties:{}}};if(J.outputSchema)K.outputSchema=await m(J.outputSchema,"output");if(J.annotations)K.annotations=J.annotations;if(J._meta)K._meta=J._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(C,(Y,Z)=>{if(!this._onteardown)throw Error("No onteardown handler set");return this._onteardown(Y.params,Z)})}_oncalltool;get oncalltool(){return this._oncalltool}set oncalltool(X){this.warnIfRequestHandlerReplaced("oncalltool",this._oncalltool,X),this._oncalltool=X,this.replaceRequestHandler(gQ,(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(dQ,(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._capabilities.tools)throw Error(`Client does not support tool capability (required for ${X})`);return;case"ping":case"ui/resource-teardown":return;default:throw Error(`No handler for method ${X} registered`)}}assertNotificationCapability(X){}assertTaskCapability(X){throw Error("Tasks are not supported in MCP Apps")}assertTaskHandlerCapability(X){throw Error("Task handlers are not supported in MCP Apps")}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},fQ,{onprogress:()=>{},resetTimeoutOnProgress:!0,...Y})}async readServerResource(X,Y){return this._assertInitialized("readServerResource"),await this.request({method:"resources/read",params:X},hQ,Y)}async listServerResources(X,Y){return this._assertInitialized("listServerResources"),await this.request({method:"resources/list",params:X},bQ,Y)}async createSamplingMessage(X,Y){this._assertInitialized("createSamplingMessage");let Z=X.tools?vQ:kQ;return await this.request({method:"sampling/createMessage",params:X},Z,Y)}sendMessage(X,Y){return this._assertInitialized("sendMessage"),this.request({method:"ui/message",params:X},U,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},xQ,Y)}openLink(X,Y){return this._assertInitialized("openLink"),this.request({method:"ui/open-link",params:X},P,Y)}sendOpenLink=this.openLink;downloadFile(X,Y){return this._assertInitialized("downloadFile"),this.request({method:"ui/download-file",params:X},A,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},g,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,D=K.style.height;K.style.height="max-content";let G=Math.ceil(K.getBoundingClientRect().height);K.style.height=D;let N=Math.ceil(window.innerWidth);if(N!==Y||G!==Z)Y=N,Z=G,this.sendSizeChanged({width:N,height:G})})};$();let J=new ResizeObserver($);return J.observe(document.documentElement),J.observe(document.body),()=>J.disconnect()}async connect(X=new E(window.parent,window.parent),Y){if(this.transport)throw Error("App is already connected. Call close() before connecting again.");this._initializedSent=!1,await super.connect(X);try{let Z=await this.request({method:"ui/initialize",params:{appCapabilities:this._capabilities,appInfo:this._appInfo,protocolVersion:j}},h,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}}}function FZ(X){let Z=X._meta?.ui?.resourceUri;if(Z===void 0)Z=X._meta?.[i];if(typeof Z==="string"&&Z.startsWith("ui://"))return Z;else if(Z!==void 0)throw Error(`Invalid UI resource URI: ${JSON.stringify(Z)}`);return}function LZ(X){let Z=X._meta?.ui?.visibility;if(!Z)return!1;if(Z.length===1&&Z[0]==="model")return!0;return!1}function PZ(X){let Z=X._meta?.ui?.visibility;if(!Z)return!1;if(Z.length===1&&Z[0]==="app")return!0;return!1}function AZ(X){if(!X)return"";let Y=[];if(X.camera)Y.push("camera");if(X.microphone)Y.push("microphone");if(X.geolocation)Y.push("geolocation");if(X.clipboardWrite)Y.push("clipboard-write");return Y.join("; ")}var KX=[j];class DX extends _{_client;_hostInfo;_capabilities;_appCapabilities;_hostContext={};_appInfo;_initializedReceived=!1;_baseReplaceRequestHandler=this.replaceRequestHandler;replaceRequestHandler=(X,Y)=>{this._baseReplaceRequestHandler(X,(Z,$)=>{if(!this._initializedReceived)console.warn(`[ext-apps] AppBridge received '${Z.method}' before ui/notifications/initialized. The View is calling host methods before completing the handshake; it should await app.connect() first.`);return Y(Z,$)})};eventSchemas={sizechange:H,sandboxready:w,initialized:y,requestteardown:q,loggingmessage:eQ};constructor(X,Y,Z,$){super($);this._client=X;this._hostInfo=Y;this._capabilities=Z;this.addEventListener("initialized",()=>{this._initializedReceived=!0}),this._hostContext=$?.hostContext||{},this.setRequestHandler(u,(J)=>this._oninitialize(J)),this.setRequestHandler(QX,(J,K)=>{return this.onping?.(J.params,K),{}}),this.replaceRequestHandler(I,(J)=>{return{mode:this._hostContext.displayMode??"inline"}})}getAppCapabilities(){return this._appCapabilities}getAppVersion(){return this._appInfo}onping;get onsizechange(){return this.getEventHandler("sizechange")}set onsizechange(X){this.setEventHandler("sizechange",X)}get onsandboxready(){return this.getEventHandler("sandboxready")}set onsandboxready(X){this.setEventHandler("sandboxready",X)}get oninitialized(){return this.getEventHandler("initialized")}set oninitialized(X){this.setEventHandler("initialized",X)}_onmessage;get onmessage(){return this._onmessage}set onmessage(X){this.warnIfRequestHandlerReplaced("onmessage",this._onmessage,X),this._onmessage=X,this.replaceRequestHandler(k,async(Y,Z)=>{if(!this._onmessage)throw Error("No onmessage handler set");return this._onmessage(Y.params,Z)})}_onopenlink;get onopenlink(){return this._onopenlink}set onopenlink(X){this.warnIfRequestHandlerReplaced("onopenlink",this._onopenlink,X),this._onopenlink=X,this.replaceRequestHandler(L,async(Y,Z)=>{if(!this._onopenlink)throw Error("No onopenlink handler set");return this._onopenlink(Y.params,Z)})}_ondownloadfile;get ondownloadfile(){return this._ondownloadfile}set ondownloadfile(X){this.warnIfRequestHandlerReplaced("ondownloadfile",this._ondownloadfile,X),this._ondownloadfile=X,this.replaceRequestHandler(f,async(Y,Z)=>{if(!this._ondownloadfile)throw Error("No ondownloadfile handler set");return this._ondownloadfile(Y.params,Z)})}get onrequestteardown(){return this.getEventHandler("requestteardown")}set onrequestteardown(X){this.setEventHandler("requestteardown",X)}_onrequestdisplaymode;get onrequestdisplaymode(){return this._onrequestdisplaymode}set onrequestdisplaymode(X){this.warnIfRequestHandlerReplaced("onrequestdisplaymode",this._onrequestdisplaymode,X),this._onrequestdisplaymode=X,this.replaceRequestHandler(I,async(Y,Z)=>{if(!this._onrequestdisplaymode)throw Error("No onrequestdisplaymode handler set");return this._onrequestdisplaymode(Y.params,Z)})}get onloggingmessage(){return this.getEventHandler("loggingmessage")}set onloggingmessage(X){this.setEventHandler("loggingmessage",X)}_onupdatemodelcontext;get onupdatemodelcontext(){return this._onupdatemodelcontext}set onupdatemodelcontext(X){this.warnIfRequestHandlerReplaced("onupdatemodelcontext",this._onupdatemodelcontext,X),this._onupdatemodelcontext=X,this.replaceRequestHandler(d,async(Y,Z)=>{if(!this._onupdatemodelcontext)throw Error("No onupdatemodelcontext handler set");return this._onupdatemodelcontext(Y.params,Z)})}_oncalltool;get oncalltool(){return this._oncalltool}set oncalltool(X){this.warnIfRequestHandlerReplaced("oncalltool",this._oncalltool,X),this._oncalltool=X,this.replaceRequestHandler(iQ,async(Y,Z)=>{if(!this._oncalltool)throw Error("No oncalltool handler set");return this._oncalltool(Y.params,Z)})}set oncreatesamplingmessage(X){this.setRequestHandler(nQ,async(Y,Z)=>{return X(Y.params,Z)})}sendToolListChanged(X={}){return this.notification({method:"notifications/tools/list_changed",params:X})}_onlistresources;get onlistresources(){return this._onlistresources}set onlistresources(X){this.warnIfRequestHandlerReplaced("onlistresources",this._onlistresources,X),this._onlistresources=X,this.replaceRequestHandler(rQ,async(Y,Z)=>{if(!this._onlistresources)throw Error("No onlistresources handler set");return this._onlistresources(Y.params,Z)})}_onlistresourcetemplates;get onlistresourcetemplates(){return this._onlistresourcetemplates}set onlistresourcetemplates(X){this.warnIfRequestHandlerReplaced("onlistresourcetemplates",this._onlistresourcetemplates,X),this._onlistresourcetemplates=X,this.replaceRequestHandler(sQ,async(Y,Z)=>{if(!this._onlistresourcetemplates)throw Error("No onlistresourcetemplates handler set");return this._onlistresourcetemplates(Y.params,Z)})}_onreadresource;get onreadresource(){return this._onreadresource}set onreadresource(X){this.warnIfRequestHandlerReplaced("onreadresource",this._onreadresource,X),this._onreadresource=X,this.replaceRequestHandler(YX,async(Y,Z)=>{if(!this._onreadresource)throw Error("No onreadresource handler set");return this._onreadresource(Y.params,Z)})}sendResourceListChanged(X={}){return this.notification({method:"notifications/resources/list_changed",params:X})}_onlistprompts;get onlistprompts(){return this._onlistprompts}set onlistprompts(X){this.warnIfRequestHandlerReplaced("onlistprompts",this._onlistprompts,X),this._onlistprompts=X,this.replaceRequestHandler(cQ,async(Y,Z)=>{if(!this._onlistprompts)throw Error("No onlistprompts handler set");return this._onlistprompts(Y.params,Z)})}sendPromptListChanged(X={}){return this.notification({method:"notifications/prompts/list_changed",params:X})}assertCapabilityForMethod(X){}assertRequestHandlerCapability(X){}assertNotificationCapability(X){}assertTaskCapability(X){throw Error("Tasks are not supported in MCP Apps")}assertTaskHandlerCapability(X){throw Error("Task handlers are not supported in MCP Apps")}getCapabilities(){return this._capabilities}async _oninitialize(X){let Y=X.params.protocolVersion;if(this._appInfo!==void 0)console.warn("[ext-apps] AppBridge received a second ui/initialize. The View may be double-mounting (e.g. React StrictMode in dev) without closing the previous App instance. Responding normally; the latest appInfo/appCapabilities replace the previous values.");return this._appCapabilities=X.params.appCapabilities,this._appInfo=X.params.appInfo,{protocolVersion:KX.includes(Y)?Y:j,hostCapabilities:this.getCapabilities(),hostInfo:this._hostInfo,hostContext:this._hostContext}}setHostContext(X){let Y={},Z=!1;for(let $ of Object.keys(X)){let J=this._hostContext[$],K=X[$];if(GX(J,K))continue;Y[$]=K,Z=!0}if(Z)this._hostContext=X,this.sendHostContextChange(Y)}sendHostContextChange(X){return this.notification({method:"ui/notifications/host-context-changed",params:X})}sendToolInput(X){return this.notification({method:"ui/notifications/tool-input",params:X})}sendToolInputPartial(X){return this.notification({method:"ui/notifications/tool-input-partial",params:X})}sendToolResult(X){return this.notification({method:"ui/notifications/tool-result",params:X})}sendToolCancelled(X){return this.notification({method:"ui/notifications/tool-cancelled",params:X})}sendSandboxResourceReady(X){return this.notification({method:"ui/notifications/sandbox-resource-ready",params:X})}teardownResource(X,Y){return this.request({method:"ui/resource-teardown",params:X},S,Y)}sendResourceTeardown=this.teardownResource;callTool(X,Y){return this.request({method:"tools/call",params:X},XQ,Y)}listTools(X,Y){return this.request({method:"tools/list",params:X},aQ,Y)}async connect(X){if(this.transport)throw Error("AppBridge is already connected. Call close() before connecting again.");if(this._initializedReceived=!1,this._client){let Y=this._client.getServerCapabilities();if(!Y)throw Error("Client server capabilities not available");if(Y.tools){if(this.oncalltool=async(Z,$)=>{return this._client.request({method:"tools/call",params:Z},XQ,{signal:$.signal})},Y.tools.listChanged)this._client.setNotificationHandler(JX,(Z)=>this.sendToolListChanged(Z.params))}if(Y.resources){if(this.onlistresources=async(Z,$)=>{return this._client.request({method:"resources/list",params:Z},oQ,{signal:$.signal})},this.onlistresourcetemplates=async(Z,$)=>{return this._client.request({method:"resources/templates/list",params:Z},tQ,{signal:$.signal})},this.onreadresource=async(Z,$)=>{return this._client.request({method:"resources/read",params:Z},ZX,{signal:$.signal})},Y.resources.listChanged)this._client.setNotificationHandler($X,(Z)=>this.sendResourceListChanged(Z.params))}if(Y.prompts){if(this.onlistprompts=async(Z,$)=>{return this._client.request({method:"prompts/list",params:Z},lQ,{signal:$.signal})},Y.prompts.listChanged)this._client.setNotificationHandler(XX,(Z)=>this.sendPromptListChanged(Z.params))}}return super.connect(X)}}function GX(X,Y){return JSON.stringify(X)===JSON.stringify(Y)}export{LZ as isToolVisibilityModelOnly,PZ as isToolVisibilityAppOnly,FZ as getToolUiResourceUri,AZ as buildAllowAttribute,BQ as TOOL_RESULT_METHOD,V as TOOL_INPUT_PARTIAL_METHOD,jQ as TOOL_INPUT_METHOD,_Q as TOOL_CANCELLED_METHOD,KX as SUPPORTED_PROTOCOL_VERSIONS,WQ as SIZE_CHANGED_METHOD,NQ as SANDBOX_RESOURCE_READY_METHOD,GQ as SANDBOX_PROXY_READY_METHOD,i as RESOURCE_URI_META_KEY,zQ as RESOURCE_TEARDOWN_METHOD,pQ as RESOURCE_MIME_TYPE,OQ as REQUEST_TEARDOWN_METHOD,FQ as REQUEST_DISPLAY_MODE_METHOD,E as PostMessageTransport,JQ as OPEN_LINK_METHOD,d as McpUiUpdateModelContextRequestSchema,e as McpUiToolVisibilitySchema,v as McpUiToolResultNotificationSchema,MQ as McpUiToolMetaSchema,T as McpUiToolInputPartialNotificationSchema,R as McpUiToolInputNotificationSchema,M as McpUiToolCancelledNotificationSchema,r as McpUiThemeSchema,F as McpUiSupportedContentBlockModalitiesSchema,H as McpUiSizeChangedNotificationSchema,CQ as McpUiSandboxResourceReadyNotificationSchema,w as McpUiSandboxProxyReadyNotificationSchema,S as McpUiResourceTeardownResultSchema,C as McpUiResourceTeardownRequestSchema,z as McpUiResourcePermissionsSchema,TQ as McpUiResourceMetaSchema,O as McpUiResourceCspSchema,q as McpUiRequestTeardownNotificationSchema,g as McpUiRequestDisplayModeResultSchema,I as McpUiRequestDisplayModeRequestSchema,P as McpUiOpenLinkResultSchema,L as McpUiOpenLinkRequestSchema,U as McpUiMessageResultSchema,k as McpUiMessageRequestSchema,y as McpUiInitializedNotificationSchema,h as McpUiInitializeResultSchema,u as McpUiInitializeRequestSchema,s as McpUiHostStylesSchema,o as McpUiHostCssSchema,x as McpUiHostContextSchema,b as McpUiHostContextChangedNotificationSchema,t as McpUiHostCapabilitiesSchema,A as McpUiDownloadFileResultSchema,f as McpUiDownloadFileRequestSchema,B as McpUiDisplayModeSchema,a as McpUiAppCapabilitiesSchema,DQ as MESSAGE_METHOD,j as LATEST_PROTOCOL_VERSION,IQ as INITIALIZE_METHOD,VQ as INITIALIZED_METHOD,EQ as HOST_CONTEXT_CHANGED_METHOD,KQ as DOWNLOAD_FILE_METHOD,DX as AppBridge};

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

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