enpilink 1.0.2

package/dist/web/bridges/apps-sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/types.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA8HD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD","sourcesContent":["import type { UnknownObject } from \"../../types.js\";\nimport type {\n  CallToolArgs,\n  CallToolResponse,\n  FileMetadata,\n  Intent,\n  Notification,\n  RequestModalOptions,\n  UploadFileOptions,\n} from \"../types.js\";\n\ntype DisplayMode = \"pip\" | \"inline\" | \"fullscreen\" | \"modal\";\ntype RequestDisplayMode = Exclude<DisplayMode, \"modal\">;\n\nexport type AppsSdkWidgetState = {\n  modelContent: Record<string, unknown>;\n  privateContent: Record<string, unknown>;\n  imageIds?: string[];\n};\n\nexport const TOOL_RESPONSE_EVENT_TYPE = \"openai:tool_response\";\nexport class ToolResponseEvent extends CustomEvent<{\n  tool: { name: string; args: UnknownObject };\n}> {\n  override readonly type = TOOL_RESPONSE_EVENT_TYPE;\n}\n\ndeclare global {\n  interface Window {\n    openai: AppsSdkMethods & AppsSdkContext;\n  }\n\n  interface WindowEventMap {\n    [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;\n  }\n}\n\nexport type AppsSdkContext<\n  ToolInput extends UnknownObject = Record<never, unknown>,\n  ToolOutput extends UnknownObject = UnknownObject,\n  ToolResponseMetadata extends UnknownObject = UnknownObject,\n  WS extends AppsSdkWidgetState = AppsSdkWidgetState,\n> = {\n  theme: Theme;\n  userAgent: UserAgent;\n  locale: string;\n\n  // layout\n  maxHeight: number | undefined;\n  displayMode: DisplayMode;\n  safeArea: SafeArea;\n  view: View;\n\n  // state\n  toolInput: ToolInput;\n  toolOutput: ToolOutput | { text: string } | null;\n  toolResponseMetadata: ToolResponseMetadata | null;\n  widgetState: WS | null;\n};\n\nexport type AppsSdkMethods<WS extends AppsSdkWidgetState = AppsSdkWidgetState> =\n  {\n    /** Calls a tool on your MCP. Returns the full response. */\n    callTool: <\n      ToolArgs extends CallToolArgs = null,\n      ToolResponse extends CallToolResponse = CallToolResponse,\n    >(\n      name: string,\n      args: ToolArgs,\n    ) => Promise<ToolResponse>;\n\n    /**\n     * Triggers a followup turn in the ChatGPT conversation\n     * scrollToBottom is optional, defaults to true, and can be\n     * set to false to prevent auto-scroll.\n     */\n    sendFollowUpMessage: (args: {\n      prompt: string;\n      scrollToBottom?: boolean;\n    }) => Promise<void>;\n\n    /** Opens an external link, redirects web page or mobile app */\n    openExternal(args: { href: string; redirectUrl?: false }): void;\n\n    /** For transitioning an app from inline to fullscreen or pip */\n    requestDisplayMode: (args: { mode: RequestDisplayMode }) => Promise<{\n      /**\n       * The granted display mode. The host may reject the request.\n       * For mobile, PiP is always coerced to fullscreen.\n       */\n      mode: RequestDisplayMode;\n    }>;\n\n    /** Requests the host to close (dismiss) the widget. */\n    requestClose: () => Promise<void>;\n\n    /**\n     * Sets the widget state.\n     * This state is persisted across widget renders.\n     */\n    setWidgetState: (state: WS) => Promise<void>;\n\n    /**\n     * Opens a modal portaled outside of the widget iFrame.\n     * This ensures the modal is correctly displayed and not limited to the widget's area.\n     */\n    requestModal: (args: RequestModalOptions) => Promise<void>;\n\n    /** Uploads a new file to the host. Pass `{ library: true }` to also save to the user's ChatGPT file library. */\n    uploadFile: (\n      file: File,\n      options?: UploadFileOptions,\n    ) => Promise<FileMetadata>;\n\n    /**\n     * Opens ChatGPT's file library picker and returns app-authorized files.\n     * Feature-detect before using: this method may not be available on all host versions.\n     */\n    selectFiles?: () => Promise<FileMetadata[]>;\n\n    /**\n     * Downloads a file from the host. Works for files uploaded by the widget,\n     * files selected via selectFiles(), or files provided via tool/file params.\n     */\n    getFileDownloadUrl: (\n      file: FileMetadata,\n    ) => Promise<{ downloadUrl: string }>;\n\n    /**\n     * Sets the open in app URL.\n     * This URL will be opened in the app when the user clicks on the top right button in fullscreen mode.\n     */\n    setOpenInAppUrl: (args: { href: string }) => Promise<void>;\n\n    /**\n     * enpilink extension (NOT part of the ChatGPT Apps SDK): surface a\n     * notification to the host. Optional — feature-detected by the adaptor; if\n     * the host doesn't provide it, the adaptor falls back to\n     * `window.parent.postMessage`. The devtools emulator implements it.\n     */\n    notify?: (notification: Notification) => Promise<void>;\n\n    /**\n     * enpilink extension (NOT part of the ChatGPT Apps SDK): forward a\n     * high-level intent to the host. Optional — feature-detected by the\n     * adaptor; falls back to `window.parent.postMessage` when absent. The\n     * devtools emulator implements it.\n     */\n    sendIntent?: (intent: Intent) => Promise<void>;\n  };\n\n// Dispatched when any global changes in the host page\nexport const SET_GLOBALS_EVENT_TYPE = \"openai:set_globals\";\nexport class SetGlobalsEvent extends CustomEvent<{\n  globals: Partial<AppsSdkContext>;\n}> {\n  override readonly type = SET_GLOBALS_EVENT_TYPE;\n}\n\ntype View = {\n  mode: DisplayMode;\n  params?: Record<string, unknown>;\n};\n\ntype Theme = \"light\" | \"dark\";\n\ntype SafeAreaInsets = {\n  top: number;\n  bottom: number;\n  left: number;\n  right: number;\n};\n\ntype SafeArea = {\n  insets: SafeAreaInsets;\n};\n\ntype DeviceType = \"mobile\" | \"tablet\" | \"desktop\" | \"unknown\";\n\ntype UserAgent = {\n  device: { type: DeviceType };\n  capabilities: {\n    hover: boolean;\n    touch: boolean;\n  };\n};\n"]}

package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts

@@ -0,0 +1,13 @@
+import type { AppsSdkContext } from "./types.js";
+/**
+ * Read a single key from the raw Apps SDK (`window.openai`) context.
+ *
+ * Advanced escape hatch — prefer the cross-host hooks (`useLayout`, `useUser`,
+ * `useToolInfo`, etc.) which work in both Apps SDK and MCP Apps. Reach for
+ * this when you need ChatGPT-only fields not surfaced by the public hooks.
+ *
+ * Throws if called outside the Apps SDK runtime.
+ *
+ * @see https://docs.enpitech.dev/api-reference/use-apps-sdk-context
+ */
+export declare function useAppsSdkContext<K extends keyof AppsSdkContext>(key: K): AppsSdkContext[K];

package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js

@@ -0,0 +1,18 @@
+import { useSyncExternalStore } from "react";
+import { AppsSdkBridge } from "./bridge.js";
+/**
+ * Read a single key from the raw Apps SDK (`window.openai`) context.
+ *
+ * Advanced escape hatch — prefer the cross-host hooks (`useLayout`, `useUser`,
+ * `useToolInfo`, etc.) which work in both Apps SDK and MCP Apps. Reach for
+ * this when you need ChatGPT-only fields not surfaced by the public hooks.
+ *
+ * Throws if called outside the Apps SDK runtime.
+ *
+ * @see https://docs.enpitech.dev/api-reference/use-apps-sdk-context
+ */
+export function useAppsSdkContext(key) {
+    const bridge = AppsSdkBridge.getInstance();
+    return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
+}
+//# sourceMappingURL=use-apps-sdk-context.js.map

package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-apps-sdk-context.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/use-apps-sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAM;IAEN,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC","sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport { AppsSdkBridge } from \"./bridge.js\";\nimport type { AppsSdkContext } from \"./types.js\";\n\n/**\n * Read a single key from the raw Apps SDK (`window.openai`) context.\n *\n * Advanced escape hatch — prefer the cross-host hooks (`useLayout`, `useUser`,\n * `useToolInfo`, etc.) which work in both Apps SDK and MCP Apps. Reach for\n * this when you need ChatGPT-only fields not surfaced by the public hooks.\n *\n * Throws if called outside the Apps SDK runtime.\n *\n * @see https://docs.enpitech.dev/api-reference/use-apps-sdk-context\n */\nexport function useAppsSdkContext<K extends keyof AppsSdkContext>(\n  key: K,\n): AppsSdkContext[K] {\n  const bridge = AppsSdkBridge.getInstance();\n  return useSyncExternalStore(bridge.subscribe(key), () =>\n    bridge.getSnapshot(key),\n  );\n}\n"]}

package/dist/web/bridges/get-adaptor.d.ts

@@ -0,0 +1,9 @@
+import type { Adaptor } from "./types.js";
+/**
+ * @internal
+ * Resolve the host-specific {@link Adaptor} based on `window.enpilink.hostType`.
+ * Prefer the documented hooks (`useCallTool`, `useViewState`, etc.) over
+ * calling this directly — it's the escape hatch used by the hooks themselves
+ * and by advanced integrations.
+ */
+export declare const getAdaptor: () => Adaptor;

package/dist/web/bridges/get-adaptor.js

@@ -0,0 +1,15 @@
+import { AppsSdkAdaptor } from "./apps-sdk/adaptor.js";
+import { McpAppAdaptor } from "./mcp-app/adaptor.js";
+/**
+ * @internal
+ * Resolve the host-specific {@link Adaptor} based on `window.enpilink.hostType`.
+ * Prefer the documented hooks (`useCallTool`, `useViewState`, etc.) over
+ * calling this directly — it's the escape hatch used by the hooks themselves
+ * and by advanced integrations.
+ */
+export const getAdaptor = () => {
+    return window.enpilink.hostType === "apps-sdk"
+        ? AppsSdkAdaptor.getInstance()
+        : McpAppAdaptor.getInstance();
+};
+//# sourceMappingURL=get-adaptor.js.map

package/dist/web/bridges/get-adaptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,UAAU;QAC5C,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC,CAAC","sourcesContent":["import { AppsSdkAdaptor } from \"./apps-sdk/adaptor.js\";\nimport { McpAppAdaptor } from \"./mcp-app/adaptor.js\";\nimport type { Adaptor } from \"./types.js\";\n\n/**\n * @internal\n * Resolve the host-specific {@link Adaptor} based on `window.enpilink.hostType`.\n * Prefer the documented hooks (`useCallTool`, `useViewState`, etc.) over\n * calling this directly — it's the escape hatch used by the hooks themselves\n * and by advanced integrations.\n */\nexport const getAdaptor = (): Adaptor => {\n  return window.enpilink.hostType === \"apps-sdk\"\n    ? AppsSdkAdaptor.getInstance()\n    : McpAppAdaptor.getInstance();\n};\n"]}

package/dist/web/bridges/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./apps-sdk/index.js";
+export { getAdaptor } from "./get-adaptor.js";
+export * from "./mcp-app/index.js";
+export * from "./types.js";
+export { useHostContext } from "./use-host-context.js";

package/dist/web/bridges/index.js

@@ -0,0 +1,6 @@
+export * from "./apps-sdk/index.js";
+export { getAdaptor } from "./get-adaptor.js";
+export * from "./mcp-app/index.js";
+export * from "./types.js";
+export { useHostContext } from "./use-host-context.js";
+//# sourceMappingURL=index.js.map

package/dist/web/bridges/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/bridges/index.tsx"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export * from \"./apps-sdk/index.js\";\nexport { getAdaptor } from \"./get-adaptor.js\";\nexport * from \"./mcp-app/index.js\";\nexport * from \"./types.js\";\nexport { useHostContext } from \"./use-host-context.js\";\n"]}

package/dist/web/bridges/mcp-app/adaptor.d.ts

@@ -0,0 +1,81 @@
+import type { Adaptor, AnyViewToolHandler, CallToolResponse, DownloadParams, DownloadResult, HostContext, HostContextStore, Intent, Notification, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, SendFollowUpMessageOptions, SetViewStateAction, ViewToolConfig } from "../types.js";
+/** @internal MCP Apps implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
+export declare class McpAppAdaptor implements Adaptor {
+    private static instance;
+    private stores;
+    private _viewState;
+    private viewStateListeners;
+    private _viewUUID;
+    private _displayState;
+    private displayListeners;
+    private constructor();
+    static getInstance(): McpAppAdaptor;
+    static resetInstance(): void;
+    getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
+    callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
+    requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
+        [x: string]: unknown;
+        mode: "inline" | "fullscreen" | "pip";
+    }>;
+    requestClose: () => Promise<void>;
+    requestSize: (size: RequestSizeOptions) => Promise<void>;
+    sendFollowUpMessage: (prompt: string, _options?: SendFollowUpMessageOptions) => Promise<void>;
+    /**
+     * Surface a notification to the host via the MCP Apps logging channel.
+     *
+     * Uses the **real** MCP protocol: `app.sendLog` (`notifications/message`).
+     * The `level` maps to the syslog levels the spec defines; `"success"` has no
+     * equivalent and is coerced to `"info"` (the structured `title`/`data` are
+     * preserved in the log payload). Hosts may render this as a toast or simply
+     * record it for debugging. Best-effort — failures are swallowed; never throws.
+     *
+     * @remarks Per-runtime: apps-sdk surfaces the same call via
+     * `window.openai.notify` / a `postMessage` fallback (see the apps-sdk
+     * adaptor); the MCP Apps runtime uses standard `notifications/message`.
+     */
+    notify: (notification: Notification) => Promise<void>;
+    /**
+     * Forward a high-level intent to the host.
+     *
+     * The MCP Apps spec has **no intent/action primitive**, so this is an
+     * **enpilink extension**: the intent is delivered best-effort over the
+     * standard `notifications/message` channel (`app.sendLog`) tagged with
+     * `logger: "enpilink/intent"` and a structured `{ intent, params }` payload.
+     * A compliant host that doesn't understand intents simply records it as a
+     * log entry (no error). Never throws.
+     *
+     * @remarks enpilink extension — not part of the MCP Apps spec. Real-host
+     * routing of intents is therefore best-effort and unverifiable here.
+     */
+    sendIntent: (intent: Intent) => Promise<void>;
+    download: (params: DownloadParams) => Promise<DownloadResult>;
+    openExternal(href: string, options?: OpenExternalOptions): void;
+    private initializeStores;
+    setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
+    /**
+     * @throws File upload is not supported in MCP App.
+     */
+    uploadFile(): Promise<{
+        fileId: string;
+    }>;
+    /**
+     * @throws File download is not supported in MCP App.
+     */
+    getFileDownloadUrl(): Promise<{
+        downloadUrl: string;
+    }>;
+    /**
+     * @throws File selection is not supported in MCP App.
+     */
+    selectFiles(): Promise<{
+        fileId: string;
+    }[]>;
+    openModal(options: RequestModalOptions): void;
+    closeModal(): void;
+    setOpenInAppUrl(_href: string): Promise<void>;
+    registerViewTool: (config: ViewToolConfig, handler: AnyViewToolHandler) => (() => void);
+    private subscribeToViewUUID;
+    private restoreFromLocalStorage;
+    private persistToLocalStorage;
+    private createHostContextStore;
+}

package/dist/web/bridges/mcp-app/adaptor.js

@@ -0,0 +1,346 @@
+import { dequal } from "dequal/lite";
+import { McpAppBridge } from "./bridge.js";
+const STORAGE_PREFIX = "sb:";
+const MAX_STORAGE_ENTRIES = 200;
+function findStorageKey(viewUUID) {
+    const suffix = `:${viewUUID}`;
+    for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {
+            return key;
+        }
+    }
+    return undefined;
+}
+/** @internal MCP Apps implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
+export class McpAppAdaptor {
+    static instance = null;
+    stores;
+    _viewState = null;
+    viewStateListeners = new Set();
+    _viewUUID = null;
+    _displayState = {
+        mode: "inline",
+    };
+    displayListeners = new Set();
+    constructor() {
+        this.stores = this.initializeStores();
+        this.subscribeToViewUUID();
+    }
+    static getInstance() {
+        if (!McpAppAdaptor.instance) {
+            McpAppAdaptor.instance = new McpAppAdaptor();
+        }
+        return McpAppAdaptor.instance;
+    }
+    static resetInstance() {
+        McpAppAdaptor.instance = null;
+    }
+    getHostContextStore(key) {
+        return this.stores[key];
+    }
+    callTool = async (name, args) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        const response = await app.callServerTool({
+            name,
+            arguments: args ?? undefined,
+        });
+        return {
+            content: response.content,
+            structuredContent: response.structuredContent ?? {},
+            isError: response.isError ?? false,
+            meta: response._meta ?? {},
+        };
+    };
+    requestDisplayMode = async (mode) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        return app.requestDisplayMode({ mode });
+    };
+    requestClose = async () => {
+        const app = await McpAppBridge.getInstance().getApp();
+        await app.requestTeardown();
+    };
+    requestSize = async (size) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        await app.sendSizeChanged(size);
+    };
+    sendFollowUpMessage = async (prompt, _options) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        await app.sendMessage({
+            role: "user",
+            content: [
+                {
+                    type: "text",
+                    text: prompt,
+                },
+            ],
+        });
+    };
+    /**
+     * Surface a notification to the host via the MCP Apps logging channel.
+     *
+     * Uses the **real** MCP protocol: `app.sendLog` (`notifications/message`).
+     * The `level` maps to the syslog levels the spec defines; `"success"` has no
+     * equivalent and is coerced to `"info"` (the structured `title`/`data` are
+     * preserved in the log payload). Hosts may render this as a toast or simply
+     * record it for debugging. Best-effort — failures are swallowed; never throws.
+     *
+     * @remarks Per-runtime: apps-sdk surfaces the same call via
+     * `window.openai.notify` / a `postMessage` fallback (see the apps-sdk
+     * adaptor); the MCP Apps runtime uses standard `notifications/message`.
+     */
+    notify = async (notification) => {
+        try {
+            const app = await McpAppBridge.getInstance().getApp();
+            const level = notification.level === "success" ? "info" : notification.level;
+            await app.sendLog({
+                level: level ?? "info",
+                logger: "enpilink",
+                data: {
+                    ...(notification.title ? { title: notification.title } : {}),
+                    message: notification.message,
+                    ...(notification.level ? { level: notification.level } : {}),
+                    ...(notification.data !== undefined
+                        ? { data: notification.data }
+                        : {}),
+                },
+            });
+        }
+        catch (error) {
+            console.warn("[enpilink] notify: failed to deliver notification", error);
+        }
+    };
+    /**
+     * Forward a high-level intent to the host.
+     *
+     * The MCP Apps spec has **no intent/action primitive**, so this is an
+     * **enpilink extension**: the intent is delivered best-effort over the
+     * standard `notifications/message` channel (`app.sendLog`) tagged with
+     * `logger: "enpilink/intent"` and a structured `{ intent, params }` payload.
+     * A compliant host that doesn't understand intents simply records it as a
+     * log entry (no error). Never throws.
+     *
+     * @remarks enpilink extension — not part of the MCP Apps spec. Real-host
+     * routing of intents is therefore best-effort and unverifiable here.
+     */
+    sendIntent = async (intent) => {
+        try {
+            const app = await McpAppBridge.getInstance().getApp();
+            await app.sendLog({
+                level: "info",
+                logger: "enpilink/intent",
+                data: {
+                    intent: intent.name,
+                    ...(intent.params ? { params: intent.params } : {}),
+                },
+            });
+        }
+        catch (error) {
+            console.warn("[enpilink] sendIntent: failed to deliver intent", error);
+        }
+    };
+    download = async (params) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        if (!app.getHostCapabilities()?.downloadFile) {
+            console.error("[enpilink] download: host does not support ui/download-file");
+            return { isError: true };
+        }
+        return app.downloadFile(params);
+    };
+    openExternal(href, options) {
+        if (options?.redirectUrl === false) {
+            console.warn("[enpilink] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.");
+        }
+        McpAppBridge.getInstance()
+            .getApp()
+            .then((app) => app.openLink({ url: href }))
+            .catch((err) => {
+            console.error("Failed to open external link:", err);
+        });
+    }
+    initializeStores() {
+        return {
+            theme: this.createHostContextStore(["theme"], ({ theme }) => theme ?? "light"),
+            locale: this.createHostContextStore(["locale"], ({ locale }) => locale ?? "en-US"),
+            safeArea: this.createHostContextStore(["safeAreaInsets"], ({ safeAreaInsets }) => ({
+                insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },
+            })),
+            displayMode: this.createHostContextStore(["displayMode"], ({ displayMode }) => displayMode ?? "inline"),
+            maxHeight: this.createHostContextStore(["containerDimensions"], ({ containerDimensions }) => {
+                if (containerDimensions && "maxHeight" in containerDimensions) {
+                    return containerDimensions.maxHeight;
+                }
+                return undefined;
+            }),
+            userAgent: this.createHostContextStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
+                device: {
+                    type: platform === "web" ? "desktop" : (platform ?? "unknown"),
+                },
+                capabilities: {
+                    hover: true,
+                    touch: true,
+                    ...deviceCapabilities,
+                },
+            })),
+            toolInput: this.createHostContextStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
+            toolOutput: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
+            toolResponseMetadata: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
+            display: {
+                subscribe: (onChange) => {
+                    this.displayListeners.add(onChange);
+                    return () => {
+                        this.displayListeners.delete(onChange);
+                    };
+                },
+                getSnapshot: () => this._displayState,
+            },
+            viewState: {
+                subscribe: (onChange) => {
+                    this.viewStateListeners.add(onChange);
+                    return () => {
+                        this.viewStateListeners.delete(onChange);
+                    };
+                },
+                getSnapshot: () => this._viewState,
+            },
+        };
+    }
+    setViewState = async (stateOrUpdater) => {
+        const newState = typeof stateOrUpdater === "function"
+            ? stateOrUpdater(this._viewState)
+            : stateOrUpdater;
+        // must happen before the async bridge call to ensure the state is updated immediately for the UI,
+        // otherwise successive calls to setViewState may have stale state
+        this._viewState = newState;
+        this.viewStateListeners.forEach((listener) => {
+            listener();
+        });
+        this.persistToLocalStorage(newState);
+        try {
+            const app = await McpAppBridge.getInstance().getApp();
+            await app.updateModelContext({
+                structuredContent: newState,
+                content: [{ type: "text", text: JSON.stringify(newState) }],
+            });
+        }
+        catch (error) {
+            console.error("Failed to update view state in MCP App.", error);
+        }
+    };
+    /**
+     * @throws File upload is not supported in MCP App.
+     */
+    uploadFile() {
+        throw new Error("File upload is not supported in MCP App.");
+    }
+    /**
+     * @throws File download is not supported in MCP App.
+     */
+    getFileDownloadUrl() {
+        throw new Error("File download is not supported in MCP App.");
+    }
+    /**
+     * @throws File selection is not supported in MCP App.
+     */
+    selectFiles() {
+        throw new Error("File selection is not supported in MCP App.");
+    }
+    openModal(options) {
+        this._displayState = { mode: "modal", params: options.params };
+        this.displayListeners.forEach((listener) => {
+            listener();
+        });
+    }
+    closeModal() {
+        this._displayState = { mode: "inline" };
+        this.displayListeners.forEach((listener) => {
+            listener();
+        });
+    }
+    setOpenInAppUrl(_href) {
+        throw new Error("setOpenInAppUrl is not implemented in MCP App.");
+    }
+    registerViewTool = (config, handler) => {
+        return McpAppBridge.getInstance().registerViewTool(config, handler);
+    };
+    subscribeToViewUUID() {
+        const bridge = McpAppBridge.getInstance();
+        bridge.subscribe("toolResult")(() => {
+            const toolResult = bridge.getSnapshot("toolResult");
+            const viewUUID = toolResult?._meta?.viewUUID;
+            if (viewUUID && viewUUID !== this._viewUUID) {
+                this._viewUUID = viewUUID;
+                this.restoreFromLocalStorage(viewUUID);
+            }
+        });
+    }
+    // localStorage keys: sb:{unix_ms}:{viewUUID}
+    // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.
+    restoreFromLocalStorage(viewUUID) {
+        try {
+            const existingKey = findStorageKey(viewUUID);
+            if (existingKey) {
+                const stored = localStorage.getItem(existingKey);
+                if (stored !== null) {
+                    this._viewState = JSON.parse(stored);
+                    this.viewStateListeners.forEach((listener) => {
+                        listener();
+                    });
+                }
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    persistToLocalStorage(state) {
+        if (!this._viewUUID || state === null) {
+            return;
+        }
+        try {
+            // Remove old key for this view, write with fresh timestamp (LRU)
+            const oldKey = findStorageKey(this._viewUUID);
+            if (oldKey) {
+                localStorage.removeItem(oldKey);
+            }
+            const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
+            localStorage.setItem(newKey, JSON.stringify(state));
+            // lru cleanup
+            const keys = [];
+            for (let i = 0; i < localStorage.length; i++) {
+                const key = localStorage.key(i);
+                if (key?.startsWith(STORAGE_PREFIX)) {
+                    keys.push(key);
+                }
+            }
+            if (keys.length <= MAX_STORAGE_ENTRIES) {
+                return;
+            }
+            keys.sort();
+            const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);
+            for (const key of toRemove) {
+                localStorage.removeItem(key);
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    createHostContextStore(keys, computeSnapshot) {
+        const bridge = McpAppBridge.getInstance();
+        let cachedValue;
+        return {
+            subscribe: bridge.subscribe(keys),
+            getSnapshot: () => {
+                const context = Object.fromEntries(keys.map((k) => [k, bridge.getSnapshot(k)]));
+                const newValue = computeSnapshot(context);
+                if (cachedValue !== undefined && dequal(cachedValue, newValue)) {
+                    return cachedValue;
+                }
+                cachedValue = newValue;
+                return newValue;
+            },
+        };
+    }
+}
+//# sourceMappingURL=adaptor.js.map

package/dist/web/bridges/mcp-app/adaptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/adaptor.ts"],"names":[],"mappings":"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","sourcesContent":["import { dequal } from \"dequal/lite\";\nimport type {\n  Adaptor,\n  AnyViewToolHandler,\n  CallToolResponse,\n  DownloadParams,\n  DownloadResult,\n  HostContext,\n  HostContextStore,\n  Intent,\n  Notification,\n  OpenExternalOptions,\n  RequestDisplayMode,\n  RequestModalOptions,\n  RequestSizeOptions,\n  SendFollowUpMessageOptions,\n  SetViewStateAction,\n  ViewToolConfig,\n} from \"../types.js\";\nimport { McpAppBridge } from \"./bridge.js\";\nimport type { McpAppContext, McpAppContextKey } from \"./types.js\";\n\n/** @internal */\ntype PickContext<K extends readonly McpAppContextKey[]> = {\n  [P in K[number]]: McpAppContext[P];\n};\n\nconst STORAGE_PREFIX = \"sb:\";\nconst MAX_STORAGE_ENTRIES = 200;\n\nfunction findStorageKey(viewUUID: string): string | undefined {\n  const suffix = `:${viewUUID}`;\n  for (let i = 0; i < localStorage.length; i++) {\n    const key = localStorage.key(i);\n    if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {\n      return key;\n    }\n  }\n  return undefined;\n}\n\n/** @internal MCP Apps implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */\nexport class McpAppAdaptor implements Adaptor {\n  private static instance: McpAppAdaptor | null = null;\n  private stores: {\n    [K in keyof HostContext]: HostContextStore<K>;\n  };\n  private _viewState: HostContext[\"viewState\"] = null;\n  private viewStateListeners = new Set<() => void>();\n  private _viewUUID: string | null = null;\n\n  private _displayState: HostContext[\"display\"] = {\n    mode: \"inline\",\n  };\n  private displayListeners = new Set<() => void>();\n\n  private constructor() {\n    this.stores = this.initializeStores();\n    this.subscribeToViewUUID();\n  }\n\n  public static getInstance(): McpAppAdaptor {\n    if (!McpAppAdaptor.instance) {\n      McpAppAdaptor.instance = new McpAppAdaptor();\n    }\n    return McpAppAdaptor.instance;\n  }\n\n  public static resetInstance(): void {\n    McpAppAdaptor.instance = null;\n  }\n\n  public getHostContextStore<K extends keyof HostContext>(\n    key: K,\n  ): HostContextStore<K> {\n    return this.stores[key];\n  }\n\n  public callTool = async <\n    ToolArgs extends Record<string, unknown> | null = null,\n    ToolResponse extends CallToolResponse = CallToolResponse,\n  >(\n    name: string,\n    args: ToolArgs,\n  ): Promise<ToolResponse> => {\n    const app = await McpAppBridge.getInstance().getApp();\n    const response = await app.callServerTool({\n      name,\n      arguments: args ?? undefined,\n    });\n\n    return {\n      content: response.content,\n      structuredContent: response.structuredContent ?? {},\n      isError: response.isError ?? false,\n      meta: response._meta ?? {},\n    } as ToolResponse;\n  };\n\n  public requestDisplayMode = async (mode: RequestDisplayMode) => {\n    const app = await McpAppBridge.getInstance().getApp();\n    return app.requestDisplayMode({ mode });\n  };\n\n  public requestClose = async (): Promise<void> => {\n    const app = await McpAppBridge.getInstance().getApp();\n    await app.requestTeardown();\n  };\n\n  public requestSize = async (size: RequestSizeOptions): Promise<void> => {\n    const app = await McpAppBridge.getInstance().getApp();\n    await app.sendSizeChanged(size);\n  };\n\n  public sendFollowUpMessage = async (\n    prompt: string,\n    _options?: SendFollowUpMessageOptions,\n  ) => {\n    const app = await McpAppBridge.getInstance().getApp();\n    await app.sendMessage({\n      role: \"user\",\n      content: [\n        {\n          type: \"text\",\n          text: prompt,\n        },\n      ],\n    });\n  };\n\n  /**\n   * Surface a notification to the host via the MCP Apps logging channel.\n   *\n   * Uses the **real** MCP protocol: `app.sendLog` (`notifications/message`).\n   * The `level` maps to the syslog levels the spec defines; `\"success\"` has no\n   * equivalent and is coerced to `\"info\"` (the structured `title`/`data` are\n   * preserved in the log payload). Hosts may render this as a toast or simply\n   * record it for debugging. Best-effort — failures are swallowed; never throws.\n   *\n   * @remarks Per-runtime: apps-sdk surfaces the same call via\n   * `window.openai.notify` / a `postMessage` fallback (see the apps-sdk\n   * adaptor); the MCP Apps runtime uses standard `notifications/message`.\n   */\n  public notify = async (notification: Notification): Promise<void> => {\n    try {\n      const app = await McpAppBridge.getInstance().getApp();\n      const level =\n        notification.level === \"success\" ? \"info\" : notification.level;\n      await app.sendLog({\n        level: level ?? \"info\",\n        logger: \"enpilink\",\n        data: {\n          ...(notification.title ? { title: notification.title } : {}),\n          message: notification.message,\n          ...(notification.level ? { level: notification.level } : {}),\n          ...(notification.data !== undefined\n            ? { data: notification.data }\n            : {}),\n        },\n      });\n    } catch (error) {\n      console.warn(\"[enpilink] notify: failed to deliver notification\", error);\n    }\n  };\n\n  /**\n   * Forward a high-level intent to the host.\n   *\n   * The MCP Apps spec has **no intent/action primitive**, so this is an\n   * **enpilink extension**: the intent is delivered best-effort over the\n   * standard `notifications/message` channel (`app.sendLog`) tagged with\n   * `logger: \"enpilink/intent\"` and a structured `{ intent, params }` payload.\n   * A compliant host that doesn't understand intents simply records it as a\n   * log entry (no error). Never throws.\n   *\n   * @remarks enpilink extension — not part of the MCP Apps spec. Real-host\n   * routing of intents is therefore best-effort and unverifiable here.\n   */\n  public sendIntent = async (intent: Intent): Promise<void> => {\n    try {\n      const app = await McpAppBridge.getInstance().getApp();\n      await app.sendLog({\n        level: \"info\",\n        logger: \"enpilink/intent\",\n        data: {\n          intent: intent.name,\n          ...(intent.params ? { params: intent.params } : {}),\n        },\n      });\n    } catch (error) {\n      console.warn(\"[enpilink] sendIntent: failed to deliver intent\", error);\n    }\n  };\n\n  public download = async (params: DownloadParams): Promise<DownloadResult> => {\n    const app = await McpAppBridge.getInstance().getApp();\n    if (!app.getHostCapabilities()?.downloadFile) {\n      console.error(\n        \"[enpilink] download: host does not support ui/download-file\",\n      );\n      return { isError: true };\n    }\n    return app.downloadFile(params);\n  };\n\n  public openExternal(href: string, options?: OpenExternalOptions): void {\n    if (options?.redirectUrl === false) {\n      console.warn(\n        \"[enpilink] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.\",\n      );\n    }\n\n    McpAppBridge.getInstance()\n      .getApp()\n      .then((app) => app.openLink({ url: href }))\n      .catch((err) => {\n        console.error(\"Failed to open external link:\", err);\n      });\n  }\n\n  private initializeStores(): {\n    [K in keyof HostContext]: HostContextStore<K>;\n  } {\n    return {\n      theme: this.createHostContextStore(\n        [\"theme\"],\n        ({ theme }) => theme ?? \"light\",\n      ),\n      locale: this.createHostContextStore(\n        [\"locale\"],\n        ({ locale }) => locale ?? \"en-US\",\n      ),\n      safeArea: this.createHostContextStore(\n        [\"safeAreaInsets\"],\n        ({ safeAreaInsets }) => ({\n          insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },\n        }),\n      ),\n      displayMode: this.createHostContextStore(\n        [\"displayMode\"],\n        ({ displayMode }) => displayMode ?? \"inline\",\n      ),\n      maxHeight: this.createHostContextStore(\n        [\"containerDimensions\"],\n        ({ containerDimensions }) => {\n          if (containerDimensions && \"maxHeight\" in containerDimensions) {\n            return containerDimensions.maxHeight;\n          }\n\n          return undefined;\n        },\n      ),\n      userAgent: this.createHostContextStore(\n        [\"platform\", \"deviceCapabilities\"],\n        ({ platform, deviceCapabilities }) => ({\n          device: {\n            type: platform === \"web\" ? \"desktop\" : (platform ?? \"unknown\"),\n          },\n          capabilities: {\n            hover: true,\n            touch: true,\n            ...deviceCapabilities,\n          },\n        }),\n      ),\n      toolInput: this.createHostContextStore(\n        [\"toolInput\"],\n        ({ toolInput }) => toolInput ?? null,\n      ),\n      toolOutput: this.createHostContextStore(\n        [\"toolResult\"],\n        ({ toolResult }) => toolResult?.structuredContent ?? null,\n      ),\n      toolResponseMetadata: this.createHostContextStore(\n        [\"toolResult\"],\n        ({ toolResult }) => toolResult?._meta ?? null,\n      ),\n      display: {\n        subscribe: (onChange: () => void) => {\n          this.displayListeners.add(onChange);\n          return () => {\n            this.displayListeners.delete(onChange);\n          };\n        },\n        getSnapshot: () => this._displayState,\n      },\n      viewState: {\n        subscribe: (onChange: () => void) => {\n          this.viewStateListeners.add(onChange);\n          return () => {\n            this.viewStateListeners.delete(onChange);\n          };\n        },\n        getSnapshot: () => this._viewState,\n      },\n    };\n  }\n\n  public setViewState = async (\n    stateOrUpdater: SetViewStateAction,\n  ): Promise<void> => {\n    const newState =\n      typeof stateOrUpdater === \"function\"\n        ? stateOrUpdater(this._viewState)\n        : stateOrUpdater;\n\n    // must happen before the async bridge call to ensure the state is updated immediately for the UI,\n    // otherwise successive calls to setViewState may have stale state\n    this._viewState = newState;\n    this.viewStateListeners.forEach((listener) => {\n      listener();\n    });\n\n    this.persistToLocalStorage(newState);\n\n    try {\n      const app = await McpAppBridge.getInstance().getApp();\n      await app.updateModelContext({\n        structuredContent: newState,\n        content: [{ type: \"text\", text: JSON.stringify(newState) }],\n      });\n    } catch (error) {\n      console.error(\"Failed to update view state in MCP App.\", error);\n    }\n  };\n\n  /**\n   * @throws File upload is not supported in MCP App.\n   */\n  public uploadFile(): Promise<{ fileId: string }> {\n    throw new Error(\"File upload is not supported in MCP App.\");\n  }\n\n  /**\n   * @throws File download is not supported in MCP App.\n   */\n  public getFileDownloadUrl(): Promise<{ downloadUrl: string }> {\n    throw new Error(\"File download is not supported in MCP App.\");\n  }\n\n  /**\n   * @throws File selection is not supported in MCP App.\n   */\n  public selectFiles(): Promise<{ fileId: string }[]> {\n    throw new Error(\"File selection is not supported in MCP App.\");\n  }\n\n  public openModal(options: RequestModalOptions) {\n    this._displayState = { mode: \"modal\", params: options.params };\n    this.displayListeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  public closeModal() {\n    this._displayState = { mode: \"inline\" };\n    this.displayListeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  public setOpenInAppUrl(_href: string): Promise<void> {\n    throw new Error(\"setOpenInAppUrl is not implemented in MCP App.\");\n  }\n\n  public registerViewTool = (\n    config: ViewToolConfig,\n    handler: AnyViewToolHandler,\n  ): (() => void) => {\n    return McpAppBridge.getInstance().registerViewTool(config, handler);\n  };\n\n  private subscribeToViewUUID(): void {\n    const bridge = McpAppBridge.getInstance();\n    bridge.subscribe(\"toolResult\")(() => {\n      const toolResult = bridge.getSnapshot(\"toolResult\");\n      const viewUUID = (\n        toolResult?._meta as Record<string, unknown> | undefined\n      )?.viewUUID as string | undefined;\n\n      if (viewUUID && viewUUID !== this._viewUUID) {\n        this._viewUUID = viewUUID;\n        this.restoreFromLocalStorage(viewUUID);\n      }\n    });\n  }\n\n  // localStorage keys: sb:{unix_ms}:{viewUUID}\n  // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.\n  private restoreFromLocalStorage(viewUUID: string): void {\n    try {\n      const existingKey = findStorageKey(viewUUID);\n      if (existingKey) {\n        const stored = localStorage.getItem(existingKey);\n        if (stored !== null) {\n          this._viewState = JSON.parse(stored);\n          this.viewStateListeners.forEach((listener) => {\n            listener();\n          });\n        }\n      }\n    } catch (err) {\n      console.error(err);\n    }\n  }\n\n  private persistToLocalStorage(state: Record<string, unknown> | null): void {\n    if (!this._viewUUID || state === null) {\n      return;\n    }\n    try {\n      // Remove old key for this view, write with fresh timestamp (LRU)\n      const oldKey = findStorageKey(this._viewUUID);\n      if (oldKey) {\n        localStorage.removeItem(oldKey);\n      }\n      const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;\n      localStorage.setItem(newKey, JSON.stringify(state));\n\n      // lru cleanup\n      const keys: string[] = [];\n      for (let i = 0; i < localStorage.length; i++) {\n        const key = localStorage.key(i);\n        if (key?.startsWith(STORAGE_PREFIX)) {\n          keys.push(key);\n        }\n      }\n      if (keys.length <= MAX_STORAGE_ENTRIES) {\n        return;\n      }\n      keys.sort();\n      const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);\n      for (const key of toRemove) {\n        localStorage.removeItem(key);\n      }\n    } catch (err) {\n      console.error(err);\n    }\n  }\n\n  private createHostContextStore<\n    const Keys extends readonly McpAppContextKey[],\n    R,\n  >(keys: Keys, computeSnapshot: (context: PickContext<Keys>) => R) {\n    const bridge = McpAppBridge.getInstance();\n    let cachedValue: R | undefined;\n\n    return {\n      subscribe: bridge.subscribe(keys),\n      getSnapshot: () => {\n        const context = Object.fromEntries(\n          keys.map((k) => [k, bridge.getSnapshot(k)]),\n        ) as PickContext<Keys>;\n        const newValue = computeSnapshot(context);\n\n        if (cachedValue !== undefined && dequal(cachedValue, newValue)) {\n          return cachedValue;\n        }\n\n        cachedValue = newValue;\n        return newValue;\n      },\n    };\n  }\n}\n"]}

package/dist/web/bridges/mcp-app/bridge.d.ts

@@ -0,0 +1,28 @@
+import { App } from "@modelcontextprotocol/ext-apps";
+import { type Implementation } from "@modelcontextprotocol/sdk/types.js";
+import type { AnyViewToolHandler, Bridge, Subscribe, ViewToolConfig } from "../types.js";
+import type { McpAppContext, McpAppContextKey } from "./types.js";
+/** @internal Singleton bridge over the `ext-apps` JSON-RPC App connection. Used by {@link McpAppAdaptor}. */
+export declare class McpAppBridge implements Bridge<McpAppContext> {
+    private static instance;
+    context: McpAppContext;
+    private listeners;
+    private app;
+    private connectPromise;
+    constructor(options: {
+        appInfo: Implementation;
+    });
+    private connect;
+    getApp(): Promise<App>;
+    registerViewTool(config: ViewToolConfig, handler: AnyViewToolHandler): () => void;
+    static getInstance(options?: Partial<{
+        appInfo: Implementation;
+    }>): McpAppBridge;
+    subscribe(key: McpAppContextKey): Subscribe;
+    subscribe(keys: readonly McpAppContextKey[]): Subscribe;
+    getSnapshot<K extends keyof McpAppContext>(key: K): McpAppContext[K];
+    cleanup: () => void;
+    static resetInstance(): void;
+    private emit;
+    private updateContext;
+}