@maxhealth.tech/prefab 0.2.2 → 0.2.3

package/dist/app.d.ts

@@ -9,7 +9,7 @@ import type { ComponentJSON } from './core/component.js';
 import type { Action, ActionJSON } from './actions/types.js';
 import type { PipeFn } from './rx/pipes.js';
 /** Package version — injected by build script, updated at release time. */
-export declare const VERSION = "0.2.2";
+export declare const VERSION = "0.2.3";
 export interface Theme {
     light?: Record<string, string>;
     dark?: Record<string, string>;

package/dist/app.js

@@ -7,7 +7,7 @@
 import {} from './core/component.js';
 import { drainAutoState } from './rx/state-collector.js';
 /** Package version — injected by build script, updated at release time. */
-export const VERSION = '0.2.2';
+export const VERSION = '0.2.3';
 export class PrefabApp {
     title;
     view;

package/dist/renderer/auto.d.ts

@@ -9,6 +9,11 @@
  * Designed for CSP-restricted environments (VS Code webviews, sandboxed iframes)
  * where inline `<script>` blocks are forbidden.
  *
+ * Supports all three Bridge protocols:
+ *   - prefab:*   (MistralOS)
+ *   - ui/* JSON-RPC (VS Code, Claude, ChatGPT)
+ *   - ext-apps SDK (legacy)
+ *
  * The host HTML only needs:
  * ```html
  * <div id="root"></div>

package/dist/renderer/auto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../src/renderer/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../src/renderer/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/renderer/auto.js

@@ -9,6 +9,11 @@
  * Designed for CSP-restricted environments (VS Code webviews, sandboxed iframes)
  * where inline `<script>` blocks are forbidden.
  *
+ * Supports all three Bridge protocols:
+ *   - prefab:*   (MistralOS)
+ *   - ui/* JSON-RPC (VS Code, Claude, ChatGPT)
+ *   - ext-apps SDK (legacy)
+ *
  * The host HTML only needs:
  * ```html
  * <div id="root"></div>
@@ -24,20 +29,50 @@ function isPrefabWire(data) {
 function isPrefabUpdate(data) {
     return PrefabRenderer.isPrefabUpdate(data);
 }
+function extractWireData(payload) {
+    if (isPrefabWire(payload))
+        return payload;
+    if (payload !== null && typeof payload === 'object') {
+        const obj = payload;
+        // MCP Apps tool-result: { content: [...], structuredContent: { $prefab, view } }
+        if (isPrefabWire(obj.structuredContent))
+            return obj.structuredContent;
+        // Try parsing text content items
+        if (Array.isArray(obj.content)) {
+            for (const raw of obj.content) {
+                const item = raw;
+                if (item.type === 'text' && typeof item.text === 'string') {
+                    try {
+                        const parsed = JSON.parse(item.text);
+                        if (isPrefabWire(parsed))
+                            return parsed;
+                    }
+                    catch { /* skip non-JSON */ }
+                }
+            }
+        }
+    }
+    return null;
+}
 async function boot() {
     const root = document.querySelector(ROOT_SELECTOR);
     if (!root) {
         console.error(`[prefab:auto] Mount target "${ROOT_SELECTOR}" not found`);
         return;
     }
+    const el = root;
     const ui = await app();
     let mounted;
+    function mount(data) {
+        if (mounted)
+            mounted.destroy();
+        mounted = ui.mount(el, data);
+    }
     // ── Tool result handler (structuredContent from MCP) ───────────────────
     ui.onToolResult((result) => {
-        if (isPrefabWire(result)) {
-            if (mounted)
-                mounted.destroy();
-            mounted = ui.mount(root, result);
+        const wire = extractWireData(result);
+        if (wire) {
+            mount(wire);
         }
         else if (isPrefabUpdate(result) && mounted) {
             mounted.update(result);
@@ -45,10 +80,9 @@ async function boot() {
     });
     // ── Tool input handler (initial data or dynamic args) ──────────────────
     ui.onToolInput((args) => {
-        if (isPrefabWire(args)) {
-            if (mounted)
-                mounted.destroy();
-            mounted = ui.mount(root, args);
+        const wire = extractWireData(args);
+        if (wire) {
+            mount(wire);
         }
         else if (isPrefabUpdate(args) && mounted) {
             mounted.update(args);

package/dist/renderer/auto.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto.js","sourceRoot":"","sources":["../../src/renderer/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,MAAM,aAAa,GAAG,OAAO,CAAA;AAE7B,SAAS,YAAY,CAAC,IAAa;IACjC,OAAO,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,OAAO,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAC5C,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAc,aAAa,CAAC,CAAA;IAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,+BAA+B,aAAa,aAAa,CAAC,CAAA;QACxE,OAAM;IACR,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAA;IAEtB,IAAI,OAA+B,CAAA;IAEnC,0EAA0E;IAC1E,EAAE,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,EAAE,CAAA;YAC9B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAClC,CAAC;aAAM,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,0EAA0E;IAC1E,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;QACtB,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,EAAE,CAAA;YAC9B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAChC,CAAC;aAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;YAC3C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;AAClD,CAAC,CAAC,CAAA"}
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../../src/renderer/auto.ts"],"names":[],"mappings":"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"}

package/dist/renderer/bridge.d.ts

@@ -2,18 +2,27 @@
  * Bridge -- PostMessage-based communication between a prefab app
  * (running in an iframe) and its host (the parent window).
  *
- * Dual protocol:
- *   Primary:  prefab:* custom protocol (supported by VS Code Copilot, MistralOS)
- *   Fallback: ext-apps JSON-RPC 2.0 (@modelcontextprotocol/ext-apps)
+ * Triple protocol:
+ *   1. prefab:*   — custom protocol (MistralOS, self-hosted)
+ *   2. ui/*       — MCP Apps JSON-RPC 2.0 (VS Code, Claude, ChatGPT, Goose)
+ *   3. ext-apps   — @modelcontextprotocol/ext-apps SDK (legacy fallback)
  *
- * Protocol detection: tries prefab:init first (1.5s timeout).
- * If no response, falls back to ext-apps.
+ * Protocol detection: tries prefab:init first (1s timeout),
+ * then ui/initialize JSON-RPC (1.5s), then ext-apps SDK.
  *
  * prefab:* messages:
  *   App  → Host: prefab:init, prefab:tool-call, prefab:send-message,
  *                 prefab:request-mode, prefab:open-link, prefab:update-context
  *   Host → App:  prefab:init-response, prefab:tool-input, prefab:tool-result,
  *                 prefab:tool-cancelled, prefab:theme-update, prefab:state-update
+ *
+ * ui/* JSON-RPC messages (MCP Apps spec 2026-01-26):
+ *   App  → Host: ui/initialize, ui/notifications/initialized,
+ *                 ui/notifications/size-changed, ui/open-link, ui/message,
+ *                 ui/request-display-mode, ui/update-model-context
+ *   Host → App:  ui/notifications/tool-input, ui/notifications/tool-result,
+ *                 ui/notifications/tool-cancelled, ui/notifications/tool-input-partial,
+ *                 ui/notifications/host-context-changed, ui/resource-teardown
  */
 import type { McpTransport } from './actions.js';
 export interface BridgeMessage<T extends string = string> {
@@ -54,12 +63,17 @@ export declare class Bridge {
     private cleanup;
     private pending;
     private callIdCounter;
+    private rpcPending;
+    private rpcIdCounter;
+    private sentRpcIds;
+    private postFn;
     private extApp;
     constructor(hostOrigin?: string);
-    /** Start listening for prefab:* messages. */
+    /** Start listening for messages (prefab:* and JSON-RPC ui/*). */
     connect(): void;
     /**
-     * Init handshake. Tries prefab:init first, falls back to ext-apps.
+     * Init handshake. Tries prefab:init first, then ui/initialize JSON-RPC,
+     * then falls back to ext-apps SDK.
      */
     initialize(appCapabilities: AppCapabilities): Promise<HostContext>;
     /** Create an McpTransport that routes through the active protocol. */
@@ -77,10 +91,22 @@ export declare class Bridge {
     /** Disconnect and clean up. */
     disconnect(): void;
     /** Which protocol is active after initialize(). */
-    get activeProtocol(): 'prefab' | 'ext-apps';
+    get activeProtocol(): 'prefab' | 'jsonrpc' | 'ext-apps';
     private initPrefab;
     private createPrefabTransport;
     private sendPrefab;
+    /** Handle incoming JSON-RPC message. */
+    private handleJsonRpc;
+    /** Initialize via MCP Apps JSON-RPC ui/initialize handshake. */
+    private initJsonRpc;
+    /** Create transport that routes tool calls via JSON-RPC tools/call. */
+    private createJsonRpcTransport;
+    /** Send a JSON-RPC request and return a promise for the response. */
+    private sendRpcRequest;
+    /** Send a JSON-RPC notification (no id, no response expected). */
+    private sendRpcNotification;
+    /** Low-level: post a JSON-RPC envelope. Uses acquireVsCodeApi if available. */
+    private postJsonRpc;
     private initExtApps;
     private wireExtAppsEvents;
     private createExtAppsTransport;

package/dist/renderer/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/renderer/bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/renderer/bridge.ts"],"names":[],"mappings":"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"}

package/dist/renderer/bridge.js

@@ -2,19 +2,34 @@
  * Bridge -- PostMessage-based communication between a prefab app
  * (running in an iframe) and its host (the parent window).
  *
- * Dual protocol:
- *   Primary:  prefab:* custom protocol (supported by VS Code Copilot, MistralOS)
- *   Fallback: ext-apps JSON-RPC 2.0 (@modelcontextprotocol/ext-apps)
+ * Triple protocol:
+ *   1. prefab:*   — custom protocol (MistralOS, self-hosted)
+ *   2. ui/*       — MCP Apps JSON-RPC 2.0 (VS Code, Claude, ChatGPT, Goose)
+ *   3. ext-apps   — @modelcontextprotocol/ext-apps SDK (legacy fallback)
  *
- * Protocol detection: tries prefab:init first (1.5s timeout).
- * If no response, falls back to ext-apps.
+ * Protocol detection: tries prefab:init first (1s timeout),
+ * then ui/initialize JSON-RPC (1.5s), then ext-apps SDK.
  *
  * prefab:* messages:
  *   App  → Host: prefab:init, prefab:tool-call, prefab:send-message,
  *                 prefab:request-mode, prefab:open-link, prefab:update-context
  *   Host → App:  prefab:init-response, prefab:tool-input, prefab:tool-result,
  *                 prefab:tool-cancelled, prefab:theme-update, prefab:state-update
+ *
+ * ui/* JSON-RPC messages (MCP Apps spec 2026-01-26):
+ *   App  → Host: ui/initialize, ui/notifications/initialized,
+ *                 ui/notifications/size-changed, ui/open-link, ui/message,
+ *                 ui/request-display-mode, ui/update-model-context
+ *   Host → App:  ui/notifications/tool-input, ui/notifications/tool-result,
+ *                 ui/notifications/tool-cancelled, ui/notifications/tool-input-partial,
+ *                 ui/notifications/host-context-changed, ui/resource-teardown
  */
+/** Type guard: is this a JSON-RPC 2.0 envelope? */
+function isJsonRpcEnvelope(msg) {
+    return (msg !== null &&
+        typeof msg === 'object' &&
+        msg.jsonrpc === '2.0');
+}
 // ── Bridge Class ─────────────────────────────────────────────────────────────
 export class Bridge {
     hostOrigin;
@@ -24,58 +39,84 @@ export class Bridge {
     // prefab:* state
     pending = new Map();
     callIdCounter = 0;
+    // JSON-RPC state
+    rpcPending = new Map();
+    rpcIdCounter = 0;
+    sentRpcIds = new Set();
+    postFn;
     // ext-apps state (lazy)
     extApp;
     constructor(hostOrigin = '*') {
         this.hostOrigin = hostOrigin;
     }
-    /** Start listening for prefab:* messages. */
+    /** Start listening for messages (prefab:* and JSON-RPC ui/*). */
     connect() {
         if (typeof window === 'undefined')
             return;
+        // Detect VS Code webview API (provides postMessage without origin restrictions)
+        const vscodeApi = detectVsCodeApi();
+        if (vscodeApi) {
+            this.postFn = (msg) => vscodeApi.postMessage(msg);
+        }
         const handler = (event) => {
             if (this.hostOrigin !== '*' && event.origin !== this.hostOrigin)
                 return;
             const msg = event.data;
-            if (!msg?.type.startsWith('prefab:'))
+            // ── JSON-RPC 2.0 messages (ui/* protocol) ───────────────────────────
+            if (isJsonRpcEnvelope(msg)) {
+                this.handleJsonRpc(msg);
+                return;
+            }
+            // ── prefab:* messages ───────────────────────────────────────────────
+            const bmsg = msg;
+            if (!bmsg?.type.startsWith('prefab:'))
                 return;
             // Resolve pending tool-call promises
-            if (msg.type === 'prefab:tool-call-response' && msg.id) {
-                const p = this.pending.get(msg.id);
+            if (bmsg.type === 'prefab:tool-call-response' && bmsg.id) {
+                const p = this.pending.get(bmsg.id);
                 if (p) {
-                    this.pending.delete(msg.id);
-                    if (msg.payload?.error != null) {
-                        p.reject(new Error(msg.payload.error));
+                    this.pending.delete(bmsg.id);
+                    if (bmsg.payload?.error != null) {
+                        p.reject(new Error(bmsg.payload.error));
                     }
                     else {
-                        p.resolve(msg.payload?.result);
+                        p.resolve(bmsg.payload?.result);
                     }
                     return;
                 }
             }
             // Dispatch to registered listeners
-            const handlers = this.listeners.get(msg.type);
+            const handlers = this.listeners.get(bmsg.type);
             if (handlers) {
                 for (const fn of handlers)
-                    fn(msg.payload ?? {});
+                    fn(bmsg.payload ?? {});
             }
         };
         window.addEventListener('message', handler);
         this.cleanup = () => window.removeEventListener('message', handler);
     }
     /**
-     * Init handshake. Tries prefab:init first, falls back to ext-apps.
+     * Init handshake. Tries prefab:init first, then ui/initialize JSON-RPC,
+     * then falls back to ext-apps SDK.
      */
     async initialize(appCapabilities) {
         try {
             return await this.initPrefab(appCapabilities);
         }
         catch {
-            return this.initExtApps(appCapabilities);
+            try {
+                return await this.initJsonRpc(appCapabilities);
+            }
+            catch {
+                return this.initExtApps(appCapabilities);
+            }
         }
     }
     /** Create an McpTransport that routes through the active protocol. */
     createTransport() {
+        if (this.protocol === 'jsonrpc') {
+            return this.createJsonRpcTransport();
+        }
         if (this.protocol === 'ext-apps' && this.extApp) {
             return this.createExtAppsTransport();
         }
@@ -83,7 +124,10 @@ export class Bridge {
     }
     /** Request a display mode change. */
     requestMode(mode) {
-        if (this.protocol === 'ext-apps' && this.extApp) {
+        if (this.protocol === 'jsonrpc') {
+            void this.sendRpcRequest('ui/request-display-mode', { mode });
+        }
+        else if (this.protocol === 'ext-apps' && this.extApp) {
             void this.extApp.requestDisplayMode({ mode });
         }
         else {
@@ -92,7 +136,10 @@ export class Bridge {
     }
     /** Request the host to open a URL. */
     openLink(url, target) {
-        if (this.protocol === 'ext-apps' && this.extApp) {
+        if (this.protocol === 'jsonrpc') {
+            void this.sendRpcRequest('ui/open-link', { url, target });
+        }
+        else if (this.protocol === 'ext-apps' && this.extApp) {
             void this.extApp.openLink({ url });
         }
         else {
@@ -101,7 +148,10 @@ export class Bridge {
     }
     /** Send context updates to the host. */
     updateContext(context) {
-        if (this.protocol === 'ext-apps' && this.extApp) {
+        if (this.protocol === 'jsonrpc') {
+            void this.sendRpcRequest('ui/update-model-context', { structuredContent: context });
+        }
+        else if (this.protocol === 'ext-apps' && this.extApp) {
             void this.extApp.updateModelContext({ structuredContent: context });
         }
         else {
@@ -130,6 +180,11 @@ export class Bridge {
             p.reject(new Error('Bridge disconnected'));
         }
         this.pending.clear();
+        for (const [, p] of this.rpcPending) {
+            p.reject(new Error('Bridge disconnected'));
+        }
+        this.rpcPending.clear();
+        this.sentRpcIds.clear();
     }
     /** Which protocol is active after initialize(). */
     get activeProtocol() {
@@ -187,6 +242,194 @@ export class Bridge {
         const msg = { type, payload, id };
         target.postMessage(msg, this.hostOrigin);
     }
+    // ── JSON-RPC ui/* protocol (MCP Apps spec 2026-01-26) ────────────────
+    /** Handle incoming JSON-RPC message. */
+    handleJsonRpc(msg) {
+        // Response to a request we sent (has no 'method' → must be JsonRpcResponse)
+        if (!('method' in msg)) {
+            const p = this.rpcPending.get(msg.id);
+            if (p) {
+                this.rpcPending.delete(msg.id);
+                if (msg.error) {
+                    p.reject(new Error(msg.error.message));
+                }
+                else {
+                    p.resolve(msg.result);
+                }
+            }
+            return;
+        }
+        // Request or notification from host (JsonRpcRequest)
+        const method = msg.method;
+        const params = msg.params ?? {};
+        // Skip our own outgoing requests bounced back (same-window postMessage in tests)
+        if (msg.id != null && this.sentRpcIds.delete(msg.id))
+            return;
+        // Auto-acknowledge host requests (those with an id) so we don't deadlock
+        if (msg.id != null) {
+            this.postJsonRpc({ jsonrpc: '2.0', id: msg.id, result: {} });
+        }
+        // Map ui/* notifications to internal prefab:* events
+        switch (method) {
+            case 'ui/notifications/tool-input':
+                this.dispatch('prefab:tool-input', { args: params.arguments ?? params });
+                break;
+            case 'ui/notifications/tool-input-partial':
+                this.dispatch('prefab:tool-input-partial', { args: params.arguments ?? params });
+                break;
+            case 'ui/notifications/tool-result':
+                this.dispatch('prefab:tool-result', { result: params });
+                break;
+            case 'ui/notifications/tool-cancelled':
+                this.dispatch('prefab:tool-cancelled', params);
+                break;
+            case 'ui/notifications/host-context-changed': {
+                const theme = {};
+                if (typeof params.theme === 'string') {
+                    theme.colorScheme = params.theme;
+                }
+                if (typeof params.styles === 'object' && params.styles !== null) {
+                    const styles = params.styles;
+                    if (styles.variables)
+                        theme.variables = styles.variables;
+                }
+                this.dispatch('prefab:theme-update', theme);
+                break;
+            }
+            case 'ui/resource-teardown':
+                this.dispatch('prefab:teardown', params);
+                break;
+        }
+    }
+    /** Initialize via MCP Apps JSON-RPC ui/initialize handshake. */
+    initJsonRpc(appCapabilities) {
+        return new Promise((resolve, reject) => {
+            const id = ++this.rpcIdCounter;
+            let settled = false;
+            this.rpcPending.set(id, {
+                resolve: (result) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    this.protocol = 'jsonrpc';
+                    const r = (result ?? {});
+                    const hostInfo = (r.hostInfo ?? {});
+                    const hostCtx = (r.hostContext ?? {});
+                    const hostCaps = (r.hostCapabilities ?? {});
+                    // Parse theme from hostContext
+                    let theme;
+                    if (typeof hostCtx.theme === 'string' || typeof hostCtx.styles === 'object') {
+                        theme = {};
+                        if (typeof hostCtx.theme === 'string') {
+                            theme.colorScheme = hostCtx.theme;
+                        }
+                        if (typeof hostCtx.styles === 'object' && hostCtx.styles !== null) {
+                            const styles = hostCtx.styles;
+                            if (styles.variables)
+                                theme.variables = styles.variables;
+                        }
+                    }
+                    // Send ui/notifications/initialized to confirm readiness
+                    this.postJsonRpc({
+                        jsonrpc: '2.0',
+                        method: 'ui/notifications/initialized',
+                        params: {},
+                    });
+                    resolve({
+                        hostName: hostInfo.name,
+                        hostVersion: hostInfo.version,
+                        capabilities: {
+                            toast: true,
+                            navigation: hostCaps.openLinks != null,
+                            messaging: true,
+                            displayModes: (hostCtx.availableDisplayModes ?? []),
+                        },
+                        theme,
+                        toolInput: undefined,
+                        meta: hostCtx,
+                    });
+                },
+                reject: (err) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    reject(err);
+                },
+            });
+            // Send ui/initialize request
+            this.postJsonRpc({
+                jsonrpc: '2.0',
+                id,
+                method: 'ui/initialize',
+                params: {
+                    protocolVersion: '2026-01-26',
+                    capabilities: {},
+                    clientInfo: { name: 'prefab', version: '0.2' },
+                    appCapabilities: {
+                        ...(appCapabilities.displayModes && {
+                            availableDisplayModes: appCapabilities.displayModes,
+                        }),
+                    },
+                },
+            });
+            // Timeout — fall through to ext-apps
+            setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    this.rpcPending.delete(id);
+                    reject(new Error('ui/initialize timeout'));
+                }
+            }, 1500);
+        });
+    }
+    /** Create transport that routes tool calls via JSON-RPC tools/call. */
+    createJsonRpcTransport() {
+        return {
+            callTool: (name, args) => {
+                return this.sendRpcRequest('tools/call', { name, arguments: args });
+            },
+            sendMessage: (message) => {
+                return this.sendRpcRequest('ui/message', {
+                    role: 'user',
+                    content: { type: 'text', text: message },
+                });
+            },
+        };
+    }
+    /** Send a JSON-RPC request and return a promise for the response. */
+    sendRpcRequest(method, params) {
+        const id = ++this.rpcIdCounter;
+        return new Promise((resolve, reject) => {
+            this.rpcPending.set(id, { resolve, reject });
+            this.postJsonRpc({ jsonrpc: '2.0', id, method, params });
+            setTimeout(() => {
+                if (this.rpcPending.has(id)) {
+                    this.rpcPending.delete(id);
+                    reject(new Error(`JSON-RPC '${method}' timed out`));
+                }
+            }, 30000);
+        });
+    }
+    /** Send a JSON-RPC notification (no id, no response expected). */
+    sendRpcNotification(method, params) {
+        this.postJsonRpc({ jsonrpc: '2.0', method, params });
+    }
+    /** Low-level: post a JSON-RPC envelope. Uses acquireVsCodeApi if available. */
+    postJsonRpc(msg) {
+        if (typeof window === 'undefined')
+            return;
+        // Track outgoing request ids to filter self-messages in same-window envs
+        if (msg.id != null && typeof msg.method === 'string') {
+            this.sentRpcIds.add(msg.id);
+        }
+        if (this.postFn) {
+            this.postFn(msg);
+        }
+        else {
+            const target = window.parent !== window ? window.parent : window;
+            target.postMessage(msg, this.hostOrigin);
+        }
+    }
     // ── ext-apps fallback ──────────────────────────────────────────────────
     async initExtApps(appCapabilities) {
         const { App, PostMessageTransport } = await import('@modelcontextprotocol/ext-apps');
@@ -299,4 +542,22 @@ export function isIframe() {
         return true;
     }
 }
+/** Detect VS Code webview API (acquireVsCodeApi). Returns the API object or undefined. */
+function detectVsCodeApi() {
+    if (typeof window === 'undefined')
+        return undefined;
+    const win = window;
+    if (typeof win.acquireVsCodeApi === 'function') {
+        try {
+            const api = win.acquireVsCodeApi();
+            if (api !== null && typeof api === 'object' && 'postMessage' in api) {
+                return api;
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
 //# sourceMappingURL=bridge.js.map