skybridge 0.0.0-dev.d42daf9 → 0.0.0-dev.d4358f5

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 (295) hide show
  1. package/README.md +148 -0
  2. package/bin/run.js +0 -4
  3. package/dist/cli/detect-port.d.ts +18 -0
  4. package/dist/cli/detect-port.js +61 -0
  5. package/dist/cli/detect-port.js.map +1 -0
  6. package/dist/cli/header.js +1 -1
  7. package/dist/cli/header.js.map +1 -1
  8. package/dist/cli/run-command.js.map +1 -1
  9. package/dist/cli/telemetry.d.ts +7 -0
  10. package/dist/cli/telemetry.js +123 -0
  11. package/dist/cli/telemetry.js.map +1 -0
  12. package/dist/cli/tunnel-control-server.d.ts +9 -0
  13. package/dist/cli/tunnel-control-server.js +31 -0
  14. package/dist/cli/tunnel-control-server.js.map +1 -0
  15. package/dist/cli/tunnel-control-server.test.js +39 -0
  16. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  17. package/dist/cli/tunnel-handler.d.ts +3 -0
  18. package/dist/cli/tunnel-handler.js +48 -0
  19. package/dist/cli/tunnel-handler.js.map +1 -0
  20. package/dist/cli/tunnel-handler.test.js +105 -0
  21. package/dist/cli/tunnel-handler.test.js.map +1 -0
  22. package/dist/cli/tunnel.d.ts +57 -0
  23. package/dist/cli/tunnel.js +154 -0
  24. package/dist/cli/tunnel.js.map +1 -0
  25. package/dist/cli/tunnel.test.js +190 -0
  26. package/dist/cli/tunnel.test.js.map +1 -0
  27. package/dist/cli/types.d.ts +5 -0
  28. package/dist/cli/types.js +2 -0
  29. package/dist/cli/types.js.map +1 -0
  30. package/dist/cli/use-execute-steps.d.ts +3 -2
  31. package/dist/cli/use-execute-steps.js +6 -1
  32. package/dist/cli/use-execute-steps.js.map +1 -1
  33. package/dist/cli/use-messages.d.ts +3 -0
  34. package/dist/cli/use-messages.js +11 -0
  35. package/dist/cli/use-messages.js.map +1 -0
  36. package/dist/cli/use-nodemon.d.ts +2 -0
  37. package/dist/cli/use-nodemon.js +73 -0
  38. package/dist/cli/use-nodemon.js.map +1 -0
  39. package/dist/cli/use-open-browser.d.ts +1 -0
  40. package/dist/cli/use-open-browser.js +44 -0
  41. package/dist/cli/use-open-browser.js.map +1 -0
  42. package/dist/cli/use-tunnel.d.ts +14 -0
  43. package/dist/cli/use-tunnel.js +131 -0
  44. package/dist/cli/use-tunnel.js.map +1 -0
  45. package/dist/cli/use-typescript-check.d.ts +9 -0
  46. package/dist/cli/use-typescript-check.js +94 -0
  47. package/dist/cli/use-typescript-check.js.map +1 -0
  48. package/dist/commands/build.js +64 -6
  49. package/dist/commands/build.js.map +1 -1
  50. package/dist/commands/dev.d.ts +6 -1
  51. package/dist/commands/dev.js +69 -9
  52. package/dist/commands/dev.js.map +1 -1
  53. package/dist/commands/start.d.ts +3 -1
  54. package/dist/commands/start.js +31 -15
  55. package/dist/commands/start.js.map +1 -1
  56. package/dist/commands/telemetry/disable.d.ts +5 -0
  57. package/dist/commands/telemetry/disable.js +14 -0
  58. package/dist/commands/telemetry/disable.js.map +1 -0
  59. package/dist/commands/telemetry/enable.d.ts +5 -0
  60. package/dist/commands/telemetry/enable.js +14 -0
  61. package/dist/commands/telemetry/enable.js.map +1 -0
  62. package/dist/commands/telemetry/status.d.ts +5 -0
  63. package/dist/commands/telemetry/status.js +14 -0
  64. package/dist/commands/telemetry/status.js.map +1 -0
  65. package/dist/server/asset-base-url-transform-plugin.d.ts +10 -0
  66. package/dist/server/asset-base-url-transform-plugin.js +33 -0
  67. package/dist/server/asset-base-url-transform-plugin.js.map +1 -0
  68. package/dist/server/asset-base-url-transform-plugin.test.d.ts +1 -0
  69. package/dist/server/asset-base-url-transform-plugin.test.js +84 -0
  70. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -0
  71. package/dist/server/content-helpers.d.ts +27 -0
  72. package/dist/server/content-helpers.js +46 -0
  73. package/dist/server/content-helpers.js.map +1 -0
  74. package/dist/server/content-helpers.test.d.ts +1 -0
  75. package/dist/server/content-helpers.test.js +70 -0
  76. package/dist/server/content-helpers.test.js.map +1 -0
  77. package/dist/server/express.d.ts +11 -0
  78. package/dist/server/express.js +101 -0
  79. package/dist/server/express.js.map +1 -0
  80. package/dist/server/express.test.d.ts +1 -0
  81. package/dist/server/express.test.js +430 -0
  82. package/dist/server/express.test.js.map +1 -0
  83. package/dist/server/index.d.ts +5 -3
  84. package/dist/server/index.js +3 -2
  85. package/dist/server/index.js.map +1 -1
  86. package/dist/server/inferUtilityTypes.d.ts +6 -6
  87. package/dist/server/inferUtilityTypes.js.map +1 -1
  88. package/dist/server/metric.d.ts +14 -0
  89. package/dist/server/metric.js +62 -0
  90. package/dist/server/metric.js.map +1 -0
  91. package/dist/server/middleware.d.ts +124 -0
  92. package/dist/server/middleware.js +93 -0
  93. package/dist/server/middleware.js.map +1 -0
  94. package/dist/server/middleware.test-d.d.ts +1 -0
  95. package/dist/server/middleware.test-d.js +75 -0
  96. package/dist/server/middleware.test-d.js.map +1 -0
  97. package/dist/server/middleware.test.d.ts +1 -0
  98. package/dist/server/middleware.test.js +493 -0
  99. package/dist/server/middleware.test.js.map +1 -0
  100. package/dist/server/server.d.ts +160 -63
  101. package/dist/server/server.js +393 -63
  102. package/dist/server/server.js.map +1 -1
  103. package/dist/server/templateHelper.d.ts +5 -7
  104. package/dist/server/templateHelper.js +3 -22
  105. package/dist/server/templateHelper.js.map +1 -1
  106. package/dist/server/templates.generated.d.ts +4 -0
  107. package/dist/server/templates.generated.js +47 -0
  108. package/dist/server/templates.generated.js.map +1 -0
  109. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  110. package/dist/server/tunnel-proxy-router.js +110 -0
  111. package/dist/server/tunnel-proxy-router.js.map +1 -0
  112. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  113. package/dist/server/tunnel-proxy-router.test.js +229 -0
  114. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  115. package/dist/server/viewsDevServer.d.ts +14 -0
  116. package/dist/server/viewsDevServer.js +45 -0
  117. package/dist/server/viewsDevServer.js.map +1 -0
  118. package/dist/test/utils.d.ts +13 -21
  119. package/dist/test/utils.js +42 -37
  120. package/dist/test/utils.js.map +1 -1
  121. package/dist/test/view.test.d.ts +1 -0
  122. package/dist/test/view.test.js +523 -0
  123. package/dist/test/view.test.js.map +1 -0
  124. package/dist/version.d.ts +1 -0
  125. package/dist/version.js +3 -0
  126. package/dist/version.js.map +1 -0
  127. package/dist/web/bridges/apps-sdk/adaptor.d.ts +16 -6
  128. package/dist/web/bridges/apps-sdk/adaptor.js +65 -8
  129. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -1
  130. package/dist/web/bridges/apps-sdk/bridge.d.ts +5 -5
  131. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -1
  132. package/dist/web/bridges/apps-sdk/index.d.ts +2 -2
  133. package/dist/web/bridges/apps-sdk/index.js +1 -1
  134. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  135. package/dist/web/bridges/apps-sdk/types.d.ts +38 -28
  136. package/dist/web/bridges/apps-sdk/types.js.map +1 -1
  137. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +2 -0
  138. package/dist/web/bridges/apps-sdk/{use-apps-sdk-bridge.js → use-apps-sdk-context.js} +2 -2
  139. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -0
  140. package/dist/web/bridges/get-adaptor.js.map +1 -1
  141. package/dist/web/bridges/index.js.map +1 -1
  142. package/dist/web/bridges/mcp-app/adaptor.d.ts +37 -8
  143. package/dist/web/bridges/mcp-app/adaptor.js +174 -56
  144. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -1
  145. package/dist/web/bridges/mcp-app/bridge.d.ts +18 -35
  146. package/dist/web/bridges/mcp-app/bridge.js +43 -197
  147. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  148. package/dist/web/bridges/mcp-app/index.d.ts +2 -2
  149. package/dist/web/bridges/mcp-app/index.js +1 -1
  150. package/dist/web/bridges/mcp-app/index.js.map +1 -1
  151. package/dist/web/bridges/mcp-app/types.d.ts +2 -2
  152. package/dist/web/bridges/mcp-app/types.js.map +1 -1
  153. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +7 -0
  154. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +7 -0
  155. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -0
  156. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.d.ts +1 -0
  157. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +26 -0
  158. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -0
  159. package/dist/web/bridges/types.d.ts +49 -12
  160. package/dist/web/bridges/types.js.map +1 -1
  161. package/dist/web/bridges/use-host-context.js.map +1 -1
  162. package/dist/web/components/modal-provider.d.ts +4 -0
  163. package/dist/web/components/modal-provider.js +45 -0
  164. package/dist/web/components/modal-provider.js.map +1 -0
  165. package/dist/web/create-store.js +17 -3
  166. package/dist/web/create-store.js.map +1 -1
  167. package/dist/web/create-store.test.js +25 -21
  168. package/dist/web/create-store.test.js.map +1 -1
  169. package/dist/web/data-llm.d.ts +1 -1
  170. package/dist/web/data-llm.js +3 -3
  171. package/dist/web/data-llm.js.map +1 -1
  172. package/dist/web/data-llm.test.js +33 -30
  173. package/dist/web/data-llm.test.js.map +1 -1
  174. package/dist/web/generate-helpers.d.ts +20 -18
  175. package/dist/web/generate-helpers.js +20 -18
  176. package/dist/web/generate-helpers.js.map +1 -1
  177. package/dist/web/generate-helpers.test-d.js +26 -26
  178. package/dist/web/generate-helpers.test-d.js.map +1 -1
  179. package/dist/web/generate-helpers.test.js.map +1 -1
  180. package/dist/web/helpers/state.d.ts +2 -2
  181. package/dist/web/helpers/state.js +11 -11
  182. package/dist/web/helpers/state.js.map +1 -1
  183. package/dist/web/helpers/state.test.js +9 -9
  184. package/dist/web/helpers/state.test.js.map +1 -1
  185. package/dist/web/hooks/index.d.ts +3 -2
  186. package/dist/web/hooks/index.js +2 -1
  187. package/dist/web/hooks/index.js.map +1 -1
  188. package/dist/web/hooks/test/utils.js +4 -0
  189. package/dist/web/hooks/test/utils.js.map +1 -1
  190. package/dist/web/hooks/use-call-tool.js.map +1 -1
  191. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -1
  192. package/dist/web/hooks/use-call-tool.test.js +0 -4
  193. package/dist/web/hooks/use-call-tool.test.js.map +1 -1
  194. package/dist/web/hooks/use-display-mode.d.ts +3 -3
  195. package/dist/web/hooks/use-display-mode.js.map +1 -1
  196. package/dist/web/hooks/use-display-mode.test-d.d.ts +1 -0
  197. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  198. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  199. package/dist/web/hooks/use-display-mode.test.js.map +1 -1
  200. package/dist/web/hooks/use-files.d.ts +3 -6
  201. package/dist/web/hooks/use-files.js +5 -2
  202. package/dist/web/hooks/use-files.js.map +1 -1
  203. package/dist/web/hooks/use-files.test.js +28 -3
  204. package/dist/web/hooks/use-files.test.js.map +1 -1
  205. package/dist/web/hooks/use-layout.d.ts +1 -1
  206. package/dist/web/hooks/use-layout.js.map +1 -1
  207. package/dist/web/hooks/use-layout.test.js +5 -4
  208. package/dist/web/hooks/use-layout.test.js.map +1 -1
  209. package/dist/web/hooks/use-open-external.d.ts +3 -1
  210. package/dist/web/hooks/use-open-external.js +1 -1
  211. package/dist/web/hooks/use-open-external.js.map +1 -1
  212. package/dist/web/hooks/use-open-external.test.js +26 -11
  213. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  214. package/dist/web/hooks/use-request-modal.d.ts +3 -3
  215. package/dist/web/hooks/use-request-modal.js +10 -8
  216. package/dist/web/hooks/use-request-modal.js.map +1 -1
  217. package/dist/web/hooks/use-request-modal.test.js +5 -1
  218. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  219. package/dist/web/hooks/use-send-follow-up-message.d.ts +2 -1
  220. package/dist/web/hooks/use-send-follow-up-message.js +2 -2
  221. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -1
  222. package/dist/web/hooks/use-set-open-in-app-url.d.ts +1 -0
  223. package/dist/web/hooks/use-set-open-in-app-url.js +8 -0
  224. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -0
  225. package/dist/web/hooks/use-set-open-in-app-url.test.d.ts +1 -0
  226. package/dist/web/hooks/use-set-open-in-app-url.test.js +43 -0
  227. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -0
  228. package/dist/web/hooks/use-tool-info.js.map +1 -1
  229. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -1
  230. package/dist/web/hooks/use-tool-info.test.js +3 -2
  231. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  232. package/dist/web/hooks/use-user.js +18 -2
  233. package/dist/web/hooks/use-user.js.map +1 -1
  234. package/dist/web/hooks/use-user.test.js +31 -2
  235. package/dist/web/hooks/use-user.test.js.map +1 -1
  236. package/dist/web/hooks/use-view-state.d.ts +4 -0
  237. package/dist/web/hooks/use-view-state.js +32 -0
  238. package/dist/web/hooks/use-view-state.js.map +1 -0
  239. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  240. package/dist/web/hooks/use-view-state.test.js +177 -0
  241. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  242. package/dist/web/index.d.ts +1 -2
  243. package/dist/web/index.js +1 -2
  244. package/dist/web/index.js.map +1 -1
  245. package/dist/web/mount-view.d.ts +1 -0
  246. package/dist/web/{mount-widget.js → mount-view.js} +11 -3
  247. package/dist/web/mount-view.js.map +1 -0
  248. package/dist/web/plugin/data-llm.test.js.map +1 -1
  249. package/dist/web/plugin/plugin.d.ts +4 -1
  250. package/dist/web/plugin/plugin.js +135 -18
  251. package/dist/web/plugin/plugin.js.map +1 -1
  252. package/dist/web/plugin/scan-views.d.ts +16 -0
  253. package/dist/web/plugin/scan-views.js +88 -0
  254. package/dist/web/plugin/scan-views.js.map +1 -0
  255. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  256. package/dist/web/plugin/scan-views.test.js +99 -0
  257. package/dist/web/plugin/scan-views.test.js.map +1 -0
  258. package/dist/web/plugin/transform-data-llm.js +1 -1
  259. package/dist/web/plugin/transform-data-llm.js.map +1 -1
  260. package/dist/web/plugin/transform-data-llm.test.js.map +1 -1
  261. package/dist/web/plugin/validate-view.d.ts +1 -0
  262. package/dist/web/plugin/validate-view.js +9 -0
  263. package/dist/web/plugin/validate-view.js.map +1 -0
  264. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  265. package/dist/web/plugin/validate-view.test.js +24 -0
  266. package/dist/web/plugin/validate-view.test.js.map +1 -0
  267. package/dist/web/proxy.js +0 -1
  268. package/dist/web/proxy.js.map +1 -1
  269. package/dist/web/types.js.map +1 -1
  270. package/package.json +52 -31
  271. package/tsconfig.base.json +33 -0
  272. package/dist/server/templates/development.hbs +0 -66
  273. package/dist/server/templates/production.hbs +0 -7
  274. package/dist/server/widgetsDevServer.d.ts +0 -12
  275. package/dist/server/widgetsDevServer.js +0 -47
  276. package/dist/server/widgetsDevServer.js.map +0 -1
  277. package/dist/test/widget.test.js +0 -255
  278. package/dist/test/widget.test.js.map +0 -1
  279. package/dist/web/bridges/apps-sdk/use-apps-sdk-bridge.d.ts +0 -2
  280. package/dist/web/bridges/apps-sdk/use-apps-sdk-bridge.js.map +0 -1
  281. package/dist/web/bridges/mcp-app/use-mcp-app-bridge.d.ts +0 -5
  282. package/dist/web/bridges/mcp-app/use-mcp-app-bridge.js +0 -7
  283. package/dist/web/bridges/mcp-app/use-mcp-app-bridge.js.map +0 -1
  284. package/dist/web/bridges/mcp-app/use-mcp-app-bridge.test.js +0 -57
  285. package/dist/web/bridges/mcp-app/use-mcp-app-bridge.test.js.map +0 -1
  286. package/dist/web/hooks/use-widget-state.d.ts +0 -4
  287. package/dist/web/hooks/use-widget-state.js +0 -32
  288. package/dist/web/hooks/use-widget-state.js.map +0 -1
  289. package/dist/web/hooks/use-widget-state.test.js +0 -61
  290. package/dist/web/hooks/use-widget-state.test.js.map +0 -1
  291. package/dist/web/mount-widget.d.ts +0 -1
  292. package/dist/web/mount-widget.js.map +0 -1
  293. /package/dist/{test/widget.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  294. /package/dist/{web/bridges/mcp-app/use-mcp-app-bridge.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
  295. /package/dist/{web/hooks/use-widget-state.test.d.ts → cli/tunnel.test.d.ts} +0 -0
@@ -1,12 +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();
18
+ _viewState = null;
19
+ viewStateListeners = new Set();
20
+ _viewUUID = null;
21
+ _displayState = {
22
+ mode: "inline",
23
+ };
24
+ displayListeners = new Set();
8
25
  constructor() {
9
26
  this.stores = this.initializeStores();
27
+ this.subscribeToViewUUID();
10
28
  }
11
29
  static getInstance() {
12
30
  if (!McpAppAdaptor.instance) {
@@ -21,56 +39,43 @@ export class McpAppAdaptor {
21
39
  return this.stores[key];
22
40
  }
23
41
  callTool = async (name, args) => {
24
- const bridge = McpAppBridge.getInstance();
25
- const response = await bridge.request({
26
- method: "tools/call",
27
- params: {
28
- name,
29
- arguments: args ?? undefined,
30
- },
42
+ const app = await McpAppBridge.getInstance().getApp();
43
+ const response = await app.callServerTool({
44
+ name,
45
+ arguments: args ?? undefined,
31
46
  });
32
- const result = response.content
33
- .filter((content) => content.type === "text")
34
- .map(({ text }) => text)
35
- .join("\n");
36
47
  return {
37
48
  content: response.content,
38
49
  structuredContent: response.structuredContent ?? {},
39
50
  isError: response.isError ?? false,
40
- result,
41
51
  meta: response._meta ?? {},
42
52
  };
43
53
  };
44
- requestDisplayMode = (mode) => {
45
- const bridge = McpAppBridge.getInstance();
46
- if (mode !== "modal") {
47
- return bridge.request({
48
- method: "ui/request-display-mode",
49
- params: { mode },
50
- });
51
- }
52
- throw new Error("Modal display mode is not accessible in MCP App.");
54
+ requestDisplayMode = async (mode) => {
55
+ const app = await McpAppBridge.getInstance().getApp();
56
+ return app.requestDisplayMode({ mode });
53
57
  };
54
- sendFollowUpMessage = async (prompt) => {
55
- const bridge = McpAppBridge.getInstance();
56
- await bridge.request({
57
- method: "ui/message",
58
- params: {
59
- role: "user",
60
- content: [
61
- {
62
- type: "text",
63
- text: prompt,
64
- },
65
- ],
66
- },
58
+ sendFollowUpMessage = async (prompt, _options) => {
59
+ const app = await McpAppBridge.getInstance().getApp();
60
+ await app.sendMessage({
61
+ role: "user",
62
+ content: [
63
+ {
64
+ type: "text",
65
+ text: prompt,
66
+ },
67
+ ],
67
68
  });
68
69
  };
69
- openExternal(href) {
70
- const bridge = McpAppBridge.getInstance();
71
- bridge.request({
72
- method: "ui/open-link",
73
- params: { url: href },
70
+ openExternal(href, options) {
71
+ if (options?.redirectUrl === false) {
72
+ console.warn("[skybridge] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.");
73
+ }
74
+ McpAppBridge.getInstance()
75
+ .getApp()
76
+ .then((app) => app.openLink({ url: href }))
77
+ .catch((err) => {
78
+ console.error("Failed to open external link:", err);
74
79
  });
75
80
  }
76
81
  initializeStores() {
@@ -83,9 +88,9 @@ export class McpAppAdaptor {
83
88
  displayMode: this.createHostContextStore(["displayMode"], ({ displayMode }) => displayMode ?? "inline"),
84
89
  maxHeight: this.createHostContextStore(["containerDimensions"], ({ containerDimensions }) => {
85
90
  if (containerDimensions && "maxHeight" in containerDimensions) {
86
- return containerDimensions.maxHeight ?? window.innerHeight;
91
+ return containerDimensions.maxHeight;
87
92
  }
88
- return window.innerHeight;
93
+ return undefined;
89
94
  }),
90
95
  userAgent: this.createHostContextStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
91
96
  device: {
@@ -100,31 +105,144 @@ export class McpAppAdaptor {
100
105
  toolInput: this.createHostContextStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
101
106
  toolOutput: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
102
107
  toolResponseMetadata: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
103
- widgetState: {
108
+ display: {
104
109
  subscribe: (onChange) => {
105
- this.widgetStateListeners.add(onChange);
110
+ this.displayListeners.add(onChange);
106
111
  return () => {
107
- this.widgetStateListeners.delete(onChange);
112
+ this.displayListeners.delete(onChange);
108
113
  };
109
114
  },
110
- getSnapshot: () => this._widgetState,
115
+ getSnapshot: () => this._displayState,
116
+ },
117
+ viewState: {
118
+ subscribe: (onChange) => {
119
+ this.viewStateListeners.add(onChange);
120
+ return () => {
121
+ this.viewStateListeners.delete(onChange);
122
+ };
123
+ },
124
+ getSnapshot: () => this._viewState,
111
125
  },
112
126
  };
113
127
  }
114
- setWidgetState = async (stateOrUpdater) => {
128
+ setViewState = async (stateOrUpdater) => {
115
129
  const newState = typeof stateOrUpdater === "function"
116
- ? stateOrUpdater(this._widgetState)
130
+ ? stateOrUpdater(this._viewState)
117
131
  : stateOrUpdater;
118
- const bridge = McpAppBridge.getInstance();
119
- await bridge.request({
120
- method: "ui/update-model-context",
121
- params: { structuredContent: newState },
122
- });
123
- this._widgetState = newState;
124
- this.widgetStateListeners.forEach((listener) => {
132
+ // must happen before the async bridge call to ensure the state is updated immediately for the UI,
133
+ // otherwise successive calls to setViewState may have stale state
134
+ this._viewState = newState;
135
+ this.viewStateListeners.forEach((listener) => {
125
136
  listener();
126
137
  });
138
+ this.persistToLocalStorage(newState);
139
+ try {
140
+ const app = await McpAppBridge.getInstance().getApp();
141
+ await app.updateModelContext({
142
+ structuredContent: newState,
143
+ content: [{ type: "text", text: JSON.stringify(newState) }],
144
+ });
145
+ }
146
+ catch (error) {
147
+ console.error("Failed to update view state in MCP App.", error);
148
+ }
127
149
  };
150
+ /**
151
+ * @throws File upload is not supported in MCP App.
152
+ */
153
+ uploadFile() {
154
+ throw new Error("File upload is not supported in MCP App.");
155
+ }
156
+ /**
157
+ * @throws File download is not supported in MCP App.
158
+ */
159
+ getFileDownloadUrl() {
160
+ throw new Error("File download is not supported in MCP App.");
161
+ }
162
+ /**
163
+ * @throws File selection is not supported in MCP App.
164
+ */
165
+ selectFiles() {
166
+ throw new Error("File selection is not supported in MCP App.");
167
+ }
168
+ openModal(options) {
169
+ this._displayState = { mode: "modal", params: options.params };
170
+ this.displayListeners.forEach((listener) => {
171
+ listener();
172
+ });
173
+ }
174
+ closeModal() {
175
+ this._displayState = { mode: "inline" };
176
+ this.displayListeners.forEach((listener) => {
177
+ listener();
178
+ });
179
+ }
180
+ setOpenInAppUrl(_href) {
181
+ throw new Error("setOpenInAppUrl is not implemented in MCP App.");
182
+ }
183
+ subscribeToViewUUID() {
184
+ const bridge = McpAppBridge.getInstance();
185
+ bridge.subscribe("toolResult")(() => {
186
+ const toolResult = bridge.getSnapshot("toolResult");
187
+ const viewUUID = toolResult?._meta?.viewUUID;
188
+ if (viewUUID && viewUUID !== this._viewUUID) {
189
+ this._viewUUID = viewUUID;
190
+ this.restoreFromLocalStorage(viewUUID);
191
+ }
192
+ });
193
+ }
194
+ // localStorage keys: sb:{unix_ms}:{viewUUID}
195
+ // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.
196
+ restoreFromLocalStorage(viewUUID) {
197
+ try {
198
+ const existingKey = findStorageKey(viewUUID);
199
+ if (existingKey) {
200
+ const stored = localStorage.getItem(existingKey);
201
+ if (stored !== null) {
202
+ this._viewState = JSON.parse(stored);
203
+ this.viewStateListeners.forEach((listener) => {
204
+ listener();
205
+ });
206
+ }
207
+ }
208
+ }
209
+ catch (err) {
210
+ console.error(err);
211
+ }
212
+ }
213
+ persistToLocalStorage(state) {
214
+ if (!this._viewUUID || state === null) {
215
+ return;
216
+ }
217
+ try {
218
+ // Remove old key for this view, write with fresh timestamp (LRU)
219
+ const oldKey = findStorageKey(this._viewUUID);
220
+ if (oldKey) {
221
+ localStorage.removeItem(oldKey);
222
+ }
223
+ const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
224
+ localStorage.setItem(newKey, JSON.stringify(state));
225
+ // lru cleanup
226
+ const keys = [];
227
+ for (let i = 0; i < localStorage.length; i++) {
228
+ const key = localStorage.key(i);
229
+ if (key?.startsWith(STORAGE_PREFIX)) {
230
+ keys.push(key);
231
+ }
232
+ }
233
+ if (keys.length <= MAX_STORAGE_ENTRIES) {
234
+ return;
235
+ }
236
+ keys.sort();
237
+ const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);
238
+ for (const key of toRemove) {
239
+ localStorage.removeItem(key);
240
+ }
241
+ }
242
+ catch (err) {
243
+ console.error(err);
244
+ }
245
+ }
128
246
  createHostContextStore(keys, computeSnapshot) {
129
247
  const bridge = McpAppBridge.getInstance();
130
248
  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;AASrC,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;IAErD;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,IAAI,MAAM,CAAC,WAAW,CAAC;gBAC7D,CAAC;gBAED,OAAO,MAAM,CAAC,WAAW,CAAC;YAC5B,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,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;IAEM,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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","sourcesContent":["import { dequal } from \"dequal/lite\";\nimport type {\n Adaptor,\n CallToolResponse,\n HostContext,\n HostContextStore,\n OpenExternalOptions,\n RequestDisplayMode,\n RequestModalOptions,\n SendFollowUpMessageOptions,\n SetViewStateAction,\n} from \"../types.js\";\nimport { McpAppBridge } from \"./bridge.js\";\nimport type { McpAppContext, McpAppContextKey } from \"./types.js\";\n\ntype PickContext<K extends readonly McpAppContextKey[]> = {\n [P in K[number]]: McpAppContext[P];\n};\n\nconst STORAGE_PREFIX = \"sb:\";\nconst MAX_STORAGE_ENTRIES = 200;\n\nfunction findStorageKey(viewUUID: string): string | undefined {\n const suffix = `:${viewUUID}`;\n for (let i = 0; i < localStorage.length; i++) {\n const key = localStorage.key(i);\n if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {\n return key;\n }\n }\n return undefined;\n}\n\nexport class McpAppAdaptor implements Adaptor {\n private static instance: McpAppAdaptor | null = null;\n private stores: {\n [K in keyof HostContext]: HostContextStore<K>;\n };\n private _viewState: HostContext[\"viewState\"] = null;\n private viewStateListeners = new Set<() => void>();\n private _viewUUID: string | null = null;\n\n private _displayState: HostContext[\"display\"] = {\n mode: \"inline\",\n };\n private displayListeners = new Set<() => void>();\n\n private constructor() {\n this.stores = this.initializeStores();\n this.subscribeToViewUUID();\n }\n\n public static getInstance(): McpAppAdaptor {\n if (!McpAppAdaptor.instance) {\n McpAppAdaptor.instance = new McpAppAdaptor();\n }\n return McpAppAdaptor.instance;\n }\n\n public static resetInstance(): void {\n McpAppAdaptor.instance = null;\n }\n\n public getHostContextStore<K extends keyof HostContext>(\n key: K,\n ): HostContextStore<K> {\n return this.stores[key];\n }\n\n public callTool = async <\n ToolArgs extends Record<string, unknown> | null = null,\n ToolResponse extends CallToolResponse = CallToolResponse,\n >(\n name: string,\n args: ToolArgs,\n ): Promise<ToolResponse> => {\n const app = await McpAppBridge.getInstance().getApp();\n const response = await app.callServerTool({\n name,\n arguments: args ?? undefined,\n });\n\n return {\n content: response.content,\n structuredContent: response.structuredContent ?? {},\n isError: response.isError ?? false,\n meta: response._meta ?? {},\n } as ToolResponse;\n };\n\n public requestDisplayMode = async (mode: RequestDisplayMode) => {\n const app = await McpAppBridge.getInstance().getApp();\n return app.requestDisplayMode({ mode });\n };\n\n public sendFollowUpMessage = async (\n prompt: string,\n _options?: SendFollowUpMessageOptions,\n ) => {\n const app = await McpAppBridge.getInstance().getApp();\n await app.sendMessage({\n role: \"user\",\n content: [\n {\n type: \"text\",\n text: prompt,\n },\n ],\n });\n };\n\n public openExternal(href: string, options?: OpenExternalOptions): void {\n if (options?.redirectUrl === false) {\n console.warn(\n \"[skybridge] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.\",\n );\n }\n\n McpAppBridge.getInstance()\n .getApp()\n .then((app) => app.openLink({ url: href }))\n .catch((err) => {\n console.error(\"Failed to open external link:\", err);\n });\n }\n\n private initializeStores(): {\n [K in keyof HostContext]: HostContextStore<K>;\n } {\n return {\n theme: this.createHostContextStore(\n [\"theme\"],\n ({ theme }) => theme ?? \"light\",\n ),\n locale: this.createHostContextStore(\n [\"locale\"],\n ({ locale }) => locale ?? \"en-US\",\n ),\n safeArea: this.createHostContextStore(\n [\"safeAreaInsets\"],\n ({ safeAreaInsets }) => ({\n insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },\n }),\n ),\n displayMode: this.createHostContextStore(\n [\"displayMode\"],\n ({ displayMode }) => displayMode ?? \"inline\",\n ),\n maxHeight: this.createHostContextStore(\n [\"containerDimensions\"],\n ({ containerDimensions }) => {\n if (containerDimensions && \"maxHeight\" in containerDimensions) {\n return containerDimensions.maxHeight;\n }\n\n return undefined;\n },\n ),\n userAgent: this.createHostContextStore(\n [\"platform\", \"deviceCapabilities\"],\n ({ platform, deviceCapabilities }) => ({\n device: {\n type: platform === \"web\" ? \"desktop\" : (platform ?? \"unknown\"),\n },\n capabilities: {\n hover: true,\n touch: true,\n ...deviceCapabilities,\n },\n }),\n ),\n toolInput: this.createHostContextStore(\n [\"toolInput\"],\n ({ toolInput }) => toolInput ?? null,\n ),\n toolOutput: this.createHostContextStore(\n [\"toolResult\"],\n ({ toolResult }) => toolResult?.structuredContent ?? null,\n ),\n toolResponseMetadata: this.createHostContextStore(\n [\"toolResult\"],\n ({ toolResult }) => toolResult?._meta ?? null,\n ),\n display: {\n subscribe: (onChange: () => void) => {\n this.displayListeners.add(onChange);\n return () => {\n this.displayListeners.delete(onChange);\n };\n },\n getSnapshot: () => this._displayState,\n },\n viewState: {\n subscribe: (onChange: () => void) => {\n this.viewStateListeners.add(onChange);\n return () => {\n this.viewStateListeners.delete(onChange);\n };\n },\n getSnapshot: () => this._viewState,\n },\n };\n }\n\n public setViewState = async (\n stateOrUpdater: SetViewStateAction,\n ): Promise<void> => {\n const newState =\n typeof stateOrUpdater === \"function\"\n ? stateOrUpdater(this._viewState)\n : stateOrUpdater;\n\n // must happen before the async bridge call to ensure the state is updated immediately for the UI,\n // otherwise successive calls to setViewState may have stale state\n this._viewState = newState;\n this.viewStateListeners.forEach((listener) => {\n listener();\n });\n\n this.persistToLocalStorage(newState);\n\n try {\n const app = await McpAppBridge.getInstance().getApp();\n await app.updateModelContext({\n structuredContent: newState,\n content: [{ type: \"text\", text: JSON.stringify(newState) }],\n });\n } catch (error) {\n console.error(\"Failed to update view state in MCP App.\", error);\n }\n };\n\n /**\n * @throws File upload is not supported in MCP App.\n */\n public uploadFile(): Promise<{ fileId: string }> {\n throw new Error(\"File upload is not supported in MCP App.\");\n }\n\n /**\n * @throws File download is not supported in MCP App.\n */\n public getFileDownloadUrl(): Promise<{ downloadUrl: string }> {\n throw new Error(\"File download is not supported in MCP App.\");\n }\n\n /**\n * @throws File selection is not supported in MCP App.\n */\n public selectFiles(): Promise<{ fileId: string }[]> {\n throw new Error(\"File selection is not supported in MCP App.\");\n }\n\n public openModal(options: RequestModalOptions) {\n this._displayState = { mode: \"modal\", params: options.params };\n this.displayListeners.forEach((listener) => {\n listener();\n });\n }\n\n public closeModal() {\n this._displayState = { mode: \"inline\" };\n this.displayListeners.forEach((listener) => {\n listener();\n });\n }\n\n public setOpenInAppUrl(_href: string): Promise<void> {\n throw new Error(\"setOpenInAppUrl is not implemented in MCP App.\");\n }\n\n private subscribeToViewUUID(): void {\n const bridge = McpAppBridge.getInstance();\n bridge.subscribe(\"toolResult\")(() => {\n const toolResult = bridge.getSnapshot(\"toolResult\");\n const viewUUID = (\n toolResult?._meta as Record<string, unknown> | undefined\n )?.viewUUID as string | undefined;\n\n if (viewUUID && viewUUID !== this._viewUUID) {\n this._viewUUID = viewUUID;\n this.restoreFromLocalStorage(viewUUID);\n }\n });\n }\n\n // localStorage keys: sb:{unix_ms}:{viewUUID}\n // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.\n private restoreFromLocalStorage(viewUUID: string): void {\n try {\n const existingKey = findStorageKey(viewUUID);\n if (existingKey) {\n const stored = localStorage.getItem(existingKey);\n if (stored !== null) {\n this._viewState = JSON.parse(stored);\n this.viewStateListeners.forEach((listener) => {\n listener();\n });\n }\n }\n } catch (err) {\n console.error(err);\n }\n }\n\n private persistToLocalStorage(state: Record<string, unknown> | null): void {\n if (!this._viewUUID || state === null) {\n return;\n }\n try {\n // Remove old key for this view, write with fresh timestamp (LRU)\n const oldKey = findStorageKey(this._viewUUID);\n if (oldKey) {\n localStorage.removeItem(oldKey);\n }\n const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;\n localStorage.setItem(newKey, JSON.stringify(state));\n\n // lru cleanup\n const keys: string[] = [];\n for (let i = 0; i < localStorage.length; i++) {\n const key = localStorage.key(i);\n if (key?.startsWith(STORAGE_PREFIX)) {\n keys.push(key);\n }\n }\n if (keys.length <= MAX_STORAGE_ENTRIES) {\n return;\n }\n keys.sort();\n const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);\n for (const key of toRemove) {\n localStorage.removeItem(key);\n }\n } catch (err) {\n console.error(err);\n }\n }\n\n private createHostContextStore<\n const Keys extends readonly McpAppContextKey[],\n R,\n >(keys: Keys, computeSnapshot: (context: PickContext<Keys>) => R) {\n const bridge = McpAppBridge.getInstance();\n let cachedValue: R | undefined;\n\n return {\n subscribe: bridge.subscribe(keys),\n getSnapshot: () => {\n const context = Object.fromEntries(\n keys.map((k) => [k, bridge.getSnapshot(k)]),\n ) as PickContext<Keys>;\n const newValue = computeSnapshot(context);\n\n if (cachedValue !== undefined && dequal(cachedValue, newValue)) {\n return cachedValue;\n }\n\n cachedValue = newValue;\n return newValue;\n },\n };\n }\n}\n"]}
@@ -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
- import type { McpAppBridgeContext, McpAppBridgeKey } from "./types.js";
4
- type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
5
- export declare class McpAppBridge implements Bridge<McpUiHostContext> {
4
+ import type { McpAppContext, McpAppContextKey } from "./types.js";
5
+ export declare class McpAppBridge implements Bridge<McpAppContext> {
6
6
  private static instance;
7
- context: McpAppBridgeContext;
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;
17
- subscribe(key: McpAppBridgeKey): Subscribe;
18
- subscribe(keys: readonly McpAppBridgeKey[]): Subscribe;
19
- getSnapshot<K extends keyof McpAppBridgeContext>(key: K): McpAppBridgeContext[K];
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;
19
+ subscribe(key: McpAppContextKey): Subscribe;
20
+ subscribe(keys: readonly McpAppContextKey[]): Subscribe;
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 {};