skybridge 0.0.0-dev.fd77b0f → 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 (442) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +153 -0
  3. package/bin/run.js +5 -0
  4. package/dist/cli/detect-port.d.ts +18 -0
  5. package/dist/cli/detect-port.js +61 -0
  6. package/dist/cli/detect-port.js.map +1 -0
  7. package/dist/cli/header.d.ts +4 -0
  8. package/dist/cli/header.js +6 -0
  9. package/dist/cli/header.js.map +1 -0
  10. package/dist/cli/run-command.d.ts +2 -0
  11. package/dist/cli/run-command.js +43 -0
  12. package/dist/cli/run-command.js.map +1 -0
  13. package/dist/cli/telemetry.d.ts +7 -0
  14. package/dist/cli/telemetry.js +123 -0
  15. package/dist/cli/telemetry.js.map +1 -0
  16. package/dist/cli/tunnel-control-server.d.ts +9 -0
  17. package/dist/cli/tunnel-control-server.js +31 -0
  18. package/dist/cli/tunnel-control-server.js.map +1 -0
  19. package/dist/cli/tunnel-control-server.test.js +39 -0
  20. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  21. package/dist/cli/tunnel-handler.d.ts +3 -0
  22. package/dist/cli/tunnel-handler.js +48 -0
  23. package/dist/cli/tunnel-handler.js.map +1 -0
  24. package/dist/cli/tunnel-handler.test.js +105 -0
  25. package/dist/cli/tunnel-handler.test.js.map +1 -0
  26. package/dist/cli/tunnel.d.ts +57 -0
  27. package/dist/cli/tunnel.js +154 -0
  28. package/dist/cli/tunnel.js.map +1 -0
  29. package/dist/cli/tunnel.test.js +190 -0
  30. package/dist/cli/tunnel.test.js.map +1 -0
  31. package/dist/cli/types.d.ts +5 -0
  32. package/dist/{src/web/bridges → cli}/types.js.map +1 -1
  33. package/dist/cli/use-execute-steps.d.ts +11 -0
  34. package/dist/cli/use-execute-steps.js +36 -0
  35. package/dist/cli/use-execute-steps.js.map +1 -0
  36. package/dist/cli/use-messages.d.ts +3 -0
  37. package/dist/cli/use-messages.js +11 -0
  38. package/dist/cli/use-messages.js.map +1 -0
  39. package/dist/cli/use-nodemon.d.ts +2 -0
  40. package/dist/cli/use-nodemon.js +64 -0
  41. package/dist/cli/use-nodemon.js.map +1 -0
  42. package/dist/cli/use-open-browser.d.ts +1 -0
  43. package/dist/cli/use-open-browser.js +44 -0
  44. package/dist/cli/use-open-browser.js.map +1 -0
  45. package/dist/cli/use-tunnel.d.ts +14 -0
  46. package/dist/cli/use-tunnel.js +131 -0
  47. package/dist/cli/use-tunnel.js.map +1 -0
  48. package/dist/cli/use-typescript-check.d.ts +9 -0
  49. package/dist/cli/use-typescript-check.js +94 -0
  50. package/dist/cli/use-typescript-check.js.map +1 -0
  51. package/dist/commands/build.d.ts +9 -0
  52. package/dist/commands/build.js +102 -0
  53. package/dist/commands/build.js.map +1 -0
  54. package/dist/commands/dev.d.ts +12 -0
  55. package/dist/commands/dev.js +80 -0
  56. package/dist/commands/dev.js.map +1 -0
  57. package/dist/commands/start.d.ts +9 -0
  58. package/dist/commands/start.js +49 -0
  59. package/dist/commands/start.js.map +1 -0
  60. package/dist/commands/telemetry/disable.d.ts +5 -0
  61. package/dist/commands/telemetry/disable.js +14 -0
  62. package/dist/commands/telemetry/disable.js.map +1 -0
  63. package/dist/commands/telemetry/enable.d.ts +5 -0
  64. package/dist/commands/telemetry/enable.js +14 -0
  65. package/dist/commands/telemetry/enable.js.map +1 -0
  66. package/dist/commands/telemetry/status.d.ts +5 -0
  67. package/dist/commands/telemetry/status.js +14 -0
  68. package/dist/commands/telemetry/status.js.map +1 -0
  69. package/dist/server/asset-base-url-transform-plugin.d.ts +10 -0
  70. package/dist/server/asset-base-url-transform-plugin.js +33 -0
  71. package/dist/server/asset-base-url-transform-plugin.js.map +1 -0
  72. package/dist/server/asset-base-url-transform-plugin.test.js +84 -0
  73. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -0
  74. package/dist/server/content-helpers.d.ts +27 -0
  75. package/dist/server/content-helpers.js +46 -0
  76. package/dist/server/content-helpers.js.map +1 -0
  77. package/dist/server/content-helpers.test.js +70 -0
  78. package/dist/server/content-helpers.test.js.map +1 -0
  79. package/dist/server/express.d.ts +11 -0
  80. package/dist/server/express.js +101 -0
  81. package/dist/server/express.js.map +1 -0
  82. package/dist/server/express.test.js +430 -0
  83. package/dist/server/express.test.js.map +1 -0
  84. package/dist/server/index.d.ts +6 -0
  85. package/dist/server/index.js +4 -0
  86. package/dist/server/index.js.map +1 -0
  87. package/dist/{src/server → server}/inferUtilityTypes.d.ts +6 -6
  88. package/dist/server/inferUtilityTypes.js.map +1 -0
  89. package/dist/server/metric.d.ts +14 -0
  90. package/dist/server/metric.js +62 -0
  91. package/dist/server/metric.js.map +1 -0
  92. package/dist/server/middleware.d.ts +124 -0
  93. package/dist/server/middleware.js +93 -0
  94. package/dist/server/middleware.js.map +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.js +493 -0
  98. package/dist/server/middleware.test.js.map +1 -0
  99. package/dist/server/server.d.ts +196 -0
  100. package/dist/server/server.js +468 -0
  101. package/dist/server/server.js.map +1 -0
  102. package/dist/{src/server → server}/templateHelper.d.ts +5 -7
  103. package/dist/server/templateHelper.js +11 -0
  104. package/dist/server/templateHelper.js.map +1 -0
  105. package/dist/server/templates.generated.d.ts +4 -0
  106. package/dist/server/templates.generated.js +47 -0
  107. package/dist/server/templates.generated.js.map +1 -0
  108. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  109. package/dist/server/tunnel-proxy-router.js +110 -0
  110. package/dist/server/tunnel-proxy-router.js.map +1 -0
  111. package/dist/server/tunnel-proxy-router.test.js +229 -0
  112. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  113. package/dist/server/viewsDevServer.d.ts +14 -0
  114. package/dist/server/viewsDevServer.js +45 -0
  115. package/dist/server/viewsDevServer.js.map +1 -0
  116. package/dist/{src/test → test}/utils.d.ts +13 -21
  117. package/dist/{src/test → test}/utils.js +42 -37
  118. package/dist/test/utils.js.map +1 -0
  119. package/dist/test/view.test.js +523 -0
  120. package/dist/test/view.test.js.map +1 -0
  121. package/dist/version.d.ts +1 -0
  122. package/dist/version.js +3 -0
  123. package/dist/version.js.map +1 -0
  124. package/dist/web/bridges/apps-sdk/adaptor.d.ts +24 -0
  125. package/dist/web/bridges/apps-sdk/adaptor.js +93 -0
  126. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -0
  127. package/dist/web/bridges/apps-sdk/bridge.d.ts +10 -0
  128. package/dist/{src/web/bridges/apps-sdk-bridge.js → web/bridges/apps-sdk/bridge.js} +2 -2
  129. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -0
  130. package/dist/web/bridges/apps-sdk/index.d.ts +5 -0
  131. package/dist/web/bridges/apps-sdk/index.js +5 -0
  132. package/dist/web/bridges/apps-sdk/index.js.map +1 -0
  133. package/dist/web/bridges/apps-sdk/types.d.ts +126 -0
  134. package/dist/{src/web → web/bridges/apps-sdk}/types.js +0 -1
  135. package/dist/web/bridges/apps-sdk/types.js.map +1 -0
  136. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +2 -0
  137. package/dist/{src/web/bridges/hooks/use-apps-sdk-bridge.js → web/bridges/apps-sdk/use-apps-sdk-context.js} +3 -3
  138. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -0
  139. package/dist/web/bridges/get-adaptor.d.ts +2 -0
  140. package/dist/web/bridges/get-adaptor.js +8 -0
  141. package/dist/web/bridges/get-adaptor.js.map +1 -0
  142. package/dist/web/bridges/index.d.ts +5 -0
  143. package/dist/web/bridges/index.js +6 -0
  144. package/dist/web/bridges/index.js.map +1 -0
  145. package/dist/web/bridges/mcp-app/adaptor.d.ts +48 -0
  146. package/dist/web/bridges/mcp-app/adaptor.js +268 -0
  147. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -0
  148. package/dist/web/bridges/mcp-app/bridge.d.ts +26 -0
  149. package/dist/web/bridges/mcp-app/bridge.js +102 -0
  150. package/dist/web/bridges/mcp-app/bridge.js.map +1 -0
  151. package/dist/web/bridges/mcp-app/index.d.ts +4 -0
  152. package/dist/web/bridges/mcp-app/index.js +4 -0
  153. package/dist/web/bridges/mcp-app/index.js.map +1 -0
  154. package/dist/web/bridges/mcp-app/types.d.ts +8 -0
  155. package/dist/web/bridges/mcp-app/types.js +2 -0
  156. package/dist/web/bridges/mcp-app/types.js.map +1 -0
  157. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +7 -0
  158. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +7 -0
  159. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -0
  160. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +26 -0
  161. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -0
  162. package/dist/web/bridges/types.d.ts +109 -0
  163. package/dist/web/bridges/types.js +2 -0
  164. package/dist/web/bridges/types.js.map +1 -0
  165. package/dist/web/bridges/use-host-context.d.ts +2 -0
  166. package/dist/web/bridges/use-host-context.js +8 -0
  167. package/dist/web/bridges/use-host-context.js.map +1 -0
  168. package/dist/web/components/modal-provider.d.ts +4 -0
  169. package/dist/web/components/modal-provider.js +45 -0
  170. package/dist/web/components/modal-provider.js.map +1 -0
  171. package/dist/web/create-store.js +38 -0
  172. package/dist/web/create-store.js.map +1 -0
  173. package/dist/web/create-store.test.js +129 -0
  174. package/dist/web/create-store.test.js.map +1 -0
  175. package/dist/{src/web → web}/data-llm.d.ts +1 -1
  176. package/dist/{src/web → web}/data-llm.js +7 -5
  177. package/dist/web/data-llm.js.map +1 -0
  178. package/dist/web/data-llm.test.js +142 -0
  179. package/dist/web/data-llm.test.js.map +1 -0
  180. package/dist/{src/web → web}/generate-helpers.d.ts +22 -19
  181. package/dist/{src/web → web}/generate-helpers.js +20 -18
  182. package/dist/web/generate-helpers.js.map +1 -0
  183. package/dist/{src/web → web}/generate-helpers.test-d.js +26 -26
  184. package/dist/web/generate-helpers.test-d.js.map +1 -0
  185. package/dist/web/generate-helpers.test.js.map +1 -0
  186. package/dist/{src/web → web}/helpers/state.d.ts +2 -2
  187. package/dist/web/helpers/state.js +45 -0
  188. package/dist/web/helpers/state.js.map +1 -0
  189. package/dist/{src/web → web}/helpers/state.test.js +9 -9
  190. package/dist/web/helpers/state.test.js.map +1 -0
  191. package/dist/{src/web → web}/hooks/index.d.ts +3 -3
  192. package/dist/{src/web → web}/hooks/index.js +2 -2
  193. package/dist/web/hooks/index.js.map +1 -0
  194. package/dist/{src/web → web}/hooks/test/utils.d.ts +8 -2
  195. package/dist/web/hooks/test/utils.js +64 -0
  196. package/dist/web/hooks/test/utils.js.map +1 -0
  197. package/dist/{src/web → web}/hooks/use-call-tool.d.ts +2 -1
  198. package/dist/{src/web → web}/hooks/use-call-tool.js +2 -2
  199. package/dist/web/hooks/use-call-tool.js.map +1 -0
  200. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  201. package/dist/{src/web → web}/hooks/use-call-tool.test.js +0 -1
  202. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  203. package/dist/web/hooks/use-display-mode.d.ts +4 -0
  204. package/dist/web/hooks/use-display-mode.js +9 -0
  205. package/dist/web/hooks/use-display-mode.js.map +1 -0
  206. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  207. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  208. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  209. package/dist/web/hooks/use-files.d.ts +7 -0
  210. package/dist/web/hooks/use-files.js +10 -0
  211. package/dist/web/hooks/use-files.js.map +1 -0
  212. package/dist/web/hooks/use-files.test.d.ts +1 -0
  213. package/dist/web/hooks/use-files.test.js +54 -0
  214. package/dist/web/hooks/use-files.test.js.map +1 -0
  215. package/dist/{src/web → web}/hooks/use-layout.d.ts +2 -2
  216. package/dist/{src/web → web}/hooks/use-layout.js +4 -4
  217. package/dist/web/hooks/use-layout.js.map +1 -0
  218. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  219. package/dist/{src/web → web}/hooks/use-layout.test.js +7 -6
  220. package/dist/web/hooks/use-layout.test.js.map +1 -0
  221. package/dist/web/hooks/use-open-external.d.ts +3 -0
  222. package/dist/web/hooks/use-open-external.js +8 -0
  223. package/dist/web/hooks/use-open-external.js.map +1 -0
  224. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  225. package/dist/{src/web → web}/hooks/use-open-external.test.js +27 -12
  226. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  227. package/dist/web/hooks/use-request-modal.d.ts +9 -0
  228. package/dist/web/hooks/use-request-modal.js +16 -0
  229. package/dist/web/hooks/use-request-modal.js.map +1 -0
  230. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  231. package/dist/{src/web → web}/hooks/use-request-modal.test.js +5 -1
  232. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  233. package/dist/{src/web → web}/hooks/use-send-follow-up-message.js +2 -2
  234. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  235. package/dist/web/hooks/use-set-open-in-app-url.d.ts +1 -0
  236. package/dist/web/hooks/use-set-open-in-app-url.js +8 -0
  237. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -0
  238. package/dist/web/hooks/use-set-open-in-app-url.test.d.ts +1 -0
  239. package/dist/web/hooks/use-set-open-in-app-url.test.js +43 -0
  240. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -0
  241. package/dist/{src/web → web}/hooks/use-tool-info.js +4 -4
  242. package/dist/web/hooks/use-tool-info.js.map +1 -0
  243. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  244. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  245. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  246. package/dist/{src/web → web}/hooks/use-tool-info.test.js +5 -5
  247. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  248. package/dist/{src/web → web}/hooks/use-user.d.ts +1 -1
  249. package/dist/web/hooks/use-user.js +35 -0
  250. package/dist/web/hooks/use-user.js.map +1 -0
  251. package/dist/web/hooks/use-user.test.d.ts +1 -0
  252. package/dist/{src/web → web}/hooks/use-user.test.js +33 -4
  253. package/dist/web/hooks/use-user.test.js.map +1 -0
  254. package/dist/web/hooks/use-view-state.d.ts +4 -0
  255. package/dist/web/hooks/use-view-state.js +32 -0
  256. package/dist/web/hooks/use-view-state.js.map +1 -0
  257. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  258. package/dist/web/hooks/use-view-state.test.js +177 -0
  259. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  260. package/dist/{src/web → web}/index.d.ts +1 -2
  261. package/dist/{src/web → web}/index.js +1 -2
  262. package/dist/web/index.js.map +1 -0
  263. package/dist/web/mount-view.d.ts +1 -0
  264. package/dist/{src/web/mount-widget.js → web/mount-view.js} +11 -3
  265. package/dist/web/mount-view.js.map +1 -0
  266. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  267. package/dist/web/plugin/data-llm.test.js.map +1 -0
  268. package/dist/web/plugin/plugin.d.ts +5 -0
  269. package/dist/web/plugin/plugin.js +156 -0
  270. package/dist/web/plugin/plugin.js.map +1 -0
  271. package/dist/web/plugin/scan-views.d.ts +16 -0
  272. package/dist/web/plugin/scan-views.js +88 -0
  273. package/dist/web/plugin/scan-views.js.map +1 -0
  274. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  275. package/dist/web/plugin/scan-views.test.js +99 -0
  276. package/dist/web/plugin/scan-views.test.js.map +1 -0
  277. package/dist/{src/web → web}/plugin/transform-data-llm.js +1 -1
  278. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  279. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  280. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  281. package/dist/web/plugin/validate-view.d.ts +1 -0
  282. package/dist/web/plugin/validate-view.js +9 -0
  283. package/dist/web/plugin/validate-view.js.map +1 -0
  284. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  285. package/dist/web/plugin/validate-view.test.js +24 -0
  286. package/dist/web/plugin/validate-view.test.js.map +1 -0
  287. package/dist/{src/web → web}/proxy.js +0 -1
  288. package/dist/web/proxy.js.map +1 -0
  289. package/dist/web/types.d.ts +16 -0
  290. package/dist/web/types.js +2 -0
  291. package/dist/web/types.js.map +1 -0
  292. package/package.json +74 -39
  293. package/tsconfig.base.json +33 -0
  294. package/dist/src/server/devtoolsStaticServer.d.ts +0 -15
  295. package/dist/src/server/devtoolsStaticServer.js +0 -38
  296. package/dist/src/server/devtoolsStaticServer.js.map +0 -1
  297. package/dist/src/server/index.d.ts +0 -5
  298. package/dist/src/server/index.js +0 -4
  299. package/dist/src/server/index.js.map +0 -1
  300. package/dist/src/server/inferUtilityTypes.js.map +0 -1
  301. package/dist/src/server/server.d.ts +0 -74
  302. package/dist/src/server/server.js +0 -82
  303. package/dist/src/server/server.js.map +0 -1
  304. package/dist/src/server/templateHelper.js +0 -30
  305. package/dist/src/server/templateHelper.js.map +0 -1
  306. package/dist/src/server/templates/development.hbs +0 -13
  307. package/dist/src/server/templates/production.hbs +0 -7
  308. package/dist/src/server/widgetsDevServer.d.ts +0 -12
  309. package/dist/src/server/widgetsDevServer.js +0 -38
  310. package/dist/src/server/widgetsDevServer.js.map +0 -1
  311. package/dist/src/test/utils.js.map +0 -1
  312. package/dist/src/test/widget.test.js +0 -146
  313. package/dist/src/test/widget.test.js.map +0 -1
  314. package/dist/src/web/bridges/adaptors/apps-sdk-adaptor.d.ts +0 -13
  315. package/dist/src/web/bridges/adaptors/apps-sdk-adaptor.js +0 -33
  316. package/dist/src/web/bridges/adaptors/apps-sdk-adaptor.js.map +0 -1
  317. package/dist/src/web/bridges/adaptors/mcp-app-adaptor.d.ts +0 -16
  318. package/dist/src/web/bridges/adaptors/mcp-app-adaptor.js +0 -115
  319. package/dist/src/web/bridges/adaptors/mcp-app-adaptor.js.map +0 -1
  320. package/dist/src/web/bridges/apps-sdk-bridge.d.ts +0 -10
  321. package/dist/src/web/bridges/apps-sdk-bridge.js.map +0 -1
  322. package/dist/src/web/bridges/hooks/use-adaptor.d.ts +0 -2
  323. package/dist/src/web/bridges/hooks/use-adaptor.js +0 -8
  324. package/dist/src/web/bridges/hooks/use-adaptor.js.map +0 -1
  325. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.d.ts +0 -2
  326. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js.map +0 -1
  327. package/dist/src/web/bridges/hooks/use-bridge.d.ts +0 -2
  328. package/dist/src/web/bridges/hooks/use-bridge.js +0 -8
  329. package/dist/src/web/bridges/hooks/use-bridge.js.map +0 -1
  330. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.d.ts +0 -5
  331. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js +0 -7
  332. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js.map +0 -1
  333. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js +0 -41
  334. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js.map +0 -1
  335. package/dist/src/web/bridges/index.d.ts +0 -4
  336. package/dist/src/web/bridges/index.js +0 -5
  337. package/dist/src/web/bridges/index.js.map +0 -1
  338. package/dist/src/web/bridges/mcp-app-bridge.d.ts +0 -38
  339. package/dist/src/web/bridges/mcp-app-bridge.js +0 -162
  340. package/dist/src/web/bridges/mcp-app-bridge.js.map +0 -1
  341. package/dist/src/web/bridges/types.d.ts +0 -57
  342. package/dist/src/web/create-store.js +0 -25
  343. package/dist/src/web/create-store.js.map +0 -1
  344. package/dist/src/web/create-store.test.js +0 -70
  345. package/dist/src/web/create-store.test.js.map +0 -1
  346. package/dist/src/web/data-llm.js.map +0 -1
  347. package/dist/src/web/data-llm.test.js +0 -76
  348. package/dist/src/web/data-llm.test.js.map +0 -1
  349. package/dist/src/web/generate-helpers.js.map +0 -1
  350. package/dist/src/web/generate-helpers.test-d.js.map +0 -1
  351. package/dist/src/web/generate-helpers.test.js.map +0 -1
  352. package/dist/src/web/helpers/state.js +0 -40
  353. package/dist/src/web/helpers/state.js.map +0 -1
  354. package/dist/src/web/helpers/state.test.js.map +0 -1
  355. package/dist/src/web/hooks/index.js.map +0 -1
  356. package/dist/src/web/hooks/test/utils.js +0 -40
  357. package/dist/src/web/hooks/test/utils.js.map +0 -1
  358. package/dist/src/web/hooks/use-call-tool.js.map +0 -1
  359. package/dist/src/web/hooks/use-call-tool.test-d.js.map +0 -1
  360. package/dist/src/web/hooks/use-call-tool.test.js.map +0 -1
  361. package/dist/src/web/hooks/use-display-mode.d.ts +0 -4
  362. package/dist/src/web/hooks/use-display-mode.js +0 -10
  363. package/dist/src/web/hooks/use-display-mode.js.map +0 -1
  364. package/dist/src/web/hooks/use-display-mode.test.js.map +0 -1
  365. package/dist/src/web/hooks/use-files.d.ts +0 -10
  366. package/dist/src/web/hooks/use-files.js +0 -7
  367. package/dist/src/web/hooks/use-files.js.map +0 -1
  368. package/dist/src/web/hooks/use-files.test.js +0 -29
  369. package/dist/src/web/hooks/use-files.test.js.map +0 -1
  370. package/dist/src/web/hooks/use-layout.js.map +0 -1
  371. package/dist/src/web/hooks/use-layout.test.js.map +0 -1
  372. package/dist/src/web/hooks/use-open-external.d.ts +0 -1
  373. package/dist/src/web/hooks/use-open-external.js +0 -8
  374. package/dist/src/web/hooks/use-open-external.js.map +0 -1
  375. package/dist/src/web/hooks/use-open-external.test.js.map +0 -1
  376. package/dist/src/web/hooks/use-openai-global.d.ts +0 -3
  377. package/dist/src/web/hooks/use-openai-global.js +0 -6
  378. package/dist/src/web/hooks/use-openai-global.js.map +0 -1
  379. package/dist/src/web/hooks/use-request-modal.d.ts +0 -9
  380. package/dist/src/web/hooks/use-request-modal.js +0 -14
  381. package/dist/src/web/hooks/use-request-modal.js.map +0 -1
  382. package/dist/src/web/hooks/use-request-modal.test.js.map +0 -1
  383. package/dist/src/web/hooks/use-send-follow-up-message.js.map +0 -1
  384. package/dist/src/web/hooks/use-tool-info.js.map +0 -1
  385. package/dist/src/web/hooks/use-tool-info.test-d.js.map +0 -1
  386. package/dist/src/web/hooks/use-tool-info.test.js.map +0 -1
  387. package/dist/src/web/hooks/use-user.js +0 -19
  388. package/dist/src/web/hooks/use-user.js.map +0 -1
  389. package/dist/src/web/hooks/use-user.test.js.map +0 -1
  390. package/dist/src/web/hooks/use-widget-state.d.ts +0 -4
  391. package/dist/src/web/hooks/use-widget-state.js +0 -32
  392. package/dist/src/web/hooks/use-widget-state.js.map +0 -1
  393. package/dist/src/web/hooks/use-widget-state.test.js +0 -61
  394. package/dist/src/web/hooks/use-widget-state.test.js.map +0 -1
  395. package/dist/src/web/index.js.map +0 -1
  396. package/dist/src/web/mount-widget.d.ts +0 -1
  397. package/dist/src/web/mount-widget.js.map +0 -1
  398. package/dist/src/web/plugin/data-llm.test.js.map +0 -1
  399. package/dist/src/web/plugin/plugin.d.ts +0 -2
  400. package/dist/src/web/plugin/plugin.js +0 -39
  401. package/dist/src/web/plugin/plugin.js.map +0 -1
  402. package/dist/src/web/plugin/transform-data-llm.js.map +0 -1
  403. package/dist/src/web/plugin/transform-data-llm.test.js.map +0 -1
  404. package/dist/src/web/proxy.js.map +0 -1
  405. package/dist/src/web/types.d.ts +0 -149
  406. package/dist/src/web/types.js.map +0 -1
  407. package/dist/vitest.config.d.ts +0 -2
  408. package/dist/vitest.config.js +0 -8
  409. package/dist/vitest.config.js.map +0 -1
  410. /package/dist/{src/test/widget.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  411. /package/dist/{src/web/bridges/hooks/use-mcp-app-bridge.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
  412. /package/dist/{src/web/create-store.test.d.ts → cli/tunnel.test.d.ts} +0 -0
  413. /package/dist/{src/web/bridges → cli}/types.js +0 -0
  414. /package/dist/{src/web/data-llm.test.d.ts → server/asset-base-url-transform-plugin.test.d.ts} +0 -0
  415. /package/dist/{src/web/generate-helpers.test-d.d.ts → server/content-helpers.test.d.ts} +0 -0
  416. /package/dist/{src/web/generate-helpers.test.d.ts → server/express.test.d.ts} +0 -0
  417. /package/dist/{src/server → server}/inferUtilityTypes.js +0 -0
  418. /package/dist/{src/web/helpers/state.test.d.ts → server/middleware.test-d.d.ts} +0 -0
  419. /package/dist/{src/web/hooks/use-call-tool.test-d.d.ts → server/middleware.test.d.ts} +0 -0
  420. /package/dist/{src/web/hooks/use-call-tool.test.d.ts → server/tunnel-proxy-router.test.d.ts} +0 -0
  421. /package/dist/{src/web/hooks/use-display-mode.test.d.ts → test/view.test.d.ts} +0 -0
  422. /package/dist/{src/web/hooks/use-files.test.d.ts → web/bridges/mcp-app/use-mcp-app-context.test.d.ts} +0 -0
  423. /package/dist/{src/web → web}/create-store.d.ts +0 -0
  424. /package/dist/{src/web/hooks/use-layout.test.d.ts → web/create-store.test.d.ts} +0 -0
  425. /package/dist/{src/web/plugin → web}/data-llm.test.d.ts +0 -0
  426. /package/dist/{src/web/hooks/use-open-external.test.d.ts → web/generate-helpers.test-d.d.ts} +0 -0
  427. /package/dist/{src/web/hooks/use-request-modal.test.d.ts → web/generate-helpers.test.d.ts} +0 -0
  428. /package/dist/{src/web → web}/generate-helpers.test.js +0 -0
  429. /package/dist/{src/web/hooks/use-tool-info.test-d.d.ts → web/helpers/state.test.d.ts} +0 -0
  430. /package/dist/{src/web/hooks/use-tool-info.test.d.ts → web/hooks/use-call-tool.test-d.d.ts} +0 -0
  431. /package/dist/{src/web → web}/hooks/use-call-tool.test-d.js +0 -0
  432. /package/dist/{src/web/hooks/use-user.test.d.ts → web/hooks/use-call-tool.test.d.ts} +0 -0
  433. /package/dist/{src/web/hooks/use-widget-state.test.d.ts → web/hooks/use-display-mode.test-d.d.ts} +0 -0
  434. /package/dist/{src/web/plugin/transform-data-llm.test.d.ts → web/hooks/use-display-mode.test.d.ts} +0 -0
  435. /package/dist/{src/web → web}/hooks/use-display-mode.test.js +0 -0
  436. /package/dist/{src/web → web}/hooks/use-send-follow-up-message.d.ts +0 -0
  437. /package/dist/{src/web → web}/hooks/use-tool-info.d.ts +0 -0
  438. /package/dist/{src/web → web}/hooks/use-tool-info.test-d.js +0 -0
  439. /package/dist/{src/web → web}/plugin/data-llm.test.js +0 -0
  440. /package/dist/{src/web → web}/plugin/transform-data-llm.d.ts +0 -0
  441. /package/dist/{src/web → web}/plugin/transform-data-llm.test.js +0 -0
  442. /package/dist/{src/web → web}/proxy.d.ts +0 -0
@@ -0,0 +1,93 @@
1
+ import { AppsSdkBridge } from "./bridge.js";
2
+ export class AppsSdkAdaptor {
3
+ static instance = null;
4
+ static getInstance() {
5
+ if (!AppsSdkAdaptor.instance) {
6
+ AppsSdkAdaptor.instance = new AppsSdkAdaptor();
7
+ }
8
+ return AppsSdkAdaptor.instance;
9
+ }
10
+ static resetInstance() {
11
+ AppsSdkAdaptor.instance = null;
12
+ }
13
+ getHostContextStore(key) {
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
+ }
27
+ return {
28
+ subscribe: bridge.subscribe(key),
29
+ getSnapshot: () => bridge.getSnapshot(key),
30
+ };
31
+ }
32
+ callTool = async (name, args) => {
33
+ return window.openai.callTool(name, args);
34
+ };
35
+ requestDisplayMode = (mode) => {
36
+ return window.openai.requestDisplayMode({ mode });
37
+ };
38
+ sendFollowUpMessage = (prompt) => {
39
+ return window.openai.sendFollowUpMessage({ prompt });
40
+ };
41
+ openExternal(href, options = {}) {
42
+ window.openai.openExternal({ href, ...options });
43
+ }
44
+ setViewState = (stateOrUpdater) => {
45
+ const modelContent = typeof stateOrUpdater === "function"
46
+ ? stateOrUpdater(window.openai.widgetState?.modelContent ?? null)
47
+ : stateOrUpdater;
48
+ return window.openai.setWidgetState({
49
+ privateContent: {},
50
+ ...window.openai.widgetState,
51
+ modelContent,
52
+ });
53
+ };
54
+ uploadFile = async (file, options) => {
55
+ const metadata = await window.openai.uploadFile(file, options);
56
+ await this.trackFileIds(metadata.fileId);
57
+ return metadata;
58
+ };
59
+ getFileDownloadUrl = (file) => {
60
+ return window.openai.getFileDownloadUrl(file);
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
+ }
82
+ openModal(options) {
83
+ return window.openai.requestModal(options);
84
+ }
85
+ setOpenInAppUrl(href) {
86
+ href = href.trim();
87
+ if (!href) {
88
+ throw new Error("The href parameter is required.");
89
+ }
90
+ return window.openai.setOpenInAppUrl({ href });
91
+ }
92
+ }
93
+ //# sourceMappingURL=adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { Bridge, Subscribe } from "../types.js";
2
+ import { type AppsSdkContext } from "./types.js";
3
+ export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
4
+ private static instance;
5
+ static getInstance(): AppsSdkBridge;
6
+ static resetInstance(): void;
7
+ subscribe(key: keyof AppsSdkContext): Subscribe;
8
+ subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;
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
+ }
@@ -1,4 +1,4 @@
1
- import { SET_GLOBALS_EVENT_TYPE, } from "../types.js";
1
+ import { SET_GLOBALS_EVENT_TYPE, } from "./types.js";
2
2
  export class AppsSdkBridge {
3
3
  static instance = null;
4
4
  static getInstance() {
@@ -43,4 +43,4 @@ export class AppsSdkBridge {
43
43
  return window.openai[key];
44
44
  };
45
45
  }
46
- //# sourceMappingURL=apps-sdk-bridge.js.map
46
+ //# sourceMappingURL=bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAE9C,MAAM,CAAC,WAAW;QACvB,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;YACxC,MAAM,CAAC,MAAM,KAAK,SAAS,EAC3B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAIM,SAAS,CACd,SAAmE;QAEnE,MAAM,IAAI,GAAsC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChB,OAAO,CAAC,QAAoB,EAAE,EAAE;YAC9B,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;gBACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CACjC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CACjD,CAAC;gBACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;YACtE,CAAC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAEM,WAAW,GAAG,CAAiC,GAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,+EAA+E,GAAG,8CAA8C,CACjI,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ export { AppsSdkAdaptor } from "./adaptor.js";
2
+ export { AppsSdkBridge } from "./bridge.js";
3
+ export type { AppsSdkContext, AppsSdkMethods, AppsSdkWidgetState, ToolResponseEvent, } from "./types.js";
4
+ export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
5
+ export { useAppsSdkContext } from "./use-apps-sdk-context.js";
@@ -0,0 +1,5 @@
1
+ export { AppsSdkAdaptor } from "./adaptor.js";
2
+ export { AppsSdkBridge } from "./bridge.js";
3
+ export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
4
+ export { useAppsSdkContext } from "./use-apps-sdk-context.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +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;AAO5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
@@ -0,0 +1,126 @@
1
+ import type { UnknownObject } from "../../types.js";
2
+ import type { CallToolArgs, CallToolResponse, FileMetadata, RequestModalOptions, UploadFileOptions } from "../types.js";
3
+ type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
4
+ type RequestDisplayMode = Exclude<DisplayMode, "modal">;
5
+ export type AppsSdkWidgetState = {
6
+ modelContent: Record<string, unknown>;
7
+ privateContent: Record<string, unknown>;
8
+ imageIds?: string[];
9
+ };
10
+ export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
11
+ export declare class ToolResponseEvent extends CustomEvent<{
12
+ tool: {
13
+ name: string;
14
+ args: UnknownObject;
15
+ };
16
+ }> {
17
+ readonly type = "openai:tool_response";
18
+ }
19
+ declare global {
20
+ interface Window {
21
+ openai: AppsSdkMethods & AppsSdkContext;
22
+ }
23
+ interface WindowEventMap {
24
+ [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
25
+ }
26
+ }
27
+ export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WS extends AppsSdkWidgetState = AppsSdkWidgetState> = {
28
+ theme: Theme;
29
+ userAgent: UserAgent;
30
+ locale: string;
31
+ maxHeight: number | undefined;
32
+ displayMode: DisplayMode;
33
+ safeArea: SafeArea;
34
+ view: View;
35
+ toolInput: ToolInput;
36
+ toolOutput: ToolOutput | {
37
+ text: string;
38
+ } | null;
39
+ toolResponseMetadata: ToolResponseMetadata | null;
40
+ widgetState: WS | null;
41
+ };
42
+ export type AppsSdkMethods<WS extends AppsSdkWidgetState = AppsSdkWidgetState> = {
43
+ /** Calls a tool on your MCP. Returns the full response. */
44
+ callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
45
+ /** Triggers a followup turn in the ChatGPT conversation */
46
+ sendFollowUpMessage: (args: {
47
+ prompt: string;
48
+ }) => Promise<void>;
49
+ /** Opens an external link, redirects web page or mobile app */
50
+ openExternal(args: {
51
+ href: string;
52
+ redirectUrl?: false;
53
+ }): void;
54
+ /** For transitioning an app from inline to fullscreen or pip */
55
+ requestDisplayMode: (args: {
56
+ mode: RequestDisplayMode;
57
+ }) => Promise<{
58
+ /**
59
+ * The granted display mode. The host may reject the request.
60
+ * For mobile, PiP is always coerced to fullscreen.
61
+ */
62
+ mode: RequestDisplayMode;
63
+ }>;
64
+ /**
65
+ * Sets the widget state.
66
+ * This state is persisted across widget renders.
67
+ */
68
+ setWidgetState: (state: WS) => Promise<void>;
69
+ /**
70
+ * Opens a modal portaled outside of the widget iFrame.
71
+ * This ensures the modal is correctly displayed and not limited to the widget's area.
72
+ */
73
+ requestModal: (args: RequestModalOptions) => Promise<void>;
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[]>;
81
+ /**
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.
84
+ */
85
+ getFileDownloadUrl: (file: FileMetadata) => Promise<{
86
+ downloadUrl: string;
87
+ }>;
88
+ /**
89
+ * Sets the open in app URL.
90
+ * This URL will be opened in the app when the user clicks on the top right button in fullscreen mode.
91
+ */
92
+ setOpenInAppUrl: (args: {
93
+ href: string;
94
+ }) => Promise<void>;
95
+ };
96
+ export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
97
+ export declare class SetGlobalsEvent extends CustomEvent<{
98
+ globals: Partial<AppsSdkContext>;
99
+ }> {
100
+ readonly type = "openai:set_globals";
101
+ }
102
+ type View = {
103
+ mode: DisplayMode;
104
+ params?: Record<string, unknown>;
105
+ };
106
+ type Theme = "light" | "dark";
107
+ type SafeAreaInsets = {
108
+ top: number;
109
+ bottom: number;
110
+ left: number;
111
+ right: number;
112
+ };
113
+ type SafeArea = {
114
+ insets: SafeAreaInsets;
115
+ };
116
+ type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
117
+ type UserAgent = {
118
+ device: {
119
+ type: DeviceType;
120
+ };
121
+ capabilities: {
122
+ hover: boolean;
123
+ touch: boolean;
124
+ };
125
+ };
126
+ export {};
@@ -1,4 +1,3 @@
1
- import "react";
2
1
  export const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
3
2
  export class ToolResponseEvent extends CustomEvent {
4
3
  type = TOOL_RESPONSE_EVENT_TYPE;
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,2 @@
1
+ import type { AppsSdkContext } from "./types.js";
2
+ export declare function useAppsSdkContext<K extends keyof AppsSdkContext>(key: K): AppsSdkContext[K];
@@ -1,7 +1,7 @@
1
1
  import { useSyncExternalStore } from "react";
2
- import { AppsSdkBridge } from "../apps-sdk-bridge.js";
3
- export function useAppsSdkBridge(key) {
2
+ import { AppsSdkBridge } from "./bridge.js";
3
+ export function useAppsSdkContext(key) {
4
4
  const bridge = AppsSdkBridge.getInstance();
5
5
  return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
6
6
  }
7
- //# sourceMappingURL=use-apps-sdk-bridge.js.map
7
+ //# sourceMappingURL=use-apps-sdk-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-apps-sdk-context.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/use-apps-sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,iBAAiB,CAC/B,GAAM;IAEN,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Adaptor } from "./types.js";
2
+ export declare const getAdaptor: () => Adaptor;
@@ -0,0 +1,8 @@
1
+ import { AppsSdkAdaptor } from "./apps-sdk/adaptor.js";
2
+ import { McpAppAdaptor } from "./mcp-app/adaptor.js";
3
+ export const getAdaptor = () => {
4
+ return window.skybridge.hostType === "apps-sdk"
5
+ ? AppsSdkAdaptor.getInstance()
6
+ : McpAppAdaptor.getInstance();
7
+ };
8
+ //# sourceMappingURL=get-adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;QAC7C,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from "./apps-sdk/index.js";
2
+ export { getAdaptor } from "./get-adaptor.js";
3
+ export * from "./mcp-app/index.js";
4
+ export * from "./types.js";
5
+ export { useHostContext } from "./use-host-context.js";
@@ -0,0 +1,6 @@
1
+ export * from "./apps-sdk/index.js";
2
+ export { getAdaptor } from "./get-adaptor.js";
3
+ export * from "./mcp-app/index.js";
4
+ export * from "./types.js";
5
+ export { useHostContext } from "./use-host-context.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/bridges/index.tsx"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,48 @@
1
+ import type { Adaptor, CallToolResponse, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, SetViewStateAction } from "../types.js";
2
+ export declare class McpAppAdaptor implements Adaptor {
3
+ private static instance;
4
+ private stores;
5
+ private _viewState;
6
+ private viewStateListeners;
7
+ private _viewUUID;
8
+ private _displayState;
9
+ private displayListeners;
10
+ private constructor();
11
+ static getInstance(): McpAppAdaptor;
12
+ static resetInstance(): void;
13
+ getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
14
+ callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
15
+ requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
16
+ [x: string]: unknown;
17
+ mode: "inline" | "fullscreen" | "pip";
18
+ }>;
19
+ sendFollowUpMessage: (prompt: string) => Promise<void>;
20
+ openExternal(href: string, options?: OpenExternalOptions): void;
21
+ private initializeStores;
22
+ setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
23
+ /**
24
+ * @throws File upload is not supported in MCP App.
25
+ */
26
+ uploadFile(): Promise<{
27
+ fileId: string;
28
+ }>;
29
+ /**
30
+ * @throws File download is not supported in MCP App.
31
+ */
32
+ getFileDownloadUrl(): Promise<{
33
+ downloadUrl: string;
34
+ }>;
35
+ /**
36
+ * @throws File selection is not supported in MCP App.
37
+ */
38
+ selectFiles(): Promise<{
39
+ fileId: string;
40
+ }[]>;
41
+ openModal(options: RequestModalOptions): void;
42
+ closeModal(): void;
43
+ setOpenInAppUrl(_href: string): Promise<void>;
44
+ private subscribeToViewUUID;
45
+ private restoreFromLocalStorage;
46
+ private persistToLocalStorage;
47
+ private createHostContextStore;
48
+ }
@@ -0,0 +1,268 @@
1
+ import { dequal } from "dequal/lite";
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
+ export class McpAppAdaptor {
16
+ static instance = null;
17
+ stores;
18
+ _viewState = null;
19
+ viewStateListeners = new Set();
20
+ _viewUUID = null;
21
+ _displayState = {
22
+ mode: "inline",
23
+ };
24
+ displayListeners = new Set();
25
+ constructor() {
26
+ this.stores = this.initializeStores();
27
+ this.subscribeToViewUUID();
28
+ }
29
+ static getInstance() {
30
+ if (!McpAppAdaptor.instance) {
31
+ McpAppAdaptor.instance = new McpAppAdaptor();
32
+ }
33
+ return McpAppAdaptor.instance;
34
+ }
35
+ static resetInstance() {
36
+ McpAppAdaptor.instance = null;
37
+ }
38
+ getHostContextStore(key) {
39
+ return this.stores[key];
40
+ }
41
+ callTool = async (name, args) => {
42
+ const app = await McpAppBridge.getInstance().getApp();
43
+ const response = await app.callServerTool({
44
+ name,
45
+ arguments: args ?? undefined,
46
+ });
47
+ const result = response.content
48
+ .filter((content) => content.type === "text")
49
+ .map(({ text }) => text)
50
+ .join("\n");
51
+ return {
52
+ content: response.content,
53
+ structuredContent: response.structuredContent ?? {},
54
+ isError: response.isError ?? false,
55
+ result,
56
+ meta: response._meta ?? {},
57
+ };
58
+ };
59
+ requestDisplayMode = async (mode) => {
60
+ const app = await McpAppBridge.getInstance().getApp();
61
+ return app.requestDisplayMode({ mode });
62
+ };
63
+ sendFollowUpMessage = async (prompt) => {
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
+ ],
73
+ });
74
+ };
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);
84
+ });
85
+ }
86
+ initializeStores() {
87
+ return {
88
+ theme: this.createHostContextStore(["theme"], ({ theme }) => theme ?? "light"),
89
+ locale: this.createHostContextStore(["locale"], ({ locale }) => locale ?? "en-US"),
90
+ safeArea: this.createHostContextStore(["safeAreaInsets"], ({ safeAreaInsets }) => ({
91
+ insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },
92
+ })),
93
+ displayMode: this.createHostContextStore(["displayMode"], ({ displayMode }) => displayMode ?? "inline"),
94
+ maxHeight: this.createHostContextStore(["containerDimensions"], ({ containerDimensions }) => {
95
+ if (containerDimensions && "maxHeight" in containerDimensions) {
96
+ return containerDimensions.maxHeight;
97
+ }
98
+ return undefined;
99
+ }),
100
+ userAgent: this.createHostContextStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
101
+ device: {
102
+ type: platform === "web" ? "desktop" : (platform ?? "unknown"),
103
+ },
104
+ capabilities: {
105
+ hover: true,
106
+ touch: true,
107
+ ...deviceCapabilities,
108
+ },
109
+ })),
110
+ toolInput: this.createHostContextStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
111
+ toolOutput: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
112
+ toolResponseMetadata: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
113
+ display: {
114
+ subscribe: (onChange) => {
115
+ this.displayListeners.add(onChange);
116
+ return () => {
117
+ this.displayListeners.delete(onChange);
118
+ };
119
+ },
120
+ getSnapshot: () => this._displayState,
121
+ },
122
+ viewState: {
123
+ subscribe: (onChange) => {
124
+ this.viewStateListeners.add(onChange);
125
+ return () => {
126
+ this.viewStateListeners.delete(onChange);
127
+ };
128
+ },
129
+ getSnapshot: () => this._viewState,
130
+ },
131
+ };
132
+ }
133
+ setViewState = async (stateOrUpdater) => {
134
+ const newState = typeof stateOrUpdater === "function"
135
+ ? stateOrUpdater(this._viewState)
136
+ : stateOrUpdater;
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) => {
141
+ listener();
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
+ }
154
+ };
155
+ /**
156
+ * @throws File upload is not supported in MCP App.
157
+ */
158
+ uploadFile() {
159
+ throw new Error("File upload is not supported in MCP App.");
160
+ }
161
+ /**
162
+ * @throws File download is not supported in MCP App.
163
+ */
164
+ getFileDownloadUrl() {
165
+ throw new Error("File download is not supported in MCP App.");
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
+ }
173
+ openModal(options) {
174
+ this._displayState = { mode: "modal", params: options.params };
175
+ this.displayListeners.forEach((listener) => {
176
+ listener();
177
+ });
178
+ }
179
+ closeModal() {
180
+ this._displayState = { mode: "inline" };
181
+ this.displayListeners.forEach((listener) => {
182
+ listener();
183
+ });
184
+ }
185
+ setOpenInAppUrl(_href) {
186
+ throw new Error("setOpenInAppUrl is not implemented in MCP App.");
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
+ }
251
+ createHostContextStore(keys, computeSnapshot) {
252
+ const bridge = McpAppBridge.getInstance();
253
+ let cachedValue;
254
+ return {
255
+ subscribe: bridge.subscribe(keys),
256
+ getSnapshot: () => {
257
+ const context = Object.fromEntries(keys.map((k) => [k, bridge.getSnapshot(k)]));
258
+ const newValue = computeSnapshot(context);
259
+ if (cachedValue !== undefined && dequal(cachedValue, newValue)) {
260
+ return cachedValue;
261
+ }
262
+ cachedValue = newValue;
263
+ return newValue;
264
+ },
265
+ };
266
+ }
267
+ }
268
+ //# sourceMappingURL=adaptor.js.map