@frontmcp/sdk 0.4.0 → 0.5.0

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 (558) hide show
  1. package/README.md +30 -18
  2. package/package.json +20 -5
  3. package/src/app/app.registry.d.ts +3 -2
  4. package/src/app/app.registry.js +3 -1
  5. package/src/app/app.registry.js.map +1 -1
  6. package/src/app/instances/app.local.instance.js +2 -2
  7. package/src/app/instances/app.local.instance.js.map +1 -1
  8. package/src/auth/auth.registry.d.ts +34 -2
  9. package/src/auth/auth.registry.js +162 -24
  10. package/src/auth/auth.registry.js.map +1 -1
  11. package/src/auth/auth.utils.js +8 -9
  12. package/src/auth/auth.utils.js.map +1 -1
  13. package/src/auth/authorization/authorization.class.d.ts +125 -0
  14. package/src/auth/authorization/authorization.class.js +224 -0
  15. package/src/auth/authorization/authorization.class.js.map +1 -0
  16. package/src/auth/authorization/authorization.types.d.ts +300 -0
  17. package/src/auth/authorization/authorization.types.js +79 -0
  18. package/src/auth/authorization/authorization.types.js.map +1 -0
  19. package/src/auth/authorization/index.d.ts +5 -0
  20. package/src/auth/authorization/index.js +19 -0
  21. package/src/auth/authorization/index.js.map +1 -0
  22. package/src/auth/authorization/orchestrated.authorization.d.ts +242 -0
  23. package/src/auth/authorization/orchestrated.authorization.js +306 -0
  24. package/src/auth/authorization/orchestrated.authorization.js.map +1 -0
  25. package/src/auth/authorization/public.authorization.d.ts +91 -0
  26. package/src/auth/authorization/public.authorization.js +132 -0
  27. package/src/auth/authorization/public.authorization.js.map +1 -0
  28. package/src/auth/authorization/transparent.authorization.d.ts +130 -0
  29. package/src/auth/authorization/transparent.authorization.js +147 -0
  30. package/src/auth/authorization/transparent.authorization.js.map +1 -0
  31. package/src/auth/consent/consent.types.d.ts +111 -0
  32. package/src/auth/consent/consent.types.js +119 -0
  33. package/src/auth/consent/consent.types.js.map +1 -0
  34. package/src/auth/consent/index.d.ts +1 -0
  35. package/src/auth/consent/index.js +13 -0
  36. package/src/auth/consent/index.js.map +1 -0
  37. package/src/auth/detection/auth-provider-detection.d.ts +84 -0
  38. package/src/auth/detection/auth-provider-detection.js +230 -0
  39. package/src/auth/detection/auth-provider-detection.js.map +1 -0
  40. package/src/auth/detection/index.d.ts +1 -0
  41. package/src/auth/detection/index.js +15 -0
  42. package/src/auth/detection/index.js.map +1 -0
  43. package/src/auth/flows/auth.verify.flow.d.ts +110 -0
  44. package/src/auth/flows/auth.verify.flow.js +379 -0
  45. package/src/auth/flows/auth.verify.flow.js.map +1 -0
  46. package/src/auth/flows/oauth.authorize.flow.d.ts +118 -164
  47. package/src/auth/flows/oauth.authorize.flow.js +701 -33
  48. package/src/auth/flows/oauth.authorize.flow.js.map +1 -1
  49. package/src/auth/flows/oauth.callback.flow.d.ts +117 -0
  50. package/src/auth/flows/oauth.callback.flow.js +357 -0
  51. package/src/auth/flows/oauth.callback.flow.js.map +1 -0
  52. package/src/auth/flows/oauth.register.flow.d.ts +32 -125
  53. package/src/auth/flows/oauth.token.flow.d.ts +52 -154
  54. package/src/auth/flows/oauth.token.flow.js +193 -55
  55. package/src/auth/flows/oauth.token.flow.js.map +1 -1
  56. package/src/auth/flows/session.verify.flow.d.ts +66 -321
  57. package/src/auth/flows/session.verify.flow.js +107 -18
  58. package/src/auth/flows/session.verify.flow.js.map +1 -1
  59. package/src/auth/flows/well-known.jwks.flow.d.ts +34 -205
  60. package/src/auth/flows/well-known.jwks.flow.js +15 -8
  61. package/src/auth/flows/well-known.jwks.flow.js.map +1 -1
  62. package/src/auth/flows/well-known.oauth-authorization-server.flow.d.ts +48 -223
  63. package/src/auth/flows/well-known.oauth-authorization-server.flow.js +2 -3
  64. package/src/auth/flows/well-known.oauth-authorization-server.flow.js.map +1 -1
  65. package/src/auth/flows/well-known.prm.flow.d.ts +19 -120
  66. package/src/auth/flows/well-known.prm.flow.js +3 -4
  67. package/src/auth/flows/well-known.prm.flow.js.map +1 -1
  68. package/src/auth/instances/instance.local-primary-auth.d.ts +91 -4
  69. package/src/auth/instances/instance.local-primary-auth.js +236 -6
  70. package/src/auth/instances/instance.local-primary-auth.js.map +1 -1
  71. package/src/auth/instances/instance.remote-primary-auth.d.ts +4 -3
  72. package/src/auth/instances/instance.remote-primary-auth.js +2 -2
  73. package/src/auth/instances/instance.remote-primary-auth.js.map +1 -1
  74. package/src/auth/session/authorization-vault.d.ts +611 -0
  75. package/src/auth/session/authorization-vault.js +817 -0
  76. package/src/auth/session/authorization-vault.js.map +1 -0
  77. package/src/auth/session/authorization.store.d.ts +301 -0
  78. package/src/auth/session/authorization.store.js +323 -0
  79. package/src/auth/session/authorization.store.js.map +1 -0
  80. package/src/auth/session/encrypted-authorization-vault.d.ts +181 -0
  81. package/src/auth/session/encrypted-authorization-vault.js +493 -0
  82. package/src/auth/session/encrypted-authorization-vault.js.map +1 -0
  83. package/src/auth/session/index.d.ts +4 -4
  84. package/src/auth/session/index.js +11 -7
  85. package/src/auth/session/index.js.map +1 -1
  86. package/src/auth/session/session.schema.d.ts +1 -1
  87. package/src/auth/session/session.service.d.ts +1 -1
  88. package/src/auth/session/transport-session.manager.d.ts +101 -0
  89. package/src/auth/session/transport-session.manager.js +300 -0
  90. package/src/auth/session/transport-session.manager.js.map +1 -0
  91. package/src/auth/session/transport-session.types.d.ts +457 -0
  92. package/src/auth/session/transport-session.types.js +110 -0
  93. package/src/auth/session/transport-session.types.js.map +1 -0
  94. package/src/auth/session/utils/session-id.utils.d.ts +14 -2
  95. package/src/auth/session/utils/session-id.utils.js +68 -19
  96. package/src/auth/session/utils/session-id.utils.js.map +1 -1
  97. package/src/auth/session/vault-encryption.d.ts +189 -0
  98. package/src/auth/session/vault-encryption.js +263 -0
  99. package/src/auth/session/vault-encryption.js.map +1 -0
  100. package/src/auth/ui/base-layout.d.ts +188 -0
  101. package/src/auth/ui/base-layout.js +292 -0
  102. package/src/auth/ui/base-layout.js.map +1 -0
  103. package/src/auth/ui/htmx-templates.d.ts +135 -0
  104. package/src/auth/ui/htmx-templates.js +433 -0
  105. package/src/auth/ui/htmx-templates.js.map +1 -0
  106. package/src/auth/ui/index.d.ts +11 -0
  107. package/src/auth/ui/index.js +35 -0
  108. package/src/auth/ui/index.js.map +1 -0
  109. package/src/auth/utils/audience.validator.d.ts +129 -0
  110. package/src/auth/utils/audience.validator.js +196 -0
  111. package/src/auth/utils/audience.validator.js.map +1 -0
  112. package/src/auth/utils/index.d.ts +2 -0
  113. package/src/auth/utils/index.js +7 -0
  114. package/src/auth/utils/index.js.map +1 -0
  115. package/src/auth/utils/www-authenticate.utils.d.ts +97 -0
  116. package/src/auth/utils/www-authenticate.utils.js +183 -0
  117. package/src/auth/utils/www-authenticate.utils.js.map +1 -0
  118. package/src/common/common.schema.d.ts +2 -16
  119. package/src/common/constants.d.ts +3 -0
  120. package/src/common/constants.js +6 -1
  121. package/src/common/constants.js.map +1 -1
  122. package/src/common/decorators/decorator-utils.d.ts +131 -0
  123. package/src/common/decorators/decorator-utils.js +195 -0
  124. package/src/common/decorators/decorator-utils.js.map +1 -0
  125. package/src/common/decorators/front-mcp.decorator.js +3 -2
  126. package/src/common/decorators/front-mcp.decorator.js.map +1 -1
  127. package/src/common/decorators/hook.decorator.d.ts +58 -2
  128. package/src/common/decorators/hook.decorator.js +127 -17
  129. package/src/common/decorators/hook.decorator.js.map +1 -1
  130. package/src/common/decorators/plugin.decorator.d.ts +1 -1
  131. package/src/common/decorators/plugin.decorator.js +11 -10
  132. package/src/common/decorators/plugin.decorator.js.map +1 -1
  133. package/src/common/decorators/resource.decorator.d.ts +32 -3
  134. package/src/common/decorators/resource.decorator.js +46 -4
  135. package/src/common/decorators/resource.decorator.js.map +1 -1
  136. package/src/common/decorators/tool.decorator.d.ts +54 -5
  137. package/src/common/decorators/tool.decorator.js.map +1 -1
  138. package/src/common/dynamic/dynamic.plugin.d.ts +22 -11
  139. package/src/common/dynamic/dynamic.plugin.js +7 -1
  140. package/src/common/dynamic/dynamic.plugin.js.map +1 -1
  141. package/src/common/entries/prompt.entry.d.ts +46 -2
  142. package/src/common/entries/prompt.entry.js +10 -0
  143. package/src/common/entries/prompt.entry.js.map +1 -1
  144. package/src/common/entries/resource.entry.d.ts +69 -6
  145. package/src/common/entries/resource.entry.js +27 -3
  146. package/src/common/entries/resource.entry.js.map +1 -1
  147. package/src/common/entries/scope.entry.d.ts +5 -1
  148. package/src/common/entries/scope.entry.js +3 -3
  149. package/src/common/entries/scope.entry.js.map +1 -1
  150. package/src/common/flow/flow.utils.d.ts +56 -0
  151. package/src/common/flow/flow.utils.js +96 -0
  152. package/src/common/flow/flow.utils.js.map +1 -0
  153. package/src/common/index.d.ts +2 -2
  154. package/src/common/index.js +2 -2
  155. package/src/common/index.js.map +1 -1
  156. package/src/common/interfaces/execution-context.interface.d.ts +59 -0
  157. package/src/common/interfaces/execution-context.interface.js +81 -0
  158. package/src/common/interfaces/execution-context.interface.js.map +1 -0
  159. package/src/common/interfaces/flow.interface.d.ts +1 -1
  160. package/src/common/interfaces/flow.interface.js.map +1 -1
  161. package/src/common/interfaces/index.d.ts +1 -0
  162. package/src/common/interfaces/index.js +1 -0
  163. package/src/common/interfaces/index.js.map +1 -1
  164. package/src/common/interfaces/internal/primary-auth-provider.interface.d.ts +17 -2
  165. package/src/common/interfaces/internal/primary-auth-provider.interface.js +52 -4
  166. package/src/common/interfaces/internal/primary-auth-provider.interface.js.map +1 -1
  167. package/src/common/interfaces/internal/registry.interface.d.ts +16 -2
  168. package/src/common/interfaces/internal/registry.interface.js.map +1 -1
  169. package/src/common/interfaces/plugin.interface.js.map +1 -1
  170. package/src/common/interfaces/prompt.interface.d.ts +53 -4
  171. package/src/common/interfaces/prompt.interface.js +78 -0
  172. package/src/common/interfaces/prompt.interface.js.map +1 -1
  173. package/src/common/interfaces/resource.interface.d.ts +47 -17
  174. package/src/common/interfaces/resource.interface.js +53 -0
  175. package/src/common/interfaces/resource.interface.js.map +1 -1
  176. package/src/common/interfaces/tool.interface.d.ts +39 -22
  177. package/src/common/interfaces/tool.interface.js +61 -34
  178. package/src/common/interfaces/tool.interface.js.map +1 -1
  179. package/src/common/metadata/adapter.metadata.d.ts +1 -9
  180. package/src/common/metadata/app.metadata.d.ts +425 -730
  181. package/src/common/metadata/auth-provider.metadata.d.ts +2 -12
  182. package/src/common/metadata/flow.metadata.d.ts +10 -25
  183. package/src/common/metadata/front-mcp.metadata.d.ts +602 -1023
  184. package/src/common/metadata/front-mcp.metadata.js +6 -4
  185. package/src/common/metadata/front-mcp.metadata.js.map +1 -1
  186. package/src/common/metadata/hook.metadata.d.ts +1 -1
  187. package/src/common/metadata/hook.metadata.js.map +1 -1
  188. package/src/common/metadata/index.d.ts +1 -0
  189. package/src/common/metadata/index.js +1 -0
  190. package/src/common/metadata/index.js.map +1 -1
  191. package/src/common/metadata/logger.metadata.d.ts +1 -9
  192. package/src/common/metadata/plugin.metadata.d.ts +8 -30
  193. package/src/common/metadata/prompt.metadata.d.ts +4 -161
  194. package/src/common/metadata/provider.metadata.d.ts +2 -12
  195. package/src/common/metadata/resource.metadata.d.ts +6 -98
  196. package/src/common/metadata/resource.metadata.js +15 -6
  197. package/src/common/metadata/resource.metadata.js.map +1 -1
  198. package/src/common/metadata/tool-ui.metadata.d.ts +10 -0
  199. package/src/common/metadata/tool-ui.metadata.js +12 -0
  200. package/src/common/metadata/tool-ui.metadata.js.map +1 -0
  201. package/src/common/metadata/tool.metadata.d.ts +78 -199
  202. package/src/common/metadata/tool.metadata.js +11 -14
  203. package/src/common/metadata/tool.metadata.js.map +1 -1
  204. package/src/common/providers/base-config.provider.d.ts +84 -0
  205. package/src/common/providers/base-config.provider.js +128 -0
  206. package/src/common/providers/base-config.provider.js.map +1 -0
  207. package/src/common/records/plugin.record.d.ts +5 -6
  208. package/src/common/records/plugin.record.js.map +1 -1
  209. package/src/common/records/prompt.record.js.map +1 -1
  210. package/src/common/records/resource.record.d.ts +17 -1
  211. package/src/common/records/resource.record.js +12 -6
  212. package/src/common/records/resource.record.js.map +1 -1
  213. package/src/common/records/tool.record.js.map +1 -1
  214. package/src/common/schemas/annotated-class.schema.d.ts +9 -9
  215. package/src/common/schemas/annotated-class.schema.js +92 -27
  216. package/src/common/schemas/annotated-class.schema.js.map +1 -1
  217. package/src/common/schemas/http-input.schema.d.ts +6 -30
  218. package/src/common/schemas/http-output.schema.d.ts +326 -1630
  219. package/src/common/schemas/http-output.schema.js +39 -1
  220. package/src/common/schemas/http-output.schema.js.map +1 -1
  221. package/src/common/tokens/front-mcp.tokens.js +4 -1
  222. package/src/common/tokens/front-mcp.tokens.js.map +1 -1
  223. package/src/common/tokens/resource.tokens.d.ts +2 -0
  224. package/src/common/tokens/resource.tokens.js +4 -1
  225. package/src/common/tokens/resource.tokens.js.map +1 -1
  226. package/src/common/tokens/tool.tokens.d.ts +2 -0
  227. package/src/common/tokens/tool.tokens.js +2 -0
  228. package/src/common/tokens/tool.tokens.js.map +1 -1
  229. package/src/common/types/auth/jwt.types.d.ts +5 -31
  230. package/src/common/types/auth/session.types.d.ts +97 -192
  231. package/src/common/types/auth/session.types.js +24 -11
  232. package/src/common/types/auth/session.types.js.map +1 -1
  233. package/src/common/types/options/auth.options.d.ts +1013 -490
  234. package/src/common/types/options/auth.options.js +554 -36
  235. package/src/common/types/options/auth.options.js.map +1 -1
  236. package/src/common/types/options/http.options.d.ts +1 -9
  237. package/src/common/types/options/logging.options.d.ts +7 -13
  238. package/src/common/types/options/logging.options.js +4 -0
  239. package/src/common/types/options/logging.options.js.map +1 -1
  240. package/src/common/types/options/server-info.options.d.ts +3 -31
  241. package/src/common/types/options/session.options.d.ts +90 -10
  242. package/src/common/types/options/session.options.js +26 -3
  243. package/src/common/types/options/session.options.js.map +1 -1
  244. package/src/common/utils/decide-request-intent.utils.d.ts +8 -46
  245. package/src/common/utils/decide-request-intent.utils.js +88 -23
  246. package/src/common/utils/decide-request-intent.utils.js.map +1 -1
  247. package/src/completion/flows/complete.flow.d.ts +74 -0
  248. package/src/completion/flows/complete.flow.js +199 -0
  249. package/src/completion/flows/complete.flow.js.map +1 -0
  250. package/src/errors/authorization-required.error.d.ts +189 -0
  251. package/src/errors/authorization-required.error.js +274 -0
  252. package/src/errors/authorization-required.error.js.map +1 -0
  253. package/src/errors/index.d.ts +2 -1
  254. package/src/errors/index.js +17 -1
  255. package/src/errors/index.js.map +1 -1
  256. package/src/errors/mcp.error.d.ts +101 -1
  257. package/src/errors/mcp.error.js +147 -2
  258. package/src/errors/mcp.error.js.map +1 -1
  259. package/src/flows/flow.instance.js +4 -3
  260. package/src/flows/flow.instance.js.map +1 -1
  261. package/src/flows/flow.registry.js.map +1 -1
  262. package/src/flows/flow.stages.js +14 -11
  263. package/src/flows/flow.stages.js.map +1 -1
  264. package/src/front-mcp/front-mcp.providers.d.ts +464 -102
  265. package/src/front-mcp/front-mcp.providers.js +3 -5
  266. package/src/front-mcp/front-mcp.providers.js.map +1 -1
  267. package/src/hooks/hook.instance.d.ts +1 -1
  268. package/src/hooks/hook.instance.js +5 -2
  269. package/src/hooks/hook.instance.js.map +1 -1
  270. package/src/hooks/hook.registry.js +7 -5
  271. package/src/hooks/hook.registry.js.map +1 -1
  272. package/src/index.d.ts +28 -9
  273. package/src/index.js +5 -1
  274. package/src/index.js.map +1 -1
  275. package/src/logger/instances/instance.logger.js +3 -2
  276. package/src/logger/instances/instance.logger.js.map +1 -1
  277. package/src/logger/logger.registry.js +7 -2
  278. package/src/logger/logger.registry.js.map +1 -1
  279. package/src/logging/flows/set-level.flow.d.ts +62 -0
  280. package/src/logging/flows/set-level.flow.js +108 -0
  281. package/src/logging/flows/set-level.flow.js.map +1 -0
  282. package/src/mcp-apps/csp.d.ts +111 -0
  283. package/src/mcp-apps/csp.js +267 -0
  284. package/src/mcp-apps/csp.js.map +1 -0
  285. package/src/mcp-apps/index.d.ts +23 -0
  286. package/src/mcp-apps/index.js +91 -0
  287. package/src/mcp-apps/index.js.map +1 -0
  288. package/src/mcp-apps/schemas.d.ts +403 -0
  289. package/src/mcp-apps/schemas.js +345 -0
  290. package/src/mcp-apps/schemas.js.map +1 -0
  291. package/src/mcp-apps/template.d.ts +94 -0
  292. package/src/mcp-apps/template.js +419 -0
  293. package/src/mcp-apps/template.js.map +1 -0
  294. package/src/mcp-apps/types.d.ts +323 -0
  295. package/src/mcp-apps/types.js +59 -0
  296. package/src/mcp-apps/types.js.map +1 -0
  297. package/src/notification/index.d.ts +1 -0
  298. package/src/notification/index.js +13 -0
  299. package/src/notification/index.js.map +1 -0
  300. package/src/notification/notification.service.d.ts +378 -0
  301. package/src/notification/notification.service.js +727 -0
  302. package/src/notification/notification.service.js.map +1 -0
  303. package/src/plugin/plugin.registry.js +12 -9
  304. package/src/plugin/plugin.registry.js.map +1 -1
  305. package/src/prompt/flows/get-prompt.flow.d.ts +153 -0
  306. package/src/prompt/flows/get-prompt.flow.js +214 -0
  307. package/src/prompt/flows/get-prompt.flow.js.map +1 -0
  308. package/src/prompt/flows/prompts-list.flow.d.ts +67 -0
  309. package/src/prompt/flows/prompts-list.flow.js +176 -0
  310. package/src/prompt/flows/prompts-list.flow.js.map +1 -0
  311. package/src/prompt/index.d.ts +7 -0
  312. package/src/prompt/index.js +17 -0
  313. package/src/prompt/index.js.map +1 -0
  314. package/src/prompt/prompt.events.d.ts +17 -0
  315. package/src/prompt/prompt.events.js +25 -0
  316. package/src/prompt/prompt.events.js.map +1 -0
  317. package/src/prompt/prompt.instance.d.ts +30 -0
  318. package/src/prompt/prompt.instance.js +120 -0
  319. package/src/prompt/prompt.instance.js.map +1 -0
  320. package/src/prompt/prompt.registry.d.ts +79 -12
  321. package/src/prompt/prompt.registry.js +360 -15
  322. package/src/prompt/prompt.registry.js.map +1 -1
  323. package/src/prompt/prompt.types.d.ts +26 -0
  324. package/src/prompt/prompt.types.js +11 -0
  325. package/src/prompt/prompt.types.js.map +1 -0
  326. package/src/prompt/prompt.utils.d.ts +26 -0
  327. package/src/prompt/prompt.utils.js +136 -0
  328. package/src/prompt/prompt.utils.js.map +1 -0
  329. package/src/provider/provider.registry.d.ts +12 -5
  330. package/src/provider/provider.registry.js +30 -138
  331. package/src/provider/provider.registry.js.map +1 -1
  332. package/src/regsitry/registry.base.d.ts +1 -1
  333. package/src/regsitry/registry.base.js.map +1 -1
  334. package/src/resource/flows/read-resource.flow.d.ts +91 -0
  335. package/src/resource/flows/read-resource.flow.js +270 -0
  336. package/src/resource/flows/read-resource.flow.js.map +1 -0
  337. package/src/resource/flows/resource-templates-list.flow.d.ts +64 -0
  338. package/src/resource/flows/resource-templates-list.flow.js +191 -0
  339. package/src/resource/flows/resource-templates-list.flow.js.map +1 -0
  340. package/src/resource/flows/resources-list.flow.d.ts +64 -0
  341. package/src/resource/flows/resources-list.flow.js +196 -0
  342. package/src/resource/flows/resources-list.flow.js.map +1 -0
  343. package/src/resource/flows/subscribe-resource.flow.d.ts +45 -0
  344. package/src/resource/flows/subscribe-resource.flow.js +123 -0
  345. package/src/resource/flows/subscribe-resource.flow.js.map +1 -0
  346. package/src/resource/flows/unsubscribe-resource.flow.d.ts +44 -0
  347. package/src/resource/flows/unsubscribe-resource.flow.js +107 -0
  348. package/src/resource/flows/unsubscribe-resource.flow.js.map +1 -0
  349. package/src/resource/index.d.ts +8 -0
  350. package/src/resource/index.js +20 -0
  351. package/src/resource/index.js.map +1 -0
  352. package/src/resource/resource.events.d.ts +24 -0
  353. package/src/resource/resource.events.js +17 -0
  354. package/src/resource/resource.events.js.map +1 -0
  355. package/src/resource/resource.instance.d.ts +35 -0
  356. package/src/resource/resource.instance.js +163 -0
  357. package/src/resource/resource.instance.js.map +1 -0
  358. package/src/resource/resource.registry.d.ts +106 -12
  359. package/src/resource/resource.registry.js +449 -13
  360. package/src/resource/resource.registry.js.map +1 -1
  361. package/src/resource/resource.types.d.ts +35 -0
  362. package/src/resource/resource.types.js +11 -0
  363. package/src/resource/resource.types.js.map +1 -0
  364. package/src/resource/resource.utils.d.ts +30 -0
  365. package/src/resource/resource.utils.js +151 -0
  366. package/src/resource/resource.utils.js.map +1 -0
  367. package/src/scope/flows/http.request.flow.d.ts +48 -330
  368. package/src/scope/flows/http.request.flow.js +306 -78
  369. package/src/scope/flows/http.request.flow.js.map +1 -1
  370. package/src/scope/scope.instance.d.ts +12 -0
  371. package/src/scope/scope.instance.js +145 -15
  372. package/src/scope/scope.instance.js.map +1 -1
  373. package/src/tool/flows/call-tool.flow.d.ts +64 -1110
  374. package/src/tool/flows/call-tool.flow.js +303 -15
  375. package/src/tool/flows/call-tool.flow.js.map +1 -1
  376. package/src/tool/flows/tools-list.flow.d.ts +32 -473
  377. package/src/tool/flows/tools-list.flow.js +111 -10
  378. package/src/tool/flows/tools-list.flow.js.map +1 -1
  379. package/src/tool/tool.events.d.ts +8 -1
  380. package/src/tool/tool.events.js.map +1 -1
  381. package/src/tool/tool.instance.d.ts +3 -1
  382. package/src/tool/tool.instance.js +17 -3
  383. package/src/tool/tool.instance.js.map +1 -1
  384. package/src/tool/tool.registry.d.ts +7 -1
  385. package/src/tool/tool.registry.js +26 -10
  386. package/src/tool/tool.registry.js.map +1 -1
  387. package/src/tool/tool.types.d.ts +4 -4
  388. package/src/tool/tool.types.js.map +1 -1
  389. package/src/tool/tool.utils.d.ts +3 -12
  390. package/src/tool/tool.utils.js +39 -193
  391. package/src/tool/tool.utils.js.map +1 -1
  392. package/src/tool/ui/index.d.ts +22 -0
  393. package/src/tool/ui/index.js +63 -0
  394. package/src/tool/ui/index.js.map +1 -0
  395. package/src/tool/ui/platform-adapters.d.ts +10 -0
  396. package/src/tool/ui/platform-adapters.js +18 -0
  397. package/src/tool/ui/platform-adapters.js.map +1 -0
  398. package/src/tool/ui/template-helpers.d.ts +46 -0
  399. package/src/tool/ui/template-helpers.js +112 -0
  400. package/src/tool/ui/template-helpers.js.map +1 -0
  401. package/src/tool/ui/ui-resource-template.d.ts +34 -0
  402. package/src/tool/ui/ui-resource-template.js +64 -0
  403. package/src/tool/ui/ui-resource-template.js.map +1 -0
  404. package/src/tool/ui/ui-resource.handler.d.ts +74 -0
  405. package/src/tool/ui/ui-resource.handler.js +129 -0
  406. package/src/tool/ui/ui-resource.handler.js.map +1 -0
  407. package/src/transport/adapters/transport.local.adapter.d.ts +2 -2
  408. package/src/transport/adapters/transport.local.adapter.js +28 -7
  409. package/src/transport/adapters/transport.local.adapter.js.map +1 -1
  410. package/src/transport/adapters/transport.sse.adapter.d.ts +2 -2
  411. package/src/transport/adapters/transport.sse.adapter.js +4 -3
  412. package/src/transport/adapters/transport.sse.adapter.js.map +1 -1
  413. package/src/transport/adapters/transport.streamable-http.adapter.d.ts +10 -3
  414. package/src/transport/adapters/transport.streamable-http.adapter.js +54 -8
  415. package/src/transport/adapters/transport.streamable-http.adapter.js.map +1 -1
  416. package/src/transport/flows/handle.sse.flow.d.ts +29 -63
  417. package/src/transport/flows/handle.sse.flow.js +78 -10
  418. package/src/transport/flows/handle.sse.flow.js.map +1 -1
  419. package/src/transport/flows/handle.stateless-http.flow.d.ts +29 -0
  420. package/src/transport/flows/handle.stateless-http.flow.js +102 -0
  421. package/src/transport/flows/handle.stateless-http.flow.js.map +1 -0
  422. package/src/transport/flows/handle.streamable-http.flow.d.ts +32 -64
  423. package/src/transport/flows/handle.streamable-http.flow.js +158 -26
  424. package/src/transport/flows/handle.streamable-http.flow.js.map +1 -1
  425. package/src/transport/legacy/legacy.sse.tranporter.d.ts +9 -0
  426. package/src/transport/legacy/legacy.sse.tranporter.js +17 -2
  427. package/src/transport/legacy/legacy.sse.tranporter.js.map +1 -1
  428. package/src/transport/mcp-handlers/call-tool-request.handler.js +27 -1
  429. package/src/transport/mcp-handlers/call-tool-request.handler.js.map +1 -1
  430. package/src/transport/mcp-handlers/complete-request.handler.d.ts +69 -0
  431. package/src/transport/mcp-handlers/complete-request.handler.js +11 -0
  432. package/src/transport/mcp-handlers/complete-request.handler.js.map +1 -0
  433. package/src/transport/mcp-handlers/get-prompt-request.handler.d.ts +87 -0
  434. package/src/transport/mcp-handlers/get-prompt-request.handler.js +11 -0
  435. package/src/transport/mcp-handlers/get-prompt-request.handler.js.map +1 -0
  436. package/src/transport/mcp-handlers/index.d.ts +517 -208
  437. package/src/transport/mcp-handlers/index.js +39 -2
  438. package/src/transport/mcp-handlers/index.js.map +1 -1
  439. package/src/transport/mcp-handlers/initialize-request.handler.d.ts +1 -1
  440. package/src/transport/mcp-handlers/initialize-request.handler.js +73 -7
  441. package/src/transport/mcp-handlers/initialize-request.handler.js.map +1 -1
  442. package/src/transport/mcp-handlers/list-prompts-request.handler.d.ts +54 -0
  443. package/src/transport/mcp-handlers/list-prompts-request.handler.js +11 -0
  444. package/src/transport/mcp-handlers/list-prompts-request.handler.js.map +1 -0
  445. package/src/transport/mcp-handlers/list-resource-templates-request.handler.d.ts +51 -0
  446. package/src/transport/mcp-handlers/list-resource-templates-request.handler.js +12 -0
  447. package/src/transport/mcp-handlers/list-resource-templates-request.handler.js.map +1 -0
  448. package/src/transport/mcp-handlers/list-resources-request.handler.d.ts +51 -0
  449. package/src/transport/mcp-handlers/list-resources-request.handler.js +12 -0
  450. package/src/transport/mcp-handlers/list-resources-request.handler.js.map +1 -0
  451. package/src/transport/mcp-handlers/list-tools-request.handler.d.ts +19 -146
  452. package/src/transport/mcp-handlers/logging-set-level-request.handler.d.ts +46 -0
  453. package/src/transport/mcp-handlers/logging-set-level-request.handler.js +34 -0
  454. package/src/transport/mcp-handlers/logging-set-level-request.handler.js.map +1 -0
  455. package/src/transport/mcp-handlers/mcp-handlers.types.d.ts +3 -7
  456. package/src/transport/mcp-handlers/mcp-handlers.types.js.map +1 -1
  457. package/src/transport/mcp-handlers/read-resource-request.handler.d.ts +46 -0
  458. package/src/transport/mcp-handlers/read-resource-request.handler.js +12 -0
  459. package/src/transport/mcp-handlers/read-resource-request.handler.js.map +1 -0
  460. package/src/transport/mcp-handlers/roots-list-changed-notification.handler.d.ts +11 -0
  461. package/src/transport/mcp-handlers/roots-list-changed-notification.handler.js +26 -0
  462. package/src/transport/mcp-handlers/roots-list-changed-notification.handler.js.map +1 -0
  463. package/src/transport/mcp-handlers/subscribe-request.handler.d.ts +37 -0
  464. package/src/transport/mcp-handlers/subscribe-request.handler.js +34 -0
  465. package/src/transport/mcp-handlers/subscribe-request.handler.js.map +1 -0
  466. package/src/transport/mcp-handlers/unsubscribe-request.handler.d.ts +37 -0
  467. package/src/transport/mcp-handlers/unsubscribe-request.handler.js +34 -0
  468. package/src/transport/mcp-handlers/unsubscribe-request.handler.js.map +1 -0
  469. package/src/transport/transport.local.js +7 -2
  470. package/src/transport/transport.local.js.map +1 -1
  471. package/src/transport/transport.registry.d.ts +30 -0
  472. package/src/transport/transport.registry.js +84 -1
  473. package/src/transport/transport.registry.js.map +1 -1
  474. package/src/transport/transport.types.d.ts +3 -3
  475. package/src/transport/transport.types.js.map +1 -1
  476. package/src/utils/content.utils.d.ts +48 -0
  477. package/src/utils/content.utils.js +194 -0
  478. package/src/utils/content.utils.js.map +1 -0
  479. package/src/utils/index.d.ts +8 -0
  480. package/src/utils/index.js +55 -0
  481. package/src/utils/index.js.map +1 -0
  482. package/src/utils/lineage.utils.d.ts +40 -0
  483. package/src/utils/lineage.utils.js +82 -0
  484. package/src/utils/lineage.utils.js.map +1 -0
  485. package/src/utils/naming.utils.d.ts +46 -0
  486. package/src/utils/naming.utils.js +136 -0
  487. package/src/utils/naming.utils.js.map +1 -0
  488. package/src/utils/types.utils.d.ts +2 -2
  489. package/src/utils/types.utils.js.map +1 -1
  490. package/src/utils/uri-template.utils.d.ts +57 -0
  491. package/src/utils/uri-template.utils.js +113 -0
  492. package/src/utils/uri-template.utils.js.map +1 -0
  493. package/src/utils/uri-validation.utils.d.ts +40 -0
  494. package/src/utils/uri-validation.utils.js +76 -0
  495. package/src/utils/uri-validation.utils.js.map +1 -0
  496. package/src/__test-utils__/fixtures/hook.fixtures.d.ts +0 -46
  497. package/src/__test-utils__/fixtures/hook.fixtures.js +0 -114
  498. package/src/__test-utils__/fixtures/hook.fixtures.js.map +0 -1
  499. package/src/__test-utils__/fixtures/index.d.ts +0 -7
  500. package/src/__test-utils__/fixtures/index.js +0 -11
  501. package/src/__test-utils__/fixtures/index.js.map +0 -1
  502. package/src/__test-utils__/fixtures/plugin.fixtures.d.ts +0 -46
  503. package/src/__test-utils__/fixtures/plugin.fixtures.js +0 -127
  504. package/src/__test-utils__/fixtures/plugin.fixtures.js.map +0 -1
  505. package/src/__test-utils__/fixtures/provider.fixtures.d.ts +0 -69
  506. package/src/__test-utils__/fixtures/provider.fixtures.js +0 -131
  507. package/src/__test-utils__/fixtures/provider.fixtures.js.map +0 -1
  508. package/src/__test-utils__/fixtures/scope.fixtures.d.ts +0 -14
  509. package/src/__test-utils__/fixtures/scope.fixtures.js +0 -59
  510. package/src/__test-utils__/fixtures/scope.fixtures.js.map +0 -1
  511. package/src/__test-utils__/fixtures/tool.fixtures.d.ts +0 -36
  512. package/src/__test-utils__/fixtures/tool.fixtures.js +0 -91
  513. package/src/__test-utils__/fixtures/tool.fixtures.js.map +0 -1
  514. package/src/__test-utils__/helpers/assertion.helpers.d.ts +0 -45
  515. package/src/__test-utils__/helpers/assertion.helpers.js +0 -153
  516. package/src/__test-utils__/helpers/assertion.helpers.js.map +0 -1
  517. package/src/__test-utils__/helpers/async.helpers.d.ts +0 -48
  518. package/src/__test-utils__/helpers/async.helpers.js +0 -112
  519. package/src/__test-utils__/helpers/async.helpers.js.map +0 -1
  520. package/src/__test-utils__/helpers/index.d.ts +0 -6
  521. package/src/__test-utils__/helpers/index.js +0 -10
  522. package/src/__test-utils__/helpers/index.js.map +0 -1
  523. package/src/__test-utils__/helpers/setup.helpers.d.ts +0 -54
  524. package/src/__test-utils__/helpers/setup.helpers.js +0 -106
  525. package/src/__test-utils__/helpers/setup.helpers.js.map +0 -1
  526. package/src/__test-utils__/index.d.ts +0 -9
  527. package/src/__test-utils__/index.js +0 -14
  528. package/src/__test-utils__/index.js.map +0 -1
  529. package/src/__test-utils__/mocks/flow-instance.mock.d.ts +0 -50
  530. package/src/__test-utils__/mocks/flow-instance.mock.js +0 -72
  531. package/src/__test-utils__/mocks/flow-instance.mock.js.map +0 -1
  532. package/src/__test-utils__/mocks/hook-registry.mock.d.ts +0 -25
  533. package/src/__test-utils__/mocks/hook-registry.mock.js +0 -65
  534. package/src/__test-utils__/mocks/hook-registry.mock.js.map +0 -1
  535. package/src/__test-utils__/mocks/index.d.ts +0 -8
  536. package/src/__test-utils__/mocks/index.js +0 -12
  537. package/src/__test-utils__/mocks/index.js.map +0 -1
  538. package/src/__test-utils__/mocks/plugin-registry.mock.d.ts +0 -43
  539. package/src/__test-utils__/mocks/plugin-registry.mock.js +0 -70
  540. package/src/__test-utils__/mocks/plugin-registry.mock.js.map +0 -1
  541. package/src/__test-utils__/mocks/provider-registry.mock.d.ts +0 -39
  542. package/src/__test-utils__/mocks/provider-registry.mock.js +0 -72
  543. package/src/__test-utils__/mocks/provider-registry.mock.js.map +0 -1
  544. package/src/__test-utils__/mocks/tool-registry.mock.d.ts +0 -43
  545. package/src/__test-utils__/mocks/tool-registry.mock.js +0 -79
  546. package/src/__test-utils__/mocks/tool-registry.mock.js.map +0 -1
  547. package/src/auth/path.utils.d.ts +0 -20
  548. package/src/auth/path.utils.js +0 -71
  549. package/src/auth/path.utils.js.map +0 -1
  550. package/src/common/decorators-old/async-with.decorator.d.ts +0 -10
  551. package/src/common/decorators-old/async-with.decorator.js +0 -24
  552. package/src/common/decorators-old/async-with.decorator.js.map +0 -1
  553. package/src/common/decorators-old/auth-hook.decorator.d.ts +0 -14
  554. package/src/common/decorators-old/auth-hook.decorator.js +0 -27
  555. package/src/common/decorators-old/auth-hook.decorator.js.map +0 -1
  556. package/src/common/decorators-old/session-hook.decorator.d.ts +0 -14
  557. package/src/common/decorators-old/session-hook.decorator.js +0 -27
  558. package/src/common/decorators-old/session-hook.decorator.js.map +0 -1
@@ -1,5 +1,27 @@
1
1
  import { z } from 'zod';
2
- import { HttpRequestIntent } from "../../utils";
2
+ /**
3
+ * Transport protocol types (excludes non-transport intents like 'delete-session')
4
+ */
5
+ export type TransportProtocolType = 'legacy-sse' | 'sse' | 'streamable-http' | 'stateful-http' | 'stateless-http';
6
+ /**
7
+ * Known AI platform types that can be detected from client info.
8
+ * Used for platform-specific rendering and behavior customization.
9
+ */
10
+ export type AIPlatformType = 'openai' | 'claude' | 'gemini' | 'cursor' | 'continue' | 'cody' | 'generic-mcp' | 'ext-apps' | 'unknown';
11
+ /**
12
+ * Zod schema for AIPlatformType validation
13
+ */
14
+ export declare const aiPlatformTypeSchema: z.ZodEnum<{
15
+ unknown: "unknown";
16
+ continue: "continue";
17
+ openai: "openai";
18
+ claude: "claude";
19
+ gemini: "gemini";
20
+ cursor: "cursor";
21
+ cody: "cody";
22
+ "generic-mcp": "generic-mcp";
23
+ "ext-apps": "ext-apps";
24
+ }>;
3
25
  /**
4
26
  * Decoded JWT payload (if any) or empty object
5
27
  */
@@ -22,242 +44,125 @@ export declare const userClaimSchema: z.ZodObject<{
22
44
  sub: z.ZodString;
23
45
  exp: z.ZodOptional<z.ZodNumber>;
24
46
  iat: z.ZodOptional<z.ZodNumber>;
25
- aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
47
+ aud: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
26
48
  email: z.ZodOptional<z.ZodString>;
27
49
  username: z.ZodOptional<z.ZodString>;
28
50
  preferred_username: z.ZodOptional<z.ZodString>;
29
51
  name: z.ZodOptional<z.ZodString>;
30
52
  picture: z.ZodOptional<z.ZodString>;
31
- }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
32
- iss: z.ZodString;
33
- sid: z.ZodOptional<z.ZodString>;
34
- sub: z.ZodString;
35
- exp: z.ZodOptional<z.ZodNumber>;
36
- iat: z.ZodOptional<z.ZodNumber>;
37
- aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
38
- email: z.ZodOptional<z.ZodString>;
39
- username: z.ZodOptional<z.ZodString>;
40
- preferred_username: z.ZodOptional<z.ZodString>;
41
- name: z.ZodOptional<z.ZodString>;
42
- picture: z.ZodOptional<z.ZodString>;
43
- }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
44
- iss: z.ZodString;
45
- sid: z.ZodOptional<z.ZodString>;
46
- sub: z.ZodString;
47
- exp: z.ZodOptional<z.ZodNumber>;
48
- iat: z.ZodOptional<z.ZodNumber>;
49
- aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
50
- email: z.ZodOptional<z.ZodString>;
51
- username: z.ZodOptional<z.ZodString>;
52
- preferred_username: z.ZodOptional<z.ZodString>;
53
- name: z.ZodOptional<z.ZodString>;
54
- picture: z.ZodOptional<z.ZodString>;
55
- }, z.ZodTypeAny, "passthrough">>;
53
+ }, z.core.$loose>;
56
54
  export type SessionIdPayload = {
57
55
  nodeId: string;
58
56
  authSig: string;
59
57
  uuid: string;
60
58
  iat: number;
61
- protocol: HttpRequestIntent;
59
+ protocol?: TransportProtocolType;
60
+ isPublic?: boolean;
61
+ platformType?: AIPlatformType;
62
62
  };
63
63
  export declare const sessionIdPayloadSchema: z.ZodObject<{
64
64
  nodeId: z.ZodString;
65
65
  authSig: z.ZodString;
66
66
  uuid: z.ZodString;
67
67
  iat: z.ZodNumber;
68
- protocol: z.ZodEnum<["legacy-sse", "sse", "streamable-http", "stateful-http", "stateless-http"]>;
69
- }, "strip", z.ZodTypeAny, {
70
- uuid: string;
71
- nodeId: string;
72
- authSig: string;
73
- iat: number;
74
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
75
- }, {
76
- uuid: string;
77
- nodeId: string;
78
- authSig: string;
79
- iat: number;
80
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
81
- }>;
68
+ protocol: z.ZodOptional<z.ZodEnum<{
69
+ "legacy-sse": "legacy-sse";
70
+ sse: "sse";
71
+ "streamable-http": "streamable-http";
72
+ "stateful-http": "stateful-http";
73
+ "stateless-http": "stateless-http";
74
+ }>>;
75
+ isPublic: z.ZodOptional<z.ZodBoolean>;
76
+ platformType: z.ZodOptional<z.ZodEnum<{
77
+ unknown: "unknown";
78
+ continue: "continue";
79
+ openai: "openai";
80
+ claude: "claude";
81
+ gemini: "gemini";
82
+ cursor: "cursor";
83
+ cody: "cody";
84
+ "generic-mcp": "generic-mcp";
85
+ "ext-apps": "ext-apps";
86
+ }>>;
87
+ }, z.core.$strip>;
82
88
  export interface Authorization {
83
89
  token: string;
84
90
  user: UserClaim;
85
91
  session?: {
86
92
  id: string;
87
- payload: SessionIdPayload;
93
+ /** Payload may be undefined when session validation failed but ID is passed for transport lookup */
94
+ payload?: SessionIdPayload;
88
95
  };
89
96
  }
90
97
  export declare const sessionIdSchema: z.ZodObject<{
91
98
  id: z.ZodString;
92
- payload: z.ZodObject<{
99
+ payload: z.ZodOptional<z.ZodObject<{
93
100
  nodeId: z.ZodString;
94
101
  authSig: z.ZodString;
95
102
  uuid: z.ZodString;
96
103
  iat: z.ZodNumber;
97
- protocol: z.ZodEnum<["legacy-sse", "sse", "streamable-http", "stateful-http", "stateless-http"]>;
98
- }, "strip", z.ZodTypeAny, {
99
- uuid: string;
100
- nodeId: string;
101
- authSig: string;
102
- iat: number;
103
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
104
- }, {
105
- uuid: string;
106
- nodeId: string;
107
- authSig: string;
108
- iat: number;
109
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
110
- }>;
111
- }, "strip", z.ZodTypeAny, {
112
- id: string;
113
- payload: {
114
- uuid: string;
115
- nodeId: string;
116
- authSig: string;
117
- iat: number;
118
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
119
- };
120
- }, {
121
- id: string;
122
- payload: {
123
- uuid: string;
124
- nodeId: string;
125
- authSig: string;
126
- iat: number;
127
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
128
- };
129
- }>;
104
+ protocol: z.ZodOptional<z.ZodEnum<{
105
+ "legacy-sse": "legacy-sse";
106
+ sse: "sse";
107
+ "streamable-http": "streamable-http";
108
+ "stateful-http": "stateful-http";
109
+ "stateless-http": "stateless-http";
110
+ }>>;
111
+ isPublic: z.ZodOptional<z.ZodBoolean>;
112
+ platformType: z.ZodOptional<z.ZodEnum<{
113
+ unknown: "unknown";
114
+ continue: "continue";
115
+ openai: "openai";
116
+ claude: "claude";
117
+ gemini: "gemini";
118
+ cursor: "cursor";
119
+ cody: "cody";
120
+ "generic-mcp": "generic-mcp";
121
+ "ext-apps": "ext-apps";
122
+ }>>;
123
+ }, z.core.$strip>>;
124
+ }, z.core.$strip>;
130
125
  export declare const authorizationSchema: z.ZodObject<{
131
126
  token: z.ZodString;
132
127
  session: z.ZodOptional<z.ZodObject<{
133
128
  id: z.ZodString;
134
- payload: z.ZodObject<{
129
+ payload: z.ZodOptional<z.ZodObject<{
135
130
  nodeId: z.ZodString;
136
131
  authSig: z.ZodString;
137
132
  uuid: z.ZodString;
138
133
  iat: z.ZodNumber;
139
- protocol: z.ZodEnum<["legacy-sse", "sse", "streamable-http", "stateful-http", "stateless-http"]>;
140
- }, "strip", z.ZodTypeAny, {
141
- uuid: string;
142
- nodeId: string;
143
- authSig: string;
144
- iat: number;
145
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
146
- }, {
147
- uuid: string;
148
- nodeId: string;
149
- authSig: string;
150
- iat: number;
151
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
152
- }>;
153
- }, "strip", z.ZodTypeAny, {
154
- id: string;
155
- payload: {
156
- uuid: string;
157
- nodeId: string;
158
- authSig: string;
159
- iat: number;
160
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
161
- };
162
- }, {
163
- id: string;
164
- payload: {
165
- uuid: string;
166
- nodeId: string;
167
- authSig: string;
168
- iat: number;
169
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
170
- };
171
- }>>;
134
+ protocol: z.ZodOptional<z.ZodEnum<{
135
+ "legacy-sse": "legacy-sse";
136
+ sse: "sse";
137
+ "streamable-http": "streamable-http";
138
+ "stateful-http": "stateful-http";
139
+ "stateless-http": "stateless-http";
140
+ }>>;
141
+ isPublic: z.ZodOptional<z.ZodBoolean>;
142
+ platformType: z.ZodOptional<z.ZodEnum<{
143
+ unknown: "unknown";
144
+ continue: "continue";
145
+ openai: "openai";
146
+ claude: "claude";
147
+ gemini: "gemini";
148
+ cursor: "cursor";
149
+ cody: "cody";
150
+ "generic-mcp": "generic-mcp";
151
+ "ext-apps": "ext-apps";
152
+ }>>;
153
+ }, z.core.$strip>>;
154
+ }, z.core.$strip>>;
172
155
  user: z.ZodObject<{
173
156
  iss: z.ZodString;
174
157
  sid: z.ZodOptional<z.ZodString>;
175
158
  sub: z.ZodString;
176
159
  exp: z.ZodOptional<z.ZodNumber>;
177
160
  iat: z.ZodOptional<z.ZodNumber>;
178
- aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
179
- email: z.ZodOptional<z.ZodString>;
180
- username: z.ZodOptional<z.ZodString>;
181
- preferred_username: z.ZodOptional<z.ZodString>;
182
- name: z.ZodOptional<z.ZodString>;
183
- picture: z.ZodOptional<z.ZodString>;
184
- }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
185
- iss: z.ZodString;
186
- sid: z.ZodOptional<z.ZodString>;
187
- sub: z.ZodString;
188
- exp: z.ZodOptional<z.ZodNumber>;
189
- iat: z.ZodOptional<z.ZodNumber>;
190
- aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
191
- email: z.ZodOptional<z.ZodString>;
192
- username: z.ZodOptional<z.ZodString>;
193
- preferred_username: z.ZodOptional<z.ZodString>;
194
- name: z.ZodOptional<z.ZodString>;
195
- picture: z.ZodOptional<z.ZodString>;
196
- }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
197
- iss: z.ZodString;
198
- sid: z.ZodOptional<z.ZodString>;
199
- sub: z.ZodString;
200
- exp: z.ZodOptional<z.ZodNumber>;
201
- iat: z.ZodOptional<z.ZodNumber>;
202
- aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
161
+ aud: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
203
162
  email: z.ZodOptional<z.ZodString>;
204
163
  username: z.ZodOptional<z.ZodString>;
205
164
  preferred_username: z.ZodOptional<z.ZodString>;
206
165
  name: z.ZodOptional<z.ZodString>;
207
166
  picture: z.ZodOptional<z.ZodString>;
208
- }, z.ZodTypeAny, "passthrough">>;
209
- }, "strip", z.ZodTypeAny, {
210
- token: string;
211
- user: {
212
- sub: string;
213
- iss: string;
214
- name?: string | undefined;
215
- email?: string | undefined;
216
- iat?: number | undefined;
217
- sid?: string | undefined;
218
- exp?: number | undefined;
219
- aud?: string | string[] | undefined;
220
- username?: string | undefined;
221
- preferred_username?: string | undefined;
222
- picture?: string | undefined;
223
- } & {
224
- [k: string]: unknown;
225
- };
226
- session?: {
227
- id: string;
228
- payload: {
229
- uuid: string;
230
- nodeId: string;
231
- authSig: string;
232
- iat: number;
233
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
234
- };
235
- } | undefined;
236
- }, {
237
- token: string;
238
- user: {
239
- sub: string;
240
- iss: string;
241
- name?: string | undefined;
242
- email?: string | undefined;
243
- iat?: number | undefined;
244
- sid?: string | undefined;
245
- exp?: number | undefined;
246
- aud?: string | string[] | undefined;
247
- username?: string | undefined;
248
- preferred_username?: string | undefined;
249
- picture?: string | undefined;
250
- } & {
251
- [k: string]: unknown;
252
- };
253
- session?: {
254
- id: string;
255
- payload: {
256
- uuid: string;
257
- nodeId: string;
258
- authSig: string;
259
- iat: number;
260
- protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
261
- };
262
- } | undefined;
263
- }>;
167
+ }, z.core.$loose>;
168
+ }, z.core.$strip>;
@@ -1,8 +1,23 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.authorizationSchema = exports.sessionIdSchema = exports.sessionIdPayloadSchema = exports.userClaimSchema = void 0;
3
+ exports.authorizationSchema = exports.sessionIdSchema = exports.sessionIdPayloadSchema = exports.userClaimSchema = exports.aiPlatformTypeSchema = void 0;
4
4
  const zod_1 = require("zod");
5
- exports.userClaimSchema = zod_1.z.object({
5
+ /**
6
+ * Zod schema for AIPlatformType validation
7
+ */
8
+ exports.aiPlatformTypeSchema = zod_1.z.enum([
9
+ 'openai',
10
+ 'claude',
11
+ 'gemini',
12
+ 'cursor',
13
+ 'continue',
14
+ 'cody',
15
+ 'generic-mcp',
16
+ 'ext-apps',
17
+ 'unknown',
18
+ ]);
19
+ exports.userClaimSchema = zod_1.z
20
+ .object({
6
21
  iss: zod_1.z.string(),
7
22
  sid: zod_1.z.string().optional(),
8
23
  sub: zod_1.z.string(),
@@ -14,23 +29,21 @@ exports.userClaimSchema = zod_1.z.object({
14
29
  preferred_username: zod_1.z.string().optional(),
15
30
  name: zod_1.z.string().optional(),
16
31
  picture: zod_1.z.string().optional(),
17
- }).passthrough();
32
+ })
33
+ .passthrough();
18
34
  exports.sessionIdPayloadSchema = zod_1.z.object({
19
35
  nodeId: zod_1.z.string(),
20
36
  authSig: zod_1.z.string(),
21
37
  uuid: zod_1.z.string().uuid(),
22
38
  iat: zod_1.z.number(),
23
- protocol: zod_1.z.enum([
24
- 'legacy-sse',
25
- 'sse',
26
- 'streamable-http',
27
- 'stateful-http',
28
- 'stateless-http',
29
- ]),
39
+ protocol: zod_1.z.enum(['legacy-sse', 'sse', 'streamable-http', 'stateful-http', 'stateless-http']).optional(),
40
+ isPublic: zod_1.z.boolean().optional(),
41
+ platformType: exports.aiPlatformTypeSchema.optional(),
30
42
  });
31
43
  exports.sessionIdSchema = zod_1.z.object({
32
44
  id: zod_1.z.string(),
33
- payload: exports.sessionIdPayloadSchema,
45
+ /** Payload is optional - may be undefined when session validation failed but ID is passed for transport lookup */
46
+ payload: exports.sessionIdPayloadSchema.optional(),
34
47
  });
35
48
  exports.authorizationSchema = zod_1.z.object({
36
49
  token: zod_1.z.string(),
@@ -1 +1 @@
1
- {"version":3,"file":"session.types.js","sourceRoot":"","sources":["../../../../../src/common/types/auth/session.types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAoBX,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACE,CAAC,CAAC,WAAW,EAAE,CAAC;AAerC,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC;QACf,YAAY;QACZ,KAAK;QACL,iBAAiB;QACjB,eAAe;QACf,gBAAgB;KACjB,CAAC;CACqC,CAAC,CAAC;AAY9B,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,8BAAsB;CACiC,CAAC,CAAC;AAEvD,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,uBAAe,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,uBAAe;CACe,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport {RawZodShape} from \"../common.types\";\nimport {HttpRequestIntent} from \"../../utils\";\n\n/**\n * Decoded JWT payload (if any) or empty object\n */\nexport type UserClaim = {\n iss: string;\n sid?: string;\n sub: string;\n exp?: number;\n iat?: number;\n aud?: string | string[];\n email?: string;\n username?: string;\n preferred_username?: string;\n name?: string;\n picture?: string;\n}\nexport const userClaimSchema = z.object({\n iss: z.string(),\n sid: z.string().optional(),\n sub: z.string(),\n exp: z.number().optional(),\n iat: z.number().optional(),\n aud: z.union([z.string(), z.array(z.string())]).optional(),\n email: z.string().optional(),\n username: z.string().optional(),\n preferred_username: z.string().optional(),\n name: z.string().optional(),\n picture: z.string().optional(),\n} satisfies RawZodShape<UserClaim>).passthrough();\n\n\nexport type SessionIdPayload = {\n /* The actual node id that handle the transport session */\n nodeId: string;\n /* The signature of the token used to create the session */\n authSig: string;\n /* The unique id of the session */\n uuid: string;\n /* The timestamp of the session creation */\n iat: number;\n /* The protocol used in existing transport */\n protocol: HttpRequestIntent;\n}\nexport const sessionIdPayloadSchema = z.object({\n nodeId: z.string(),\n authSig: z.string(),\n uuid: z.string().uuid(),\n iat: z.number(),\n protocol: z.enum([\n 'legacy-sse',\n 'sse',\n 'streamable-http',\n 'stateful-http',\n 'stateless-http',\n ]),\n} satisfies RawZodShape<SessionIdPayload>);\n\n\nexport interface Authorization {\n token: string;\n user: UserClaim;\n session?: {\n id: string;\n payload: SessionIdPayload;\n };\n}\n\nexport const sessionIdSchema = z.object({\n id: z.string(),\n payload: sessionIdPayloadSchema,\n} satisfies RawZodShape<{ id: string, payload: SessionIdPayload }>);\n\nexport const authorizationSchema = z.object({\n token: z.string(),\n session: sessionIdSchema.optional(),\n user: userClaimSchema,\n} satisfies RawZodShape<Authorization>);\n"]}
1
+ {"version":3,"file":"session.types.js","sourceRoot":"","sources":["../../../../../src/common/types/auth/session.types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAuBxB;;GAEG;AACU,QAAA,oBAAoB,GAAG,OAAC,CAAC,IAAI,CAAC;IACzC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,MAAM;IACN,aAAa;IACb,UAAU;IACV,SAAS;CACV,CAAC,CAAC;AAkBU,QAAA,eAAe,GAAG,OAAC;KAC7B,MAAM,CAAC;IACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACE,CAAC;KAClC,WAAW,EAAE,CAAC;AAkBJ,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxG,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,4BAAoB,CAAC,QAAQ,EAAE;CACN,CAAC,CAAC;AAY9B,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,kHAAkH;IAClH,OAAO,EAAE,8BAAsB,CAAC,QAAQ,EAAE;CACuB,CAAC,CAAC;AAExD,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,uBAAe,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,uBAAe;CACe,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../common.types';\n\n/**\n * Transport protocol types (excludes non-transport intents like 'delete-session')\n */\nexport type TransportProtocolType = 'legacy-sse' | 'sse' | 'streamable-http' | 'stateful-http' | 'stateless-http';\n\n/**\n * Known AI platform types that can be detected from client info.\n * Used for platform-specific rendering and behavior customization.\n */\nexport type AIPlatformType =\n | 'openai' // ChatGPT, OpenAI API clients\n | 'claude' // Claude Desktop, Claude API clients\n | 'gemini' // Google Gemini clients\n | 'cursor' // Cursor IDE\n | 'continue' // Continue.dev\n | 'cody' // Sourcegraph Cody\n | 'generic-mcp' // Generic MCP client\n | 'ext-apps' // MCP Apps spec compliant clients (io.modelcontextprotocol/ui extension)\n | 'unknown'; // Unknown client\n\n/**\n * Zod schema for AIPlatformType validation\n */\nexport const aiPlatformTypeSchema = z.enum([\n 'openai',\n 'claude',\n 'gemini',\n 'cursor',\n 'continue',\n 'cody',\n 'generic-mcp',\n 'ext-apps',\n 'unknown',\n]);\n\n/**\n * Decoded JWT payload (if any) or empty object\n */\nexport type UserClaim = {\n iss: string;\n sid?: string;\n sub: string;\n exp?: number;\n iat?: number;\n aud?: string | string[];\n email?: string;\n username?: string;\n preferred_username?: string;\n name?: string;\n picture?: string;\n};\nexport const userClaimSchema = z\n .object({\n iss: z.string(),\n sid: z.string().optional(),\n sub: z.string(),\n exp: z.number().optional(),\n iat: z.number().optional(),\n aud: z.union([z.string(), z.array(z.string())]).optional(),\n email: z.string().optional(),\n username: z.string().optional(),\n preferred_username: z.string().optional(),\n name: z.string().optional(),\n picture: z.string().optional(),\n } satisfies RawZodShape<UserClaim>)\n .passthrough();\n\nexport type SessionIdPayload = {\n /* The actual node id that handle the transport session */\n nodeId: string;\n /* The signature of the token used to create the session */\n authSig: string;\n /* The unique id of the session */\n uuid: string;\n /* The timestamp of the session creation */\n iat: number;\n /* The protocol used in existing transport - optional for stateless mode */\n protocol?: TransportProtocolType;\n /* True if session was created in public mode (anonymous access) */\n isPublic?: boolean;\n /* The detected AI platform type from MCP initialize clientInfo */\n platformType?: AIPlatformType;\n};\nexport const sessionIdPayloadSchema = z.object({\n nodeId: z.string(),\n authSig: z.string(),\n uuid: z.string().uuid(),\n iat: z.number(),\n protocol: z.enum(['legacy-sse', 'sse', 'streamable-http', 'stateful-http', 'stateless-http']).optional(),\n isPublic: z.boolean().optional(),\n platformType: aiPlatformTypeSchema.optional(),\n} satisfies RawZodShape<SessionIdPayload>);\n\nexport interface Authorization {\n token: string;\n user: UserClaim;\n session?: {\n id: string;\n /** Payload may be undefined when session validation failed but ID is passed for transport lookup */\n payload?: SessionIdPayload;\n };\n}\n\nexport const sessionIdSchema = z.object({\n id: z.string(),\n /** Payload is optional - may be undefined when session validation failed but ID is passed for transport lookup */\n payload: sessionIdPayloadSchema.optional(),\n} satisfies RawZodShape<{ id: string; payload?: SessionIdPayload }>);\n\nexport const authorizationSchema = z.object({\n token: z.string(),\n session: sessionIdSchema.optional(),\n user: userClaimSchema,\n} satisfies RawZodShape<Authorization>);\n"]}