@1mcp/agent 0.39.6 → 0.40.0-beta.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 (488) hide show
  1. package/README.md +14 -7
  2. package/build/admin/assets/{admin-BackendLogsWorkspace-BKavXT9B.js → admin-BackendLogsWorkspace-DnPzXW3E.js} +1 -1
  3. package/build/admin/assets/{admin-InstructionTemplatesWorkspace-CvG4EPdZ.js → admin-InstructionTemplatesWorkspace-B7beKEgz.js} +1 -1
  4. package/build/admin/assets/{admin-OAuthServicesWorkspace-BKqTW6r0.js → admin-OAuthServicesWorkspace-Bu74Bzt5.js} +1 -1
  5. package/build/admin/assets/{admin-PresetAuthoringWorkspace-BboJVBFl.js → admin-PresetAuthoringWorkspace-053b1zwU.js} +1 -1
  6. package/build/admin/assets/{admin-console-BwfDrlgF.js → admin-console-DVuqABnE.js} +3 -3
  7. package/build/admin/assets/admin-icons-wOzB38gm.js +1 -0
  8. package/build/admin/assets/admin-vendor-BLZ1Mauf.js +3 -0
  9. package/build/admin/assets/admin-vendor-BdHKHno1.js +1 -0
  10. package/build/admin/assets/admin-vendor-BqYiU41k.js +51 -0
  11. package/build/admin/assets/admin-vendor-C291Vs-N.js +3 -0
  12. package/build/admin/assets/admin-vendor-VzhcFgoy.js +1 -0
  13. package/build/admin/index.html +7 -5
  14. package/build/application/backendPreparationAdmission.d.ts +77 -0
  15. package/build/application/backendPreparationAdmission.d.ts.map +1 -0
  16. package/build/application/backendPreparationAdmission.js +423 -0
  17. package/build/application/backendPreparationAdmission.js.map +1 -0
  18. package/build/application/backendPreparationCoordinator.d.ts +122 -0
  19. package/build/application/backendPreparationCoordinator.d.ts.map +1 -0
  20. package/build/application/backendPreparationCoordinator.js +885 -0
  21. package/build/application/backendPreparationCoordinator.js.map +1 -0
  22. package/build/application/projectLifecycle.d.ts +49 -0
  23. package/build/application/projectLifecycle.d.ts.map +1 -0
  24. package/build/application/projectLifecycle.js +228 -0
  25. package/build/application/projectLifecycle.js.map +1 -0
  26. package/build/cli.d.ts.map +1 -1
  27. package/build/cli.js +39 -17
  28. package/build/cli.js.map +1 -1
  29. package/build/commands/admin/index.d.ts.map +1 -1
  30. package/build/commands/admin/index.js +2 -6
  31. package/build/commands/admin/index.js.map +1 -1
  32. package/build/commands/app/index.d.ts.map +1 -1
  33. package/build/commands/app/index.js +5 -17
  34. package/build/commands/app/index.js.map +1 -1
  35. package/build/commands/auth/index.d.ts.map +1 -1
  36. package/build/commands/auth/index.js +2 -7
  37. package/build/commands/auth/index.js.map +1 -1
  38. package/build/commands/bootstrap/bootstrap.d.ts +38 -0
  39. package/build/commands/bootstrap/bootstrap.d.ts.map +1 -0
  40. package/build/commands/bootstrap/bootstrap.js +265 -0
  41. package/build/commands/bootstrap/bootstrap.js.map +1 -0
  42. package/build/commands/bootstrap/bootstrapOwnership.d.ts +13 -0
  43. package/build/commands/bootstrap/bootstrapOwnership.d.ts.map +1 -0
  44. package/build/commands/bootstrap/bootstrapOwnership.js +112 -0
  45. package/build/commands/bootstrap/bootstrapOwnership.js.map +1 -0
  46. package/build/commands/bootstrap/index.d.ts +3 -0
  47. package/build/commands/bootstrap/index.d.ts.map +1 -0
  48. package/build/commands/bootstrap/index.js +22 -0
  49. package/build/commands/bootstrap/index.js.map +1 -0
  50. package/build/commands/cliSetup/index.d.ts.map +1 -1
  51. package/build/commands/cliSetup/index.js +3 -4
  52. package/build/commands/cliSetup/index.js.map +1 -1
  53. package/build/commands/cliSetup/installPreparationSkill.d.ts +8 -0
  54. package/build/commands/cliSetup/installPreparationSkill.d.ts.map +1 -0
  55. package/build/commands/cliSetup/installPreparationSkill.js +201 -0
  56. package/build/commands/cliSetup/installPreparationSkill.js.map +1 -0
  57. package/build/commands/cliSetup/preparationSkill.generated.d.ts +2 -0
  58. package/build/commands/cliSetup/preparationSkill.generated.d.ts.map +1 -0
  59. package/build/commands/cliSetup/preparationSkill.generated.js +8 -0
  60. package/build/commands/cliSetup/preparationSkill.generated.js.map +1 -0
  61. package/build/commands/cliSetup/setupFiles.d.ts +5 -1
  62. package/build/commands/cliSetup/setupFiles.d.ts.map +1 -1
  63. package/build/commands/cliSetup/setupFiles.js +54 -37
  64. package/build/commands/cliSetup/setupFiles.js.map +1 -1
  65. package/build/commands/inspect/index.d.ts.map +1 -1
  66. package/build/commands/inspect/index.js +4 -4
  67. package/build/commands/inspect/index.js.map +1 -1
  68. package/build/commands/inspect/inspect.d.ts +2 -1
  69. package/build/commands/inspect/inspect.d.ts.map +1 -1
  70. package/build/commands/inspect/inspect.js +10 -5
  71. package/build/commands/inspect/inspect.js.map +1 -1
  72. package/build/commands/inspect/inspectUtils.js +3 -0
  73. package/build/commands/inspect/inspectUtils.js.map +1 -1
  74. package/build/commands/instructions/index.d.ts.map +1 -1
  75. package/build/commands/instructions/index.js +8 -3
  76. package/build/commands/instructions/index.js.map +1 -1
  77. package/build/commands/instructions/instructions.d.ts +3 -1
  78. package/build/commands/instructions/instructions.d.ts.map +1 -1
  79. package/build/commands/instructions/instructions.js +24 -0
  80. package/build/commands/instructions/instructions.js.map +1 -1
  81. package/build/commands/instructions/instructionsUtils.d.ts +2 -0
  82. package/build/commands/instructions/instructionsUtils.d.ts.map +1 -1
  83. package/build/commands/instructions/instructionsUtils.js +14 -4
  84. package/build/commands/instructions/instructionsUtils.js.map +1 -1
  85. package/build/commands/mcp/index.d.ts.map +1 -1
  86. package/build/commands/mcp/index.js +16 -21
  87. package/build/commands/mcp/index.js.map +1 -1
  88. package/build/commands/mcp/installSource.d.ts +3 -1
  89. package/build/commands/mcp/installSource.d.ts.map +1 -1
  90. package/build/commands/mcp/installSource.js +2 -2
  91. package/build/commands/mcp/installSource.js.map +1 -1
  92. package/build/commands/mcp/knownServerSetup.d.ts +4 -0
  93. package/build/commands/mcp/knownServerSetup.d.ts.map +1 -0
  94. package/build/commands/mcp/knownServerSetup.js +102 -0
  95. package/build/commands/mcp/knownServerSetup.js.map +1 -0
  96. package/build/commands/mcp/setup.d.ts +28 -0
  97. package/build/commands/mcp/setup.d.ts.map +1 -0
  98. package/build/commands/mcp/setup.js +56 -0
  99. package/build/commands/mcp/setup.js.map +1 -0
  100. package/build/commands/mcp/tools.d.ts.map +1 -1
  101. package/build/commands/mcp/tools.js +3 -3
  102. package/build/commands/mcp/tools.js.map +1 -1
  103. package/build/commands/preparation/index.d.ts +3 -0
  104. package/build/commands/preparation/index.d.ts.map +1 -0
  105. package/build/commands/preparation/index.js +55 -0
  106. package/build/commands/preparation/index.js.map +1 -0
  107. package/build/commands/preparation/preparation.d.ts +18 -0
  108. package/build/commands/preparation/preparation.d.ts.map +1 -0
  109. package/build/commands/preparation/preparation.js +102 -0
  110. package/build/commands/preparation/preparation.js.map +1 -0
  111. package/build/commands/preset/index.d.ts.map +1 -1
  112. package/build/commands/preset/index.js +4 -51
  113. package/build/commands/preset/index.js.map +1 -1
  114. package/build/commands/project/index.d.ts +3 -0
  115. package/build/commands/project/index.d.ts.map +1 -0
  116. package/build/commands/project/index.js +40 -0
  117. package/build/commands/project/index.js.map +1 -0
  118. package/build/commands/project/project.d.ts +34 -0
  119. package/build/commands/project/project.d.ts.map +1 -0
  120. package/build/commands/project/project.js +119 -0
  121. package/build/commands/project/project.js.map +1 -0
  122. package/build/commands/proxy/index.d.ts +2 -1
  123. package/build/commands/proxy/index.d.ts.map +1 -1
  124. package/build/commands/proxy/index.js +6 -46
  125. package/build/commands/proxy/index.js.map +1 -1
  126. package/build/commands/proxy/proxy.d.ts.map +1 -1
  127. package/build/commands/proxy/proxy.js +7 -1
  128. package/build/commands/proxy/proxy.js.map +1 -1
  129. package/build/commands/registry/index.d.ts.map +1 -1
  130. package/build/commands/registry/index.js +16 -20
  131. package/build/commands/registry/index.js.map +1 -1
  132. package/build/commands/run/index.d.ts.map +1 -1
  133. package/build/commands/run/index.js +9 -3
  134. package/build/commands/run/index.js.map +1 -1
  135. package/build/commands/run/run.d.ts +4 -1
  136. package/build/commands/run/run.d.ts.map +1 -1
  137. package/build/commands/run/run.js +80 -14
  138. package/build/commands/run/run.js.map +1 -1
  139. package/build/commands/serve/cooperativeRuntime.d.ts.map +1 -1
  140. package/build/commands/serve/cooperativeRuntime.js +2 -1
  141. package/build/commands/serve/cooperativeRuntime.js.map +1 -1
  142. package/build/commands/serve/index.d.ts.map +1 -1
  143. package/build/commands/serve/index.js +57 -39
  144. package/build/commands/serve/index.js.map +1 -1
  145. package/build/commands/shared/agentSession.d.ts +5 -0
  146. package/build/commands/shared/agentSession.d.ts.map +1 -0
  147. package/build/commands/shared/agentSession.js +75 -0
  148. package/build/commands/shared/agentSession.js.map +1 -0
  149. package/build/commands/shared/apiClient.d.ts +2 -0
  150. package/build/commands/shared/apiClient.d.ts.map +1 -1
  151. package/build/commands/shared/apiClient.js +10 -6
  152. package/build/commands/shared/apiClient.js.map +1 -1
  153. package/build/commands/shared/cliContext.d.ts +2 -1
  154. package/build/commands/shared/cliContext.d.ts.map +1 -1
  155. package/build/commands/shared/cliContext.js +2 -1
  156. package/build/commands/shared/cliContext.js.map +1 -1
  157. package/build/commands/shared/clientSurfaceAttachment.d.ts +7 -1
  158. package/build/commands/shared/clientSurfaceAttachment.d.ts.map +1 -1
  159. package/build/commands/shared/clientSurfaceAttachment.js +221 -140
  160. package/build/commands/shared/clientSurfaceAttachment.js.map +1 -1
  161. package/build/commands/shared/projectOwnerStorage.d.ts +8 -0
  162. package/build/commands/shared/projectOwnerStorage.d.ts.map +1 -0
  163. package/build/commands/shared/projectOwnerStorage.js +63 -0
  164. package/build/commands/shared/projectOwnerStorage.js.map +1 -0
  165. package/build/commands/shared/projectOwnerStore.d.ts +78 -0
  166. package/build/commands/shared/projectOwnerStore.d.ts.map +1 -0
  167. package/build/commands/shared/projectOwnerStore.js +482 -0
  168. package/build/commands/shared/projectOwnerStore.js.map +1 -0
  169. package/build/commands/shared/projectSelectionOptions.d.ts +24 -0
  170. package/build/commands/shared/projectSelectionOptions.d.ts.map +1 -0
  171. package/build/commands/shared/projectSelectionOptions.js +20 -0
  172. package/build/commands/shared/projectSelectionOptions.js.map +1 -0
  173. package/build/commands/shared/serveTargetResolver.d.ts +7 -1
  174. package/build/commands/shared/serveTargetResolver.d.ts.map +1 -1
  175. package/build/commands/shared/serveTargetResolver.js +99 -4
  176. package/build/commands/shared/serveTargetResolver.js.map +1 -1
  177. package/build/commands/target/index.d.ts.map +1 -1
  178. package/build/commands/target/index.js +6 -13
  179. package/build/commands/target/index.js.map +1 -1
  180. package/build/commands/wait/index.d.ts.map +1 -1
  181. package/build/commands/wait/index.js +3 -3
  182. package/build/commands/wait/index.js.map +1 -1
  183. package/build/commands/wait/wait.d.ts +2 -1
  184. package/build/commands/wait/wait.d.ts.map +1 -1
  185. package/build/commands/wait/wait.js.map +1 -1
  186. package/build/config/configLoader.d.ts.map +1 -1
  187. package/build/config/configLoader.js +5 -1
  188. package/build/config/configLoader.js.map +1 -1
  189. package/build/config/configManager.d.ts.map +1 -1
  190. package/build/config/configManager.js +5 -1
  191. package/build/config/configManager.js.map +1 -1
  192. package/build/config/projectConfigLoader.d.ts +4 -0
  193. package/build/config/projectConfigLoader.d.ts.map +1 -1
  194. package/build/config/projectConfigLoader.js +129 -28
  195. package/build/config/projectConfigLoader.js.map +1 -1
  196. package/build/config/projectConfigTypes.d.ts +7 -0
  197. package/build/config/projectConfigTypes.d.ts.map +1 -1
  198. package/build/config/projectConfigTypes.js +1 -0
  199. package/build/config/projectConfigTypes.js.map +1 -1
  200. package/build/constants/cliTimeouts.d.ts +4 -0
  201. package/build/constants/cliTimeouts.d.ts.map +1 -0
  202. package/build/constants/cliTimeouts.js +4 -0
  203. package/build/constants/cliTimeouts.js.map +1 -0
  204. package/build/constants/mcp.d.ts +1 -1
  205. package/build/constants/mcp.d.ts.map +1 -1
  206. package/build/constants/mcp.js +1 -1
  207. package/build/constants/mcp.js.map +1 -1
  208. package/build/core/capabilities/capabilityCatalog.d.ts +7 -0
  209. package/build/core/capabilities/capabilityCatalog.d.ts.map +1 -1
  210. package/build/core/capabilities/capabilityCatalog.js +58 -2
  211. package/build/core/capabilities/capabilityCatalog.js.map +1 -1
  212. package/build/core/capabilities/capabilityPagination.d.ts +12 -4
  213. package/build/core/capabilities/capabilityPagination.d.ts.map +1 -1
  214. package/build/core/capabilities/capabilityPagination.js +15 -2
  215. package/build/core/capabilities/capabilityPagination.js.map +1 -1
  216. package/build/core/capabilities/capabilityVisibility.d.ts +3 -0
  217. package/build/core/capabilities/capabilityVisibility.d.ts.map +1 -1
  218. package/build/core/capabilities/capabilityVisibility.js.map +1 -1
  219. package/build/core/capabilities/lazyLoadingOrchestrator.d.ts +2 -1
  220. package/build/core/capabilities/lazyLoadingOrchestrator.d.ts.map +1 -1
  221. package/build/core/capabilities/lazyLoadingOrchestrator.js +2 -2
  222. package/build/core/capabilities/lazyLoadingOrchestrator.js.map +1 -1
  223. package/build/core/capabilities/metaToolProvider.d.ts +2 -2
  224. package/build/core/capabilities/metaToolProvider.d.ts.map +1 -1
  225. package/build/core/capabilities/metaToolProvider.js +2 -2
  226. package/build/core/capabilities/metaToolProvider.js.map +1 -1
  227. package/build/core/capabilities/runtimeCapabilityCatalog.d.ts +1 -0
  228. package/build/core/capabilities/runtimeCapabilityCatalog.d.ts.map +1 -1
  229. package/build/core/capabilities/runtimeCapabilityCatalog.js +23 -9
  230. package/build/core/capabilities/runtimeCapabilityCatalog.js.map +1 -1
  231. package/build/core/context/projectOwner.d.ts +16 -0
  232. package/build/core/context/projectOwner.d.ts.map +1 -0
  233. package/build/core/context/projectOwner.js +33 -0
  234. package/build/core/context/projectOwner.js.map +1 -0
  235. package/build/core/context/projectPreparationAuthority.d.ts +37 -0
  236. package/build/core/context/projectPreparationAuthority.d.ts.map +1 -0
  237. package/build/core/context/projectPreparationAuthority.js +113 -0
  238. package/build/core/context/projectPreparationAuthority.js.map +1 -0
  239. package/build/core/instructions/inspectionGuidance.d.ts +2 -0
  240. package/build/core/instructions/inspectionGuidance.d.ts.map +1 -0
  241. package/build/core/instructions/inspectionGuidance.js +2 -0
  242. package/build/core/instructions/inspectionGuidance.js.map +1 -0
  243. package/build/core/instructions/instructionAggregator.d.ts +1 -0
  244. package/build/core/instructions/instructionAggregator.d.ts.map +1 -1
  245. package/build/core/instructions/instructionAggregator.js +2 -2
  246. package/build/core/instructions/instructionAggregator.js.map +1 -1
  247. package/build/core/instructions/instructionsDistribution.d.ts +5 -0
  248. package/build/core/instructions/instructionsDistribution.d.ts.map +1 -1
  249. package/build/core/instructions/instructionsDistribution.js +72 -15
  250. package/build/core/instructions/instructionsDistribution.js.map +1 -1
  251. package/build/core/instructions/preparationGuidance.d.ts +3 -0
  252. package/build/core/instructions/preparationGuidance.d.ts.map +1 -0
  253. package/build/core/instructions/preparationGuidance.js +14 -0
  254. package/build/core/instructions/preparationGuidance.js.map +1 -0
  255. package/build/core/instructions/sessionGuidance.d.ts +3 -0
  256. package/build/core/instructions/sessionGuidance.d.ts.map +1 -0
  257. package/build/core/instructions/sessionGuidance.js +25 -0
  258. package/build/core/instructions/sessionGuidance.js.map +1 -0
  259. package/build/core/instructions/templateTypes.d.ts +3 -1
  260. package/build/core/instructions/templateTypes.d.ts.map +1 -1
  261. package/build/core/instructions/templateTypes.js +15 -5
  262. package/build/core/instructions/templateTypes.js.map +1 -1
  263. package/build/core/protocol/requestHandlerUtils.d.ts.map +1 -1
  264. package/build/core/protocol/requestHandlerUtils.js +23 -4
  265. package/build/core/protocol/requestHandlerUtils.js.map +1 -1
  266. package/build/core/server/connectionResolver.d.ts +5 -0
  267. package/build/core/server/connectionResolver.d.ts.map +1 -1
  268. package/build/core/server/connectionResolver.js +11 -0
  269. package/build/core/server/connectionResolver.js.map +1 -1
  270. package/build/core/server/runtimeLaunchIpc.d.ts +167 -2
  271. package/build/core/server/runtimeLaunchIpc.d.ts.map +1 -1
  272. package/build/core/server/runtimeReplacementConfig.d.ts +167 -2
  273. package/build/core/server/runtimeReplacementConfig.d.ts.map +1 -1
  274. package/build/core/tools/handlers/serverManagementHandler.d.ts +413 -7
  275. package/build/core/tools/handlers/serverManagementHandler.d.ts.map +1 -1
  276. package/build/core/tools/internal/adapters/helpers/configTransformers.d.ts +59 -1
  277. package/build/core/tools/internal/adapters/helpers/configTransformers.d.ts.map +1 -1
  278. package/build/core/types/server.d.ts +7 -1
  279. package/build/core/types/server.d.ts.map +1 -1
  280. package/build/core/types/transport.d.ts +249 -3
  281. package/build/core/types/transport.d.ts.map +1 -1
  282. package/build/core/types/transport.js +27 -0
  283. package/build/core/types/transport.js.map +1 -1
  284. package/build/domains/admin/adminInstructionPreviewRuntime.d.ts.map +1 -1
  285. package/build/domains/admin/adminInstructionPreviewRuntime.js +4 -1
  286. package/build/domains/admin/adminInstructionPreviewRuntime.js.map +1 -1
  287. package/build/domains/backend-preparation/adapterRegistry.d.ts +8 -0
  288. package/build/domains/backend-preparation/adapterRegistry.d.ts.map +1 -0
  289. package/build/domains/backend-preparation/adapterRegistry.js +15 -0
  290. package/build/domains/backend-preparation/adapterRegistry.js.map +1 -0
  291. package/build/domains/backend-preparation/builtInIntegrationDefinitions.d.ts +4 -0
  292. package/build/domains/backend-preparation/builtInIntegrationDefinitions.d.ts.map +1 -0
  293. package/build/domains/backend-preparation/builtInIntegrationDefinitions.js +3 -0
  294. package/build/domains/backend-preparation/builtInIntegrationDefinitions.js.map +1 -0
  295. package/build/domains/backend-preparation/configuredCommandAdapter.d.ts +88 -0
  296. package/build/domains/backend-preparation/configuredCommandAdapter.d.ts.map +1 -0
  297. package/build/domains/backend-preparation/configuredCommandAdapter.js +196 -0
  298. package/build/domains/backend-preparation/configuredCommandAdapter.js.map +1 -0
  299. package/build/domains/backend-preparation/configuredCommandProcess.d.ts +27 -0
  300. package/build/domains/backend-preparation/configuredCommandProcess.d.ts.map +1 -0
  301. package/build/domains/backend-preparation/configuredCommandProcess.js +183 -0
  302. package/build/domains/backend-preparation/configuredCommandProcess.js.map +1 -0
  303. package/build/domains/backend-preparation/contracts.d.ts +131 -0
  304. package/build/domains/backend-preparation/contracts.d.ts.map +1 -0
  305. package/build/domains/backend-preparation/contracts.js +2 -0
  306. package/build/domains/backend-preparation/contracts.js.map +1 -0
  307. package/build/domains/backend-preparation/integrationDefinitions.d.ts +171 -0
  308. package/build/domains/backend-preparation/integrationDefinitions.d.ts.map +1 -0
  309. package/build/domains/backend-preparation/integrationDefinitions.js +246 -0
  310. package/build/domains/backend-preparation/integrationDefinitions.js.map +1 -0
  311. package/build/domains/backend-preparation/policy.d.ts +50 -0
  312. package/build/domains/backend-preparation/policy.d.ts.map +1 -0
  313. package/build/domains/backend-preparation/policy.js +58 -0
  314. package/build/domains/backend-preparation/policy.js.map +1 -0
  315. package/build/domains/backend-preparation/scheduler.d.ts +18 -0
  316. package/build/domains/backend-preparation/scheduler.d.ts.map +1 -0
  317. package/build/domains/backend-preparation/scheduler.js +62 -0
  318. package/build/domains/backend-preparation/scheduler.js.map +1 -0
  319. package/build/domains/backend-preparation/service.d.ts +67 -0
  320. package/build/domains/backend-preparation/service.d.ts.map +1 -0
  321. package/build/domains/backend-preparation/service.js +709 -0
  322. package/build/domains/backend-preparation/service.js.map +1 -0
  323. package/build/domains/config-change/configChange.js +5 -5
  324. package/build/domains/config-change/configChange.js.map +1 -1
  325. package/build/domains/installation/knownServerCatalog.d.ts +14 -0
  326. package/build/domains/installation/knownServerCatalog.d.ts.map +1 -0
  327. package/build/domains/installation/knownServerCatalog.js +56 -0
  328. package/build/domains/installation/knownServerCatalog.js.map +1 -0
  329. package/build/domains/installation/knownServerSetup.d.ts +21 -0
  330. package/build/domains/installation/knownServerSetup.d.ts.map +1 -0
  331. package/build/domains/installation/knownServerSetup.js +330 -0
  332. package/build/domains/installation/knownServerSetup.js.map +1 -0
  333. package/build/domains/installation/knownServerSetupTypes.d.ts +34 -0
  334. package/build/domains/installation/knownServerSetupTypes.d.ts.map +1 -0
  335. package/build/domains/installation/knownServerSetupTypes.js +2 -0
  336. package/build/domains/installation/knownServerSetupTypes.js.map +1 -0
  337. package/build/domains/project-selection/projectBindingScope.d.ts +7 -0
  338. package/build/domains/project-selection/projectBindingScope.d.ts.map +1 -0
  339. package/build/domains/project-selection/projectBindingScope.js +9 -0
  340. package/build/domains/project-selection/projectBindingScope.js.map +1 -0
  341. package/build/domains/project-selection/projectPolicy.d.ts +11 -0
  342. package/build/domains/project-selection/projectPolicy.d.ts.map +1 -0
  343. package/build/domains/project-selection/projectPolicy.js +104 -0
  344. package/build/domains/project-selection/projectPolicy.js.map +1 -0
  345. package/build/domains/project-selection/projectSelection.d.ts +30 -0
  346. package/build/domains/project-selection/projectSelection.d.ts.map +1 -0
  347. package/build/domains/project-selection/projectSelection.js +124 -0
  348. package/build/domains/project-selection/projectSelection.js.map +1 -0
  349. package/build/globalOptions.d.ts +9 -0
  350. package/build/globalOptions.d.ts.map +1 -1
  351. package/build/globalOptions.js +13 -11
  352. package/build/globalOptions.js.map +1 -1
  353. package/build/observability/events/registry.d.ts +7 -1
  354. package/build/observability/events/registry.d.ts.map +1 -1
  355. package/build/observability/events/registry.js +7 -1
  356. package/build/observability/events/registry.js.map +1 -1
  357. package/build/sdk/legacy/client/runtime/backendDispatchLifetime.d.ts.map +1 -1
  358. package/build/sdk/legacy/client/runtime/backendDispatchLifetime.js +8 -2
  359. package/build/sdk/legacy/client/runtime/backendDispatchLifetime.js.map +1 -1
  360. package/build/sdk/legacy/client/runtime/legacyTransport.d.ts +2 -0
  361. package/build/sdk/legacy/client/runtime/legacyTransport.d.ts.map +1 -1
  362. package/build/sdk/legacy/client/runtime/serveClient.d.ts +6 -1
  363. package/build/sdk/legacy/client/runtime/serveClient.d.ts.map +1 -1
  364. package/build/sdk/legacy/client/runtime/serveClient.js +16 -5
  365. package/build/sdk/legacy/client/runtime/serveClient.js.map +1 -1
  366. package/build/sdk/legacy/commands/serve.d.ts.map +1 -1
  367. package/build/sdk/legacy/commands/serve.js +11 -5
  368. package/build/sdk/legacy/commands/serve.js.map +1 -1
  369. package/build/sdk/legacy/server/protocol/projectAdmission.d.ts +4 -0
  370. package/build/sdk/legacy/server/protocol/projectAdmission.d.ts.map +1 -0
  371. package/build/sdk/legacy/server/protocol/projectAdmission.js +24 -0
  372. package/build/sdk/legacy/server/protocol/projectAdmission.js.map +1 -0
  373. package/build/sdk/legacy/server/protocol/promptRequestHandlers.d.ts.map +1 -1
  374. package/build/sdk/legacy/server/protocol/promptRequestHandlers.js +6 -3
  375. package/build/sdk/legacy/server/protocol/promptRequestHandlers.js.map +1 -1
  376. package/build/sdk/legacy/server/protocol/resourceRequestHandlers.d.ts.map +1 -1
  377. package/build/sdk/legacy/server/protocol/resourceRequestHandlers.js +6 -4
  378. package/build/sdk/legacy/server/protocol/resourceRequestHandlers.js.map +1 -1
  379. package/build/sdk/legacy/server/protocol/resourceSubscriptions.d.ts +1 -1
  380. package/build/sdk/legacy/server/protocol/resourceSubscriptions.d.ts.map +1 -1
  381. package/build/sdk/legacy/server/protocol/resourceSubscriptions.js +193 -41
  382. package/build/sdk/legacy/server/protocol/resourceSubscriptions.js.map +1 -1
  383. package/build/sdk/legacy/server/protocol/toolRequestHandlers.d.ts.map +1 -1
  384. package/build/sdk/legacy/server/protocol/toolRequestHandlers.js +93 -17
  385. package/build/sdk/legacy/server/protocol/toolRequestHandlers.js.map +1 -1
  386. package/build/sdk/legacy/server/runtime/clientInstancePool.d.ts +12 -0
  387. package/build/sdk/legacy/server/runtime/clientInstancePool.d.ts.map +1 -1
  388. package/build/sdk/legacy/server/runtime/clientInstancePool.js +117 -4
  389. package/build/sdk/legacy/server/runtime/clientInstancePool.js.map +1 -1
  390. package/build/sdk/legacy/server/runtime/connectionManager.d.ts.map +1 -1
  391. package/build/sdk/legacy/server/runtime/connectionManager.js +2 -0
  392. package/build/sdk/legacy/server/runtime/connectionManager.js.map +1 -1
  393. package/build/sdk/legacy/server/runtime/requestContextPreparation.d.ts +19 -1
  394. package/build/sdk/legacy/server/runtime/requestContextPreparation.d.ts.map +1 -1
  395. package/build/sdk/legacy/server/runtime/requestContextPreparation.js +40 -7
  396. package/build/sdk/legacy/server/runtime/requestContextPreparation.js.map +1 -1
  397. package/build/sdk/legacy/server/runtime/serverManager.d.ts +6 -2
  398. package/build/sdk/legacy/server/runtime/serverManager.d.ts.map +1 -1
  399. package/build/sdk/legacy/server/runtime/serverManager.js +85 -17
  400. package/build/sdk/legacy/server/runtime/serverManager.js.map +1 -1
  401. package/build/sdk/legacy/server/runtime/templateServerManager.d.ts +26 -4
  402. package/build/sdk/legacy/server/runtime/templateServerManager.d.ts.map +1 -1
  403. package/build/sdk/legacy/server/runtime/templateServerManager.js +260 -14
  404. package/build/sdk/legacy/server/runtime/templateServerManager.js.map +1 -1
  405. package/build/sdk/legacy/transport/http/modernInboundLegacyBridge.js +1 -1
  406. package/build/sdk/legacy/transport/http/modernInboundLegacyBridge.js.map +1 -1
  407. package/build/sdk/legacy/transport/http/streamableSessionLifecycle.d.ts.map +1 -1
  408. package/build/sdk/legacy/transport/http/streamableSessionLifecycle.js +14 -3
  409. package/build/sdk/legacy/transport/http/streamableSessionLifecycle.js.map +1 -1
  410. package/build/sdk/legacy/transport/stdioProxyTransport.d.ts +1 -0
  411. package/build/sdk/legacy/transport/stdioProxyTransport.d.ts.map +1 -1
  412. package/build/sdk/legacy/transport/stdioProxyTransport.js +2 -0
  413. package/build/sdk/legacy/transport/stdioProxyTransport.js.map +1 -1
  414. package/build/template/handlebarsTemplateRenderer.d.ts.map +1 -1
  415. package/build/template/handlebarsTemplateRenderer.js +3 -0
  416. package/build/template/handlebarsTemplateRenderer.js.map +1 -1
  417. package/build/transport/http/middlewares/projectAdmission.d.ts +5 -0
  418. package/build/transport/http/middlewares/projectAdmission.d.ts.map +1 -0
  419. package/build/transport/http/middlewares/projectAdmission.js +33 -0
  420. package/build/transport/http/middlewares/projectAdmission.js.map +1 -0
  421. package/build/transport/http/routes/apiRoutes.d.ts.map +1 -1
  422. package/build/transport/http/routes/apiRoutes.js +4 -0
  423. package/build/transport/http/routes/apiRoutes.js.map +1 -1
  424. package/build/transport/http/routes/inspectHelpers.d.ts +1 -0
  425. package/build/transport/http/routes/inspectHelpers.d.ts.map +1 -1
  426. package/build/transport/http/routes/inspectHelpers.js +2 -0
  427. package/build/transport/http/routes/inspectHelpers.js.map +1 -1
  428. package/build/transport/http/routes/inspectRequestContext.d.ts +5 -2
  429. package/build/transport/http/routes/inspectRequestContext.d.ts.map +1 -1
  430. package/build/transport/http/routes/inspectRequestContext.js +41 -19
  431. package/build/transport/http/routes/inspectRequestContext.js.map +1 -1
  432. package/build/transport/http/routes/inspectRoutes.d.ts +11 -2
  433. package/build/transport/http/routes/inspectRoutes.d.ts.map +1 -1
  434. package/build/transport/http/routes/inspectRoutes.js +94 -24
  435. package/build/transport/http/routes/inspectRoutes.js.map +1 -1
  436. package/build/transport/http/routes/instructionsRoutes.d.ts.map +1 -1
  437. package/build/transport/http/routes/instructionsRoutes.js +20 -8
  438. package/build/transport/http/routes/instructionsRoutes.js.map +1 -1
  439. package/build/transport/http/routes/modernHttpRoutes.d.ts.map +1 -1
  440. package/build/transport/http/routes/modernHttpRoutes.js +96 -13
  441. package/build/transport/http/routes/modernHttpRoutes.js.map +1 -1
  442. package/build/transport/http/routes/modernInteractionBinding.d.ts.map +1 -1
  443. package/build/transport/http/routes/modernInteractionBinding.js +3 -9
  444. package/build/transport/http/routes/modernInteractionBinding.js.map +1 -1
  445. package/build/transport/http/routes/modernSubscriptions.d.ts.map +1 -1
  446. package/build/transport/http/routes/modernSubscriptions.js +7 -5
  447. package/build/transport/http/routes/modernSubscriptions.js.map +1 -1
  448. package/build/transport/http/routes/modernTemplateContext.d.ts +2 -1
  449. package/build/transport/http/routes/modernTemplateContext.d.ts.map +1 -1
  450. package/build/transport/http/routes/modernTemplateContext.js +14 -3
  451. package/build/transport/http/routes/modernTemplateContext.js.map +1 -1
  452. package/build/transport/http/routes/modernToolHeaderRegistry.d.ts.map +1 -1
  453. package/build/transport/http/routes/modernToolHeaderRegistry.js +2 -2
  454. package/build/transport/http/routes/modernToolHeaderRegistry.js.map +1 -1
  455. package/build/transport/http/routes/preparationRoutes.d.ts +26 -0
  456. package/build/transport/http/routes/preparationRoutes.d.ts.map +1 -0
  457. package/build/transport/http/routes/preparationRoutes.js +132 -0
  458. package/build/transport/http/routes/preparationRoutes.js.map +1 -0
  459. package/build/transport/http/routes/projectRoutes.d.ts +18 -0
  460. package/build/transport/http/routes/projectRoutes.d.ts.map +1 -0
  461. package/build/transport/http/routes/projectRoutes.js +159 -0
  462. package/build/transport/http/routes/projectRoutes.js.map +1 -0
  463. package/build/transport/http/routes/streamableHttpRoutes.d.ts.map +1 -1
  464. package/build/transport/http/routes/streamableHttpRoutes.js +24 -4
  465. package/build/transport/http/routes/streamableHttpRoutes.js.map +1 -1
  466. package/build/transport/http/routes/toolRoutes.d.ts.map +1 -1
  467. package/build/transport/http/routes/toolRoutes.js +163 -20
  468. package/build/transport/http/routes/toolRoutes.js.map +1 -1
  469. package/build/transport/http/utils/contextExtractor.d.ts +2 -0
  470. package/build/transport/http/utils/contextExtractor.d.ts.map +1 -1
  471. package/build/transport/http/utils/contextExtractor.js +11 -0
  472. package/build/transport/http/utils/contextExtractor.js.map +1 -1
  473. package/build/transport/http/utils/templateContextAuthority.d.ts +2 -0
  474. package/build/transport/http/utils/templateContextAuthority.d.ts.map +1 -1
  475. package/build/transport/http/utils/templateContextAuthority.js +23 -2
  476. package/build/transport/http/utils/templateContextAuthority.js.map +1 -1
  477. package/build/types/context.d.ts +13 -0
  478. package/build/types/context.d.ts.map +1 -1
  479. package/build/types/context.js.map +1 -1
  480. package/build/utils/cli/help.d.ts +7 -0
  481. package/build/utils/cli/help.d.ts.map +1 -0
  482. package/build/utils/cli/help.js +57 -0
  483. package/build/utils/cli/help.js.map +1 -0
  484. package/package.json +20 -22
  485. package/build/admin/assets/admin-icons-CYGTDZA5.js +0 -1
  486. package/build/admin/assets/admin-vendor-62eL-qdH.js +0 -1
  487. package/build/admin/assets/admin-vendor-BbMrl7MK.js +0 -3
  488. package/build/admin/assets/admin-vendor-DpjVwd81.js +0 -62
@@ -0,0 +1,58 @@
1
+ import { z } from 'zod';
2
+ export const PreparationOptionsSchema = z
3
+ .object({
4
+ concurrency: z.number().int().min(1).max(64).default(1),
5
+ queueCapacity: z.number().int().min(0).max(4096).default(16),
6
+ requestWaitMs: z.number().int().min(0).max(3_600_000).default(5_000),
7
+ executionDeadlineMs: z.number().int().min(1).max(86_400_000).default(120_000),
8
+ maxRecords: z.number().int().min(1).max(100_000).default(1024),
9
+ })
10
+ .strict();
11
+ export const BackendPolicySchema = z
12
+ .object({
13
+ allowedActions: z.array(z.enum(['initialize', 'sync', 'rebuild', 'install', 'paid'])).max(5),
14
+ executionDeadlineMs: z.number().int().min(1).max(86_400_000).optional(),
15
+ transientRetryLimit: z.number().int().min(0).max(3).optional(),
16
+ })
17
+ .strict();
18
+ export const PreparationTargetSchema = z
19
+ .object({
20
+ checkoutRoot: z.string().min(1),
21
+ backendName: z.string().min(1),
22
+ backendIdentity: z.string().min(1),
23
+ configurationKey: z.string().min(1),
24
+ })
25
+ .strict();
26
+ export function preparationKey(target, policy, options, operation) {
27
+ return JSON.stringify([
28
+ target.checkoutRoot,
29
+ target.backendName,
30
+ target.backendIdentity,
31
+ target.configurationKey,
32
+ operation,
33
+ [...new Set(policy.allowedActions)].sort(),
34
+ policy.executionDeadlineMs ?? options.executionDeadlineMs,
35
+ policy.transientRetryLimit ?? 0,
36
+ ]);
37
+ }
38
+ export const PreparationFailureSchema = z
39
+ .object({
40
+ code: z.string().min(1).max(256),
41
+ message: z.string().max(4096),
42
+ retryable: z.boolean(),
43
+ instructions: z.string().min(1).max(4096),
44
+ })
45
+ .strict();
46
+ export const BackendReadyReadinessSchema = z
47
+ .object({
48
+ state: z.literal('ready'),
49
+ evidence: z
50
+ .object({
51
+ freshness: z.enum(['current', 'stale', 'unknown']),
52
+ coverage: z.enum(['complete', 'partial', 'unknown']),
53
+ detail: z.string().max(4096),
54
+ })
55
+ .strict(),
56
+ })
57
+ .strict();
58
+ //# sourceMappingURL=policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/domains/backend-preparation/policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /** Runtime-global expensive-work bound. Running cancellation retains its slot until work settles. */
2
+ export declare class PreparationScheduler {
3
+ private readonly concurrency;
4
+ private readonly queueCapacity;
5
+ private active;
6
+ private readonly activeResources;
7
+ private readonly queue;
8
+ constructor(concurrency: number, queueCapacity: number);
9
+ schedule(id: string, run: (wasQueued: boolean) => Promise<void>, resourceKey?: string, beforeAdmission?: () => void): boolean;
10
+ cancelQueued(id: string): boolean;
11
+ counts(): {
12
+ active: number;
13
+ queued: number;
14
+ };
15
+ private start;
16
+ private drain;
17
+ }
18
+ //# sourceMappingURL=scheduler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/scheduler.ts"],"names":[],"mappings":"AASA,qGAAqG;AACrG,qBAAa,oBAAoB;IAM7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAG1B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM;IAKxC,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EAC1C,WAAW,SAAK,EAChB,eAAe,CAAC,EAAE,MAAM,IAAI,GAC3B,OAAO;IAcV,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOjC,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAI5C,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,KAAK;CAQd"}
@@ -0,0 +1,62 @@
1
+ import { PreparationOptionsSchema } from './policy.js';
2
+ /** Runtime-global expensive-work bound. Running cancellation retains its slot until work settles. */
3
+ export class PreparationScheduler {
4
+ concurrency;
5
+ queueCapacity;
6
+ active = 0;
7
+ activeResources = new Set();
8
+ queue = [];
9
+ constructor(concurrency, queueCapacity) {
10
+ this.concurrency = concurrency;
11
+ this.queueCapacity = queueCapacity;
12
+ PreparationOptionsSchema.parse({ concurrency, queueCapacity });
13
+ }
14
+ schedule(id, run, resourceKey = id, beforeAdmission) {
15
+ if (this.active < this.concurrency) {
16
+ if (!this.activeResources.has(resourceKey)) {
17
+ beforeAdmission?.();
18
+ this.start({ id, run, resourceKey, wasQueued: false });
19
+ return true;
20
+ }
21
+ }
22
+ if (this.queue.length >= this.queueCapacity)
23
+ return false;
24
+ beforeAdmission?.();
25
+ this.queue.push({ id, run, resourceKey, wasQueued: true });
26
+ return true;
27
+ }
28
+ cancelQueued(id) {
29
+ const index = this.queue.findIndex((work) => work.id === id);
30
+ if (index < 0)
31
+ return false;
32
+ this.queue.splice(index, 1);
33
+ return true;
34
+ }
35
+ counts() {
36
+ return { active: this.active, queued: this.queue.length };
37
+ }
38
+ start(work) {
39
+ this.active++;
40
+ this.activeResources.add(work.resourceKey);
41
+ void Promise.resolve()
42
+ .then(() => work.run(work.wasQueued))
43
+ .finally(() => {
44
+ this.active--;
45
+ this.activeResources.delete(work.resourceKey);
46
+ this.drain();
47
+ })
48
+ .catch(() => {
49
+ /* A failing work item must still release its slot. */
50
+ });
51
+ }
52
+ drain() {
53
+ while (this.active < this.concurrency) {
54
+ const index = this.queue.findIndex((work) => !this.activeResources.has(work.resourceKey));
55
+ if (index < 0)
56
+ return;
57
+ const [next] = this.queue.splice(index, 1);
58
+ this.start(next);
59
+ }
60
+ }
61
+ }
62
+ //# sourceMappingURL=scheduler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../src/domains/backend-preparation/scheduler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,67 @@
1
+ import { PreparationAdapterRegistry } from './adapterRegistry.js';
2
+ import type { BackendPolicy, BackendReadiness, PreparationAction, PreparationAdmission, PreparationFailure, PreparationOptions, PreparationProgress, PreparationRecoveryHint, PreparationRequestOptions, PreparationResult, PreparationStatus, PreparationTarget, ProjectPreparationPreferences } from './contracts.js';
3
+ import { PreparationScheduler } from './scheduler.js';
4
+ export declare class BackendPreparationService {
5
+ private readonly registry;
6
+ readonly options: PreparationOptions;
7
+ readonly scheduler: PreparationScheduler;
8
+ private readonly jobs;
9
+ private readonly identities;
10
+ private sequence;
11
+ private shuttingDown;
12
+ constructor(registry: PreparationAdapterRegistry, options?: Partial<PreparationOptions>);
13
+ inspect(target: PreparationTarget, operation: string, options?: {
14
+ readonly waitMs?: number;
15
+ readonly signal?: AbortSignal;
16
+ }): Promise<BackendReadiness>;
17
+ /** Explicit status inspection is read-only and never admits, retries, or changes a job. */
18
+ inspectProgress(target: PreparationTarget, operation: string, options?: {
19
+ readonly waitMs?: number;
20
+ readonly signal?: AbortSignal;
21
+ }): Promise<PreparationProgress | undefined>;
22
+ /** Recovery only reconciles native evidence. A persisted running flag never starts or kills work. */
23
+ recover(target: PreparationTarget, operation: string, advisory: PreparationRecoveryHint, options?: {
24
+ readonly waitMs?: number;
25
+ readonly signal?: AbortSignal;
26
+ }): Promise<BackendReadiness>;
27
+ prepare(target: PreparationTarget, operation: string, policy: BackendPolicy, action?: PreparationAction, options?: PreparationRequestOptions): Promise<PreparationResult>;
28
+ private prepareInspected;
29
+ /** Never receives an operation callback, so pending calls cannot be queued or replayed. */
30
+ admit(target: PreparationTarget, operation: string, policy: BackendPolicy, preferences: ProjectPreparationPreferences, options?: PreparationRequestOptions): Promise<PreparationAdmission>;
31
+ private pending;
32
+ /** All admitted jobs, including automatic jobs with no public control handle. */
33
+ activeStatuses(): PreparationStatus[];
34
+ status(id: string): PreparationStatus | undefined;
35
+ wait(id: string, options?: {
36
+ readonly waitMs?: number;
37
+ readonly signal?: AbortSignal;
38
+ }): Promise<PreparationStatus | undefined>;
39
+ cancel(id: string): PreparationStatus | undefined;
40
+ /** Explicit retry creates a new compatible identity when the execution budget changes. */
41
+ retry(id: string, policy?: BackendPolicy, options?: PreparationRequestOptions): Promise<PreparationResult>;
42
+ /** Stop admission and wait for actual owned work settlement, including expired jobs. */
43
+ shutdown(): Promise<void>;
44
+ /** Only restores a validated stable failure; it confers no process ownership or repair authority. */
45
+ importFailure(target: PreparationTarget, operation: string, policy: BackendPolicy, action: PreparationAction, failure: PreparationFailure, state?: 'failed' | 'not_ready'): PreparationStatus | undefined;
46
+ /** Caller supplies fresh native evidence; advisory state alone cannot resolve a failure. */
47
+ clearResolvedFailure(target: PreparationTarget, operation: string, policy: BackendPolicy, readiness: Extract<BackendReadiness, {
48
+ state: 'ready';
49
+ }>): number;
50
+ private removeRecord;
51
+ private shutdownResult;
52
+ private execute;
53
+ private reconcileQueuedReadiness;
54
+ private moveActionIdentity;
55
+ private runAttempts;
56
+ private releaseCompletedRecords;
57
+ private failedJob;
58
+ private activeJob;
59
+ private probe;
60
+ private readReadiness;
61
+ private findJob;
62
+ private snapshot;
63
+ private update;
64
+ private terminal;
65
+ private unsupported;
66
+ }
67
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/service.ts"],"names":[],"mappings":"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"}