skybridge 0.0.0-dev.87acdcf → 0.0.0-dev.87c99fc

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 (199) hide show
  1. package/LICENSE +21 -674
  2. package/dist/src/server/devtoolsStaticServer.d.ts +19 -0
  3. package/dist/src/server/devtoolsStaticServer.js +48 -0
  4. package/dist/src/server/devtoolsStaticServer.js.map +1 -0
  5. package/dist/src/server/index.d.ts +3 -0
  6. package/dist/src/server/index.js +1 -0
  7. package/dist/src/server/index.js.map +1 -1
  8. package/dist/src/server/inferUtilityTypes.d.ts +64 -0
  9. package/dist/src/server/inferUtilityTypes.js +2 -0
  10. package/dist/src/server/inferUtilityTypes.js.map +1 -0
  11. package/dist/src/server/server.d.ts +70 -9
  12. package/dist/src/server/server.js +55 -30
  13. package/dist/src/server/server.js.map +1 -1
  14. package/dist/src/server/templateHelper.d.ts +3 -0
  15. package/dist/src/server/templateHelper.js +5 -4
  16. package/dist/src/server/templateHelper.js.map +1 -1
  17. package/dist/src/server/templates/development.hbs +4 -3
  18. package/dist/src/server/templates/production.hbs +1 -0
  19. package/dist/src/server/widgetsDevServer.js +2 -5
  20. package/dist/src/server/widgetsDevServer.js.map +1 -1
  21. package/dist/src/test/utils.d.ts +108 -1
  22. package/dist/src/test/utils.js +202 -3
  23. package/dist/src/test/utils.js.map +1 -1
  24. package/dist/src/test/widget.test.js +83 -27
  25. package/dist/src/test/widget.test.js.map +1 -1
  26. package/dist/src/web/bridges/adaptors/apps-sdk-adaptor.d.ts +13 -0
  27. package/dist/src/web/bridges/adaptors/apps-sdk-adaptor.js +33 -0
  28. package/dist/src/web/bridges/adaptors/apps-sdk-adaptor.js.map +1 -0
  29. package/dist/src/web/bridges/adaptors/mcp-app-adaptor.d.ts +16 -0
  30. package/dist/src/web/bridges/adaptors/mcp-app-adaptor.js +115 -0
  31. package/dist/src/web/bridges/adaptors/mcp-app-adaptor.js.map +1 -0
  32. package/dist/src/web/bridges/apps-sdk-bridge.d.ts +10 -0
  33. package/dist/src/web/bridges/apps-sdk-bridge.js +46 -0
  34. package/dist/src/web/bridges/apps-sdk-bridge.js.map +1 -0
  35. package/dist/src/web/bridges/hooks/use-adaptor.d.ts +2 -0
  36. package/dist/src/web/bridges/hooks/use-adaptor.js +8 -0
  37. package/dist/src/web/bridges/hooks/use-adaptor.js.map +1 -0
  38. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.d.ts +2 -0
  39. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js +7 -0
  40. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js.map +1 -0
  41. package/dist/src/web/bridges/hooks/use-bridge.d.ts +2 -0
  42. package/dist/src/web/bridges/hooks/use-bridge.js +8 -0
  43. package/dist/src/web/bridges/hooks/use-bridge.js.map +1 -0
  44. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.d.ts +5 -0
  45. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js +7 -0
  46. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js.map +1 -0
  47. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js +41 -0
  48. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js.map +1 -0
  49. package/dist/src/web/bridges/index.d.ts +4 -0
  50. package/dist/src/web/bridges/index.js +5 -0
  51. package/dist/src/web/bridges/index.js.map +1 -0
  52. package/dist/src/web/bridges/mcp-app-bridge.d.ts +38 -0
  53. package/dist/src/web/bridges/mcp-app-bridge.js +162 -0
  54. package/dist/src/web/bridges/mcp-app-bridge.js.map +1 -0
  55. package/dist/src/web/bridges/types.d.ts +57 -0
  56. package/dist/src/web/bridges/types.js +2 -0
  57. package/dist/src/web/bridges/types.js.map +1 -0
  58. package/dist/src/web/create-store.d.ts +1 -1
  59. package/dist/src/web/create-store.js +3 -81
  60. package/dist/src/web/create-store.js.map +1 -1
  61. package/dist/src/web/create-store.test.js +70 -0
  62. package/dist/src/web/create-store.test.js.map +1 -0
  63. package/dist/src/web/data-llm.d.ts +14 -0
  64. package/dist/src/web/{llm-describe.js → data-llm.js} +20 -12
  65. package/dist/src/web/data-llm.js.map +1 -0
  66. package/dist/src/web/data-llm.test.js +76 -0
  67. package/dist/src/web/data-llm.test.js.map +1 -0
  68. package/dist/src/web/generate-helpers.d.ts +115 -0
  69. package/dist/src/web/generate-helpers.js +111 -0
  70. package/dist/src/web/generate-helpers.js.map +1 -0
  71. package/dist/src/web/generate-helpers.test-d.d.ts +1 -0
  72. package/dist/src/web/generate-helpers.test-d.js +209 -0
  73. package/dist/src/web/generate-helpers.test-d.js.map +1 -0
  74. package/dist/src/web/generate-helpers.test.d.ts +1 -0
  75. package/dist/src/web/generate-helpers.test.js +17 -0
  76. package/dist/src/web/generate-helpers.test.js.map +1 -0
  77. package/dist/src/web/helpers/state.d.ts +7 -0
  78. package/dist/src/web/helpers/state.js +40 -0
  79. package/dist/src/web/helpers/state.js.map +1 -0
  80. package/dist/src/web/helpers/state.test.d.ts +1 -0
  81. package/dist/src/web/helpers/state.test.js +53 -0
  82. package/dist/src/web/helpers/state.test.js.map +1 -0
  83. package/dist/src/web/hooks/index.d.ts +4 -6
  84. package/dist/src/web/hooks/index.js +4 -6
  85. package/dist/src/web/hooks/index.js.map +1 -1
  86. package/dist/src/web/hooks/test/utils.d.ts +10 -0
  87. package/dist/src/web/hooks/test/utils.js +40 -0
  88. package/dist/src/web/hooks/test/utils.js.map +1 -0
  89. package/dist/src/web/hooks/use-call-tool.d.ts +58 -20
  90. package/dist/src/web/hooks/use-call-tool.js +19 -19
  91. package/dist/src/web/hooks/use-call-tool.js.map +1 -1
  92. package/dist/src/web/hooks/use-call-tool.test-d.d.ts +1 -0
  93. package/dist/src/web/hooks/use-call-tool.test-d.js +104 -0
  94. package/dist/src/web/hooks/use-call-tool.test-d.js.map +1 -0
  95. package/dist/src/web/hooks/use-call-tool.test.js +35 -15
  96. package/dist/src/web/hooks/use-call-tool.test.js.map +1 -1
  97. package/dist/src/web/hooks/use-display-mode.d.ts +1 -1
  98. package/dist/src/web/hooks/use-display-mode.js +6 -3
  99. package/dist/src/web/hooks/use-display-mode.js.map +1 -1
  100. package/dist/src/web/hooks/use-display-mode.test.js +3 -2
  101. package/dist/src/web/hooks/use-display-mode.test.js.map +1 -1
  102. package/dist/src/web/hooks/use-files.d.ts +10 -0
  103. package/dist/src/web/hooks/use-files.js +7 -0
  104. package/dist/src/web/hooks/use-files.js.map +1 -0
  105. package/dist/src/web/hooks/use-files.test.d.ts +1 -0
  106. package/dist/src/web/hooks/use-files.test.js +29 -0
  107. package/dist/src/web/hooks/use-files.test.js.map +1 -0
  108. package/dist/src/web/hooks/use-layout.d.ts +22 -0
  109. package/dist/src/web/hooks/use-layout.js +23 -0
  110. package/dist/src/web/hooks/use-layout.js.map +1 -0
  111. package/dist/src/web/hooks/use-layout.test.d.ts +1 -0
  112. package/dist/src/web/hooks/use-layout.test.js +95 -0
  113. package/dist/src/web/hooks/use-layout.test.js.map +1 -0
  114. package/dist/src/web/hooks/use-open-external.js +5 -3
  115. package/dist/src/web/hooks/use-open-external.js.map +1 -1
  116. package/dist/src/web/hooks/use-open-external.test.js +43 -17
  117. package/dist/src/web/hooks/use-open-external.test.js.map +1 -1
  118. package/dist/src/web/hooks/use-openai-global.d.ts +3 -2
  119. package/dist/src/web/hooks/use-openai-global.js +3 -20
  120. package/dist/src/web/hooks/use-openai-global.js.map +1 -1
  121. package/dist/src/web/hooks/use-request-modal.d.ts +5 -1
  122. package/dist/src/web/hooks/use-request-modal.js +6 -1
  123. package/dist/src/web/hooks/use-request-modal.js.map +1 -1
  124. package/dist/src/web/hooks/use-request-modal.test.js +37 -4
  125. package/dist/src/web/hooks/use-request-modal.test.js.map +1 -1
  126. package/dist/src/web/hooks/use-send-follow-up-message.js +3 -6
  127. package/dist/src/web/hooks/use-send-follow-up-message.js.map +1 -1
  128. package/dist/src/web/hooks/use-tool-info.d.ts +15 -4
  129. package/dist/src/web/hooks/use-tool-info.js +15 -11
  130. package/dist/src/web/hooks/use-tool-info.js.map +1 -1
  131. package/dist/src/web/hooks/use-tool-info.test-d.js +40 -5
  132. package/dist/src/web/hooks/use-tool-info.test-d.js.map +1 -1
  133. package/dist/src/web/hooks/use-tool-info.test.js +119 -48
  134. package/dist/src/web/hooks/use-tool-info.test.js.map +1 -1
  135. package/dist/src/web/hooks/use-user.d.ts +18 -0
  136. package/dist/src/web/hooks/use-user.js +19 -0
  137. package/dist/src/web/hooks/use-user.js.map +1 -0
  138. package/dist/src/web/hooks/use-user.test.d.ts +1 -0
  139. package/dist/src/web/hooks/use-user.test.js +93 -0
  140. package/dist/src/web/hooks/use-user.test.js.map +1 -0
  141. package/dist/src/web/hooks/use-widget-state.js +5 -27
  142. package/dist/src/web/hooks/use-widget-state.js.map +1 -1
  143. package/dist/src/web/hooks/use-widget-state.test.js +3 -2
  144. package/dist/src/web/hooks/use-widget-state.test.js.map +1 -1
  145. package/dist/src/web/index.d.ts +6 -4
  146. package/dist/src/web/index.js +6 -4
  147. package/dist/src/web/index.js.map +1 -1
  148. package/dist/src/web/mount-widget.js +5 -0
  149. package/dist/src/web/mount-widget.js.map +1 -1
  150. package/dist/src/web/plugin/data-llm.test.d.ts +1 -0
  151. package/dist/src/web/plugin/data-llm.test.js +81 -0
  152. package/dist/src/web/plugin/data-llm.test.js.map +1 -0
  153. package/dist/src/web/plugin/plugin.js +39 -0
  154. package/dist/src/web/plugin/plugin.js.map +1 -0
  155. package/dist/src/web/plugin/transform-data-llm.d.ts +12 -0
  156. package/dist/src/web/plugin/transform-data-llm.js +96 -0
  157. package/dist/src/web/plugin/transform-data-llm.js.map +1 -0
  158. package/dist/src/web/plugin/transform-data-llm.test.d.ts +1 -0
  159. package/dist/src/web/plugin/transform-data-llm.test.js +81 -0
  160. package/dist/src/web/plugin/transform-data-llm.test.js.map +1 -0
  161. package/dist/src/web/proxy.d.ts +1 -0
  162. package/dist/src/web/proxy.js +53 -0
  163. package/dist/src/web/proxy.js.map +1 -0
  164. package/dist/src/web/types.d.ts +59 -27
  165. package/dist/src/web/types.js.map +1 -1
  166. package/package.json +25 -19
  167. package/README.md +0 -198
  168. package/dist/src/server/describe-plugin.d.ts +0 -2
  169. package/dist/src/server/describe-plugin.js +0 -101
  170. package/dist/src/server/describe-plugin.js.map +0 -1
  171. package/dist/src/web/hooks/use-locale.d.ts +0 -1
  172. package/dist/src/web/hooks/use-locale.js +0 -5
  173. package/dist/src/web/hooks/use-locale.js.map +0 -1
  174. package/dist/src/web/hooks/use-locale.test.js +0 -21
  175. package/dist/src/web/hooks/use-locale.test.js.map +0 -1
  176. package/dist/src/web/hooks/use-theme.d.ts +0 -1
  177. package/dist/src/web/hooks/use-theme.js +0 -5
  178. package/dist/src/web/hooks/use-theme.js.map +0 -1
  179. package/dist/src/web/hooks/use-theme.test.js +0 -26
  180. package/dist/src/web/hooks/use-theme.test.js.map +0 -1
  181. package/dist/src/web/hooks/use-tool-output.d.ts +0 -4
  182. package/dist/src/web/hooks/use-tool-output.js +0 -9
  183. package/dist/src/web/hooks/use-tool-output.js.map +0 -1
  184. package/dist/src/web/hooks/use-tool-response-metadata.d.ts +0 -4
  185. package/dist/src/web/hooks/use-tool-response-metadata.js +0 -8
  186. package/dist/src/web/hooks/use-tool-response-metadata.js.map +0 -1
  187. package/dist/src/web/hooks/use-user-agent.d.ts +0 -1
  188. package/dist/src/web/hooks/use-user-agent.js +0 -5
  189. package/dist/src/web/hooks/use-user-agent.js.map +0 -1
  190. package/dist/src/web/hooks/use-user-agent.test.js +0 -31
  191. package/dist/src/web/hooks/use-user-agent.test.js.map +0 -1
  192. package/dist/src/web/llm-describe.d.ts +0 -13
  193. package/dist/src/web/llm-describe.js.map +0 -1
  194. package/dist/src/web/plugin.js +0 -28
  195. package/dist/src/web/plugin.js.map +0 -1
  196. /package/dist/src/web/{hooks/use-locale.test.d.ts → bridges/hooks/use-mcp-app-bridge.test.d.ts} +0 -0
  197. /package/dist/src/web/{hooks/use-theme.test.d.ts → create-store.test.d.ts} +0 -0
  198. /package/dist/src/web/{hooks/use-user-agent.test.d.ts → data-llm.test.d.ts} +0 -0
  199. /package/dist/src/web/{plugin.d.ts → plugin/plugin.d.ts} +0 -0
@@ -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,41 @@
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
+ describe("useMcpAppBridge", () => {
7
+ beforeEach(async () => {
8
+ vi.stubGlobal("skybridge", { hostType: "mcp-app" });
9
+ McpAppBridge.resetInstance();
10
+ });
11
+ afterEach(() => {
12
+ vi.unstubAllGlobals();
13
+ vi.clearAllMocks();
14
+ });
15
+ it("should return the theme value from host context and update on notification", async () => {
16
+ vi.stubGlobal("parent", {
17
+ postMessage: getMcpAppHostPostMessageMock({ theme: "light" }),
18
+ });
19
+ const { result } = renderHook(() => useMcpAppBridge("theme"));
20
+ await waitFor(() => {
21
+ expect(result.current).toBe("light");
22
+ });
23
+ });
24
+ it("should reject the request after timeout", async () => {
25
+ vi.useFakeTimers();
26
+ const consoleErrorSpy = vi
27
+ .spyOn(console, "error")
28
+ .mockImplementation(() => { });
29
+ const nonRespondingMock = vi.fn();
30
+ vi.stubGlobal("parent", { postMessage: nonRespondingMock });
31
+ renderHook(() => useMcpAppBridge("theme", undefined, 100));
32
+ expect(nonRespondingMock).toHaveBeenCalledWith(expect.objectContaining({ method: "ui/initialize" }), "*");
33
+ await act(async () => {
34
+ await vi.advanceTimersByTimeAsync(100);
35
+ });
36
+ expect(consoleErrorSpy).toHaveBeenCalledWith(new Error("Request timed out"));
37
+ consoleErrorSpy.mockRestore();
38
+ vi.useRealTimers();
39
+ });
40
+ });
41
+ //# 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,4BAA4B,EAAE,MAAM,2BAA2B,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,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,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,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtB,WAAW,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAE9D,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,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAE5D,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QAE3D,MAAM,CAAC,iBAAiB,CAAC,CAAC,oBAAoB,CAC5C,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,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,38 @@
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
+ constructor(options: McpAppInitializationOptions, requestTimeout?: number);
21
+ static getInstance(options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpAppBridge;
22
+ subscribe(key: McpAppBridgeKey): Subscribe;
23
+ subscribe(keys: readonly McpAppBridgeKey[]): Subscribe;
24
+ getSnapshot<K extends keyof McpAppBridgeContext>(key: K): McpAppBridgeContext[K];
25
+ cleanup: () => void;
26
+ static resetInstance(): void;
27
+ request<R extends {
28
+ method: string;
29
+ params?: unknown;
30
+ }, T>({ method, params, }: R): Promise<T>;
31
+ private emit;
32
+ private updateContext;
33
+ private init;
34
+ private handleMessage;
35
+ private connect;
36
+ private notify;
37
+ }
38
+ export {};
@@ -0,0 +1,162 @@
1
+ const LATEST_PROTOCOL_VERSION = "2025-11-21";
2
+ export class McpAppBridge {
3
+ static instance = null;
4
+ context = {
5
+ toolInput: null,
6
+ toolCancelled: null,
7
+ toolResult: null,
8
+ };
9
+ listeners = new Map();
10
+ pendingRequests = new Map();
11
+ nextId = 1;
12
+ initialized;
13
+ appInitializationOptions;
14
+ requestTimeout;
15
+ constructor(options, requestTimeout = 10_000) {
16
+ this.requestTimeout = requestTimeout;
17
+ this.initialized = false;
18
+ this.appInitializationOptions = {
19
+ appInfo: options.appInfo,
20
+ appCapabilities: {},
21
+ protocolVersion: LATEST_PROTOCOL_VERSION,
22
+ };
23
+ }
24
+ static getInstance(options, requestTimeout) {
25
+ if (window.skybridge.hostType !== "mcp-app") {
26
+ throw new Error("MCP App Bridge can only be used in the mcp-app runtime");
27
+ }
28
+ if (McpAppBridge.instance && (options || requestTimeout)) {
29
+ console.warn("McpAppBridge.getInstance: options and requestTimeout ignored, instance already exists");
30
+ }
31
+ if (!McpAppBridge.instance) {
32
+ const defaultOptions = {
33
+ appInfo: { name: "skybridge-app", version: "0.0.1" },
34
+ };
35
+ McpAppBridge.instance = new McpAppBridge({ ...defaultOptions, ...options }, requestTimeout);
36
+ }
37
+ return McpAppBridge.instance;
38
+ }
39
+ subscribe(keyOrKeys) {
40
+ const keys = Array.isArray(keyOrKeys) ? keyOrKeys : [keyOrKeys];
41
+ return (onChange) => {
42
+ for (const key of keys) {
43
+ this.listeners.set(key, new Set([...(this.listeners.get(key) || []), onChange]));
44
+ }
45
+ this.init();
46
+ return () => {
47
+ for (const key of keys) {
48
+ this.listeners.get(key)?.delete(onChange);
49
+ }
50
+ };
51
+ };
52
+ }
53
+ getSnapshot(key) {
54
+ return this.context[key];
55
+ }
56
+ cleanup = () => {
57
+ window.removeEventListener("message", this.handleMessage);
58
+ this.pendingRequests.forEach((request) => {
59
+ clearTimeout(request.timeout);
60
+ });
61
+ this.pendingRequests.clear();
62
+ this.listeners.clear();
63
+ };
64
+ static resetInstance() {
65
+ if (McpAppBridge.instance) {
66
+ McpAppBridge.instance.cleanup();
67
+ McpAppBridge.instance = null;
68
+ }
69
+ }
70
+ request({ method, params, }) {
71
+ const id = this.nextId++;
72
+ const { promise, resolve, reject } = Promise.withResolvers();
73
+ this.pendingRequests.set(id, {
74
+ resolve: resolve,
75
+ reject,
76
+ timeout: setTimeout(() => {
77
+ reject(new Error("Request timed out"));
78
+ this.pendingRequests.delete(id);
79
+ }, this.requestTimeout),
80
+ });
81
+ window.parent.postMessage({ jsonrpc: "2.0", id, method, params }, "*");
82
+ return promise;
83
+ }
84
+ emit(key) {
85
+ this.listeners.get(key)?.forEach((listener) => {
86
+ listener();
87
+ });
88
+ }
89
+ updateContext(context) {
90
+ this.context = { ...this.context, ...context };
91
+ for (const key of Object.keys(context)) {
92
+ this.emit(key);
93
+ }
94
+ }
95
+ init() {
96
+ if (this.initialized) {
97
+ return;
98
+ }
99
+ this.initialized = true;
100
+ if (typeof window === "undefined" || window.parent === window) {
101
+ return;
102
+ }
103
+ window.addEventListener("message", this.handleMessage);
104
+ this.connect();
105
+ }
106
+ handleMessage = (event) => {
107
+ const data = event.data;
108
+ if (data.jsonrpc !== "2.0") {
109
+ return;
110
+ }
111
+ if ("id" in data) {
112
+ const request = this.pendingRequests.get(data.id);
113
+ if (request) {
114
+ clearTimeout(request.timeout);
115
+ this.pendingRequests.delete(data.id);
116
+ if ("error" in data) {
117
+ request.reject(new Error(data.error.message));
118
+ return;
119
+ }
120
+ request.resolve(data.result);
121
+ }
122
+ return;
123
+ }
124
+ switch (data.method) {
125
+ case "ui/notifications/host-context-changed":
126
+ this.updateContext(data.params);
127
+ return;
128
+ case "ui/notifications/tool-input":
129
+ this.updateContext({
130
+ toolInput: data.params.arguments ?? {},
131
+ });
132
+ return;
133
+ case "ui/notifications/tool-result":
134
+ this.updateContext({
135
+ toolResult: data.params,
136
+ });
137
+ return;
138
+ case "ui/notifications/tool-cancelled":
139
+ this.updateContext({
140
+ toolCancelled: data.params,
141
+ });
142
+ return;
143
+ }
144
+ };
145
+ async connect() {
146
+ try {
147
+ const result = await this.request({
148
+ method: "ui/initialize",
149
+ params: this.appInitializationOptions,
150
+ });
151
+ this.updateContext(result.hostContext);
152
+ this.notify({ method: "ui/notifications/initialized" });
153
+ }
154
+ catch (err) {
155
+ console.error(err);
156
+ }
157
+ }
158
+ notify(notification) {
159
+ window.parent.postMessage({ jsonrpc: "2.0", ...notification }, "*");
160
+ }
161
+ }
162
+ //# 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,57 @@
1
+ import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
2
+ import type { useSyncExternalStore } from "react";
3
+ export type CallToolArgs = Record<string, unknown> | null;
4
+ export type CallToolResponse = {
5
+ content: CallToolResult["content"];
6
+ structuredContent: NonNullable<CallToolResult["structuredContent"]>;
7
+ isError: NonNullable<CallToolResult["isError"]>;
8
+ result: string;
9
+ meta: NonNullable<CallToolResult["_meta"]>;
10
+ };
11
+ export type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
12
+ export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
13
+ export interface BridgeInterface {
14
+ theme: "light" | "dark";
15
+ locale: string;
16
+ displayMode: DisplayMode;
17
+ safeArea: {
18
+ insets: {
19
+ top: number;
20
+ right: number;
21
+ bottom: number;
22
+ left: number;
23
+ };
24
+ };
25
+ maxHeight: number;
26
+ userAgent: {
27
+ device: {
28
+ type: DeviceType;
29
+ };
30
+ capabilities: {
31
+ hover: boolean;
32
+ touch: boolean;
33
+ };
34
+ };
35
+ toolInput: Record<string, unknown> | null;
36
+ toolOutput: Record<string, unknown> | null;
37
+ toolResponseMetadata: Record<string, unknown> | null;
38
+ }
39
+ export type Subscribe = Parameters<typeof useSyncExternalStore>[0];
40
+ export interface Bridge<Context> {
41
+ subscribe(key: keyof Context): Subscribe;
42
+ subscribe(keys: readonly (keyof Context)[]): Subscribe;
43
+ getSnapshot<K extends keyof Context>(key: K): Context[K] | undefined;
44
+ }
45
+ export type ExternalStore<K extends keyof BridgeInterface> = {
46
+ subscribe: Subscribe;
47
+ getSnapshot: () => BridgeInterface[K];
48
+ };
49
+ export interface Adaptor {
50
+ getExternalStore<K extends keyof BridgeInterface>(key: K): ExternalStore<K>;
51
+ callTool<ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs): Promise<ToolResponse>;
52
+ requestDisplayMode(mode: DisplayMode): Promise<{
53
+ mode: DisplayMode;
54
+ }>;
55
+ sendFollowUpMessage(prompt: string): Promise<void>;
56
+ openExternal(href: string): void;
57
+ }
@@ -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":""}
@@ -1,3 +1,3 @@
1
1
  import { type StateCreator } from "zustand";
2
2
  import type { UnknownObject } from "./types.js";
3
- export declare function createStore<T extends UnknownObject>(storeCreator: StateCreator<T, [], [], T>, defaultState?: T | (() => T)): import("zustand").UseBoundStore<import("zustand").StoreApi<T>>;
3
+ export declare function createStore<State extends UnknownObject>(storeCreator: StateCreator<State, [], [], State>, defaultState?: State | (() => State)): import("zustand").UseBoundStore<import("zustand").StoreApi<State>>;
@@ -1,103 +1,25 @@
1
1
  import { create } from "zustand";
2
- import { SET_GLOBALS_EVENT_TYPE } from "./types.js";
3
- const WIDGET_CONTEXT_KEY = "__widget_context";
4
- function filterWidgetContext(state) {
5
- if (state === null) {
6
- return null;
7
- }
8
- const { [WIDGET_CONTEXT_KEY]: _, ...filteredState } = state;
9
- return filteredState;
10
- }
11
- function serializeState(value) {
12
- // Skip functions (methods)
13
- if (typeof value === "function") {
14
- return undefined;
15
- }
16
- // Handle arrays
17
- if (Array.isArray(value)) {
18
- return value
19
- .map((item) => serializeState(item))
20
- .filter((item) => item !== undefined);
21
- }
22
- // Handle objects
23
- if (value !== null && typeof value === "object") {
24
- const serialized = {};
25
- for (const [key, val] of Object.entries(value)) {
26
- const serializedValue = serializeState(val);
27
- if (serializedValue !== undefined) {
28
- serialized[key] = serializedValue;
29
- }
30
- }
31
- return serialized;
32
- }
33
- // Primitive values
34
- return value;
35
- }
36
- function preserveWidgetContext(newState) {
37
- if (newState === null) {
38
- return null;
39
- }
40
- const currentWindowState = window.openai?.widgetState;
41
- if (currentWindowState !== null &&
42
- currentWindowState !== undefined &&
43
- WIDGET_CONTEXT_KEY in currentWindowState) {
44
- return {
45
- ...newState,
46
- [WIDGET_CONTEXT_KEY]: currentWindowState[WIDGET_CONTEXT_KEY],
47
- };
48
- }
49
- return newState;
50
- }
51
- function getInitialState(defaultState) {
52
- const widgetStateFromWindow = window.openai?.widgetState;
53
- if (widgetStateFromWindow !== null && widgetStateFromWindow !== undefined) {
54
- return filterWidgetContext(widgetStateFromWindow);
55
- }
56
- return typeof defaultState === "function"
57
- ? defaultState()
58
- : defaultState ?? null;
59
- }
2
+ import { getInitialState, injectWidgetContext, serializeState, } from "./helpers/state.js";
60
3
  export function createStore(storeCreator, defaultState) {
61
4
  const initialState = getInitialState(defaultState);
62
5
  const store = create()((...args) => {
63
6
  const baseStore = storeCreator(...args);
64
- // Merge with initial state from window.openai.widgetState or defaultState
65
7
  if (initialState !== null) {
66
8
  return { ...baseStore, ...initialState };
67
9
  }
68
10
  return baseStore;
69
11
  });
70
- // Subscribe to store changes and persist to window.openai.setWidgetState
71
- let isInternalUpdate = false;
72
12
  store.subscribe((state) => {
73
- if (!isInternalUpdate && window.openai) {
74
- // Only serialize the state data, not the methods
13
+ if (window.openai) {
75
14
  const serializedState = serializeState(state);
76
15
  if (serializedState !== null && serializedState !== undefined) {
77
- const stateToPersist = preserveWidgetContext(serializedState);
16
+ const stateToPersist = injectWidgetContext(serializedState);
78
17
  if (stateToPersist !== null) {
79
18
  window.openai.setWidgetState(stateToPersist);
80
19
  }
81
20
  }
82
21
  }
83
22
  });
84
- // Listen to external widgetState changes and update the store
85
- if (typeof window !== "undefined") {
86
- const handleSetGlobals = (event) => {
87
- const widgetState = event.detail.globals.widgetState;
88
- if (widgetState !== undefined) {
89
- const filteredState = filterWidgetContext(widgetState);
90
- if (filteredState !== null) {
91
- isInternalUpdate = true;
92
- store.setState(filteredState);
93
- isInternalUpdate = false;
94
- }
95
- }
96
- };
97
- window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobals, {
98
- passive: true,
99
- });
100
- }
101
23
  return store;
102
24
  }
103
25
  //# sourceMappingURL=create-store.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-store.js","sourceRoot":"","sources":["../../../src/web/create-store.ts"],"names":[],"mappings":"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"}
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"}