skybridge 0.0.0-dev.6e31b21 → 0.0.0-dev.6f1dfd8

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 (286) 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 +99 -0
  27. package/dist/server/server.js +138 -0
  28. package/dist/server/server.js.map +1 -0
  29. package/dist/{src/server → server}/templateHelper.d.ts +3 -0
  30. package/dist/{src/server → server}/templateHelper.js +5 -4
  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 +1 -0
  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/apps-sdk/adaptor.d.ts +14 -0
  43. package/dist/web/bridges/apps-sdk/adaptor.js +39 -0
  44. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -0
  45. package/dist/web/bridges/apps-sdk/bridge.d.ts +10 -0
  46. package/dist/web/bridges/apps-sdk/bridge.js +46 -0
  47. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -0
  48. package/dist/web/bridges/apps-sdk/index.d.ts +5 -0
  49. package/dist/web/bridges/apps-sdk/index.js +5 -0
  50. package/dist/web/bridges/apps-sdk/index.js.map +1 -0
  51. package/dist/{src/web → web/bridges/apps-sdk}/types.d.ts +50 -45
  52. package/dist/web/bridges/apps-sdk/types.js.map +1 -0
  53. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +2 -0
  54. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +7 -0
  55. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -0
  56. package/dist/web/bridges/get-adaptor.d.ts +2 -0
  57. package/dist/web/bridges/get-adaptor.js +8 -0
  58. package/dist/web/bridges/get-adaptor.js.map +1 -0
  59. package/dist/web/bridges/index.d.ts +5 -0
  60. package/dist/web/bridges/index.js +6 -0
  61. package/dist/web/bridges/index.js.map +1 -0
  62. package/dist/web/bridges/mcp-app/adaptor.d.ts +19 -0
  63. package/dist/web/bridges/mcp-app/adaptor.js +145 -0
  64. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -0
  65. package/dist/web/bridges/mcp-app/bridge.d.ts +43 -0
  66. package/dist/web/bridges/mcp-app/bridge.js +255 -0
  67. package/dist/web/bridges/mcp-app/bridge.js.map +1 -0
  68. package/dist/web/bridges/mcp-app/index.d.ts +4 -0
  69. package/dist/web/bridges/mcp-app/index.js +4 -0
  70. package/dist/web/bridges/mcp-app/index.js.map +1 -0
  71. package/dist/web/bridges/mcp-app/types.d.ts +8 -0
  72. package/dist/web/bridges/mcp-app/types.js +2 -0
  73. package/dist/web/bridges/mcp-app/types.js.map +1 -0
  74. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +5 -0
  75. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +7 -0
  76. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -0
  77. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +66 -0
  78. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -0
  79. package/dist/web/bridges/types.d.ts +74 -0
  80. package/dist/web/bridges/types.js +2 -0
  81. package/dist/web/bridges/types.js.map +1 -0
  82. package/dist/web/bridges/use-host-context.d.ts +2 -0
  83. package/dist/web/bridges/use-host-context.js +8 -0
  84. package/dist/web/bridges/use-host-context.js.map +1 -0
  85. package/dist/web/create-store.d.ts +3 -0
  86. package/dist/web/create-store.js +24 -0
  87. package/dist/web/create-store.js.map +1 -0
  88. package/dist/web/create-store.test.js +126 -0
  89. package/dist/web/create-store.test.js.map +1 -0
  90. package/dist/web/data-llm.d.ts +14 -0
  91. package/dist/web/data-llm.js +72 -0
  92. package/dist/web/data-llm.js.map +1 -0
  93. package/dist/web/data-llm.test.js +139 -0
  94. package/dist/web/data-llm.test.js.map +1 -0
  95. package/dist/web/generate-helpers.d.ts +116 -0
  96. package/dist/web/generate-helpers.js +111 -0
  97. package/dist/web/generate-helpers.js.map +1 -0
  98. package/dist/web/generate-helpers.test-d.js +209 -0
  99. package/dist/web/generate-helpers.test-d.js.map +1 -0
  100. package/dist/web/generate-helpers.test.js +17 -0
  101. package/dist/web/generate-helpers.test.js.map +1 -0
  102. package/dist/web/helpers/state.d.ts +7 -0
  103. package/dist/web/helpers/state.js +45 -0
  104. package/dist/web/helpers/state.js.map +1 -0
  105. package/dist/web/helpers/state.test.js +53 -0
  106. package/dist/web/helpers/state.test.js.map +1 -0
  107. package/dist/web/hooks/index.d.ts +10 -0
  108. package/dist/web/hooks/index.js +11 -0
  109. package/dist/web/hooks/index.js.map +1 -0
  110. package/dist/web/hooks/test/utils.d.ts +16 -0
  111. package/dist/web/hooks/test/utils.js +60 -0
  112. package/dist/web/hooks/test/utils.js.map +1 -0
  113. package/dist/web/hooks/use-call-tool.d.ts +101 -0
  114. package/dist/web/hooks/use-call-tool.js +68 -0
  115. package/dist/web/hooks/use-call-tool.js.map +1 -0
  116. package/dist/web/hooks/use-call-tool.test-d.js +104 -0
  117. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  118. package/dist/{src/web → web}/hooks/use-call-tool.test.js +41 -15
  119. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  120. package/dist/{src/web → web}/hooks/use-display-mode.d.ts +1 -1
  121. package/dist/web/hooks/use-display-mode.js +9 -0
  122. package/dist/web/hooks/use-display-mode.js.map +1 -0
  123. package/dist/{src/web → web}/hooks/use-display-mode.test.js +3 -2
  124. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  125. package/dist/web/hooks/use-files.d.ts +10 -0
  126. package/dist/web/hooks/use-files.js +7 -0
  127. package/dist/web/hooks/use-files.js.map +1 -0
  128. package/dist/web/hooks/use-files.test.d.ts +1 -0
  129. package/dist/web/hooks/use-files.test.js +29 -0
  130. package/dist/web/hooks/use-files.test.js.map +1 -0
  131. package/dist/web/hooks/use-layout.d.ts +22 -0
  132. package/dist/web/hooks/use-layout.js +23 -0
  133. package/dist/web/hooks/use-layout.js.map +1 -0
  134. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  135. package/dist/web/hooks/use-layout.test.js +96 -0
  136. package/dist/web/hooks/use-layout.test.js.map +1 -0
  137. package/dist/web/hooks/use-open-external.js +8 -0
  138. package/dist/web/hooks/use-open-external.js.map +1 -0
  139. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  140. package/dist/web/hooks/use-open-external.test.js +50 -0
  141. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  142. package/dist/web/hooks/use-request-modal.d.ts +9 -0
  143. package/dist/web/hooks/use-request-modal.js +14 -0
  144. package/dist/web/hooks/use-request-modal.js.map +1 -0
  145. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  146. package/dist/web/hooks/use-request-modal.test.js +57 -0
  147. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  148. package/dist/web/hooks/use-send-follow-up-message.js +8 -0
  149. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  150. package/dist/web/hooks/use-tool-info.d.ts +36 -0
  151. package/dist/web/hooks/use-tool-info.js +26 -0
  152. package/dist/web/hooks/use-tool-info.js.map +1 -0
  153. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  154. package/dist/web/hooks/use-tool-info.test-d.js +109 -0
  155. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  156. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  157. package/dist/web/hooks/use-tool-info.test.js +130 -0
  158. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  159. package/dist/web/hooks/use-user.d.ts +18 -0
  160. package/dist/web/hooks/use-user.js +19 -0
  161. package/dist/web/hooks/use-user.js.map +1 -0
  162. package/dist/web/hooks/use-user.test.d.ts +1 -0
  163. package/dist/web/hooks/use-user.test.js +94 -0
  164. package/dist/web/hooks/use-user.test.js.map +1 -0
  165. package/dist/web/hooks/use-widget-state.js +32 -0
  166. package/dist/web/hooks/use-widget-state.js.map +1 -0
  167. package/dist/web/hooks/use-widget-state.test.d.ts +1 -0
  168. package/dist/{src/web → web}/hooks/use-widget-state.test.js +3 -2
  169. package/dist/web/hooks/use-widget-state.test.js.map +1 -0
  170. package/dist/web/index.d.ts +8 -0
  171. package/dist/web/index.js +9 -0
  172. package/dist/web/index.js.map +1 -0
  173. package/dist/{src/web → web}/mount-widget.js +5 -0
  174. package/dist/web/mount-widget.js.map +1 -0
  175. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  176. package/dist/web/plugin/data-llm.test.js +81 -0
  177. package/dist/web/plugin/data-llm.test.js.map +1 -0
  178. package/dist/web/plugin/plugin.js +39 -0
  179. package/dist/web/plugin/plugin.js.map +1 -0
  180. package/dist/web/plugin/transform-data-llm.d.ts +12 -0
  181. package/dist/web/plugin/transform-data-llm.js +96 -0
  182. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  183. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  184. package/dist/web/plugin/transform-data-llm.test.js +81 -0
  185. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  186. package/dist/web/proxy.d.ts +1 -0
  187. package/dist/web/proxy.js +53 -0
  188. package/dist/web/proxy.js.map +1 -0
  189. package/dist/web/types.d.ts +16 -0
  190. package/dist/web/types.js +2 -0
  191. package/dist/web/types.js.map +1 -0
  192. package/package.json +54 -31
  193. package/README.md +0 -198
  194. package/dist/src/server/index.d.ts +0 -2
  195. package/dist/src/server/index.js.map +0 -1
  196. package/dist/src/server/server.d.ts +0 -13
  197. package/dist/src/server/server.js +0 -57
  198. package/dist/src/server/server.js.map +0 -1
  199. package/dist/src/server/templateHelper.js.map +0 -1
  200. package/dist/src/server/templates/development.hbs +0 -12
  201. package/dist/src/server/widgetsDevServer.js.map +0 -1
  202. package/dist/src/test/utils.d.ts +0 -28
  203. package/dist/src/test/utils.js +0 -43
  204. package/dist/src/test/utils.js.map +0 -1
  205. package/dist/src/test/widget.test.js +0 -90
  206. package/dist/src/test/widget.test.js.map +0 -1
  207. package/dist/src/web/hooks/index.d.ts +0 -13
  208. package/dist/src/web/hooks/index.js +0 -14
  209. package/dist/src/web/hooks/index.js.map +0 -1
  210. package/dist/src/web/hooks/use-call-tool.d.ts +0 -61
  211. package/dist/src/web/hooks/use-call-tool.js +0 -66
  212. package/dist/src/web/hooks/use-call-tool.js.map +0 -1
  213. package/dist/src/web/hooks/use-call-tool.test.js.map +0 -1
  214. package/dist/src/web/hooks/use-display-mode.js +0 -7
  215. package/dist/src/web/hooks/use-display-mode.js.map +0 -1
  216. package/dist/src/web/hooks/use-display-mode.test.js.map +0 -1
  217. package/dist/src/web/hooks/use-locale.d.ts +0 -1
  218. package/dist/src/web/hooks/use-locale.js +0 -5
  219. package/dist/src/web/hooks/use-locale.js.map +0 -1
  220. package/dist/src/web/hooks/use-locale.test.js +0 -21
  221. package/dist/src/web/hooks/use-locale.test.js.map +0 -1
  222. package/dist/src/web/hooks/use-open-external.js +0 -6
  223. package/dist/src/web/hooks/use-open-external.js.map +0 -1
  224. package/dist/src/web/hooks/use-open-external.test.js +0 -24
  225. package/dist/src/web/hooks/use-open-external.test.js.map +0 -1
  226. package/dist/src/web/hooks/use-openai-global.d.ts +0 -2
  227. package/dist/src/web/hooks/use-openai-global.js +0 -23
  228. package/dist/src/web/hooks/use-openai-global.js.map +0 -1
  229. package/dist/src/web/hooks/use-request-modal.d.ts +0 -5
  230. package/dist/src/web/hooks/use-request-modal.js +0 -9
  231. package/dist/src/web/hooks/use-request-modal.js.map +0 -1
  232. package/dist/src/web/hooks/use-request-modal.test.js +0 -24
  233. package/dist/src/web/hooks/use-request-modal.test.js.map +0 -1
  234. package/dist/src/web/hooks/use-send-follow-up-message.js +0 -11
  235. package/dist/src/web/hooks/use-send-follow-up-message.js.map +0 -1
  236. package/dist/src/web/hooks/use-theme.d.ts +0 -1
  237. package/dist/src/web/hooks/use-theme.js +0 -5
  238. package/dist/src/web/hooks/use-theme.js.map +0 -1
  239. package/dist/src/web/hooks/use-theme.test.js +0 -26
  240. package/dist/src/web/hooks/use-theme.test.js.map +0 -1
  241. package/dist/src/web/hooks/use-tool-info.d.ts +0 -23
  242. package/dist/src/web/hooks/use-tool-info.js +0 -22
  243. package/dist/src/web/hooks/use-tool-info.js.map +0 -1
  244. package/dist/src/web/hooks/use-tool-info.test.js +0 -134
  245. package/dist/src/web/hooks/use-tool-info.test.js.map +0 -1
  246. package/dist/src/web/hooks/use-tool-output.d.ts +0 -4
  247. package/dist/src/web/hooks/use-tool-output.js +0 -9
  248. package/dist/src/web/hooks/use-tool-output.js.map +0 -1
  249. package/dist/src/web/hooks/use-tool-response-metadata.d.ts +0 -4
  250. package/dist/src/web/hooks/use-tool-response-metadata.js +0 -8
  251. package/dist/src/web/hooks/use-tool-response-metadata.js.map +0 -1
  252. package/dist/src/web/hooks/use-user-agent.d.ts +0 -1
  253. package/dist/src/web/hooks/use-user-agent.js +0 -5
  254. package/dist/src/web/hooks/use-user-agent.js.map +0 -1
  255. package/dist/src/web/hooks/use-user-agent.test.js +0 -31
  256. package/dist/src/web/hooks/use-user-agent.test.js.map +0 -1
  257. package/dist/src/web/hooks/use-widget-state.js +0 -30
  258. package/dist/src/web/hooks/use-widget-state.js.map +0 -1
  259. package/dist/src/web/hooks/use-widget-state.test.js.map +0 -1
  260. package/dist/src/web/index.d.ts +0 -4
  261. package/dist/src/web/index.js +0 -5
  262. package/dist/src/web/index.js.map +0 -1
  263. package/dist/src/web/mount-widget.js.map +0 -1
  264. package/dist/src/web/plugin.js +0 -28
  265. package/dist/src/web/plugin.js.map +0 -1
  266. package/dist/src/web/types.js.map +0 -1
  267. package/dist/vitest.config.d.ts +0 -2
  268. package/dist/vitest.config.js +0 -8
  269. package/dist/vitest.config.js.map +0 -1
  270. /package/dist/{src/server → server}/index.js +0 -0
  271. /package/dist/{src/test → test}/widget.test.d.ts +0 -0
  272. /package/dist/{src/web → web/bridges/apps-sdk}/types.js +0 -0
  273. /package/dist/{src/web/hooks/use-call-tool.test.d.ts → web/bridges/mcp-app/use-mcp-app-context.test.d.ts} +0 -0
  274. /package/dist/{src/web/hooks/use-display-mode.test.d.ts → web/create-store.test.d.ts} +0 -0
  275. /package/dist/{src/web/hooks/use-locale.test.d.ts → web/data-llm.test.d.ts} +0 -0
  276. /package/dist/{src/web/hooks/use-open-external.test.d.ts → web/generate-helpers.test-d.d.ts} +0 -0
  277. /package/dist/{src/web/hooks/use-request-modal.test.d.ts → web/generate-helpers.test.d.ts} +0 -0
  278. /package/dist/{src/web/hooks/use-theme.test.d.ts → web/helpers/state.test.d.ts} +0 -0
  279. /package/dist/{src/web/hooks/use-tool-info.test.d.ts → web/hooks/use-call-tool.test-d.d.ts} +0 -0
  280. /package/dist/{src/web/hooks/use-user-agent.test.d.ts → web/hooks/use-call-tool.test.d.ts} +0 -0
  281. /package/dist/{src/web/hooks/use-widget-state.test.d.ts → web/hooks/use-display-mode.test.d.ts} +0 -0
  282. /package/dist/{src/web → web}/hooks/use-open-external.d.ts +0 -0
  283. /package/dist/{src/web → web}/hooks/use-send-follow-up-message.d.ts +0 -0
  284. /package/dist/{src/web → web}/hooks/use-widget-state.d.ts +0 -0
  285. /package/dist/{src/web → web}/mount-widget.d.ts +0 -0
  286. /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":"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"}
@@ -0,0 +1,14 @@
1
+ import type { Adaptor, CallToolResponse, DisplayMode, HostContext, HostContextStore, SetWidgetStateAction } from "../types.js";
2
+ export declare class AppsSdkAdaptor implements Adaptor {
3
+ private static instance;
4
+ static getInstance(): AppsSdkAdaptor;
5
+ static resetInstance(): void;
6
+ getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<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
+ setWidgetState: (stateOrUpdater: SetWidgetStateAction) => Promise<void>;
14
+ }
@@ -0,0 +1,39 @@
1
+ import { AppsSdkBridge } from "./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
+ getHostContextStore(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
+ setWidgetState = (stateOrUpdater) => {
33
+ const newState = typeof stateOrUpdater === "function"
34
+ ? stateOrUpdater(window.openai.widgetState)
35
+ : stateOrUpdater;
36
+ return window.openai.setWidgetState(newState);
37
+ };
38
+ }
39
+ //# sourceMappingURL=adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"AAQA,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"}
@@ -0,0 +1,10 @@
1
+ import type { Bridge, Subscribe } from "../types.js";
2
+ import { type AppsSdkContext } from "./types.js";
3
+ export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
4
+ private static instance;
5
+ static getInstance(): AppsSdkBridge;
6
+ static resetInstance(): void;
7
+ subscribe(key: keyof AppsSdkContext): Subscribe;
8
+ subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;
9
+ 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];
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=bridge.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,5 @@
1
+ export { AppsSdkAdaptor } from "./adaptor.js";
2
+ export { AppsSdkBridge } from "./bridge.js";
3
+ export type { AppsSdkContext, AppsSdkMethods, RequestModalOptions, ToolResponseEvent, } from "./types.js";
4
+ export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
5
+ export { useAppsSdkContext } from "./use-apps-sdk-context.js";
@@ -0,0 +1,5 @@
1
+ export { AppsSdkAdaptor } from "./adaptor.js";
2
+ export { AppsSdkBridge } from "./bridge.js";
3
+ export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
4
+ export { useAppsSdkContext } from "./use-apps-sdk-context.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
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;AAO5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
@@ -1,17 +1,9 @@
1
- export type UnknownObject = Record<string, unknown>;
2
- export type WidgetState = UnknownObject;
3
- export type SetWidgetState = (state: WidgetState) => Promise<void>;
4
- export type SendFollowUpMessage = (args: {
5
- prompt: string;
6
- }) => Promise<void>;
7
- export type RequestDisplayMode = (args: {
8
- mode: DisplayMode;
9
- }) => Promise<{
10
- mode: DisplayMode;
11
- }>;
12
- export type RequestModal = (options: RequestModalOptions) => Promise<void>;
13
- export type RequestModalOptions = {
14
- title: string;
1
+ import type { UnknownObject } from "../../types.js";
2
+ import type { CallToolArgs, CallToolResponse } from "../types.js";
3
+ type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
4
+ type WidgetState = UnknownObject;
5
+ type FileMetadata = {
6
+ fileId: string;
15
7
  };
16
8
  export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
17
9
  export declare class ToolResponseEvent extends CustomEvent<{
@@ -24,53 +16,46 @@ export declare class ToolResponseEvent extends CustomEvent<{
24
16
  }
25
17
  declare global {
26
18
  interface Window {
27
- openai: API<WidgetState> & OpenAiGlobals;
19
+ openai: AppsSdkMethods<WidgetState> & AppsSdkContext;
28
20
  }
29
21
  interface WindowEventMap {
30
22
  [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
31
23
  }
32
24
  }
33
- export type OpenAiGlobals<ToolInput extends UnknownObject = {}, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
25
+ export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
34
26
  theme: Theme;
35
27
  userAgent: UserAgent;
36
28
  locale: string;
37
- maxHeight: number;
29
+ maxHeight: number | undefined;
38
30
  displayMode: DisplayMode;
39
31
  safeArea: SafeArea;
32
+ view: View;
40
33
  toolInput: ToolInput;
41
34
  toolOutput: ToolOutput | {
42
35
  text: string;
43
36
  } | null;
44
37
  toolResponseMetadata: ToolResponseMetadata | null;
45
38
  widgetState: WidgetState | null;
46
- requestDisplayMode: RequestDisplayMode;
47
- requestModal: RequestModal;
48
- };
49
- export type CallToolArgs = Record<string, unknown> | null;
50
- export type CallToolResponse = {
51
- content: {
52
- type: "text";
53
- text: string;
54
- }[];
55
- structuredContent: Record<string, unknown>;
56
- isError: boolean;
57
- result: string;
58
- meta: Record<string, unknown>;
59
39
  };
60
- export type DefaultCallToolResponse = {
61
- structuredContent: Record<string, unknown>;
62
- meta: Record<string, unknown>;
40
+ export type RequestModalOptions = {
41
+ title?: string;
42
+ params?: Record<string, unknown>;
43
+ anchor?: {
44
+ top?: number;
45
+ left?: number;
46
+ width?: number;
47
+ height?: number;
48
+ };
63
49
  };
64
- export type CallToolResponseConstraint = Partial<Pick<CallToolResponse, "structuredContent" | "meta">>;
65
- type API<WidgetState extends UnknownObject> = {
50
+ export type AppsSdkMethods<WidgetState extends UnknownObject = UnknownObject> = {
66
51
  /** Calls a tool on your MCP. Returns the full response. */
67
- callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponseConstraint = DefaultCallToolResponse>(name: string, args: ToolArgs) => Promise<CallToolResponse & ToolResponse>;
52
+ callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
68
53
  /** Triggers a followup turn in the ChatGPT conversation */
69
54
  sendFollowUpMessage: (args: {
70
55
  prompt: string;
71
56
  }) => Promise<void>;
72
57
  /** Opens an external link, redirects web page or mobile app */
73
- openExternal(payload: {
58
+ openExternal(args: {
74
59
  href: string;
75
60
  }): void;
76
61
  /** For transitioning an app from inline to fullscreen or pip */
@@ -83,28 +68,48 @@ type API<WidgetState extends UnknownObject> = {
83
68
  */
84
69
  mode: DisplayMode;
85
70
  }>;
71
+ /**
72
+ * Sets the widget state.
73
+ * This state is persisted across widget renders.
74
+ */
86
75
  setWidgetState: (state: WidgetState) => Promise<void>;
76
+ /**
77
+ * Opens a modal portaled outside of the widget iFrame.
78
+ * This ensures the modal is correctly displayed and not limited to the widget's area.
79
+ */
80
+ requestModal: (args: RequestModalOptions) => Promise<void>;
81
+ /** Uploads a new file to the host */
82
+ uploadFile: (file: File) => Promise<FileMetadata>;
83
+ /**
84
+ * Downloads a file from the host that was previously uploaded.
85
+ * Only files uploaded by the same connector instance can be downloaded.
86
+ */
87
+ getFileDownloadUrl: (file: FileMetadata) => Promise<{
88
+ downloadUrl: string;
89
+ }>;
87
90
  };
88
91
  export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
89
92
  export declare class SetGlobalsEvent extends CustomEvent<{
90
- globals: Partial<OpenAiGlobals>;
93
+ globals: Partial<AppsSdkContext>;
91
94
  }> {
92
95
  readonly type = "openai:set_globals";
93
96
  }
94
- export type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
95
- export type DisplayMode = "pip" | "inline" | "fullscreen";
96
- export type Theme = "light" | "dark";
97
- export type SafeAreaInsets = {
97
+ type View = {
98
+ mode: DisplayMode;
99
+ params?: Record<string, unknown>;
100
+ };
101
+ type Theme = "light" | "dark";
102
+ type SafeAreaInsets = {
98
103
  top: number;
99
104
  bottom: number;
100
105
  left: number;
101
106
  right: number;
102
107
  };
103
- export type SafeArea = {
108
+ type SafeArea = {
104
109
  insets: SafeAreaInsets;
105
110
  };
106
- export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
107
- export type UserAgent = {
111
+ type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
112
+ type UserAgent = {
108
113
  device: {
109
114
  type: DeviceType;
110
115
  };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA2FD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
@@ -0,0 +1,2 @@
1
+ import type { AppsSdkContext } from "./types.js";
2
+ export declare function useAppsSdkContext<K extends keyof AppsSdkContext>(key: K): AppsSdkContext[K];
@@ -0,0 +1,7 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { AppsSdkBridge } from "./bridge.js";
3
+ export function useAppsSdkContext(key) {
4
+ const bridge = AppsSdkBridge.getInstance();
5
+ return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
6
+ }
7
+ //# sourceMappingURL=use-apps-sdk-context.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,2 @@
1
+ import type { Adaptor } from "./types.js";
2
+ export declare const getAdaptor: () => Adaptor;
@@ -0,0 +1,8 @@
1
+ import { AppsSdkAdaptor } from "./apps-sdk/adaptor.js";
2
+ import { McpAppAdaptor } from "./mcp-app/adaptor.js";
3
+ export const getAdaptor = () => {
4
+ return window.skybridge.hostType === "apps-sdk"
5
+ ? AppsSdkAdaptor.getInstance()
6
+ : McpAppAdaptor.getInstance();
7
+ };
8
+ //# sourceMappingURL=get-adaptor.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,5 @@
1
+ export * from "./apps-sdk/index.js";
2
+ export { getAdaptor } from "./get-adaptor.js";
3
+ export * from "./mcp-app/index.js";
4
+ export * from "./types.js";
5
+ export { useHostContext } from "./use-host-context.js";
@@ -0,0 +1,6 @@
1
+ export * from "./apps-sdk/index.js";
2
+ export { getAdaptor } from "./get-adaptor.js";
3
+ export * from "./mcp-app/index.js";
4
+ export * from "./types.js";
5
+ export { useHostContext } from "./use-host-context.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
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"}