skybridge 0.0.0-dev.fd7dd56 → 0.0.0-dev.fda2b44

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 (231) hide show
  1. package/README.md +24 -15
  2. package/dist/cli/detect-port.d.ts +18 -0
  3. package/dist/cli/detect-port.js +61 -0
  4. package/dist/cli/detect-port.js.map +1 -0
  5. package/dist/cli/header.js +1 -1
  6. package/dist/cli/header.js.map +1 -1
  7. package/dist/cli/tunnel-control-server.d.ts +9 -0
  8. package/dist/cli/tunnel-control-server.js +31 -0
  9. package/dist/cli/tunnel-control-server.js.map +1 -0
  10. package/dist/cli/tunnel-control-server.test.js +39 -0
  11. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  12. package/dist/cli/tunnel-handler.d.ts +3 -0
  13. package/dist/cli/tunnel-handler.js +48 -0
  14. package/dist/cli/tunnel-handler.js.map +1 -0
  15. package/dist/cli/tunnel-handler.test.js +105 -0
  16. package/dist/cli/tunnel-handler.test.js.map +1 -0
  17. package/dist/cli/tunnel.d.ts +57 -0
  18. package/dist/cli/tunnel.js +154 -0
  19. package/dist/cli/tunnel.js.map +1 -0
  20. package/dist/cli/tunnel.test.d.ts +1 -0
  21. package/dist/cli/tunnel.test.js +190 -0
  22. package/dist/cli/tunnel.test.js.map +1 -0
  23. package/dist/cli/types.d.ts +5 -0
  24. package/dist/cli/types.js +2 -0
  25. package/dist/cli/types.js.map +1 -0
  26. package/dist/cli/use-messages.d.ts +3 -0
  27. package/dist/cli/use-messages.js +11 -0
  28. package/dist/cli/use-messages.js.map +1 -0
  29. package/dist/cli/use-nodemon.d.ts +2 -6
  30. package/dist/cli/use-nodemon.js +20 -17
  31. package/dist/cli/use-nodemon.js.map +1 -1
  32. package/dist/cli/use-open-browser.d.ts +1 -0
  33. package/dist/cli/use-open-browser.js +44 -0
  34. package/dist/cli/use-open-browser.js.map +1 -0
  35. package/dist/cli/use-tunnel.d.ts +14 -0
  36. package/dist/cli/use-tunnel.js +131 -0
  37. package/dist/cli/use-tunnel.js.map +1 -0
  38. package/dist/cli/use-typescript-check.d.ts +1 -0
  39. package/dist/cli/use-typescript-check.js +41 -6
  40. package/dist/cli/use-typescript-check.js.map +1 -1
  41. package/dist/commands/build.js +63 -7
  42. package/dist/commands/build.js.map +1 -1
  43. package/dist/commands/dev.d.ts +4 -1
  44. package/dist/commands/dev.js +57 -8
  45. package/dist/commands/dev.js.map +1 -1
  46. package/dist/commands/start.d.ts +3 -1
  47. package/dist/commands/start.js +30 -9
  48. package/dist/commands/start.js.map +1 -1
  49. package/dist/server/asset-base-url-transform-plugin.d.ts +5 -6
  50. package/dist/server/asset-base-url-transform-plugin.js +9 -10
  51. package/dist/server/asset-base-url-transform-plugin.js.map +1 -1
  52. package/dist/server/asset-base-url-transform-plugin.test.js +41 -13
  53. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -1
  54. package/dist/server/content-helpers.d.ts +27 -0
  55. package/dist/server/content-helpers.js +46 -0
  56. package/dist/server/content-helpers.js.map +1 -0
  57. package/dist/server/content-helpers.test.d.ts +1 -0
  58. package/dist/server/content-helpers.test.js +70 -0
  59. package/dist/server/content-helpers.test.js.map +1 -0
  60. package/dist/server/express.d.ts +11 -0
  61. package/dist/server/express.js +101 -0
  62. package/dist/server/express.js.map +1 -0
  63. package/dist/server/express.test.d.ts +1 -0
  64. package/dist/server/express.test.js +430 -0
  65. package/dist/server/express.test.js.map +1 -0
  66. package/dist/server/index.d.ts +5 -3
  67. package/dist/server/index.js +3 -2
  68. package/dist/server/index.js.map +1 -1
  69. package/dist/server/inferUtilityTypes.d.ts +6 -6
  70. package/dist/server/metric.d.ts +14 -0
  71. package/dist/server/metric.js +62 -0
  72. package/dist/server/metric.js.map +1 -0
  73. package/dist/server/middleware.d.ts +124 -0
  74. package/dist/server/middleware.js +93 -0
  75. package/dist/server/middleware.js.map +1 -0
  76. package/dist/server/middleware.test-d.d.ts +1 -0
  77. package/dist/server/middleware.test-d.js +75 -0
  78. package/dist/server/middleware.test-d.js.map +1 -0
  79. package/dist/server/middleware.test.d.ts +1 -0
  80. package/dist/server/middleware.test.js +493 -0
  81. package/dist/server/middleware.test.js.map +1 -0
  82. package/dist/server/server.d.ts +160 -63
  83. package/dist/server/server.js +391 -76
  84. package/dist/server/server.js.map +1 -1
  85. package/dist/server/templateHelper.d.ts +5 -8
  86. package/dist/server/templateHelper.js +3 -22
  87. package/dist/server/templateHelper.js.map +1 -1
  88. package/dist/server/templates.generated.d.ts +4 -0
  89. package/dist/server/templates.generated.js +47 -0
  90. package/dist/server/templates.generated.js.map +1 -0
  91. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  92. package/dist/server/tunnel-proxy-router.js +110 -0
  93. package/dist/server/tunnel-proxy-router.js.map +1 -0
  94. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  95. package/dist/server/tunnel-proxy-router.test.js +229 -0
  96. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  97. package/dist/server/viewsDevServer.d.ts +14 -0
  98. package/dist/server/viewsDevServer.js +45 -0
  99. package/dist/server/viewsDevServer.js.map +1 -0
  100. package/dist/test/utils.d.ts +13 -21
  101. package/dist/test/utils.js +42 -37
  102. package/dist/test/utils.js.map +1 -1
  103. package/dist/test/view.test.d.ts +1 -0
  104. package/dist/test/view.test.js +523 -0
  105. package/dist/test/view.test.js.map +1 -0
  106. package/dist/version.d.ts +1 -0
  107. package/dist/version.js +3 -0
  108. package/dist/version.js.map +1 -0
  109. package/dist/web/bridges/apps-sdk/adaptor.d.ts +8 -6
  110. package/dist/web/bridges/apps-sdk/adaptor.js +46 -17
  111. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -1
  112. package/dist/web/bridges/apps-sdk/bridge.d.ts +1 -1
  113. package/dist/web/bridges/apps-sdk/index.d.ts +1 -1
  114. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  115. package/dist/web/bridges/apps-sdk/types.d.ts +24 -13
  116. package/dist/web/bridges/apps-sdk/types.js.map +1 -1
  117. package/dist/web/bridges/mcp-app/adaptor.d.ts +20 -8
  118. package/dist/web/bridges/mcp-app/adaptor.js +141 -58
  119. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -1
  120. package/dist/web/bridges/mcp-app/bridge.d.ts +13 -30
  121. package/dist/web/bridges/mcp-app/bridge.js +43 -196
  122. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  123. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +5 -3
  124. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +2 -2
  125. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -1
  126. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +1 -41
  127. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -1
  128. package/dist/web/bridges/types.d.ts +22 -11
  129. package/dist/web/components/modal-provider.js +3 -5
  130. package/dist/web/components/modal-provider.js.map +1 -1
  131. package/dist/web/create-store.js +17 -3
  132. package/dist/web/create-store.js.map +1 -1
  133. package/dist/web/create-store.test.js +23 -20
  134. package/dist/web/create-store.test.js.map +1 -1
  135. package/dist/web/data-llm.d.ts +1 -1
  136. package/dist/web/data-llm.js +3 -3
  137. package/dist/web/data-llm.js.map +1 -1
  138. package/dist/web/data-llm.test.js +33 -30
  139. package/dist/web/data-llm.test.js.map +1 -1
  140. package/dist/web/generate-helpers.d.ts +20 -18
  141. package/dist/web/generate-helpers.js +20 -18
  142. package/dist/web/generate-helpers.js.map +1 -1
  143. package/dist/web/generate-helpers.test-d.js +26 -26
  144. package/dist/web/generate-helpers.test-d.js.map +1 -1
  145. package/dist/web/helpers/state.d.ts +2 -2
  146. package/dist/web/helpers/state.js +11 -11
  147. package/dist/web/helpers/state.js.map +1 -1
  148. package/dist/web/helpers/state.test.js +9 -9
  149. package/dist/web/helpers/state.test.js.map +1 -1
  150. package/dist/web/hooks/index.d.ts +2 -2
  151. package/dist/web/hooks/index.js +1 -1
  152. package/dist/web/hooks/index.js.map +1 -1
  153. package/dist/web/hooks/test/utils.js +4 -0
  154. package/dist/web/hooks/test/utils.js.map +1 -1
  155. package/dist/web/hooks/use-display-mode.d.ts +3 -3
  156. package/dist/web/hooks/use-display-mode.js.map +1 -1
  157. package/dist/web/hooks/use-display-mode.test-d.d.ts +1 -0
  158. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  159. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  160. package/dist/web/hooks/use-files.d.ts +2 -1
  161. package/dist/web/hooks/use-files.js +1 -0
  162. package/dist/web/hooks/use-files.js.map +1 -1
  163. package/dist/web/hooks/use-files.test.js +27 -3
  164. package/dist/web/hooks/use-files.test.js.map +1 -1
  165. package/dist/web/hooks/use-layout.test.js +3 -3
  166. package/dist/web/hooks/use-layout.test.js.map +1 -1
  167. package/dist/web/hooks/use-open-external.d.ts +3 -1
  168. package/dist/web/hooks/use-open-external.js +1 -1
  169. package/dist/web/hooks/use-open-external.js.map +1 -1
  170. package/dist/web/hooks/use-open-external.test.js +26 -11
  171. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  172. package/dist/web/hooks/use-request-modal.d.ts +1 -1
  173. package/dist/web/hooks/use-request-modal.js +4 -4
  174. package/dist/web/hooks/use-request-modal.js.map +1 -1
  175. package/dist/web/hooks/use-request-modal.test.js +5 -1
  176. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  177. package/dist/web/hooks/use-set-open-in-app-url.test.js +5 -11
  178. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -1
  179. package/dist/web/hooks/use-tool-info.test.js +1 -1
  180. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  181. package/dist/web/hooks/use-user.js +18 -2
  182. package/dist/web/hooks/use-user.js.map +1 -1
  183. package/dist/web/hooks/use-user.test.js +29 -1
  184. package/dist/web/hooks/use-user.test.js.map +1 -1
  185. package/dist/web/hooks/use-view-state.d.ts +4 -0
  186. package/dist/web/hooks/use-view-state.js +32 -0
  187. package/dist/web/hooks/use-view-state.js.map +1 -0
  188. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  189. package/dist/web/hooks/use-view-state.test.js +177 -0
  190. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  191. package/dist/web/index.d.ts +1 -2
  192. package/dist/web/index.js +1 -2
  193. package/dist/web/index.js.map +1 -1
  194. package/dist/web/mount-view.d.ts +1 -0
  195. package/dist/web/{mount-widget.js → mount-view.js} +2 -2
  196. package/dist/web/mount-view.js.map +1 -0
  197. package/dist/web/plugin/plugin.d.ts +4 -1
  198. package/dist/web/plugin/plugin.js +128 -18
  199. package/dist/web/plugin/plugin.js.map +1 -1
  200. package/dist/web/plugin/scan-views.d.ts +16 -0
  201. package/dist/web/plugin/scan-views.js +88 -0
  202. package/dist/web/plugin/scan-views.js.map +1 -0
  203. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  204. package/dist/web/plugin/scan-views.test.js +99 -0
  205. package/dist/web/plugin/scan-views.test.js.map +1 -0
  206. package/dist/web/plugin/transform-data-llm.js +1 -1
  207. package/dist/web/plugin/transform-data-llm.js.map +1 -1
  208. package/dist/web/plugin/validate-view.d.ts +1 -0
  209. package/dist/web/plugin/validate-view.js +9 -0
  210. package/dist/web/plugin/validate-view.js.map +1 -0
  211. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  212. package/dist/web/plugin/validate-view.test.js +24 -0
  213. package/dist/web/plugin/validate-view.test.js.map +1 -0
  214. package/package.json +44 -30
  215. package/tsconfig.base.json +33 -0
  216. package/dist/server/templates/development.hbs +0 -67
  217. package/dist/server/templates/production.hbs +0 -6
  218. package/dist/server/widgetsDevServer.d.ts +0 -12
  219. package/dist/server/widgetsDevServer.js +0 -57
  220. package/dist/server/widgetsDevServer.js.map +0 -1
  221. package/dist/test/widget.test.js +0 -255
  222. package/dist/test/widget.test.js.map +0 -1
  223. package/dist/web/hooks/use-widget-state.d.ts +0 -4
  224. package/dist/web/hooks/use-widget-state.js +0 -32
  225. package/dist/web/hooks/use-widget-state.js.map +0 -1
  226. package/dist/web/hooks/use-widget-state.test.js +0 -61
  227. package/dist/web/hooks/use-widget-state.test.js.map +0 -1
  228. package/dist/web/mount-widget.d.ts +0 -1
  229. package/dist/web/mount-widget.js.map +0 -1
  230. /package/dist/{test/widget.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  231. /package/dist/{web/hooks/use-widget-state.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
@@ -12,6 +12,18 @@ export class AppsSdkAdaptor {
12
12
  }
13
13
  getHostContextStore(key) {
14
14
  const bridge = AppsSdkBridge.getInstance();
15
+ if (key === "viewState") {
16
+ return {
17
+ subscribe: bridge.subscribe("widgetState"),
18
+ getSnapshot: () => bridge.getSnapshot("widgetState")?.modelContent ?? null,
19
+ };
20
+ }
21
+ if (key === "display") {
22
+ return {
23
+ subscribe: bridge.subscribe("view"),
24
+ getSnapshot: () => bridge.getSnapshot("view"),
25
+ };
26
+ }
15
27
  return {
16
28
  subscribe: bridge.subscribe(key),
17
29
  getSnapshot: () => bridge.getSnapshot(key),
@@ -26,21 +38,47 @@ export class AppsSdkAdaptor {
26
38
  sendFollowUpMessage = (prompt) => {
27
39
  return window.openai.sendFollowUpMessage({ prompt });
28
40
  };
29
- openExternal(href) {
30
- window.openai.openExternal({ href });
41
+ openExternal(href, options = {}) {
42
+ window.openai.openExternal({ href, ...options });
31
43
  }
32
- setWidgetState = (stateOrUpdater) => {
33
- const newState = typeof stateOrUpdater === "function"
34
- ? stateOrUpdater(window.openai.widgetState)
44
+ setViewState = (stateOrUpdater) => {
45
+ const modelContent = typeof stateOrUpdater === "function"
46
+ ? stateOrUpdater(window.openai.widgetState?.modelContent ?? null)
35
47
  : stateOrUpdater;
36
- return window.openai.setWidgetState(newState);
48
+ return window.openai.setWidgetState({
49
+ privateContent: {},
50
+ ...window.openai.widgetState,
51
+ modelContent,
52
+ });
37
53
  };
38
- uploadFile = (file) => {
39
- return window.openai.uploadFile(file);
54
+ uploadFile = async (file, options) => {
55
+ const metadata = await window.openai.uploadFile(file, options);
56
+ await this.trackFileIds(metadata.fileId);
57
+ return metadata;
40
58
  };
41
59
  getFileDownloadUrl = (file) => {
42
60
  return window.openai.getFileDownloadUrl(file);
43
61
  };
62
+ selectFiles = async () => {
63
+ if (!window.openai.selectFiles) {
64
+ throw new Error("selectFiles is not supported by the current host version.");
65
+ }
66
+ const files = await window.openai.selectFiles();
67
+ if (files.length > 0) {
68
+ await this.trackFileIds(...files.map((f) => f.fileId));
69
+ }
70
+ return files;
71
+ };
72
+ async trackFileIds(...fileIds) {
73
+ const state = window.openai.widgetState
74
+ ? { ...window.openai.widgetState }
75
+ : { modelContent: {}, privateContent: {} };
76
+ if (!state.imageIds) {
77
+ state.imageIds = [];
78
+ }
79
+ state.imageIds.push(...fileIds);
80
+ await window.openai.setWidgetState(state);
81
+ }
44
82
  openModal(options) {
45
83
  return window.openai.requestModal(options);
46
84
  }
@@ -49,15 +87,6 @@ export class AppsSdkAdaptor {
49
87
  if (!href) {
50
88
  throw new Error("The href parameter is required.");
51
89
  }
52
- const serverUrl = window.skybridge.serverUrl;
53
- if (!serverUrl) {
54
- throw new Error("The widgetDomain property has not been set on the widget resource meta object.");
55
- }
56
- const domainUrl = new URL(serverUrl);
57
- const hrefUrl = new URL(href, serverUrl);
58
- if (domainUrl.origin !== hrefUrl.origin) {
59
- throw new Error("Provided href is not compatible with widget domain: origin differs");
60
- }
61
90
  return window.openai.setOpenInAppUrl({ href });
62
91
  }
63
92
  }
@@ -1 +1 @@
1
- {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"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"}
@@ -6,5 +6,5 @@ export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
6
6
  static resetInstance(): void;
7
7
  subscribe(key: keyof AppsSdkContext): Subscribe;
8
8
  subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;
9
- getSnapshot: <K extends keyof AppsSdkContext>(key: K) => (import("./types.js").AppsSdkMethods<import("../../types.js").UnknownObject> & AppsSdkContext<Record<never, unknown>, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject>)[K];
9
+ getSnapshot: <K extends keyof AppsSdkContext>(key: K) => (import("./types.js").AppsSdkMethods<import("./types.js").AppsSdkWidgetState> & AppsSdkContext<Record<never, unknown>, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject, import("./types.js").AppsSdkWidgetState>)[K];
10
10
  }
@@ -1,5 +1,5 @@
1
1
  export { AppsSdkAdaptor } from "./adaptor.js";
2
2
  export { AppsSdkBridge } from "./bridge.js";
3
- export type { AppsSdkContext, AppsSdkMethods, ToolResponseEvent, } from "./types.js";
3
+ export type { AppsSdkContext, AppsSdkMethods, AppsSdkWidgetState, ToolResponseEvent, } from "./types.js";
4
4
  export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
5
5
  export { useAppsSdkContext } from "./use-apps-sdk-context.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
@@ -1,7 +1,12 @@
1
1
  import type { UnknownObject } from "../../types.js";
2
- import type { CallToolArgs, CallToolResponse, FileMetadata, RequestModalOptions } from "../types.js";
2
+ import type { CallToolArgs, CallToolResponse, FileMetadata, RequestModalOptions, UploadFileOptions } from "../types.js";
3
3
  type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
4
- type WidgetState = UnknownObject;
4
+ type RequestDisplayMode = Exclude<DisplayMode, "modal">;
5
+ export type AppsSdkWidgetState = {
6
+ modelContent: Record<string, unknown>;
7
+ privateContent: Record<string, unknown>;
8
+ imageIds?: string[];
9
+ };
5
10
  export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
6
11
  export declare class ToolResponseEvent extends CustomEvent<{
7
12
  tool: {
@@ -13,13 +18,13 @@ export declare class ToolResponseEvent extends CustomEvent<{
13
18
  }
14
19
  declare global {
15
20
  interface Window {
16
- openai: AppsSdkMethods<WidgetState> & AppsSdkContext;
21
+ openai: AppsSdkMethods & AppsSdkContext;
17
22
  }
18
23
  interface WindowEventMap {
19
24
  [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
20
25
  }
21
26
  }
22
- export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
27
+ export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WS extends AppsSdkWidgetState = AppsSdkWidgetState> = {
23
28
  theme: Theme;
24
29
  userAgent: UserAgent;
25
30
  locale: string;
@@ -32,9 +37,9 @@ export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unkno
32
37
  text: string;
33
38
  } | null;
34
39
  toolResponseMetadata: ToolResponseMetadata | null;
35
- widgetState: WidgetState | null;
40
+ widgetState: WS | null;
36
41
  };
37
- export type AppsSdkMethods<WidgetState extends UnknownObject = UnknownObject> = {
42
+ export type AppsSdkMethods<WS extends AppsSdkWidgetState = AppsSdkWidgetState> = {
38
43
  /** Calls a tool on your MCP. Returns the full response. */
39
44
  callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
40
45
  /** Triggers a followup turn in the ChatGPT conversation */
@@ -44,32 +49,38 @@ export type AppsSdkMethods<WidgetState extends UnknownObject = UnknownObject> =
44
49
  /** Opens an external link, redirects web page or mobile app */
45
50
  openExternal(args: {
46
51
  href: string;
52
+ redirectUrl?: false;
47
53
  }): void;
48
54
  /** For transitioning an app from inline to fullscreen or pip */
49
55
  requestDisplayMode: (args: {
50
- mode: DisplayMode;
56
+ mode: RequestDisplayMode;
51
57
  }) => Promise<{
52
58
  /**
53
59
  * The granted display mode. The host may reject the request.
54
60
  * For mobile, PiP is always coerced to fullscreen.
55
61
  */
56
- mode: DisplayMode;
62
+ mode: RequestDisplayMode;
57
63
  }>;
58
64
  /**
59
65
  * Sets the widget state.
60
66
  * This state is persisted across widget renders.
61
67
  */
62
- setWidgetState: (state: WidgetState) => Promise<void>;
68
+ setWidgetState: (state: WS) => Promise<void>;
63
69
  /**
64
70
  * Opens a modal portaled outside of the widget iFrame.
65
71
  * This ensures the modal is correctly displayed and not limited to the widget's area.
66
72
  */
67
73
  requestModal: (args: RequestModalOptions) => Promise<void>;
68
- /** Uploads a new file to the host */
69
- uploadFile: (file: File) => Promise<FileMetadata>;
74
+ /** Uploads a new file to the host. Pass `{ library: true }` to also save to the user's ChatGPT file library. */
75
+ uploadFile: (file: File, options?: UploadFileOptions) => Promise<FileMetadata>;
76
+ /**
77
+ * Opens ChatGPT's file library picker and returns app-authorized files.
78
+ * Feature-detect before using: this method may not be available on all host versions.
79
+ */
80
+ selectFiles?: () => Promise<FileMetadata[]>;
70
81
  /**
71
- * Downloads a file from the host that was previously uploaded.
72
- * Only files uploaded by the same connector instance can be downloaded.
82
+ * Downloads a file from the host. Works for files uploaded by the widget,
83
+ * files selected via selectFiles(), or files provided via tool/file params.
73
84
  */
74
85
  getFileDownloadUrl: (file: FileMetadata) => Promise<{
75
86
  downloadUrl: string;
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/types.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA2FD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/types.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AAoGD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
@@ -1,22 +1,25 @@
1
- import type { McpUiRequestDisplayModeResult } from "@modelcontextprotocol/ext-apps";
2
- import type { Adaptor, CallToolResponse, DisplayMode, HostContext, HostContextStore, RequestModalOptions, SetWidgetStateAction } from "../types.js";
1
+ import type { Adaptor, CallToolResponse, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, SetViewStateAction } from "../types.js";
3
2
  export declare class McpAppAdaptor implements Adaptor {
4
3
  private static instance;
5
4
  private stores;
6
- private _widgetState;
7
- private widgetStateListeners;
8
5
  private _viewState;
9
- private viewListeners;
6
+ private viewStateListeners;
7
+ private _viewUUID;
8
+ private _displayState;
9
+ private displayListeners;
10
10
  private constructor();
11
11
  static getInstance(): McpAppAdaptor;
12
12
  static resetInstance(): void;
13
13
  getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
14
14
  callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
15
- requestDisplayMode: (mode: DisplayMode) => Promise<McpUiRequestDisplayModeResult>;
15
+ requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
16
+ [x: string]: unknown;
17
+ mode: "inline" | "fullscreen" | "pip";
18
+ }>;
16
19
  sendFollowUpMessage: (prompt: string) => Promise<void>;
17
- openExternal(href: string): void;
20
+ openExternal(href: string, options?: OpenExternalOptions): void;
18
21
  private initializeStores;
19
- setWidgetState: (stateOrUpdater: SetWidgetStateAction) => Promise<void>;
22
+ setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
20
23
  /**
21
24
  * @throws File upload is not supported in MCP App.
22
25
  */
@@ -29,8 +32,17 @@ export declare class McpAppAdaptor implements Adaptor {
29
32
  getFileDownloadUrl(): Promise<{
30
33
  downloadUrl: string;
31
34
  }>;
35
+ /**
36
+ * @throws File selection is not supported in MCP App.
37
+ */
38
+ selectFiles(): Promise<{
39
+ fileId: string;
40
+ }[]>;
32
41
  openModal(options: RequestModalOptions): void;
33
42
  closeModal(): void;
34
43
  setOpenInAppUrl(_href: string): Promise<void>;
44
+ private subscribeToViewUUID;
45
+ private restoreFromLocalStorage;
46
+ private persistToLocalStorage;
35
47
  private createHostContextStore;
36
48
  }
@@ -1,16 +1,30 @@
1
1
  import { dequal } from "dequal/lite";
2
2
  import { McpAppBridge } from "./bridge.js";
3
+ const STORAGE_PREFIX = "sb:";
4
+ const MAX_STORAGE_ENTRIES = 200;
5
+ function findStorageKey(viewUUID) {
6
+ const suffix = `:${viewUUID}`;
7
+ for (let i = 0; i < localStorage.length; i++) {
8
+ const key = localStorage.key(i);
9
+ if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {
10
+ return key;
11
+ }
12
+ }
13
+ return undefined;
14
+ }
3
15
  export class McpAppAdaptor {
4
16
  static instance = null;
5
17
  stores;
6
- _widgetState = null;
7
- widgetStateListeners = new Set();
8
- _viewState = {
18
+ _viewState = null;
19
+ viewStateListeners = new Set();
20
+ _viewUUID = null;
21
+ _displayState = {
9
22
  mode: "inline",
10
23
  };
11
- viewListeners = new Set();
24
+ displayListeners = new Set();
12
25
  constructor() {
13
26
  this.stores = this.initializeStores();
27
+ this.subscribeToViewUUID();
14
28
  }
15
29
  static getInstance() {
16
30
  if (!McpAppAdaptor.instance) {
@@ -25,13 +39,10 @@ export class McpAppAdaptor {
25
39
  return this.stores[key];
26
40
  }
27
41
  callTool = async (name, args) => {
28
- const bridge = McpAppBridge.getInstance();
29
- const response = await bridge.request({
30
- method: "tools/call",
31
- params: {
32
- name,
33
- arguments: args ?? undefined,
34
- },
42
+ const app = await McpAppBridge.getInstance().getApp();
43
+ const response = await app.callServerTool({
44
+ name,
45
+ arguments: args ?? undefined,
35
46
  });
36
47
  const result = response.content
37
48
  .filter((content) => content.type === "text")
@@ -45,36 +56,31 @@ export class McpAppAdaptor {
45
56
  meta: response._meta ?? {},
46
57
  };
47
58
  };
48
- requestDisplayMode = (mode) => {
49
- const bridge = McpAppBridge.getInstance();
50
- if (mode !== "modal") {
51
- return bridge.request({
52
- method: "ui/request-display-mode",
53
- params: { mode },
54
- });
55
- }
56
- throw new Error("Modal display mode is not accessible in MCP App.");
59
+ requestDisplayMode = async (mode) => {
60
+ const app = await McpAppBridge.getInstance().getApp();
61
+ return app.requestDisplayMode({ mode });
57
62
  };
58
63
  sendFollowUpMessage = async (prompt) => {
59
- const bridge = McpAppBridge.getInstance();
60
- await bridge.request({
61
- method: "ui/message",
62
- params: {
63
- role: "user",
64
- content: [
65
- {
66
- type: "text",
67
- text: prompt,
68
- },
69
- ],
70
- },
64
+ const app = await McpAppBridge.getInstance().getApp();
65
+ await app.sendMessage({
66
+ role: "user",
67
+ content: [
68
+ {
69
+ type: "text",
70
+ text: prompt,
71
+ },
72
+ ],
71
73
  });
72
74
  };
73
- openExternal(href) {
74
- const bridge = McpAppBridge.getInstance();
75
- bridge.request({
76
- method: "ui/open-link",
77
- params: { url: href },
75
+ openExternal(href, options) {
76
+ if (options?.redirectUrl === false) {
77
+ console.warn("[skybridge] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.");
78
+ }
79
+ McpAppBridge.getInstance()
80
+ .getApp()
81
+ .then((app) => app.openLink({ url: href }))
82
+ .catch((err) => {
83
+ console.error("Failed to open external link:", err);
78
84
  });
79
85
  }
80
86
  initializeStores() {
@@ -104,39 +110,47 @@ export class McpAppAdaptor {
104
110
  toolInput: this.createHostContextStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
105
111
  toolOutput: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
106
112
  toolResponseMetadata: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
107
- view: {
113
+ display: {
108
114
  subscribe: (onChange) => {
109
- this.viewListeners.add(onChange);
115
+ this.displayListeners.add(onChange);
110
116
  return () => {
111
- this.viewListeners.delete(onChange);
117
+ this.displayListeners.delete(onChange);
112
118
  };
113
119
  },
114
- getSnapshot: () => this._viewState,
120
+ getSnapshot: () => this._displayState,
115
121
  },
116
- widgetState: {
122
+ viewState: {
117
123
  subscribe: (onChange) => {
118
- this.widgetStateListeners.add(onChange);
124
+ this.viewStateListeners.add(onChange);
119
125
  return () => {
120
- this.widgetStateListeners.delete(onChange);
126
+ this.viewStateListeners.delete(onChange);
121
127
  };
122
128
  },
123
- getSnapshot: () => this._widgetState,
129
+ getSnapshot: () => this._viewState,
124
130
  },
125
131
  };
126
132
  }
127
- setWidgetState = async (stateOrUpdater) => {
133
+ setViewState = async (stateOrUpdater) => {
128
134
  const newState = typeof stateOrUpdater === "function"
129
- ? stateOrUpdater(this._widgetState)
135
+ ? stateOrUpdater(this._viewState)
130
136
  : stateOrUpdater;
131
- const bridge = McpAppBridge.getInstance();
132
- await bridge.request({
133
- method: "ui/update-model-context",
134
- params: { structuredContent: newState },
135
- });
136
- this._widgetState = newState;
137
- this.widgetStateListeners.forEach((listener) => {
137
+ // must happen before the async bridge call to ensure the state is updated immediately for the UI,
138
+ // otherwise successive calls to setViewState may have stale state
139
+ this._viewState = newState;
140
+ this.viewStateListeners.forEach((listener) => {
138
141
  listener();
139
142
  });
143
+ this.persistToLocalStorage(newState);
144
+ try {
145
+ const app = await McpAppBridge.getInstance().getApp();
146
+ await app.updateModelContext({
147
+ structuredContent: newState,
148
+ content: [{ type: "text", text: JSON.stringify(newState) }],
149
+ });
150
+ }
151
+ catch (error) {
152
+ console.error("Failed to update view state in MCP App.", error);
153
+ }
140
154
  };
141
155
  /**
142
156
  * @throws File upload is not supported in MCP App.
@@ -150,21 +164,90 @@ export class McpAppAdaptor {
150
164
  getFileDownloadUrl() {
151
165
  throw new Error("File download is not supported in MCP App.");
152
166
  }
167
+ /**
168
+ * @throws File selection is not supported in MCP App.
169
+ */
170
+ selectFiles() {
171
+ throw new Error("File selection is not supported in MCP App.");
172
+ }
153
173
  openModal(options) {
154
- this._viewState = { mode: "modal", params: options.params };
155
- this.viewListeners.forEach((listener) => {
174
+ this._displayState = { mode: "modal", params: options.params };
175
+ this.displayListeners.forEach((listener) => {
156
176
  listener();
157
177
  });
158
178
  }
159
179
  closeModal() {
160
- this._viewState = { mode: "inline" };
161
- this.viewListeners.forEach((listener) => {
180
+ this._displayState = { mode: "inline" };
181
+ this.displayListeners.forEach((listener) => {
162
182
  listener();
163
183
  });
164
184
  }
165
185
  setOpenInAppUrl(_href) {
166
186
  throw new Error("setOpenInAppUrl is not implemented in MCP App.");
167
187
  }
188
+ subscribeToViewUUID() {
189
+ const bridge = McpAppBridge.getInstance();
190
+ bridge.subscribe("toolResult")(() => {
191
+ const toolResult = bridge.getSnapshot("toolResult");
192
+ const viewUUID = toolResult?._meta?.viewUUID;
193
+ if (viewUUID && viewUUID !== this._viewUUID) {
194
+ this._viewUUID = viewUUID;
195
+ this.restoreFromLocalStorage(viewUUID);
196
+ }
197
+ });
198
+ }
199
+ // localStorage keys: sb:{unix_ms}:{viewUUID}
200
+ // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.
201
+ restoreFromLocalStorage(viewUUID) {
202
+ try {
203
+ const existingKey = findStorageKey(viewUUID);
204
+ if (existingKey) {
205
+ const stored = localStorage.getItem(existingKey);
206
+ if (stored !== null) {
207
+ this._viewState = JSON.parse(stored);
208
+ this.viewStateListeners.forEach((listener) => {
209
+ listener();
210
+ });
211
+ }
212
+ }
213
+ }
214
+ catch (err) {
215
+ console.error(err);
216
+ }
217
+ }
218
+ persistToLocalStorage(state) {
219
+ if (!this._viewUUID || state === null) {
220
+ return;
221
+ }
222
+ try {
223
+ // Remove old key for this view, write with fresh timestamp (LRU)
224
+ const oldKey = findStorageKey(this._viewUUID);
225
+ if (oldKey) {
226
+ localStorage.removeItem(oldKey);
227
+ }
228
+ const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
229
+ localStorage.setItem(newKey, JSON.stringify(state));
230
+ // lru cleanup
231
+ const keys = [];
232
+ for (let i = 0; i < localStorage.length; i++) {
233
+ const key = localStorage.key(i);
234
+ if (key?.startsWith(STORAGE_PREFIX)) {
235
+ keys.push(key);
236
+ }
237
+ }
238
+ if (keys.length <= MAX_STORAGE_ENTRIES) {
239
+ return;
240
+ }
241
+ keys.sort();
242
+ const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);
243
+ for (const key of toRemove) {
244
+ localStorage.removeItem(key);
245
+ }
246
+ }
247
+ catch (err) {
248
+ console.error(err);
249
+ }
250
+ }
168
251
  createHostContextStore(keys, computeSnapshot) {
169
252
  const bridge = McpAppBridge.getInstance();
170
253
  let cachedValue;
@@ -1 +1 @@
1
- {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/adaptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAC7C,MAAM,CAEZ;IACM,YAAY,GAA+B,IAAI,CAAC;IAChD,oBAAoB,GAAG,IAAI,GAAG,EAAc,CAAC;IAE7C,UAAU,GAAwB;QACxC,IAAI,EAAE,QAAQ;KACf,CAAC;IACM,aAAa,GAAG,IAAI,GAAG,EAAc,CAAC;IAE9C;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;IAChC,CAAC;IAEM,mBAAmB,CACxB,GAAM;QAEN,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEM,QAAQ,GAAG,KAAK,EAIrB,IAAY,EACZ,IAAc,EACS,EAAE;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAkC;YACrE,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE;gBACN,IAAI;gBACJ,SAAS,EAAE,IAAI,IAAI,SAAS;aAC7B;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO;aAC5B,MAAM,CACL,CAAC,OAAO,EAA6C,EAAE,CACrD,OAAO,CAAC,IAAI,KAAK,MAAM,CAC1B;aACA,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;aACvB,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,IAAI,EAAE;YACnD,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,KAAK;YAClC,MAAM;YACN,IAAI,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;SACX,CAAC;IACpB,CAAC,CAAC;IAEK,kBAAkB,GAAG,CAAC,IAAiB,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,OAAO,CAGnB;gBACA,MAAM,EAAE,yBAAyB;gBACjC,MAAM,EAAE,EAAE,IAAI,EAAE;aACjB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC,CAAC;IAEK,mBAAmB,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,MAAM,CAAC,OAAO,CAA0C;YAC5D,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;qBACb;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAEK,YAAY,CAAC,IAAY;QAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAA4C;YACxD,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB;QAGtB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,sBAAsB,CAChC,CAAC,OAAO,CAAC,EACT,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,CAChC;YACD,MAAM,EAAE,IAAI,CAAC,sBAAsB,CACjC,CAAC,QAAQ,CAAC,EACV,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,IAAI,OAAO,CAClC;YACD,QAAQ,EAAE,IAAI,CAAC,sBAAsB,CACnC,CAAC,gBAAgB,CAAC,EAClB,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;gBACvB,MAAM,EAAE,cAAc,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;aACnE,CAAC,CACH;YACD,WAAW,EAAE,IAAI,CAAC,sBAAsB,CACtC,CAAC,aAAa,CAAC,EACf,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,IAAI,QAAQ,CAC7C;YACD,SAAS,EAAE,IAAI,CAAC,sBAAsB,CACpC,CAAC,qBAAqB,CAAC,EACvB,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE;gBAC1B,IAAI,mBAAmB,IAAI,WAAW,IAAI,mBAAmB,EAAE,CAAC;oBAC9D,OAAO,mBAAmB,CAAC,SAAS,CAAC;gBACvC,CAAC;gBAED,OAAO,SAAS,CAAC;YACnB,CAAC,CACF;YACD,SAAS,EAAE,IAAI,CAAC,sBAAsB,CACpC,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAClC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC,CAAC;gBACrC,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,SAAS,CAAC;iBAC/D;gBACD,YAAY,EAAE;oBACZ,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,IAAI;oBACX,GAAG,kBAAkB;iBACtB;aACF,CAAC,CACH;YACD,SAAS,EAAE,IAAI,CAAC,sBAAsB,CACpC,CAAC,WAAW,CAAC,EACb,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,CACrC;YACD,UAAU,EAAE,IAAI,CAAC,sBAAsB,CACrC,CAAC,YAAY,CAAC,EACd,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,iBAAiB,IAAI,IAAI,CAC1D;YACD,oBAAoB,EAAE,IAAI,CAAC,sBAAsB,CAC/C,CAAC,YAAY,CAAC,EACd,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,IAAI,CAC9C;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,CAAC,QAAoB,EAAE,EAAE;oBAClC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACjC,OAAO,GAAG,EAAE;wBACV,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACtC,CAAC,CAAC;gBACJ,CAAC;gBACD,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU;aACnC;YACD,WAAW,EAAE;gBACX,SAAS,EAAE,CAAC,QAAoB,EAAE,EAAE;oBAClC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACxC,OAAO,GAAG,EAAE;wBACV,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC7C,CAAC,CAAC;gBACJ,CAAC;gBACD,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY;aACrC;SACF,CAAC;IACJ,CAAC;IAEM,cAAc,GAAG,KAAK,EAC3B,cAAoC,EACrB,EAAE;QACjB,MAAM,QAAQ,GACZ,OAAO,cAAc,KAAK,UAAU;YAClC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC;YACnC,CAAC,CAAC,cAAc,CAAC;QAErB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,MAAM,CAAC,OAAO,CAA0C;YAC5D,MAAM,EAAE,yBAAyB;YACjC,MAAM,EAAE,EAAE,iBAAiB,EAAE,QAAQ,EAAE;SACxC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7C,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF;;OAEG;IACI,UAAU;QACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACI,kBAAkB;QACvB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAEM,SAAS,CAAC,OAA4B;QAC3C,IAAI,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5D,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YACtC,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YACtC,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,eAAe,CAAC,KAAa;QAClC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAEO,sBAAsB,CAG5B,IAAU,EAAE,eAAkD;QAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,WAA0B,CAAC;QAE/B,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;YACjC,WAAW,EAAE,GAAG,EAAE;gBAChB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CACvB,CAAC;gBACvB,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;gBAE1C,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;oBAC/D,OAAO,WAAW,CAAC;gBACrB,CAAC;gBAED,WAAW,GAAG,QAAQ,CAAC;gBACvB,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC"}
1
+ {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/adaptor.ts"],"names":[],"mappings":"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"}
@@ -1,43 +1,26 @@
1
- import type { McpUiHostContext, McpUiInitializeRequest } from "@modelcontextprotocol/ext-apps";
1
+ import { App } from "@modelcontextprotocol/ext-apps";
2
+ import type { Implementation } from "@modelcontextprotocol/sdk/types.js";
2
3
  import type { Bridge, Subscribe } from "../types.js";
3
4
  import type { McpAppContext, McpAppContextKey } from "./types.js";
4
- type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
5
- export declare class McpAppBridge implements Bridge<McpUiHostContext> {
5
+ export declare class McpAppBridge implements Bridge<McpAppContext> {
6
6
  private static instance;
7
7
  context: McpAppContext;
8
8
  private listeners;
9
- private pendingRequests;
10
- private nextId;
11
- private initialized;
12
- private appInitializationOptions;
13
- private requestTimeout;
14
- private cleanupSizeObserver;
15
- constructor(options: McpAppInitializationOptions, requestTimeout?: number);
16
- static getInstance(options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpAppBridge;
9
+ private app;
10
+ private connectPromise;
11
+ constructor(options: {
12
+ appInfo: Implementation;
13
+ });
14
+ private connect;
15
+ getApp(): Promise<App>;
16
+ static getInstance(options?: Partial<{
17
+ appInfo: Implementation;
18
+ }>): McpAppBridge;
17
19
  subscribe(key: McpAppContextKey): Subscribe;
18
20
  subscribe(keys: readonly McpAppContextKey[]): Subscribe;
19
21
  getSnapshot<K extends keyof McpAppContext>(key: K): McpAppContext[K];
20
22
  cleanup: () => void;
21
23
  static resetInstance(): void;
22
- request<R extends {
23
- method: string;
24
- params?: unknown;
25
- }, T>({ method, params, }: R): Promise<T>;
26
24
  private emit;
27
25
  private updateContext;
28
- private init;
29
- private handleMessage;
30
- private handleResponse;
31
- private handleNotification;
32
- private handleRequest;
33
- private connect;
34
- private notify;
35
- private sendSizeChanged;
36
- /**
37
- * Set up automatic size change notifications using ResizeObserver.
38
- * Based on @modelcontextprotocol/ext-apps App.setupSizeChangedNotifications
39
- * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/src/app.ts#L940-L989
40
- */
41
- private setupSizeChangedNotifications;
42
26
  }
43
- export {};