skybridge 0.0.0-dev.db67c37 → 0.0.0-dev.dbab7df

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 (504) hide show
  1. package/README.md +126 -116
  2. package/dist/cli/build-helpers.d.ts +11 -0
  3. package/dist/cli/build-helpers.js +107 -0
  4. package/dist/cli/build-helpers.js.map +1 -0
  5. package/dist/cli/build-helpers.test.js +132 -0
  6. package/dist/cli/build-helpers.test.js.map +1 -0
  7. package/dist/cli/build-steps.d.ts +2 -0
  8. package/dist/cli/build-steps.js +73 -0
  9. package/dist/cli/build-steps.js.map +1 -0
  10. package/dist/cli/build-steps.test.js +52 -0
  11. package/dist/cli/build-steps.test.js.map +1 -0
  12. package/dist/cli/detect-port.d.ts +2 -2
  13. package/dist/cli/detect-port.js +9 -20
  14. package/dist/cli/detect-port.js.map +1 -1
  15. package/dist/cli/header.d.ts +1 -1
  16. package/dist/cli/header.js +1 -1
  17. package/dist/cli/header.js.map +1 -1
  18. package/dist/cli/resolve-skybridge-config.d.ts +5 -0
  19. package/dist/cli/resolve-skybridge-config.js +18 -0
  20. package/dist/cli/resolve-skybridge-config.js.map +1 -0
  21. package/dist/cli/run-command.js.map +1 -1
  22. package/dist/cli/run-plain.d.ts +18 -0
  23. package/dist/cli/run-plain.js +89 -0
  24. package/dist/cli/run-plain.js.map +1 -0
  25. package/dist/cli/telemetry.js.map +1 -1
  26. package/dist/cli/tunnel-control-server.d.ts +9 -0
  27. package/dist/cli/tunnel-control-server.js +31 -0
  28. package/dist/cli/tunnel-control-server.js.map +1 -0
  29. package/dist/cli/tunnel-control-server.test.js +39 -0
  30. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  31. package/dist/cli/tunnel-handler.d.ts +3 -0
  32. package/dist/cli/tunnel-handler.js +48 -0
  33. package/dist/cli/tunnel-handler.js.map +1 -0
  34. package/dist/cli/tunnel-handler.test.js +105 -0
  35. package/dist/cli/tunnel-handler.test.js.map +1 -0
  36. package/dist/cli/tunnel.d.ts +57 -0
  37. package/dist/cli/tunnel.js +154 -0
  38. package/dist/cli/tunnel.js.map +1 -0
  39. package/dist/cli/tunnel.test.js +190 -0
  40. package/dist/cli/tunnel.test.js.map +1 -0
  41. package/dist/cli/types.d.ts +5 -0
  42. package/dist/cli/types.js +2 -0
  43. package/dist/cli/types.js.map +1 -0
  44. package/dist/cli/use-execute-steps.d.ts +1 -1
  45. package/dist/cli/use-execute-steps.js.map +1 -1
  46. package/dist/cli/use-messages.d.ts +3 -0
  47. package/dist/cli/use-messages.js +11 -0
  48. package/dist/cli/use-messages.js.map +1 -0
  49. package/dist/cli/use-nodemon.d.ts +16 -6
  50. package/dist/cli/use-nodemon.js +74 -59
  51. package/dist/cli/use-nodemon.js.map +1 -1
  52. package/dist/cli/use-open-browser.d.ts +1 -0
  53. package/dist/cli/use-open-browser.js +44 -0
  54. package/dist/cli/use-open-browser.js.map +1 -0
  55. package/dist/cli/use-tunnel.d.ts +14 -0
  56. package/dist/cli/use-tunnel.js +131 -0
  57. package/dist/cli/use-tunnel.js.map +1 -0
  58. package/dist/cli/use-typescript-check.d.ts +9 -2
  59. package/dist/cli/use-typescript-check.js +89 -51
  60. package/dist/cli/use-typescript-check.js.map +1 -1
  61. package/dist/commands/build.d.ts +0 -3
  62. package/dist/commands/build.js +3 -18
  63. package/dist/commands/build.js.map +1 -1
  64. package/dist/commands/create.d.ts +9 -0
  65. package/dist/commands/create.js +30 -0
  66. package/dist/commands/create.js.map +1 -0
  67. package/dist/commands/dev.d.ts +4 -1
  68. package/dist/commands/dev.js +94 -8
  69. package/dist/commands/dev.js.map +1 -1
  70. package/dist/commands/start.js +13 -10
  71. package/dist/commands/start.js.map +1 -1
  72. package/dist/commands/telemetry/disable.js.map +1 -1
  73. package/dist/commands/telemetry/enable.js.map +1 -1
  74. package/dist/commands/telemetry/status.js.map +1 -1
  75. package/dist/context-warnings.d.ts +5 -0
  76. package/dist/context-warnings.js +31 -0
  77. package/dist/context-warnings.js.map +1 -0
  78. package/dist/context-warnings.test.js +28 -0
  79. package/dist/context-warnings.test.js.map +1 -0
  80. package/dist/server/app.d.ts +180 -0
  81. package/dist/server/app.js +266 -0
  82. package/dist/server/app.js.map +1 -0
  83. package/dist/server/asset-base-url-transform-plugin.d.ts +6 -6
  84. package/dist/server/asset-base-url-transform-plugin.js +25 -11
  85. package/dist/server/asset-base-url-transform-plugin.js.map +1 -1
  86. package/dist/server/asset-base-url-transform-plugin.test.js +92 -14
  87. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -1
  88. package/dist/server/auth/discovery.d.ts +33 -0
  89. package/dist/server/auth/discovery.js +56 -0
  90. package/dist/server/auth/discovery.js.map +1 -0
  91. package/dist/server/auth/discovery.test.d.ts +1 -0
  92. package/dist/server/auth/discovery.test.js +93 -0
  93. package/dist/server/auth/discovery.test.js.map +1 -0
  94. package/dist/server/auth/index.d.ts +30 -0
  95. package/dist/server/auth/index.js +2 -0
  96. package/dist/server/auth/index.js.map +1 -0
  97. package/dist/server/auth/providers/auth0.d.ts +40 -0
  98. package/dist/server/auth/providers/auth0.js +31 -0
  99. package/dist/server/auth/providers/auth0.js.map +1 -0
  100. package/dist/server/auth/providers/auth0.test.d.ts +1 -0
  101. package/dist/server/auth/providers/auth0.test.js +50 -0
  102. package/dist/server/auth/providers/auth0.test.js.map +1 -0
  103. package/dist/server/auth/providers/authplane.d.ts +49 -0
  104. package/dist/server/auth/providers/authplane.js +57 -0
  105. package/dist/server/auth/providers/authplane.js.map +1 -0
  106. package/dist/server/auth/providers/authplane.test.d.ts +1 -0
  107. package/dist/server/auth/providers/authplane.test.js +140 -0
  108. package/dist/server/auth/providers/authplane.test.js.map +1 -0
  109. package/dist/server/auth/providers/clerk.d.ts +51 -0
  110. package/dist/server/auth/providers/clerk.js +19 -0
  111. package/dist/server/auth/providers/clerk.js.map +1 -0
  112. package/dist/server/auth/providers/clerk.test.d.ts +1 -0
  113. package/dist/server/auth/providers/clerk.test.js +30 -0
  114. package/dist/server/auth/providers/clerk.test.js.map +1 -0
  115. package/dist/server/auth/providers/custom.d.ts +40 -0
  116. package/dist/server/auth/providers/custom.js +56 -0
  117. package/dist/server/auth/providers/custom.js.map +1 -0
  118. package/dist/server/auth/providers/custom.test.d.ts +1 -0
  119. package/dist/server/auth/providers/custom.test.js +158 -0
  120. package/dist/server/auth/providers/custom.test.js.map +1 -0
  121. package/dist/server/auth/providers/descope.d.ts +44 -0
  122. package/dist/server/auth/providers/descope.js +44 -0
  123. package/dist/server/auth/providers/descope.js.map +1 -0
  124. package/dist/server/auth/providers/descope.test.d.ts +1 -0
  125. package/dist/server/auth/providers/descope.test.js +62 -0
  126. package/dist/server/auth/providers/descope.test.js.map +1 -0
  127. package/dist/server/auth/providers/shared.d.ts +2 -0
  128. package/dist/server/auth/providers/shared.js +6 -0
  129. package/dist/server/auth/providers/shared.js.map +1 -0
  130. package/dist/server/auth/providers/shared.test.d.ts +1 -0
  131. package/dist/server/auth/providers/shared.test.js +10 -0
  132. package/dist/server/auth/providers/shared.test.js.map +1 -0
  133. package/dist/server/auth/providers/stytch.d.ts +25 -0
  134. package/dist/server/auth/providers/stytch.js +16 -0
  135. package/dist/server/auth/providers/stytch.js.map +1 -0
  136. package/dist/server/auth/providers/verify-spy.d.ts +12 -0
  137. package/dist/server/auth/providers/verify-spy.js +21 -0
  138. package/dist/server/auth/providers/verify-spy.js.map +1 -0
  139. package/dist/server/auth/providers/workos.d.ts +33 -0
  140. package/dist/server/auth/providers/workos.js +15 -0
  141. package/dist/server/auth/providers/workos.js.map +1 -0
  142. package/dist/server/auth/security-schemes.d.ts +23 -0
  143. package/dist/server/auth/security-schemes.js +64 -0
  144. package/dist/server/auth/security-schemes.js.map +1 -0
  145. package/dist/server/auth/security-schemes.test.d.ts +1 -0
  146. package/dist/server/auth/security-schemes.test.js +99 -0
  147. package/dist/server/auth/security-schemes.test.js.map +1 -0
  148. package/dist/server/auth/setup.d.ts +6 -0
  149. package/dist/server/auth/setup.js +91 -0
  150. package/dist/server/auth/setup.js.map +1 -0
  151. package/dist/server/auth/setup.test.d.ts +1 -0
  152. package/dist/server/auth/setup.test.js +512 -0
  153. package/dist/server/auth/setup.test.js.map +1 -0
  154. package/dist/server/auth/verify.d.ts +46 -0
  155. package/dist/server/auth/verify.js +62 -0
  156. package/dist/server/auth/verify.js.map +1 -0
  157. package/dist/server/auth/verify.test.d.ts +1 -0
  158. package/dist/server/auth/verify.test.js +149 -0
  159. package/dist/server/auth/verify.test.js.map +1 -0
  160. package/dist/server/auth-extra.test-d.d.ts +1 -0
  161. package/dist/server/auth-extra.test-d.js +70 -0
  162. package/dist/server/auth-extra.test-d.js.map +1 -0
  163. package/dist/server/auth.d.ts +57 -0
  164. package/dist/server/auth.js +27 -0
  165. package/dist/server/auth.js.map +1 -0
  166. package/dist/server/build-manifest.test.d.ts +1 -0
  167. package/dist/server/build-manifest.test.js +28 -0
  168. package/dist/server/build-manifest.test.js.map +1 -0
  169. package/dist/server/content-helpers.d.ts +67 -0
  170. package/dist/server/content-helpers.js +79 -0
  171. package/dist/server/content-helpers.js.map +1 -0
  172. package/dist/server/content-helpers.test.d.ts +1 -0
  173. package/dist/server/content-helpers.test.js +70 -0
  174. package/dist/server/content-helpers.test.js.map +1 -0
  175. package/dist/server/express.d.ts +9 -5
  176. package/dist/server/express.js +49 -44
  177. package/dist/server/express.js.map +1 -1
  178. package/dist/server/express.test.js +470 -25
  179. package/dist/server/express.test.js.map +1 -1
  180. package/dist/server/file-ref.d.ts +28 -0
  181. package/dist/server/file-ref.js +27 -0
  182. package/dist/server/file-ref.js.map +1 -0
  183. package/dist/server/host.d.ts +2 -0
  184. package/dist/server/host.js +11 -0
  185. package/dist/server/host.js.map +1 -0
  186. package/dist/server/host.test.d.ts +1 -0
  187. package/dist/server/host.test.js +13 -0
  188. package/dist/server/host.test.js.map +1 -0
  189. package/dist/server/index.d.ts +21 -4
  190. package/dist/server/index.js +16 -2
  191. package/dist/server/index.js.map +1 -1
  192. package/dist/server/inferUtilityTypes.d.ts +6 -6
  193. package/dist/server/inferUtilityTypes.js.map +1 -1
  194. package/dist/server/mcp-errors.test.d.ts +1 -0
  195. package/dist/server/mcp-errors.test.js +37 -0
  196. package/dist/server/mcp-errors.test.js.map +1 -0
  197. package/dist/server/metric.d.ts +14 -0
  198. package/dist/server/metric.js +62 -0
  199. package/dist/server/metric.js.map +1 -0
  200. package/dist/server/middleware.d.ts +80 -14
  201. package/dist/server/middleware.js +33 -0
  202. package/dist/server/middleware.js.map +1 -1
  203. package/dist/server/middleware.test-d.js +44 -21
  204. package/dist/server/middleware.test-d.js.map +1 -1
  205. package/dist/server/middleware.test.js +229 -53
  206. package/dist/server/middleware.test.js.map +1 -1
  207. package/dist/server/register-tool.test.d.ts +1 -0
  208. package/dist/server/register-tool.test.js +23 -0
  209. package/dist/server/register-tool.test.js.map +1 -0
  210. package/dist/server/requestOrigin.d.ts +7 -0
  211. package/dist/server/requestOrigin.js +25 -0
  212. package/dist/server/requestOrigin.js.map +1 -0
  213. package/dist/server/server.d.ts +377 -95
  214. package/dist/server/server.js +521 -209
  215. package/dist/server/server.js.map +1 -1
  216. package/dist/server/skills-integration.test.d.ts +1 -0
  217. package/dist/server/skills-integration.test.js +79 -0
  218. package/dist/server/skills-integration.test.js.map +1 -0
  219. package/dist/server/skills.d.ts +27 -0
  220. package/dist/server/skills.js +188 -0
  221. package/dist/server/skills.js.map +1 -0
  222. package/dist/server/skills.test.d.ts +1 -0
  223. package/dist/server/skills.test.js +243 -0
  224. package/dist/server/skills.test.js.map +1 -0
  225. package/dist/server/templateHelper.d.ts +5 -8
  226. package/dist/server/templateHelper.js +3 -22
  227. package/dist/server/templateHelper.js.map +1 -1
  228. package/dist/server/templates.generated.d.ts +4 -0
  229. package/dist/server/templates.generated.js +47 -0
  230. package/dist/server/templates.generated.js.map +1 -0
  231. package/dist/server/tool-extra.test.d.ts +1 -0
  232. package/dist/server/tool-extra.test.js +72 -0
  233. package/dist/server/tool-extra.test.js.map +1 -0
  234. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  235. package/dist/server/tunnel-proxy-router.js +110 -0
  236. package/dist/server/tunnel-proxy-router.js.map +1 -0
  237. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  238. package/dist/server/tunnel-proxy-router.test.js +229 -0
  239. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  240. package/dist/server/view-name.test-d.d.ts +1 -0
  241. package/dist/server/view-name.test-d.js +8 -0
  242. package/dist/server/view-name.test-d.js.map +1 -0
  243. package/dist/server/view-resource-resolution.test.d.ts +6 -0
  244. package/dist/server/view-resource-resolution.test.js +172 -0
  245. package/dist/server/view-resource-resolution.test.js.map +1 -0
  246. package/dist/server/viewsDevServer.d.ts +14 -0
  247. package/dist/server/viewsDevServer.js +48 -0
  248. package/dist/server/viewsDevServer.js.map +1 -0
  249. package/dist/standard-schema.d.ts +3 -0
  250. package/dist/standard-schema.js +2 -0
  251. package/dist/standard-schema.js.map +1 -0
  252. package/dist/test/utils.d.ts +21 -31
  253. package/dist/test/utils.js +55 -45
  254. package/dist/test/utils.js.map +1 -1
  255. package/dist/test/view.test.d.ts +1 -0
  256. package/dist/test/view.test.js +536 -0
  257. package/dist/test/view.test.js.map +1 -0
  258. package/dist/version.d.ts +1 -0
  259. package/dist/version.js +3 -0
  260. package/dist/version.js.map +1 -0
  261. package/dist/views/index.d.ts +3 -0
  262. package/dist/views/index.js +3 -0
  263. package/dist/views/index.js.map +1 -0
  264. package/dist/views/scan-views.d.ts +16 -0
  265. package/dist/views/scan-views.js +88 -0
  266. package/dist/views/scan-views.js.map +1 -0
  267. package/dist/views/scan-views.test.d.ts +1 -0
  268. package/dist/views/scan-views.test.js +99 -0
  269. package/dist/views/scan-views.test.js.map +1 -0
  270. package/dist/views/validate-view.d.ts +1 -0
  271. package/dist/views/validate-view.js +9 -0
  272. package/dist/views/validate-view.js.map +1 -0
  273. package/dist/views/validate-view.test.d.ts +1 -0
  274. package/dist/views/validate-view.test.js +24 -0
  275. package/dist/views/validate-view.test.js.map +1 -0
  276. package/dist/web/bridges/adaptor.d.ts +51 -0
  277. package/dist/web/bridges/adaptor.js +327 -0
  278. package/dist/web/bridges/adaptor.js.map +1 -0
  279. package/dist/web/bridges/adaptor.test.d.ts +1 -0
  280. package/dist/web/bridges/adaptor.test.js +225 -0
  281. package/dist/web/bridges/adaptor.test.js.map +1 -0
  282. package/dist/web/bridges/apps-sdk/bridge.d.ts +7 -2
  283. package/dist/web/bridges/apps-sdk/bridge.js +15 -3
  284. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -1
  285. package/dist/web/bridges/apps-sdk/index.d.ts +1 -2
  286. package/dist/web/bridges/apps-sdk/index.js +0 -1
  287. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  288. package/dist/web/bridges/apps-sdk/types.d.ts +22 -9
  289. package/dist/web/bridges/apps-sdk/types.js.map +1 -1
  290. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +11 -0
  291. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +11 -0
  292. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -1
  293. package/dist/web/bridges/get-adaptor.d.ts +7 -0
  294. package/dist/web/bridges/get-adaptor.js +9 -7
  295. package/dist/web/bridges/get-adaptor.js.map +1 -1
  296. package/dist/web/bridges/get-adaptor.test.d.ts +1 -0
  297. package/dist/web/bridges/get-adaptor.test.js +32 -0
  298. package/dist/web/bridges/get-adaptor.test.js.map +1 -0
  299. package/dist/web/bridges/index.js.map +1 -1
  300. package/dist/web/bridges/mcp-app/bridge.d.ts +27 -31
  301. package/dist/web/bridges/mcp-app/bridge.js +111 -203
  302. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  303. package/dist/web/bridges/mcp-app/bridge.test.d.ts +1 -0
  304. package/dist/web/bridges/mcp-app/bridge.test.js +17 -0
  305. package/dist/web/bridges/mcp-app/bridge.test.js.map +1 -0
  306. package/dist/web/bridges/mcp-app/index.d.ts +0 -1
  307. package/dist/web/bridges/mcp-app/index.js +0 -1
  308. package/dist/web/bridges/mcp-app/index.js.map +1 -1
  309. package/dist/web/bridges/mcp-app/types.d.ts +2 -0
  310. package/dist/web/bridges/mcp-app/types.js.map +1 -1
  311. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +17 -3
  312. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +14 -2
  313. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -1
  314. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +1 -41
  315. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -1
  316. package/dist/web/bridges/mcp-app/view-tools.test.d.ts +1 -0
  317. package/dist/web/bridges/mcp-app/view-tools.test.js +143 -0
  318. package/dist/web/bridges/mcp-app/view-tools.test.js.map +1 -0
  319. package/dist/web/bridges/types.d.ts +131 -11
  320. package/dist/web/bridges/types.js +14 -1
  321. package/dist/web/bridges/types.js.map +1 -1
  322. package/dist/web/bridges/types.test.d.ts +1 -0
  323. package/dist/web/bridges/types.test.js +19 -0
  324. package/dist/web/bridges/types.test.js.map +1 -0
  325. package/dist/web/bridges/use-host-context.d.ts +5 -0
  326. package/dist/web/bridges/use-host-context.js +5 -0
  327. package/dist/web/bridges/use-host-context.js.map +1 -1
  328. package/dist/web/components/modal-provider.d.ts +1 -1
  329. package/dist/web/components/modal-provider.js +5 -6
  330. package/dist/web/components/modal-provider.js.map +1 -1
  331. package/dist/web/create-store.d.ts +26 -0
  332. package/dist/web/create-store.js +43 -3
  333. package/dist/web/create-store.js.map +1 -1
  334. package/dist/web/create-store.test.js +30 -24
  335. package/dist/web/create-store.test.js.map +1 -1
  336. package/dist/web/data-llm.d.ts +35 -2
  337. package/dist/web/data-llm.js +31 -3
  338. package/dist/web/data-llm.js.map +1 -1
  339. package/dist/web/data-llm.test.js +43 -29
  340. package/dist/web/data-llm.test.js.map +1 -1
  341. package/dist/web/generate-helpers.d.ts +32 -27
  342. package/dist/web/generate-helpers.js +29 -24
  343. package/dist/web/generate-helpers.js.map +1 -1
  344. package/dist/web/generate-helpers.test-d.js +33 -31
  345. package/dist/web/generate-helpers.test-d.js.map +1 -1
  346. package/dist/web/generate-helpers.test.js +2 -2
  347. package/dist/web/generate-helpers.test.js.map +1 -1
  348. package/dist/web/helpers/state.d.ts +2 -2
  349. package/dist/web/helpers/state.js +11 -11
  350. package/dist/web/helpers/state.js.map +1 -1
  351. package/dist/web/helpers/state.test.js +9 -9
  352. package/dist/web/helpers/state.test.js.map +1 -1
  353. package/dist/web/hooks/index.d.ts +7 -2
  354. package/dist/web/hooks/index.js +7 -2
  355. package/dist/web/hooks/index.js.map +1 -1
  356. package/dist/web/hooks/test/utils.d.ts +7 -2
  357. package/dist/web/hooks/test/utils.js +18 -3
  358. package/dist/web/hooks/test/utils.js.map +1 -1
  359. package/dist/web/hooks/use-call-tool.d.ts +45 -0
  360. package/dist/web/hooks/use-call-tool.js +28 -0
  361. package/dist/web/hooks/use-call-tool.js.map +1 -1
  362. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -1
  363. package/dist/web/hooks/use-call-tool.test.js +64 -29
  364. package/dist/web/hooks/use-call-tool.test.js.map +1 -1
  365. package/dist/web/hooks/use-display-mode.d.ts +20 -0
  366. package/dist/web/hooks/use-display-mode.js +20 -0
  367. package/dist/web/hooks/use-display-mode.js.map +1 -1
  368. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -1
  369. package/dist/web/hooks/use-display-mode.test.js +57 -21
  370. package/dist/web/hooks/use-display-mode.test.js.map +1 -1
  371. package/dist/web/hooks/use-download.d.ts +3 -0
  372. package/dist/web/hooks/use-download.js +7 -0
  373. package/dist/web/hooks/use-download.js.map +1 -0
  374. package/dist/web/hooks/use-download.test.d.ts +1 -0
  375. package/dist/web/hooks/use-download.test.js +103 -0
  376. package/dist/web/hooks/use-download.test.js.map +1 -0
  377. package/dist/web/hooks/use-files.d.ts +34 -1
  378. package/dist/web/hooks/use-files.js +33 -0
  379. package/dist/web/hooks/use-files.js.map +1 -1
  380. package/dist/web/hooks/use-files.test.js +31 -3
  381. package/dist/web/hooks/use-files.test.js.map +1 -1
  382. package/dist/web/hooks/use-host.d.ts +22 -0
  383. package/dist/web/hooks/use-host.js +30 -0
  384. package/dist/web/hooks/use-host.js.map +1 -0
  385. package/dist/web/hooks/use-host.test.d.ts +1 -0
  386. package/dist/web/hooks/use-host.test.js +59 -0
  387. package/dist/web/hooks/use-host.test.js.map +1 -0
  388. package/dist/web/hooks/use-open-external.d.ts +17 -0
  389. package/dist/web/hooks/use-open-external.js +16 -0
  390. package/dist/web/hooks/use-open-external.js.map +1 -1
  391. package/dist/web/hooks/use-open-external.test.js +29 -14
  392. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  393. package/dist/web/hooks/use-register-view-tool.d.ts +37 -0
  394. package/dist/web/hooks/use-register-view-tool.js +50 -0
  395. package/dist/web/hooks/use-register-view-tool.js.map +1 -0
  396. package/dist/web/hooks/use-request-close.d.ts +16 -0
  397. package/dist/web/hooks/use-request-close.js +21 -0
  398. package/dist/web/hooks/use-request-close.js.map +1 -0
  399. package/dist/web/hooks/use-request-close.test.d.ts +1 -0
  400. package/dist/web/hooks/use-request-close.test.js +47 -0
  401. package/dist/web/hooks/use-request-close.test.js.map +1 -0
  402. package/dist/web/hooks/use-request-modal.d.ts +16 -1
  403. package/dist/web/hooks/use-request-modal.js +19 -4
  404. package/dist/web/hooks/use-request-modal.js.map +1 -1
  405. package/dist/web/hooks/use-request-modal.test.js +16 -2
  406. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  407. package/dist/web/hooks/use-request-size.d.ts +20 -0
  408. package/dist/web/hooks/use-request-size.js +24 -0
  409. package/dist/web/hooks/use-request-size.js.map +1 -0
  410. package/dist/web/hooks/use-request-size.test.d.ts +1 -0
  411. package/dist/web/hooks/use-request-size.test.js +47 -0
  412. package/dist/web/hooks/use-request-size.test.js.map +1 -0
  413. package/dist/web/hooks/use-send-follow-up-message.d.ts +19 -1
  414. package/dist/web/hooks/use-send-follow-up-message.js +19 -2
  415. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -1
  416. package/dist/web/hooks/use-set-open-in-app-url.d.ts +17 -0
  417. package/dist/web/hooks/use-set-open-in-app-url.js +17 -0
  418. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -1
  419. package/dist/web/hooks/use-set-open-in-app-url.test.js +29 -9
  420. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -1
  421. package/dist/web/hooks/use-tool-info.d.ts +46 -14
  422. package/dist/web/hooks/use-tool-info.js +29 -7
  423. package/dist/web/hooks/use-tool-info.js.map +1 -1
  424. package/dist/web/hooks/use-tool-info.test-d.js +11 -34
  425. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -1
  426. package/dist/web/hooks/use-tool-info.test.js +42 -37
  427. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  428. package/dist/web/hooks/use-user.d.ts +5 -2
  429. package/dist/web/hooks/use-user.js +23 -4
  430. package/dist/web/hooks/use-user.js.map +1 -1
  431. package/dist/web/hooks/use-user.test.js +104 -28
  432. package/dist/web/hooks/use-user.test.js.map +1 -1
  433. package/dist/web/hooks/use-view-state.d.ts +25 -0
  434. package/dist/web/hooks/use-view-state.js +42 -0
  435. package/dist/web/hooks/use-view-state.js.map +1 -0
  436. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  437. package/dist/web/hooks/use-view-state.test.js +212 -0
  438. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  439. package/dist/web/hooks/use-viewport.d.ts +20 -0
  440. package/dist/web/hooks/use-viewport.js +21 -0
  441. package/dist/web/hooks/use-viewport.js.map +1 -0
  442. package/dist/web/hooks/use-viewport.test.d.ts +1 -0
  443. package/dist/web/hooks/use-viewport.test.js +109 -0
  444. package/dist/web/hooks/use-viewport.test.js.map +1 -0
  445. package/dist/web/index.d.ts +2 -2
  446. package/dist/web/index.js +1 -2
  447. package/dist/web/index.js.map +1 -1
  448. package/dist/web/mount-view.d.ts +21 -0
  449. package/dist/web/{mount-widget.js → mount-view.js} +22 -2
  450. package/dist/web/mount-view.js.map +1 -0
  451. package/dist/web/proxy.js.map +1 -1
  452. package/dist/web/types.d.ts +4 -0
  453. package/dist/web/types.js.map +1 -1
  454. package/package.json +47 -27
  455. package/tsconfig.base.json +5 -0
  456. package/dist/server/const.d.ts +0 -1
  457. package/dist/server/const.js +0 -2
  458. package/dist/server/const.js.map +0 -1
  459. package/dist/server/templates/development.hbs +0 -67
  460. package/dist/server/templates/production.hbs +0 -6
  461. package/dist/server/widgetsDevServer.d.ts +0 -12
  462. package/dist/server/widgetsDevServer.js +0 -63
  463. package/dist/server/widgetsDevServer.js.map +0 -1
  464. package/dist/test/widget.test.js +0 -261
  465. package/dist/test/widget.test.js.map +0 -1
  466. package/dist/web/bridges/apps-sdk/adaptor.d.ts +0 -22
  467. package/dist/web/bridges/apps-sdk/adaptor.js +0 -71
  468. package/dist/web/bridges/apps-sdk/adaptor.js.map +0 -1
  469. package/dist/web/bridges/mcp-app/adaptor.d.ts +0 -36
  470. package/dist/web/bridges/mcp-app/adaptor.js +0 -190
  471. package/dist/web/bridges/mcp-app/adaptor.js.map +0 -1
  472. package/dist/web/hooks/use-layout.d.ts +0 -22
  473. package/dist/web/hooks/use-layout.js +0 -23
  474. package/dist/web/hooks/use-layout.js.map +0 -1
  475. package/dist/web/hooks/use-layout.test.js +0 -96
  476. package/dist/web/hooks/use-layout.test.js.map +0 -1
  477. package/dist/web/hooks/use-widget-state.d.ts +0 -4
  478. package/dist/web/hooks/use-widget-state.js +0 -32
  479. package/dist/web/hooks/use-widget-state.js.map +0 -1
  480. package/dist/web/hooks/use-widget-state.test.js +0 -62
  481. package/dist/web/hooks/use-widget-state.test.js.map +0 -1
  482. package/dist/web/mount-widget.d.ts +0 -1
  483. package/dist/web/mount-widget.js.map +0 -1
  484. package/dist/web/plugin/data-llm.test.js +0 -81
  485. package/dist/web/plugin/data-llm.test.js.map +0 -1
  486. package/dist/web/plugin/plugin.d.ts +0 -2
  487. package/dist/web/plugin/plugin.js +0 -54
  488. package/dist/web/plugin/plugin.js.map +0 -1
  489. package/dist/web/plugin/transform-data-llm.d.ts +0 -12
  490. package/dist/web/plugin/transform-data-llm.js +0 -96
  491. package/dist/web/plugin/transform-data-llm.js.map +0 -1
  492. package/dist/web/plugin/transform-data-llm.test.js +0 -81
  493. package/dist/web/plugin/transform-data-llm.test.js.map +0 -1
  494. package/dist/web/plugin/validate-widget.d.ts +0 -5
  495. package/dist/web/plugin/validate-widget.js +0 -27
  496. package/dist/web/plugin/validate-widget.js.map +0 -1
  497. package/dist/web/plugin/validate-widget.test.js +0 -42
  498. package/dist/web/plugin/validate-widget.test.js.map +0 -1
  499. /package/dist/{test/widget.test.d.ts → cli/build-helpers.test.d.ts} +0 -0
  500. /package/dist/{web/hooks/use-layout.test.d.ts → cli/build-steps.test.d.ts} +0 -0
  501. /package/dist/{web/hooks/use-widget-state.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  502. /package/dist/{web/plugin/data-llm.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
  503. /package/dist/{web/plugin/transform-data-llm.test.d.ts → cli/tunnel.test.d.ts} +0 -0
  504. /package/dist/{web/plugin/validate-widget.test.d.ts → context-warnings.test.d.ts} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-helpers.js","sourceRoot":"","sources":["../../src/server/content-helpers.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,IAAyB;IACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAClB,KAAa,EACb,WAAgC;IAEhC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CACnB,IAAyB,EACzB,QAAgB,EAChB,WAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;QACpB,QAAQ;QACR,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CACnB,IAAyB,EACzB,QAAgB,EAChB,WAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;QACpB,QAAQ;QACR,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAEoD,EACpD,WAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ;QACR,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAOC,EACD,WAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,GAAG,IAAI;QACP,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n AudioContent,\n EmbeddedResource,\n ImageContent,\n ResourceLink,\n TextContent,\n} from \"@modelcontextprotocol/server\";\n\n/**\n * MCP content annotations applied to any returned block.\n *\n * - `audience` — who is meant to see the content (`\"user\"`, `\"assistant\"`, or both).\n * - `priority` — relative importance hint for the host.\n * - `lastModified` — ISO timestamp for when the content was produced.\n */\ntype ContentAnnotations = {\n audience?: (\"user\" | \"assistant\")[];\n priority?: number;\n lastModified?: string;\n};\n\n/**\n * Returns a base64-encoded string.\n * - `Uint8Array` input is encoded via `Buffer.toString(\"base64\")`.\n * - `string` input is assumed to be **already base64-encoded** and is returned\n * as-is. Passing raw/unencoded string bytes will produce invalid MCP content.\n */\nfunction toBase64(data: string | Uint8Array): string {\n if (typeof data === \"string\") {\n return data;\n }\n return Buffer.from(data).toString(\"base64\");\n}\n\n/**\n * Build an MCP text content block.\n *\n * @example\n * ```ts\n * return { content: [text(\"Found 3 results.\")] };\n * ```\n */\nexport function text(\n value: string,\n annotations?: ContentAnnotations,\n): TextContent {\n return { type: \"text\", text: value, ...(annotations && { annotations }) };\n}\n\n/**\n * Build an MCP image content block.\n *\n * `data` may be a `Uint8Array` (encoded to base64 for you) or a string that is\n * **already base64-encoded**. Passing a raw byte-string will produce invalid\n * content.\n */\nexport function image(\n data: string | Uint8Array,\n mimeType: string,\n annotations?: ContentAnnotations,\n): ImageContent {\n return {\n type: \"image\",\n data: toBase64(data),\n mimeType,\n ...(annotations && { annotations }),\n };\n}\n\n/**\n * Build an MCP audio content block.\n *\n * `data` may be a `Uint8Array` (encoded to base64 for you) or a string that is\n * **already base64-encoded**.\n */\nexport function audio(\n data: string | Uint8Array,\n mimeType: string,\n annotations?: ContentAnnotations,\n): AudioContent {\n return {\n type: \"audio\",\n data: toBase64(data),\n mimeType,\n ...(annotations && { annotations }),\n };\n}\n\n/**\n * Build an MCP embedded resource — the full content travels inline. Use this\n * when the client needs the bytes themselves rather than a link.\n *\n * Pass either `text` (UTF-8 string) or `blob` (base64-encoded bytes).\n */\nexport function embeddedResource(\n resource:\n | { uri: string; mimeType?: string; text: string }\n | { uri: string; mimeType?: string; blob: string },\n annotations?: ContentAnnotations,\n): EmbeddedResource {\n return {\n type: \"resource\",\n resource,\n ...(annotations && { annotations }),\n };\n}\n\n/**\n * Build an MCP resource link — a `type: \"resource_link\"` block carrying a URI\n * the client can fetch (or subscribe to) on demand. Use a link when the\n * client should retrieve the bytes itself; use {@link embeddedResource} when\n * the content must travel inline with the response.\n */\nexport function resourceLink(\n link: {\n uri: string;\n name: string;\n title?: string;\n description?: string;\n mimeType?: string;\n size?: number;\n },\n annotations?: ContentAnnotations,\n): ResourceLink {\n return {\n type: \"resource_link\",\n ...link,\n ...(annotations && { annotations }),\n };\n}\n"]}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,70 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { audio, embeddedResource, image, resourceLink, text, } from "./content-helpers.js";
3
+ describe("text", () => {
4
+ it("returns a TextContent without annotations when none given", () => {
5
+ expect(text("hello")).toEqual({ type: "text", text: "hello" });
6
+ });
7
+ it("includes annotations when provided", () => {
8
+ expect(text("hi", { priority: 1 })).toEqual({
9
+ type: "text",
10
+ text: "hi",
11
+ annotations: { priority: 1 },
12
+ });
13
+ });
14
+ });
15
+ describe("image", () => {
16
+ it("base64-encodes Uint8Array data", () => {
17
+ const bytes = new Uint8Array([104, 105]);
18
+ expect(image(bytes, "image/png")).toEqual({
19
+ type: "image",
20
+ data: "aGk=",
21
+ mimeType: "image/png",
22
+ });
23
+ });
24
+ it("passes string data through unchanged (caller is responsible for base64)", () => {
25
+ expect(image("YWxyZWFkeS1iNjQ=", "image/png")).toEqual({
26
+ type: "image",
27
+ data: "YWxyZWFkeS1iNjQ=",
28
+ mimeType: "image/png",
29
+ });
30
+ });
31
+ });
32
+ describe("audio", () => {
33
+ it("base64-encodes Uint8Array data", () => {
34
+ const bytes = new Uint8Array([104, 105]);
35
+ expect(audio(bytes, "audio/mpeg")).toMatchObject({
36
+ type: "audio",
37
+ data: "aGk=",
38
+ mimeType: "audio/mpeg",
39
+ });
40
+ });
41
+ });
42
+ describe("embeddedResource", () => {
43
+ it("wraps a text resource with a type tag", () => {
44
+ expect(embeddedResource({
45
+ uri: "file:///a.txt",
46
+ mimeType: "text/plain",
47
+ text: "x",
48
+ })).toEqual({
49
+ type: "resource",
50
+ resource: { uri: "file:///a.txt", mimeType: "text/plain", text: "x" },
51
+ });
52
+ });
53
+ it("wraps a blob resource with a type tag", () => {
54
+ expect(embeddedResource({ uri: "file:///a.bin", blob: "YmFy" })).toEqual({
55
+ type: "resource",
56
+ resource: { uri: "file:///a.bin", blob: "YmFy" },
57
+ });
58
+ });
59
+ });
60
+ describe("resourceLink", () => {
61
+ it("spreads link fields alongside the type tag", () => {
62
+ expect(resourceLink({ uri: "file:///a", name: "a", title: "A" })).toEqual({
63
+ type: "resource_link",
64
+ uri: "file:///a",
65
+ name: "a",
66
+ title: "A",
67
+ });
68
+ });
69
+ });
70
+ //# sourceMappingURL=content-helpers.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-helpers.test.js","sourceRoot":"","sources":["../../src/server/content-helpers.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport {\n audio,\n embeddedResource,\n image,\n resourceLink,\n text,\n} from \"./content-helpers.js\";\n\ndescribe(\"text\", () => {\n it(\"returns a TextContent without annotations when none given\", () => {\n expect(text(\"hello\")).toEqual({ type: \"text\", text: \"hello\" });\n });\n\n it(\"includes annotations when provided\", () => {\n expect(text(\"hi\", { priority: 1 })).toEqual({\n type: \"text\",\n text: \"hi\",\n annotations: { priority: 1 },\n });\n });\n});\n\ndescribe(\"image\", () => {\n it(\"base64-encodes Uint8Array data\", () => {\n const bytes = new Uint8Array([104, 105]);\n expect(image(bytes, \"image/png\")).toEqual({\n type: \"image\",\n data: \"aGk=\",\n mimeType: \"image/png\",\n });\n });\n\n it(\"passes string data through unchanged (caller is responsible for base64)\", () => {\n expect(image(\"YWxyZWFkeS1iNjQ=\", \"image/png\")).toEqual({\n type: \"image\",\n data: \"YWxyZWFkeS1iNjQ=\",\n mimeType: \"image/png\",\n });\n });\n});\n\ndescribe(\"audio\", () => {\n it(\"base64-encodes Uint8Array data\", () => {\n const bytes = new Uint8Array([104, 105]);\n expect(audio(bytes, \"audio/mpeg\")).toMatchObject({\n type: \"audio\",\n data: \"aGk=\",\n mimeType: \"audio/mpeg\",\n });\n });\n});\n\ndescribe(\"embeddedResource\", () => {\n it(\"wraps a text resource with a type tag\", () => {\n expect(\n embeddedResource({\n uri: \"file:///a.txt\",\n mimeType: \"text/plain\",\n text: \"x\",\n }),\n ).toEqual({\n type: \"resource\",\n resource: { uri: \"file:///a.txt\", mimeType: \"text/plain\", text: \"x\" },\n });\n });\n\n it(\"wraps a blob resource with a type tag\", () => {\n expect(embeddedResource({ uri: \"file:///a.bin\", blob: \"YmFy\" })).toEqual({\n type: \"resource\",\n resource: { uri: \"file:///a.bin\", blob: \"YmFy\" },\n });\n });\n});\n\ndescribe(\"resourceLink\", () => {\n it(\"spreads link fields alongside the type tag\", () => {\n expect(resourceLink({ uri: \"file:///a\", name: \"a\", title: \"A\" })).toEqual({\n type: \"resource_link\",\n uri: \"file:///a\",\n name: \"a\",\n title: \"A\",\n });\n });\n});\n"]}
@@ -1,9 +1,13 @@
1
+ import type http from "node:http";
1
2
  import express from "express";
2
- import type { McpServer } from "./server";
3
- export declare function createServer({ server, customMiddleware, }: {
4
- server: McpServer;
5
- customMiddleware?: {
3
+ import type { Skybridge } from "./app.js";
4
+ type SkybridgeApp = Pick<Skybridge, "express" | "fetchHandler">;
5
+ export declare function createApp({ app: skybridgeApp, httpServer, errorMiddleware, }: {
6
+ app: SkybridgeApp;
7
+ httpServer: http.Server;
8
+ errorMiddleware?: {
6
9
  path?: string;
7
- handlers: express.RequestHandler[];
10
+ handlers: express.ErrorRequestHandler[];
8
11
  }[];
9
12
  }): Promise<express.Express>;
13
+ export {};
@@ -1,12 +1,19 @@
1
1
  import path from "node:path";
2
- import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
2
+ import { toNodeHandler } from "@modelcontextprotocol/node";
3
3
  import cors from "cors";
4
4
  import express from "express";
5
- export async function createServer({ server, customMiddleware = [], }) {
6
- const app = express();
7
- app.use(express.json());
8
- const env = process.env.NODE_ENV || "development";
9
- for (const middleware of customMiddleware) {
5
+ function parseControlPort(raw) {
6
+ if (raw === undefined) {
7
+ return null;
8
+ }
9
+ const n = Number.parseInt(raw, 10);
10
+ if (!Number.isFinite(n) || n <= 0 || n >= 65536) {
11
+ return null;
12
+ }
13
+ return n;
14
+ }
15
+ function applyMiddlewares(app, middlewares) {
16
+ for (const middleware of middlewares) {
10
17
  if (middleware.path) {
11
18
  app.use(middleware.path, ...middleware.handlers);
12
19
  }
@@ -14,58 +21,56 @@ export async function createServer({ server, customMiddleware = [], }) {
14
21
  app.use(...middleware.handlers);
15
22
  }
16
23
  }
17
- if (env !== "production") {
24
+ }
25
+ function defaultErrorHandler(err, _req, res, _next) {
26
+ console.error("Error handling MCP request:", err);
27
+ if (!res.headersSent) {
28
+ res.status(500).json({
29
+ jsonrpc: "2.0",
30
+ error: { code: -32603, message: "Internal server error" },
31
+ id: null,
32
+ });
33
+ }
34
+ }
35
+ export async function createApp({ app: skybridgeApp, httpServer, errorMiddleware = [], }) {
36
+ const app = skybridgeApp.express;
37
+ // Read `process.env.NODE_ENV` inline: wrangler/esbuild only substitute the literal expression,
38
+ // so a local const would defeat dead-code elimination of the dev-only imports below.
39
+ if (process.env.NODE_ENV !== "production") {
18
40
  const { devtoolsStaticServer } = await import("@skybridge/devtools");
19
41
  app.use(await devtoolsStaticServer());
20
- const { widgetsDevServer } = await import("./widgetsDevServer.js");
21
- app.use(await widgetsDevServer());
42
+ const { viewsDevServer } = await import("./viewsDevServer.js");
43
+ app.use(await viewsDevServer(httpServer));
44
+ const controlPort = parseControlPort(process.env.__TUNNEL_CONTROL_PORT);
45
+ if (controlPort !== null) {
46
+ const { createTunnelProxyRouter } = await import("./tunnel-proxy-router.js");
47
+ app.use(createTunnelProxyRouter(controlPort));
48
+ }
49
+ else if (process.env.__TUNNEL_CONTROL_PORT !== undefined) {
50
+ console.warn(`Ignoring invalid __TUNNEL_CONTROL_PORT=${process.env.__TUNNEL_CONTROL_PORT}`);
51
+ }
22
52
  }
23
- if (env === "production") {
53
+ else {
24
54
  const assetsPath = path.join(process.cwd(), "dist", "assets");
25
55
  app.use("/assets", cors());
26
56
  app.use("/assets", express.static(assetsPath));
27
57
  }
28
- app.use("/mcp", mcpMiddleware(server));
58
+ app.use("/mcp", mcpMiddleware(skybridgeApp));
59
+ applyMiddlewares(app, errorMiddleware);
60
+ app.use("/mcp", defaultErrorHandler);
29
61
  return app;
30
62
  }
31
- const mcpMiddleware = (server) => {
32
- return async (req, res, _next) => {
33
- if (req.method !== "POST") {
34
- res.writeHead(405).end(JSON.stringify({
35
- jsonrpc: "2.0",
36
- error: {
37
- code: -32000,
38
- message: "Method not allowed.",
39
- },
40
- id: null,
41
- }));
42
- return;
43
- }
63
+ const mcpMiddleware = (skybridgeApp) => {
64
+ const handler = toNodeHandler(skybridgeApp.fetchHandler);
65
+ return async (req, res, next) => {
44
66
  try {
45
- const transport = new StreamableHTTPServerTransport({
46
- sessionIdGenerator: undefined,
47
- });
48
- res.on("close", () => {
49
- transport.close();
50
- });
51
- await server.connect(transport);
52
67
  // Express strips the mount path from req.url (e.g. "/mcp" becomes "/").
53
- // Restore it so the SDK builds the correct requestInfo.url.
68
+ // Restore it so the SDK builds the correct request URL.
54
69
  req.url = req.originalUrl;
55
- await transport.handleRequest(req, res, req.body);
70
+ await handler(req, res, req.body);
56
71
  }
57
72
  catch (error) {
58
- console.error("Error handling MCP request:", error);
59
- if (!res.headersSent) {
60
- res.status(500).json({
61
- jsonrpc: "2.0",
62
- error: {
63
- code: -32603,
64
- message: "Internal server error",
65
- },
66
- id: null,
67
- });
68
- }
73
+ next(error);
69
74
  }
70
75
  };
71
76
  };
@@ -1 +1 @@
1
- {"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/server/express.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/server/express.ts"],"names":[],"mappings":"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","sourcesContent":["import type http from \"node:http\";\nimport path from \"node:path\";\nimport { toNodeHandler } from \"@modelcontextprotocol/node\";\nimport cors from \"cors\";\nimport express from \"express\";\nimport type { Skybridge } from \"./app.js\";\n\ntype SkybridgeApp = Pick<Skybridge, \"express\" | \"fetchHandler\">;\n\nfunction parseControlPort(raw: string | undefined): number | null {\n if (raw === undefined) {\n return null;\n }\n const n = Number.parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0 || n >= 65536) {\n return null;\n }\n return n;\n}\n\nfunction applyMiddlewares(\n app: express.Express,\n middlewares: Array<{\n path?: string;\n handlers: express.ErrorRequestHandler[];\n }>,\n): void {\n for (const middleware of middlewares) {\n if (middleware.path) {\n app.use(middleware.path, ...middleware.handlers);\n } else {\n app.use(...middleware.handlers);\n }\n }\n}\n\nfunction defaultErrorHandler(\n err: unknown,\n _req: express.Request,\n res: express.Response,\n _next: express.NextFunction,\n) {\n console.error(\"Error handling MCP request:\", err);\n if (!res.headersSent) {\n res.status(500).json({\n jsonrpc: \"2.0\",\n error: { code: -32603, message: \"Internal server error\" },\n id: null,\n });\n }\n}\n\nexport async function createApp({\n app: skybridgeApp,\n httpServer,\n errorMiddleware = [],\n}: {\n app: SkybridgeApp;\n httpServer: http.Server;\n errorMiddleware?: {\n path?: string;\n handlers: express.ErrorRequestHandler[];\n }[];\n}): Promise<express.Express> {\n const app = skybridgeApp.express;\n\n // Read `process.env.NODE_ENV` inline: wrangler/esbuild only substitute the literal expression,\n // so a local const would defeat dead-code elimination of the dev-only imports below.\n if (process.env.NODE_ENV !== \"production\") {\n const { devtoolsStaticServer } = await import(\"@skybridge/devtools\");\n app.use(await devtoolsStaticServer());\n const { viewsDevServer } = await import(\"./viewsDevServer.js\");\n app.use(await viewsDevServer(httpServer));\n\n const controlPort = parseControlPort(process.env.__TUNNEL_CONTROL_PORT);\n if (controlPort !== null) {\n const { createTunnelProxyRouter } = await import(\n \"./tunnel-proxy-router.js\"\n );\n app.use(createTunnelProxyRouter(controlPort));\n } else if (process.env.__TUNNEL_CONTROL_PORT !== undefined) {\n console.warn(\n `Ignoring invalid __TUNNEL_CONTROL_PORT=${process.env.__TUNNEL_CONTROL_PORT}`,\n );\n }\n } else {\n const assetsPath = path.join(process.cwd(), \"dist\", \"assets\");\n\n app.use(\"/assets\", cors());\n app.use(\"/assets\", express.static(assetsPath));\n }\n\n app.use(\"/mcp\", mcpMiddleware(skybridgeApp));\n\n applyMiddlewares(app, errorMiddleware);\n\n app.use(\"/mcp\", defaultErrorHandler);\n\n return app;\n}\n\nconst mcpMiddleware = (skybridgeApp: SkybridgeApp): express.RequestHandler => {\n const handler = toNodeHandler(skybridgeApp.fetchHandler);\n\n return async (\n req: express.Request,\n res: express.Response,\n next: express.NextFunction,\n ) => {\n try {\n // Express strips the mount path from req.url (e.g. \"/mcp\" becomes \"/\").\n // Restore it so the SDK builds the correct request URL.\n req.url = req.originalUrl;\n await handler(req, res, req.body);\n } catch (error) {\n next(error);\n }\n };\n};\n"]}