skybridge 0.0.0-dev.d0ea289 → 0.0.0-dev.d1820df

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 (222) hide show
  1. package/LICENSE +21 -674
  2. package/bin/run.js +9 -0
  3. package/dist/cli/use-version.d.ts +1 -0
  4. package/dist/cli/use-version.js +33 -0
  5. package/dist/cli/use-version.js.map +1 -0
  6. package/dist/commands/dev.d.ts +7 -0
  7. package/dist/commands/dev.js +30 -0
  8. package/dist/commands/dev.js.map +1 -0
  9. package/dist/server/index.d.ts +4 -0
  10. package/dist/server/index.js.map +1 -0
  11. package/dist/server/inferUtilityTypes.d.ts +64 -0
  12. package/dist/server/inferUtilityTypes.js +2 -0
  13. package/dist/server/inferUtilityTypes.js.map +1 -0
  14. package/dist/server/server.d.ts +101 -0
  15. package/dist/server/server.js +132 -0
  16. package/dist/server/server.js.map +1 -0
  17. package/dist/server/templateHelper.d.ts +18 -0
  18. package/dist/{src/server → server}/templateHelper.js +5 -12
  19. package/dist/server/templateHelper.js.map +1 -0
  20. package/dist/server/templates/development.hbs +66 -0
  21. package/dist/{src/server → server}/templates/production.hbs +3 -2
  22. package/dist/{src/server → server}/widgetsDevServer.d.ts +2 -2
  23. package/dist/{src/server → server}/widgetsDevServer.js +13 -5
  24. package/dist/server/widgetsDevServer.js.map +1 -0
  25. package/dist/test/utils.d.ts +135 -0
  26. package/dist/test/utils.js +242 -0
  27. package/dist/test/utils.js.map +1 -0
  28. package/dist/test/widget.test.js +234 -0
  29. package/dist/test/widget.test.js.map +1 -0
  30. package/dist/web/bridges/adaptors/apps-sdk-adaptor.d.ts +13 -0
  31. package/dist/web/bridges/adaptors/apps-sdk-adaptor.js +33 -0
  32. package/dist/web/bridges/adaptors/apps-sdk-adaptor.js.map +1 -0
  33. package/dist/web/bridges/adaptors/mcp-app-adaptor.d.ts +16 -0
  34. package/dist/web/bridges/adaptors/mcp-app-adaptor.js +115 -0
  35. package/dist/web/bridges/adaptors/mcp-app-adaptor.js.map +1 -0
  36. package/dist/web/bridges/apps-sdk-bridge.d.ts +10 -0
  37. package/dist/web/bridges/apps-sdk-bridge.js +46 -0
  38. package/dist/web/bridges/apps-sdk-bridge.js.map +1 -0
  39. package/dist/web/bridges/hooks/use-adaptor.d.ts +2 -0
  40. package/dist/web/bridges/hooks/use-adaptor.js +8 -0
  41. package/dist/web/bridges/hooks/use-adaptor.js.map +1 -0
  42. package/dist/web/bridges/hooks/use-apps-sdk-bridge.d.ts +2 -0
  43. package/dist/web/bridges/hooks/use-apps-sdk-bridge.js +7 -0
  44. package/dist/web/bridges/hooks/use-apps-sdk-bridge.js.map +1 -0
  45. package/dist/web/bridges/hooks/use-bridge.d.ts +2 -0
  46. package/dist/web/bridges/hooks/use-bridge.js +8 -0
  47. package/dist/web/bridges/hooks/use-bridge.js.map +1 -0
  48. package/dist/web/bridges/hooks/use-mcp-app-bridge.d.ts +5 -0
  49. package/dist/web/bridges/hooks/use-mcp-app-bridge.js +7 -0
  50. package/dist/web/bridges/hooks/use-mcp-app-bridge.js.map +1 -0
  51. package/dist/web/bridges/hooks/use-mcp-app-bridge.test.js +62 -0
  52. package/dist/web/bridges/hooks/use-mcp-app-bridge.test.js.map +1 -0
  53. package/dist/web/bridges/index.d.ts +4 -0
  54. package/dist/web/bridges/index.js +5 -0
  55. package/dist/web/bridges/index.js.map +1 -0
  56. package/dist/web/bridges/mcp-app-bridge.d.ts +46 -0
  57. package/dist/web/bridges/mcp-app-bridge.js +217 -0
  58. package/dist/web/bridges/mcp-app-bridge.js.map +1 -0
  59. package/dist/web/bridges/types.d.ts +57 -0
  60. package/dist/web/bridges/types.js +2 -0
  61. package/dist/web/bridges/types.js.map +1 -0
  62. package/dist/web/create-store.d.ts +3 -0
  63. package/dist/web/create-store.js +25 -0
  64. package/dist/web/create-store.js.map +1 -0
  65. package/dist/web/create-store.test.d.ts +1 -0
  66. package/dist/web/create-store.test.js +70 -0
  67. package/dist/web/create-store.test.js.map +1 -0
  68. package/dist/web/data-llm.d.ts +14 -0
  69. package/dist/web/data-llm.js +70 -0
  70. package/dist/web/data-llm.js.map +1 -0
  71. package/dist/web/data-llm.test.d.ts +1 -0
  72. package/dist/web/data-llm.test.js +76 -0
  73. package/dist/web/data-llm.test.js.map +1 -0
  74. package/dist/web/generate-helpers.d.ts +115 -0
  75. package/dist/web/generate-helpers.js +111 -0
  76. package/dist/web/generate-helpers.js.map +1 -0
  77. package/dist/web/generate-helpers.test-d.d.ts +1 -0
  78. package/dist/web/generate-helpers.test-d.js +209 -0
  79. package/dist/web/generate-helpers.test-d.js.map +1 -0
  80. package/dist/web/generate-helpers.test.d.ts +1 -0
  81. package/dist/web/generate-helpers.test.js +17 -0
  82. package/dist/web/generate-helpers.test.js.map +1 -0
  83. package/dist/web/helpers/state.d.ts +7 -0
  84. package/dist/web/helpers/state.js +40 -0
  85. package/dist/web/helpers/state.js.map +1 -0
  86. package/dist/web/helpers/state.test.d.ts +1 -0
  87. package/dist/web/helpers/state.test.js +53 -0
  88. package/dist/web/helpers/state.test.js.map +1 -0
  89. package/dist/web/hooks/index.d.ts +11 -0
  90. package/dist/web/hooks/index.js +12 -0
  91. package/dist/web/hooks/index.js.map +1 -0
  92. package/dist/web/hooks/test/utils.d.ts +10 -0
  93. package/dist/web/hooks/test/utils.js +40 -0
  94. package/dist/web/hooks/test/utils.js.map +1 -0
  95. package/dist/web/hooks/use-call-tool.d.ts +100 -0
  96. package/dist/web/hooks/use-call-tool.js +68 -0
  97. package/dist/web/hooks/use-call-tool.js.map +1 -0
  98. package/dist/web/hooks/use-call-tool.test-d.d.ts +1 -0
  99. package/dist/web/hooks/use-call-tool.test-d.js +104 -0
  100. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  101. package/dist/web/hooks/use-call-tool.test.d.ts +1 -0
  102. package/dist/web/hooks/use-call-tool.test.js +190 -0
  103. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  104. package/dist/web/hooks/use-display-mode.d.ts +4 -0
  105. package/dist/web/hooks/use-display-mode.js +10 -0
  106. package/dist/web/hooks/use-display-mode.js.map +1 -0
  107. package/dist/web/hooks/use-display-mode.test.d.ts +1 -0
  108. package/dist/web/hooks/use-display-mode.test.js +41 -0
  109. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  110. package/dist/web/hooks/use-files.d.ts +10 -0
  111. package/dist/web/hooks/use-files.js +7 -0
  112. package/dist/web/hooks/use-files.js.map +1 -0
  113. package/dist/web/hooks/use-files.test.d.ts +1 -0
  114. package/dist/web/hooks/use-files.test.js +29 -0
  115. package/dist/web/hooks/use-files.test.js.map +1 -0
  116. package/dist/web/hooks/use-layout.d.ts +22 -0
  117. package/dist/web/hooks/use-layout.js +23 -0
  118. package/dist/web/hooks/use-layout.js.map +1 -0
  119. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  120. package/dist/web/hooks/use-layout.test.js +95 -0
  121. package/dist/web/hooks/use-layout.test.js.map +1 -0
  122. package/dist/web/hooks/use-open-external.d.ts +1 -0
  123. package/dist/web/hooks/use-open-external.js +8 -0
  124. package/dist/web/hooks/use-open-external.js.map +1 -0
  125. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  126. package/dist/web/hooks/use-open-external.test.js +50 -0
  127. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  128. package/dist/web/hooks/use-openai-global.d.ts +3 -0
  129. package/dist/web/hooks/use-openai-global.js +6 -0
  130. package/dist/web/hooks/use-openai-global.js.map +1 -0
  131. package/dist/web/hooks/use-request-modal.d.ts +9 -0
  132. package/dist/web/hooks/use-request-modal.js +14 -0
  133. package/dist/web/hooks/use-request-modal.js.map +1 -0
  134. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  135. package/dist/web/hooks/use-request-modal.test.js +57 -0
  136. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  137. package/dist/web/hooks/use-send-follow-up-message.d.ts +1 -0
  138. package/dist/web/hooks/use-send-follow-up-message.js +8 -0
  139. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  140. package/dist/web/hooks/use-tool-info.d.ts +36 -0
  141. package/dist/web/hooks/use-tool-info.js +26 -0
  142. package/dist/web/hooks/use-tool-info.js.map +1 -0
  143. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  144. package/dist/web/hooks/use-tool-info.test-d.js +109 -0
  145. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  146. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  147. package/dist/web/hooks/use-tool-info.test.js +130 -0
  148. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  149. package/dist/web/hooks/use-user.d.ts +18 -0
  150. package/dist/web/hooks/use-user.js +19 -0
  151. package/dist/web/hooks/use-user.js.map +1 -0
  152. package/dist/web/hooks/use-user.test.d.ts +1 -0
  153. package/dist/web/hooks/use-user.test.js +93 -0
  154. package/dist/web/hooks/use-user.test.js.map +1 -0
  155. package/dist/web/hooks/use-widget-state.d.ts +4 -0
  156. package/dist/web/hooks/use-widget-state.js +32 -0
  157. package/dist/web/hooks/use-widget-state.js.map +1 -0
  158. package/dist/web/hooks/use-widget-state.test.d.ts +1 -0
  159. package/dist/web/hooks/use-widget-state.test.js +61 -0
  160. package/dist/web/hooks/use-widget-state.test.js.map +1 -0
  161. package/dist/web/index.d.ts +8 -0
  162. package/dist/web/index.js +9 -0
  163. package/dist/web/index.js.map +1 -0
  164. package/dist/{src/web → web}/mount-widget.js +5 -0
  165. package/dist/web/mount-widget.js.map +1 -0
  166. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  167. package/dist/web/plugin/data-llm.test.js +81 -0
  168. package/dist/web/plugin/data-llm.test.js.map +1 -0
  169. package/dist/web/plugin/plugin.js +39 -0
  170. package/dist/web/plugin/plugin.js.map +1 -0
  171. package/dist/web/plugin/transform-data-llm.d.ts +12 -0
  172. package/dist/web/plugin/transform-data-llm.js +96 -0
  173. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  174. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  175. package/dist/web/plugin/transform-data-llm.test.js +81 -0
  176. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  177. package/dist/web/proxy.d.ts +1 -0
  178. package/dist/web/proxy.js +53 -0
  179. package/dist/web/proxy.js.map +1 -0
  180. package/dist/web/types.d.ts +149 -0
  181. package/dist/{src/web → web}/types.js +1 -0
  182. package/dist/web/types.js.map +1 -0
  183. package/package.json +55 -24
  184. package/README.md +0 -126
  185. package/dist/src/server/index.d.ts +0 -2
  186. package/dist/src/server/index.js.map +0 -1
  187. package/dist/src/server/server.d.ts +0 -13
  188. package/dist/src/server/server.js +0 -56
  189. package/dist/src/server/server.js.map +0 -1
  190. package/dist/src/server/templateHelper.d.ts +0 -14
  191. package/dist/src/server/templateHelper.js.map +0 -1
  192. package/dist/src/server/templates/development.hbs +0 -12
  193. package/dist/src/server/widgetsDevServer.js.map +0 -1
  194. package/dist/src/test/setup.js +0 -9
  195. package/dist/src/test/setup.js.map +0 -1
  196. package/dist/src/test/utils.d.ts +0 -28
  197. package/dist/src/test/utils.js +0 -43
  198. package/dist/src/test/utils.js.map +0 -1
  199. package/dist/src/test/widget.test.js +0 -69
  200. package/dist/src/test/widget.test.js.map +0 -1
  201. package/dist/src/web/index.d.ts +0 -5
  202. package/dist/src/web/index.js +0 -6
  203. package/dist/src/web/index.js.map +0 -1
  204. package/dist/src/web/mount-widget.js.map +0 -1
  205. package/dist/src/web/plugin.js +0 -28
  206. package/dist/src/web/plugin.js.map +0 -1
  207. package/dist/src/web/types.d.ts +0 -95
  208. package/dist/src/web/types.js.map +0 -1
  209. package/dist/src/web/use-openai-global.d.ts +0 -2
  210. package/dist/src/web/use-openai-global.js +0 -21
  211. package/dist/src/web/use-openai-global.js.map +0 -1
  212. package/dist/src/web/use-tool-output.d.ts +0 -3
  213. package/dist/src/web/use-tool-output.js +0 -5
  214. package/dist/src/web/use-tool-output.js.map +0 -1
  215. package/dist/vitest.config.d.ts +0 -2
  216. package/dist/vitest.config.js +0 -9
  217. package/dist/vitest.config.js.map +0 -1
  218. /package/dist/{src/server → server}/index.js +0 -0
  219. /package/dist/{src/test → test}/widget.test.d.ts +0 -0
  220. /package/dist/{src/test/setup.d.ts → web/bridges/hooks/use-mcp-app-bridge.test.d.ts} +0 -0
  221. /package/dist/{src/web → web}/mount-widget.d.ts +0 -0
  222. /package/dist/{src/web → web/plugin}/plugin.d.ts +0 -0
@@ -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,115 @@
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(["viewport"], ({ viewport }) => viewport?.maxHeight ?? window.innerHeight),
83
+ userAgent: this.createExternalStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
84
+ device: {
85
+ type: platform === "web" ? "desktop" : (platform ?? "unknown"),
86
+ },
87
+ capabilities: {
88
+ hover: true,
89
+ touch: true,
90
+ ...deviceCapabilities,
91
+ },
92
+ })),
93
+ toolInput: this.createExternalStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
94
+ toolOutput: this.createExternalStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
95
+ toolResponseMetadata: this.createExternalStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
96
+ };
97
+ }
98
+ createExternalStore(keys, computeSnapshot) {
99
+ const bridge = McpAppBridge.getInstance();
100
+ let cachedValue;
101
+ return {
102
+ subscribe: bridge.subscribe(keys),
103
+ getSnapshot: () => {
104
+ const context = Object.fromEntries(keys.map((k) => [k, bridge.getSnapshot(k)]));
105
+ const newValue = computeSnapshot(context);
106
+ if (cachedValue !== undefined && dequal(cachedValue, newValue)) {
107
+ return cachedValue;
108
+ }
109
+ cachedValue = newValue;
110
+ return newValue;
111
+ },
112
+ };
113
+ }
114
+ }
115
+ //# 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"}
@@ -0,0 +1,62 @@
1
+ import { act, renderHook, waitFor } from "@testing-library/react";
2
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
3
+ import { getMcpAppHostPostMessageMock } from "../../hooks/test/utils.js";
4
+ import { McpAppBridge } from "../mcp-app-bridge.js";
5
+ import { useMcpAppBridge } from "./use-mcp-app-bridge.js";
6
+ class MockResizeObserver {
7
+ observe = vi.fn();
8
+ unobserve = vi.fn();
9
+ disconnect = vi.fn();
10
+ }
11
+ describe("useMcpAppBridge", () => {
12
+ beforeEach(async () => {
13
+ vi.stubGlobal("skybridge", { hostType: "mcp-app" });
14
+ vi.stubGlobal("ResizeObserver", MockResizeObserver);
15
+ McpAppBridge.resetInstance();
16
+ });
17
+ afterEach(() => {
18
+ vi.unstubAllGlobals();
19
+ vi.clearAllMocks();
20
+ });
21
+ it("should return the theme value from host context and update on notification", async () => {
22
+ vi.stubGlobal("parent", {
23
+ postMessage: getMcpAppHostPostMessageMock({ theme: "light" }),
24
+ });
25
+ const { result } = renderHook(() => useMcpAppBridge("theme"));
26
+ await waitFor(() => {
27
+ expect(result.current).toBe("light");
28
+ });
29
+ });
30
+ it("should reject the request after timeout", async () => {
31
+ vi.useFakeTimers();
32
+ const consoleErrorSpy = vi
33
+ .spyOn(console, "error")
34
+ .mockImplementation(() => { });
35
+ const nonRespondingMock = vi.fn();
36
+ vi.stubGlobal("parent", { postMessage: nonRespondingMock });
37
+ renderHook(() => useMcpAppBridge("theme", undefined, 100));
38
+ expect(nonRespondingMock).toHaveBeenCalledWith(expect.objectContaining({ method: "ui/initialize" }), "*");
39
+ await act(async () => {
40
+ await vi.advanceTimersByTimeAsync(100);
41
+ });
42
+ expect(consoleErrorSpy).toHaveBeenCalledWith(new Error("Request timed out"));
43
+ consoleErrorSpy.mockRestore();
44
+ vi.useRealTimers();
45
+ });
46
+ it("should send size-changed notification after successful initialization", async () => {
47
+ const postMessageMock = getMcpAppHostPostMessageMock({ theme: "light" });
48
+ vi.stubGlobal("parent", { postMessage: postMessageMock });
49
+ renderHook(() => useMcpAppBridge("theme"));
50
+ await waitFor(() => {
51
+ expect(postMessageMock).toHaveBeenCalledWith(expect.objectContaining({
52
+ jsonrpc: "2.0",
53
+ method: "ui/notifications/size-changed",
54
+ params: expect.objectContaining({
55
+ width: expect.any(Number),
56
+ height: expect.any(Number),
57
+ }),
58
+ }), "*");
59
+ });
60
+ });
61
+ });
62
+ //# sourceMappingURL=use-mcp-app-bridge.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-mcp-app-bridge.test.js","sourceRoot":"","sources":["../../../../src/web/bridges/hooks/use-mcp-app-bridge.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export { useAdaptor } from "./hooks/use-adaptor.js";
2
+ export { useAppsSdkBridge } from "./hooks/use-apps-sdk-bridge.js";
3
+ export { useBridge } from "./hooks/use-bridge.js";
4
+ export { useMcpAppBridge } from "./hooks/use-mcp-app-bridge.js";
@@ -0,0 +1,5 @@
1
+ export { useAdaptor } from "./hooks/use-adaptor.js";
2
+ export { useAppsSdkBridge } from "./hooks/use-apps-sdk-bridge.js";
3
+ export { useBridge } from "./hooks/use-bridge.js";
4
+ export { useMcpAppBridge } from "./hooks/use-mcp-app-bridge.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/bridges/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}
@@ -0,0 +1,46 @@
1
+ import type { McpUiHostContext, McpUiInitializeRequest, McpUiToolCancelledNotification, McpUiToolInputNotification, McpUiToolResultNotification } from "@modelcontextprotocol/ext-apps";
2
+ import type { Bridge, Subscribe } from "./types.js";
3
+ type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
4
+ export type McpToolState = {
5
+ toolInput: NonNullable<McpUiToolInputNotification["params"]["arguments"]> | null;
6
+ toolResult: McpUiToolResultNotification["params"] | null;
7
+ toolCancelled: McpUiToolCancelledNotification["params"] | null;
8
+ };
9
+ export type McpAppBridgeContext = McpUiHostContext & McpToolState;
10
+ export type McpAppBridgeKey = keyof McpAppBridgeContext;
11
+ export declare class McpAppBridge implements Bridge<McpUiHostContext> {
12
+ private static instance;
13
+ context: McpAppBridgeContext;
14
+ private listeners;
15
+ private pendingRequests;
16
+ private nextId;
17
+ private initialized;
18
+ private appInitializationOptions;
19
+ private requestTimeout;
20
+ private cleanupSizeObserver;
21
+ constructor(options: McpAppInitializationOptions, requestTimeout?: number);
22
+ static getInstance(options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpAppBridge;
23
+ subscribe(key: McpAppBridgeKey): Subscribe;
24
+ subscribe(keys: readonly McpAppBridgeKey[]): Subscribe;
25
+ getSnapshot<K extends keyof McpAppBridgeContext>(key: K): McpAppBridgeContext[K];
26
+ cleanup: () => void;
27
+ static resetInstance(): void;
28
+ request<R extends {
29
+ method: string;
30
+ params?: unknown;
31
+ }, T>({ method, params, }: R): Promise<T>;
32
+ private emit;
33
+ private updateContext;
34
+ private init;
35
+ private handleMessage;
36
+ private connect;
37
+ private notify;
38
+ private sendSizeChanged;
39
+ /**
40
+ * Set up automatic size change notifications using ResizeObserver.
41
+ * Based on @modelcontextprotocol/ext-apps App.setupSizeChangedNotifications
42
+ * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/src/app.ts#L940-L989
43
+ */
44
+ private setupSizeChangedNotifications;
45
+ }
46
+ export {};