@frontmcp/sdk 0.7.2 → 0.8.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 (630) hide show
  1. package/agent/adapters/adapter.factory.d.ts +27 -18
  2. package/agent/adapters/adapter.factory.d.ts.map +1 -1
  3. package/agent/agent.instance.d.ts +5 -0
  4. package/agent/agent.instance.d.ts.map +1 -1
  5. package/agent/agent.scope.d.ts +54 -72
  6. package/agent/agent.scope.d.ts.map +1 -1
  7. package/agent/flows/call-agent.flow.d.ts +1 -0
  8. package/agent/flows/call-agent.flow.d.ts.map +1 -1
  9. package/app/instances/app.local.instance.d.ts +3 -0
  10. package/app/instances/app.local.instance.d.ts.map +1 -1
  11. package/app/instances/app.remote.instance.d.ts +3 -0
  12. package/app/instances/app.remote.instance.d.ts.map +1 -1
  13. package/auth/auth.registry.d.ts.map +1 -1
  14. package/auth/authorization/authorization.types.d.ts +7 -180
  15. package/auth/authorization/authorization.types.d.ts.map +1 -1
  16. package/auth/authorization/index.d.ts +2 -0
  17. package/auth/authorization/index.d.ts.map +1 -1
  18. package/auth/authorization/orchestrated.accessor.d.ts +161 -0
  19. package/auth/authorization/orchestrated.accessor.d.ts.map +1 -0
  20. package/auth/authorization/orchestrated.authorization.d.ts +19 -4
  21. package/auth/authorization/orchestrated.authorization.d.ts.map +1 -1
  22. package/auth/authorization/orchestrated.context-extension.d.ts +108 -0
  23. package/auth/authorization/orchestrated.context-extension.d.ts.map +1 -0
  24. package/auth/cimd/index.d.ts +14 -0
  25. package/auth/cimd/index.d.ts.map +1 -0
  26. package/auth/flows/auth.verify.flow.d.ts.map +1 -1
  27. package/auth/flows/oauth.authorize.flow.d.ts +30 -3
  28. package/auth/flows/oauth.authorize.flow.d.ts.map +1 -1
  29. package/auth/flows/oauth.callback.flow.d.ts +11 -3
  30. package/auth/flows/oauth.callback.flow.d.ts.map +1 -1
  31. package/auth/flows/oauth.provider-callback.flow.d.ts +118 -0
  32. package/auth/flows/oauth.provider-callback.flow.d.ts.map +1 -0
  33. package/auth/flows/oauth.register.flow.d.ts +1 -1
  34. package/auth/flows/oauth.token.flow.d.ts +1 -1
  35. package/auth/flows/session.verify.flow.d.ts +8 -0
  36. package/auth/flows/session.verify.flow.d.ts.map +1 -1
  37. package/auth/flows/well-known.jwks.flow.d.ts +3 -3
  38. package/auth/flows/well-known.oauth-authorization-server.flow.d.ts +3 -2
  39. package/auth/flows/well-known.oauth-authorization-server.flow.d.ts.map +1 -1
  40. package/auth/flows/well-known.prm.flow.d.ts +1 -1
  41. package/auth/instances/instance.local-primary-auth.d.ts +88 -1
  42. package/auth/instances/instance.local-primary-auth.d.ts.map +1 -1
  43. package/auth/machine-id.d.ts +14 -0
  44. package/auth/machine-id.d.ts.map +1 -1
  45. package/auth/session/encrypted-authorization-vault.d.ts +2 -3
  46. package/auth/session/encrypted-authorization-vault.d.ts.map +1 -1
  47. package/auth/session/federated-auth.session.d.ts +252 -0
  48. package/auth/session/federated-auth.session.d.ts.map +1 -0
  49. package/auth/session/index.d.ts +6 -2
  50. package/auth/session/index.d.ts.map +1 -1
  51. package/auth/session/orchestrated-token.store.d.ts +155 -0
  52. package/auth/session/orchestrated-token.store.d.ts.map +1 -0
  53. package/auth/session/record/session.base.d.ts +7 -7
  54. package/auth/session/record/session.base.d.ts.map +1 -1
  55. package/auth/session/record/session.mcp.d.ts +11 -0
  56. package/auth/session/record/session.mcp.d.ts.map +1 -0
  57. package/auth/session/redis-session.store.d.ts +10 -5
  58. package/auth/session/redis-session.store.d.ts.map +1 -1
  59. package/auth/session/session-crypto.d.ts +6 -9
  60. package/auth/session/session-crypto.d.ts.map +1 -1
  61. package/{store/store.factory.d.ts → auth/session/session-store.factory.d.ts} +10 -36
  62. package/auth/session/session-store.factory.d.ts.map +1 -0
  63. package/auth/session/session.service.d.ts +4 -8
  64. package/auth/session/session.service.d.ts.map +1 -1
  65. package/auth/session/session.transport.d.ts +8 -2
  66. package/auth/session/session.transport.d.ts.map +1 -1
  67. package/auth/session/session.types.d.ts +5 -5
  68. package/auth/session/session.types.d.ts.map +1 -1
  69. package/auth/session/token.refresh.d.ts +1 -2
  70. package/auth/session/token.refresh.d.ts.map +1 -1
  71. package/auth/session/transport-session.manager.d.ts +7 -6
  72. package/auth/session/transport-session.manager.d.ts.map +1 -1
  73. package/auth/session/utils/session-id.utils.d.ts +18 -1
  74. package/auth/session/utils/session-id.utils.d.ts.map +1 -1
  75. package/auth/session/vercel-kv-session.store.d.ts +16 -16
  76. package/auth/session/vercel-kv-session.store.d.ts.map +1 -1
  77. package/auth/utils/authorization-id.utils.d.ts +12 -0
  78. package/auth/utils/authorization-id.utils.d.ts.map +1 -0
  79. package/auth/utils/index.d.ts +1 -2
  80. package/auth/utils/index.d.ts.map +1 -1
  81. package/auth/vault/auth-providers.accessor.d.ts +153 -0
  82. package/auth/vault/auth-providers.accessor.d.ts.map +1 -0
  83. package/auth/vault/auth-providers.accessor.impl.d.ts +52 -0
  84. package/auth/vault/auth-providers.accessor.impl.d.ts.map +1 -0
  85. package/auth/vault/auth-providers.context-extension.d.ts +68 -0
  86. package/auth/vault/auth-providers.context-extension.d.ts.map +1 -0
  87. package/auth/vault/auth-providers.providers.d.ts +40 -0
  88. package/auth/vault/auth-providers.providers.d.ts.map +1 -0
  89. package/auth/vault/auth-providers.registry.d.ts +110 -0
  90. package/auth/vault/auth-providers.registry.d.ts.map +1 -0
  91. package/auth/vault/auth-providers.vault.d.ts +93 -0
  92. package/auth/vault/auth-providers.vault.d.ts.map +1 -0
  93. package/auth/vault/credential-cache.d.ts +13 -0
  94. package/auth/vault/credential-cache.d.ts.map +1 -0
  95. package/auth/vault/credential-loaders/eager-loader.d.ts +46 -0
  96. package/auth/vault/credential-loaders/eager-loader.d.ts.map +1 -0
  97. package/auth/vault/credential-loaders/index.d.ts +7 -0
  98. package/auth/vault/credential-loaders/index.d.ts.map +1 -0
  99. package/auth/vault/credential-loaders/lazy-loader.d.ts +53 -0
  100. package/auth/vault/credential-loaders/lazy-loader.d.ts.map +1 -0
  101. package/auth/vault/index.d.ts +56 -0
  102. package/auth/vault/index.d.ts.map +1 -0
  103. package/builtin/config/config-resolver.d.ts +162 -0
  104. package/builtin/config/config-resolver.d.ts.map +1 -0
  105. package/builtin/config/config.plugin.d.ts +63 -0
  106. package/builtin/config/config.plugin.d.ts.map +1 -0
  107. package/builtin/config/config.symbols.d.ts +7 -0
  108. package/builtin/config/config.symbols.d.ts.map +1 -0
  109. package/builtin/config/config.types.d.ts +71 -0
  110. package/builtin/config/config.types.d.ts.map +1 -0
  111. package/builtin/config/index.d.ts +68 -0
  112. package/builtin/config/index.d.ts.map +1 -0
  113. package/builtin/config/providers/config-loader.d.ts +36 -0
  114. package/builtin/config/providers/config-loader.d.ts.map +1 -0
  115. package/builtin/config/providers/config.service.d.ts +108 -0
  116. package/builtin/config/providers/config.service.d.ts.map +1 -0
  117. package/builtin/config/providers/env-loader.d.ts +76 -0
  118. package/builtin/config/providers/env-loader.d.ts.map +1 -0
  119. package/builtin/index.d.ts +7 -0
  120. package/builtin/index.d.ts.map +1 -0
  121. package/common/decorators/front-mcp.decorator.d.ts.map +1 -1
  122. package/common/decorators/hook.decorator.d.ts +0 -10
  123. package/common/decorators/hook.decorator.d.ts.map +1 -1
  124. package/common/decorators/index.d.ts +1 -0
  125. package/common/decorators/index.d.ts.map +1 -1
  126. package/common/decorators/skill.decorator.d.ts +105 -0
  127. package/common/decorators/skill.decorator.d.ts.map +1 -0
  128. package/common/dynamic/dynamic.adapter.d.ts +14 -4
  129. package/common/dynamic/dynamic.adapter.d.ts.map +1 -1
  130. package/common/entries/app.entry.d.ts +2 -0
  131. package/common/entries/app.entry.d.ts.map +1 -1
  132. package/common/entries/index.d.ts +1 -0
  133. package/common/entries/index.d.ts.map +1 -1
  134. package/common/entries/prompt.entry.d.ts +0 -6
  135. package/common/entries/prompt.entry.d.ts.map +1 -1
  136. package/common/entries/resource.entry.d.ts +0 -6
  137. package/common/entries/resource.entry.d.ts.map +1 -1
  138. package/common/entries/scope.entry.d.ts +2 -0
  139. package/common/entries/scope.entry.d.ts.map +1 -1
  140. package/common/entries/skill.entry.d.ts +95 -0
  141. package/common/entries/skill.entry.d.ts.map +1 -0
  142. package/common/entries/tool.entry.d.ts +17 -9
  143. package/common/entries/tool.entry.d.ts.map +1 -1
  144. package/common/interfaces/agent.interface.d.ts +35 -6
  145. package/common/interfaces/agent.interface.d.ts.map +1 -1
  146. package/common/interfaces/execution-context.interface.d.ts +14 -0
  147. package/common/interfaces/execution-context.interface.d.ts.map +1 -1
  148. package/common/interfaces/index.d.ts +1 -0
  149. package/common/interfaces/index.d.ts.map +1 -1
  150. package/common/interfaces/internal/primary-auth-provider.interface.d.ts +1 -7
  151. package/common/interfaces/internal/primary-auth-provider.interface.d.ts.map +1 -1
  152. package/common/interfaces/internal/registry.interface.d.ts +4 -1
  153. package/common/interfaces/internal/registry.interface.d.ts.map +1 -1
  154. package/common/interfaces/skill.interface.d.ts +91 -0
  155. package/common/interfaces/skill.interface.d.ts.map +1 -0
  156. package/common/interfaces/tool.interface.d.ts +39 -0
  157. package/common/interfaces/tool.interface.d.ts.map +1 -1
  158. package/common/metadata/agent.metadata.d.ts +62 -2
  159. package/common/metadata/agent.metadata.d.ts.map +1 -1
  160. package/common/metadata/app.metadata.d.ts +168 -169
  161. package/common/metadata/app.metadata.d.ts.map +1 -1
  162. package/common/metadata/front-mcp.metadata.d.ts +2182 -721
  163. package/common/metadata/front-mcp.metadata.d.ts.map +1 -1
  164. package/common/metadata/index.d.ts +1 -0
  165. package/common/metadata/index.d.ts.map +1 -1
  166. package/common/metadata/plugin.metadata.d.ts +8 -1
  167. package/common/metadata/plugin.metadata.d.ts.map +1 -1
  168. package/common/metadata/skill.metadata.d.ts +366 -0
  169. package/common/metadata/skill.metadata.d.ts.map +1 -0
  170. package/common/metadata/tool.metadata.d.ts +71 -0
  171. package/common/metadata/tool.metadata.d.ts.map +1 -1
  172. package/common/records/index.d.ts +1 -0
  173. package/common/records/index.d.ts.map +1 -1
  174. package/common/records/skill.record.d.ts +55 -0
  175. package/common/records/skill.record.d.ts.map +1 -0
  176. package/common/schemas/annotated-class.schema.d.ts +1 -0
  177. package/common/schemas/annotated-class.schema.d.ts.map +1 -1
  178. package/common/schemas/http-output.schema.d.ts +24 -24
  179. package/common/tokens/app.tokens.d.ts.map +1 -1
  180. package/common/tokens/front-mcp.tokens.d.ts.map +1 -1
  181. package/common/tokens/index.d.ts +1 -0
  182. package/common/tokens/index.d.ts.map +1 -1
  183. package/common/tokens/plugin.tokens.d.ts +1 -0
  184. package/common/tokens/plugin.tokens.d.ts.map +1 -1
  185. package/common/tokens/skill.tokens.d.ts +18 -0
  186. package/common/tokens/skill.tokens.d.ts.map +1 -0
  187. package/common/tokens/tool.tokens.d.ts +2 -0
  188. package/common/tokens/tool.tokens.d.ts.map +1 -1
  189. package/common/types/auth/session.types.d.ts +21 -0
  190. package/common/types/auth/session.types.d.ts.map +1 -1
  191. package/common/types/options/auth/app-auth.schema.d.ts +80 -84
  192. package/common/types/options/auth/app-auth.schema.d.ts.map +1 -1
  193. package/common/types/options/auth/index.d.ts +6 -8
  194. package/common/types/options/auth/index.d.ts.map +1 -1
  195. package/common/types/options/auth/{auth.interfaces.d.ts → interfaces.d.ts} +17 -48
  196. package/common/types/options/auth/interfaces.d.ts.map +1 -0
  197. package/common/types/options/auth/orchestrated.schema.d.ts +160 -84
  198. package/common/types/options/auth/orchestrated.schema.d.ts.map +1 -1
  199. package/common/types/options/auth/public.schema.d.ts +0 -21
  200. package/common/types/options/auth/public.schema.d.ts.map +1 -1
  201. package/common/types/options/auth/{auth.schema.d.ts → schema.d.ts} +81 -85
  202. package/common/types/options/auth/schema.d.ts.map +1 -0
  203. package/common/types/options/auth/shared.schemas.d.ts +12 -0
  204. package/common/types/options/auth/shared.schemas.d.ts.map +1 -1
  205. package/common/types/options/auth/transparent.schema.d.ts +0 -21
  206. package/common/types/options/auth/transparent.schema.d.ts.map +1 -1
  207. package/common/types/options/auth/typecheck.d.ts +2 -0
  208. package/common/types/options/auth/typecheck.d.ts.map +1 -0
  209. package/common/types/options/auth/{auth.utils.d.ts → utils.d.ts} +2 -2
  210. package/common/types/options/auth/utils.d.ts.map +1 -0
  211. package/common/types/options/elicitation/index.d.ts +4 -0
  212. package/common/types/options/elicitation/index.d.ts.map +1 -0
  213. package/common/types/options/elicitation/interfaces.d.ts +80 -0
  214. package/common/types/options/elicitation/interfaces.d.ts.map +1 -0
  215. package/common/types/options/elicitation/schema.d.ts +75 -0
  216. package/common/types/options/elicitation/schema.d.ts.map +1 -0
  217. package/common/types/options/ext-apps/index.d.ts +3 -0
  218. package/common/types/options/ext-apps/index.d.ts.map +1 -0
  219. package/common/types/options/ext-apps/interfaces.d.ts +2 -0
  220. package/common/types/options/ext-apps/interfaces.d.ts.map +1 -0
  221. package/common/types/options/ext-apps/schema.d.ts +80 -0
  222. package/common/types/options/ext-apps/schema.d.ts.map +1 -0
  223. package/common/types/options/http/index.d.ts +4 -0
  224. package/common/types/options/http/index.d.ts.map +1 -0
  225. package/common/types/options/http/interfaces.d.ts +23 -0
  226. package/common/types/options/http/interfaces.d.ts.map +1 -0
  227. package/common/types/options/http/schema.d.ts +18 -0
  228. package/common/types/options/http/schema.d.ts.map +1 -0
  229. package/common/types/options/index.d.ts +10 -6
  230. package/common/types/options/index.d.ts.map +1 -1
  231. package/common/types/options/logging/index.d.ts +5 -0
  232. package/common/types/options/logging/index.d.ts.map +1 -0
  233. package/common/types/options/logging/interfaces.d.ts +41 -0
  234. package/common/types/options/logging/interfaces.d.ts.map +1 -0
  235. package/common/types/options/logging/schema.d.ts +24 -0
  236. package/common/types/options/logging/schema.d.ts.map +1 -0
  237. package/common/types/options/pagination/index.d.ts +4 -0
  238. package/common/types/options/pagination/index.d.ts.map +1 -0
  239. package/common/types/options/pagination/interfaces.d.ts +43 -0
  240. package/common/types/options/pagination/interfaces.d.ts.map +1 -0
  241. package/common/types/options/pagination/schema.d.ts +41 -0
  242. package/common/types/options/pagination/schema.d.ts.map +1 -0
  243. package/common/types/options/redis/index.d.ts +4 -0
  244. package/common/types/options/redis/index.d.ts.map +1 -0
  245. package/common/types/options/redis/interfaces.d.ts +81 -0
  246. package/common/types/options/redis/interfaces.d.ts.map +1 -0
  247. package/common/types/options/{redis.options.d.ts → redis/schema.d.ts} +2 -2
  248. package/common/types/options/redis/schema.d.ts.map +1 -0
  249. package/common/types/options/server-info/index.d.ts +4 -0
  250. package/common/types/options/server-info/index.d.ts.map +1 -0
  251. package/common/types/options/server-info/interfaces.d.ts +27 -0
  252. package/common/types/options/server-info/interfaces.d.ts.map +1 -0
  253. package/common/types/options/{server-info.options.d.ts → server-info/schema.d.ts} +13 -10
  254. package/common/types/options/server-info/schema.d.ts.map +1 -0
  255. package/common/types/options/session/index.d.ts +4 -0
  256. package/common/types/options/session/index.d.ts.map +1 -0
  257. package/common/types/options/session/interfaces.d.ts +66 -0
  258. package/common/types/options/session/interfaces.d.ts.map +1 -0
  259. package/common/types/options/session/schema.d.ts +79 -0
  260. package/common/types/options/session/schema.d.ts.map +1 -0
  261. package/common/types/options/skills-http/index.d.ts +4 -0
  262. package/common/types/options/skills-http/index.d.ts.map +1 -0
  263. package/common/types/options/skills-http/interfaces.d.ts +321 -0
  264. package/common/types/options/skills-http/interfaces.d.ts.map +1 -0
  265. package/common/types/options/skills-http/schema.d.ts +139 -0
  266. package/common/types/options/skills-http/schema.d.ts.map +1 -0
  267. package/common/types/options/transport/index.d.ts +4 -0
  268. package/common/types/options/transport/index.d.ts.map +1 -0
  269. package/common/types/options/transport/interfaces.d.ts +354 -0
  270. package/common/types/options/transport/interfaces.d.ts.map +1 -0
  271. package/common/types/options/transport/schema.d.ts +309 -0
  272. package/common/types/options/transport/schema.d.ts.map +1 -0
  273. package/common/types/options/transport/typecheck.d.ts +2 -0
  274. package/common/types/options/transport/typecheck.d.ts.map +1 -0
  275. package/common/utils/decide-request-intent.utils.d.ts +3 -3
  276. package/common/utils/decide-request-intent.utils.d.ts.map +1 -1
  277. package/context/context-extension.d.ts +1 -28
  278. package/context/context-extension.d.ts.map +1 -1
  279. package/context/frontmcp-context-storage.d.ts.map +1 -1
  280. package/context/frontmcp-context.d.ts +36 -39
  281. package/context/frontmcp-context.d.ts.map +1 -1
  282. package/context/frontmcp-context.provider.d.ts +3 -9
  283. package/context/frontmcp-context.provider.d.ts.map +1 -1
  284. package/context/index.d.ts +5 -20
  285. package/context/index.d.ts.map +1 -1
  286. package/context/metadata.utils.d.ts +24 -0
  287. package/context/metadata.utils.d.ts.map +1 -0
  288. package/direct/client.types.d.ts +447 -0
  289. package/direct/client.types.d.ts.map +1 -0
  290. package/direct/connect.d.ts +188 -0
  291. package/direct/connect.d.ts.map +1 -0
  292. package/direct/direct-client.d.ts +7 -0
  293. package/direct/direct-client.d.ts.map +1 -0
  294. package/direct/direct-server.d.ts +38 -0
  295. package/direct/direct-server.d.ts.map +1 -0
  296. package/direct/direct.types.d.ts +134 -0
  297. package/direct/direct.types.d.ts.map +1 -0
  298. package/direct/index.d.ts +15 -0
  299. package/direct/index.d.ts.map +1 -0
  300. package/direct/llm-platform.d.ts +94 -0
  301. package/direct/llm-platform.d.ts.map +1 -0
  302. package/elicitation/elicitation-fallback.schema.d.ts +32 -0
  303. package/elicitation/elicitation-fallback.schema.d.ts.map +1 -0
  304. package/elicitation/elicitation.types.d.ts +160 -0
  305. package/elicitation/elicitation.types.d.ts.map +1 -0
  306. package/elicitation/flows/elicitation-request.flow.d.ts +98 -0
  307. package/elicitation/flows/elicitation-request.flow.d.ts.map +1 -0
  308. package/elicitation/flows/elicitation-result.flow.d.ts +79 -0
  309. package/elicitation/flows/elicitation-result.flow.d.ts.map +1 -0
  310. package/elicitation/flows/index.d.ts +10 -0
  311. package/elicitation/flows/index.d.ts.map +1 -0
  312. package/elicitation/helpers/elicit.helper.d.ts +65 -0
  313. package/elicitation/helpers/elicit.helper.d.ts.map +1 -0
  314. package/elicitation/helpers/extend-output-schema.d.ts +31 -0
  315. package/elicitation/helpers/extend-output-schema.d.ts.map +1 -0
  316. package/elicitation/helpers/fallback.helper.d.ts +60 -0
  317. package/elicitation/helpers/fallback.helper.d.ts.map +1 -0
  318. package/elicitation/helpers/index.d.ts +12 -0
  319. package/elicitation/helpers/index.d.ts.map +1 -0
  320. package/elicitation/helpers/validate-elicitation-content.d.ts +52 -0
  321. package/elicitation/helpers/validate-elicitation-content.d.ts.map +1 -0
  322. package/elicitation/hooks/elicitation.hooks.d.ts +66 -0
  323. package/elicitation/hooks/elicitation.hooks.d.ts.map +1 -0
  324. package/elicitation/hooks/index.d.ts +9 -0
  325. package/elicitation/hooks/index.d.ts.map +1 -0
  326. package/elicitation/index.d.ts +18 -0
  327. package/elicitation/index.d.ts.map +1 -0
  328. package/elicitation/send-elicitation-result.tool.d.ts +18 -0
  329. package/elicitation/send-elicitation-result.tool.d.ts.map +1 -0
  330. package/elicitation/store/elicitation-encryption.d.ts +134 -0
  331. package/elicitation/store/elicitation-encryption.d.ts.map +1 -0
  332. package/elicitation/store/elicitation-store.factory.d.ts +197 -0
  333. package/elicitation/store/elicitation-store.factory.d.ts.map +1 -0
  334. package/elicitation/store/elicitation.store.d.ts +191 -0
  335. package/elicitation/store/elicitation.store.d.ts.map +1 -0
  336. package/elicitation/store/encrypted-elicitation.store.d.ts +121 -0
  337. package/elicitation/store/encrypted-elicitation.store.d.ts.map +1 -0
  338. package/elicitation/store/index.d.ts +14 -0
  339. package/elicitation/store/index.d.ts.map +1 -0
  340. package/elicitation/store/storage-elicitation.store.d.ts +118 -0
  341. package/elicitation/store/storage-elicitation.store.d.ts.map +1 -0
  342. package/errors/elicitation.error.d.ts +115 -0
  343. package/errors/elicitation.error.d.ts.map +1 -0
  344. package/errors/index.d.ts +1 -0
  345. package/errors/index.d.ts.map +1 -1
  346. package/esm/index.mjs +30824 -19537
  347. package/esm/package.json +13 -7
  348. package/ext-apps/ext-apps.handler.d.ts +177 -0
  349. package/ext-apps/ext-apps.handler.d.ts.map +1 -0
  350. package/ext-apps/ext-apps.types.d.ts +273 -0
  351. package/ext-apps/ext-apps.types.d.ts.map +1 -0
  352. package/ext-apps/index.d.ts +13 -0
  353. package/ext-apps/index.d.ts.map +1 -0
  354. package/flows/flow.instance.d.ts.map +1 -1
  355. package/front-mcp/front-mcp.d.ts +64 -2
  356. package/front-mcp/front-mcp.d.ts.map +1 -1
  357. package/front-mcp/front-mcp.providers.d.ts +604 -236
  358. package/front-mcp/front-mcp.providers.d.ts.map +1 -1
  359. package/index.d.ts +17 -0
  360. package/index.d.ts.map +1 -1
  361. package/index.js +31066 -19707
  362. package/notification/index.d.ts +1 -1
  363. package/notification/index.d.ts.map +1 -1
  364. package/notification/notification.service.d.ts +18 -0
  365. package/notification/notification.service.d.ts.map +1 -1
  366. package/package.json +13 -7
  367. package/plugin/plugin.registry.d.ts +2 -0
  368. package/plugin/plugin.registry.d.ts.map +1 -1
  369. package/provider/provider.registry.d.ts +8 -3
  370. package/provider/provider.registry.d.ts.map +1 -1
  371. package/scope/flows/http.request.flow.d.ts +4 -0
  372. package/scope/flows/http.request.flow.d.ts.map +1 -1
  373. package/scope/scope.instance.d.ts +74 -0
  374. package/scope/scope.instance.d.ts.map +1 -1
  375. package/server/server.instance.d.ts +3 -3
  376. package/server/server.instance.d.ts.map +1 -1
  377. package/skill/auth/index.d.ts +10 -0
  378. package/skill/auth/index.d.ts.map +1 -0
  379. package/skill/auth/skill-http-auth.d.ts +112 -0
  380. package/skill/auth/skill-http-auth.d.ts.map +1 -0
  381. package/skill/cache/index.d.ts +13 -0
  382. package/skill/cache/index.d.ts.map +1 -0
  383. package/skill/cache/skill-http-cache.d.ts +144 -0
  384. package/skill/cache/skill-http-cache.d.ts.map +1 -0
  385. package/skill/cache/skill-http-cache.factory.d.ts +83 -0
  386. package/skill/cache/skill-http-cache.factory.d.ts.map +1 -0
  387. package/skill/cache/skill-http-cache.holder.d.ts +35 -0
  388. package/skill/cache/skill-http-cache.holder.d.ts.map +1 -0
  389. package/skill/errors/index.d.ts +3 -0
  390. package/skill/errors/index.d.ts.map +1 -0
  391. package/skill/errors/skill-validation.error.d.ts +110 -0
  392. package/skill/errors/skill-validation.error.d.ts.map +1 -0
  393. package/skill/errors/tool-not-allowed.error.d.ts +66 -0
  394. package/skill/errors/tool-not-allowed.error.d.ts.map +1 -0
  395. package/skill/flows/http/index.d.ts +12 -0
  396. package/skill/flows/http/index.d.ts.map +1 -0
  397. package/skill/flows/http/llm-full-txt.flow.d.ts +70 -0
  398. package/skill/flows/http/llm-full-txt.flow.d.ts.map +1 -0
  399. package/skill/flows/http/llm-txt.flow.d.ts +77 -0
  400. package/skill/flows/http/llm-txt.flow.d.ts.map +1 -0
  401. package/skill/flows/http/skills-api.flow.d.ts +81 -0
  402. package/skill/flows/http/skills-api.flow.d.ts.map +1 -0
  403. package/skill/flows/index.d.ts +13 -0
  404. package/skill/flows/index.d.ts.map +1 -0
  405. package/skill/flows/load-skill.flow.d.ts +169 -0
  406. package/skill/flows/load-skill.flow.d.ts.map +1 -0
  407. package/skill/flows/search-skills.flow.d.ts +101 -0
  408. package/skill/flows/search-skills.flow.d.ts.map +1 -0
  409. package/skill/guards/index.d.ts +2 -0
  410. package/skill/guards/index.d.ts.map +1 -0
  411. package/skill/guards/tool-authorization.guard.d.ts +87 -0
  412. package/skill/guards/tool-authorization.guard.d.ts.map +1 -0
  413. package/skill/hooks/index.d.ts +2 -0
  414. package/skill/hooks/index.d.ts.map +1 -0
  415. package/skill/hooks/skill-tool.hook.d.ts +52 -0
  416. package/skill/hooks/skill-tool.hook.d.ts.map +1 -0
  417. package/skill/index.d.ts +74 -0
  418. package/skill/index.d.ts.map +1 -0
  419. package/skill/providers/external-skill.provider.d.ts +240 -0
  420. package/skill/providers/external-skill.provider.d.ts.map +1 -0
  421. package/skill/providers/index.d.ts +12 -0
  422. package/skill/providers/index.d.ts.map +1 -0
  423. package/skill/providers/memory-skill.provider.d.ts +97 -0
  424. package/skill/providers/memory-skill.provider.d.ts.map +1 -0
  425. package/skill/session/index.d.ts +4 -0
  426. package/skill/session/index.d.ts.map +1 -0
  427. package/skill/session/skill-session-store.interface.d.ts +79 -0
  428. package/skill/session/skill-session-store.interface.d.ts.map +1 -0
  429. package/skill/session/skill-session.manager.d.ts +137 -0
  430. package/skill/session/skill-session.manager.d.ts.map +1 -0
  431. package/skill/session/skill-session.types.d.ts +303 -0
  432. package/skill/session/skill-session.types.d.ts.map +1 -0
  433. package/skill/skill-http.utils.d.ts +107 -0
  434. package/skill/skill-http.utils.d.ts.map +1 -0
  435. package/skill/skill-mode.utils.d.ts +53 -0
  436. package/skill/skill-mode.utils.d.ts.map +1 -0
  437. package/skill/skill-scope.helper.d.ts +55 -0
  438. package/skill/skill-scope.helper.d.ts.map +1 -0
  439. package/skill/skill-storage.factory.d.ts +194 -0
  440. package/skill/skill-storage.factory.d.ts.map +1 -0
  441. package/skill/skill-storage.interface.d.ts +230 -0
  442. package/skill/skill-storage.interface.d.ts.map +1 -0
  443. package/skill/skill-validator.d.ts +63 -0
  444. package/skill/skill-validator.d.ts.map +1 -0
  445. package/skill/skill.events.d.ts +88 -0
  446. package/skill/skill.events.d.ts.map +1 -0
  447. package/skill/skill.instance.d.ts +92 -0
  448. package/skill/skill.instance.d.ts.map +1 -0
  449. package/skill/skill.registry.d.ts +309 -0
  450. package/skill/skill.registry.d.ts.map +1 -0
  451. package/skill/skill.utils.d.ts +90 -0
  452. package/skill/skill.utils.d.ts.map +1 -0
  453. package/skill/sync/index.d.ts +16 -0
  454. package/skill/sync/index.d.ts.map +1 -0
  455. package/skill/sync/memory-sync-state.store.d.ts +49 -0
  456. package/skill/sync/memory-sync-state.store.d.ts.map +1 -0
  457. package/skill/sync/skill-hash.d.ts +65 -0
  458. package/skill/sync/skill-hash.d.ts.map +1 -0
  459. package/skill/sync/sync-state.interface.d.ts +125 -0
  460. package/skill/sync/sync-state.interface.d.ts.map +1 -0
  461. package/skill/tools/index.d.ts +21 -0
  462. package/skill/tools/index.d.ts.map +1 -0
  463. package/skill/tools/load-skills.tool.d.ts +76 -0
  464. package/skill/tools/load-skills.tool.d.ts.map +1 -0
  465. package/skill/tools/search-skills.tool.d.ts +61 -0
  466. package/skill/tools/search-skills.tool.d.ts.map +1 -0
  467. package/tool/flows/call-tool.flow.d.ts +1 -0
  468. package/tool/flows/call-tool.flow.d.ts.map +1 -1
  469. package/tool/flows/tools-list.flow.d.ts +15 -0
  470. package/tool/flows/tools-list.flow.d.ts.map +1 -1
  471. package/tool/tool.instance.d.ts +8 -0
  472. package/tool/tool.instance.d.ts.map +1 -1
  473. package/tool/tool.registry.d.ts +11 -0
  474. package/tool/tool.registry.d.ts.map +1 -1
  475. package/tool/tool.utils.d.ts.map +1 -1
  476. package/tool/ui/template-helpers.d.ts +0 -5
  477. package/tool/ui/template-helpers.d.ts.map +1 -1
  478. package/transport/adapters/streamable-http-transport.d.ts.map +1 -1
  479. package/transport/adapters/transport.local.adapter.d.ts +54 -9
  480. package/transport/adapters/transport.local.adapter.d.ts.map +1 -1
  481. package/transport/adapters/transport.sse.adapter.d.ts +11 -2
  482. package/transport/adapters/transport.sse.adapter.d.ts.map +1 -1
  483. package/transport/adapters/transport.streamable-http.adapter.d.ts +21 -2
  484. package/transport/adapters/transport.streamable-http.adapter.d.ts.map +1 -1
  485. package/transport/event-stores/event-store.factory.d.ts +96 -0
  486. package/transport/event-stores/event-store.factory.d.ts.map +1 -0
  487. package/transport/event-stores/index.d.ts +47 -0
  488. package/transport/event-stores/index.d.ts.map +1 -0
  489. package/transport/event-stores/memory.event-store.d.ts +51 -0
  490. package/transport/event-stores/memory.event-store.d.ts.map +1 -0
  491. package/transport/event-stores/redis.event-store.d.ts +79 -0
  492. package/transport/event-stores/redis.event-store.d.ts.map +1 -0
  493. package/transport/flows/handle.sse.flow.d.ts.map +1 -1
  494. package/transport/flows/handle.streamable-http.flow.d.ts +3 -1
  495. package/transport/flows/handle.streamable-http.flow.d.ts.map +1 -1
  496. package/transport/in-memory-server.d.ts +85 -0
  497. package/transport/in-memory-server.d.ts.map +1 -0
  498. package/transport/index.d.ts +47 -0
  499. package/transport/index.d.ts.map +1 -1
  500. package/transport/mcp-handlers/complete-request.handler.d.ts +3 -84
  501. package/transport/mcp-handlers/complete-request.handler.d.ts.map +1 -1
  502. package/transport/mcp-handlers/get-prompt-request.handler.d.ts +3 -128
  503. package/transport/mcp-handlers/get-prompt-request.handler.d.ts.map +1 -1
  504. package/transport/mcp-handlers/index.d.ts +463 -490
  505. package/transport/mcp-handlers/index.d.ts.map +1 -1
  506. package/transport/mcp-handlers/initialize-request.handler.d.ts.map +1 -1
  507. package/transport/mcp-handlers/list-prompts-request.handler.d.ts +3 -70
  508. package/transport/mcp-handlers/list-prompts-request.handler.d.ts.map +1 -1
  509. package/transport/mcp-handlers/list-resource-templates-request.handler.d.ts +3 -72
  510. package/transport/mcp-handlers/list-resource-templates-request.handler.d.ts.map +1 -1
  511. package/transport/mcp-handlers/list-resources-request.handler.d.ts +3 -72
  512. package/transport/mcp-handlers/list-resources-request.handler.d.ts.map +1 -1
  513. package/transport/mcp-handlers/list-tools-request.handler.d.ts +3 -85
  514. package/transport/mcp-handlers/list-tools-request.handler.d.ts.map +1 -1
  515. package/transport/mcp-handlers/read-resource-request.handler.d.ts +3 -61
  516. package/transport/mcp-handlers/read-resource-request.handler.d.ts.map +1 -1
  517. package/transport/mcp-handlers/skills-list-request.handler.d.ts +9 -0
  518. package/transport/mcp-handlers/skills-list-request.handler.d.ts.map +1 -0
  519. package/transport/mcp-handlers/skills-load-request.handler.d.ts +9 -0
  520. package/transport/mcp-handlers/skills-load-request.handler.d.ts.map +1 -0
  521. package/transport/mcp-handlers/skills-mcp.types.d.ts +157 -0
  522. package/transport/mcp-handlers/skills-mcp.types.d.ts.map +1 -0
  523. package/transport/mcp-handlers/skills-search-request.handler.d.ts +9 -0
  524. package/transport/mcp-handlers/skills-search-request.handler.d.ts.map +1 -0
  525. package/transport/transport.registry.d.ts +9 -1
  526. package/transport/transport.registry.d.ts.map +1 -1
  527. package/transport/transport.types.d.ts +1 -8
  528. package/transport/transport.types.d.ts.map +1 -1
  529. package/auth/jwks/dev-key-persistence.d.ts +0 -64
  530. package/auth/jwks/dev-key-persistence.d.ts.map +0 -1
  531. package/auth/jwks/index.d.ts +0 -4
  532. package/auth/jwks/index.d.ts.map +0 -1
  533. package/auth/jwks/jwks.service.d.ts +0 -58
  534. package/auth/jwks/jwks.service.d.ts.map +0 -1
  535. package/auth/jwks/jwks.types.d.ts +0 -33
  536. package/auth/jwks/jwks.types.d.ts.map +0 -1
  537. package/auth/jwks/jwks.utils.d.ts +0 -5
  538. package/auth/jwks/jwks.utils.d.ts.map +0 -1
  539. package/auth/oauth/flows/oauth.authorize.flow.d.ts +0 -32
  540. package/auth/oauth/flows/oauth.authorize.flow.d.ts.map +0 -1
  541. package/auth/oauth/flows/oauth.device-authorization.flow.d.ts +0 -47
  542. package/auth/oauth/flows/oauth.device-authorization.flow.d.ts.map +0 -1
  543. package/auth/oauth/flows/oauth.introspect.flow.d.ts +0 -27
  544. package/auth/oauth/flows/oauth.introspect.flow.d.ts.map +0 -1
  545. package/auth/oauth/flows/oauth.par.flow.d.ts +0 -28
  546. package/auth/oauth/flows/oauth.par.flow.d.ts.map +0 -1
  547. package/auth/oauth/flows/oauth.revoke.flow.d.ts +0 -26
  548. package/auth/oauth/flows/oauth.revoke.flow.d.ts.map +0 -1
  549. package/auth/oauth/flows/oauth.token.flow.d.ts +0 -58
  550. package/auth/oauth/flows/oauth.token.flow.d.ts.map +0 -1
  551. package/auth/oauth/flows/oauth.userinfo.flow.d.ts +0 -23
  552. package/auth/oauth/flows/oauth.userinfo.flow.d.ts.map +0 -1
  553. package/auth/oauth/flows/oidc.logout.flow.d.ts +0 -19
  554. package/auth/oauth/flows/oidc.logout.flow.d.ts.map +0 -1
  555. package/auth/session/authorization-vault.d.ts +0 -612
  556. package/auth/session/authorization-vault.d.ts.map +0 -1
  557. package/auth/session/authorization.store.d.ts +0 -302
  558. package/auth/session/authorization.store.d.ts.map +0 -1
  559. package/auth/session/record/session.stateful.d.ts +0 -21
  560. package/auth/session/record/session.stateful.d.ts.map +0 -1
  561. package/auth/session/record/session.stateless.d.ts +0 -18
  562. package/auth/session/record/session.stateless.d.ts.map +0 -1
  563. package/auth/session/record/session.transparent.d.ts +0 -18
  564. package/auth/session/record/session.transparent.d.ts.map +0 -1
  565. package/auth/session/session.crypto.d.ts +0 -8
  566. package/auth/session/session.crypto.d.ts.map +0 -1
  567. package/auth/session/session.schema.d.ts +0 -6
  568. package/auth/session/session.schema.d.ts.map +0 -1
  569. package/auth/session/token.store.d.ts +0 -36
  570. package/auth/session/token.store.d.ts.map +0 -1
  571. package/auth/session/token.vault.d.ts +0 -27
  572. package/auth/session/token.vault.d.ts.map +0 -1
  573. package/auth/session/vault-encryption.d.ts +0 -190
  574. package/auth/session/vault-encryption.d.ts.map +0 -1
  575. package/auth/utils/audience.validator.d.ts +0 -130
  576. package/auth/utils/audience.validator.d.ts.map +0 -1
  577. package/auth/utils/www-authenticate.utils.d.ts +0 -98
  578. package/auth/utils/www-authenticate.utils.d.ts.map +0 -1
  579. package/common/migrate/auth-transport.migrate.d.ts +0 -63
  580. package/common/migrate/auth-transport.migrate.d.ts.map +0 -1
  581. package/common/migrate/index.d.ts +0 -2
  582. package/common/migrate/index.d.ts.map +0 -1
  583. package/common/types/options/auth/auth.interfaces.d.ts.map +0 -1
  584. package/common/types/options/auth/auth.schema.d.ts.map +0 -1
  585. package/common/types/options/auth/auth.typecheck.d.ts +0 -2
  586. package/common/types/options/auth/auth.typecheck.d.ts.map +0 -1
  587. package/common/types/options/auth/auth.utils.d.ts.map +0 -1
  588. package/common/types/options/auth/transport.deprecated.d.ts +0 -64
  589. package/common/types/options/auth/transport.deprecated.d.ts.map +0 -1
  590. package/common/types/options/http.options.d.ts +0 -15
  591. package/common/types/options/http.options.d.ts.map +0 -1
  592. package/common/types/options/logging.options.d.ts +0 -29
  593. package/common/types/options/logging.options.d.ts.map +0 -1
  594. package/common/types/options/redis.options.d.ts.map +0 -1
  595. package/common/types/options/server-info.options.d.ts.map +0 -1
  596. package/common/types/options/session.options.d.ts +0 -148
  597. package/common/types/options/session.options.d.ts.map +0 -1
  598. package/common/types/options/transport.options.d.ts +0 -178
  599. package/common/types/options/transport.options.d.ts.map +0 -1
  600. package/context/request-context-storage.d.ts +0 -90
  601. package/context/request-context-storage.d.ts.map +0 -1
  602. package/context/request-context.d.ts +0 -185
  603. package/context/request-context.d.ts.map +0 -1
  604. package/context/request-context.provider.d.ts +0 -38
  605. package/context/request-context.provider.d.ts.map +0 -1
  606. package/context/session-key.provider.d.ts +0 -46
  607. package/context/session-key.provider.d.ts.map +0 -1
  608. package/store/adapters/store.base.adapter.d.ts +0 -22
  609. package/store/adapters/store.base.adapter.d.ts.map +0 -1
  610. package/store/adapters/store.memory.adapter.d.ts +0 -27
  611. package/store/adapters/store.memory.adapter.d.ts.map +0 -1
  612. package/store/adapters/store.redis.adapter.d.ts +0 -34
  613. package/store/adapters/store.redis.adapter.d.ts.map +0 -1
  614. package/store/adapters/store.vercel-kv.adapter.d.ts +0 -87
  615. package/store/adapters/store.vercel-kv.adapter.d.ts.map +0 -1
  616. package/store/index.d.ts +0 -11
  617. package/store/index.d.ts.map +0 -1
  618. package/store/store.factory.d.ts.map +0 -1
  619. package/store/store.helpers.d.ts +0 -10
  620. package/store/store.helpers.d.ts.map +0 -1
  621. package/store/store.registry.d.ts +0 -14
  622. package/store/store.registry.d.ts.map +0 -1
  623. package/store/store.tokens.d.ts +0 -4
  624. package/store/store.tokens.d.ts.map +0 -1
  625. package/store/store.types.d.ts +0 -65
  626. package/store/store.types.d.ts.map +0 -1
  627. package/store/store.utils.d.ts +0 -9
  628. package/store/store.utils.d.ts.map +0 -1
  629. package/transport/transport.event-store.d.ts +0 -11
  630. package/transport/transport.event-store.d.ts.map +0 -1
@@ -0,0 +1,321 @@
1
+ /**
2
+ * @module skillsConfig
3
+ *
4
+ * Skills HTTP Endpoints Configuration
5
+ *
6
+ * This module enables exposing FrontMCP skills via HTTP endpoints for multi-agent
7
+ * architectures where:
8
+ * - **Planner agents** fetch skills via HTTP to create execution plans
9
+ * - **Sub-agents** connect to specific apps for tool execution without skills
10
+ * - **Backend servers** fetch skills via HTTP GET before calling LLMs
11
+ *
12
+ * ## HTTP Endpoints
13
+ *
14
+ * When `skillsConfig.enabled: true`, the following endpoints are available:
15
+ *
16
+ * | Endpoint | Method | Description |
17
+ * |-------------------|--------|------------------------------------------------|
18
+ * | `/llm.txt` | GET | Compact skill summaries (name, description, tools, tags) |
19
+ * | `/llm_full.txt` | GET | Full skills with complete instructions and tool schemas |
20
+ * | `/skills` | GET | JSON API - List all skills |
21
+ * | `/skills?query=X` | GET | JSON API - Search skills with optional filters |
22
+ * | `/skills/{id}` | GET | JSON API - Get specific skill by ID/name |
23
+ *
24
+ * ## Visibility Control
25
+ *
26
+ * Skills can have a `visibility` property to control where they appear:
27
+ * - `'mcp'`: Only via searchSkills/loadSkill MCP tools
28
+ * - `'http'`: Only via HTTP API endpoints (/llm.txt, /skills)
29
+ * - `'both'`: Visible in both MCP and HTTP (default)
30
+ *
31
+ * ```typescript
32
+ * @Skill({
33
+ * name: 'internal-process',
34
+ * visibility: 'http', // Only visible via HTTP endpoints
35
+ * instructions: { file: './internal.md' },
36
+ * })
37
+ * class InternalProcessSkill {}
38
+ * ```
39
+ *
40
+ * ## Architecture Examples
41
+ *
42
+ * ### Multi-Agent Architecture
43
+ * ```
44
+ * ┌──────────────────┐ HTTP GET /skills
45
+ * │ Planner Agent │ ──────────────────────> FrontMCP Server
46
+ * └────────┬─────────┘ │
47
+ * │ creates plan │ /llm.txt
48
+ * ▼ │ /skills
49
+ * ┌──────────────────┐ MCP (tools only) ▼
50
+ * │ Executor Agent │ <──────────────────── Tools (no skills listed)
51
+ * └──────────────────┘
52
+ * ```
53
+ *
54
+ * ### Backend Server Integration
55
+ * ```typescript
56
+ * // Fetch skills before calling LLM
57
+ * const skills = await fetch('https://api.example.com/llm.txt');
58
+ * const systemPrompt = `Available skills:\n${await skills.text()}`;
59
+ *
60
+ * // Call LLM with skill context
61
+ * const response = await llm.chat({ system: systemPrompt, user: query });
62
+ * ```
63
+ *
64
+ * @see {@link SkillsConfigOptions} for configuration options
65
+ * @see {@link SkillMetadata.visibility} for per-skill visibility control
66
+ */
67
+ /**
68
+ * Authentication mode for skills HTTP endpoints.
69
+ * - 'inherit': Use the server's default authentication
70
+ * - 'public': No authentication required
71
+ * - 'api-key': Require API key in X-API-Key header or Authorization: ApiKey <key>
72
+ * - 'bearer': Require JWT token, validated against configured issuer
73
+ */
74
+ export type SkillsConfigAuthMode = 'inherit' | 'public' | 'api-key' | 'bearer';
75
+ /**
76
+ * JWT validation configuration for bearer auth mode.
77
+ */
78
+ export interface SkillsConfigJwtOptions {
79
+ /**
80
+ * JWT issuer URL (e.g., 'https://auth.example.com').
81
+ * Required when using bearer auth mode.
82
+ */
83
+ issuer: string;
84
+ /**
85
+ * Expected audience claim (optional).
86
+ * If provided, the JWT must have this audience.
87
+ */
88
+ audience?: string;
89
+ /**
90
+ * JWKS URL for key discovery.
91
+ * Defaults to {issuer}/.well-known/jwks.json
92
+ */
93
+ jwksUrl?: string;
94
+ }
95
+ /**
96
+ * Configuration for an individual skills HTTP endpoint.
97
+ * Controls whether the endpoint is enabled and its path.
98
+ * Authentication is configured at the top level of SkillsConfigOptions.
99
+ */
100
+ export interface SkillsConfigEndpointConfig {
101
+ /**
102
+ * Whether this endpoint is enabled.
103
+ * @default true
104
+ */
105
+ enabled?: boolean;
106
+ /**
107
+ * Custom path override for this endpoint.
108
+ * If not specified, uses the default path.
109
+ */
110
+ path?: string;
111
+ }
112
+ /**
113
+ * Options for exposing skills via HTTP endpoints.
114
+ *
115
+ * When enabled, skills can be discovered and loaded via HTTP endpoints
116
+ * in addition to (or instead of) MCP tools.
117
+ *
118
+ * Authentication is configured once at the top level and applies to all
119
+ * HTTP endpoints. Individual endpoints can be enabled/disabled separately.
120
+ *
121
+ * @example Basic usage (public access)
122
+ * ```typescript
123
+ * @FrontMcp({
124
+ * skillsConfig: {
125
+ * enabled: true,
126
+ * auth: 'public',
127
+ * },
128
+ * })
129
+ * ```
130
+ *
131
+ * @example Protected API with API key
132
+ * ```typescript
133
+ * @FrontMcp({
134
+ * skillsConfig: {
135
+ * enabled: true,
136
+ * auth: 'api-key',
137
+ * apiKeys: ['sk-xxx', 'sk-yyy'],
138
+ * },
139
+ * })
140
+ * ```
141
+ *
142
+ * @example Custom paths with prefix
143
+ * ```typescript
144
+ * @FrontMcp({
145
+ * skillsConfig: {
146
+ * enabled: true,
147
+ * prefix: '/api/v1',
148
+ * auth: 'public',
149
+ * llmTxt: { path: '/api/v1/llm.txt' },
150
+ * api: { enabled: false }, // Disable JSON API
151
+ * },
152
+ * })
153
+ * ```
154
+ *
155
+ * @example HTTP only (no MCP tools)
156
+ * ```typescript
157
+ * @FrontMcp({
158
+ * skillsConfig: {
159
+ * enabled: true,
160
+ * auth: 'public',
161
+ * mcpTools: false, // No searchSkills/loadSkill MCP tools
162
+ * },
163
+ * })
164
+ * ```
165
+ */
166
+ export interface SkillsConfigOptions {
167
+ /**
168
+ * Whether skills HTTP endpoints are enabled.
169
+ * @default false (opt-in feature)
170
+ */
171
+ enabled?: boolean;
172
+ /**
173
+ * Prefix for all skills HTTP endpoints.
174
+ * @example '/api' results in '/api/llm.txt', '/api/skills', etc.
175
+ */
176
+ prefix?: string;
177
+ /**
178
+ * Authentication mode for all skills HTTP endpoints.
179
+ * This single setting applies to /llm.txt, /llm_full.txt, and /skills.
180
+ *
181
+ * - 'inherit': Use the server's default authentication (default)
182
+ * - 'public': No authentication required
183
+ * - 'api-key': Require API key in X-API-Key header
184
+ * - 'bearer': Require bearer token in Authorization header
185
+ *
186
+ * @default 'inherit'
187
+ */
188
+ auth?: SkillsConfigAuthMode;
189
+ /**
190
+ * API keys for 'api-key' authentication mode.
191
+ * Only used when auth is 'api-key'.
192
+ * Requests must include one of these keys in the X-API-Key header
193
+ * or in Authorization header as `ApiKey <key>`.
194
+ */
195
+ apiKeys?: string[];
196
+ /**
197
+ * JWT validation configuration for 'bearer' authentication mode.
198
+ * Required when auth is 'bearer'.
199
+ *
200
+ * @example
201
+ * ```typescript
202
+ * @FrontMcp({
203
+ * skillsConfig: {
204
+ * enabled: true,
205
+ * auth: 'bearer',
206
+ * jwt: {
207
+ * issuer: 'https://auth.example.com',
208
+ * audience: 'skills-api',
209
+ * },
210
+ * },
211
+ * })
212
+ * ```
213
+ */
214
+ jwt?: SkillsConfigJwtOptions;
215
+ /**
216
+ * Configuration for /llm.txt endpoint.
217
+ * Provides compact skill summaries (name, description, tools, tags).
218
+ *
219
+ * Can be:
220
+ * - `true`: Enable with defaults
221
+ * - `false`: Disable this endpoint
222
+ * - `{ enabled?: boolean; path?: string }`: Custom configuration
223
+ *
224
+ * @default true (when skillsConfig.enabled is true)
225
+ */
226
+ llmTxt?: SkillsConfigEndpointConfig | boolean;
227
+ /**
228
+ * Configuration for /llm_full.txt endpoint.
229
+ * Provides full skill content with complete instructions and tool schemas.
230
+ *
231
+ * Can be:
232
+ * - `true`: Enable with defaults
233
+ * - `false`: Disable this endpoint
234
+ * - `{ enabled?: boolean; path?: string }`: Custom configuration
235
+ *
236
+ * @default true (when skillsConfig.enabled is true)
237
+ */
238
+ llmFullTxt?: SkillsConfigEndpointConfig | boolean;
239
+ /**
240
+ * Configuration for /skills API endpoints.
241
+ * Provides JSON API for listing, searching, and loading skills.
242
+ *
243
+ * Endpoints:
244
+ * - GET /skills - List all skills
245
+ * - GET /skills?query=X - Search skills
246
+ * - GET /skills/{id} - Get specific skill by ID/name
247
+ *
248
+ * Can be:
249
+ * - `true`: Enable with defaults
250
+ * - `false`: Disable this endpoint
251
+ * - `{ enabled?: boolean; path?: string }`: Custom configuration
252
+ *
253
+ * @default true (when skillsConfig.enabled is true)
254
+ */
255
+ api?: SkillsConfigEndpointConfig | boolean;
256
+ /**
257
+ * Whether to include searchSkills/loadSkill MCP tools.
258
+ * Set to false to expose skills only via HTTP endpoints.
259
+ *
260
+ * @default true
261
+ */
262
+ mcpTools?: boolean;
263
+ /**
264
+ * Cache configuration for HTTP endpoints.
265
+ * Reduces latency and CPU/memory overhead for repeated requests.
266
+ *
267
+ * @example Memory cache (default)
268
+ * ```typescript
269
+ * cache: { enabled: true, ttlMs: 30000 }
270
+ * ```
271
+ *
272
+ * @example Redis cache
273
+ * ```typescript
274
+ * cache: {
275
+ * enabled: true,
276
+ * redis: { provider: 'redis', host: 'localhost' },
277
+ * ttlMs: 60000,
278
+ * }
279
+ * ```
280
+ */
281
+ cache?: SkillsConfigCacheOptions;
282
+ }
283
+ /**
284
+ * Cache configuration for skills HTTP endpoints.
285
+ */
286
+ export interface SkillsConfigCacheOptions {
287
+ /**
288
+ * Whether caching is enabled.
289
+ * @default false (opt-in)
290
+ */
291
+ enabled?: boolean;
292
+ /**
293
+ * Redis configuration for distributed caching.
294
+ * If not provided, falls back to in-memory cache.
295
+ *
296
+ * Note: 'redis' provider uses ioredis under the hood.
297
+ */
298
+ redis?: {
299
+ /** Redis provider type */
300
+ provider: 'redis' | 'vercel-kv' | '@vercel/kv';
301
+ /** Redis host */
302
+ host?: string;
303
+ /** Redis port */
304
+ port?: number;
305
+ /** Redis password */
306
+ password?: string;
307
+ /** Redis database number */
308
+ db?: number;
309
+ };
310
+ /**
311
+ * Cache TTL in milliseconds.
312
+ * @default 60000 (1 minute)
313
+ */
314
+ ttlMs?: number;
315
+ /**
316
+ * Key prefix for Redis cache.
317
+ * @default 'frontmcp:skills:cache:'
318
+ */
319
+ keyPrefix?: string;
320
+ }
321
+ //# sourceMappingURL=interfaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../../src/common/types/options/skills-http/interfaces.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,CAAC,EAAE,sBAAsB,CAAC;IAE7B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC;IAE9C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC;IAElD;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QACN,0BAA0B;QAC1B,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;QAC/C,iBAAiB;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,iBAAiB;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,qBAAqB;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,4BAA4B;QAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IAEF;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
@@ -0,0 +1,139 @@
1
+ import { z } from 'zod';
2
+ import type { SkillsConfigAuthMode } from './interfaces';
3
+ /**
4
+ * Authentication mode schema for skills HTTP endpoints.
5
+ */
6
+ export declare const skillsConfigAuthModeSchema: z.ZodEnum<{
7
+ bearer: "bearer";
8
+ public: "public";
9
+ inherit: "inherit";
10
+ "api-key": "api-key";
11
+ }>;
12
+ /**
13
+ * Endpoint configuration schema (simplified - no auth, just enabled and path).
14
+ */
15
+ export declare const skillsConfigEndpointConfigSchema: z.ZodObject<{
16
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
17
+ path: z.ZodOptional<z.ZodString>;
18
+ }, z.core.$strip>;
19
+ /**
20
+ * JWT validation configuration schema.
21
+ */
22
+ export declare const skillsConfigJwtOptionsSchema: z.ZodObject<{
23
+ issuer: z.ZodString;
24
+ audience: z.ZodOptional<z.ZodString>;
25
+ jwksUrl: z.ZodOptional<z.ZodString>;
26
+ }, z.core.$strip>;
27
+ /**
28
+ * Cache configuration schema.
29
+ *
30
+ * Supports 'redis' (uses ioredis under the hood) and 'vercel-kv' providers.
31
+ */
32
+ export declare const skillsConfigCacheOptionsSchema: z.ZodObject<{
33
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
34
+ redis: z.ZodOptional<z.ZodObject<{
35
+ provider: z.ZodEnum<{
36
+ redis: "redis";
37
+ "vercel-kv": "vercel-kv";
38
+ "@vercel/kv": "@vercel/kv";
39
+ }>;
40
+ host: z.ZodOptional<z.ZodString>;
41
+ port: z.ZodOptional<z.ZodNumber>;
42
+ password: z.ZodOptional<z.ZodString>;
43
+ db: z.ZodOptional<z.ZodNumber>;
44
+ }, z.core.$strip>>;
45
+ ttlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
46
+ keyPrefix: z.ZodOptional<z.ZodString>;
47
+ }, z.core.$strip>;
48
+ /**
49
+ * Skills HTTP options Zod schema.
50
+ * Auth is configured at the top level and applies to all HTTP endpoints.
51
+ */
52
+ export declare const skillsConfigOptionsSchema: z.ZodObject<{
53
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
54
+ prefix: z.ZodOptional<z.ZodString>;
55
+ auth: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
56
+ bearer: "bearer";
57
+ public: "public";
58
+ inherit: "inherit";
59
+ "api-key": "api-key";
60
+ }>>>;
61
+ apiKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
62
+ jwt: z.ZodOptional<z.ZodObject<{
63
+ issuer: z.ZodString;
64
+ audience: z.ZodOptional<z.ZodString>;
65
+ jwksUrl: z.ZodOptional<z.ZodString>;
66
+ }, z.core.$strip>>;
67
+ llmTxt: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
68
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
69
+ path: z.ZodOptional<z.ZodString>;
70
+ }, z.core.$strip>, z.ZodBoolean]>>>;
71
+ llmFullTxt: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
72
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
73
+ path: z.ZodOptional<z.ZodString>;
74
+ }, z.core.$strip>, z.ZodBoolean]>>>;
75
+ api: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
76
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
77
+ path: z.ZodOptional<z.ZodString>;
78
+ }, z.core.$strip>, z.ZodBoolean]>>>;
79
+ mcpTools: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
80
+ cache: z.ZodOptional<z.ZodObject<{
81
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
82
+ redis: z.ZodOptional<z.ZodObject<{
83
+ provider: z.ZodEnum<{
84
+ redis: "redis";
85
+ "vercel-kv": "vercel-kv";
86
+ "@vercel/kv": "@vercel/kv";
87
+ }>;
88
+ host: z.ZodOptional<z.ZodString>;
89
+ port: z.ZodOptional<z.ZodNumber>;
90
+ password: z.ZodOptional<z.ZodString>;
91
+ db: z.ZodOptional<z.ZodNumber>;
92
+ }, z.core.$strip>>;
93
+ ttlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
94
+ keyPrefix: z.ZodOptional<z.ZodString>;
95
+ }, z.core.$strip>>;
96
+ }, z.core.$strip>;
97
+ /**
98
+ * Skills HTTP options type (with defaults applied).
99
+ */
100
+ export type SkillsConfigOptions = z.infer<typeof skillsConfigOptionsSchema>;
101
+ /**
102
+ * Skills HTTP options input type (for user configuration).
103
+ */
104
+ export type SkillsConfigOptionsInput = z.input<typeof skillsConfigOptionsSchema>;
105
+ /**
106
+ * Skills HTTP endpoint config type (with defaults applied).
107
+ */
108
+ export type SkillsConfigEndpointConfig = z.infer<typeof skillsConfigEndpointConfigSchema>;
109
+ /**
110
+ * Skills HTTP endpoint config input type.
111
+ */
112
+ export type SkillsConfigEndpointConfigInput = z.input<typeof skillsConfigEndpointConfigSchema>;
113
+ /**
114
+ * Normalized endpoint configuration with auth from parent.
115
+ * This is the result of normalizing an endpoint config with the parent's auth settings.
116
+ */
117
+ export interface NormalizedEndpointConfig {
118
+ enabled: boolean;
119
+ path: string;
120
+ auth: SkillsConfigAuthMode;
121
+ apiKeys?: string[];
122
+ }
123
+ /**
124
+ * Normalize endpoint configuration.
125
+ * Converts boolean or config object to normalized config object.
126
+ * Auth settings come from the parent skillsConfig, not per-endpoint.
127
+ */
128
+ export declare function normalizeEndpointConfig(config: boolean | SkillsConfigEndpointConfig | undefined, defaultPath: string, parentAuth: SkillsConfigAuthMode, parentApiKeys?: string[]): NormalizedEndpointConfig;
129
+ /**
130
+ * Normalize skills HTTP options.
131
+ * Applies defaults and normalizes all endpoint configurations.
132
+ * Auth is applied from the top level to all endpoints.
133
+ */
134
+ export declare function normalizeSkillsConfigOptions(options: SkillsConfigOptionsInput | undefined): SkillsConfigOptions & {
135
+ normalizedLlmTxt: NormalizedEndpointConfig;
136
+ normalizedLlmFullTxt: NormalizedEndpointConfig;
137
+ normalizedApi: NormalizedEndpointConfig;
138
+ };
139
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../src/common/types/options/skills-http/schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;EAAqD,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;iBAG3C,CAAC;AAOH;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;iBAazC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWpC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE/F;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,EACxD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,oBAAoB,EAChC,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,wBAAwB,CAuB1B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,GAAG,mBAAmB,GAAG;IACjH,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,aAAa,EAAE,wBAAwB,CAAC;CACzC,CAsBA"}
@@ -0,0 +1,4 @@
1
+ export type { TransportOptionsInterface, TransportOptionsInput, ProtocolConfig, ProtocolPreset, PersistenceConfig, EventStoreConfig, SessionMode, SessionModeOption, PlatformMappingEntry, PlatformDetectionConfig, DistributedEnabled, } from './interfaces';
2
+ export { transportOptionsSchema, persistenceConfigSchema, eventStoreConfigSchema, PROTOCOL_PRESETS, expandProtocolConfig, toLegacyProtocolFlags, isDistributedMode, shouldCacheProviders, expandTransportConfig, } from './schema';
3
+ export type { TransportOptions, TransportPersistenceConfig, TransportPersistenceConfigInput, PlatformDetectionConfigType, DistributedConfigInput, LegacyProtocolFlags, ExpandedTransportConfig, } from './schema';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/common/types/options/transport/index.ts"],"names":[],"mappings":"AAMA,YAAY,EAEV,yBAAyB,EACzB,qBAAqB,EAErB,cAAc,EACd,cAAc,EAEd,iBAAiB,EAEjB,gBAAgB,EAEhB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EAEvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAKtB,OAAO,EAEL,sBAAsB,EAEtB,uBAAuB,EACvB,sBAAsB,EAEtB,gBAAgB,EAEhB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EAEV,gBAAgB,EAChB,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,sBAAsB,EAEtB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,UAAU,CAAC"}