skybridge 0.0.0-dev.6ca41d7 → 0.0.0-dev.6d0958c

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 (182) hide show
  1. package/LICENSE +21 -674
  2. package/README.md +74 -147
  3. package/dist/src/server/devtoolsStaticServer.d.ts +15 -0
  4. package/dist/src/server/devtoolsStaticServer.js +38 -0
  5. package/dist/src/server/devtoolsStaticServer.js.map +1 -0
  6. package/dist/src/server/index.d.ts +3 -0
  7. package/dist/src/server/index.js +1 -0
  8. package/dist/src/server/index.js.map +1 -1
  9. package/dist/src/server/inferUtilityTypes.d.ts +64 -0
  10. package/dist/src/server/inferUtilityTypes.js +2 -0
  11. package/dist/src/server/inferUtilityTypes.js.map +1 -0
  12. package/dist/src/server/server.d.ts +70 -9
  13. package/dist/src/server/server.js +55 -30
  14. package/dist/src/server/server.js.map +1 -1
  15. package/dist/src/server/templateHelper.d.ts +3 -0
  16. package/dist/src/server/templateHelper.js +5 -4
  17. package/dist/src/server/templateHelper.js.map +1 -1
  18. package/dist/src/server/templates/development.hbs +3 -2
  19. package/dist/src/server/templates/production.hbs +1 -0
  20. package/dist/src/server/widgetsDevServer.js +3 -3
  21. package/dist/src/server/widgetsDevServer.js.map +1 -1
  22. package/dist/src/test/utils.d.ts +108 -1
  23. package/dist/src/test/utils.js +202 -3
  24. package/dist/src/test/utils.js.map +1 -1
  25. package/dist/src/test/widget.test.js +83 -27
  26. package/dist/src/test/widget.test.js.map +1 -1
  27. package/dist/src/web/bridges/apps-sdk-bridge.d.ts +14 -0
  28. package/dist/src/web/bridges/apps-sdk-bridge.js +44 -0
  29. package/dist/src/web/bridges/apps-sdk-bridge.js.map +1 -0
  30. package/dist/src/web/bridges/get-bridge-methods.d.ts +2 -0
  31. package/dist/src/web/bridges/get-bridge-methods.js +11 -0
  32. package/dist/src/web/bridges/get-bridge-methods.js.map +1 -0
  33. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.d.ts +2 -0
  34. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js +7 -0
  35. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js.map +1 -0
  36. package/dist/src/web/bridges/hooks/use-bridge.d.ts +3 -0
  37. package/dist/src/web/bridges/hooks/use-bridge.js +28 -0
  38. package/dist/src/web/bridges/hooks/use-bridge.js.map +1 -0
  39. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.d.ts +4 -0
  40. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js +7 -0
  41. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js.map +1 -0
  42. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js +58 -0
  43. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js.map +1 -0
  44. package/dist/src/web/bridges/index.d.ts +3 -0
  45. package/dist/src/web/bridges/index.js +4 -0
  46. package/dist/src/web/bridges/index.js.map +1 -0
  47. package/dist/src/web/bridges/mcp-app-bridge.d.ts +30 -0
  48. package/dist/src/web/bridges/mcp-app-bridge.js +136 -0
  49. package/dist/src/web/bridges/mcp-app-bridge.js.map +1 -0
  50. package/dist/src/web/bridges/types.d.ts +8 -0
  51. package/dist/src/web/bridges/types.js +2 -0
  52. package/dist/src/web/bridges/types.js.map +1 -0
  53. package/dist/src/web/create-store.d.ts +3 -0
  54. package/dist/src/web/create-store.js +25 -0
  55. package/dist/src/web/create-store.js.map +1 -0
  56. package/dist/src/web/create-store.test.js +70 -0
  57. package/dist/src/web/create-store.test.js.map +1 -0
  58. package/dist/src/web/data-llm.d.ts +14 -0
  59. package/dist/src/web/data-llm.js +68 -0
  60. package/dist/src/web/data-llm.js.map +1 -0
  61. package/dist/src/web/data-llm.test.js +76 -0
  62. package/dist/src/web/data-llm.test.js.map +1 -0
  63. package/dist/src/web/generate-helpers.d.ts +115 -0
  64. package/dist/src/web/generate-helpers.js +111 -0
  65. package/dist/src/web/generate-helpers.js.map +1 -0
  66. package/dist/src/web/generate-helpers.test-d.d.ts +1 -0
  67. package/dist/src/web/generate-helpers.test-d.js +206 -0
  68. package/dist/src/web/generate-helpers.test-d.js.map +1 -0
  69. package/dist/src/web/generate-helpers.test.d.ts +1 -0
  70. package/dist/src/web/generate-helpers.test.js +17 -0
  71. package/dist/src/web/generate-helpers.test.js.map +1 -0
  72. package/dist/src/web/helpers/state.d.ts +7 -0
  73. package/dist/src/web/helpers/state.js +40 -0
  74. package/dist/src/web/helpers/state.js.map +1 -0
  75. package/dist/src/web/helpers/state.test.d.ts +1 -0
  76. package/dist/src/web/helpers/state.test.js +53 -0
  77. package/dist/src/web/helpers/state.test.js.map +1 -0
  78. package/dist/src/web/hooks/index.d.ts +4 -6
  79. package/dist/src/web/hooks/index.js +4 -6
  80. package/dist/src/web/hooks/index.js.map +1 -1
  81. package/dist/src/web/hooks/use-call-tool.d.ts +59 -21
  82. package/dist/src/web/hooks/use-call-tool.js +14 -20
  83. package/dist/src/web/hooks/use-call-tool.js.map +1 -1
  84. package/dist/src/web/hooks/use-call-tool.test-d.d.ts +1 -0
  85. package/dist/src/web/hooks/use-call-tool.test-d.js +104 -0
  86. package/dist/src/web/hooks/use-call-tool.test-d.js.map +1 -0
  87. package/dist/src/web/hooks/use-call-tool.test.js +14 -12
  88. package/dist/src/web/hooks/use-call-tool.test.js.map +1 -1
  89. package/dist/src/web/hooks/use-display-mode.d.ts +2 -2
  90. package/dist/src/web/hooks/use-display-mode.js +6 -3
  91. package/dist/src/web/hooks/use-display-mode.js.map +1 -1
  92. package/dist/src/web/hooks/use-display-mode.test.js +3 -2
  93. package/dist/src/web/hooks/use-display-mode.test.js.map +1 -1
  94. package/dist/src/web/hooks/use-files.d.ts +10 -0
  95. package/dist/src/web/hooks/use-files.js +7 -0
  96. package/dist/src/web/hooks/use-files.js.map +1 -0
  97. package/dist/src/web/hooks/use-files.test.d.ts +1 -0
  98. package/dist/src/web/hooks/use-files.test.js +29 -0
  99. package/dist/src/web/hooks/use-files.test.js.map +1 -0
  100. package/dist/src/web/hooks/use-layout.d.ts +22 -0
  101. package/dist/src/web/hooks/use-layout.js +23 -0
  102. package/dist/src/web/hooks/use-layout.js.map +1 -0
  103. package/dist/src/web/hooks/use-layout.test.d.ts +1 -0
  104. package/dist/src/web/hooks/use-layout.test.js +46 -0
  105. package/dist/src/web/hooks/use-layout.test.js.map +1 -0
  106. package/dist/src/web/hooks/use-open-external.test.js +2 -2
  107. package/dist/src/web/hooks/use-open-external.test.js.map +1 -1
  108. package/dist/src/web/hooks/use-openai-global.d.ts +3 -2
  109. package/dist/src/web/hooks/use-openai-global.js +3 -20
  110. package/dist/src/web/hooks/use-openai-global.js.map +1 -1
  111. package/dist/src/web/hooks/use-request-modal.d.ts +3 -2
  112. package/dist/src/web/hooks/use-request-modal.js.map +1 -1
  113. package/dist/src/web/hooks/use-request-modal.test.js +2 -2
  114. package/dist/src/web/hooks/use-request-modal.test.js.map +1 -1
  115. package/dist/src/web/hooks/use-tool-info.d.ts +5 -3
  116. package/dist/src/web/hooks/use-tool-info.js +5 -7
  117. package/dist/src/web/hooks/use-tool-info.js.map +1 -1
  118. package/dist/src/web/hooks/use-tool-info.test-d.d.ts +1 -0
  119. package/dist/src/web/hooks/use-tool-info.test-d.js +73 -0
  120. package/dist/src/web/hooks/use-tool-info.test-d.js.map +1 -0
  121. package/dist/src/web/hooks/use-tool-info.test.js +4 -77
  122. package/dist/src/web/hooks/use-tool-info.test.js.map +1 -1
  123. package/dist/src/web/hooks/use-user.d.ts +18 -0
  124. package/dist/src/web/hooks/use-user.js +19 -0
  125. package/dist/src/web/hooks/use-user.js.map +1 -0
  126. package/dist/src/web/hooks/use-user.test.d.ts +1 -0
  127. package/dist/src/web/hooks/use-user.test.js +44 -0
  128. package/dist/src/web/hooks/use-user.test.js.map +1 -0
  129. package/dist/src/web/hooks/use-widget-state.js +11 -9
  130. package/dist/src/web/hooks/use-widget-state.js.map +1 -1
  131. package/dist/src/web/hooks/use-widget-state.test.js +3 -2
  132. package/dist/src/web/hooks/use-widget-state.test.js.map +1 -1
  133. package/dist/src/web/index.d.ts +7 -3
  134. package/dist/src/web/index.js +7 -3
  135. package/dist/src/web/index.js.map +1 -1
  136. package/dist/src/web/mount-widget.js +5 -0
  137. package/dist/src/web/mount-widget.js.map +1 -1
  138. package/dist/src/web/plugin/data-llm.test.d.ts +1 -0
  139. package/dist/src/web/plugin/data-llm.test.js +81 -0
  140. package/dist/src/web/plugin/data-llm.test.js.map +1 -0
  141. package/dist/src/web/plugin/plugin.js +39 -0
  142. package/dist/src/web/plugin/plugin.js.map +1 -0
  143. package/dist/src/web/plugin/transform-data-llm.d.ts +12 -0
  144. package/dist/src/web/plugin/transform-data-llm.js +93 -0
  145. package/dist/src/web/plugin/transform-data-llm.js.map +1 -0
  146. package/dist/src/web/plugin/transform-data-llm.test.d.ts +1 -0
  147. package/dist/src/web/plugin/transform-data-llm.test.js +81 -0
  148. package/dist/src/web/plugin/transform-data-llm.test.js.map +1 -0
  149. package/dist/src/web/proxy.d.ts +1 -0
  150. package/dist/src/web/proxy.js +53 -0
  151. package/dist/src/web/proxy.js.map +1 -0
  152. package/dist/src/web/types.d.ts +51 -22
  153. package/dist/src/web/types.js +1 -0
  154. package/dist/src/web/types.js.map +1 -1
  155. package/package.json +15 -6
  156. package/dist/src/web/hooks/use-locale.d.ts +0 -1
  157. package/dist/src/web/hooks/use-locale.js +0 -5
  158. package/dist/src/web/hooks/use-locale.js.map +0 -1
  159. package/dist/src/web/hooks/use-locale.test.js +0 -21
  160. package/dist/src/web/hooks/use-locale.test.js.map +0 -1
  161. package/dist/src/web/hooks/use-theme.d.ts +0 -1
  162. package/dist/src/web/hooks/use-theme.js +0 -5
  163. package/dist/src/web/hooks/use-theme.js.map +0 -1
  164. package/dist/src/web/hooks/use-theme.test.js +0 -26
  165. package/dist/src/web/hooks/use-theme.test.js.map +0 -1
  166. package/dist/src/web/hooks/use-tool-output.d.ts +0 -4
  167. package/dist/src/web/hooks/use-tool-output.js +0 -9
  168. package/dist/src/web/hooks/use-tool-output.js.map +0 -1
  169. package/dist/src/web/hooks/use-tool-response-metadata.d.ts +0 -4
  170. package/dist/src/web/hooks/use-tool-response-metadata.js +0 -8
  171. package/dist/src/web/hooks/use-tool-response-metadata.js.map +0 -1
  172. package/dist/src/web/hooks/use-user-agent.d.ts +0 -1
  173. package/dist/src/web/hooks/use-user-agent.js +0 -5
  174. package/dist/src/web/hooks/use-user-agent.js.map +0 -1
  175. package/dist/src/web/hooks/use-user-agent.test.js +0 -31
  176. package/dist/src/web/hooks/use-user-agent.test.js.map +0 -1
  177. package/dist/src/web/plugin.js +0 -28
  178. package/dist/src/web/plugin.js.map +0 -1
  179. /package/dist/src/web/{hooks/use-locale.test.d.ts → bridges/hooks/use-mcp-app-bridge.test.d.ts} +0 -0
  180. /package/dist/src/web/{hooks/use-theme.test.d.ts → create-store.test.d.ts} +0 -0
  181. /package/dist/src/web/{hooks/use-user-agent.test.d.ts → data-llm.test.d.ts} +0 -0
  182. /package/dist/src/web/{plugin.d.ts → plugin/plugin.d.ts} +0 -0
@@ -0,0 +1,14 @@
1
+ import { type DisplayMode, type OpenAiProperties } from "../types.js";
2
+ import type { IBridge } from "./types.js";
3
+ export declare class AppsSdkBridge implements IBridge {
4
+ private static instance;
5
+ static getInstance(): AppsSdkBridge;
6
+ static resetInstance(): void;
7
+ subscribe: (key: keyof OpenAiProperties) => (onChange: () => void) => () => void;
8
+ 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];
9
+ requestDisplayMode: ({ mode }: {
10
+ mode: DisplayMode;
11
+ }) => Promise<{
12
+ mode: DisplayMode;
13
+ }>;
14
+ }
@@ -0,0 +1,44 @@
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 = (key) => (onChange) => {
20
+ const handleSetGlobal = (event) => {
21
+ const value = event.detail.globals[key];
22
+ if (value === undefined) {
23
+ return;
24
+ }
25
+ onChange();
26
+ };
27
+ window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {
28
+ passive: true,
29
+ });
30
+ return () => {
31
+ window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);
32
+ };
33
+ };
34
+ getSnapshot = (key) => {
35
+ if (window.openai === undefined) {
36
+ throw new Error(`window.openai is not available. Make sure you're calling the hook requiring ${key} within the OpenAI iFrame skybridge runtime.`);
37
+ }
38
+ return window.openai[key];
39
+ };
40
+ requestDisplayMode = ({ mode }) => {
41
+ return window.openai.requestDisplayMode({ mode });
42
+ };
43
+ }
44
+ //# 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,EAGL,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;IAEM,SAAS,GACd,CAAC,GAA2B,EAAE,EAAE,CAAC,CAAC,QAAoB,EAAE,EAAE;QACxD,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;YACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO;YACT,CAAC;YAED,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;YAC/D,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;QACtE,CAAC,CAAC;IACJ,CAAC,CAAC;IACG,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;IAEK,kBAAkB,GAAG,CAAC,EAAE,IAAI,EAAyB,EAAE,EAAE;QAC9D,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { IBridge } from "./types";
2
+ export declare const getBridgeMethods: () => IBridge;
@@ -0,0 +1,11 @@
1
+ import { AppsSdkBridge } from "./apps-sdk-bridge";
2
+ import { McpAppBridge } from "./mcp-app-bridge";
3
+ export const getBridgeMethods = () => {
4
+ const bridge = window.skybridge.hostType === "apps-sdk"
5
+ ? AppsSdkBridge.getInstance()
6
+ : McpAppBridge.getInstance();
7
+ return {
8
+ requestDisplayMode: bridge.requestDisplayMode,
9
+ };
10
+ };
11
+ //# sourceMappingURL=get-bridge-methods.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-bridge-methods.js","sourceRoot":"","sources":["../../../../src/web/bridges/get-bridge-methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,MAAM,MAAM,GACV,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;QACtC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE;QAC7B,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO;QACL,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;KAC9C,CAAC;AACJ,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,3 @@
1
+ import type { McpUiHostContext } from "@modelcontextprotocol/ext-apps";
2
+ export type BridgeInterface = Required<Pick<McpUiHostContext, "theme" | "locale" | "displayMode">>;
3
+ export declare const useBridge: <K extends keyof BridgeInterface>(key: K, defaultValue?: BridgeInterface[K]) => BridgeInterface[K];
@@ -0,0 +1,28 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { AppsSdkBridge } from "../apps-sdk-bridge";
3
+ import { McpAppBridge } from "../mcp-app-bridge";
4
+ const DEFAULT_VALUE_FOR_MCP_APP_BRIDGE = {
5
+ theme: "light",
6
+ locale: "en-US",
7
+ displayMode: "inline",
8
+ };
9
+ const getExternalStore = (key, defaultValue = DEFAULT_VALUE_FOR_MCP_APP_BRIDGE[key]) => {
10
+ const hostType = window.skybridge.hostType;
11
+ if (hostType === "apps-sdk") {
12
+ const bridge = AppsSdkBridge.getInstance();
13
+ return {
14
+ subscribe: bridge.subscribe(key),
15
+ getSnapshot: () => bridge.getSnapshot(key),
16
+ };
17
+ }
18
+ const bridge = McpAppBridge.getInstance();
19
+ return {
20
+ subscribe: bridge.subscribe(key),
21
+ getSnapshot: () => (bridge.getSnapshot(key) ?? defaultValue),
22
+ };
23
+ };
24
+ export const useBridge = (key, defaultValue = DEFAULT_VALUE_FOR_MCP_APP_BRIDGE[key]) => {
25
+ const externalStore = getExternalStore(key, defaultValue);
26
+ return useSyncExternalStore(externalStore.subscribe, externalStore.getSnapshot, () => DEFAULT_VALUE_FOR_MCP_APP_BRIDGE[key]);
27
+ };
28
+ //# 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":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWjD,MAAM,gCAAgC,GAAoB;IACxD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,GAAM,EACN,eAAmC,gCAAgC,CAAC,GAAG,CAAC,EAChD,EAAE;IAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IAC3C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,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,CAAuB;SACjE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE,CAChB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,YAAY,CAAuB;KAClE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,GAAM,EACN,eAAmC,gCAAgC,CAAC,GAAG,CAAC,EACpD,EAAE;IACtB,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE1D,OAAO,oBAAoB,CACzB,aAAa,CAAC,SAAS,EACvB,aAAa,CAAC,WAAW,EACzB,GAAG,EAAE,CAAC,gCAAgC,CAAC,GAAG,CAAC,CAC5C,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { McpUiHostContext, McpUiInitializeRequest } from "@modelcontextprotocol/ext-apps";
2
+ type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
3
+ export declare function useMcpAppBridge<K extends keyof McpUiHostContext>(key: K, options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpUiHostContext[K];
4
+ export {};
@@ -0,0 +1,7 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { McpAppBridge } from "../mcp-app-bridge";
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":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD,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,58 @@
1
+ import { act, renderHook, waitFor } from "@testing-library/react";
2
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
3
+ import { McpAppBridge } from "../mcp-app-bridge.js";
4
+ import { useMcpAppBridge } from "./use-mcp-app-bridge.js";
5
+ describe("useMcpAppBridge", () => {
6
+ let mockPostMessage;
7
+ beforeEach(async () => {
8
+ mockPostMessage = vi.fn();
9
+ Object.defineProperty(window, "parent", {
10
+ value: { postMessage: mockPostMessage },
11
+ writable: true,
12
+ configurable: true,
13
+ });
14
+ vi.stubGlobal("skybridge", { hostType: "mcp-app" });
15
+ McpAppBridge.resetInstance();
16
+ });
17
+ afterEach(() => {
18
+ vi.clearAllMocks();
19
+ });
20
+ it("should return the theme value from host context", async () => {
21
+ const { result } = renderHook(() => useMcpAppBridge("theme"));
22
+ const initCall = mockPostMessage.mock.calls.find((call) => call[0].method === "ui/initialize");
23
+ if (initCall) {
24
+ act(() => {
25
+ window.dispatchEvent(new MessageEvent("message", {
26
+ data: {
27
+ jsonrpc: "2.0",
28
+ id: initCall[0].id,
29
+ result: {
30
+ protocolVersion: "2025-06-18",
31
+ hostInfo: { name: "test-host", version: "1.0.0" },
32
+ hostCapabilities: {},
33
+ hostContext: { theme: "light" },
34
+ },
35
+ },
36
+ }));
37
+ });
38
+ }
39
+ await waitFor(() => {
40
+ expect(result.current).toBe("light");
41
+ });
42
+ });
43
+ it("should reject the request after timeout", async () => {
44
+ vi.useFakeTimers();
45
+ const consoleErrorSpy = vi
46
+ .spyOn(console, "error")
47
+ .mockImplementation(() => { });
48
+ renderHook(() => useMcpAppBridge("theme", undefined, 100));
49
+ expect(mockPostMessage).toHaveBeenCalledWith(expect.objectContaining({ method: "ui/initialize" }), "*");
50
+ await act(async () => {
51
+ await vi.advanceTimersByTimeAsync(100);
52
+ });
53
+ expect(consoleErrorSpy).toHaveBeenCalledWith(new Error("Request timed out"));
54
+ consoleErrorSpy.mockRestore();
55
+ vi.useRealTimers();
56
+ });
57
+ });
58
+ //# 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":"AAAA,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,eAAyC,CAAC;IAE9C,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,eAAe,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE;YACtC,KAAK,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE;YACvC,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,YAAY,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAC9C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,eAAe,CAC7C,CAAC;QAEF,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,GAAG,EAAE;gBACP,MAAM,CAAC,aAAa,CAClB,IAAI,YAAY,CAAC,SAAS,EAAE;oBAC1B,IAAI,EAAE;wBACJ,OAAO,EAAE,KAAK;wBACd,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;wBAClB,MAAM,EAAE;4BACN,eAAe,EAAE,YAAY;4BAC7B,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE;4BACjD,gBAAgB,EAAE,EAAE;4BACpB,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;yBAChC;qBACF;iBACF,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,eAAe,GAAG,EAAE;aACvB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;aACvB,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEhC,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QAE3D,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAC1C,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EACpD,GAAG,CACJ,CAAC;QAEF,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,MAAM,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAC1C,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAC/B,CAAC;QAEF,eAAe,CAAC,WAAW,EAAE,CAAC;QAC9B,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { useAppsSdkBridge } from "./hooks/use-apps-sdk-bridge.js";
2
+ export { useBridge } from "./hooks/use-bridge.js";
3
+ export { useMcpAppBridge } from "./hooks/use-mcp-app-bridge.js";
@@ -0,0 +1,4 @@
1
+ export { useAppsSdkBridge } from "./hooks/use-apps-sdk-bridge.js";
2
+ export { useBridge } from "./hooks/use-bridge.js";
3
+ export { useMcpAppBridge } from "./hooks/use-mcp-app-bridge.js";
4
+ //# 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,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,30 @@
1
+ import type { McpUiDisplayMode, McpUiHostContext, McpUiInitializeRequest, McpUiRequestDisplayModeResult } from "@modelcontextprotocol/ext-apps";
2
+ import type { IBridge } from "./types";
3
+ type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
4
+ export declare class McpAppBridge implements IBridge {
5
+ private static instance;
6
+ context: McpUiHostContext | null;
7
+ private listeners;
8
+ private pendingRequests;
9
+ private nextId;
10
+ private initialized;
11
+ private appInitializationOptions;
12
+ private requestTimeout;
13
+ constructor(options: McpAppInitializationOptions, requestTimeout?: number);
14
+ static getInstance(options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpAppBridge;
15
+ subscribe: (key: keyof McpUiHostContext) => (onChange: () => void) => () => boolean | undefined;
16
+ getSnapshot: <K extends keyof McpUiHostContext>(key: K) => McpUiHostContext[K] | undefined;
17
+ requestDisplayMode: ({ mode }: {
18
+ mode: McpUiDisplayMode;
19
+ }) => Promise<McpUiRequestDisplayModeResult>;
20
+ cleanup: () => void;
21
+ static resetInstance(): void;
22
+ private request;
23
+ private emit;
24
+ private setContext;
25
+ private init;
26
+ private handleMessage;
27
+ private connect;
28
+ private notify;
29
+ }
30
+ export {};
@@ -0,0 +1,136 @@
1
+ const LATEST_PROTOCOL_VERSION = "2025-11-21";
2
+ export class McpAppBridge {
3
+ static instance = null;
4
+ context = null;
5
+ listeners = new Map();
6
+ pendingRequests = new Map();
7
+ nextId = 1;
8
+ initialized;
9
+ appInitializationOptions;
10
+ requestTimeout;
11
+ constructor(options, requestTimeout = 10_000) {
12
+ this.requestTimeout = requestTimeout;
13
+ this.initialized = false;
14
+ this.appInitializationOptions = {
15
+ appInfo: options.appInfo,
16
+ appCapabilities: {},
17
+ protocolVersion: LATEST_PROTOCOL_VERSION,
18
+ };
19
+ }
20
+ static getInstance(options, requestTimeout) {
21
+ if (window.skybridge.hostType !== "mcp-app") {
22
+ throw new Error("MCP App Bridge can only be used in the mcp-app runtime");
23
+ }
24
+ if (McpAppBridge.instance && (options || requestTimeout)) {
25
+ console.warn("McpAppBridge.getInstance: options and requestTimeout ignored, instance already exists");
26
+ }
27
+ if (!McpAppBridge.instance) {
28
+ const defaultOptions = {
29
+ appInfo: { name: "skybridge-app", version: "0.0.1" },
30
+ };
31
+ McpAppBridge.instance = new McpAppBridge({ ...defaultOptions, ...options }, requestTimeout);
32
+ }
33
+ return McpAppBridge.instance;
34
+ }
35
+ subscribe = (key) => (onChange) => {
36
+ this.listeners.set(key, new Set([...(this.listeners.get(key) || []), onChange]));
37
+ this.init();
38
+ return () => this.listeners.get(key)?.delete(onChange);
39
+ };
40
+ getSnapshot = (key) => {
41
+ return this.context?.[key];
42
+ };
43
+ requestDisplayMode = async ({ mode }) => {
44
+ return this.request({
45
+ method: "ui/request-display-mode",
46
+ params: { mode },
47
+ });
48
+ };
49
+ cleanup = () => {
50
+ window.removeEventListener("message", this.handleMessage);
51
+ this.pendingRequests.forEach((request) => {
52
+ clearTimeout(request.timeout);
53
+ });
54
+ this.pendingRequests.clear();
55
+ this.listeners.clear();
56
+ };
57
+ static resetInstance() {
58
+ if (McpAppBridge.instance) {
59
+ McpAppBridge.instance.cleanup();
60
+ McpAppBridge.instance = null;
61
+ }
62
+ }
63
+ request({ method, params, }) {
64
+ const id = this.nextId++;
65
+ const { promise, resolve, reject } = Promise.withResolvers();
66
+ this.pendingRequests.set(id, {
67
+ resolve: resolve,
68
+ reject,
69
+ timeout: setTimeout(() => {
70
+ reject(new Error("Request timed out"));
71
+ this.pendingRequests.delete(id);
72
+ }, this.requestTimeout),
73
+ });
74
+ window.parent.postMessage({ jsonrpc: "2.0", id, method, params }, "*");
75
+ return promise;
76
+ }
77
+ emit(key) {
78
+ this.listeners.get(key)?.forEach((listener) => {
79
+ listener();
80
+ });
81
+ }
82
+ setContext(context) {
83
+ if (context == null)
84
+ return;
85
+ this.context = context;
86
+ for (const key of Object.keys(context)) {
87
+ this.emit(key);
88
+ }
89
+ }
90
+ init() {
91
+ if (this.initialized)
92
+ return;
93
+ this.initialized = true;
94
+ if (typeof window === "undefined" || window.parent === window) {
95
+ return;
96
+ }
97
+ window.addEventListener("message", this.handleMessage);
98
+ this.connect();
99
+ }
100
+ handleMessage = (event) => {
101
+ const data = event.data;
102
+ if (data?.jsonrpc !== "2.0")
103
+ return;
104
+ const request = this.pendingRequests.get(data.id);
105
+ if (request) {
106
+ clearTimeout(request.timeout);
107
+ this.pendingRequests.delete(data.id);
108
+ if (data.error) {
109
+ request.reject(new Error(data.error.message));
110
+ return;
111
+ }
112
+ request.resolve(data.result);
113
+ return;
114
+ }
115
+ if (data.method === "ui/notifications/host-context-changed") {
116
+ this.setContext({ ...this.context, ...data.params });
117
+ }
118
+ };
119
+ async connect() {
120
+ try {
121
+ const result = await this.request({
122
+ method: "ui/initialize",
123
+ params: this.appInitializationOptions,
124
+ });
125
+ this.setContext(result.hostContext);
126
+ this.notify({ method: "ui/notifications/initialized" });
127
+ }
128
+ catch (err) {
129
+ console.error(err);
130
+ }
131
+ }
132
+ notify(notification) {
133
+ window.parent.postMessage({ jsonrpc: "2.0", ...notification }, "*");
134
+ }
135
+ }
136
+ //# sourceMappingURL=mcp-app-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-app-bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app-bridge.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { McpUiDisplayMode } from "@modelcontextprotocol/ext-apps";
2
+ export interface IBridge {
3
+ requestDisplayMode({ mode }: {
4
+ mode: McpUiDisplayMode;
5
+ }): Promise<{
6
+ mode: McpUiDisplayMode;
7
+ }>;
8
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,3 @@
1
+ import { type StateCreator } from "zustand";
2
+ import type { UnknownObject } from "./types.js";
3
+ export declare function createStore<State extends UnknownObject>(storeCreator: StateCreator<State, [], [], State>, defaultState?: State | (() => State)): import("zustand").UseBoundStore<import("zustand").StoreApi<State>>;
@@ -0,0 +1,25 @@
1
+ import { create } from "zustand";
2
+ import { getInitialState, injectWidgetContext, serializeState, } from "./helpers/state.js";
3
+ export function createStore(storeCreator, defaultState) {
4
+ const initialState = getInitialState(defaultState);
5
+ const store = create()((...args) => {
6
+ const baseStore = storeCreator(...args);
7
+ if (initialState !== null) {
8
+ return { ...baseStore, ...initialState };
9
+ }
10
+ return baseStore;
11
+ });
12
+ store.subscribe((state) => {
13
+ if (window.openai) {
14
+ const serializedState = serializeState(state);
15
+ if (serializedState !== null && serializedState !== undefined) {
16
+ const stateToPersist = injectWidgetContext(serializedState);
17
+ if (stateToPersist !== null) {
18
+ window.openai.setWidgetState(stateToPersist);
19
+ }
20
+ }
21
+ }
22
+ });
23
+ return store;
24
+ }
25
+ //# sourceMappingURL=create-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-store.js","sourceRoot":"","sources":["../../../src/web/create-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,MAAM,UAAU,WAAW,CACzB,YAAgD,EAChD,YAAoC;IAEpC,MAAM,YAAY,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,MAAM,EAAS,CAC3B,CAAC,GAAG,IAAoD,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;QAExC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,YAAY,EAAE,CAAC;QAC3C,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CACF,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,CAAC,KAAY,EAAE,EAAE;QAC/B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,eAAe,KAAK,IAAI,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC9D,MAAM,cAAc,GAAG,mBAAmB,CAAC,eAAwB,CAAC,CAAC;gBACrE,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;oBAC5B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,70 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
2
+ import { createStore } from "./create-store.js";
3
+ import { WIDGET_CONTEXT_KEY } from "./data-llm.js";
4
+ describe("createStore", () => {
5
+ let OpenaiMock;
6
+ beforeEach(() => {
7
+ OpenaiMock = {
8
+ widgetState: null,
9
+ setWidgetState: vi.fn().mockResolvedValue(undefined),
10
+ };
11
+ vi.stubGlobal("openai", OpenaiMock);
12
+ });
13
+ afterEach(() => {
14
+ vi.unstubAllGlobals();
15
+ vi.resetAllMocks();
16
+ });
17
+ it("should create a store without default state", () => {
18
+ const storeCreator = () => ({
19
+ count: 0,
20
+ });
21
+ const store = createStore(storeCreator);
22
+ expect(store.getState()).toEqual({ count: 0 });
23
+ });
24
+ it("should create a store with default state", () => {
25
+ const storeCreator = () => ({
26
+ count: 0,
27
+ name: "initial",
28
+ });
29
+ const defaultState = { count: 5, name: "default" };
30
+ const store = createStore(storeCreator, defaultState);
31
+ expect(store.getState()).toEqual({ count: 5, name: "default" });
32
+ });
33
+ it("should initialize from window.openai.widgetState when available", () => {
34
+ const storeCreator = () => ({
35
+ count: 0,
36
+ name: "initial",
37
+ });
38
+ const windowState = { count: 20, name: "window" };
39
+ OpenaiMock.widgetState = windowState;
40
+ const store = createStore(storeCreator);
41
+ expect(store.getState()).toEqual({ count: 20, name: "window" });
42
+ });
43
+ it("should persist state changes to window.openai.setWidgetState", async () => {
44
+ const storeCreator = (set) => ({
45
+ count: 0,
46
+ increment: () => set((state) => ({ count: state.count + 1 })),
47
+ });
48
+ const store = createStore(storeCreator);
49
+ store.getState().increment();
50
+ await vi.waitFor(() => {
51
+ expect(OpenaiMock.setWidgetState).toHaveBeenCalled();
52
+ });
53
+ const callArgs = OpenaiMock.setWidgetState.mock.calls[0]?.[0];
54
+ expect(callArgs).toEqual({ count: 1 });
55
+ });
56
+ it("should filter widget context from initial state", () => {
57
+ const storeCreator = () => ({
58
+ count: 0,
59
+ });
60
+ const windowState = {
61
+ count: 5,
62
+ [WIDGET_CONTEXT_KEY]: "context-value",
63
+ };
64
+ OpenaiMock.widgetState = windowState;
65
+ const store = createStore(storeCreator);
66
+ expect(store.getState()).toEqual({ count: 5 });
67
+ expect(store.getState()[WIDGET_CONTEXT_KEY]).toBeUndefined();
68
+ });
69
+ });
70
+ //# sourceMappingURL=create-store.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-store.test.js","sourceRoot":"","sources":["../../../src/web/create-store.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,MAAM,EACN,EAAE,EAEF,EAAE,GACH,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,UAGH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,WAAW,EAAE,IAAI;YACjB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SACrD,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QAErD,MAAM,YAAY,GAA+C,GAAG,EAAE,CAAC,CAAC;YACtE,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAElD,MAAM,YAAY,GAA+C,GAAG,EAAE,CAAC,CAAC;YACtE,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAEnD,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAEtD,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QAEzE,MAAM,YAAY,GAA+C,GAAG,EAAE,CAAC,CAAC;YACtE,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAClD,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QAErC,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAE5E,MAAM,YAAY,GAA+C,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACzE,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;SAC9D,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QACxC,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC;QAE7B,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACpB,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAEzD,MAAM,YAAY,GAA+C,GAAG,EAAE,CAAC,CAAC;YACtE,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QACH,MAAM,WAAW,GAAG;YAClB,KAAK,EAAE,CAAC;YACR,CAAC,kBAAkB,CAAC,EAAE,eAAe;SACtC,CAAC;QACF,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QAErC,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CACH,KAAK,CAAC,QAAQ,EAA8B,CAAC,kBAAkB,CAAC,CAClE,CAAC,aAAa,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { type ReactNode } from "react";
2
+ export type DataLLMContent = string;
3
+ export interface DataLLMNode {
4
+ id: string;
5
+ parentId: string | null;
6
+ content: string | null;
7
+ }
8
+ export declare const WIDGET_CONTEXT_KEY: "__widget_context";
9
+ interface DataLLMProps {
10
+ content: DataLLMContent | null | undefined;
11
+ children?: ReactNode;
12
+ }
13
+ export declare function DataLLM({ content, children }: DataLLMProps): import("react/jsx-runtime").JSX.Element;
14
+ export {};
@@ -0,0 +1,68 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { createContext, useContext, useEffect, useId, } from "react";
3
+ export const WIDGET_CONTEXT_KEY = "__widget_context";
4
+ const nodes = new Map();
5
+ function setNode(node) {
6
+ nodes.set(node.id, node);
7
+ onChange();
8
+ }
9
+ function removeNode(id) {
10
+ nodes.delete(id);
11
+ onChange();
12
+ }
13
+ function onChange() {
14
+ const description = getLLMDescriptionString();
15
+ window.openai.setWidgetState({
16
+ ...window.openai.widgetState,
17
+ [WIDGET_CONTEXT_KEY]: description,
18
+ });
19
+ }
20
+ const ParentIdContext = createContext(null);
21
+ export function DataLLM({ content, children }) {
22
+ const parentId = useContext(ParentIdContext);
23
+ const id = useId();
24
+ useEffect(() => {
25
+ if (content) {
26
+ setNode({
27
+ id,
28
+ parentId,
29
+ content,
30
+ });
31
+ }
32
+ else {
33
+ removeNode(id);
34
+ }
35
+ return () => {
36
+ removeNode(id);
37
+ };
38
+ }, [id, parentId, content]);
39
+ return (_jsx(ParentIdContext.Provider, { value: id, children: children }));
40
+ }
41
+ function getLLMDescriptionString() {
42
+ const byParent = new Map();
43
+ for (const node of Array.from(nodes.values())) {
44
+ const key = node.parentId ?? null;
45
+ if (!byParent.has(key))
46
+ byParent.set(key, []);
47
+ byParent.get(key)?.push(node);
48
+ }
49
+ for (const list of byParent.values()) {
50
+ list.sort((a, b) => a.id.localeCompare(b.id));
51
+ }
52
+ const lines = [];
53
+ function traverseTree(parentId, depth) {
54
+ const children = byParent.get(parentId);
55
+ if (!children)
56
+ return;
57
+ for (const child of children) {
58
+ if (child.content?.trim()) {
59
+ const indent = " ".repeat(depth);
60
+ lines.push(`${indent}- ${child.content.trim()}`);
61
+ }
62
+ traverseTree(child.id, depth + 1);
63
+ }
64
+ }
65
+ traverseTree(null, 0);
66
+ return lines.join("\n");
67
+ }
68
+ //# sourceMappingURL=data-llm.js.map