skybridge 0.0.0-dev.d0ea289 → 0.0.0-dev.d0fdafb

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (234) hide show
  1. package/LICENSE +21 -674
  2. package/bin/run.js +9 -0
  3. package/dist/cli/header.d.ts +4 -0
  4. package/dist/cli/header.js +6 -0
  5. package/dist/cli/header.js.map +1 -0
  6. package/dist/cli/run-command.d.ts +2 -0
  7. package/dist/cli/run-command.js +43 -0
  8. package/dist/cli/run-command.js.map +1 -0
  9. package/dist/cli/use-execute-steps.d.ts +10 -0
  10. package/dist/cli/use-execute-steps.js +31 -0
  11. package/dist/cli/use-execute-steps.js.map +1 -0
  12. package/dist/commands/build.d.ts +9 -0
  13. package/dist/commands/build.js +44 -0
  14. package/dist/commands/build.js.map +1 -0
  15. package/dist/commands/dev.d.ts +7 -0
  16. package/dist/commands/dev.js +20 -0
  17. package/dist/commands/dev.js.map +1 -0
  18. package/dist/commands/start.d.ts +7 -0
  19. package/dist/commands/start.js +33 -0
  20. package/dist/commands/start.js.map +1 -0
  21. package/dist/server/index.d.ts +4 -0
  22. package/dist/server/index.js.map +1 -0
  23. package/dist/server/inferUtilityTypes.d.ts +64 -0
  24. package/dist/server/inferUtilityTypes.js +2 -0
  25. package/dist/server/inferUtilityTypes.js.map +1 -0
  26. package/dist/server/server.d.ts +103 -0
  27. package/dist/server/server.js +137 -0
  28. package/dist/server/server.js.map +1 -0
  29. package/dist/server/templateHelper.d.ts +18 -0
  30. package/dist/{src/server → server}/templateHelper.js +5 -12
  31. package/dist/server/templateHelper.js.map +1 -0
  32. package/dist/server/templates/development.hbs +66 -0
  33. package/dist/{src/server → server}/templates/production.hbs +3 -2
  34. package/dist/{src/server → server}/widgetsDevServer.d.ts +2 -2
  35. package/dist/{src/server → server}/widgetsDevServer.js +13 -5
  36. package/dist/server/widgetsDevServer.js.map +1 -0
  37. package/dist/test/utils.d.ts +135 -0
  38. package/dist/test/utils.js +242 -0
  39. package/dist/test/utils.js.map +1 -0
  40. package/dist/test/widget.test.js +255 -0
  41. package/dist/test/widget.test.js.map +1 -0
  42. package/dist/web/bridges/adaptors/apps-sdk-adaptor.d.ts +13 -0
  43. package/dist/web/bridges/adaptors/apps-sdk-adaptor.js +33 -0
  44. package/dist/web/bridges/adaptors/apps-sdk-adaptor.js.map +1 -0
  45. package/dist/web/bridges/adaptors/mcp-app-adaptor.d.ts +16 -0
  46. package/dist/web/bridges/adaptors/mcp-app-adaptor.js +120 -0
  47. package/dist/web/bridges/adaptors/mcp-app-adaptor.js.map +1 -0
  48. package/dist/web/bridges/apps-sdk-bridge.d.ts +10 -0
  49. package/dist/web/bridges/apps-sdk-bridge.js +46 -0
  50. package/dist/web/bridges/apps-sdk-bridge.js.map +1 -0
  51. package/dist/web/bridges/hooks/use-adaptor.d.ts +2 -0
  52. package/dist/web/bridges/hooks/use-adaptor.js +8 -0
  53. package/dist/web/bridges/hooks/use-adaptor.js.map +1 -0
  54. package/dist/web/bridges/hooks/use-apps-sdk-bridge.d.ts +2 -0
  55. package/dist/web/bridges/hooks/use-apps-sdk-bridge.js +7 -0
  56. package/dist/web/bridges/hooks/use-apps-sdk-bridge.js.map +1 -0
  57. package/dist/web/bridges/hooks/use-bridge.d.ts +2 -0
  58. package/dist/web/bridges/hooks/use-bridge.js +8 -0
  59. package/dist/web/bridges/hooks/use-bridge.js.map +1 -0
  60. package/dist/web/bridges/hooks/use-mcp-app-bridge.d.ts +5 -0
  61. package/dist/web/bridges/hooks/use-mcp-app-bridge.js +7 -0
  62. package/dist/web/bridges/hooks/use-mcp-app-bridge.js.map +1 -0
  63. package/dist/web/bridges/hooks/use-mcp-app-bridge.test.js +62 -0
  64. package/dist/web/bridges/hooks/use-mcp-app-bridge.test.js.map +1 -0
  65. package/dist/web/bridges/index.d.ts +4 -0
  66. package/dist/web/bridges/index.js +5 -0
  67. package/dist/web/bridges/index.js.map +1 -0
  68. package/dist/web/bridges/mcp-app-bridge.d.ts +49 -0
  69. package/dist/web/bridges/mcp-app-bridge.js +256 -0
  70. package/dist/web/bridges/mcp-app-bridge.js.map +1 -0
  71. package/dist/web/bridges/types.d.ts +57 -0
  72. package/dist/web/bridges/types.js +2 -0
  73. package/dist/web/bridges/types.js.map +1 -0
  74. package/dist/web/create-store.d.ts +3 -0
  75. package/dist/web/create-store.js +25 -0
  76. package/dist/web/create-store.js.map +1 -0
  77. package/dist/web/create-store.test.d.ts +1 -0
  78. package/dist/web/create-store.test.js +70 -0
  79. package/dist/web/create-store.test.js.map +1 -0
  80. package/dist/web/data-llm.d.ts +14 -0
  81. package/dist/web/data-llm.js +70 -0
  82. package/dist/web/data-llm.js.map +1 -0
  83. package/dist/web/data-llm.test.d.ts +1 -0
  84. package/dist/web/data-llm.test.js +76 -0
  85. package/dist/web/data-llm.test.js.map +1 -0
  86. package/dist/web/generate-helpers.d.ts +115 -0
  87. package/dist/web/generate-helpers.js +111 -0
  88. package/dist/web/generate-helpers.js.map +1 -0
  89. package/dist/web/generate-helpers.test-d.d.ts +1 -0
  90. package/dist/web/generate-helpers.test-d.js +209 -0
  91. package/dist/web/generate-helpers.test-d.js.map +1 -0
  92. package/dist/web/generate-helpers.test.d.ts +1 -0
  93. package/dist/web/generate-helpers.test.js +17 -0
  94. package/dist/web/generate-helpers.test.js.map +1 -0
  95. package/dist/web/helpers/state.d.ts +7 -0
  96. package/dist/web/helpers/state.js +40 -0
  97. package/dist/web/helpers/state.js.map +1 -0
  98. package/dist/web/helpers/state.test.d.ts +1 -0
  99. package/dist/web/helpers/state.test.js +53 -0
  100. package/dist/web/helpers/state.test.js.map +1 -0
  101. package/dist/web/hooks/index.d.ts +11 -0
  102. package/dist/web/hooks/index.js +12 -0
  103. package/dist/web/hooks/index.js.map +1 -0
  104. package/dist/web/hooks/test/utils.d.ts +10 -0
  105. package/dist/web/hooks/test/utils.js +40 -0
  106. package/dist/web/hooks/test/utils.js.map +1 -0
  107. package/dist/web/hooks/use-call-tool.d.ts +100 -0
  108. package/dist/web/hooks/use-call-tool.js +68 -0
  109. package/dist/web/hooks/use-call-tool.js.map +1 -0
  110. package/dist/web/hooks/use-call-tool.test-d.d.ts +1 -0
  111. package/dist/web/hooks/use-call-tool.test-d.js +104 -0
  112. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  113. package/dist/web/hooks/use-call-tool.test.d.ts +1 -0
  114. package/dist/web/hooks/use-call-tool.test.js +190 -0
  115. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  116. package/dist/web/hooks/use-display-mode.d.ts +4 -0
  117. package/dist/web/hooks/use-display-mode.js +10 -0
  118. package/dist/web/hooks/use-display-mode.js.map +1 -0
  119. package/dist/web/hooks/use-display-mode.test.d.ts +1 -0
  120. package/dist/web/hooks/use-display-mode.test.js +41 -0
  121. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  122. package/dist/web/hooks/use-files.d.ts +10 -0
  123. package/dist/web/hooks/use-files.js +7 -0
  124. package/dist/web/hooks/use-files.js.map +1 -0
  125. package/dist/web/hooks/use-files.test.d.ts +1 -0
  126. package/dist/web/hooks/use-files.test.js +29 -0
  127. package/dist/web/hooks/use-files.test.js.map +1 -0
  128. package/dist/web/hooks/use-layout.d.ts +22 -0
  129. package/dist/web/hooks/use-layout.js +23 -0
  130. package/dist/web/hooks/use-layout.js.map +1 -0
  131. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  132. package/dist/web/hooks/use-layout.test.js +95 -0
  133. package/dist/web/hooks/use-layout.test.js.map +1 -0
  134. package/dist/web/hooks/use-open-external.d.ts +1 -0
  135. package/dist/web/hooks/use-open-external.js +8 -0
  136. package/dist/web/hooks/use-open-external.js.map +1 -0
  137. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  138. package/dist/web/hooks/use-open-external.test.js +50 -0
  139. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  140. package/dist/web/hooks/use-openai-global.d.ts +3 -0
  141. package/dist/web/hooks/use-openai-global.js +6 -0
  142. package/dist/web/hooks/use-openai-global.js.map +1 -0
  143. package/dist/web/hooks/use-request-modal.d.ts +9 -0
  144. package/dist/web/hooks/use-request-modal.js +14 -0
  145. package/dist/web/hooks/use-request-modal.js.map +1 -0
  146. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  147. package/dist/web/hooks/use-request-modal.test.js +57 -0
  148. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  149. package/dist/web/hooks/use-send-follow-up-message.d.ts +1 -0
  150. package/dist/web/hooks/use-send-follow-up-message.js +8 -0
  151. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  152. package/dist/web/hooks/use-tool-info.d.ts +36 -0
  153. package/dist/web/hooks/use-tool-info.js +26 -0
  154. package/dist/web/hooks/use-tool-info.js.map +1 -0
  155. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  156. package/dist/web/hooks/use-tool-info.test-d.js +109 -0
  157. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  158. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  159. package/dist/web/hooks/use-tool-info.test.js +130 -0
  160. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  161. package/dist/web/hooks/use-user.d.ts +18 -0
  162. package/dist/web/hooks/use-user.js +19 -0
  163. package/dist/web/hooks/use-user.js.map +1 -0
  164. package/dist/web/hooks/use-user.test.d.ts +1 -0
  165. package/dist/web/hooks/use-user.test.js +93 -0
  166. package/dist/web/hooks/use-user.test.js.map +1 -0
  167. package/dist/web/hooks/use-widget-state.d.ts +4 -0
  168. package/dist/web/hooks/use-widget-state.js +32 -0
  169. package/dist/web/hooks/use-widget-state.js.map +1 -0
  170. package/dist/web/hooks/use-widget-state.test.d.ts +1 -0
  171. package/dist/web/hooks/use-widget-state.test.js +61 -0
  172. package/dist/web/hooks/use-widget-state.test.js.map +1 -0
  173. package/dist/web/index.d.ts +8 -0
  174. package/dist/web/index.js +9 -0
  175. package/dist/web/index.js.map +1 -0
  176. package/dist/{src/web → web}/mount-widget.js +5 -0
  177. package/dist/web/mount-widget.js.map +1 -0
  178. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  179. package/dist/web/plugin/data-llm.test.js +81 -0
  180. package/dist/web/plugin/data-llm.test.js.map +1 -0
  181. package/dist/web/plugin/plugin.js +39 -0
  182. package/dist/web/plugin/plugin.js.map +1 -0
  183. package/dist/web/plugin/transform-data-llm.d.ts +12 -0
  184. package/dist/web/plugin/transform-data-llm.js +96 -0
  185. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  186. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  187. package/dist/web/plugin/transform-data-llm.test.js +81 -0
  188. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  189. package/dist/web/proxy.d.ts +1 -0
  190. package/dist/web/proxy.js +53 -0
  191. package/dist/web/proxy.js.map +1 -0
  192. package/dist/web/types.d.ts +149 -0
  193. package/dist/{src/web → web}/types.js +1 -0
  194. package/dist/web/types.js.map +1 -0
  195. package/package.json +55 -24
  196. package/README.md +0 -126
  197. package/dist/src/server/index.d.ts +0 -2
  198. package/dist/src/server/index.js.map +0 -1
  199. package/dist/src/server/server.d.ts +0 -13
  200. package/dist/src/server/server.js +0 -56
  201. package/dist/src/server/server.js.map +0 -1
  202. package/dist/src/server/templateHelper.d.ts +0 -14
  203. package/dist/src/server/templateHelper.js.map +0 -1
  204. package/dist/src/server/templates/development.hbs +0 -12
  205. package/dist/src/server/widgetsDevServer.js.map +0 -1
  206. package/dist/src/test/setup.js +0 -9
  207. package/dist/src/test/setup.js.map +0 -1
  208. package/dist/src/test/utils.d.ts +0 -28
  209. package/dist/src/test/utils.js +0 -43
  210. package/dist/src/test/utils.js.map +0 -1
  211. package/dist/src/test/widget.test.js +0 -69
  212. package/dist/src/test/widget.test.js.map +0 -1
  213. package/dist/src/web/index.d.ts +0 -5
  214. package/dist/src/web/index.js +0 -6
  215. package/dist/src/web/index.js.map +0 -1
  216. package/dist/src/web/mount-widget.js.map +0 -1
  217. package/dist/src/web/plugin.js +0 -28
  218. package/dist/src/web/plugin.js.map +0 -1
  219. package/dist/src/web/types.d.ts +0 -95
  220. package/dist/src/web/types.js.map +0 -1
  221. package/dist/src/web/use-openai-global.d.ts +0 -2
  222. package/dist/src/web/use-openai-global.js +0 -21
  223. package/dist/src/web/use-openai-global.js.map +0 -1
  224. package/dist/src/web/use-tool-output.d.ts +0 -3
  225. package/dist/src/web/use-tool-output.js +0 -5
  226. package/dist/src/web/use-tool-output.js.map +0 -1
  227. package/dist/vitest.config.d.ts +0 -2
  228. package/dist/vitest.config.js +0 -9
  229. package/dist/vitest.config.js.map +0 -1
  230. /package/dist/{src/server → server}/index.js +0 -0
  231. /package/dist/{src/test → test}/widget.test.d.ts +0 -0
  232. /package/dist/{src/test/setup.d.ts → web/bridges/hooks/use-mcp-app-bridge.test.d.ts} +0 -0
  233. /package/dist/{src/web → web}/mount-widget.d.ts +0 -0
  234. /package/dist/{src/web → web/plugin}/plugin.d.ts +0 -0
@@ -0,0 +1,255 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
2
+ import { createMockExtra, createMockMcpServer, resetTestEnv, setTestEnv, } from "./utils.js";
3
+ const mockManifest = {
4
+ "src/widgets/my-widget.tsx": { file: "my-widget.js" },
5
+ "src/widgets/folder-widget/index.tsx": { file: "folder-widget.js" },
6
+ "style.css": { file: "style.css" },
7
+ };
8
+ const actual = vi.hoisted(() => require("node:fs"));
9
+ vi.mock("node:fs", () => {
10
+ const readFileSyncImpl = (path, ...args) => {
11
+ if (typeof path === "string" && path.includes("manifest.json")) {
12
+ return JSON.stringify(mockManifest);
13
+ }
14
+ return actual.readFileSync(path, ...args);
15
+ };
16
+ const readFileSync = vi.fn(readFileSyncImpl);
17
+ return {
18
+ readFileSync,
19
+ default: {
20
+ readFileSync,
21
+ },
22
+ };
23
+ });
24
+ describe("McpServer.registerWidget", () => {
25
+ let server;
26
+ let mockRegisterResource;
27
+ let mockRegisterTool;
28
+ beforeEach(() => {
29
+ ({ server, mockRegisterResource, mockRegisterTool } =
30
+ createMockMcpServer());
31
+ });
32
+ afterEach(() => {
33
+ vi.clearAllMocks();
34
+ resetTestEnv();
35
+ });
36
+ it("should generate correct HTML for development mode", async () => {
37
+ setTestEnv({ NODE_ENV: "development" });
38
+ const mockToolCallback = vi.fn();
39
+ const mockRegisterResourceConfig = { description: "Test widget" };
40
+ const mockToolConfig = { description: "Test tool" };
41
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
42
+ // Get the resource callback function
43
+ const appsSdkResourceCallback = mockRegisterResource.mock
44
+ .calls[0]?.[3];
45
+ expect(appsSdkResourceCallback).toBeDefined();
46
+ const serverUrl = "http://localhost:3000";
47
+ const mockExtra = createMockExtra("__not_used__");
48
+ const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
49
+ expect(mockRegisterTool).toHaveBeenCalled();
50
+ expect(result).toEqual({
51
+ contents: [
52
+ {
53
+ uri: "ui://widgets/apps-sdk/my-widget.html",
54
+ mimeType: "text/html+skybridge",
55
+ text: expect.stringContaining('<div id="root"></div>'),
56
+ _meta: {
57
+ "openai/widgetCSP": {
58
+ resource_domains: [serverUrl],
59
+ connect_domains: ["ws://localhost:24678"],
60
+ },
61
+ "openai/widgetDomain": serverUrl,
62
+ "openai/widgetDescription": "Test tool",
63
+ },
64
+ },
65
+ ],
66
+ });
67
+ // Check development-specific content
68
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/@react-refresh`);
69
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/@vite/client`);
70
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/src/widgets/my-widget`);
71
+ expect(result.contents[0]?.text).not.toContain(`${serverUrl}/src/widgets/my-widget.tsx`);
72
+ });
73
+ it("should generate correct HTML for production mode", async () => {
74
+ setTestEnv({ NODE_ENV: "production" });
75
+ const mockToolCallback = vi.fn();
76
+ const mockRegisterResourceConfig = { description: "Test widget" };
77
+ const mockToolConfig = { description: "Test tool" };
78
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
79
+ // Get the resource callback function
80
+ const appsSdkResourceCallback = mockRegisterResource.mock
81
+ .calls[0]?.[3];
82
+ expect(appsSdkResourceCallback).toBeDefined();
83
+ const host = "myapp.com";
84
+ const serverUrl = `https://${host}`;
85
+ const mockExtra = createMockExtra(host);
86
+ const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
87
+ expect(result).toEqual({
88
+ contents: [
89
+ {
90
+ uri: "ui://widgets/apps-sdk/my-widget.html",
91
+ mimeType: "text/html+skybridge",
92
+ text: expect.stringContaining('<div id="root"></div>'),
93
+ _meta: {
94
+ "openai/widgetCSP": {
95
+ resource_domains: [serverUrl],
96
+ connect_domains: [],
97
+ },
98
+ "openai/widgetDomain": serverUrl,
99
+ "openai/widgetDescription": "Test tool",
100
+ },
101
+ },
102
+ ],
103
+ });
104
+ // Check production-specific content
105
+ expect(result.contents[0]?.text).not.toContain(`${serverUrl}/assets/@react-refresh`);
106
+ expect(result.contents[0]?.text).not.toContain(`${serverUrl}@vite/client`);
107
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/my-widget.js`);
108
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/style.css`);
109
+ });
110
+ it("should resolve folder-based widgets (barrel files) in production mode", async () => {
111
+ setTestEnv({ NODE_ENV: "production" });
112
+ const mockToolCallback = vi.fn();
113
+ const mockRegisterResourceConfig = { description: "Folder widget" };
114
+ const mockToolConfig = { description: "Folder tool" };
115
+ server.registerWidget("folder-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
116
+ const appsSdkResourceCallback = mockRegisterResource.mock
117
+ .calls[0]?.[3];
118
+ expect(appsSdkResourceCallback).toBeDefined();
119
+ const host = "myapp.com";
120
+ const serverUrl = `https://${host}`;
121
+ const mockExtra = createMockExtra(host);
122
+ const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/folder-widget.html"), mockExtra);
123
+ // Should resolve to folder-widget.js from the manifest entry "src/widgets/folder-widget/index.tsx"
124
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/folder-widget.js`);
125
+ });
126
+ it("should register resources with correct hostType for both apps-sdk and ext-apps formats", async () => {
127
+ const mockToolCallback = vi.fn();
128
+ const mockRegisterResourceConfig = {
129
+ description: "Test widget",
130
+ _meta: { "openai/widgetPrefersBorder": true },
131
+ };
132
+ const mockToolConfig = { description: "Test tool" };
133
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
134
+ expect(mockRegisterResource).toHaveBeenCalledTimes(2);
135
+ const appsSdkCallback = mockRegisterResource.mock
136
+ .calls[0]?.[3];
137
+ const appsSdkResult = await appsSdkCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), createMockExtra("__not_used__"));
138
+ expect(appsSdkResult).toEqual({
139
+ contents: [
140
+ {
141
+ uri: "ui://widgets/apps-sdk/my-widget.html",
142
+ mimeType: "text/html+skybridge",
143
+ text: expect.stringContaining('<div id="root"></div>'),
144
+ _meta: {
145
+ "openai/widgetCSP": {
146
+ resource_domains: ["http://localhost:3000"],
147
+ connect_domains: ["ws://localhost:24678"],
148
+ },
149
+ "openai/widgetDomain": "http://localhost:3000",
150
+ "openai/widgetDescription": "Test tool",
151
+ "openai/widgetPrefersBorder": true,
152
+ },
153
+ },
154
+ ],
155
+ });
156
+ expect(appsSdkResult.contents[0]?.text).toContain('window.skybridge = { hostType: "apps-sdk" }');
157
+ const extAppsResourceCallback = mockRegisterResource.mock
158
+ .calls[1]?.[3];
159
+ expect(extAppsResourceCallback).toBeDefined();
160
+ const extAppsResult = await extAppsResourceCallback(new URL("ui://widgets/ext-apps/my-widget.html"), createMockExtra("__not_used__"));
161
+ expect(extAppsResult).toEqual({
162
+ contents: [
163
+ {
164
+ uri: "ui://widgets/ext-apps/my-widget.html",
165
+ mimeType: "text/html;profile=mcp-app",
166
+ text: expect.stringContaining('<div id="root"></div>'),
167
+ _meta: {
168
+ ui: {
169
+ csp: {
170
+ resourceDomains: ["http://localhost:3000"],
171
+ connectDomains: ["ws://localhost:24678"],
172
+ },
173
+ domain: "http://localhost:3000",
174
+ },
175
+ },
176
+ },
177
+ ],
178
+ });
179
+ expect(extAppsResult.contents[0]?.text).toContain('window.skybridge = { hostType: "mcp-app" }');
180
+ });
181
+ it("should register tool with ui.resourceUri metadata (not deprecated ui/resourceUri)", async () => {
182
+ const mockToolCallback = vi.fn();
183
+ const mockRegisterResourceConfig = { description: "Test widget" };
184
+ const mockToolConfig = { description: "Test tool" };
185
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
186
+ expect(mockRegisterTool).toHaveBeenCalledTimes(1);
187
+ const toolCallArgs = mockRegisterTool.mock.calls[0];
188
+ const toolConfig = toolCallArgs?.[1];
189
+ expect(toolConfig._meta).toHaveProperty("ui");
190
+ expect(toolConfig._meta?.ui).toEqual({
191
+ resourceUri: "ui://widgets/ext-apps/my-widget.html",
192
+ });
193
+ });
194
+ it("should apply meta overrides in correct priority: defaults < ui.* < direct openai/* keys", async () => {
195
+ const mockToolCallback = vi.fn();
196
+ const mockRegisterResourceConfig = {
197
+ description: "Test widget",
198
+ _meta: {
199
+ // ui.csp overrides (middle priority)
200
+ ui: {
201
+ csp: {
202
+ resourceDomains: ["https://from-ui-csp.com"],
203
+ connectDomains: ["https://from-ui-csp.com"],
204
+ },
205
+ domain: "https://from-ui-domain.com",
206
+ prefersBorder: false,
207
+ },
208
+ // Direct openai/* keys (highest priority) - should override ui.*
209
+ "openai/widgetDomain": "https://direct-override.com",
210
+ "openai/widgetPrefersBorder": true,
211
+ },
212
+ };
213
+ const mockToolConfig = { description: "Test tool" };
214
+ server.registerWidget("override-test", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
215
+ const appsSdkCallback = mockRegisterResource.mock
216
+ .calls[0]?.[3];
217
+ const result = await appsSdkCallback(new URL("ui://widgets/apps-sdk/override-test.html"), createMockExtra("__not_used__"));
218
+ const meta = result.contents[0]?._meta;
219
+ // CSP arrays are merged with union - all unique domains from defaults and user config are preserved
220
+ expect(meta["openai/widgetCSP"]).toEqual({
221
+ resource_domains: ["http://localhost:3000", "https://from-ui-csp.com"],
222
+ connect_domains: ["ws://localhost:24678", "https://from-ui-csp.com"],
223
+ frame_domains: undefined,
224
+ redirect_domains: undefined,
225
+ });
226
+ // Domain should be overridden by direct openai/* key (highest priority)
227
+ expect(meta["openai/widgetDomain"]).toBe("https://direct-override.com");
228
+ // PrefersBorder should be overridden by direct openai/* key (highest priority)
229
+ expect(meta["openai/widgetPrefersBorder"]).toBe(true);
230
+ // Description should be from defaults (toolConfig.description)
231
+ expect(meta["openai/widgetDescription"]).toBe("Test tool");
232
+ });
233
+ it("should register tool with ui.resourceUri metadata only", async () => {
234
+ const mockToolCallback = vi.fn();
235
+ server.registerWidget("my-widget", { description: "Test widget", hosts: ["mcp-app"] }, { description: "Test tool" }, mockToolCallback);
236
+ expect(mockRegisterTool).toHaveBeenCalledTimes(1);
237
+ const toolCallArgs = mockRegisterTool.mock.calls[0];
238
+ const toolConfig = toolCallArgs?.[1];
239
+ expect(toolConfig._meta).toHaveProperty("ui");
240
+ expect(toolConfig._meta?.ui).toEqual({
241
+ resourceUri: "ui://widgets/ext-apps/my-widget.html",
242
+ });
243
+ expect(toolConfig._meta?.["openai/outputTemplate"]).to.be.undefined;
244
+ });
245
+ it("should register tool with uopenai/outputTemplate metadata only", async () => {
246
+ const mockToolCallback = vi.fn();
247
+ server.registerWidget("my-widget", { description: "Test widget", hosts: ["apps-sdk"] }, { description: "Test tool" }, mockToolCallback);
248
+ expect(mockRegisterTool).toHaveBeenCalledTimes(1);
249
+ const toolCallArgs = mockRegisterTool.mock.calls[0];
250
+ const toolConfig = toolCallArgs?.[1];
251
+ expect(toolConfig._meta).not.toHaveProperty("ui");
252
+ expect(toolConfig._meta?.["openai/outputTemplate"]).to.eq("ui://widgets/apps-sdk/my-widget.html");
253
+ });
254
+ });
255
+ //# sourceMappingURL=widget.test.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,13 @@
1
+ import type { Adaptor, BridgeInterface, CallToolResponse, DisplayMode, ExternalStore } from "../types.js";
2
+ export declare class AppsSdkAdaptor implements Adaptor {
3
+ private static instance;
4
+ static getInstance(): AppsSdkAdaptor;
5
+ static resetInstance(): void;
6
+ getExternalStore<K extends keyof BridgeInterface>(key: K): ExternalStore<K>;
7
+ callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
8
+ requestDisplayMode: (mode: DisplayMode) => Promise<{
9
+ mode: DisplayMode;
10
+ }>;
11
+ sendFollowUpMessage: (prompt: string) => Promise<void>;
12
+ openExternal(href: string): void;
13
+ }
@@ -0,0 +1,33 @@
1
+ import { AppsSdkBridge } from "../apps-sdk-bridge.js";
2
+ export class AppsSdkAdaptor {
3
+ static instance = null;
4
+ static getInstance() {
5
+ if (!AppsSdkAdaptor.instance) {
6
+ AppsSdkAdaptor.instance = new AppsSdkAdaptor();
7
+ }
8
+ return AppsSdkAdaptor.instance;
9
+ }
10
+ static resetInstance() {
11
+ AppsSdkAdaptor.instance = null;
12
+ }
13
+ getExternalStore(key) {
14
+ const bridge = AppsSdkBridge.getInstance();
15
+ return {
16
+ subscribe: bridge.subscribe(key),
17
+ getSnapshot: () => bridge.getSnapshot(key),
18
+ };
19
+ }
20
+ callTool = async (name, args) => {
21
+ return window.openai.callTool(name, args);
22
+ };
23
+ requestDisplayMode = (mode) => {
24
+ return window.openai.requestDisplayMode({ mode });
25
+ };
26
+ sendFollowUpMessage = (prompt) => {
27
+ return window.openai.sendFollowUpMessage({ prompt });
28
+ };
29
+ openExternal(href) {
30
+ window.openai.openExternal({ href });
31
+ }
32
+ }
33
+ //# sourceMappingURL=apps-sdk-adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apps-sdk-adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/adaptors/apps-sdk-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAStD,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,gBAAgB,CACrB,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"}
@@ -0,0 +1,16 @@
1
+ import type { McpUiRequestDisplayModeResult } from "@modelcontextprotocol/ext-apps";
2
+ import type { Adaptor, BridgeInterface, CallToolResponse, DisplayMode, ExternalStore } from "../types.js";
3
+ export declare class McpAppAdaptor implements Adaptor {
4
+ private static instance;
5
+ private stores;
6
+ private constructor();
7
+ static getInstance(): McpAppAdaptor;
8
+ static resetInstance(): void;
9
+ getExternalStore<K extends keyof BridgeInterface>(key: K): ExternalStore<K>;
10
+ callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
11
+ requestDisplayMode: (mode: DisplayMode) => Promise<McpUiRequestDisplayModeResult>;
12
+ sendFollowUpMessage: (prompt: string) => Promise<void>;
13
+ openExternal(href: string): void;
14
+ private initializeStores;
15
+ private createExternalStore;
16
+ }
@@ -0,0 +1,120 @@
1
+ import { dequal } from "dequal/lite";
2
+ import { McpAppBridge, } from "../mcp-app-bridge.js";
3
+ export class McpAppAdaptor {
4
+ static instance = null;
5
+ stores;
6
+ constructor() {
7
+ this.stores = this.initializeStores();
8
+ }
9
+ static getInstance() {
10
+ if (!McpAppAdaptor.instance) {
11
+ McpAppAdaptor.instance = new McpAppAdaptor();
12
+ }
13
+ return McpAppAdaptor.instance;
14
+ }
15
+ static resetInstance() {
16
+ McpAppAdaptor.instance = null;
17
+ }
18
+ getExternalStore(key) {
19
+ return this.stores[key];
20
+ }
21
+ callTool = async (name, args) => {
22
+ const bridge = McpAppBridge.getInstance();
23
+ const response = await bridge.request({
24
+ method: "tools/call",
25
+ params: {
26
+ name,
27
+ arguments: args ?? undefined,
28
+ },
29
+ });
30
+ const result = response.content
31
+ .filter((content) => content.type === "text")
32
+ .map(({ text }) => text)
33
+ .join("\n");
34
+ return {
35
+ content: response.content,
36
+ structuredContent: response.structuredContent ?? {},
37
+ isError: response.isError ?? false,
38
+ result,
39
+ _meta: response._meta ?? {},
40
+ };
41
+ };
42
+ requestDisplayMode = (mode) => {
43
+ const bridge = McpAppBridge.getInstance();
44
+ if (mode !== "modal") {
45
+ return bridge.request({
46
+ method: "ui/request-display-mode",
47
+ params: { mode },
48
+ });
49
+ }
50
+ throw new Error("Modal display mode is not accessible in MCP App.");
51
+ };
52
+ sendFollowUpMessage = async (prompt) => {
53
+ const bridge = McpAppBridge.getInstance();
54
+ await bridge.request({
55
+ method: "ui/message",
56
+ params: {
57
+ role: "user",
58
+ content: [
59
+ {
60
+ type: "text",
61
+ text: prompt,
62
+ },
63
+ ],
64
+ },
65
+ });
66
+ };
67
+ openExternal(href) {
68
+ const bridge = McpAppBridge.getInstance();
69
+ bridge.request({
70
+ method: "ui/open-link",
71
+ params: { url: href },
72
+ });
73
+ }
74
+ initializeStores() {
75
+ return {
76
+ theme: this.createExternalStore(["theme"], ({ theme }) => theme ?? "light"),
77
+ locale: this.createExternalStore(["locale"], ({ locale }) => locale ?? "en-US"),
78
+ safeArea: this.createExternalStore(["safeAreaInsets"], ({ safeAreaInsets }) => ({
79
+ insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },
80
+ })),
81
+ displayMode: this.createExternalStore(["displayMode"], ({ displayMode }) => displayMode ?? "inline"),
82
+ maxHeight: this.createExternalStore(["containerDimensions"], ({ containerDimensions }) => {
83
+ if (containerDimensions && "maxHeight" in containerDimensions) {
84
+ return containerDimensions.maxHeight ?? window.innerHeight;
85
+ }
86
+ return window.innerHeight;
87
+ }),
88
+ userAgent: this.createExternalStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
89
+ device: {
90
+ type: platform === "web" ? "desktop" : (platform ?? "unknown"),
91
+ },
92
+ capabilities: {
93
+ hover: true,
94
+ touch: true,
95
+ ...deviceCapabilities,
96
+ },
97
+ })),
98
+ toolInput: this.createExternalStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
99
+ toolOutput: this.createExternalStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
100
+ toolResponseMetadata: this.createExternalStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
101
+ };
102
+ }
103
+ createExternalStore(keys, computeSnapshot) {
104
+ const bridge = McpAppBridge.getInstance();
105
+ let cachedValue;
106
+ return {
107
+ subscribe: bridge.subscribe(keys),
108
+ getSnapshot: () => {
109
+ const context = Object.fromEntries(keys.map((k) => [k, bridge.getSnapshot(k)]));
110
+ const newValue = computeSnapshot(context);
111
+ if (cachedValue !== undefined && dequal(cachedValue, newValue)) {
112
+ return cachedValue;
113
+ }
114
+ cachedValue = newValue;
115
+ return newValue;
116
+ },
117
+ };
118
+ }
119
+ }
120
+ //# sourceMappingURL=mcp-app-adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-app-adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/adaptors/mcp-app-adaptor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { type OpenAiProperties } from "../types.js";
2
+ import type { Bridge, Subscribe } from "./types.js";
3
+ export declare class AppsSdkBridge implements Bridge<OpenAiProperties> {
4
+ private static instance;
5
+ static getInstance(): AppsSdkBridge;
6
+ static resetInstance(): void;
7
+ subscribe(key: keyof OpenAiProperties): Subscribe;
8
+ subscribe(keys: readonly (keyof OpenAiProperties)[]): Subscribe;
9
+ getSnapshot: <K extends keyof OpenAiProperties>(key: K) => (import("../types.js").OpenAiMethods<import("../types.js").UnknownObject> & OpenAiProperties<Record<never, unknown>, import("../types.js").UnknownObject, import("../types.js").UnknownObject, import("../types.js").UnknownObject>)[K];
10
+ }
@@ -0,0 +1,46 @@
1
+ import { SET_GLOBALS_EVENT_TYPE, } from "../types.js";
2
+ export class AppsSdkBridge {
3
+ static instance = null;
4
+ static getInstance() {
5
+ if (window.skybridge.hostType !== "apps-sdk" ||
6
+ window.openai === undefined) {
7
+ throw new Error("Apps SDK Bridge can only be used in the apps-sdk runtime");
8
+ }
9
+ if (AppsSdkBridge.instance === null) {
10
+ AppsSdkBridge.instance = new AppsSdkBridge();
11
+ }
12
+ return AppsSdkBridge.instance;
13
+ }
14
+ static resetInstance() {
15
+ if (AppsSdkBridge.instance) {
16
+ AppsSdkBridge.instance = null;
17
+ }
18
+ }
19
+ subscribe(keyOrKeys) {
20
+ const keys = Array.isArray(keyOrKeys)
21
+ ? keyOrKeys
22
+ : [keyOrKeys];
23
+ return (onChange) => {
24
+ const handleSetGlobal = (event) => {
25
+ const hasRelevantChange = keys.some((key) => event.detail.globals[key] !== undefined);
26
+ if (!hasRelevantChange) {
27
+ return;
28
+ }
29
+ onChange();
30
+ };
31
+ window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {
32
+ passive: true,
33
+ });
34
+ return () => {
35
+ window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);
36
+ };
37
+ };
38
+ }
39
+ getSnapshot = (key) => {
40
+ if (window.openai === undefined) {
41
+ throw new Error(`window.openai is not available. Make sure you're calling the hook requiring ${key} within the OpenAI iFrame skybridge runtime.`);
42
+ }
43
+ return window.openai[key];
44
+ };
45
+ }
46
+ //# sourceMappingURL=apps-sdk-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apps-sdk-bridge.js","sourceRoot":"","sources":["../../../src/web/bridges/apps-sdk-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AAGrB,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,SAAuE;QAEvE,MAAM,IAAI,GAAwC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACxE,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,CAAmC,GAAM,EAAE,EAAE;QAChE,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"}
@@ -0,0 +1,2 @@
1
+ import type { Adaptor } from "../types.js";
2
+ export declare const useAdaptor: () => Adaptor;
@@ -0,0 +1,8 @@
1
+ import { AppsSdkAdaptor } from "../adaptors/apps-sdk-adaptor.js";
2
+ import { McpAppAdaptor } from "../adaptors/mcp-app-adaptor.js";
3
+ export const useAdaptor = () => {
4
+ return window.skybridge.hostType === "apps-sdk"
5
+ ? AppsSdkAdaptor.getInstance()
6
+ : McpAppAdaptor.getInstance();
7
+ };
8
+ //# sourceMappingURL=use-adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/hooks/use-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,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"}
@@ -0,0 +1,2 @@
1
+ import type { OpenAiProperties } from "../../types.js";
2
+ export declare function useAppsSdkBridge<K extends keyof OpenAiProperties>(key: K): OpenAiProperties[K];
@@ -0,0 +1,7 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { AppsSdkBridge } from "../apps-sdk-bridge.js";
3
+ export function useAppsSdkBridge(key) {
4
+ const bridge = AppsSdkBridge.getInstance();
5
+ return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
6
+ }
7
+ //# sourceMappingURL=use-apps-sdk-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-apps-sdk-bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/hooks/use-apps-sdk-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAC9B,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"}
@@ -0,0 +1,2 @@
1
+ import type { BridgeInterface } from "../types.js";
2
+ export declare const useBridge: <K extends keyof BridgeInterface>(key: K) => BridgeInterface[K];
@@ -0,0 +1,8 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { useAdaptor } from "./use-adaptor.js";
3
+ export const useBridge = (key) => {
4
+ const adaptor = useAdaptor();
5
+ const externalStore = adaptor.getExternalStore(key);
6
+ return useSyncExternalStore(externalStore.subscribe, externalStore.getSnapshot);
7
+ };
8
+ //# sourceMappingURL=use-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/hooks/use-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,GAAM,EACc,EAAE;IACtB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEpD,OAAO,oBAAoB,CACzB,aAAa,CAAC,SAAS,EACvB,aAAa,CAAC,WAAW,CAC1B,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { McpUiInitializeRequest } from "@modelcontextprotocol/ext-apps";
2
+ import { type McpAppBridgeContext } from "../mcp-app-bridge.js";
3
+ type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
4
+ export declare function useMcpAppBridge<K extends keyof McpAppBridgeContext>(key: K, options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpAppBridgeContext[K];
5
+ export {};
@@ -0,0 +1,7 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { McpAppBridge } from "../mcp-app-bridge.js";
3
+ export function useMcpAppBridge(key, options, requestTimeout) {
4
+ const bridge = McpAppBridge.getInstance(options, requestTimeout);
5
+ return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
6
+ }
7
+ //# sourceMappingURL=use-mcp-app-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-mcp-app-bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/hooks/use-mcp-app-bridge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AAO9E,MAAM,UAAU,eAAe,CAC7B,GAAM,EACN,OAA8C,EAC9C,cAAuB;IAEvB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACjE,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC"}