skybridge 0.0.0-dev.f5759ba → 0.0.0-dev.f57f202

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 (644) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +155 -0
  3. package/bin/run.js +5 -0
  4. package/dist/cli/build-helpers.d.ts +11 -0
  5. package/dist/cli/build-helpers.js +107 -0
  6. package/dist/cli/build-helpers.js.map +1 -0
  7. package/dist/cli/build-helpers.test.js +132 -0
  8. package/dist/cli/build-helpers.test.js.map +1 -0
  9. package/dist/cli/build-steps.d.ts +2 -0
  10. package/dist/cli/build-steps.js +73 -0
  11. package/dist/cli/build-steps.js.map +1 -0
  12. package/dist/cli/build-steps.test.js +52 -0
  13. package/dist/cli/build-steps.test.js.map +1 -0
  14. package/dist/cli/detect-port.d.ts +18 -0
  15. package/dist/cli/detect-port.js +49 -0
  16. package/dist/cli/detect-port.js.map +1 -0
  17. package/dist/cli/header.d.ts +4 -0
  18. package/dist/cli/header.js +6 -0
  19. package/dist/cli/header.js.map +1 -0
  20. package/dist/cli/resolve-skybridge-config.d.ts +5 -0
  21. package/dist/cli/resolve-skybridge-config.js +18 -0
  22. package/dist/cli/resolve-skybridge-config.js.map +1 -0
  23. package/dist/cli/run-command.d.ts +2 -0
  24. package/dist/cli/run-command.js +43 -0
  25. package/dist/cli/run-command.js.map +1 -0
  26. package/dist/cli/run-plain.d.ts +18 -0
  27. package/dist/cli/run-plain.js +90 -0
  28. package/dist/cli/run-plain.js.map +1 -0
  29. package/dist/cli/telemetry.d.ts +7 -0
  30. package/dist/cli/telemetry.js +125 -0
  31. package/dist/cli/telemetry.js.map +1 -0
  32. package/dist/cli/tunnel-control-server.d.ts +9 -0
  33. package/dist/cli/tunnel-control-server.js +31 -0
  34. package/dist/cli/tunnel-control-server.js.map +1 -0
  35. package/dist/cli/tunnel-control-server.test.js +39 -0
  36. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  37. package/dist/cli/tunnel-handler.d.ts +3 -0
  38. package/dist/cli/tunnel-handler.js +48 -0
  39. package/dist/cli/tunnel-handler.js.map +1 -0
  40. package/dist/cli/tunnel-handler.test.js +105 -0
  41. package/dist/cli/tunnel-handler.test.js.map +1 -0
  42. package/dist/cli/tunnel.d.ts +57 -0
  43. package/dist/cli/tunnel.js +154 -0
  44. package/dist/cli/tunnel.js.map +1 -0
  45. package/dist/cli/tunnel.test.js +190 -0
  46. package/dist/cli/tunnel.test.js.map +1 -0
  47. package/dist/cli/types.d.ts +5 -0
  48. package/dist/cli/types.js +2 -0
  49. package/dist/cli/types.js.map +1 -0
  50. package/dist/cli/use-execute-steps.d.ts +11 -0
  51. package/dist/cli/use-execute-steps.js +36 -0
  52. package/dist/cli/use-execute-steps.js.map +1 -0
  53. package/dist/cli/use-messages.d.ts +3 -0
  54. package/dist/cli/use-messages.js +11 -0
  55. package/dist/cli/use-messages.js.map +1 -0
  56. package/dist/cli/use-nodemon.d.ts +26 -0
  57. package/dist/cli/use-nodemon.js +106 -0
  58. package/dist/cli/use-nodemon.js.map +1 -0
  59. package/dist/cli/use-open-browser.d.ts +1 -0
  60. package/dist/cli/use-open-browser.js +44 -0
  61. package/dist/cli/use-open-browser.js.map +1 -0
  62. package/dist/cli/use-tunnel.d.ts +14 -0
  63. package/dist/cli/use-tunnel.js +131 -0
  64. package/dist/cli/use-tunnel.js.map +1 -0
  65. package/dist/cli/use-typescript-check.d.ts +15 -0
  66. package/dist/cli/use-typescript-check.js +97 -0
  67. package/dist/cli/use-typescript-check.js.map +1 -0
  68. package/dist/commands/build.d.ts +6 -0
  69. package/dist/commands/build.js +31 -0
  70. package/dist/commands/build.js.map +1 -0
  71. package/dist/commands/create.d.ts +9 -0
  72. package/dist/commands/create.js +30 -0
  73. package/dist/commands/create.js.map +1 -0
  74. package/dist/commands/dev.d.ts +13 -0
  75. package/dist/commands/dev.js +128 -0
  76. package/dist/commands/dev.js.map +1 -0
  77. package/dist/commands/start.d.ts +9 -0
  78. package/dist/commands/start.js +55 -0
  79. package/dist/commands/start.js.map +1 -0
  80. package/dist/commands/telemetry/disable.d.ts +5 -0
  81. package/dist/commands/telemetry/disable.js +14 -0
  82. package/dist/commands/telemetry/disable.js.map +1 -0
  83. package/dist/commands/telemetry/enable.d.ts +5 -0
  84. package/dist/commands/telemetry/enable.js +14 -0
  85. package/dist/commands/telemetry/enable.js.map +1 -0
  86. package/dist/commands/telemetry/status.d.ts +5 -0
  87. package/dist/commands/telemetry/status.js +14 -0
  88. package/dist/commands/telemetry/status.js.map +1 -0
  89. package/dist/context-warnings.d.ts +5 -0
  90. package/dist/context-warnings.js +31 -0
  91. package/dist/context-warnings.js.map +1 -0
  92. package/dist/context-warnings.test.js +28 -0
  93. package/dist/context-warnings.test.js.map +1 -0
  94. package/dist/server/app.d.ts +194 -0
  95. package/dist/server/app.js +266 -0
  96. package/dist/server/app.js.map +1 -0
  97. package/dist/server/app.test.js +97 -0
  98. package/dist/server/app.test.js.map +1 -0
  99. package/dist/server/asset-base-url-transform-plugin.d.ts +11 -0
  100. package/dist/server/asset-base-url-transform-plugin.js +48 -0
  101. package/dist/server/asset-base-url-transform-plugin.js.map +1 -0
  102. package/dist/server/asset-base-url-transform-plugin.test.js +134 -0
  103. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -0
  104. package/dist/server/auth/discovery.d.ts +33 -0
  105. package/dist/server/auth/discovery.js +56 -0
  106. package/dist/server/auth/discovery.js.map +1 -0
  107. package/dist/server/auth/discovery.test.js +93 -0
  108. package/dist/server/auth/discovery.test.js.map +1 -0
  109. package/dist/server/auth/index.d.ts +48 -0
  110. package/dist/server/auth/index.js +2 -0
  111. package/dist/server/auth/index.js.map +1 -0
  112. package/dist/server/auth/providers/auth0.d.ts +40 -0
  113. package/dist/server/auth/providers/auth0.js +36 -0
  114. package/dist/server/auth/providers/auth0.js.map +1 -0
  115. package/dist/server/auth/providers/auth0.test.js +50 -0
  116. package/dist/server/auth/providers/auth0.test.js.map +1 -0
  117. package/dist/server/auth/providers/authplane.d.ts +49 -0
  118. package/dist/server/auth/providers/authplane.js +57 -0
  119. package/dist/server/auth/providers/authplane.js.map +1 -0
  120. package/dist/server/auth/providers/authplane.test.js +143 -0
  121. package/dist/server/auth/providers/authplane.test.js.map +1 -0
  122. package/dist/server/auth/providers/clerk.d.ts +51 -0
  123. package/dist/server/auth/providers/clerk.js +19 -0
  124. package/dist/server/auth/providers/clerk.js.map +1 -0
  125. package/dist/server/auth/providers/clerk.test.js +30 -0
  126. package/dist/server/auth/providers/clerk.test.js.map +1 -0
  127. package/dist/server/auth/providers/custom.d.ts +42 -0
  128. package/dist/server/auth/providers/custom.js +59 -0
  129. package/dist/server/auth/providers/custom.js.map +1 -0
  130. package/dist/server/auth/providers/custom.test.js +161 -0
  131. package/dist/server/auth/providers/custom.test.js.map +1 -0
  132. package/dist/server/auth/providers/descope.d.ts +44 -0
  133. package/dist/server/auth/providers/descope.js +44 -0
  134. package/dist/server/auth/providers/descope.js.map +1 -0
  135. package/dist/server/auth/providers/descope.test.js +62 -0
  136. package/dist/server/auth/providers/descope.test.js.map +1 -0
  137. package/dist/server/auth/providers/shared.d.ts +2 -0
  138. package/dist/server/auth/providers/shared.js +6 -0
  139. package/dist/server/auth/providers/shared.js.map +1 -0
  140. package/dist/server/auth/providers/shared.test.js +10 -0
  141. package/dist/server/auth/providers/shared.test.js.map +1 -0
  142. package/dist/server/auth/providers/stytch.d.ts +25 -0
  143. package/dist/server/auth/providers/stytch.js +16 -0
  144. package/dist/server/auth/providers/stytch.js.map +1 -0
  145. package/dist/server/auth/providers/verify-spy.d.ts +12 -0
  146. package/dist/server/auth/providers/verify-spy.js +21 -0
  147. package/dist/server/auth/providers/verify-spy.js.map +1 -0
  148. package/dist/server/auth/providers/workos.d.ts +34 -0
  149. package/dist/server/auth/providers/workos.js +16 -0
  150. package/dist/server/auth/providers/workos.js.map +1 -0
  151. package/dist/server/auth/security-schemes.d.ts +23 -0
  152. package/dist/server/auth/security-schemes.js +64 -0
  153. package/dist/server/auth/security-schemes.js.map +1 -0
  154. package/dist/server/auth/security-schemes.test.js +99 -0
  155. package/dist/server/auth/security-schemes.test.js.map +1 -0
  156. package/dist/server/auth/setup.d.ts +6 -0
  157. package/dist/server/auth/setup.js +91 -0
  158. package/dist/server/auth/setup.js.map +1 -0
  159. package/dist/server/auth/setup.test.js +514 -0
  160. package/dist/server/auth/setup.test.js.map +1 -0
  161. package/dist/server/auth/verify.d.ts +48 -0
  162. package/dist/server/auth/verify.js +62 -0
  163. package/dist/server/auth/verify.js.map +1 -0
  164. package/dist/server/auth/verify.test.js +165 -0
  165. package/dist/server/auth/verify.test.js.map +1 -0
  166. package/dist/server/auth-extra.test-d.js +130 -0
  167. package/dist/server/auth-extra.test-d.js.map +1 -0
  168. package/dist/server/auth.d.ts +57 -0
  169. package/dist/server/auth.js +27 -0
  170. package/dist/server/auth.js.map +1 -0
  171. package/dist/server/build-manifest.test.js +28 -0
  172. package/dist/server/build-manifest.test.js.map +1 -0
  173. package/dist/server/content-helpers.d.ts +67 -0
  174. package/dist/server/content-helpers.js +79 -0
  175. package/dist/server/content-helpers.js.map +1 -0
  176. package/dist/server/content-helpers.test.d.ts +1 -0
  177. package/dist/server/content-helpers.test.js +70 -0
  178. package/dist/server/content-helpers.test.js.map +1 -0
  179. package/dist/server/express.d.ts +31 -0
  180. package/dist/server/express.js +107 -0
  181. package/dist/server/express.js.map +1 -0
  182. package/dist/server/express.test.d.ts +1 -0
  183. package/dist/server/express.test.js +608 -0
  184. package/dist/server/express.test.js.map +1 -0
  185. package/dist/server/file-ref.d.ts +28 -0
  186. package/dist/server/file-ref.js +27 -0
  187. package/dist/server/file-ref.js.map +1 -0
  188. package/dist/server/host.d.ts +2 -0
  189. package/dist/server/host.js +11 -0
  190. package/dist/server/host.js.map +1 -0
  191. package/dist/server/host.test.d.ts +1 -0
  192. package/dist/server/host.test.js +13 -0
  193. package/dist/server/host.test.js.map +1 -0
  194. package/dist/server/index.d.ts +22 -0
  195. package/dist/server/index.js +18 -0
  196. package/dist/server/index.js.map +1 -0
  197. package/dist/{src/server → server}/inferUtilityTypes.d.ts +6 -6
  198. package/dist/server/inferUtilityTypes.js.map +1 -0
  199. package/dist/server/mcp-errors.test.d.ts +1 -0
  200. package/dist/server/mcp-errors.test.js +41 -0
  201. package/dist/server/mcp-errors.test.js.map +1 -0
  202. package/dist/server/metric.d.ts +14 -0
  203. package/dist/server/metric.js +62 -0
  204. package/dist/server/metric.js.map +1 -0
  205. package/dist/server/middleware.d.ts +162 -0
  206. package/dist/server/middleware.js +126 -0
  207. package/dist/server/middleware.js.map +1 -0
  208. package/dist/server/middleware.test-d.d.ts +1 -0
  209. package/dist/server/middleware.test-d.js +75 -0
  210. package/dist/server/middleware.test-d.js.map +1 -0
  211. package/dist/server/middleware.test.d.ts +1 -0
  212. package/dist/server/middleware.test.js +601 -0
  213. package/dist/server/middleware.test.js.map +1 -0
  214. package/dist/server/register-tool.test.d.ts +1 -0
  215. package/dist/server/register-tool.test.js +77 -0
  216. package/dist/server/register-tool.test.js.map +1 -0
  217. package/dist/server/requestOrigin.d.ts +7 -0
  218. package/dist/server/requestOrigin.js +25 -0
  219. package/dist/server/requestOrigin.js.map +1 -0
  220. package/dist/server/server.d.ts +496 -0
  221. package/dist/server/server.js +591 -0
  222. package/dist/server/server.js.map +1 -0
  223. package/dist/server/skills-integration.test.d.ts +1 -0
  224. package/dist/server/skills-integration.test.js +86 -0
  225. package/dist/server/skills-integration.test.js.map +1 -0
  226. package/dist/server/skills.d.ts +27 -0
  227. package/dist/server/skills.js +188 -0
  228. package/dist/server/skills.js.map +1 -0
  229. package/dist/server/skills.test.d.ts +1 -0
  230. package/dist/server/skills.test.js +243 -0
  231. package/dist/server/skills.test.js.map +1 -0
  232. package/dist/{src/server → server}/templateHelper.d.ts +2 -7
  233. package/dist/server/templateHelper.js +11 -0
  234. package/dist/server/templateHelper.js.map +1 -0
  235. package/dist/server/templates.generated.d.ts +4 -0
  236. package/dist/server/templates.generated.js +43 -0
  237. package/dist/server/templates.generated.js.map +1 -0
  238. package/dist/server/tool-extra.test.d.ts +1 -0
  239. package/dist/server/tool-extra.test.js +88 -0
  240. package/dist/server/tool-extra.test.js.map +1 -0
  241. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  242. package/dist/server/tunnel-proxy-router.js +110 -0
  243. package/dist/server/tunnel-proxy-router.js.map +1 -0
  244. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  245. package/dist/server/tunnel-proxy-router.test.js +229 -0
  246. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  247. package/dist/server/view-name.test-d.d.ts +1 -0
  248. package/dist/server/view-name.test-d.js +8 -0
  249. package/dist/server/view-name.test-d.js.map +1 -0
  250. package/dist/server/view-resource-resolution.test.d.ts +6 -0
  251. package/dist/server/view-resource-resolution.test.js +176 -0
  252. package/dist/server/view-resource-resolution.test.js.map +1 -0
  253. package/dist/server/viewsDevServer.d.ts +14 -0
  254. package/dist/server/viewsDevServer.js +48 -0
  255. package/dist/server/viewsDevServer.js.map +1 -0
  256. package/dist/{src/test → test}/utils.d.ts +21 -31
  257. package/dist/test/utils.js +266 -0
  258. package/dist/test/utils.js.map +1 -0
  259. package/dist/test/view.test.d.ts +1 -0
  260. package/dist/test/view.test.js +540 -0
  261. package/dist/test/view.test.js.map +1 -0
  262. package/dist/version.d.ts +1 -0
  263. package/dist/version.js +3 -0
  264. package/dist/version.js.map +1 -0
  265. package/dist/views/index.d.ts +10 -0
  266. package/dist/views/index.js +3 -0
  267. package/dist/views/index.js.map +1 -0
  268. package/dist/views/scan-views.d.ts +16 -0
  269. package/dist/views/scan-views.js +88 -0
  270. package/dist/views/scan-views.js.map +1 -0
  271. package/dist/views/scan-views.test.d.ts +1 -0
  272. package/dist/views/scan-views.test.js +99 -0
  273. package/dist/views/scan-views.test.js.map +1 -0
  274. package/dist/views/validate-view.d.ts +1 -0
  275. package/dist/views/validate-view.js +9 -0
  276. package/dist/views/validate-view.js.map +1 -0
  277. package/dist/views/validate-view.test.d.ts +1 -0
  278. package/dist/views/validate-view.test.js +24 -0
  279. package/dist/views/validate-view.test.js.map +1 -0
  280. package/dist/web/bridges/adaptor.d.ts +55 -0
  281. package/dist/web/bridges/adaptor.js +377 -0
  282. package/dist/web/bridges/adaptor.js.map +1 -0
  283. package/dist/web/bridges/adaptor.test.d.ts +1 -0
  284. package/dist/web/bridges/adaptor.test.js +231 -0
  285. package/dist/web/bridges/adaptor.test.js.map +1 -0
  286. package/dist/web/bridges/apps-sdk/bridge.d.ts +15 -0
  287. package/dist/web/bridges/apps-sdk/bridge.js +58 -0
  288. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -0
  289. package/dist/web/bridges/apps-sdk/index.d.ts +4 -0
  290. package/dist/web/bridges/apps-sdk/index.js +4 -0
  291. package/dist/web/bridges/apps-sdk/index.js.map +1 -0
  292. package/dist/web/bridges/apps-sdk/types.d.ts +133 -0
  293. package/dist/{src/web → web/bridges/apps-sdk}/types.js +0 -1
  294. package/dist/web/bridges/apps-sdk/types.js.map +1 -0
  295. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +13 -0
  296. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +18 -0
  297. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -0
  298. package/dist/web/bridges/get-adaptor.d.ts +9 -0
  299. package/dist/web/bridges/get-adaptor.js +10 -0
  300. package/dist/web/bridges/get-adaptor.js.map +1 -0
  301. package/dist/web/bridges/get-adaptor.test.d.ts +1 -0
  302. package/dist/web/bridges/get-adaptor.test.js +32 -0
  303. package/dist/web/bridges/get-adaptor.test.js.map +1 -0
  304. package/dist/web/bridges/index.d.ts +5 -0
  305. package/dist/web/bridges/index.js +6 -0
  306. package/dist/web/bridges/index.js.map +1 -0
  307. package/dist/web/bridges/mcp-app/bridge.d.ts +39 -0
  308. package/dist/web/bridges/mcp-app/bridge.js +175 -0
  309. package/dist/web/bridges/mcp-app/bridge.js.map +1 -0
  310. package/dist/web/bridges/mcp-app/bridge.test.d.ts +1 -0
  311. package/dist/web/bridges/mcp-app/bridge.test.js +17 -0
  312. package/dist/web/bridges/mcp-app/bridge.test.js.map +1 -0
  313. package/dist/web/bridges/mcp-app/index.d.ts +3 -0
  314. package/dist/web/bridges/mcp-app/index.js +3 -0
  315. package/dist/web/bridges/mcp-app/index.js.map +1 -0
  316. package/dist/web/bridges/mcp-app/types.d.ts +33 -0
  317. package/dist/web/bridges/mcp-app/types.js +2 -0
  318. package/dist/web/bridges/mcp-app/types.js.map +1 -0
  319. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +19 -0
  320. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +19 -0
  321. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -0
  322. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.d.ts +1 -0
  323. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +26 -0
  324. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -0
  325. package/dist/web/bridges/mcp-app/view-tools.test.d.ts +1 -0
  326. package/dist/web/bridges/mcp-app/view-tools.test.js +143 -0
  327. package/dist/web/bridges/mcp-app/view-tools.test.js.map +1 -0
  328. package/dist/web/bridges/types.d.ts +233 -0
  329. package/dist/web/bridges/types.js +15 -0
  330. package/dist/web/bridges/types.js.map +1 -0
  331. package/dist/web/bridges/types.test.d.ts +1 -0
  332. package/dist/web/bridges/types.test.js +19 -0
  333. package/dist/web/bridges/types.test.js.map +1 -0
  334. package/dist/web/bridges/use-host-context.d.ts +7 -0
  335. package/dist/web/bridges/use-host-context.js +13 -0
  336. package/dist/web/bridges/use-host-context.js.map +1 -0
  337. package/dist/web/components/modal-provider.d.ts +4 -0
  338. package/dist/web/components/modal-provider.js +46 -0
  339. package/dist/web/components/modal-provider.js.map +1 -0
  340. package/dist/web/create-store.d.ts +29 -0
  341. package/dist/web/create-store.js +64 -0
  342. package/dist/web/create-store.js.map +1 -0
  343. package/dist/web/create-store.test.d.ts +1 -0
  344. package/dist/web/create-store.test.js +132 -0
  345. package/dist/web/create-store.test.js.map +1 -0
  346. package/dist/web/data-llm.d.ts +47 -0
  347. package/dist/{src/web → web}/data-llm.js +42 -9
  348. package/dist/web/data-llm.js.map +1 -0
  349. package/dist/web/data-llm.test.d.ts +1 -0
  350. package/dist/web/data-llm.test.js +161 -0
  351. package/dist/web/data-llm.test.js.map +1 -0
  352. package/dist/{src/web → web}/generate-helpers.d.ts +41 -32
  353. package/dist/{src/web → web}/generate-helpers.js +38 -30
  354. package/dist/web/generate-helpers.js.map +1 -0
  355. package/dist/web/generate-helpers.test-d.d.ts +1 -0
  356. package/dist/{src/web → web}/generate-helpers.test-d.js +35 -30
  357. package/dist/web/generate-helpers.test-d.js.map +1 -0
  358. package/dist/web/generate-helpers.test.d.ts +1 -0
  359. package/dist/{src/web → web}/generate-helpers.test.js +2 -2
  360. package/dist/web/generate-helpers.test.js.map +1 -0
  361. package/dist/{src/web → web}/helpers/state.d.ts +2 -2
  362. package/dist/web/helpers/state.js +45 -0
  363. package/dist/web/helpers/state.js.map +1 -0
  364. package/dist/web/helpers/state.test.d.ts +1 -0
  365. package/dist/{src/web → web}/helpers/state.test.js +9 -9
  366. package/dist/web/helpers/state.test.js.map +1 -0
  367. package/dist/web/hooks/index.d.ts +18 -0
  368. package/dist/web/hooks/index.js +19 -0
  369. package/dist/web/hooks/index.js.map +1 -0
  370. package/dist/web/hooks/openai-extensions.test.d.ts +1 -0
  371. package/dist/web/hooks/openai-extensions.test.js +114 -0
  372. package/dist/web/hooks/openai-extensions.test.js.map +1 -0
  373. package/dist/web/hooks/test/utils.d.ts +21 -0
  374. package/dist/web/hooks/test/utils.js +75 -0
  375. package/dist/web/hooks/test/utils.js.map +1 -0
  376. package/dist/{src/web → web}/hooks/use-call-tool.d.ts +48 -2
  377. package/dist/web/hooks/use-call-tool.js +101 -0
  378. package/dist/web/hooks/use-call-tool.js.map +1 -0
  379. package/dist/web/hooks/use-call-tool.test-d.d.ts +1 -0
  380. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  381. package/dist/web/hooks/use-call-tool.test.d.ts +1 -0
  382. package/dist/{src/web → web}/hooks/use-call-tool.test.js +91 -24
  383. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  384. package/dist/web/hooks/use-deep-link.d.ts +22 -0
  385. package/dist/web/hooks/use-deep-link.js +60 -0
  386. package/dist/web/hooks/use-deep-link.js.map +1 -0
  387. package/dist/web/hooks/use-display-mode.d.ts +24 -0
  388. package/dist/web/hooks/use-display-mode.js +29 -0
  389. package/dist/web/hooks/use-display-mode.js.map +1 -0
  390. package/dist/web/hooks/use-display-mode.test-d.d.ts +1 -0
  391. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  392. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  393. package/dist/web/hooks/use-display-mode.test.d.ts +1 -0
  394. package/dist/web/hooks/use-display-mode.test.js +77 -0
  395. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  396. package/dist/web/hooks/use-download.d.ts +3 -0
  397. package/dist/web/hooks/use-download.js +7 -0
  398. package/dist/web/hooks/use-download.js.map +1 -0
  399. package/dist/web/hooks/use-download.test.d.ts +1 -0
  400. package/dist/web/hooks/use-download.test.js +103 -0
  401. package/dist/web/hooks/use-download.test.js.map +1 -0
  402. package/dist/web/hooks/use-files.d.ts +39 -0
  403. package/dist/web/hooks/use-files.js +42 -0
  404. package/dist/web/hooks/use-files.js.map +1 -0
  405. package/dist/web/hooks/use-files.test.d.ts +1 -0
  406. package/dist/web/hooks/use-files.test.js +62 -0
  407. package/dist/web/hooks/use-files.test.js.map +1 -0
  408. package/dist/web/hooks/use-host.d.ts +44 -0
  409. package/dist/web/hooks/use-host.js +45 -0
  410. package/dist/web/hooks/use-host.js.map +1 -0
  411. package/dist/web/hooks/use-host.test.d.ts +1 -0
  412. package/dist/web/hooks/use-host.test.js +59 -0
  413. package/dist/web/hooks/use-host.test.js.map +1 -0
  414. package/dist/web/hooks/use-model-context.d.ts +44 -0
  415. package/dist/web/hooks/use-model-context.js +65 -0
  416. package/dist/web/hooks/use-model-context.js.map +1 -0
  417. package/dist/web/hooks/use-open-external.d.ts +20 -0
  418. package/dist/web/hooks/use-open-external.js +24 -0
  419. package/dist/web/hooks/use-open-external.js.map +1 -0
  420. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  421. package/dist/web/hooks/use-open-external.test.js +75 -0
  422. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  423. package/dist/web/hooks/use-register-view-tool.d.ts +37 -0
  424. package/dist/web/hooks/use-register-view-tool.js +50 -0
  425. package/dist/web/hooks/use-register-view-tool.js.map +1 -0
  426. package/dist/web/hooks/use-request-close.d.ts +16 -0
  427. package/dist/web/hooks/use-request-close.js +21 -0
  428. package/dist/web/hooks/use-request-close.js.map +1 -0
  429. package/dist/web/hooks/use-request-close.test.d.ts +1 -0
  430. package/dist/web/hooks/use-request-close.test.js +47 -0
  431. package/dist/web/hooks/use-request-close.test.js.map +1 -0
  432. package/dist/web/hooks/use-request-modal.d.ts +24 -0
  433. package/dist/web/hooks/use-request-modal.js +31 -0
  434. package/dist/web/hooks/use-request-modal.js.map +1 -0
  435. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  436. package/dist/web/hooks/use-request-modal.test.js +71 -0
  437. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  438. package/dist/web/hooks/use-request-size.d.ts +20 -0
  439. package/dist/web/hooks/use-request-size.js +24 -0
  440. package/dist/web/hooks/use-request-size.js.map +1 -0
  441. package/dist/web/hooks/use-request-size.test.d.ts +1 -0
  442. package/dist/web/hooks/use-request-size.test.js +47 -0
  443. package/dist/web/hooks/use-request-size.test.js.map +1 -0
  444. package/dist/web/hooks/use-send-follow-up-message.d.ts +19 -0
  445. package/dist/web/hooks/use-send-follow-up-message.js +25 -0
  446. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  447. package/dist/web/hooks/use-set-open-in-app-url.d.ts +18 -0
  448. package/dist/web/hooks/use-set-open-in-app-url.js +25 -0
  449. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -0
  450. package/dist/web/hooks/use-set-open-in-app-url.test.d.ts +1 -0
  451. package/dist/web/hooks/use-set-open-in-app-url.test.js +57 -0
  452. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -0
  453. package/dist/web/hooks/use-tool-info.d.ts +68 -0
  454. package/dist/web/hooks/use-tool-info.js +48 -0
  455. package/dist/web/hooks/use-tool-info.js.map +1 -0
  456. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  457. package/dist/{src/web → web}/hooks/use-tool-info.test-d.js +19 -6
  458. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  459. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  460. package/dist/web/hooks/use-tool-info.test.js +135 -0
  461. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  462. package/dist/{src/web → web}/hooks/use-user.d.ts +5 -2
  463. package/dist/web/hooks/use-user.js +38 -0
  464. package/dist/web/hooks/use-user.js.map +1 -0
  465. package/dist/web/hooks/use-user.test.d.ts +1 -0
  466. package/dist/web/hooks/use-user.test.js +170 -0
  467. package/dist/web/hooks/use-user.test.js.map +1 -0
  468. package/dist/web/hooks/use-view-state.d.ts +25 -0
  469. package/dist/web/hooks/use-view-state.js +42 -0
  470. package/dist/web/hooks/use-view-state.js.map +1 -0
  471. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  472. package/dist/web/hooks/use-view-state.test.js +212 -0
  473. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  474. package/dist/web/hooks/use-viewport.d.ts +20 -0
  475. package/dist/web/hooks/use-viewport.js +21 -0
  476. package/dist/web/hooks/use-viewport.js.map +1 -0
  477. package/dist/web/hooks/use-viewport.test.d.ts +1 -0
  478. package/dist/web/hooks/use-viewport.test.js +109 -0
  479. package/dist/web/hooks/use-viewport.test.js.map +1 -0
  480. package/dist/{src/web → web}/index.d.ts +1 -2
  481. package/dist/{src/web → web}/index.js +1 -2
  482. package/dist/web/index.js.map +1 -0
  483. package/dist/web/mount-view.d.ts +21 -0
  484. package/dist/web/mount-view.js +43 -0
  485. package/dist/web/mount-view.js.map +1 -0
  486. package/dist/{src/web → web}/proxy.js +0 -1
  487. package/dist/web/proxy.js.map +1 -0
  488. package/dist/web/types.d.ts +20 -0
  489. package/dist/web/types.js +2 -0
  490. package/dist/web/types.js.map +1 -0
  491. package/package.json +90 -41
  492. package/tsconfig.base.json +33 -0
  493. package/dist/src/server/devtoolsStaticServer.d.ts +0 -15
  494. package/dist/src/server/devtoolsStaticServer.js +0 -38
  495. package/dist/src/server/devtoolsStaticServer.js.map +0 -1
  496. package/dist/src/server/index.d.ts +0 -5
  497. package/dist/src/server/index.js +0 -4
  498. package/dist/src/server/index.js.map +0 -1
  499. package/dist/src/server/inferUtilityTypes.js.map +0 -1
  500. package/dist/src/server/server.d.ts +0 -74
  501. package/dist/src/server/server.js +0 -82
  502. package/dist/src/server/server.js.map +0 -1
  503. package/dist/src/server/templateHelper.js +0 -30
  504. package/dist/src/server/templateHelper.js.map +0 -1
  505. package/dist/src/server/templates/development.hbs +0 -13
  506. package/dist/src/server/templates/production.hbs +0 -7
  507. package/dist/src/server/widgetsDevServer.d.ts +0 -12
  508. package/dist/src/server/widgetsDevServer.js +0 -39
  509. package/dist/src/server/widgetsDevServer.js.map +0 -1
  510. package/dist/src/test/utils.js +0 -242
  511. package/dist/src/test/utils.js.map +0 -1
  512. package/dist/src/test/widget.test.js +0 -146
  513. package/dist/src/test/widget.test.js.map +0 -1
  514. package/dist/src/web/bridges/apps-sdk-bridge.d.ts +0 -8
  515. package/dist/src/web/bridges/apps-sdk-bridge.js +0 -41
  516. package/dist/src/web/bridges/apps-sdk-bridge.js.map +0 -1
  517. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.d.ts +0 -2
  518. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js +0 -7
  519. package/dist/src/web/bridges/hooks/use-apps-sdk-bridge.js.map +0 -1
  520. package/dist/src/web/bridges/hooks/use-bridge.d.ts +0 -3
  521. package/dist/src/web/bridges/hooks/use-bridge.js +0 -27
  522. package/dist/src/web/bridges/hooks/use-bridge.js.map +0 -1
  523. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.d.ts +0 -4
  524. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js +0 -7
  525. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.js.map +0 -1
  526. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js +0 -58
  527. package/dist/src/web/bridges/hooks/use-mcp-app-bridge.test.js.map +0 -1
  528. package/dist/src/web/bridges/index.d.ts +0 -3
  529. package/dist/src/web/bridges/index.js +0 -4
  530. package/dist/src/web/bridges/index.js.map +0 -1
  531. package/dist/src/web/bridges/mcp-app-bridge.d.ts +0 -26
  532. package/dist/src/web/bridges/mcp-app-bridge.js +0 -130
  533. package/dist/src/web/bridges/mcp-app-bridge.js.map +0 -1
  534. package/dist/src/web/create-store.d.ts +0 -3
  535. package/dist/src/web/create-store.js +0 -25
  536. package/dist/src/web/create-store.js.map +0 -1
  537. package/dist/src/web/create-store.test.js +0 -70
  538. package/dist/src/web/create-store.test.js.map +0 -1
  539. package/dist/src/web/data-llm.d.ts +0 -14
  540. package/dist/src/web/data-llm.js.map +0 -1
  541. package/dist/src/web/data-llm.test.js +0 -76
  542. package/dist/src/web/data-llm.test.js.map +0 -1
  543. package/dist/src/web/generate-helpers.js.map +0 -1
  544. package/dist/src/web/generate-helpers.test-d.js.map +0 -1
  545. package/dist/src/web/generate-helpers.test.js.map +0 -1
  546. package/dist/src/web/helpers/state.js +0 -40
  547. package/dist/src/web/helpers/state.js.map +0 -1
  548. package/dist/src/web/helpers/state.test.js.map +0 -1
  549. package/dist/src/web/hooks/index.d.ts +0 -11
  550. package/dist/src/web/hooks/index.js +0 -12
  551. package/dist/src/web/hooks/index.js.map +0 -1
  552. package/dist/src/web/hooks/use-call-tool.js +0 -60
  553. package/dist/src/web/hooks/use-call-tool.js.map +0 -1
  554. package/dist/src/web/hooks/use-call-tool.test-d.js.map +0 -1
  555. package/dist/src/web/hooks/use-call-tool.test.js.map +0 -1
  556. package/dist/src/web/hooks/use-display-mode.d.ts +0 -4
  557. package/dist/src/web/hooks/use-display-mode.js +0 -7
  558. package/dist/src/web/hooks/use-display-mode.js.map +0 -1
  559. package/dist/src/web/hooks/use-display-mode.test.js +0 -41
  560. package/dist/src/web/hooks/use-display-mode.test.js.map +0 -1
  561. package/dist/src/web/hooks/use-files.d.ts +0 -10
  562. package/dist/src/web/hooks/use-files.js +0 -7
  563. package/dist/src/web/hooks/use-files.js.map +0 -1
  564. package/dist/src/web/hooks/use-files.test.js +0 -29
  565. package/dist/src/web/hooks/use-files.test.js.map +0 -1
  566. package/dist/src/web/hooks/use-layout.d.ts +0 -22
  567. package/dist/src/web/hooks/use-layout.js +0 -23
  568. package/dist/src/web/hooks/use-layout.js.map +0 -1
  569. package/dist/src/web/hooks/use-layout.test.js +0 -46
  570. package/dist/src/web/hooks/use-layout.test.js.map +0 -1
  571. package/dist/src/web/hooks/use-open-external.d.ts +0 -1
  572. package/dist/src/web/hooks/use-open-external.js +0 -6
  573. package/dist/src/web/hooks/use-open-external.js.map +0 -1
  574. package/dist/src/web/hooks/use-open-external.test.js +0 -24
  575. package/dist/src/web/hooks/use-open-external.test.js.map +0 -1
  576. package/dist/src/web/hooks/use-openai-global.d.ts +0 -3
  577. package/dist/src/web/hooks/use-openai-global.js +0 -6
  578. package/dist/src/web/hooks/use-openai-global.js.map +0 -1
  579. package/dist/src/web/hooks/use-request-modal.d.ts +0 -6
  580. package/dist/src/web/hooks/use-request-modal.js +0 -9
  581. package/dist/src/web/hooks/use-request-modal.js.map +0 -1
  582. package/dist/src/web/hooks/use-request-modal.test.js +0 -24
  583. package/dist/src/web/hooks/use-request-modal.test.js.map +0 -1
  584. package/dist/src/web/hooks/use-send-follow-up-message.d.ts +0 -1
  585. package/dist/src/web/hooks/use-send-follow-up-message.js +0 -11
  586. package/dist/src/web/hooks/use-send-follow-up-message.js.map +0 -1
  587. package/dist/src/web/hooks/use-tool-info.d.ts +0 -25
  588. package/dist/src/web/hooks/use-tool-info.js +0 -20
  589. package/dist/src/web/hooks/use-tool-info.js.map +0 -1
  590. package/dist/src/web/hooks/use-tool-info.test-d.js.map +0 -1
  591. package/dist/src/web/hooks/use-tool-info.test.js +0 -60
  592. package/dist/src/web/hooks/use-tool-info.test.js.map +0 -1
  593. package/dist/src/web/hooks/use-user.js +0 -19
  594. package/dist/src/web/hooks/use-user.js.map +0 -1
  595. package/dist/src/web/hooks/use-user.test.js +0 -44
  596. package/dist/src/web/hooks/use-user.test.js.map +0 -1
  597. package/dist/src/web/hooks/use-widget-state.d.ts +0 -4
  598. package/dist/src/web/hooks/use-widget-state.js +0 -32
  599. package/dist/src/web/hooks/use-widget-state.js.map +0 -1
  600. package/dist/src/web/hooks/use-widget-state.test.js +0 -61
  601. package/dist/src/web/hooks/use-widget-state.test.js.map +0 -1
  602. package/dist/src/web/index.js.map +0 -1
  603. package/dist/src/web/mount-widget.d.ts +0 -1
  604. package/dist/src/web/mount-widget.js +0 -19
  605. package/dist/src/web/mount-widget.js.map +0 -1
  606. package/dist/src/web/plugin/data-llm.test.js +0 -81
  607. package/dist/src/web/plugin/data-llm.test.js.map +0 -1
  608. package/dist/src/web/plugin/plugin.d.ts +0 -2
  609. package/dist/src/web/plugin/plugin.js +0 -39
  610. package/dist/src/web/plugin/plugin.js.map +0 -1
  611. package/dist/src/web/plugin/transform-data-llm.d.ts +0 -12
  612. package/dist/src/web/plugin/transform-data-llm.js +0 -93
  613. package/dist/src/web/plugin/transform-data-llm.js.map +0 -1
  614. package/dist/src/web/plugin/transform-data-llm.test.js +0 -81
  615. package/dist/src/web/plugin/transform-data-llm.test.js.map +0 -1
  616. package/dist/src/web/proxy.js.map +0 -1
  617. package/dist/src/web/types.d.ts +0 -138
  618. package/dist/src/web/types.js.map +0 -1
  619. package/dist/vitest.config.d.ts +0 -2
  620. package/dist/vitest.config.js +0 -8
  621. package/dist/vitest.config.js.map +0 -1
  622. /package/dist/{src/test/widget.test.d.ts → cli/build-helpers.test.d.ts} +0 -0
  623. /package/dist/{src/web/bridges/hooks/use-mcp-app-bridge.test.d.ts → cli/build-steps.test.d.ts} +0 -0
  624. /package/dist/{src/web/create-store.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  625. /package/dist/{src/web/data-llm.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
  626. /package/dist/{src/web/generate-helpers.test-d.d.ts → cli/tunnel.test.d.ts} +0 -0
  627. /package/dist/{src/web/generate-helpers.test.d.ts → context-warnings.test.d.ts} +0 -0
  628. /package/dist/{src/web/helpers/state.test.d.ts → server/app.test.d.ts} +0 -0
  629. /package/dist/{src/web/hooks/use-call-tool.test-d.d.ts → server/asset-base-url-transform-plugin.test.d.ts} +0 -0
  630. /package/dist/{src/web/hooks/use-display-mode.test.d.ts → server/auth/discovery.test.d.ts} +0 -0
  631. /package/dist/{src/web/hooks/use-files.test.d.ts → server/auth/providers/auth0.test.d.ts} +0 -0
  632. /package/dist/{src/web/hooks/use-layout.test.d.ts → server/auth/providers/authplane.test.d.ts} +0 -0
  633. /package/dist/{src/web/hooks/use-open-external.test.d.ts → server/auth/providers/clerk.test.d.ts} +0 -0
  634. /package/dist/{src/web/hooks/use-request-modal.test.d.ts → server/auth/providers/custom.test.d.ts} +0 -0
  635. /package/dist/{src/web/hooks/use-tool-info.test-d.d.ts → server/auth/providers/descope.test.d.ts} +0 -0
  636. /package/dist/{src/web/hooks/use-tool-info.test.d.ts → server/auth/providers/shared.test.d.ts} +0 -0
  637. /package/dist/{src/web/hooks/use-user.test.d.ts → server/auth/security-schemes.test.d.ts} +0 -0
  638. /package/dist/{src/web/hooks/use-widget-state.test.d.ts → server/auth/setup.test.d.ts} +0 -0
  639. /package/dist/{src/web/plugin/data-llm.test.d.ts → server/auth/verify.test.d.ts} +0 -0
  640. /package/dist/{src/web/hooks/use-call-tool.test.d.ts → server/auth-extra.test-d.d.ts} +0 -0
  641. /package/dist/{src/web/plugin/transform-data-llm.test.d.ts → server/build-manifest.test.d.ts} +0 -0
  642. /package/dist/{src/server → server}/inferUtilityTypes.js +0 -0
  643. /package/dist/{src/web → web}/hooks/use-call-tool.test-d.js +0 -0
  644. /package/dist/{src/web → web}/proxy.d.ts +0 -0
@@ -0,0 +1,591 @@
1
+ import crypto from "node:crypto";
2
+ import { readFileSync } from "node:fs";
3
+ import path from "node:path";
4
+ import { McpServer as McpServerBase, } from "@modelcontextprotocol/server";
5
+ import { warnOnLargeToolOutput } from "../context-warnings.js";
6
+ import { authToSecuritySchemes, evaluateSecuritySchemes, inBandChallengeResult, } from "./auth/security-schemes.js";
7
+ import { hostFromUserAgent } from "./host.js";
8
+ import { captureToolError } from "./middleware.js";
9
+ import { resolveServerOrigin } from "./requestOrigin.js";
10
+ import { discoverSkills, registerSkills, SKILLS_EXTENSION_KEY, } from "./skills.js";
11
+ import { templateHelper } from "./templateHelper.js";
12
+ const unionOf = (base, extra) => extra ? [...new Set([...base, ...extra])] : base;
13
+ function definedEntries(values) {
14
+ return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
15
+ }
16
+ function acceptsEmptyInput(inputSchema) {
17
+ if (inputSchema === undefined) {
18
+ return true;
19
+ }
20
+ const checks = "~standard" in inputSchema
21
+ ? [inputSchema["~standard"].validate({})]
22
+ : Object.values(inputSchema).map((schema) => schema["~standard"].validate(undefined));
23
+ return checks.every((result) => result instanceof Promise || result.issues === undefined);
24
+ }
25
+ const SKILLS_DIR = "src/skills";
26
+ /**
27
+ * Normalize an `x-forwarded-prefix` value into a leading-slash, no-trailing-slash
28
+ * path. Takes the first hop of a comma-separated proxy chain.
29
+ * "/v1/", "v1", "/v1, /internal" → "/v1"; "", "/", undefined → "".
30
+ */
31
+ function normalizeForwardedPrefix(raw) {
32
+ const firstHop = raw?.split(",")[0]?.trim() ?? "";
33
+ const trimmed = firstHop.replace(/\/+$/, "");
34
+ if (trimmed === "") {
35
+ return "";
36
+ }
37
+ return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
38
+ }
39
+ /**
40
+ * Drop the query string from a `ui://` view URI, leaving the bare path. The
41
+ * `?v=` cache key is the only query we append, so a plain split is enough and
42
+ * sidesteps `URL` normalization quirks on the non-special `ui:` scheme.
43
+ */
44
+ function stripQuery(uri) {
45
+ const queryIndex = uri.indexOf("?");
46
+ return queryIndex === -1 ? uri : uri.slice(0, queryIndex);
47
+ }
48
+ /**
49
+ * Coerce a tool handler's return value into an MCP `content` array. Strings
50
+ * become a single `TextContent`; a single block is wrapped in an array;
51
+ * `undefined` produces `[]`. Mostly used internally — exported so consumers
52
+ * who build content lazily can apply the same normalization.
53
+ */
54
+ export function normalizeContent(content) {
55
+ if (content === undefined) {
56
+ return [];
57
+ }
58
+ if (typeof content === "string") {
59
+ return [{ type: "text", text: content }];
60
+ }
61
+ if (Array.isArray(content)) {
62
+ return content;
63
+ }
64
+ return [content];
65
+ }
66
+ const McpServerBaseOmitted = McpServerBase;
67
+ // Side channel populated by `dist/__entry.js` before user code is imported.
68
+ // Set at module scope rather than passed through the constructor because the
69
+ // wrapper has the manifest before the user's `new McpServer(...)` runs, and
70
+ // threading it through every call site (including user templates) is exactly
71
+ // the boilerplate this design is trying to hide.
72
+ let pendingBuildManifest = null;
73
+ /**
74
+ * Prime the build-time Vite manifest before user code constructs its
75
+ * `McpServer`. Called from the generated `dist/__entry.js`; not part of the
76
+ * user-facing API.
77
+ *
78
+ * @internal
79
+ */
80
+ export function __setBuildManifest(manifest) {
81
+ pendingBuildManifest = manifest;
82
+ }
83
+ let pendingSkillsManifest = null;
84
+ let cachedDiskManifest = null;
85
+ let discoveredSkills = null;
86
+ let warnedOnMissingSkills = false;
87
+ export function __setSkillsManifest(manifest) {
88
+ pendingSkillsManifest = manifest;
89
+ discoveredSkills = null;
90
+ }
91
+ // Pure and `this`-free so it can run inside the `super(...)` call, before `this`
92
+ // exists — the capability must be present for the `initialize` response.
93
+ function withSkillsCapability(options, skybridgeOptions) {
94
+ if (!skybridgeOptions?.skills) {
95
+ return options;
96
+ }
97
+ return {
98
+ ...options,
99
+ capabilities: {
100
+ ...options?.capabilities,
101
+ extensions: {
102
+ ...options?.capabilities?.extensions,
103
+ [SKILLS_EXTENSION_KEY]: { directoryRead: true },
104
+ },
105
+ },
106
+ };
107
+ }
108
+ /**
109
+ * Typed registration sugar over the MCP SDK's `McpServer`: a tool registry
110
+ * that carries input/output/meta shapes, view resources, per-tool security
111
+ * schemes, and prompt/resource registration. A {@link Skybridge} app builds
112
+ * one of these per request and hands it to your `handler`; chain
113
+ * {@link McpServer.registerTool} calls on it and return the result.
114
+ *
115
+ * The `TTools` generic accumulates each registered tool's input/output/meta
116
+ * shape, so `typeof app` carries enough information for view-side helpers
117
+ * like {@link generateHelpers} to produce fully-typed hooks.
118
+ *
119
+ * @typeParam TTools - Accumulated tool registry. Filled in by `registerTool`
120
+ * chaining; you almost never set this manually.
121
+ *
122
+ * @example
123
+ * ```ts
124
+ * export const app = new Skybridge({
125
+ * name: "my-app",
126
+ * version: "1.0.0",
127
+ * handler: (server) =>
128
+ * server.registerTool({
129
+ * name: "search",
130
+ * inputSchema: { query: z.string() },
131
+ * view: { component: "search" },
132
+ * }, async ({ query }) => ({ content: `Results for ${query}` })),
133
+ * });
134
+ * ```
135
+ *
136
+ * @see https://docs.skybridge.tech/api-reference/mcp-server
137
+ */
138
+ export class McpServer extends McpServerBaseOmitted {
139
+ claimedViews = new Map();
140
+ viewMetaBuilders = new Map();
141
+ /**
142
+ * Maps a view resource's query-less path to its canonical registered URI
143
+ * (the one carrying the `?v=` cache key). Lets `resources/read` resolve the
144
+ * underlying view no matter which version param the consumer sends, since
145
+ * the param is only a cache key, not part of the resource's identity.
146
+ */
147
+ viewUriByPath = new Map();
148
+ viteManifest = null;
149
+ oauthEnabled = false;
150
+ resolveResourceMetadataUrl;
151
+ toolSecuritySchemes = new Map();
152
+ userMiddlewareEntries = [];
153
+ constructor(serverInfo, options, skybridgeOptions) {
154
+ super(serverInfo, withSkillsCapability(options, skybridgeOptions));
155
+ this.oauthEnabled = Boolean(skybridgeOptions?.oauth);
156
+ // Pick up the manifest if `dist/__entry.js` primed it before importing
157
+ // user code. Explicit `setViteManifest` calls still win because they
158
+ // happen after construction.
159
+ if (pendingBuildManifest) {
160
+ this.setViteManifest(pendingBuildManifest);
161
+ }
162
+ this.setupSkills(Boolean(skybridgeOptions?.skills));
163
+ }
164
+ /**
165
+ * The per-tool security schemes collected during registration, keyed by tool
166
+ * name. Read by the OAuth layer to decide whether anonymous requests are
167
+ * allowed and which schemes gate a given `tools/call`.
168
+ *
169
+ * @internal
170
+ */
171
+ get securitySchemesByTool() {
172
+ return this.toolSecuritySchemes;
173
+ }
174
+ /**
175
+ * Inject the resolver the app uses to build the protected-resource metadata
176
+ * URL, so tool handlers can emit in-band auth challenges.
177
+ *
178
+ * @internal
179
+ */
180
+ setResourceMetadataUrlResolver(resolve) {
181
+ this.resolveResourceMetadataUrl = resolve;
182
+ return this;
183
+ }
184
+ setupSkills(enabled) {
185
+ if (!enabled) {
186
+ return;
187
+ }
188
+ discoveredSkills ??= pendingSkillsManifest ?? discoverSkills(SKILLS_DIR);
189
+ if (discoveredSkills.length === 0 && !warnedOnMissingSkills) {
190
+ warnedOnMissingSkills = true;
191
+ console.warn(`skybridge: the "skills" option is enabled but no skills were found in "${SKILLS_DIR}". Add a <name>/SKILL.md there, or remove the option.`);
192
+ }
193
+ registerSkills(this, discoveredSkills);
194
+ }
195
+ mcpMiddleware(filterOrHandler,
196
+ // biome-ignore lint/suspicious/noExplicitAny: overloads narrow the handler type at call sites; implementation must accept all variants
197
+ maybeHandler) {
198
+ const handler = maybeHandler;
199
+ if (typeof filterOrHandler === "function") {
200
+ this.userMiddlewareEntries.push({
201
+ filter: null,
202
+ handler: filterOrHandler,
203
+ });
204
+ }
205
+ else if (handler) {
206
+ this.userMiddlewareEntries.push({
207
+ filter: filterOrHandler,
208
+ handler,
209
+ });
210
+ }
211
+ else {
212
+ throw new Error("mcpMiddleware requires a handler function when a filter is provided");
213
+ }
214
+ return this;
215
+ }
216
+ /**
217
+ * This instance's protocol-level middleware: the framework's own entries
218
+ * (view `_meta` on `resources/list`, version-agnostic view resolution on
219
+ * `resources/read`, the top-level `securitySchemes` mirror on `tools/list`)
220
+ * followed by the ones registered via {@link McpServer.mcpMiddleware}.
221
+ *
222
+ * @internal
223
+ */
224
+ protocolMiddlewareEntries() {
225
+ // Surface view-resource _meta on `resources/list` (per ext-apps spec:
226
+ // hosts/checkers read CSP & domain at list time before fetching content).
227
+ const viewListMetaEntry = {
228
+ filter: "resources/list",
229
+ handler: async (_req, extra, next) => {
230
+ const result = (await next());
231
+ for (const resource of result.resources) {
232
+ const builder = this.viewMetaBuilders.get(resource.uri);
233
+ if (!builder) {
234
+ continue;
235
+ }
236
+ const meta = builder(extra);
237
+ resource._meta = {
238
+ ...(resource._meta ?? {}),
239
+ ...meta,
240
+ };
241
+ }
242
+ return result;
243
+ },
244
+ };
245
+ // Resolve a view's `resources/read` by its query-less path so the
246
+ // underlying asset is served no matter the `?v=` value (stale cache key,
247
+ // no param, etc.). The version param is a cache-busting hint for external
248
+ // consumers; it must not gate resolution. We rewrite the lookup URI to the
249
+ // canonical registered one, then restore the requested URI on the response
250
+ // so the consumer-facing URI is never rewritten.
251
+ const viewReadResolveEntry = {
252
+ filter: "resources/read",
253
+ handler: async (req, _extra, next) => {
254
+ const requested = req.params.uri;
255
+ if (typeof requested !== "string") {
256
+ return next();
257
+ }
258
+ const path = stripQuery(requested);
259
+ const canonical = this.viewUriByPath.get(path);
260
+ if (!canonical) {
261
+ return next();
262
+ }
263
+ req.params.uri = canonical;
264
+ try {
265
+ const result = (await next());
266
+ for (const content of result.contents ?? []) {
267
+ if (typeof content.uri === "string" &&
268
+ stripQuery(content.uri) === stripQuery(canonical)) {
269
+ content.uri = requested;
270
+ }
271
+ }
272
+ return result;
273
+ }
274
+ finally {
275
+ // Restore the shared request params so middleware outer to us never
276
+ // observes the rewritten lookup URI after next() unwinds.
277
+ req.params.uri = requested;
278
+ }
279
+ },
280
+ };
281
+ // ChatGPT reads `securitySchemes` at the tool descriptor top level (SEP-1488,
282
+ // still Draft), but the SDK's registerTool strips unknown top-level fields, so
283
+ // it's stashed in `_meta` at registration. This restores it to the top level
284
+ // on tools/list output. Remove once SEP-1488 lands and the SDK preserves it.
285
+ // { name: "checkout", _meta: { securitySchemes: [{ type: "oauth2" }] } }
286
+ // -> { name: "checkout", _meta: {…}, securitySchemes: [{ type: "oauth2" }] }
287
+ const toolsListSecuritySchemesEntry = {
288
+ filter: "tools/list",
289
+ handler: async (_req, _extra, next) => {
290
+ const result = (await next());
291
+ for (const tool of result.tools) {
292
+ const schemes = tool._meta?.securitySchemes;
293
+ if (schemes && !("securitySchemes" in tool)) {
294
+ tool.securitySchemes = schemes;
295
+ }
296
+ }
297
+ return result;
298
+ },
299
+ };
300
+ return [
301
+ viewListMetaEntry,
302
+ viewReadResolveEntry,
303
+ toolsListSecuritySchemesEntry,
304
+ ...this.userMiddlewareEntries,
305
+ ];
306
+ }
307
+ enforceOneToolPerView(component, toolName) {
308
+ const existingTool = this.claimedViews.get(component);
309
+ if (existingTool) {
310
+ throw new Error(`skybridge: view "${component}" is already used by tool "${existingTool}". Tool "${toolName}" cannot also reference it — each view backs exactly one tool.`);
311
+ }
312
+ this.claimedViews.set(component, toolName);
313
+ }
314
+ resolveViewRequestContext(ctx) {
315
+ const isProduction = process.env.NODE_ENV === "production";
316
+ const header = (key) => ctx?.http?.req?.headers.get(key) ?? undefined;
317
+ const isClaude = hostFromUserAgent(header("user-agent")) === "claude";
318
+ const serverUrl = resolveServerOrigin(header);
319
+ // Path prefix the proxy routed this request under (e.g. `foo.com/v1`). Read
320
+ // per-request so one process can serve many hosts/prefixes at once: the
321
+ // origin is recovered from x-forwarded-host, the prefix from
322
+ // x-forwarded-prefix. Empty when served at the origin root.
323
+ const assetsBasePath = normalizeForwardedPrefix(header("x-forwarded-prefix"));
324
+ const connectDomains = [serverUrl];
325
+ if (!isProduction) {
326
+ const wsUrl = new URL(serverUrl);
327
+ wsUrl.protocol = wsUrl.protocol === "https:" ? "wss:" : "ws:";
328
+ connectDomains.push(wsUrl.origin);
329
+ }
330
+ let contentMetaOverrides = {};
331
+ if (isClaude) {
332
+ const pathname = ctx?.http?.req ? new URL(ctx.http.req.url).pathname : "";
333
+ const rawUrl = header("x-alpic-forwarded-url") ?? `${serverUrl}${pathname}`;
334
+ // Strip a lone trailing slash so the hash matches the connector URL
335
+ // as registered with Claude (which has no trailing slash on bare origins).
336
+ const url = rawUrl.endsWith("/") ? rawUrl.slice(0, -1) : rawUrl;
337
+ const hash = crypto
338
+ .createHash("sha256")
339
+ .update(url)
340
+ .digest("hex")
341
+ .slice(0, 32);
342
+ contentMetaOverrides = { domain: `${hash}.claudemcpcontent.com` };
343
+ }
344
+ return { serverUrl, assetsBasePath, connectDomains, contentMetaOverrides };
345
+ }
346
+ registerViewResources(toolName, view, toolMeta, openaiResourceMeta) {
347
+ // Append a content-derived version param so hosts (e.g. ChatGPT) bust
348
+ // their cache when the bundle changes, but keep the URI stable across
349
+ // `tools/list` calls when the bundle hasn't changed.
350
+ const versionParam = this.computeViewVersionParam(view.component);
351
+ const viewResource = {
352
+ uri: `ui://views/ext-apps/${view.component}.html${versionParam}`,
353
+ mimeType: "text/html;profile=mcp-app",
354
+ buildContentMeta: ({ resourceDomains, connectDomains, domain, baseUriDomains }, overrides) => {
355
+ const ui = {
356
+ ui: {
357
+ ...(view.description && { description: view.description }),
358
+ ...(view.prefersBorder !== undefined && {
359
+ prefersBorder: view.prefersBorder,
360
+ }),
361
+ domain: overrides.domain ?? view.domain ?? domain,
362
+ csp: {
363
+ resourceDomains: unionOf(resourceDomains, view.csp?.resourceDomains),
364
+ connectDomains: unionOf(connectDomains, view.csp?.connectDomains),
365
+ baseUriDomains: unionOf(baseUriDomains, view.csp?.baseUriDomains),
366
+ ...(view.csp?.frameDomains && {
367
+ frameDomains: view.csp.frameDomains,
368
+ }),
369
+ },
370
+ },
371
+ };
372
+ const base = {
373
+ ...ui,
374
+ ...(view.description && {
375
+ "openai/widgetDescription": view.description,
376
+ }),
377
+ ...(view.csp?.redirectDomains && {
378
+ "openai/widgetCSP": { redirect_domains: view.csp.redirectDomains },
379
+ }),
380
+ };
381
+ const meta = { ...base, ...view._meta };
382
+ if (openaiResourceMeta && Object.keys(openaiResourceMeta).length > 0) {
383
+ meta["openai/ui"] = {
384
+ ...view._meta?.["openai/ui"],
385
+ ...openaiResourceMeta,
386
+ };
387
+ }
388
+ return meta;
389
+ },
390
+ };
391
+ this.registerViewResource({ name: toolName, viewResource, view });
392
+ // Advertise via the MCP Apps standard pointer only — ChatGPT renders from
393
+ // ui.resourceUri (verified), and not emitting openai/outputTemplate lets us
394
+ // retire the legacy apps-sdk resource later. The legacy apps-sdk URL is still
395
+ // served (see registerViewResource) so already-published apps keep resolving.
396
+ // @ts-expect-error - For backwards compatibility with Claude current implementation of the specs
397
+ toolMeta["ui/resourceUri"] = viewResource.uri;
398
+ toolMeta.ui = { ...toolMeta.ui, resourceUri: viewResource.uri };
399
+ }
400
+ registerViewResource({ name, viewResource, view, }) {
401
+ const { uri: viewUri, mimeType, buildContentMeta } = viewResource;
402
+ const buildMeta = (extra) => {
403
+ const { serverUrl, connectDomains, contentMetaOverrides } = this.resolveViewRequestContext(extra);
404
+ return buildContentMeta({
405
+ resourceDomains: [serverUrl],
406
+ connectDomains,
407
+ domain: serverUrl,
408
+ baseUriDomains: [serverUrl],
409
+ }, contentMetaOverrides);
410
+ };
411
+ this.viewMetaBuilders.set(viewUri, buildMeta);
412
+ this.viewUriByPath.set(stripQuery(viewUri), viewUri);
413
+ this.serveLegacyAppsSdkUrl(view.component, viewUri);
414
+ this.registerResource(name, viewUri, { description: view.description }, async (uri, extra) => {
415
+ const isProduction = process.env.NODE_ENV === "production";
416
+ const { serverUrl, assetsBasePath } = this.resolveViewRequestContext(extra);
417
+ // The view resolves all assets (template imports + runtime lazy chunks
418
+ // via `window.skybridge.serverUrl`) against this base, so it carries the
419
+ // proxy path prefix. CSP domains in `buildMeta` stay the bare origin.
420
+ const viewBase = `${serverUrl}${assetsBasePath}`;
421
+ const html = isProduction
422
+ ? templateHelper.renderProduction({
423
+ serverUrl: viewBase,
424
+ viewFile: this.lookupViewFile(view.component),
425
+ styleFile: this.lookupDistFile("style.css") ?? "",
426
+ })
427
+ : templateHelper.renderDevelopment({
428
+ serverUrl: viewBase,
429
+ viewName: view.component,
430
+ });
431
+ return {
432
+ contents: [
433
+ { uri: uri.href, mimeType, text: html, _meta: buildMeta(extra) },
434
+ ],
435
+ };
436
+ });
437
+ }
438
+ serveLegacyAppsSdkUrl(component, canonicalUri) {
439
+ this.viewUriByPath.set(`ui://views/apps-sdk/${component}.html`, canonicalUri);
440
+ this.viewUriByPath.set(`ui://widgets/apps-sdk/${component}.html`, canonicalUri);
441
+ this.viewUriByPath.set(`ui://widgets/ext-apps/${component}.html`, canonicalUri);
442
+ }
443
+ decorateToolHandler(cb, { attachViewUUID, securitySchemes, toolName, }) {
444
+ return async (args, extra) => {
445
+ if (this.oauthEnabled) {
446
+ const failure = evaluateSecuritySchemes(securitySchemes, extra.http?.authInfo);
447
+ if (failure) {
448
+ const header = (key) => extra.http?.req?.headers.get(key) ?? undefined;
449
+ return inBandChallengeResult(failure, this.resolveResourceMetadataUrl?.(header));
450
+ }
451
+ }
452
+ let result;
453
+ try {
454
+ result = await cb(args, extra);
455
+ }
456
+ catch (error) {
457
+ captureToolError(extra, error);
458
+ throw error;
459
+ }
460
+ warnOnLargeToolOutput(result, toolName);
461
+ return {
462
+ ...result,
463
+ content: normalizeContent(result.content),
464
+ ...(attachViewUUID && {
465
+ _meta: {
466
+ ...result._meta,
467
+ viewUUID: crypto.randomUUID(),
468
+ },
469
+ }),
470
+ };
471
+ };
472
+ }
473
+ computeViewVersionParam(viewName) {
474
+ if (process.env.NODE_ENV !== "production") {
475
+ return "";
476
+ }
477
+ try {
478
+ const viewFile = this.lookupViewFile(viewName);
479
+ const styleFile = this.lookupDistFile("style.css") ?? "";
480
+ const hash = crypto
481
+ .createHash("sha256")
482
+ .update(viewFile)
483
+ .update("\0")
484
+ .update(styleFile)
485
+ .digest("hex")
486
+ .slice(0, 8);
487
+ return `?v=${hash}`;
488
+ }
489
+ catch {
490
+ return "";
491
+ }
492
+ }
493
+ lookupViewFile(viewName) {
494
+ const manifest = this.readManifest();
495
+ for (const entry of Object.values(manifest)) {
496
+ if (entry?.isEntry && entry.name === viewName && entry.file) {
497
+ return entry.file;
498
+ }
499
+ }
500
+ 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.`);
501
+ }
502
+ lookupDistFile(key) {
503
+ const manifest = this.readManifest();
504
+ return manifest[key]?.file;
505
+ }
506
+ /**
507
+ * Inject the Vite manifest as a value rather than letting `readManifest()`
508
+ * load it from disk. Required for runtimes without a usable filesystem
509
+ * (Cloudflare Workers, etc.) — the user's `skybridge build` emits the
510
+ * manifest as a JS module which the entry imports and passes here.
511
+ */
512
+ setViteManifest(manifest) {
513
+ this.viteManifest = manifest;
514
+ return this;
515
+ }
516
+ readManifest() {
517
+ if (this.viteManifest) {
518
+ return this.viteManifest;
519
+ }
520
+ cachedDiskManifest ??= JSON.parse(readFileSync(path.join(process.cwd(), "dist", "assets", ".vite", "manifest.json"), "utf-8"));
521
+ return cachedDiskManifest ?? {};
522
+ }
523
+ registerTool(rawConfig, rawCb) {
524
+ const baseFn = McpServerBase.prototype.registerTool;
525
+ const config = rawConfig;
526
+ const cb = rawCb;
527
+ const { name, view, auth, securitySchemes: rawSecuritySchemes, openai, _meta: userToolMeta, ...toolFields } = config;
528
+ const authNeedsProvider = auth !== undefined &&
529
+ (!auth.allowsAnonymous || Boolean(auth.scopes?.length));
530
+ if (rawSecuritySchemes === undefined &&
531
+ authNeedsProvider &&
532
+ !this.oauthEnabled) {
533
+ throw new Error(`Tool "${name}" sets \`auth: ${JSON.stringify(auth)}\` but the server has no \`oauth\` provider configured.`);
534
+ }
535
+ const securitySchemes = rawSecuritySchemes ??
536
+ (auth && this.oauthEnabled ? authToSecuritySchemes(auth) : undefined);
537
+ const toolMeta = { ...userToolMeta };
538
+ this.toolSecuritySchemes.set(name, securitySchemes);
539
+ if (securitySchemes) {
540
+ // SEP-1488 puts `securitySchemes` at the top level of the tool
541
+ // descriptor, but the SDK's `registerTool` drops unknown top-level
542
+ // fields, so the canonical spot isn't reachable without intercepting
543
+ // `tools/list`. Use the `_meta` back-compat mirror documented in the
544
+ // Apps SDK reference until SEP-1488 lands in the spec.
545
+ toolMeta.securitySchemes = securitySchemes;
546
+ }
547
+ if (openai) {
548
+ if (!view) {
549
+ throw new Error(`skybridge: tool "${name}" sets \`openai\` options but has no \`view\`.`);
550
+ }
551
+ const opensWithoutInput = openai.entrypoints?.some(({ type }) => type === "global" || type === "thread");
552
+ if (opensWithoutInput && !acceptsEmptyInput(toolFields.inputSchema)) {
553
+ throw new Error(`skybridge: tool "${name}" has a global or thread entrypoint, so ChatGPT calls it with \`{}\`, but its input schema rejects \`{}\`. Make every input optional.`);
554
+ }
555
+ const badExtension = openai.entrypoints
556
+ ?.flatMap((entrypoint) => entrypoint.type === "file" ? entrypoint.extensions : [])
557
+ .find((extension) => !extension.startsWith("."));
558
+ if (badExtension !== undefined) {
559
+ throw new Error(`skybridge: tool "${name}" has a file entrypoint extension "${badExtension}" that doesn't start with ".".`);
560
+ }
561
+ const openaiUi = definedEntries({
562
+ entrypoints: openai.entrypoints,
563
+ preferredModelDisplayMode: openai.preferredModelDisplayMode,
564
+ });
565
+ if (Object.keys(openaiUi).length > 0) {
566
+ toolMeta["openai/ui"] = {
567
+ ...userToolMeta?.["openai/ui"],
568
+ ...openaiUi,
569
+ };
570
+ }
571
+ }
572
+ if (view) {
573
+ this.enforceOneToolPerView(view.component, name);
574
+ this.registerViewResources(name, view, toolMeta, openai &&
575
+ definedEntries({
576
+ availableDisplayModes: openai.availableDisplayModes,
577
+ preferredDisplayMode: openai.preferredDisplayMode,
578
+ }));
579
+ }
580
+ const wrappedCb = this.decorateToolHandler(cb, {
581
+ attachViewUUID: Boolean(view),
582
+ securitySchemes,
583
+ toolName: name,
584
+ });
585
+ baseFn.call(this, name, { ...toolFields, _meta: toolMeta }, toolFields.inputSchema === undefined
586
+ ? (extra) => wrappedCb({}, extra)
587
+ : wrappedCb);
588
+ return this;
589
+ }
590
+ }
591
+ //# sourceMappingURL=server.js.map