skybridge 0.0.0-dev.ecf87cf → 0.0.0-dev.ed7ee19

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 (503) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +152 -0
  3. package/bin/run.js +5 -0
  4. package/dist/cli/build-helpers.d.ts +7 -0
  5. package/dist/cli/build-helpers.js +82 -0
  6. package/dist/cli/build-helpers.js.map +1 -0
  7. package/dist/cli/build-helpers.test.js +64 -0
  8. package/dist/cli/build-helpers.test.js.map +1 -0
  9. package/dist/cli/detect-port.d.ts +18 -0
  10. package/dist/cli/detect-port.js +50 -0
  11. package/dist/cli/detect-port.js.map +1 -0
  12. package/dist/cli/header.d.ts +4 -0
  13. package/dist/cli/header.js +6 -0
  14. package/dist/cli/header.js.map +1 -0
  15. package/dist/cli/resolve-views-dir.d.ts +1 -0
  16. package/dist/cli/resolve-views-dir.js +17 -0
  17. package/dist/cli/resolve-views-dir.js.map +1 -0
  18. package/dist/cli/run-command.d.ts +2 -0
  19. package/dist/cli/run-command.js +43 -0
  20. package/dist/cli/run-command.js.map +1 -0
  21. package/dist/cli/telemetry.d.ts +7 -0
  22. package/dist/cli/telemetry.js +123 -0
  23. package/dist/cli/telemetry.js.map +1 -0
  24. package/dist/cli/tunnel-control-server.d.ts +9 -0
  25. package/dist/cli/tunnel-control-server.js +31 -0
  26. package/dist/cli/tunnel-control-server.js.map +1 -0
  27. package/dist/cli/tunnel-control-server.test.js +39 -0
  28. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  29. package/dist/cli/tunnel-handler.d.ts +3 -0
  30. package/dist/cli/tunnel-handler.js +48 -0
  31. package/dist/cli/tunnel-handler.js.map +1 -0
  32. package/dist/cli/tunnel-handler.test.js +105 -0
  33. package/dist/cli/tunnel-handler.test.js.map +1 -0
  34. package/dist/cli/tunnel.d.ts +57 -0
  35. package/dist/cli/tunnel.js +154 -0
  36. package/dist/cli/tunnel.js.map +1 -0
  37. package/dist/cli/tunnel.test.js +190 -0
  38. package/dist/cli/tunnel.test.js.map +1 -0
  39. package/dist/cli/types.d.ts +5 -0
  40. package/dist/cli/types.js.map +1 -0
  41. package/dist/cli/use-execute-steps.d.ts +11 -0
  42. package/dist/cli/use-execute-steps.js +36 -0
  43. package/dist/cli/use-execute-steps.js.map +1 -0
  44. package/dist/cli/use-messages.d.ts +3 -0
  45. package/dist/cli/use-messages.js +11 -0
  46. package/dist/cli/use-messages.js.map +1 -0
  47. package/dist/cli/use-nodemon.d.ts +2 -0
  48. package/dist/cli/use-nodemon.js +73 -0
  49. package/dist/cli/use-nodemon.js.map +1 -0
  50. package/dist/cli/use-open-browser.d.ts +1 -0
  51. package/dist/cli/use-open-browser.js +44 -0
  52. package/dist/cli/use-open-browser.js.map +1 -0
  53. package/dist/cli/use-tunnel.d.ts +14 -0
  54. package/dist/cli/use-tunnel.js +131 -0
  55. package/dist/cli/use-tunnel.js.map +1 -0
  56. package/dist/cli/use-typescript-check.d.ts +9 -0
  57. package/dist/cli/use-typescript-check.js +94 -0
  58. package/dist/cli/use-typescript-check.js.map +1 -0
  59. package/dist/commands/build.d.ts +8 -0
  60. package/dist/commands/build.js +90 -0
  61. package/dist/commands/build.js.map +1 -0
  62. package/dist/commands/create.d.ts +9 -0
  63. package/dist/commands/create.js +30 -0
  64. package/dist/commands/create.js.map +1 -0
  65. package/dist/commands/dev.d.ts +12 -0
  66. package/dist/commands/dev.js +96 -0
  67. package/dist/commands/dev.js.map +1 -0
  68. package/dist/commands/start.d.ts +9 -0
  69. package/dist/commands/start.js +55 -0
  70. package/dist/commands/start.js.map +1 -0
  71. package/dist/commands/telemetry/disable.d.ts +5 -0
  72. package/dist/commands/telemetry/disable.js +14 -0
  73. package/dist/commands/telemetry/disable.js.map +1 -0
  74. package/dist/commands/telemetry/enable.d.ts +5 -0
  75. package/dist/commands/telemetry/enable.js +14 -0
  76. package/dist/commands/telemetry/enable.js.map +1 -0
  77. package/dist/commands/telemetry/status.d.ts +5 -0
  78. package/dist/commands/telemetry/status.js +14 -0
  79. package/dist/commands/telemetry/status.js.map +1 -0
  80. package/dist/server/asset-base-url-transform-plugin.d.ts +11 -0
  81. package/dist/server/asset-base-url-transform-plugin.js +48 -0
  82. package/dist/server/asset-base-url-transform-plugin.js.map +1 -0
  83. package/dist/server/asset-base-url-transform-plugin.test.js +134 -0
  84. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -0
  85. package/dist/server/auth.d.ts +20 -0
  86. package/dist/server/auth.js +28 -0
  87. package/dist/server/auth.js.map +1 -0
  88. package/dist/server/build-manifest.test.js +27 -0
  89. package/dist/server/build-manifest.test.js.map +1 -0
  90. package/dist/server/content-helpers.d.ts +67 -0
  91. package/dist/server/content-helpers.js +79 -0
  92. package/dist/server/content-helpers.js.map +1 -0
  93. package/dist/server/content-helpers.test.js +70 -0
  94. package/dist/server/content-helpers.test.js.map +1 -0
  95. package/dist/server/express.d.ts +11 -0
  96. package/dist/server/express.js +101 -0
  97. package/dist/server/express.js.map +1 -0
  98. package/dist/server/express.test.js +491 -0
  99. package/dist/server/express.test.js.map +1 -0
  100. package/dist/server/file-ref.d.ts +28 -0
  101. package/dist/server/file-ref.js +27 -0
  102. package/dist/server/file-ref.js.map +1 -0
  103. package/dist/server/index.d.ts +8 -0
  104. package/dist/server/index.js +6 -0
  105. package/dist/server/index.js.map +1 -0
  106. package/dist/{src/server → server}/inferUtilityTypes.d.ts +6 -6
  107. package/dist/server/inferUtilityTypes.js.map +1 -0
  108. package/dist/server/metric.d.ts +14 -0
  109. package/dist/server/metric.js +62 -0
  110. package/dist/server/metric.js.map +1 -0
  111. package/dist/server/middleware.d.ts +137 -0
  112. package/dist/server/middleware.js +93 -0
  113. package/dist/server/middleware.js.map +1 -0
  114. package/dist/server/middleware.test-d.js +75 -0
  115. package/dist/server/middleware.test-d.js.map +1 -0
  116. package/dist/server/middleware.test.js +493 -0
  117. package/dist/server/middleware.test.js.map +1 -0
  118. package/dist/server/server.d.ts +400 -0
  119. package/dist/server/server.js +656 -0
  120. package/dist/server/server.js.map +1 -0
  121. package/dist/{src/server → server}/templateHelper.d.ts +5 -7
  122. package/dist/server/templateHelper.js +11 -0
  123. package/dist/server/templateHelper.js.map +1 -0
  124. package/dist/server/templates.generated.d.ts +4 -0
  125. package/dist/server/templates.generated.js +47 -0
  126. package/dist/server/templates.generated.js.map +1 -0
  127. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  128. package/dist/server/tunnel-proxy-router.js +110 -0
  129. package/dist/server/tunnel-proxy-router.js.map +1 -0
  130. package/dist/server/tunnel-proxy-router.test.js +229 -0
  131. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  132. package/dist/server/view-resource-resolution.test.d.ts +6 -0
  133. package/dist/server/view-resource-resolution.test.js +88 -0
  134. package/dist/server/view-resource-resolution.test.js.map +1 -0
  135. package/dist/server/viewsDevServer.d.ts +14 -0
  136. package/dist/server/viewsDevServer.js +45 -0
  137. package/dist/server/viewsDevServer.js.map +1 -0
  138. package/dist/{src/test → test}/utils.d.ts +13 -21
  139. package/dist/{src/test → test}/utils.js +42 -37
  140. package/dist/test/utils.js.map +1 -0
  141. package/dist/test/view.test.js +568 -0
  142. package/dist/test/view.test.js.map +1 -0
  143. package/dist/version.d.ts +1 -0
  144. package/dist/version.js +3 -0
  145. package/dist/version.js.map +1 -0
  146. package/dist/web/bridges/apps-sdk/adaptor.d.ts +29 -0
  147. package/dist/web/bridges/apps-sdk/adaptor.js +117 -0
  148. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -0
  149. package/dist/web/bridges/apps-sdk/bridge.d.ts +11 -0
  150. package/dist/web/bridges/apps-sdk/bridge.js +47 -0
  151. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -0
  152. package/dist/web/bridges/apps-sdk/index.d.ts +5 -0
  153. package/dist/web/bridges/apps-sdk/index.js +5 -0
  154. package/dist/web/bridges/apps-sdk/index.js.map +1 -0
  155. package/dist/web/bridges/apps-sdk/types.d.ts +133 -0
  156. package/dist/{src/web → web/bridges/apps-sdk}/types.js +0 -1
  157. package/dist/web/bridges/apps-sdk/types.js.map +1 -0
  158. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +13 -0
  159. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +18 -0
  160. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -0
  161. package/dist/web/bridges/get-adaptor.d.ts +9 -0
  162. package/dist/web/bridges/get-adaptor.js +15 -0
  163. package/dist/web/bridges/get-adaptor.js.map +1 -0
  164. package/dist/web/bridges/index.d.ts +5 -0
  165. package/dist/web/bridges/index.js +6 -0
  166. package/dist/web/bridges/index.js.map +1 -0
  167. package/dist/web/bridges/mcp-app/adaptor.d.ts +53 -0
  168. package/dist/web/bridges/mcp-app/adaptor.js +283 -0
  169. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -0
  170. package/dist/web/bridges/mcp-app/bridge.d.ts +28 -0
  171. package/dist/web/bridges/mcp-app/bridge.js +124 -0
  172. package/dist/web/bridges/mcp-app/bridge.js.map +1 -0
  173. package/dist/web/bridges/mcp-app/index.d.ts +4 -0
  174. package/dist/web/bridges/mcp-app/index.js +4 -0
  175. package/dist/web/bridges/mcp-app/index.js.map +1 -0
  176. package/dist/web/bridges/mcp-app/types.d.ts +8 -0
  177. package/dist/web/bridges/mcp-app/types.js +2 -0
  178. package/dist/web/bridges/mcp-app/types.js.map +1 -0
  179. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +19 -0
  180. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +19 -0
  181. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -0
  182. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +26 -0
  183. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -0
  184. package/dist/web/bridges/mcp-app/view-tools.test.js +144 -0
  185. package/dist/web/bridges/mcp-app/view-tools.test.js.map +1 -0
  186. package/dist/web/bridges/types.d.ts +204 -0
  187. package/dist/web/bridges/types.js +2 -0
  188. package/dist/web/bridges/types.js.map +1 -0
  189. package/dist/web/bridges/use-host-context.d.ts +7 -0
  190. package/dist/web/bridges/use-host-context.js +13 -0
  191. package/dist/web/bridges/use-host-context.js.map +1 -0
  192. package/dist/web/components/modal-provider.d.ts +4 -0
  193. package/dist/web/components/modal-provider.js +45 -0
  194. package/dist/web/components/modal-provider.js.map +1 -0
  195. package/dist/web/create-store.d.ts +29 -0
  196. package/dist/web/create-store.js +64 -0
  197. package/dist/web/create-store.js.map +1 -0
  198. package/dist/web/create-store.test.js +129 -0
  199. package/dist/web/create-store.test.js.map +1 -0
  200. package/dist/web/data-llm.d.ts +47 -0
  201. package/dist/{src/web → web}/data-llm.js +39 -7
  202. package/dist/web/data-llm.js.map +1 -0
  203. package/dist/web/data-llm.test.js +142 -0
  204. package/dist/web/data-llm.test.js.map +1 -0
  205. package/dist/{src/web → web}/generate-helpers.d.ts +24 -19
  206. package/dist/{src/web → web}/generate-helpers.js +22 -18
  207. package/dist/web/generate-helpers.js.map +1 -0
  208. package/dist/{src/web → web}/generate-helpers.test-d.js +32 -27
  209. package/dist/web/generate-helpers.test-d.js.map +1 -0
  210. package/dist/web/generate-helpers.test.js.map +1 -0
  211. package/dist/{src/web → web}/helpers/state.d.ts +2 -2
  212. package/dist/web/helpers/state.js +45 -0
  213. package/dist/web/helpers/state.js.map +1 -0
  214. package/dist/{src/web → web}/helpers/state.test.js +9 -9
  215. package/dist/web/helpers/state.test.js.map +1 -0
  216. package/dist/{src/web → web}/hooks/index.d.ts +7 -3
  217. package/dist/{src/web → web}/hooks/index.js +6 -2
  218. package/dist/web/hooks/index.js.map +1 -0
  219. package/dist/web/hooks/test/utils.d.ts +20 -0
  220. package/dist/web/hooks/test/utils.js +75 -0
  221. package/dist/web/hooks/test/utils.js.map +1 -0
  222. package/dist/{src/web → web}/hooks/use-call-tool.d.ts +47 -1
  223. package/dist/web/hooks/use-call-tool.js +96 -0
  224. package/dist/web/hooks/use-call-tool.js.map +1 -0
  225. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  226. package/dist/web/hooks/use-call-tool.test.d.ts +1 -0
  227. package/dist/{src/web → web}/hooks/use-call-tool.test.js +50 -4
  228. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  229. package/dist/web/hooks/use-display-mode.d.ts +24 -0
  230. package/dist/web/hooks/use-display-mode.js +29 -0
  231. package/dist/web/hooks/use-display-mode.js.map +1 -0
  232. package/dist/web/hooks/use-display-mode.test-d.d.ts +1 -0
  233. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  234. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  235. package/dist/web/hooks/use-display-mode.test.d.ts +1 -0
  236. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  237. package/dist/web/hooks/use-download.d.ts +5 -0
  238. package/dist/web/hooks/use-download.js +8 -0
  239. package/dist/web/hooks/use-download.js.map +1 -0
  240. package/dist/web/hooks/use-download.test.d.ts +1 -0
  241. package/dist/web/hooks/use-download.test.js +95 -0
  242. package/dist/web/hooks/use-download.test.js.map +1 -0
  243. package/dist/web/hooks/use-files.d.ts +39 -0
  244. package/dist/web/hooks/use-files.js +42 -0
  245. package/dist/web/hooks/use-files.js.map +1 -0
  246. package/dist/web/hooks/use-files.test.d.ts +1 -0
  247. package/dist/web/hooks/use-files.test.js +54 -0
  248. package/dist/web/hooks/use-files.test.js.map +1 -0
  249. package/dist/{src/web → web}/hooks/use-layout.d.ts +4 -2
  250. package/dist/{src/web → web}/hooks/use-layout.js +6 -4
  251. package/dist/web/hooks/use-layout.js.map +1 -0
  252. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  253. package/dist/web/hooks/use-layout.test.js +96 -0
  254. package/dist/web/hooks/use-layout.test.js.map +1 -0
  255. package/dist/web/hooks/use-open-external.d.ts +20 -0
  256. package/dist/web/hooks/use-open-external.js +24 -0
  257. package/dist/web/hooks/use-open-external.js.map +1 -0
  258. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  259. package/dist/web/hooks/use-open-external.test.js +65 -0
  260. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  261. package/dist/web/hooks/use-register-view-tool.d.ts +38 -0
  262. package/dist/web/hooks/use-register-view-tool.js +50 -0
  263. package/dist/web/hooks/use-register-view-tool.js.map +1 -0
  264. package/dist/web/hooks/use-request-close.d.ts +16 -0
  265. package/dist/web/hooks/use-request-close.js +21 -0
  266. package/dist/web/hooks/use-request-close.js.map +1 -0
  267. package/dist/web/hooks/use-request-close.test.d.ts +1 -0
  268. package/dist/web/hooks/use-request-close.test.js +52 -0
  269. package/dist/web/hooks/use-request-close.test.js.map +1 -0
  270. package/dist/web/hooks/use-request-modal.d.ts +24 -0
  271. package/dist/web/hooks/use-request-modal.js +31 -0
  272. package/dist/web/hooks/use-request-modal.js.map +1 -0
  273. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  274. package/dist/{src/web → web}/hooks/use-request-modal.test.js +5 -1
  275. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  276. package/dist/web/hooks/use-request-size.d.ts +20 -0
  277. package/dist/web/hooks/use-request-size.js +24 -0
  278. package/dist/web/hooks/use-request-size.js.map +1 -0
  279. package/dist/web/hooks/use-request-size.test.d.ts +1 -0
  280. package/dist/web/hooks/use-request-size.test.js +65 -0
  281. package/dist/web/hooks/use-request-size.test.js.map +1 -0
  282. package/dist/web/hooks/use-send-follow-up-message.d.ts +19 -0
  283. package/dist/web/hooks/use-send-follow-up-message.js +25 -0
  284. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  285. package/dist/web/hooks/use-set-open-in-app-url.d.ts +18 -0
  286. package/dist/web/hooks/use-set-open-in-app-url.js +25 -0
  287. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -0
  288. package/dist/web/hooks/use-set-open-in-app-url.test.d.ts +1 -0
  289. package/dist/web/hooks/use-set-open-in-app-url.test.js +43 -0
  290. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -0
  291. package/dist/web/hooks/use-tool-info.d.ts +87 -0
  292. package/dist/web/hooks/use-tool-info.js +49 -0
  293. package/dist/web/hooks/use-tool-info.js.map +1 -0
  294. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  295. package/dist/{src/web → web}/hooks/use-tool-info.test-d.js +24 -6
  296. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  297. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  298. package/dist/web/hooks/use-tool-info.test.js +130 -0
  299. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  300. package/dist/{src/web → web}/hooks/use-user.d.ts +3 -1
  301. package/dist/web/hooks/use-user.js +37 -0
  302. package/dist/web/hooks/use-user.js.map +1 -0
  303. package/dist/web/hooks/use-user.test.d.ts +1 -0
  304. package/dist/web/hooks/use-user.test.js +122 -0
  305. package/dist/web/hooks/use-user.test.js.map +1 -0
  306. package/dist/web/hooks/use-view-state.d.ts +25 -0
  307. package/dist/web/hooks/use-view-state.js +32 -0
  308. package/dist/web/hooks/use-view-state.js.map +1 -0
  309. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  310. package/dist/web/hooks/use-view-state.test.js +177 -0
  311. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  312. package/dist/{src/web → web}/index.d.ts +1 -2
  313. package/dist/{src/web → web}/index.js +1 -2
  314. package/dist/web/index.js.map +1 -0
  315. package/dist/web/mount-view.d.ts +20 -0
  316. package/dist/web/mount-view.js +46 -0
  317. package/dist/web/mount-view.js.map +1 -0
  318. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  319. package/dist/web/plugin/data-llm.test.js.map +1 -0
  320. package/dist/web/plugin/plugin.d.ts +33 -0
  321. package/dist/web/plugin/plugin.js +189 -0
  322. package/dist/web/plugin/plugin.js.map +1 -0
  323. package/dist/web/plugin/scan-views.d.ts +16 -0
  324. package/dist/web/plugin/scan-views.js +88 -0
  325. package/dist/web/plugin/scan-views.js.map +1 -0
  326. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  327. package/dist/web/plugin/scan-views.test.js +99 -0
  328. package/dist/web/plugin/scan-views.test.js.map +1 -0
  329. package/dist/{src/web → web}/plugin/transform-data-llm.js +7 -4
  330. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  331. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  332. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  333. package/dist/web/plugin/validate-view.d.ts +1 -0
  334. package/dist/web/plugin/validate-view.js +9 -0
  335. package/dist/web/plugin/validate-view.js.map +1 -0
  336. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  337. package/dist/web/plugin/validate-view.test.js +24 -0
  338. package/dist/web/plugin/validate-view.test.js.map +1 -0
  339. package/dist/{src/web → web}/proxy.js +0 -1
  340. package/dist/web/proxy.js.map +1 -0
  341. package/dist/web/types.d.ts +20 -0
  342. package/dist/web/types.js +2 -0
  343. package/dist/web/types.js.map +1 -0
  344. package/package.json +81 -40
  345. package/tsconfig.base.json +33 -0
  346. package/dist/src/server/devtoolsStaticServer.d.ts +0 -15
  347. package/dist/src/server/devtoolsStaticServer.js +0 -38
  348. package/dist/src/server/devtoolsStaticServer.js.map +0 -1
  349. package/dist/src/server/index.d.ts +0 -5
  350. package/dist/src/server/index.js +0 -4
  351. package/dist/src/server/index.js.map +0 -1
  352. package/dist/src/server/inferUtilityTypes.js.map +0 -1
  353. package/dist/src/server/server.d.ts +0 -74
  354. package/dist/src/server/server.js +0 -82
  355. package/dist/src/server/server.js.map +0 -1
  356. package/dist/src/server/templateHelper.js +0 -30
  357. package/dist/src/server/templateHelper.js.map +0 -1
  358. package/dist/src/server/templates/development.hbs +0 -13
  359. package/dist/src/server/templates/production.hbs +0 -7
  360. package/dist/src/server/widgetsDevServer.d.ts +0 -12
  361. package/dist/src/server/widgetsDevServer.js +0 -39
  362. package/dist/src/server/widgetsDevServer.js.map +0 -1
  363. package/dist/src/test/utils.js.map +0 -1
  364. package/dist/src/test/widget.test.js +0 -146
  365. package/dist/src/test/widget.test.js.map +0 -1
  366. package/dist/src/web/bridges/apps-sdk-adapter.d.ts +0 -2
  367. package/dist/src/web/bridges/apps-sdk-adapter.js +0 -4
  368. package/dist/src/web/bridges/apps-sdk-adapter.js.map +0 -1
  369. package/dist/src/web/bridges/apps-sdk-bridge.d.ts +0 -8
  370. package/dist/src/web/bridges/apps-sdk-bridge.js +0 -41
  371. package/dist/src/web/bridges/apps-sdk-bridge.js.map +0 -1
  372. package/dist/src/web/bridges/get-bridge-methods.d.ts +0 -2
  373. package/dist/src/web/bridges/get-bridge-methods.js +0 -8
  374. package/dist/src/web/bridges/get-bridge-methods.js.map +0 -1
  375. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.d.ts +0 -2
  376. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js +0 -7
  377. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js.map +0 -1
  378. package/dist/src/web/bridges/hooks/use-bridge.d.ts +0 -2
  379. package/dist/src/web/bridges/hooks/use-bridge.js +0 -90
  380. package/dist/src/web/bridges/hooks/use-bridge.js.map +0 -1
  381. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.d.ts +0 -4
  382. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js +0 -7
  383. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js.map +0 -1
  384. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js +0 -58
  385. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js.map +0 -1
  386. package/dist/src/web/bridges/index.d.ts +0 -4
  387. package/dist/src/web/bridges/index.js +0 -5
  388. package/dist/src/web/bridges/index.js.map +0 -1
  389. package/dist/src/web/bridges/mcp-app-adapter.d.ts +0 -2
  390. package/dist/src/web/bridges/mcp-app-adapter.js +0 -12
  391. package/dist/src/web/bridges/mcp-app-adapter.js.map +0 -1
  392. package/dist/src/web/bridges/mcp-app-bridge.d.ts +0 -30
  393. package/dist/src/web/bridges/mcp-app-bridge.js +0 -139
  394. package/dist/src/web/bridges/mcp-app-bridge.js.map +0 -1
  395. package/dist/src/web/bridges/types.d.ts +0 -32
  396. package/dist/src/web/bridges/types.js.map +0 -1
  397. package/dist/src/web/create-store.d.ts +0 -3
  398. package/dist/src/web/create-store.js +0 -25
  399. package/dist/src/web/create-store.js.map +0 -1
  400. package/dist/src/web/create-store.test.js +0 -70
  401. package/dist/src/web/create-store.test.js.map +0 -1
  402. package/dist/src/web/data-llm.d.ts +0 -14
  403. package/dist/src/web/data-llm.js.map +0 -1
  404. package/dist/src/web/data-llm.test.js +0 -76
  405. package/dist/src/web/data-llm.test.js.map +0 -1
  406. package/dist/src/web/generate-helpers.js.map +0 -1
  407. package/dist/src/web/generate-helpers.test-d.js.map +0 -1
  408. package/dist/src/web/generate-helpers.test.js.map +0 -1
  409. package/dist/src/web/helpers/state.js +0 -40
  410. package/dist/src/web/helpers/state.js.map +0 -1
  411. package/dist/src/web/helpers/state.test.js.map +0 -1
  412. package/dist/src/web/hooks/index.js.map +0 -1
  413. package/dist/src/web/hooks/use-call-tool.js +0 -60
  414. package/dist/src/web/hooks/use-call-tool.js.map +0 -1
  415. package/dist/src/web/hooks/use-call-tool.test-d.js.map +0 -1
  416. package/dist/src/web/hooks/use-call-tool.test.js.map +0 -1
  417. package/dist/src/web/hooks/use-display-mode.d.ts +0 -4
  418. package/dist/src/web/hooks/use-display-mode.js +0 -10
  419. package/dist/src/web/hooks/use-display-mode.js.map +0 -1
  420. package/dist/src/web/hooks/use-display-mode.test.js.map +0 -1
  421. package/dist/src/web/hooks/use-files.d.ts +0 -10
  422. package/dist/src/web/hooks/use-files.js +0 -7
  423. package/dist/src/web/hooks/use-files.js.map +0 -1
  424. package/dist/src/web/hooks/use-files.test.js +0 -29
  425. package/dist/src/web/hooks/use-files.test.js.map +0 -1
  426. package/dist/src/web/hooks/use-layout.js.map +0 -1
  427. package/dist/src/web/hooks/use-layout.test.js +0 -46
  428. package/dist/src/web/hooks/use-layout.test.js.map +0 -1
  429. package/dist/src/web/hooks/use-open-external.d.ts +0 -1
  430. package/dist/src/web/hooks/use-open-external.js +0 -6
  431. package/dist/src/web/hooks/use-open-external.js.map +0 -1
  432. package/dist/src/web/hooks/use-open-external.test.js +0 -24
  433. package/dist/src/web/hooks/use-open-external.test.js.map +0 -1
  434. package/dist/src/web/hooks/use-openai-global.d.ts +0 -3
  435. package/dist/src/web/hooks/use-openai-global.js +0 -6
  436. package/dist/src/web/hooks/use-openai-global.js.map +0 -1
  437. package/dist/src/web/hooks/use-request-modal.d.ts +0 -9
  438. package/dist/src/web/hooks/use-request-modal.js +0 -14
  439. package/dist/src/web/hooks/use-request-modal.js.map +0 -1
  440. package/dist/src/web/hooks/use-request-modal.test.js.map +0 -1
  441. package/dist/src/web/hooks/use-send-follow-up-message.d.ts +0 -1
  442. package/dist/src/web/hooks/use-send-follow-up-message.js +0 -11
  443. package/dist/src/web/hooks/use-send-follow-up-message.js.map +0 -1
  444. package/dist/src/web/hooks/use-tool-info.d.ts +0 -25
  445. package/dist/src/web/hooks/use-tool-info.js +0 -20
  446. package/dist/src/web/hooks/use-tool-info.js.map +0 -1
  447. package/dist/src/web/hooks/use-tool-info.test-d.js.map +0 -1
  448. package/dist/src/web/hooks/use-tool-info.test.js +0 -60
  449. package/dist/src/web/hooks/use-tool-info.test.js.map +0 -1
  450. package/dist/src/web/hooks/use-user.js +0 -19
  451. package/dist/src/web/hooks/use-user.js.map +0 -1
  452. package/dist/src/web/hooks/use-user.test.js +0 -44
  453. package/dist/src/web/hooks/use-user.test.js.map +0 -1
  454. package/dist/src/web/hooks/use-widget-state.d.ts +0 -4
  455. package/dist/src/web/hooks/use-widget-state.js +0 -32
  456. package/dist/src/web/hooks/use-widget-state.js.map +0 -1
  457. package/dist/src/web/hooks/use-widget-state.test.js +0 -61
  458. package/dist/src/web/hooks/use-widget-state.test.js.map +0 -1
  459. package/dist/src/web/index.js.map +0 -1
  460. package/dist/src/web/mount-widget.d.ts +0 -1
  461. package/dist/src/web/mount-widget.js +0 -19
  462. package/dist/src/web/mount-widget.js.map +0 -1
  463. package/dist/src/web/plugin/data-llm.test.js.map +0 -1
  464. package/dist/src/web/plugin/plugin.d.ts +0 -2
  465. package/dist/src/web/plugin/plugin.js +0 -39
  466. package/dist/src/web/plugin/plugin.js.map +0 -1
  467. package/dist/src/web/plugin/transform-data-llm.js.map +0 -1
  468. package/dist/src/web/plugin/transform-data-llm.test.js.map +0 -1
  469. package/dist/src/web/proxy.js.map +0 -1
  470. package/dist/src/web/types.d.ts +0 -151
  471. package/dist/src/web/types.js.map +0 -1
  472. package/dist/vitest.config.d.ts +0 -2
  473. package/dist/vitest.config.js +0 -8
  474. package/dist/vitest.config.js.map +0 -1
  475. /package/dist/{src/test/widget.test.d.ts → cli/build-helpers.test.d.ts} +0 -0
  476. /package/dist/{src/web/bridges/hooks/use-mcp-app-bridge.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  477. /package/dist/{src/web/create-store.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
  478. /package/dist/{src/web/data-llm.test.d.ts → cli/tunnel.test.d.ts} +0 -0
  479. /package/dist/{src/web/bridges → cli}/types.js +0 -0
  480. /package/dist/{src/web/generate-helpers.test-d.d.ts → server/asset-base-url-transform-plugin.test.d.ts} +0 -0
  481. /package/dist/{src/web/generate-helpers.test.d.ts → server/build-manifest.test.d.ts} +0 -0
  482. /package/dist/{src/web/helpers/state.test.d.ts → server/content-helpers.test.d.ts} +0 -0
  483. /package/dist/{src/web/hooks/use-call-tool.test-d.d.ts → server/express.test.d.ts} +0 -0
  484. /package/dist/{src/server → server}/inferUtilityTypes.js +0 -0
  485. /package/dist/{src/web/hooks/use-call-tool.test.d.ts → server/middleware.test-d.d.ts} +0 -0
  486. /package/dist/{src/web/hooks/use-display-mode.test.d.ts → server/middleware.test.d.ts} +0 -0
  487. /package/dist/{src/web/hooks/use-files.test.d.ts → server/tunnel-proxy-router.test.d.ts} +0 -0
  488. /package/dist/{src/web/hooks/use-layout.test.d.ts → test/view.test.d.ts} +0 -0
  489. /package/dist/{src/web/hooks/use-open-external.test.d.ts → web/bridges/mcp-app/use-mcp-app-context.test.d.ts} +0 -0
  490. /package/dist/{src/web/hooks/use-request-modal.test.d.ts → web/bridges/mcp-app/view-tools.test.d.ts} +0 -0
  491. /package/dist/{src/web/hooks/use-tool-info.test-d.d.ts → web/create-store.test.d.ts} +0 -0
  492. /package/dist/{src/web/plugin → web}/data-llm.test.d.ts +0 -0
  493. /package/dist/{src/web/hooks/use-tool-info.test.d.ts → web/generate-helpers.test-d.d.ts} +0 -0
  494. /package/dist/{src/web/hooks/use-user.test.d.ts → web/generate-helpers.test.d.ts} +0 -0
  495. /package/dist/{src/web → web}/generate-helpers.test.js +0 -0
  496. /package/dist/{src/web/hooks/use-widget-state.test.d.ts → web/helpers/state.test.d.ts} +0 -0
  497. /package/dist/{src/web/plugin/transform-data-llm.test.d.ts → web/hooks/use-call-tool.test-d.d.ts} +0 -0
  498. /package/dist/{src/web → web}/hooks/use-call-tool.test-d.js +0 -0
  499. /package/dist/{src/web → web}/hooks/use-display-mode.test.js +0 -0
  500. /package/dist/{src/web → web}/plugin/data-llm.test.js +0 -0
  501. /package/dist/{src/web → web}/plugin/transform-data-llm.d.ts +0 -0
  502. /package/dist/{src/web → web}/plugin/transform-data-llm.test.js +0 -0
  503. /package/dist/{src/web → web}/proxy.d.ts +0 -0
@@ -0,0 +1,656 @@
1
+ import crypto from "node:crypto";
2
+ import { readFileSync } from "node:fs";
3
+ import http from "node:http";
4
+ import path from "node:path";
5
+ import { Server as SdkServer, } from "@modelcontextprotocol/sdk/server/index.js";
6
+ import { McpServer as McpServerBase } from "@modelcontextprotocol/sdk/server/mcp.js";
7
+ import { mergeWith, union } from "es-toolkit";
8
+ import express, {} from "express";
9
+ import { createApp } from "./express.js";
10
+ import { createMiddlewareEntry } from "./metric.js";
11
+ import { buildMiddlewareChain, getHandlerMaps } from "./middleware.js";
12
+ import { templateHelper } from "./templateHelper.js";
13
+ const mergeWithUnion = (target, source) => {
14
+ return mergeWith(target, source, (targetVal, sourceVal) => {
15
+ if (Array.isArray(targetVal) && Array.isArray(sourceVal)) {
16
+ return union(targetVal, sourceVal);
17
+ }
18
+ });
19
+ };
20
+ /**
21
+ * Drop the query string from a `ui://` view URI, leaving the bare path. The
22
+ * `?v=` cache key is the only query we append, so a plain split is enough and
23
+ * sidesteps `URL` normalization quirks on the non-special `ui:` scheme.
24
+ */
25
+ function stripQuery(uri) {
26
+ const queryIndex = uri.indexOf("?");
27
+ return queryIndex === -1 ? uri : uri.slice(0, queryIndex);
28
+ }
29
+ /**
30
+ * Coerce a tool handler's return value into an MCP `content` array. Strings
31
+ * become a single `TextContent`; a single block is wrapped in an array;
32
+ * `undefined` produces `[]`. Mostly used internally — exported so consumers
33
+ * who build content lazily can apply the same normalization.
34
+ */
35
+ export function normalizeContent(content) {
36
+ if (content === undefined) {
37
+ return [];
38
+ }
39
+ if (typeof content === "string") {
40
+ return [{ type: "text", text: content }];
41
+ }
42
+ if (Array.isArray(content)) {
43
+ return content;
44
+ }
45
+ return [content];
46
+ }
47
+ const McpServerBaseOmitted = McpServerBase;
48
+ /**
49
+ * The Skybridge server. Extends the MCP SDK's `McpServer` with a typed tool
50
+ * registry, view resources, an embedded Express app, and protocol-level
51
+ * middleware. Construct it with the same `Implementation` info you would pass
52
+ * to the SDK, chain {@link McpServer.registerTool} calls to declare tools,
53
+ * then call {@link McpServer.run} to start the HTTP server.
54
+ *
55
+ * The `TTools` generic accumulates each registered tool's input/output/meta
56
+ * shape, so `typeof server` carries enough information for view-side helpers
57
+ * like {@link generateHelpers} to produce fully-typed hooks.
58
+ *
59
+ * @typeParam TTools - Accumulated tool registry. Filled in by `registerTool`
60
+ * chaining; you almost never set this manually.
61
+ *
62
+ * @example
63
+ * ```ts
64
+ * const server = new McpServer({ name: "my-app", version: "1.0.0" }, {})
65
+ * .registerTool({
66
+ * name: "search",
67
+ * inputSchema: { query: z.string() },
68
+ * view: { component: "search" },
69
+ * }, async ({ query }) => ({ content: `Results for ${query}` }));
70
+ *
71
+ * await server.run();
72
+ * export type AppType = typeof server;
73
+ * ```
74
+ *
75
+ * @see https://docs.skybridge.tech/api-reference/mcp-server
76
+ */
77
+ // Side channel populated by `dist/__entry.js` before user code is imported.
78
+ // Set at module scope rather than passed through the constructor because the
79
+ // wrapper has the manifest before the user's `new McpServer(...)` runs, and
80
+ // threading it through every call site (including user templates) is exactly
81
+ // the boilerplate this design is trying to hide.
82
+ let pendingBuildManifest = null;
83
+ /**
84
+ * Prime the build-time Vite manifest before user code constructs its
85
+ * `McpServer`. Called from the generated `dist/__entry.js`; not part of the
86
+ * user-facing API.
87
+ *
88
+ * @internal
89
+ */
90
+ export function __setBuildManifest(manifest) {
91
+ pendingBuildManifest = manifest;
92
+ }
93
+ export class McpServer extends McpServerBaseOmitted {
94
+ /**
95
+ * The underlying Express app. Use this to extend the HTTP server with
96
+ * custom routes, middleware, or settings — e.g.
97
+ * `server.express.get("/health", ...)`.
98
+ *
99
+ * `express.json()` is pre-applied — tune it via the constructor's third
100
+ * argument, e.g. `new McpServer(info, {}, { json: { limit: "10mb" } })`.
101
+ * Register your handlers before `run()`;
102
+ * after `run()`, dev-mode middleware, the `/mcp` route, and the default
103
+ * error handler are appended in that order.
104
+ *
105
+ * Note: Alpic Cloud only routes traffic to `/mcp` — custom routes work
106
+ * locally and on self-hosted deployments.
107
+ */
108
+ express;
109
+ customErrorMiddleware = [];
110
+ mcpMiddlewareEntries = [];
111
+ mcpMiddlewareApplied = false;
112
+ claimedViews = new Map();
113
+ viewMetaBuilders = new Map();
114
+ /**
115
+ * Maps a view resource's query-less path to its canonical registered URI
116
+ * (the one carrying the `?v=` cache key). Lets `resources/read` resolve the
117
+ * underlying view no matter which version param the consumer sends, since
118
+ * the param is only a cache key, not part of the resource's identity.
119
+ */
120
+ viewUriByPath = new Map();
121
+ viteManifest = null;
122
+ serverInfo;
123
+ serverOptions;
124
+ constructor(serverInfo, options, skybridgeOptions) {
125
+ super(serverInfo, options);
126
+ this.serverInfo = serverInfo;
127
+ this.serverOptions = options;
128
+ this.express = express();
129
+ this.express.use(express.json(skybridgeOptions?.json));
130
+ // Pick up the manifest if `dist/__entry.js` primed it before importing
131
+ // user code. Consume-once: clear after the first construction so a
132
+ // subsequent test that doesn't prime can't inherit stale state.
133
+ // Explicit `setViteManifest` calls still win because they happen after
134
+ // construction.
135
+ if (pendingBuildManifest) {
136
+ this.setViteManifest(pendingBuildManifest);
137
+ pendingBuildManifest = null;
138
+ }
139
+ }
140
+ use(pathOrHandler, ...handlers) {
141
+ // Branching is load-bearing: Express's `app.use` overloads can't be
142
+ // resolved against a `string | RequestHandler` union, so we narrow.
143
+ if (typeof pathOrHandler === "string") {
144
+ this.express.use(pathOrHandler, ...handlers);
145
+ }
146
+ else {
147
+ this.express.use(pathOrHandler, ...handlers);
148
+ }
149
+ return this;
150
+ }
151
+ useOnError(pathOrHandler, ...handlers) {
152
+ if (typeof pathOrHandler === "string") {
153
+ this.customErrorMiddleware.push({ path: pathOrHandler, handlers });
154
+ }
155
+ else {
156
+ this.customErrorMiddleware.push({
157
+ handlers: [pathOrHandler, ...handlers],
158
+ });
159
+ }
160
+ return this;
161
+ }
162
+ mcpMiddleware(filterOrHandler,
163
+ // biome-ignore lint/suspicious/noExplicitAny: overloads narrow the handler type at call sites; implementation must accept all variants
164
+ maybeHandler) {
165
+ if (this.mcpMiddlewareApplied) {
166
+ throw new Error("Cannot register MCP middleware after run() or connect() has been called");
167
+ }
168
+ const handler = maybeHandler;
169
+ if (typeof filterOrHandler === "function") {
170
+ this.mcpMiddlewareEntries.push({
171
+ filter: null,
172
+ handler: filterOrHandler,
173
+ });
174
+ }
175
+ else if (handler) {
176
+ this.mcpMiddlewareEntries.push({
177
+ filter: filterOrHandler,
178
+ handler,
179
+ });
180
+ }
181
+ else {
182
+ throw new Error("mcpMiddleware requires a handler function when a filter is provided");
183
+ }
184
+ return this;
185
+ }
186
+ applyMcpMiddleware() {
187
+ if (this.mcpMiddlewareApplied) {
188
+ return;
189
+ }
190
+ this.mcpMiddlewareApplied = true;
191
+ // Surface view-resource _meta on `resources/list` (per ext-apps spec:
192
+ // hosts/checkers read CSP & domain at list time before fetching content).
193
+ const viewListMetaEntry = {
194
+ filter: "resources/list",
195
+ handler: async (_req, extra, next) => {
196
+ const result = (await next());
197
+ for (const resource of result.resources) {
198
+ const builder = this.viewMetaBuilders.get(resource.uri);
199
+ if (!builder) {
200
+ continue;
201
+ }
202
+ const meta = builder(extra);
203
+ resource._meta = {
204
+ ...(resource._meta ?? {}),
205
+ ...meta,
206
+ };
207
+ }
208
+ return result;
209
+ },
210
+ };
211
+ // Resolve a view's `resources/read` by its query-less path so the
212
+ // underlying asset is served no matter the `?v=` value (stale cache key,
213
+ // no param, etc.). The version param is a cache-busting hint for external
214
+ // consumers; it must not gate resolution. We rewrite the lookup URI to the
215
+ // canonical registered one, then restore the requested URI on the response
216
+ // so the consumer-facing URI is never rewritten.
217
+ const viewReadResolveEntry = {
218
+ filter: "resources/read",
219
+ handler: async (req, _extra, next) => {
220
+ const requested = req.params.uri;
221
+ if (typeof requested !== "string") {
222
+ return next();
223
+ }
224
+ const path = stripQuery(requested);
225
+ const canonical = this.viewUriByPath.get(path);
226
+ if (!canonical) {
227
+ return next();
228
+ }
229
+ req.params.uri = canonical;
230
+ try {
231
+ const result = (await next());
232
+ for (const content of result.contents ?? []) {
233
+ if (typeof content.uri === "string" &&
234
+ stripQuery(content.uri) === path) {
235
+ content.uri = requested;
236
+ }
237
+ }
238
+ return result;
239
+ }
240
+ finally {
241
+ // Restore the shared request params so middleware outer to us never
242
+ // observes the rewritten lookup URI after next() unwinds.
243
+ req.params.uri = requested;
244
+ }
245
+ },
246
+ };
247
+ const monitoringEntry = createMiddlewareEntry();
248
+ const entries = [
249
+ ...(monitoringEntry ? [monitoringEntry] : []),
250
+ viewListMetaEntry,
251
+ viewReadResolveEntry,
252
+ ...this.mcpMiddlewareEntries,
253
+ ];
254
+ if (entries.length === 0) {
255
+ return;
256
+ }
257
+ const { requestHandlers, notificationHandlers } = getHandlerMaps(this.server);
258
+ const instrumentMap = (map, isNotification) => {
259
+ for (const [method, handler] of map) {
260
+ map.set(method, buildMiddlewareChain(method, isNotification, handler, entries));
261
+ }
262
+ const originalSet = map.set.bind(map);
263
+ map.set = (method, handler) => originalSet(method, buildMiddlewareChain(method, isNotification, handler, entries));
264
+ };
265
+ instrumentMap(requestHandlers, false);
266
+ instrumentMap(notificationHandlers, true);
267
+ }
268
+ /**
269
+ * Connect to an MCP transport (override of the SDK's `connect`). Use this
270
+ * when you're embedding Skybridge in a host that already manages its own
271
+ * transport (e.g. stdio for desktop apps); for HTTP, prefer {@link McpServer.run}
272
+ * which sets the transport up for you. Locks in any middleware registered
273
+ * via {@link McpServer.mcpMiddleware} — further calls to that method will
274
+ * throw afterwards.
275
+ */
276
+ async connect(transport) {
277
+ this.applyMcpMiddleware();
278
+ return McpServerBase.prototype.connect.call(this, transport);
279
+ }
280
+ /**
281
+ * Per-request stateless connect. The SDK's `Protocol` only allows one
282
+ * transport per instance, so we can't reuse this `McpServer` across
283
+ * concurrent requests. The SDK's idiomatic fix is a `() => McpServer`
284
+ * factory, but that would break Skybridge's singleton API — so instead
285
+ * we build a fresh underlying `Server` per request and share the main
286
+ * server's handler maps by reference. The cast is unavoidable: there's
287
+ * no public API to inject handler maps. `getHandlerMaps` validates the
288
+ * read side and fails fast on SDK field renames.
289
+ */
290
+ async connectStatelessTransport(transport) {
291
+ this.applyMcpMiddleware();
292
+ const { requestHandlers, notificationHandlers } = getHandlerMaps(this.server);
293
+ const fresh = new SdkServer(this.serverInfo, this.serverOptions);
294
+ const target = fresh;
295
+ target._requestHandlers = requestHandlers;
296
+ target._notificationHandlers = notificationHandlers;
297
+ await fresh.connect(transport);
298
+ }
299
+ /**
300
+ * Start the HTTP server. Listens on `process.env.__PORT` (default `3000`),
301
+ * mounts the `/mcp` route, applies any custom Express middleware registered
302
+ * via {@link McpServer.use} / {@link McpServer.useOnError}, and locks in
303
+ * any MCP middleware registered via {@link McpServer.mcpMiddleware}.
304
+ *
305
+ * On Cloudflare Workers / workerd, returns an object exposing `fetch` so
306
+ * the runtime can bridge incoming requests to the Node HTTP server. On
307
+ * Vercel (`VERCEL === "1"`), returns the Express app directly so the
308
+ * serverless function entry can call it as a `(req, res)` handler. On
309
+ * Node, returns `undefined` once listening.
310
+ */
311
+ async run() {
312
+ this.applyMcpMiddleware();
313
+ if (process.env.VERCEL === "1") {
314
+ // createApp only reads httpServer inside its dev-only branch
315
+ // (viewsDevServer); under VERCEL=1 + NODE_ENV=production it's a
316
+ // bare object passed to satisfy the required parameter.
317
+ const httpServer = http.createServer();
318
+ await createApp({
319
+ mcpServer: this,
320
+ httpServer,
321
+ errorMiddleware: this.customErrorMiddleware,
322
+ });
323
+ return this.express;
324
+ }
325
+ const httpServer = http.createServer();
326
+ await createApp({
327
+ mcpServer: this,
328
+ httpServer,
329
+ errorMiddleware: this.customErrorMiddleware,
330
+ });
331
+ httpServer.on("request", this.express);
332
+ const port = parseInt(process.env.__PORT ?? "3000", 10);
333
+ await new Promise((resolve, reject) => {
334
+ httpServer.on("error", (error) => {
335
+ console.error("Failed to start server:", error);
336
+ reject(error);
337
+ });
338
+ httpServer.listen(port, () => {
339
+ resolve();
340
+ });
341
+ });
342
+ // On workerd, bridge the Node http server to a Workers fetch handler.
343
+ // The specifier is held in a variable to sidestep tsc's module resolution
344
+ // (`cloudflare:node` only exists under wrangler/workerd).
345
+ if (typeof navigator !== "undefined" &&
346
+ navigator.userAgent === "Cloudflare-Workers") {
347
+ const cloudflareNode = "cloudflare:node";
348
+ const { httpServerHandler } = await import(cloudflareNode);
349
+ return httpServerHandler({ port });
350
+ }
351
+ const shutdown = () => {
352
+ // Drop both handlers so a second signal falls through to Node's default
353
+ // (force-quit on a second Ctrl+C while drain is hanging).
354
+ process.off("SIGTERM", shutdown);
355
+ process.off("SIGINT", shutdown);
356
+ httpServer.close(() => process.exit(0));
357
+ // Force exit if connections don't drain in time so the port is still
358
+ // released promptly (e.g. for nodemon restarts).
359
+ setTimeout(() => process.exit(0), 3000).unref();
360
+ };
361
+ process.on("SIGTERM", shutdown);
362
+ process.on("SIGINT", shutdown);
363
+ return undefined;
364
+ }
365
+ enforceOneToolPerView(component, toolName) {
366
+ const existingTool = this.claimedViews.get(component);
367
+ if (existingTool) {
368
+ throw new Error(`skybridge: view "${component}" is already used by tool "${existingTool}". Tool "${toolName}" cannot also reference it — each view backs exactly one tool.`);
369
+ }
370
+ this.claimedViews.set(component, toolName);
371
+ }
372
+ resolveViewRequestContext(extra) {
373
+ const isProduction = process.env.NODE_ENV === "production";
374
+ const headers = extra?.requestInfo?.headers || {};
375
+ const header = (key) => {
376
+ const val = headers[key];
377
+ return Array.isArray(val) ? val[0] : val;
378
+ };
379
+ const isClaude = header("user-agent") === "Claude-User";
380
+ let serverUrl;
381
+ const forwardedHost = header("x-forwarded-host");
382
+ const origin = header("origin");
383
+ const host = header("host");
384
+ if (forwardedHost) {
385
+ const proto = header("x-forwarded-proto") || "https";
386
+ serverUrl = `${proto}://${forwardedHost}`;
387
+ }
388
+ else if (origin) {
389
+ serverUrl = origin;
390
+ }
391
+ else if (host) {
392
+ const proto = ["127.0.0.1:", "localhost:"].some((p) => host.startsWith(p))
393
+ ? "http"
394
+ : "https";
395
+ serverUrl = `${proto}://${host}`;
396
+ }
397
+ else {
398
+ const devPort = process.env.__PORT || "3000";
399
+ serverUrl = `http://localhost:${devPort}`;
400
+ }
401
+ const connectDomains = [serverUrl];
402
+ if (!isProduction) {
403
+ const wsUrl = new URL(serverUrl);
404
+ wsUrl.protocol = wsUrl.protocol === "https:" ? "wss:" : "ws:";
405
+ connectDomains.push(wsUrl.origin);
406
+ }
407
+ let contentMetaOverrides = {};
408
+ if (isClaude) {
409
+ const pathname = extra?.requestInfo?.url?.pathname ?? "";
410
+ const rawUrl = header("x-alpic-forwarded-url") ?? `${serverUrl}${pathname}`;
411
+ // Strip a lone trailing slash so the hash matches the connector URL
412
+ // as registered with Claude (which has no trailing slash on bare origins).
413
+ const url = rawUrl.endsWith("/") ? rawUrl.slice(0, -1) : rawUrl;
414
+ const hash = crypto
415
+ .createHash("sha256")
416
+ .update(url)
417
+ .digest("hex")
418
+ .slice(0, 32);
419
+ contentMetaOverrides = { domain: `${hash}.claudemcpcontent.com` };
420
+ }
421
+ return { serverUrl, connectDomains, contentMetaOverrides };
422
+ }
423
+ registerViewResources(toolName, view, toolMeta) {
424
+ const hosts = view.hosts ?? ["apps-sdk", "mcp-app"];
425
+ // Append a content-derived version param so hosts (e.g. ChatGPT) bust
426
+ // their cache when the bundle changes, but keep the URI stable across
427
+ // `tools/list` calls when the bundle hasn't changed.
428
+ const versionParam = this.computeViewVersionParam(view.component);
429
+ if (hosts.includes("apps-sdk")) {
430
+ const viewResource = {
431
+ hostType: "apps-sdk",
432
+ uri: `ui://views/apps-sdk/${view.component}.html${versionParam}`,
433
+ mimeType: "text/html+skybridge",
434
+ buildContentMeta: ({ resourceDomains, connectDomains, domain }, overrides) => {
435
+ const defaults = {
436
+ "openai/widgetCSP": {
437
+ resource_domains: resourceDomains,
438
+ connect_domains: connectDomains,
439
+ },
440
+ "openai/widgetDomain": domain,
441
+ "openai/widgetDescription": view.description,
442
+ };
443
+ const fromView = {
444
+ "openai/widgetCSP": {
445
+ resource_domains: view.csp?.resourceDomains,
446
+ connect_domains: view.csp?.connectDomains,
447
+ frame_domains: view.csp?.frameDomains,
448
+ redirect_domains: view.csp?.redirectDomains,
449
+ },
450
+ "openai/widgetDomain": view.domain,
451
+ "openai/widgetPrefersBorder": view.prefersBorder,
452
+ };
453
+ const base = mergeWithUnion(mergeWithUnion(defaults, fromView), {
454
+ "openai/widgetDomain": overrides.domain,
455
+ });
456
+ if (view._meta) {
457
+ return { ...base, ...view._meta };
458
+ }
459
+ return base;
460
+ },
461
+ };
462
+ this.registerViewResource({
463
+ name: toolName,
464
+ viewResource,
465
+ view,
466
+ });
467
+ toolMeta["openai/outputTemplate"] = viewResource.uri;
468
+ }
469
+ if (hosts.includes("mcp-app")) {
470
+ const viewResource = {
471
+ hostType: "mcp-app",
472
+ uri: `ui://views/ext-apps/${view.component}.html${versionParam}`,
473
+ mimeType: "text/html;profile=mcp-app",
474
+ buildContentMeta: ({ resourceDomains, connectDomains, domain, baseUriDomains }, overrides) => {
475
+ const defaults = {
476
+ ui: {
477
+ csp: {
478
+ resourceDomains,
479
+ connectDomains,
480
+ baseUriDomains,
481
+ },
482
+ domain,
483
+ },
484
+ };
485
+ const fromView = {
486
+ ui: {
487
+ ...(view.description && { description: view.description }),
488
+ ...(view.prefersBorder !== undefined && {
489
+ prefersBorder: view.prefersBorder,
490
+ }),
491
+ ...(view.domain && { domain: view.domain }),
492
+ csp: {
493
+ ...(view.csp?.resourceDomains && {
494
+ resourceDomains: view.csp.resourceDomains,
495
+ }),
496
+ ...(view.csp?.connectDomains && {
497
+ connectDomains: view.csp.connectDomains,
498
+ }),
499
+ ...(view.csp?.frameDomains && {
500
+ frameDomains: view.csp.frameDomains,
501
+ }),
502
+ ...(view.csp?.baseUriDomains && {
503
+ baseUriDomains: view.csp.baseUriDomains,
504
+ }),
505
+ ...(view.csp?.redirectDomains && {
506
+ redirectDomains: view.csp.redirectDomains,
507
+ }),
508
+ },
509
+ },
510
+ };
511
+ const base = mergeWithUnion(mergeWithUnion(defaults, fromView), {
512
+ ui: overrides,
513
+ });
514
+ if (view._meta) {
515
+ return { ...base, ...view._meta };
516
+ }
517
+ return base;
518
+ },
519
+ };
520
+ this.registerViewResource({
521
+ name: toolName,
522
+ viewResource,
523
+ view,
524
+ });
525
+ // @ts-expect-error - For backwards compatibility with Claude current implementation of the specs
526
+ toolMeta["ui/resourceUri"] = viewResource.uri;
527
+ toolMeta.ui = { ...toolMeta.ui, resourceUri: viewResource.uri };
528
+ }
529
+ }
530
+ registerViewResource({ name, viewResource, view, }) {
531
+ const { hostType, uri: viewUri, mimeType, buildContentMeta } = viewResource;
532
+ const buildMeta = (extra) => {
533
+ const { serverUrl, connectDomains, contentMetaOverrides } = this.resolveViewRequestContext(extra);
534
+ return buildContentMeta({
535
+ resourceDomains: [serverUrl],
536
+ connectDomains,
537
+ domain: serverUrl,
538
+ baseUriDomains: [serverUrl],
539
+ }, contentMetaOverrides);
540
+ };
541
+ this.viewMetaBuilders.set(viewUri, buildMeta);
542
+ this.viewUriByPath.set(stripQuery(viewUri), viewUri);
543
+ this.registerResource(name, viewUri, { description: view.description }, async (uri, extra) => {
544
+ const isProduction = process.env.NODE_ENV === "production";
545
+ const { serverUrl } = this.resolveViewRequestContext(extra);
546
+ const html = isProduction
547
+ ? templateHelper.renderProduction({
548
+ hostType,
549
+ serverUrl,
550
+ viewFile: this.lookupViewFile(view.component),
551
+ styleFile: this.lookupDistFile("style.css") ?? "",
552
+ })
553
+ : templateHelper.renderDevelopment({
554
+ hostType,
555
+ serverUrl,
556
+ viewName: view.component,
557
+ });
558
+ return {
559
+ contents: [
560
+ { uri: uri.href, mimeType, text: html, _meta: buildMeta(extra) },
561
+ ],
562
+ };
563
+ });
564
+ }
565
+ wrapHandler(cb, { attachViewUUID }) {
566
+ return async (args, extra) => {
567
+ const result = await cb(args, extra);
568
+ return {
569
+ ...result,
570
+ content: normalizeContent(result.content),
571
+ ...(attachViewUUID && {
572
+ _meta: {
573
+ ...result._meta,
574
+ viewUUID: crypto.randomUUID(),
575
+ },
576
+ }),
577
+ };
578
+ };
579
+ }
580
+ computeViewVersionParam(viewName) {
581
+ if (process.env.NODE_ENV !== "production") {
582
+ return "";
583
+ }
584
+ try {
585
+ const viewFile = this.lookupViewFile(viewName);
586
+ const styleFile = this.lookupDistFile("style.css") ?? "";
587
+ const hash = crypto
588
+ .createHash("sha256")
589
+ .update(viewFile)
590
+ .update("\0")
591
+ .update(styleFile)
592
+ .digest("hex")
593
+ .slice(0, 8);
594
+ return `?v=${hash}`;
595
+ }
596
+ catch {
597
+ return "";
598
+ }
599
+ }
600
+ lookupViewFile(viewName) {
601
+ const manifest = this.readManifest();
602
+ for (const entry of Object.values(manifest)) {
603
+ if (entry?.isEntry && entry.name === viewName && entry.file) {
604
+ return entry.file;
605
+ }
606
+ }
607
+ throw new Error(`View "${viewName}" not found in Vite manifest. Did the build complete successfully? Look for an entry with name "${viewName}" in dist/assets/.vite/manifest.json.`);
608
+ }
609
+ lookupDistFile(key) {
610
+ const manifest = this.readManifest();
611
+ return manifest[key]?.file;
612
+ }
613
+ /**
614
+ * Inject the Vite manifest as a value rather than letting `readManifest()`
615
+ * load it from disk. Required for runtimes without a usable filesystem
616
+ * (Cloudflare Workers, etc.) — the user's `skybridge build` emits the
617
+ * manifest as a JS module which the entry imports and passes here.
618
+ */
619
+ setViteManifest(manifest) {
620
+ this.viteManifest = manifest;
621
+ return this;
622
+ }
623
+ readManifest() {
624
+ if (this.viteManifest) {
625
+ return this.viteManifest;
626
+ }
627
+ return JSON.parse(readFileSync(path.join(process.cwd(), "dist", "assets", ".vite", "manifest.json"), "utf-8"));
628
+ }
629
+ registerTool(...args) {
630
+ const baseFn = McpServerBase.prototype.registerTool;
631
+ if (typeof args[0] === "string") {
632
+ baseFn.call(this, args[0], args[1], args[2]);
633
+ return this;
634
+ }
635
+ const config = args[0];
636
+ const cb = args[1];
637
+ const { name, view, securitySchemes, _meta: userToolMeta, ...toolFields } = config;
638
+ const toolMeta = { ...userToolMeta };
639
+ if (securitySchemes) {
640
+ // SEP-1488 puts `securitySchemes` at the top level of the tool
641
+ // descriptor, but the SDK's `registerTool` drops unknown top-level
642
+ // fields, so the canonical spot isn't reachable without intercepting
643
+ // `tools/list`. Use the `_meta` back-compat mirror documented in the
644
+ // Apps SDK reference until SEP-1488 lands in the spec.
645
+ toolMeta.securitySchemes = securitySchemes;
646
+ }
647
+ if (view) {
648
+ this.enforceOneToolPerView(view.component, name);
649
+ this.registerViewResources(name, view, toolMeta);
650
+ }
651
+ const wrappedCb = this.wrapHandler(cb, { attachViewUUID: Boolean(view) });
652
+ baseFn.call(this, name, { ...toolFields, _meta: toolMeta }, wrappedCb);
653
+ return this;
654
+ }
655
+ }
656
+ //# sourceMappingURL=server.js.map