skybridge 0.0.0-dev.fecd520 → 0.0.0-dev.fef24cf

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