skybridge 0.0.0-dev.d757a58 → 0.0.0-dev.d778c19

package/dist/{src/test → test}/widget.test.js

@@ -54,6 +54,11 @@ describe("McpServer.registerWidget", () => {
                     mimeType: "text/html+skybridge",
                     text: expect.stringContaining('<div id="root"></div>'),
                     _meta: {
+                        "openai/widgetCSP": {
+                            resource_domains: [serverUrl],
+                            connect_domains: ["ws://localhost:24678"],
+                        },
+                        "openai/widgetDomain": serverUrl,
                         "openai/widgetDescription": "Test tool",
                     },
                 },
@@ -75,8 +80,9 @@ describe("McpServer.registerWidget", () => {
         const appsSdkResourceCallback = mockRegisterResource.mock
             .calls[0]?.[3];
         expect(appsSdkResourceCallback).toBeDefined();
-        const serverUrl = "https://myapp.com";
-        const mockExtra = createMockExtra(serverUrl);
+        const host = "myapp.com";
+        const serverUrl = `https://${host}`;
+        const mockExtra = createMockExtra(host);
         const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
         expect(result).toEqual({
             contents: [
@@ -85,6 +91,11 @@ describe("McpServer.registerWidget", () => {
                     mimeType: "text/html+skybridge",
                     text: expect.stringContaining('<div id="root"></div>'),
                     _meta: {
+                        "openai/widgetCSP": {
+                            resource_domains: [serverUrl],
+                            connect_domains: [],
+                        },
+                        "openai/widgetDomain": serverUrl,
                         "openai/widgetDescription": "Test tool",
                     },
                 },
@@ -105,8 +116,9 @@ describe("McpServer.registerWidget", () => {
         const appsSdkResourceCallback = mockRegisterResource.mock
             .calls[0]?.[3];
         expect(appsSdkResourceCallback).toBeDefined();
-        const serverUrl = "https://myapp.com";
-        const mockExtra = createMockExtra(serverUrl);
+        const host = "myapp.com";
+        const serverUrl = `https://${host}`;
+        const mockExtra = createMockExtra(host);
         const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/folder-widget.html"), mockExtra);
         // Should resolve to folder-widget.js from the manifest entry "src/widgets/folder-widget/index.tsx"
         expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/folder-widget.js`);
@@ -130,6 +142,11 @@ describe("McpServer.registerWidget", () => {
                     mimeType: "text/html+skybridge",
                     text: expect.stringContaining('<div id="root"></div>'),
                     _meta: {
+                        "openai/widgetCSP": {
+                            resource_domains: ["http://localhost:3000"],
+                            connect_domains: ["ws://localhost:24678"],
+                        },
+                        "openai/widgetDomain": "http://localhost:3000",
                         "openai/widgetDescription": "Test tool",
                         "openai/widgetPrefersBorder": true,
                     },
@@ -148,13 +165,91 @@ describe("McpServer.registerWidget", () => {
                     mimeType: "text/html;profile=mcp-app",
                     text: expect.stringContaining('<div id="root"></div>'),
                     _meta: {
-                        "openai/widgetDescription": "Test tool",
-                        "openai/widgetPrefersBorder": true,
+                        ui: {
+                            csp: {
+                                resourceDomains: ["http://localhost:3000"],
+                                connectDomains: ["ws://localhost:24678"],
+                            },
+                            domain: "http://localhost:3000",
+                        },
                     },
                 },
             ],
         });
         expect(extAppsResult.contents[0]?.text).toContain('window.skybridge = { hostType: "mcp-app" }');
     });
+    it("should register tool with ui.resourceUri metadata (not deprecated ui/resourceUri)", async () => {
+        const mockToolCallback = vi.fn();
+        const mockRegisterResourceConfig = { description: "Test widget" };
+        const mockToolConfig = { description: "Test tool" };
+        server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
+        expect(mockRegisterTool).toHaveBeenCalledTimes(1);
+        const toolCallArgs = mockRegisterTool.mock.calls[0];
+        const toolConfig = toolCallArgs?.[1];
+        expect(toolConfig._meta).toHaveProperty("ui");
+        expect(toolConfig._meta?.ui).toEqual({
+            resourceUri: "ui://widgets/ext-apps/my-widget.html",
+        });
+    });
+    it("should apply meta overrides in correct priority: defaults < ui.* < direct openai/* keys", async () => {
+        const mockToolCallback = vi.fn();
+        const mockRegisterResourceConfig = {
+            description: "Test widget",
+            _meta: {
+                // ui.csp overrides (middle priority)
+                ui: {
+                    csp: {
+                        resourceDomains: ["https://from-ui-csp.com"],
+                        connectDomains: ["https://from-ui-csp.com"],
+                    },
+                    domain: "https://from-ui-domain.com",
+                    prefersBorder: false,
+                },
+                // Direct openai/* keys (highest priority) - should override ui.*
+                "openai/widgetDomain": "https://direct-override.com",
+                "openai/widgetPrefersBorder": true,
+            },
+        };
+        const mockToolConfig = { description: "Test tool" };
+        server.registerWidget("override-test", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
+        const appsSdkCallback = mockRegisterResource.mock
+            .calls[0]?.[3];
+        const result = await appsSdkCallback(new URL("ui://widgets/apps-sdk/override-test.html"), createMockExtra("__not_used__"));
+        const meta = result.contents[0]?._meta;
+        // CSP arrays are merged with union - all unique domains from defaults and user config are preserved
+        expect(meta["openai/widgetCSP"]).toEqual({
+            resource_domains: ["http://localhost:3000", "https://from-ui-csp.com"],
+            connect_domains: ["ws://localhost:24678", "https://from-ui-csp.com"],
+            frame_domains: undefined,
+            redirect_domains: undefined,
+        });
+        // Domain should be overridden by direct openai/* key (highest priority)
+        expect(meta["openai/widgetDomain"]).toBe("https://direct-override.com");
+        // PrefersBorder should be overridden by direct openai/* key (highest priority)
+        expect(meta["openai/widgetPrefersBorder"]).toBe(true);
+        // Description should be from defaults (toolConfig.description)
+        expect(meta["openai/widgetDescription"]).toBe("Test tool");
+    });
+    it("should register tool with ui.resourceUri metadata only", async () => {
+        const mockToolCallback = vi.fn();
+        server.registerWidget("my-widget", { description: "Test widget", hosts: ["mcp-app"] }, { description: "Test tool" }, mockToolCallback);
+        expect(mockRegisterTool).toHaveBeenCalledTimes(1);
+        const toolCallArgs = mockRegisterTool.mock.calls[0];
+        const toolConfig = toolCallArgs?.[1];
+        expect(toolConfig._meta).toHaveProperty("ui");
+        expect(toolConfig._meta?.ui).toEqual({
+            resourceUri: "ui://widgets/ext-apps/my-widget.html",
+        });
+        expect(toolConfig._meta?.["openai/outputTemplate"]).to.be.undefined;
+    });
+    it("should register tool with uopenai/outputTemplate metadata only", async () => {
+        const mockToolCallback = vi.fn();
+        server.registerWidget("my-widget", { description: "Test widget", hosts: ["apps-sdk"] }, { description: "Test tool" }, mockToolCallback);
+        expect(mockRegisterTool).toHaveBeenCalledTimes(1);
+        const toolCallArgs = mockRegisterTool.mock.calls[0];
+        const toolConfig = toolCallArgs?.[1];
+        expect(toolConfig._meta).not.toHaveProperty("ui");
+        expect(toolConfig._meta?.["openai/outputTemplate"]).to.eq("ui://widgets/apps-sdk/my-widget.html");
+    });
 });
 //# sourceMappingURL=widget.test.js.map

package/dist/test/widget.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.test.js","sourceRoot":"","sources":["../../src/test/widget.test.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,MAAM,EACN,EAAE,EAEF,EAAE,GACH,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,MAAM,YAAY,GAAG;IACnB,2BAA2B,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;IACrD,qCAAqC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACnE,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;CACnC,CAAC;AAEF,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAEpD,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;IACtB,MAAM,gBAAgB,GAAG,CACvB,IAA+C,EAC/C,GAAG,IAAe,EACsB,EAAE;QAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAEjC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAA+B,CAAC;IAE3E,OAAO;QACL,YAAY;QACZ,OAAO,EAAE;YACP,YAAY;SACb;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,MAAiB,CAAC;IACtB,IAAI,oBAAiE,CAAC;IACtE,IAAI,gBAAyD,CAAC;IAE9D,UAAU,CAAC,GAAG,EAAE;QACd,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,EAAE;YACjD,mBAAmB,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,YAAY,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,UAAU,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;QAExC,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,0BAA0B,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;QAClE,MAAM,cAAc,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAEpD,MAAM,CAAC,cAAc,CACnB,WAAW,EACX,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,qCAAqC;QACrC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC,IAAI;aACtD,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAKb,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,SAAS,GAAG,uBAAuB,CAAC;QAC1C,MAAM,SAAS,GAAG,eAAe,CAC/B,cAAc,CACsD,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAC1C,IAAI,GAAG,CAAC,sCAAsC,CAAC,EAC/C,SAAS,CACV,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,sCAAsC;oBAC3C,QAAQ,EAAE,qBAAqB;oBAC/B,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC;oBACtD,KAAK,EAAE;wBACL,kBAAkB,EAAE;4BAClB,gBAAgB,EAAE,CAAC,SAAS,CAAC;4BAC7B,eAAe,EAAE,CAAC,sBAAsB,CAAC;yBAC1C;wBACD,qBAAqB,EAAE,SAAS;wBAChC,0BAA0B,EAAE,WAAW;qBACxC;iBACF;aACF;SACF,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CACxC,GAAG,SAAS,wBAAwB,CACrC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,eAAe,CAAC,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CACxC,GAAG,SAAS,wBAAwB,CACrC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAC5C,GAAG,SAAS,4BAA4B,CACzC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAEvC,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,0BAA0B,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;QAClE,MAAM,cAAc,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAEpD,MAAM,CAAC,cAAc,CACnB,WAAW,EACX,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,qCAAqC;QACrC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC,IAAI;aACtD,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAKb,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,IAAI,GAAG,WAAW,CAAC;QACzB,MAAM,SAAS,GAAG,WAAW,IAAI,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAGrC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAC1C,IAAI,GAAG,CAAC,sCAAsC,CAAC,EAC/C,SAAS,CACV,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,sCAAsC;oBAC3C,QAAQ,EAAE,qBAAqB;oBAC/B,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC;oBACtD,KAAK,EAAE;wBACL,kBAAkB,EAAE;4BAClB,gBAAgB,EAAE,CAAC,SAAS,CAAC;4BAC7B,eAAe,EAAE,EAAE;yBACpB;wBACD,qBAAqB,EAAE,SAAS;wBAChC,0BAA0B,EAAE,WAAW;qBACxC;iBACF;aACF;SACF,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAC5C,GAAG,SAAS,wBAAwB,CACrC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CACxC,GAAG,SAAS,sBAAsB,CACnC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAEvC,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,0BAA0B,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;QACpE,MAAM,cAAc,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;QAEtD,MAAM,CAAC,cAAc,CACnB,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,MAAM,uBAAuB,GAAG,oBAAoB,CAAC,IAAI;aACtD,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAKb,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,IAAI,GAAG,WAAW,CAAC;QACzB,MAAM,SAAS,GAAG,WAAW,IAAI,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAGrC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAC1C,IAAI,GAAG,CAAC,0CAA0C,CAAC,EACnD,SAAS,CACV,CAAC;QAEF,mGAAmG;QACnG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CACxC,GAAG,SAAS,0BAA0B,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;QACtG,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,0BAA0B,GAAG;YACjC,WAAW,EAAE,aAAa;YAC1B,KAAK,EAAE,EAAE,4BAA4B,EAAE,IAAI,EAAE;SAC9C,CAAC;QACF,MAAM,cAAc,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAEpD,MAAM,CAAC,cAAc,CACnB,WAAW,EACX,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,MAAM,CAAC,oBAAoB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAEtD,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI;aAC9C,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAKb,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,eAAe,CACzC,IAAI,GAAG,CAAC,sCAAsC,CAAC,EAC/C,eAAe,CAAC,cAAc,CAG7B,CACF,CAAC;QAEF,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC;YAC5B,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,sCAAsC;oBAC3C,QAAQ,EAAE,qBAAqB;oBAC/B,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC;oBACtD,KAAK,EAAE;wBACL,kBAAkB,EAAE;4BAClB,gBAAgB,EAAE,CAAC,uBAAuB,CAAC;4BAC3C,eAAe,EAAE,CAAC,sBAAsB,CAAC;yBAC1C;wBACD,qBAAqB,EAAE,uBAAuB;wBAC9C,0BAA0B,EAAE,WAAW;wBACvC,4BAA4B,EAAE,IAAI;qBACnC;iBACF;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CAC/C,6CAA6C,CAC9C,CAAC;QAEF,MAAM,uBAAuB,GAAG,oBAAoB,CAAC,IAAI;aACtD,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAUb,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,aAAa,GAAG,MAAM,uBAAuB,CACjD,IAAI,GAAG,CAAC,sCAAsC,CAAC,EAC/C,eAAe,CAAC,cAAc,CAG7B,CACF,CAAC;QAEF,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC;YAC5B,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,sCAAsC;oBAC3C,QAAQ,EAAE,2BAA2B;oBACrC,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC;oBACtD,KAAK,EAAE;wBACL,EAAE,EAAE;4BACF,GAAG,EAAE;gCACH,eAAe,EAAE,CAAC,uBAAuB,CAAC;gCAC1C,cAAc,EAAE,CAAC,sBAAsB,CAAC;6BACzC;4BACD,MAAM,EAAE,uBAAuB;yBAChC;qBACF;iBACF;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CAC/C,4CAA4C,CAC7C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,0BAA0B,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;QAClE,MAAM,cAAc,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAEpD,MAAM,CAAC,cAAc,CACnB,WAAW,EACX,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAElD,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC,CAAC,CAAwC,CAAC;QAE5E,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC;YACnC,WAAW,EAAE,sCAAsC;SACpD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;QACvG,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,0BAA0B,GAAG;YACjC,WAAW,EAAE,aAAa;YAC1B,KAAK,EAAE;gBACL,qCAAqC;gBACrC,EAAE,EAAE;oBACF,GAAG,EAAE;wBACH,eAAe,EAAE,CAAC,yBAAyB,CAAC;wBAC5C,cAAc,EAAE,CAAC,yBAAyB,CAAC;qBAC5C;oBACD,MAAM,EAAE,4BAA4B;oBACpC,aAAa,EAAE,KAAK;iBACrB;gBACD,iEAAiE;gBACjE,qBAAqB,EAAE,6BAA6B;gBACpD,4BAA4B,EAAE,IAAI;aACnC;SACF,CAAC;QACF,MAAM,cAAc,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAEpD,MAAM,CAAC,cAAc,CACnB,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI;aAC9C,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAUb,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,IAAI,GAAG,CAAC,0CAA0C,CAAC,EACnD,eAAe,CAAC,cAAc,CAG7B,CACF,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAgC,CAAC;QAElE,oGAAoG;QACpG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,gBAAgB,EAAE,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;YACtE,eAAe,EAAE,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;YACpE,aAAa,EAAE,SAAS;YACxB,gBAAgB,EAAE,SAAS;SAC5B,CAAC,CAAC;QAEH,wEAAwE;QACxE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAExE,+EAA+E;QAC/E,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtD,+DAA+D;QAC/D,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,cAAc,CACnB,WAAW,EACX,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAClD,EAAE,WAAW,EAAE,WAAW,EAAE,EAC5B,gBAAgB,CACjB,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAElD,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC,CAAC,CAAwC,CAAC;QAE5E,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC;YACnC,WAAW,EAAE,sCAAsC;SACpD,CAAC,CAAC;QACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,cAAc,CACnB,WAAW,EACX,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,EACnD,EAAE,WAAW,EAAE,WAAW,EAAE,EAC5B,gBAAgB,CACjB,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAElD,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC,CAAC,CAAwC,CAAC;QAE5E,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACvD,sCAAsC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/web/bridges/apps-sdk/adaptor.d.ts

@@ -0,0 +1,21 @@
+import type { Adaptor, CallToolResponse, DisplayMode, HostContext, HostContextStore, RequestModalOptions, SetWidgetStateAction } from "../types.js";
+export declare class AppsSdkAdaptor implements Adaptor {
+    private static instance;
+    static getInstance(): AppsSdkAdaptor;
+    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: DisplayMode) => Promise<{
+        mode: DisplayMode;
+    }>;
+    sendFollowUpMessage: (prompt: string) => Promise<void>;
+    openExternal(href: string): void;
+    setWidgetState: (stateOrUpdater: SetWidgetStateAction) => Promise<void>;
+    uploadFile: (file: File) => Promise<import("../types.js").FileMetadata>;
+    getFileDownloadUrl: (file: {
+        fileId: string;
+    }) => Promise<{
+        downloadUrl: string;
+    }>;
+    openModal(options: RequestModalOptions): Promise<void>;
+}

package/dist/{src/web/bridges/adaptors/apps-sdk-adaptor.js → web/bridges/apps-sdk/adaptor.js}

@@ -1,4 +1,4 @@
-import { AppsSdkBridge } from "../apps-sdk-bridge.js";
+import { AppsSdkBridge } from "./bridge.js";
 export class AppsSdkAdaptor {
     static instance = null;
     static getInstance() {
@@ -10,7 +10,7 @@ export class AppsSdkAdaptor {
     static resetInstance() {
         AppsSdkAdaptor.instance = null;
     }
-    getExternalStore(key) {
+    getHostContextStore(key) {
         const bridge = AppsSdkBridge.getInstance();
         return {
             subscribe: bridge.subscribe(key),
@@ -29,5 +29,20 @@ export class AppsSdkAdaptor {
     openExternal(href) {
         window.openai.openExternal({ href });
     }
+    setWidgetState = (stateOrUpdater) => {
+        const newState = typeof stateOrUpdater === "function"
+            ? stateOrUpdater(window.openai.widgetState)
+            : stateOrUpdater;
+        return window.openai.setWidgetState(newState);
+    };
+    uploadFile = (file) => {
+        return window.openai.uploadFile(file);
+    };
+    getFileDownloadUrl = (file) => {
+        return window.openai.getFileDownloadUrl(file);
+    };
+    openModal(options) {
+        return window.openai.requestModal(options);
+    }
 }
-//# sourceMappingURL=apps-sdk-adaptor.js.map
+//# sourceMappingURL=adaptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,GAA0B,IAAI,CAAC;IAE/C,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,cAAc,CAAC,QAAQ,GAAG,IAAI,CAAC;IACjC,CAAC;IAEM,mBAAmB,CACxB,GAAM;QAEN,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;YAChC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC;SAC3C,CAAC;IACJ,CAAC;IAEM,QAAQ,GAAG,KAAK,EAIrB,IAAY,EACZ,IAAc,EACS,EAAE;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAyB,IAAI,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC;IAEK,kBAAkB,GAAG,CAC1B,IAAiB,EACe,EAAE;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC;IAEK,mBAAmB,GAAG,CAAC,MAAc,EAAiB,EAAE;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC;IAEK,YAAY,CAAC,IAAY;QAC9B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAEM,cAAc,GAAG,CACtB,cAAoC,EACrB,EAAE;QACjB,MAAM,QAAQ,GACZ,OAAO,cAAc,KAAK,UAAU;YAClC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YAC3C,CAAC,CAAC,cAAc,CAAC;QAErB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC,CAAC;IAEK,UAAU,GAAG,CAAC,IAAU,EAAE,EAAE;QACjC,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC;IAEK,kBAAkB,GAAG,CAAC,IAAwB,EAAE,EAAE;QACvD,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC;IAEK,SAAS,CAAC,OAA4B;QAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC"}

package/dist/web/bridges/apps-sdk/bridge.d.ts

@@ -0,0 +1,10 @@
+import type { Bridge, Subscribe } from "../types.js";
+import { type AppsSdkContext } from "./types.js";
+export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
+    private static instance;
+    static getInstance(): AppsSdkBridge;
+    static resetInstance(): void;
+    subscribe(key: keyof AppsSdkContext): Subscribe;
+    subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;
+    getSnapshot: <K extends keyof AppsSdkContext>(key: K) => (import("./types.js").AppsSdkMethods<import("../../types.js").UnknownObject> & AppsSdkContext<Record<never, unknown>, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject>)[K];
+}

package/dist/{src/web/bridges/apps-sdk-bridge.js → web/bridges/apps-sdk/bridge.js}

@@ -1,4 +1,4 @@
-import { SET_GLOBALS_EVENT_TYPE, } from "../types.js";
+import { SET_GLOBALS_EVENT_TYPE, } from "./types.js";
 export class AppsSdkBridge {
     static instance = null;
     static getInstance() {
@@ -43,4 +43,4 @@ export class AppsSdkBridge {
         return window.openai[key];
     };
 }
-//# sourceMappingURL=apps-sdk-bridge.js.map
+//# sourceMappingURL=bridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAE9C,MAAM,CAAC,WAAW;QACvB,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;YACxC,MAAM,CAAC,MAAM,KAAK,SAAS,EAC3B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAIM,SAAS,CACd,SAAmE;QAEnE,MAAM,IAAI,GAAsC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChB,OAAO,CAAC,QAAoB,EAAE,EAAE;YAC9B,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;gBACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CACjC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CACjD,CAAC;gBACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;YACtE,CAAC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAEM,WAAW,GAAG,CAAiC,GAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,+EAA+E,GAAG,8CAA8C,CACjI,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC"}

package/dist/web/bridges/apps-sdk/index.d.ts

@@ -0,0 +1,5 @@
+export { AppsSdkAdaptor } from "./adaptor.js";
+export { AppsSdkBridge } from "./bridge.js";
+export type { AppsSdkContext, AppsSdkMethods, ToolResponseEvent, } from "./types.js";
+export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
+export { useAppsSdkContext } from "./use-apps-sdk-context.js";

package/dist/web/bridges/apps-sdk/index.js

@@ -0,0 +1,5 @@
+export { AppsSdkAdaptor } from "./adaptor.js";
+export { AppsSdkBridge } from "./bridge.js";
+export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
+export { useAppsSdkContext } from "./use-apps-sdk-context.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/{src/web → web/bridges/apps-sdk}/types.d.ts

@@ -1,24 +1,7 @@
-import "react";
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import type { WidgetHostType } from "../server/index.js";
-declare module "react" {
-    interface HTMLAttributes<T> {
-        "data-llm"?: string;
-    }
-}
-export type UnknownObject = Record<string, unknown>;
-export type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-export type Objectify<T> = T & UnknownObject;
-type RequiredKeys<T> = {
-    [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
-}[keyof T];
-export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
+import type { UnknownObject } from "../../types.js";
+import type { CallToolArgs, CallToolResponse, FileMetadata, RequestModalOptions } from "../types.js";
+type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
 type WidgetState = UnknownObject;
-type FileMetadata = {
-    fileId: string;
-};
 export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
 export declare class ToolResponseEvent extends CustomEvent<{
     tool: {
@@ -30,21 +13,17 @@ export declare class ToolResponseEvent extends CustomEvent<{
 }
 declare global {
     interface Window {
-        skybridge: SkybridgeProperties;
-        openai: OpenAiMethods<WidgetState> & OpenAiProperties;
+        openai: AppsSdkMethods<WidgetState> & AppsSdkContext;
     }
     interface WindowEventMap {
         [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
     }
 }
-export type SkybridgeProperties = {
-    hostType: WidgetHostType;
-};
-export type OpenAiProperties<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
+export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
     theme: Theme;
     userAgent: UserAgent;
     locale: string;
-    maxHeight: number;
+    maxHeight: number | undefined;
     displayMode: DisplayMode;
     safeArea: SafeArea;
     view: View;
@@ -55,25 +34,7 @@ export type OpenAiProperties<ToolInput extends UnknownObject = Record<never, unk
     toolResponseMetadata: ToolResponseMetadata | null;
     widgetState: WidgetState | null;
 };
-export type CallToolArgs = Record<string, unknown> | null;
-export type CallToolResponse = {
-    content: CallToolResult["content"];
-    structuredContent: Record<string, unknown>;
-    isError: boolean;
-    result: string;
-    _meta?: CallToolResult["_meta"];
-};
-export type RequestModalOptions = {
-    title?: string;
-    params?: Record<string, unknown>;
-    anchor?: {
-        top?: number;
-        left?: number;
-        width?: number;
-        height?: number;
-    };
-};
-export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
+export type AppsSdkMethods<WidgetState extends UnknownObject = UnknownObject> = {
     /** Calls a tool on your MCP. Returns the full response. */
     callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
     /** Triggers a followup turn in the ChatGPT conversation */
@@ -110,34 +71,32 @@ export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
      * Downloads a file from the host that was previously uploaded.
      * Only files uploaded by the same connector instance can be downloaded.
      */
-    downloadFile: (file: FileMetadata) => Promise<{
+    getFileDownloadUrl: (file: FileMetadata) => Promise<{
         downloadUrl: string;
     }>;
 };
 export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
 export declare class SetGlobalsEvent extends CustomEvent<{
-    globals: Partial<OpenAiProperties>;
+    globals: Partial<AppsSdkContext>;
 }> {
     readonly type = "openai:set_globals";
 }
-export type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
-export type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
-export type View = {
+type View = {
     mode: DisplayMode;
     params?: Record<string, unknown>;
 };
-export type Theme = "light" | "dark";
-export type SafeAreaInsets = {
+type Theme = "light" | "dark";
+type SafeAreaInsets = {
     top: number;
     bottom: number;
     left: number;
     right: number;
 };
-export type SafeArea = {
+type SafeArea = {
     insets: SafeAreaInsets;
 };
-export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
-export type UserAgent = {
+type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
+type UserAgent = {
     device: {
         type: DeviceType;
     };

package/dist/{src/web → web/bridges/apps-sdk}/types.js

@@ -1,4 +1,3 @@
-import "react";
 export const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
 export class ToolResponseEvent extends CustomEvent {
     type = TOOL_RESPONSE_EVENT_TYPE;

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":"AAYA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AAqFD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}

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

@@ -0,0 +1,2 @@
+import type { AppsSdkContext } from "./types.js";
+export declare function useAppsSdkContext<K extends keyof AppsSdkContext>(key: K): AppsSdkContext[K];

package/dist/{src/web/bridges/hooks/use-apps-sdk-bridge.js → web/bridges/apps-sdk/use-apps-sdk-context.js}

@@ -1,7 +1,7 @@
 import { useSyncExternalStore } from "react";
-import { AppsSdkBridge } from "../apps-sdk-bridge.js";
-export function useAppsSdkBridge(key) {
+import { AppsSdkBridge } from "./bridge.js";
+export function useAppsSdkContext(key) {
     const bridge = AppsSdkBridge.getInstance();
     return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
 }
-//# sourceMappingURL=use-apps-sdk-bridge.js.map
+//# 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,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"}

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

@@ -0,0 +1,2 @@
+import type { Adaptor } from "./types.js";
+export declare const getAdaptor: () => Adaptor;

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

@@ -0,0 +1,8 @@
+import { AppsSdkAdaptor } from "./apps-sdk/adaptor.js";
+import { McpAppAdaptor } from "./mcp-app/adaptor.js";
+export const getAdaptor = () => {
+    return window.skybridge.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,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;QAC7C,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC,CAAC"}

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"}

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

@@ -0,0 +1,35 @@
+import type { McpUiRequestDisplayModeResult } from "@modelcontextprotocol/ext-apps";
+import type { Adaptor, CallToolResponse, DisplayMode, HostContext, HostContextStore, RequestModalOptions, SetWidgetStateAction } from "../types.js";
+export declare class McpAppAdaptor implements Adaptor {
+    private static instance;
+    private stores;
+    private _widgetState;
+    private widgetStateListeners;
+    private _viewState;
+    private viewListeners;
+    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: DisplayMode) => Promise<McpUiRequestDisplayModeResult>;
+    sendFollowUpMessage: (prompt: string) => Promise<void>;
+    openExternal(href: string): void;
+    private initializeStores;
+    setWidgetState: (stateOrUpdater: SetWidgetStateAction) => 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;
+    }>;
+    openModal(options: RequestModalOptions): void;
+    closeModal(): void;
+    private createHostContextStore;
+}