@backendkit-labs/agent-coding 0.28.5 → 0.30.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 (466) hide show
  1. package/README.md +4 -0
  2. package/dist/__tests__/cli-baseline.test.d.ts +2 -0
  3. package/dist/__tests__/cli-baseline.test.d.ts.map +1 -0
  4. package/dist/__tests__/cli-baseline.test.js +114 -0
  5. package/dist/__tests__/cli-baseline.test.js.map +1 -0
  6. package/dist/__tests__/context-hooks.test.d.ts +2 -0
  7. package/dist/__tests__/context-hooks.test.d.ts.map +1 -0
  8. package/dist/__tests__/context-hooks.test.js +21 -0
  9. package/dist/__tests__/context-hooks.test.js.map +1 -0
  10. package/dist/__tests__/createCodingEngine.forwarding.test.js +2 -1
  11. package/dist/__tests__/createCodingEngine.forwarding.test.js.map +1 -1
  12. package/dist/__tests__/sandbox.test.js +1 -1
  13. package/dist/__tests__/sandbox.test.js.map +1 -1
  14. package/dist/__tests__/workspace-trust.test.js +7 -5
  15. package/dist/__tests__/workspace-trust.test.js.map +1 -1
  16. package/dist/agents/AgentLoader.d.ts.map +1 -1
  17. package/dist/agents/AgentLoader.js +2 -1
  18. package/dist/agents/AgentLoader.js.map +1 -1
  19. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts +22 -0
  20. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts.map +1 -0
  21. package/dist/cli/agent-discovery/AgentPackageLoader.js +100 -0
  22. package/dist/cli/agent-discovery/AgentPackageLoader.js.map +1 -0
  23. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts +31 -0
  24. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts.map +1 -0
  25. package/dist/cli/agent-discovery/RemoteAgentRegistry.js +106 -0
  26. package/dist/cli/agent-discovery/RemoteAgentRegistry.js.map +1 -0
  27. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts +2 -0
  28. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts.map +1 -0
  29. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js +34 -0
  30. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js.map +1 -0
  31. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts +2 -0
  32. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts.map +1 -0
  33. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js +147 -0
  34. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js.map +1 -0
  35. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts +2 -0
  36. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts.map +1 -0
  37. package/dist/cli/agent-discovery/__tests__/download-guard.test.js +47 -0
  38. package/dist/cli/agent-discovery/__tests__/download-guard.test.js.map +1 -0
  39. package/dist/cli/agent-discovery/discoverAgents.d.ts +21 -0
  40. package/dist/cli/agent-discovery/discoverAgents.d.ts.map +1 -0
  41. package/dist/cli/agent-discovery/discoverAgents.js +74 -0
  42. package/dist/cli/agent-discovery/discoverAgents.js.map +1 -0
  43. package/dist/cli/agent-discovery/download-guard.d.ts +20 -0
  44. package/dist/cli/agent-discovery/download-guard.d.ts.map +1 -0
  45. package/dist/cli/agent-discovery/download-guard.js +84 -0
  46. package/dist/cli/agent-discovery/download-guard.js.map +1 -0
  47. package/dist/cli/agent-discovery/index.d.ts +5 -0
  48. package/dist/cli/agent-discovery/index.d.ts.map +1 -0
  49. package/dist/cli/agent-discovery/index.js +12 -0
  50. package/dist/cli/agent-discovery/index.js.map +1 -0
  51. package/dist/cli/agent-discovery/types.d.ts +48 -0
  52. package/dist/cli/agent-discovery/types.d.ts.map +1 -0
  53. package/dist/cli/agent-discovery/types.js +3 -0
  54. package/dist/cli/agent-discovery/types.js.map +1 -0
  55. package/dist/cli/bootstrap/GlobalSeed.d.ts +46 -0
  56. package/dist/cli/bootstrap/GlobalSeed.d.ts.map +1 -0
  57. package/dist/cli/bootstrap/GlobalSeed.js +285 -0
  58. package/dist/cli/bootstrap/GlobalSeed.js.map +1 -0
  59. package/dist/cli/bootstrap/config.d.ts +24 -0
  60. package/dist/cli/bootstrap/config.d.ts.map +1 -0
  61. package/dist/cli/bootstrap/config.js +71 -0
  62. package/dist/cli/bootstrap/config.js.map +1 -0
  63. package/dist/cli/checkpoint/index.d.ts +17 -0
  64. package/dist/cli/checkpoint/index.d.ts.map +1 -0
  65. package/dist/cli/checkpoint/index.js +207 -0
  66. package/dist/cli/checkpoint/index.js.map +1 -0
  67. package/dist/cli/commands/builtin.d.ts +7 -0
  68. package/dist/cli/commands/builtin.d.ts.map +1 -0
  69. package/dist/cli/commands/builtin.js +962 -0
  70. package/dist/cli/commands/builtin.js.map +1 -0
  71. package/dist/cli/context/__tests__/formatPipeline.test.d.ts +2 -0
  72. package/dist/cli/context/__tests__/formatPipeline.test.d.ts.map +1 -0
  73. package/dist/cli/context/__tests__/formatPipeline.test.js +25 -0
  74. package/dist/cli/context/__tests__/formatPipeline.test.js.map +1 -0
  75. package/dist/cli/context/index.d.ts +8 -0
  76. package/dist/cli/context/index.d.ts.map +1 -0
  77. package/dist/cli/context/index.js +8 -0
  78. package/dist/cli/context/index.js.map +1 -0
  79. package/dist/cli/context/pipeline.d.ts +46 -0
  80. package/dist/cli/context/pipeline.d.ts.map +1 -0
  81. package/dist/cli/context/pipeline.js +112 -0
  82. package/dist/cli/context/pipeline.js.map +1 -0
  83. package/dist/cli/context/stages/stage-instructions.d.ts +12 -0
  84. package/dist/cli/context/stages/stage-instructions.d.ts.map +1 -0
  85. package/dist/cli/context/stages/stage-instructions.js +76 -0
  86. package/dist/cli/context/stages/stage-instructions.js.map +1 -0
  87. package/dist/cli/context/stages/stage-lessons.d.ts +13 -0
  88. package/dist/cli/context/stages/stage-lessons.d.ts.map +1 -0
  89. package/dist/cli/context/stages/stage-lessons.js +83 -0
  90. package/dist/cli/context/stages/stage-lessons.js.map +1 -0
  91. package/dist/cli/context/stages/stage-manifest.d.ts +11 -0
  92. package/dist/cli/context/stages/stage-manifest.d.ts.map +1 -0
  93. package/dist/cli/context/stages/stage-manifest.js +62 -0
  94. package/dist/cli/context/stages/stage-manifest.js.map +1 -0
  95. package/dist/cli/context/stages/stage-project.d.ts +10 -0
  96. package/dist/cli/context/stages/stage-project.d.ts.map +1 -0
  97. package/dist/cli/context/stages/stage-project.js +55 -0
  98. package/dist/cli/context/stages/stage-project.js.map +1 -0
  99. package/dist/cli/context/stages/stage-session.d.ts +12 -0
  100. package/dist/cli/context/stages/stage-session.d.ts.map +1 -0
  101. package/dist/cli/context/stages/stage-session.js +69 -0
  102. package/dist/cli/context/stages/stage-session.js.map +1 -0
  103. package/dist/cli/file-sources.d.ts +17 -0
  104. package/dist/cli/file-sources.d.ts.map +1 -0
  105. package/dist/cli/file-sources.js +42 -0
  106. package/dist/cli/file-sources.js.map +1 -0
  107. package/dist/cli/index.d.ts +26 -0
  108. package/dist/cli/index.d.ts.map +1 -0
  109. package/dist/cli/index.js +55 -0
  110. package/dist/cli/index.js.map +1 -0
  111. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts +2 -0
  112. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts.map +1 -0
  113. package/dist/cli/skills/__tests__/SkillLoader.test.js +285 -0
  114. package/dist/cli/skills/__tests__/SkillLoader.test.js.map +1 -0
  115. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts +2 -0
  116. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts.map +1 -0
  117. package/dist/cli/skills/__tests__/SkillManager.safety.test.js +87 -0
  118. package/dist/cli/skills/__tests__/SkillManager.safety.test.js.map +1 -0
  119. package/dist/cli/skills/__tests__/stack.test.d.ts +2 -0
  120. package/dist/cli/skills/__tests__/stack.test.d.ts.map +1 -0
  121. package/dist/cli/skills/__tests__/stack.test.js +81 -0
  122. package/dist/cli/skills/__tests__/stack.test.js.map +1 -0
  123. package/dist/cli/skills/loader.d.ts +42 -0
  124. package/dist/cli/skills/loader.d.ts.map +1 -0
  125. package/dist/cli/skills/loader.js +158 -0
  126. package/dist/cli/skills/loader.js.map +1 -0
  127. package/dist/cli/skills/manager.d.ts +97 -0
  128. package/dist/cli/skills/manager.d.ts.map +1 -0
  129. package/dist/cli/skills/manager.js +304 -0
  130. package/dist/cli/skills/manager.js.map +1 -0
  131. package/dist/cli/skills/parse-md-skill.d.ts +14 -0
  132. package/dist/cli/skills/parse-md-skill.d.ts.map +1 -0
  133. package/dist/cli/skills/parse-md-skill.js +86 -0
  134. package/dist/cli/skills/parse-md-skill.js.map +1 -0
  135. package/dist/cli/skills/providers/github.d.ts +21 -0
  136. package/dist/cli/skills/providers/github.d.ts.map +1 -0
  137. package/dist/cli/skills/providers/github.js +146 -0
  138. package/dist/cli/skills/providers/github.js.map +1 -0
  139. package/dist/cli/skills/providers/index.d.ts +6 -0
  140. package/dist/cli/skills/providers/index.d.ts.map +1 -0
  141. package/dist/cli/skills/providers/index.js +12 -0
  142. package/dist/cli/skills/providers/index.js.map +1 -0
  143. package/dist/cli/skills/providers/local.d.ts +16 -0
  144. package/dist/cli/skills/providers/local.d.ts.map +1 -0
  145. package/dist/cli/skills/providers/local.js +91 -0
  146. package/dist/cli/skills/providers/local.js.map +1 -0
  147. package/dist/cli/skills/providers/obsidian.d.ts +31 -0
  148. package/dist/cli/skills/providers/obsidian.d.ts.map +1 -0
  149. package/dist/cli/skills/providers/obsidian.js +141 -0
  150. package/dist/cli/skills/providers/obsidian.js.map +1 -0
  151. package/dist/cli/skills/providers/skills-sh.d.ts +32 -0
  152. package/dist/cli/skills/providers/skills-sh.d.ts.map +1 -0
  153. package/dist/cli/skills/providers/skills-sh.js +53 -0
  154. package/dist/cli/skills/providers/skills-sh.js.map +1 -0
  155. package/dist/cli/skills/providers/types.d.ts +25 -0
  156. package/dist/cli/skills/providers/types.d.ts.map +1 -0
  157. package/dist/cli/skills/providers/types.js +3 -0
  158. package/dist/cli/skills/providers/types.js.map +1 -0
  159. package/dist/cli/skills/safe-name.d.ts +2 -0
  160. package/dist/cli/skills/safe-name.d.ts.map +1 -0
  161. package/dist/cli/skills/safe-name.js +22 -0
  162. package/dist/cli/skills/safe-name.js.map +1 -0
  163. package/dist/cli/skills/stack.d.ts +3 -0
  164. package/dist/cli/skills/stack.d.ts.map +1 -0
  165. package/dist/cli/skills/stack.js +64 -0
  166. package/dist/cli/skills/stack.js.map +1 -0
  167. package/dist/cli/skills/types.d.ts +28 -0
  168. package/dist/cli/skills/types.d.ts.map +1 -0
  169. package/dist/cli/skills/types.js +3 -0
  170. package/dist/cli/skills/types.js.map +1 -0
  171. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts +2 -0
  172. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts.map +1 -0
  173. package/dist/cli/trust/__tests__/workspace-trust.test.js +252 -0
  174. package/dist/cli/trust/__tests__/workspace-trust.test.js.map +1 -0
  175. package/dist/cli/trust/workspace-trust.d.ts +49 -0
  176. package/dist/cli/trust/workspace-trust.d.ts.map +1 -0
  177. package/dist/cli/trust/workspace-trust.js +163 -0
  178. package/dist/cli/trust/workspace-trust.js.map +1 -0
  179. package/dist/cli/workspace/index.d.ts +68 -0
  180. package/dist/cli/workspace/index.d.ts.map +1 -0
  181. package/dist/cli/workspace/index.js +231 -0
  182. package/dist/cli/workspace/index.js.map +1 -0
  183. package/dist/context-hooks.d.ts +11 -0
  184. package/dist/context-hooks.d.ts.map +1 -0
  185. package/dist/context-hooks.js +23 -0
  186. package/dist/context-hooks.js.map +1 -0
  187. package/dist/context-services.d.ts +12 -0
  188. package/dist/context-services.d.ts.map +1 -0
  189. package/dist/context-services.js +20 -0
  190. package/dist/context-services.js.map +1 -0
  191. package/dist/index.d.ts +5 -1
  192. package/dist/index.d.ts.map +1 -1
  193. package/dist/index.js +26 -12
  194. package/dist/index.js.map +1 -1
  195. package/dist/orchestration/capability-matrix.d.ts +1 -1
  196. package/dist/orchestration/capability-matrix.d.ts.map +1 -1
  197. package/dist/pipeline/__tests__/AgentEngine.orchestratorFailure.test.d.ts +2 -0
  198. package/dist/pipeline/__tests__/AgentEngine.orchestratorFailure.test.d.ts.map +1 -0
  199. package/dist/pipeline/__tests__/AgentEngine.orchestratorFailure.test.js +42 -0
  200. package/dist/pipeline/__tests__/AgentEngine.orchestratorFailure.test.js.map +1 -0
  201. package/dist/pipeline/__tests__/coding-pipeline-hooks.test.d.ts +2 -0
  202. package/dist/pipeline/__tests__/coding-pipeline-hooks.test.d.ts.map +1 -0
  203. package/dist/pipeline/__tests__/coding-pipeline-hooks.test.js +64 -0
  204. package/dist/pipeline/__tests__/coding-pipeline-hooks.test.js.map +1 -0
  205. package/dist/pipeline/__tests__/engine-brief.test.d.ts +2 -0
  206. package/dist/pipeline/__tests__/engine-brief.test.d.ts.map +1 -0
  207. package/dist/pipeline/__tests__/engine-brief.test.js +159 -0
  208. package/dist/pipeline/__tests__/engine-brief.test.js.map +1 -0
  209. package/dist/pipeline/__tests__/qa-orchestrator.test.d.ts +2 -0
  210. package/dist/pipeline/__tests__/qa-orchestrator.test.d.ts.map +1 -0
  211. package/dist/pipeline/__tests__/qa-orchestrator.test.js +276 -0
  212. package/dist/pipeline/__tests__/qa-orchestrator.test.js.map +1 -0
  213. package/dist/pipeline/coding-pipeline-hooks.d.ts +28 -0
  214. package/dist/pipeline/coding-pipeline-hooks.d.ts.map +1 -0
  215. package/dist/pipeline/coding-pipeline-hooks.js +91 -0
  216. package/dist/pipeline/coding-pipeline-hooks.js.map +1 -0
  217. package/dist/pipeline/index.d.ts +13 -0
  218. package/dist/pipeline/index.d.ts.map +1 -0
  219. package/dist/pipeline/index.js +44 -0
  220. package/dist/pipeline/index.js.map +1 -0
  221. package/dist/pipeline/orchestration/__tests__/agent-id-consistency.test.d.ts +11 -0
  222. package/dist/pipeline/orchestration/__tests__/agent-id-consistency.test.d.ts.map +1 -0
  223. package/dist/pipeline/orchestration/__tests__/agent-id-consistency.test.js +105 -0
  224. package/dist/pipeline/orchestration/__tests__/agent-id-consistency.test.js.map +1 -0
  225. package/dist/pipeline/orchestration/__tests__/fsm-commit-skipped.test.d.ts +2 -0
  226. package/dist/pipeline/orchestration/__tests__/fsm-commit-skipped.test.d.ts.map +1 -0
  227. package/dist/pipeline/orchestration/__tests__/fsm-commit-skipped.test.js +21 -0
  228. package/dist/pipeline/orchestration/__tests__/fsm-commit-skipped.test.js.map +1 -0
  229. package/dist/pipeline/orchestration/__tests__/fsm-critical-path.test.d.ts +9 -0
  230. package/dist/pipeline/orchestration/__tests__/fsm-critical-path.test.d.ts.map +1 -0
  231. package/dist/pipeline/orchestration/__tests__/fsm-critical-path.test.js +101 -0
  232. package/dist/pipeline/orchestration/__tests__/fsm-critical-path.test.js.map +1 -0
  233. package/dist/pipeline/orchestration/__tests__/fsm-rework-and-regression.test.d.ts +2 -0
  234. package/dist/pipeline/orchestration/__tests__/fsm-rework-and-regression.test.d.ts.map +1 -0
  235. package/dist/pipeline/orchestration/__tests__/fsm-rework-and-regression.test.js +54 -0
  236. package/dist/pipeline/orchestration/__tests__/fsm-rework-and-regression.test.js.map +1 -0
  237. package/dist/pipeline/orchestration/__tests__/intent-detector-llm.test.d.ts +2 -0
  238. package/dist/pipeline/orchestration/__tests__/intent-detector-llm.test.d.ts.map +1 -0
  239. package/dist/pipeline/orchestration/__tests__/intent-detector-llm.test.js +57 -0
  240. package/dist/pipeline/orchestration/__tests__/intent-detector-llm.test.js.map +1 -0
  241. package/dist/pipeline/orchestration/__tests__/intent-detector-scores.test.d.ts +9 -0
  242. package/dist/pipeline/orchestration/__tests__/intent-detector-scores.test.d.ts.map +1 -0
  243. package/dist/pipeline/orchestration/__tests__/intent-detector-scores.test.js +43 -0
  244. package/dist/pipeline/orchestration/__tests__/intent-detector-scores.test.js.map +1 -0
  245. package/dist/pipeline/orchestration/__tests__/reflection-cycle.test.d.ts +10 -0
  246. package/dist/pipeline/orchestration/__tests__/reflection-cycle.test.d.ts.map +1 -0
  247. package/dist/pipeline/orchestration/__tests__/reflection-cycle.test.js +264 -0
  248. package/dist/pipeline/orchestration/__tests__/reflection-cycle.test.js.map +1 -0
  249. package/dist/pipeline/orchestration/audit/audit-ci-blocker.d.ts +31 -0
  250. package/dist/pipeline/orchestration/audit/audit-ci-blocker.d.ts.map +1 -0
  251. package/dist/pipeline/orchestration/audit/audit-ci-blocker.js +120 -0
  252. package/dist/pipeline/orchestration/audit/audit-ci-blocker.js.map +1 -0
  253. package/dist/pipeline/orchestration/audit/audit-finding-tracer.d.ts +33 -0
  254. package/dist/pipeline/orchestration/audit/audit-finding-tracer.d.ts.map +1 -0
  255. package/dist/pipeline/orchestration/audit/audit-finding-tracer.js +126 -0
  256. package/dist/pipeline/orchestration/audit/audit-finding-tracer.js.map +1 -0
  257. package/dist/pipeline/orchestration/audit/audit-lessons-learned.d.ts +27 -0
  258. package/dist/pipeline/orchestration/audit/audit-lessons-learned.d.ts.map +1 -0
  259. package/dist/pipeline/orchestration/audit/audit-lessons-learned.js +155 -0
  260. package/dist/pipeline/orchestration/audit/audit-lessons-learned.js.map +1 -0
  261. package/dist/pipeline/orchestration/audit/audit-pending-issues.d.ts +21 -0
  262. package/dist/pipeline/orchestration/audit/audit-pending-issues.d.ts.map +1 -0
  263. package/dist/pipeline/orchestration/audit/audit-pending-issues.js +110 -0
  264. package/dist/pipeline/orchestration/audit/audit-pending-issues.js.map +1 -0
  265. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts +39 -0
  266. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts.map +1 -0
  267. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js +65 -0
  268. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js.map +1 -0
  269. package/dist/pipeline/orchestration/audit/audit-report-renderer.d.ts +30 -0
  270. package/dist/pipeline/orchestration/audit/audit-report-renderer.d.ts.map +1 -0
  271. package/dist/pipeline/orchestration/audit/audit-report-renderer.js +249 -0
  272. package/dist/pipeline/orchestration/audit/audit-report-renderer.js.map +1 -0
  273. package/dist/pipeline/orchestration/audit/audit-report-version-manager.d.ts +52 -0
  274. package/dist/pipeline/orchestration/audit/audit-report-version-manager.d.ts.map +1 -0
  275. package/dist/pipeline/orchestration/audit/audit-report-version-manager.js +144 -0
  276. package/dist/pipeline/orchestration/audit/audit-report-version-manager.js.map +1 -0
  277. package/dist/pipeline/orchestration/audit/audit-silent-gates-buffer.d.ts +37 -0
  278. package/dist/pipeline/orchestration/audit/audit-silent-gates-buffer.d.ts.map +1 -0
  279. package/dist/pipeline/orchestration/audit/audit-silent-gates-buffer.js +129 -0
  280. package/dist/pipeline/orchestration/audit/audit-silent-gates-buffer.js.map +1 -0
  281. package/dist/pipeline/orchestration/audit/index.d.ts +17 -0
  282. package/dist/pipeline/orchestration/audit/index.d.ts.map +1 -0
  283. package/dist/pipeline/orchestration/audit/index.js +26 -0
  284. package/dist/pipeline/orchestration/audit/index.js.map +1 -0
  285. package/dist/pipeline/orchestration/audit/types.d.ts +79 -0
  286. package/dist/pipeline/orchestration/audit/types.d.ts.map +1 -0
  287. package/dist/pipeline/orchestration/audit/types.js +10 -0
  288. package/dist/pipeline/orchestration/audit/types.js.map +1 -0
  289. package/dist/pipeline/orchestration/audit-reporter.d.ts +133 -0
  290. package/dist/pipeline/orchestration/audit-reporter.d.ts.map +1 -0
  291. package/dist/pipeline/orchestration/audit-reporter.js +322 -0
  292. package/dist/pipeline/orchestration/audit-reporter.js.map +1 -0
  293. package/dist/pipeline/orchestration/config-loader.d.ts +51 -0
  294. package/dist/pipeline/orchestration/config-loader.d.ts.map +1 -0
  295. package/dist/pipeline/orchestration/config-loader.js +215 -0
  296. package/dist/pipeline/orchestration/config-loader.js.map +1 -0
  297. package/dist/pipeline/orchestration/domain-detector.d.ts +36 -0
  298. package/dist/pipeline/orchestration/domain-detector.d.ts.map +1 -0
  299. package/dist/pipeline/orchestration/domain-detector.js +157 -0
  300. package/dist/pipeline/orchestration/domain-detector.js.map +1 -0
  301. package/dist/pipeline/orchestration/fsm.d.ts +92 -0
  302. package/dist/pipeline/orchestration/fsm.d.ts.map +1 -0
  303. package/dist/pipeline/orchestration/fsm.js +243 -0
  304. package/dist/pipeline/orchestration/fsm.js.map +1 -0
  305. package/dist/pipeline/orchestration/gate-resolver.d.ts +52 -0
  306. package/dist/pipeline/orchestration/gate-resolver.d.ts.map +1 -0
  307. package/dist/pipeline/orchestration/gate-resolver.js +120 -0
  308. package/dist/pipeline/orchestration/gate-resolver.js.map +1 -0
  309. package/dist/pipeline/orchestration/index.d.ts +16 -0
  310. package/dist/pipeline/orchestration/index.d.ts.map +1 -0
  311. package/dist/pipeline/orchestration/index.js +32 -0
  312. package/dist/pipeline/orchestration/index.js.map +1 -0
  313. package/dist/pipeline/orchestration/intent-detector.d.ts +37 -0
  314. package/dist/pipeline/orchestration/intent-detector.d.ts.map +1 -0
  315. package/dist/pipeline/orchestration/intent-detector.js +248 -0
  316. package/dist/pipeline/orchestration/intent-detector.js.map +1 -0
  317. package/dist/pipeline/orchestration/keyword-match.d.ts +17 -0
  318. package/dist/pipeline/orchestration/keyword-match.d.ts.map +1 -0
  319. package/dist/pipeline/orchestration/keyword-match.js +26 -0
  320. package/dist/pipeline/orchestration/keyword-match.js.map +1 -0
  321. package/dist/pipeline/orchestration/orchestrator.d.ts +158 -0
  322. package/dist/pipeline/orchestration/orchestrator.d.ts.map +1 -0
  323. package/dist/pipeline/orchestration/orchestrator.js +414 -0
  324. package/dist/pipeline/orchestration/orchestrator.js.map +1 -0
  325. package/dist/pipeline/orchestration/policy-engine.d.ts +54 -0
  326. package/dist/pipeline/orchestration/policy-engine.d.ts.map +1 -0
  327. package/dist/pipeline/orchestration/policy-engine.js +278 -0
  328. package/dist/pipeline/orchestration/policy-engine.js.map +1 -0
  329. package/dist/pipeline/orchestration/risk-scorer.d.ts +38 -0
  330. package/dist/pipeline/orchestration/risk-scorer.d.ts.map +1 -0
  331. package/dist/pipeline/orchestration/risk-scorer.js +145 -0
  332. package/dist/pipeline/orchestration/risk-scorer.js.map +1 -0
  333. package/dist/pipeline/orchestration/task-context.d.ts +205 -0
  334. package/dist/pipeline/orchestration/task-context.d.ts.map +1 -0
  335. package/dist/pipeline/orchestration/task-context.js +162 -0
  336. package/dist/pipeline/orchestration/task-context.js.map +1 -0
  337. package/dist/pipeline/orchestration/types.d.ts +111 -0
  338. package/dist/pipeline/orchestration/types.d.ts.map +1 -0
  339. package/dist/pipeline/orchestration/types.js +37 -0
  340. package/dist/pipeline/orchestration/types.js.map +1 -0
  341. package/dist/pipeline/qa/__tests__/QAService.test.d.ts +2 -0
  342. package/dist/pipeline/qa/__tests__/QAService.test.d.ts.map +1 -0
  343. package/dist/pipeline/qa/__tests__/QAService.test.js +170 -0
  344. package/dist/pipeline/qa/__tests__/QAService.test.js.map +1 -0
  345. package/dist/pipeline/qa/__tests__/QAService.verdict.test.d.ts +2 -0
  346. package/dist/pipeline/qa/__tests__/QAService.verdict.test.d.ts.map +1 -0
  347. package/dist/pipeline/qa/__tests__/QAService.verdict.test.js +39 -0
  348. package/dist/pipeline/qa/__tests__/QAService.verdict.test.js.map +1 -0
  349. package/dist/pipeline/qa/index.d.ts +3 -0
  350. package/dist/pipeline/qa/index.d.ts.map +1 -0
  351. package/dist/pipeline/qa/index.js +6 -0
  352. package/dist/pipeline/qa/index.js.map +1 -0
  353. package/dist/pipeline/qa/qa-service.d.ts +33 -0
  354. package/dist/pipeline/qa/qa-service.d.ts.map +1 -0
  355. package/dist/pipeline/qa/qa-service.js +239 -0
  356. package/dist/pipeline/qa/qa-service.js.map +1 -0
  357. package/dist/pipeline/qa-orchestrator.d.ts +60 -0
  358. package/dist/pipeline/qa-orchestrator.d.ts.map +1 -0
  359. package/dist/pipeline/qa-orchestrator.js +177 -0
  360. package/dist/pipeline/qa-orchestrator.js.map +1 -0
  361. package/dist/pipeline/reflection/domains/agent-domain.d.ts +40 -0
  362. package/dist/pipeline/reflection/domains/agent-domain.d.ts.map +1 -0
  363. package/dist/pipeline/reflection/domains/agent-domain.js +161 -0
  364. package/dist/pipeline/reflection/domains/agent-domain.js.map +1 -0
  365. package/dist/pipeline/reflection/domains/audit-domain.d.ts +46 -0
  366. package/dist/pipeline/reflection/domains/audit-domain.d.ts.map +1 -0
  367. package/dist/pipeline/reflection/domains/audit-domain.js +241 -0
  368. package/dist/pipeline/reflection/domains/audit-domain.js.map +1 -0
  369. package/dist/pipeline/reflection/domains/bootstrap-domain.d.ts +40 -0
  370. package/dist/pipeline/reflection/domains/bootstrap-domain.d.ts.map +1 -0
  371. package/dist/pipeline/reflection/domains/bootstrap-domain.js +156 -0
  372. package/dist/pipeline/reflection/domains/bootstrap-domain.js.map +1 -0
  373. package/dist/pipeline/reflection/domains/commit-domain.d.ts +40 -0
  374. package/dist/pipeline/reflection/domains/commit-domain.d.ts.map +1 -0
  375. package/dist/pipeline/reflection/domains/commit-domain.js +174 -0
  376. package/dist/pipeline/reflection/domains/commit-domain.js.map +1 -0
  377. package/dist/pipeline/reflection/domains/test-domain.d.ts +40 -0
  378. package/dist/pipeline/reflection/domains/test-domain.d.ts.map +1 -0
  379. package/dist/pipeline/reflection/domains/test-domain.js +194 -0
  380. package/dist/pipeline/reflection/domains/test-domain.js.map +1 -0
  381. package/dist/pipeline/reflection/historical-loader.d.ts +105 -0
  382. package/dist/pipeline/reflection/historical-loader.d.ts.map +1 -0
  383. package/dist/pipeline/reflection/historical-loader.js +462 -0
  384. package/dist/pipeline/reflection/historical-loader.js.map +1 -0
  385. package/dist/pipeline/reflection/hooks/agent-hook.d.ts +72 -0
  386. package/dist/pipeline/reflection/hooks/agent-hook.d.ts.map +1 -0
  387. package/dist/pipeline/reflection/hooks/agent-hook.js +98 -0
  388. package/dist/pipeline/reflection/hooks/agent-hook.js.map +1 -0
  389. package/dist/pipeline/reflection/hooks/audit-hook.d.ts +72 -0
  390. package/dist/pipeline/reflection/hooks/audit-hook.d.ts.map +1 -0
  391. package/dist/pipeline/reflection/hooks/audit-hook.js +112 -0
  392. package/dist/pipeline/reflection/hooks/audit-hook.js.map +1 -0
  393. package/dist/pipeline/reflection/hooks/bootstrap-hook.d.ts +71 -0
  394. package/dist/pipeline/reflection/hooks/bootstrap-hook.d.ts.map +1 -0
  395. package/dist/pipeline/reflection/hooks/bootstrap-hook.js +97 -0
  396. package/dist/pipeline/reflection/hooks/bootstrap-hook.js.map +1 -0
  397. package/dist/pipeline/reflection/hooks/commit-hook.d.ts +63 -0
  398. package/dist/pipeline/reflection/hooks/commit-hook.d.ts.map +1 -0
  399. package/dist/pipeline/reflection/hooks/commit-hook.js +90 -0
  400. package/dist/pipeline/reflection/hooks/commit-hook.js.map +1 -0
  401. package/dist/pipeline/reflection/hooks/test-hook.d.ts +65 -0
  402. package/dist/pipeline/reflection/hooks/test-hook.d.ts.map +1 -0
  403. package/dist/pipeline/reflection/hooks/test-hook.js +99 -0
  404. package/dist/pipeline/reflection/hooks/test-hook.js.map +1 -0
  405. package/dist/pipeline/reflection/lessons-memo-generator.d.ts +60 -0
  406. package/dist/pipeline/reflection/lessons-memo-generator.d.ts.map +1 -0
  407. package/dist/pipeline/reflection/lessons-memo-generator.js +286 -0
  408. package/dist/pipeline/reflection/lessons-memo-generator.js.map +1 -0
  409. package/dist/store/ProjectStore.d.ts +1 -1
  410. package/dist/store/ProjectStore.d.ts.map +1 -1
  411. package/dist/store/ProjectStore.js +2 -1
  412. package/dist/store/ProjectStore.js.map +1 -1
  413. package/dist/store/types.d.ts +28 -0
  414. package/dist/store/types.d.ts.map +1 -0
  415. package/dist/store/types.js +3 -0
  416. package/dist/store/types.js.map +1 -0
  417. package/dist/tools/__tests__/command-parser.test.js +1 -1
  418. package/dist/tools/__tests__/command-parser.test.js.map +1 -1
  419. package/dist/tools/__tests__/declared-facts.test.d.ts +2 -0
  420. package/dist/tools/__tests__/declared-facts.test.d.ts.map +1 -0
  421. package/dist/tools/__tests__/declared-facts.test.js +21 -0
  422. package/dist/tools/__tests__/declared-facts.test.js.map +1 -0
  423. package/dist/tools/__tests__/package-install.test.d.ts +2 -0
  424. package/dist/tools/__tests__/package-install.test.d.ts.map +1 -0
  425. package/dist/tools/__tests__/package-install.test.js +56 -0
  426. package/dist/tools/__tests__/package-install.test.js.map +1 -0
  427. package/dist/tools/__tests__/save-tools.secrets.test.js +1 -1
  428. package/dist/tools/__tests__/save-tools.secrets.test.js.map +1 -1
  429. package/dist/tools/edit-file.d.ts.map +1 -1
  430. package/dist/tools/edit-file.js +1 -0
  431. package/dist/tools/edit-file.js.map +1 -1
  432. package/dist/tools/list-directory.d.ts.map +1 -1
  433. package/dist/tools/list-directory.js +1 -0
  434. package/dist/tools/list-directory.js.map +1 -1
  435. package/dist/tools/package-install.d.ts +11 -0
  436. package/dist/tools/package-install.d.ts.map +1 -0
  437. package/dist/tools/package-install.js +112 -0
  438. package/dist/tools/package-install.js.map +1 -0
  439. package/dist/tools/read-file.d.ts.map +1 -1
  440. package/dist/tools/read-file.js +1 -0
  441. package/dist/tools/read-file.js.map +1 -1
  442. package/dist/tools/run-command.d.ts.map +1 -1
  443. package/dist/tools/run-command.js +5 -1
  444. package/dist/tools/run-command.js.map +1 -1
  445. package/dist/tools/save-audit.d.ts.map +1 -1
  446. package/dist/tools/save-audit.js +7 -6
  447. package/dist/tools/save-audit.js.map +1 -1
  448. package/dist/tools/save-context.d.ts.map +1 -1
  449. package/dist/tools/save-context.js +3 -2
  450. package/dist/tools/save-context.js.map +1 -1
  451. package/dist/tools/save-learning.d.ts.map +1 -1
  452. package/dist/tools/save-learning.js +4 -3
  453. package/dist/tools/save-learning.js.map +1 -1
  454. package/dist/tools/save-user-preference.d.ts.map +1 -1
  455. package/dist/tools/save-user-preference.js +3 -2
  456. package/dist/tools/save-user-preference.js.map +1 -1
  457. package/dist/tools/search-files.d.ts.map +1 -1
  458. package/dist/tools/search-files.js +1 -0
  459. package/dist/tools/search-files.js.map +1 -1
  460. package/dist/tools/update-session.d.ts.map +1 -1
  461. package/dist/tools/update-session.js +3 -2
  462. package/dist/tools/update-session.js.map +1 -1
  463. package/dist/tools/write-file.d.ts.map +1 -1
  464. package/dist/tools/write-file.js +1 -0
  465. package/dist/tools/write-file.js.map +1 -1
  466. package/package.json +71 -44
@@ -0,0 +1,106 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.RemoteAgentRegistry = void 0;
4
+ const fs_1 = require("fs");
5
+ const path_1 = require("path");
6
+ const yaml_1 = require("yaml");
7
+ const agent_core_1 = require("@backendkit-labs/agent-core");
8
+ const download_guard_1 = require("./download-guard");
9
+ const INDEX_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
10
+ /**
11
+ * Fetches and caches agent packages from a remote registry.
12
+ *
13
+ * Registry index format (served at registryUrl):
14
+ * {
15
+ * "version": "1",
16
+ * "agents": [
17
+ * { "name": "@bk/agent-devops-aws", "version": "1.0.0",
18
+ * "description": "...", "downloadUrl": "https://..." }
19
+ * ]
20
+ * }
21
+ *
22
+ * Each downloadUrl must return a valid agent.yaml body.
23
+ */
24
+ class RemoteAgentRegistry {
25
+ registryUrl;
26
+ cacheDir;
27
+ constructor(registryUrl, cacheDir) {
28
+ this.registryUrl = registryUrl;
29
+ this.cacheDir = cacheDir;
30
+ (0, fs_1.mkdirSync)(cacheDir, { recursive: true });
31
+ }
32
+ /** Fetch the registry index (cached for 1 hour). */
33
+ async fetchIndex() {
34
+ const cachePath = (0, path_1.join)(this.cacheDir, '_index.json');
35
+ if ((0, fs_1.existsSync)(cachePath)) {
36
+ const wrapper = JSON.parse((0, fs_1.readFileSync)(cachePath, 'utf-8'));
37
+ if (Date.now() - wrapper.fetchedAt < INDEX_CACHE_TTL_MS) {
38
+ return wrapper.data;
39
+ }
40
+ }
41
+ const resp = await fetch(this.registryUrl, { headers: { Accept: 'application/json' } });
42
+ if (!resp.ok) {
43
+ throw new Error(`Registry fetch failed ${resp.status}: ${resp.statusText}`);
44
+ }
45
+ const data = await resp.json();
46
+ (0, agent_core_1.atomicWriteSync)(cachePath, JSON.stringify({ fetchedAt: Date.now(), data }, null, 2));
47
+ return data;
48
+ }
49
+ /**
50
+ * Download and cache a package by name.
51
+ * Returns null and logs a warning if the package is not found or invalid.
52
+ */
53
+ async installPackage(packageName) {
54
+ const safeName = packageName.replace(/[@/]/g, '_');
55
+ const packageDir = (0, path_1.join)(this.cacheDir, safeName);
56
+ const agentPath = (0, path_1.join)(packageDir, 'agent.yaml');
57
+ // Use cached version if available
58
+ if ((0, fs_1.existsSync)(agentPath)) {
59
+ return this.parseYamlAgent(agentPath, packageName);
60
+ }
61
+ let pkg;
62
+ try {
63
+ const index = await this.fetchIndex();
64
+ pkg = index.agents.find(a => a.name === packageName);
65
+ }
66
+ catch (err) {
67
+ console.warn(`[AgentDiscovery] Registry unavailable for "${packageName}": ${err.message}`);
68
+ return null;
69
+ }
70
+ if (!pkg) {
71
+ console.warn(`[AgentDiscovery] Package "${packageName}" not found in registry`);
72
+ return null;
73
+ }
74
+ return this.downloadAndCache(pkg, packageDir, agentPath);
75
+ }
76
+ // ── Private ────────────────────────────────────────────────────────────────
77
+ async downloadAndCache(pkg, packageDir, agentPath) {
78
+ // downloadUrl comes from the registry index: check it, and refuse redirects (they skip the check).
79
+ await (0, download_guard_1.assertSafeDownloadUrl)(pkg.downloadUrl, this.registryUrl);
80
+ const resp = await fetch(pkg.downloadUrl, { redirect: 'error' });
81
+ if (!resp.ok) {
82
+ throw new Error(`Download failed for "${pkg.name}" (${resp.status}): ${resp.statusText}`);
83
+ }
84
+ const content = await resp.text();
85
+ (0, fs_1.mkdirSync)(packageDir, { recursive: true });
86
+ (0, agent_core_1.atomicWriteSync)(agentPath, content);
87
+ console.log(`[AgentDiscovery] Installed "${pkg.name}@${pkg.version}" → ${agentPath}`);
88
+ return this.parseYamlAgent(agentPath, pkg.name);
89
+ }
90
+ parseYamlAgent(filePath, packageName) {
91
+ try {
92
+ const raw = (0, yaml_1.parse)((0, fs_1.readFileSync)(filePath, 'utf-8'));
93
+ if (!raw?.id || !raw?.systemPrompt || !Array.isArray(raw?.allowedTools)) {
94
+ console.warn(`[AgentDiscovery] Invalid agent.yaml for package "${packageName}"`);
95
+ return null;
96
+ }
97
+ return { ...raw, source: 'registry' };
98
+ }
99
+ catch (err) {
100
+ console.warn(`[AgentDiscovery] Parse error for "${packageName}": ${err.message}`);
101
+ return null;
102
+ }
103
+ }
104
+ }
105
+ exports.RemoteAgentRegistry = RemoteAgentRegistry;
106
+ //# sourceMappingURL=RemoteAgentRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RemoteAgentRegistry.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/RemoteAgentRegistry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=RemoteAgentRegistry.ssrf.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RemoteAgentRegistry.ssrf.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,34 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const fs_1 = require("fs");
4
+ const os_1 = require("os");
5
+ const path_1 = require("path");
6
+ const RemoteAgentRegistry_1 = require("../RemoteAgentRegistry");
7
+ describe('RemoteAgentRegistry download guard', () => {
8
+ let dir;
9
+ const realFetch = global.fetch;
10
+ let fetchMock;
11
+ beforeEach(() => {
12
+ dir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'bk-registry-'));
13
+ fetchMock = jest.fn(async (url) => {
14
+ if (String(url).endsWith('index.json')) {
15
+ return new Response(JSON.stringify({
16
+ version: '1',
17
+ agents: [{ name: 'evil', version: '1', description: 'x', downloadUrl: 'http://169.254.169.254/latest/meta-data' }],
18
+ }));
19
+ }
20
+ return new Response('id: x');
21
+ });
22
+ global.fetch = fetchMock;
23
+ });
24
+ afterEach(() => {
25
+ global.fetch = realFetch;
26
+ (0, fs_1.rmSync)(dir, { recursive: true, force: true });
27
+ });
28
+ it('does not request an internal downloadUrl taken from the index', async () => {
29
+ const registry = new RemoteAgentRegistry_1.RemoteAgentRegistry('https://registry.example.com/index.json', dir);
30
+ await expect(registry.installPackage('evil')).rejects.toThrow(/Unsafe download URL/);
31
+ expect(fetchMock.mock.calls.map(c => String(c[0]))).toEqual(['https://registry.example.com/index.json']);
32
+ });
33
+ });
34
+ //# sourceMappingURL=RemoteAgentRegistry.ssrf.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RemoteAgentRegistry.ssrf.test.js","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.ts"],"names":[],"mappings":";;AAAA,2BAAyC;AACzC,2BAA4B;AAC5B,+BAA4B;AAC5B,gEAA6D;AAE7D,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAChD,IAAI,GAAW,CAAC;IAChB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/B,IAAI,SAAoB,CAAC;IAEzB,UAAU,CAAC,GAAG,EAAE;QACZ,GAAG,GAAG,IAAA,gBAAW,EAAC,IAAA,WAAI,EAAC,IAAA,WAAM,GAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QAClD,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;YACtC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;oBAC/B,OAAO,EAAE,GAAG;oBACZ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;iBACrH,CAAC,CAAC,CAAC;YACR,CAAC;YACD,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,GAAG,SAAoC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,IAAA,WAAM,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;QACzF,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACrF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=discoverAgents.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/discoverAgents.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,147 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ const fs = __importStar(require("node:fs"));
37
+ const os = __importStar(require("node:os"));
38
+ const path = __importStar(require("node:path"));
39
+ const discoverAgents_1 = require("../discoverAgents");
40
+ const AgentPackageLoader_1 = require("../AgentPackageLoader");
41
+ const workspace_trust_1 = require("../../trust/workspace-trust");
42
+ const APP = 'disc-test';
43
+ let root;
44
+ let home;
45
+ let project;
46
+ const agentYaml = (id, prompt) => `id: ${id}\nname: ${id}\ndescription: d\nsystemPrompt: ${prompt}\nallowedTools: []\n`;
47
+ function put(dir, file, content) {
48
+ fs.mkdirSync(dir, { recursive: true });
49
+ fs.writeFileSync(path.join(dir, file), content);
50
+ }
51
+ const globalDir = () => (0, AgentPackageLoader_1.globalAgentsDir)(APP);
52
+ const projectDir = () => path.join(project, `.${APP}`, 'agents');
53
+ const discover = (extra = {}) => (0, discoverAgents_1.discoverAgents)({ appName: APP, workingDir: project, ...extra });
54
+ beforeEach(() => {
55
+ root = fs.mkdtempSync(path.join(os.tmpdir(), 'discover-'));
56
+ home = path.join(root, 'home');
57
+ project = path.join(root, 'repo');
58
+ fs.mkdirSync(home);
59
+ fs.mkdirSync(project);
60
+ process.env.USERPROFILE = home;
61
+ process.env.HOME = home;
62
+ delete process.env.BK_TRUST_PROJECT;
63
+ jest.spyOn(console, 'warn').mockImplementation(() => undefined);
64
+ });
65
+ afterEach(() => {
66
+ jest.restoreAllMocks();
67
+ fs.rmSync(root, { recursive: true, force: true });
68
+ delete process.env.USERPROFILE;
69
+ delete process.env.HOME;
70
+ delete process.env.BK_TRUST_PROJECT;
71
+ });
72
+ describe('discoverAgents — the project layer needs the workspace to be trusted', () => {
73
+ it('an untrusted project\'s agents are NOT loaded, and the warning names them', async () => {
74
+ put(projectDir(), 'evil.yaml', agentYaml('evil', 'exfiltrate everything'));
75
+ put(projectDir(), 'ok.yaml', agentYaml('ok', 'fine'));
76
+ const found = await discover();
77
+ expect(found.map(a => a.id)).toEqual([]);
78
+ const warning = console.warn.mock.calls.map(c => String(c[0])).join('\n');
79
+ expect(warning).toContain('not trusted');
80
+ expect(warning).toContain('2 agent(s)');
81
+ expect(warning).toContain('evil');
82
+ expect(warning).toContain('ok');
83
+ });
84
+ it('does not even parse an untrusted project\'s files (a broken one raises no parse warning)', async () => {
85
+ put(projectDir(), 'broken.yaml', ': : not yaml {{{');
86
+ await discover();
87
+ const warnings = console.warn.mock.calls.map(c => String(c[0]));
88
+ expect(warnings.some(w => w.includes('Failed to parse'))).toBe(false);
89
+ });
90
+ it('a trusted project loads (trustProject, or BK_TRUST_PROJECT=1)', async () => {
91
+ put(projectDir(), 'mine.yaml', agentYaml('mine', 'p'));
92
+ (0, workspace_trust_1.trustProject)(APP, project);
93
+ expect((await discover()).map(a => a.id)).toEqual(['mine']);
94
+ fs.rmSync(path.join(home, `.${APP}`), { recursive: true, force: true });
95
+ expect(await discover()).toEqual([]); // trust gone: left out again
96
+ process.env.BK_TRUST_PROJECT = '1';
97
+ expect((await discover()).map(a => a.id)).toEqual(['mine']);
98
+ });
99
+ it('`trusted` passed by the host wins over the trust file, in both directions', async () => {
100
+ put(projectDir(), 'mine.yaml', agentYaml('mine', 'p'));
101
+ expect((await discover({ trusted: true })).map(a => a.id)).toEqual(['mine']);
102
+ (0, workspace_trust_1.trustProject)(APP, project);
103
+ expect(await discover({ trusted: false })).toEqual([]);
104
+ });
105
+ it('global agents always load, untrusted project or not', async () => {
106
+ put(globalDir(), 'shared.yaml', agentYaml('shared', 'g'));
107
+ put(projectDir(), 'repo-agent.yaml', agentYaml('repo-agent', 'r'));
108
+ expect((await discover()).map(a => a.id)).toEqual(['shared']);
109
+ });
110
+ it('an untrusted project with no agents says nothing', async () => {
111
+ await discover();
112
+ expect(console.warn).not.toHaveBeenCalled();
113
+ });
114
+ });
115
+ describe('discoverAgents — precedence: project over global', () => {
116
+ it('the same id in both: the trusted project\'s version wins (as in coding\'s AgentLoader)', async () => {
117
+ put(globalDir(), 'helper.yaml', agentYaml('helper', 'global prompt'));
118
+ put(projectDir(), 'helper.yaml', agentYaml('helper', 'project prompt'));
119
+ (0, workspace_trust_1.trustProject)(APP, project);
120
+ const [helper, ...rest] = await discover();
121
+ expect(rest).toEqual([]);
122
+ expect(helper).toMatchObject({ id: 'helper', systemPrompt: 'project prompt', source: 'project' });
123
+ });
124
+ it('with the project untrusted the global one is what remains', async () => {
125
+ put(globalDir(), 'helper.yaml', agentYaml('helper', 'global prompt'));
126
+ put(projectDir(), 'helper.yaml', agentYaml('helper', 'project prompt'));
127
+ const [helper] = await discover();
128
+ expect(helper).toMatchObject({ systemPrompt: 'global prompt', source: 'global' });
129
+ });
130
+ });
131
+ describe('discoverAgents — one home directory for the framework', () => {
132
+ it('the global directory follows USERPROFILE/HOME like the trust file and AgentLoader', () => {
133
+ expect(globalDir()).toBe(path.join(home, `.${APP}`, 'agents'));
134
+ });
135
+ });
136
+ describe('listAgentEntries', () => {
137
+ it('lists names of yaml/json files and agent.yaml directories, reading nothing', () => {
138
+ put(projectDir(), 'a.yaml', 'x');
139
+ put(projectDir(), 'b.json', 'x');
140
+ put(path.join(projectDir(), 'pkg'), 'agent.yaml', 'x');
141
+ put(path.join(projectDir(), 'notes'), 'readme.md', 'x'); // a directory without agent.yaml
142
+ put(path.join(projectDir(), 'registry'), 'cached.yaml', 'x'); // the registry cache is skipped
143
+ expect((0, AgentPackageLoader_1.listAgentEntries)(projectDir())).toEqual(['a', 'b', 'pkg']);
144
+ expect((0, AgentPackageLoader_1.listAgentEntries)(path.join(root, 'missing'))).toEqual([]);
145
+ });
146
+ });
147
+ //# sourceMappingURL=discoverAgents.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.test.js","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/discoverAgents.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=download-guard.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/download-guard.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,47 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const download_guard_1 = require("../download-guard");
4
+ const REGISTRY = 'https://registry.example.com/index.json';
5
+ const publicDns = async () => [{ address: '93.184.216.34' }];
6
+ describe('isPrivateIp', () => {
7
+ it.each([
8
+ '127.0.0.1', '10.1.2.3', '172.16.0.1', '172.31.255.255', '192.168.1.1', '169.254.169.254',
9
+ '100.64.0.1', '0.0.0.0', '224.0.0.1', '::1', '::', 'fd00::1', 'fe80::1', '::ffff:127.0.0.1', '::ffff:7f00:1',
10
+ ])('%s is not public', (ip) => {
11
+ expect((0, download_guard_1.isPrivateIp)(ip)).toBe(true);
12
+ });
13
+ it.each(['93.184.216.34', '8.8.8.8', '172.32.0.1', '2606:4700::1111', '::ffff:8.8.8.8'])('%s is public', (ip) => {
14
+ expect((0, download_guard_1.isPrivateIp)(ip)).toBe(false);
15
+ });
16
+ });
17
+ describe('assertSafeDownloadUrl', () => {
18
+ it('accepts a public https URL', async () => {
19
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('https://cdn.example.org/a.yaml', REGISTRY, publicDns)).resolves.toBeUndefined();
20
+ });
21
+ it.each(['file:///etc/passwd', 'ftp://example.org/a', 'javascript:alert(1)', 'not a url'])('rejects %s', async (u) => {
22
+ await expect((0, download_guard_1.assertSafeDownloadUrl)(u, REGISTRY, publicDns)).rejects.toThrow(/Unsafe download URL/);
23
+ });
24
+ it.each([
25
+ 'http://localhost/a', 'http://127.0.0.1/a', 'http://169.254.169.254/latest/meta-data',
26
+ 'http://[::1]/a', 'http://metadata.google.internal/a', 'http://10.0.0.5:8080/a', 'http://[::ffff:7f00:1]/a',
27
+ ])('rejects %s', async (u) => {
28
+ await expect((0, download_guard_1.assertSafeDownloadUrl)(u, REGISTRY, publicDns)).rejects.toThrow(/Unsafe download URL/);
29
+ });
30
+ it('rejects a public-looking name that resolves to a private address', async () => {
31
+ const rebinding = async () => [{ address: '93.184.216.34' }, { address: '10.0.0.7' }];
32
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('https://evil.example.org/a', REGISTRY, rebinding)).rejects.toThrow(/10\.0\.0\.7/);
33
+ });
34
+ it('rejects a host that does not resolve', async () => {
35
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('https://nada.example.org/a', REGISTRY, async () => [])).rejects.toThrow(/did not resolve/);
36
+ });
37
+ it('accepts a private address when it is the registry itself (registry inside the company network)', async () => {
38
+ const internal = 'http://registry.corp.internal:8080/index.json';
39
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('http://registry.corp.internal:8080/agents/a.yaml', internal, publicDns)).resolves.toBeUndefined();
40
+ });
41
+ it('does not extend that trust to another port or host', async () => {
42
+ const internal = 'http://10.0.0.5:8080/index.json';
43
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('http://10.0.0.5:9999/a.yaml', internal, publicDns)).rejects.toThrow(/Unsafe/);
44
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('http://10.0.0.6:8080/a.yaml', internal, publicDns)).rejects.toThrow(/Unsafe/);
45
+ });
46
+ });
47
+ //# sourceMappingURL=download-guard.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.test.js","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/download-guard.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { AgentProfile } from '@backendkit-labs/agent-core';
2
+ import type { AgentDiscoveryConfig } from './types';
3
+ /**
4
+ * Discover agents from local directories and/or a remote registry.
5
+ *
6
+ * Local layout (appName = 'bk-agent'):
7
+ * ~/.bk-agent/agents/ ← global agents (shared across projects)
8
+ * {workingDir}/.bk-agent/agents/ ← project-local agents (git-tracked); only in a TRUSTED project
9
+ *
10
+ * Remote:
11
+ * Fetch the registry index, download requested packages, cache locally.
12
+ * Re-running is fast — cached packages are reused until deleted.
13
+ *
14
+ * Deduplication: if the same agent id appears in multiple sources, the first occurrence wins:
15
+ * project → global → registry → static agents. The project overrides the global one, as in coding's AgentLoader.
16
+ *
17
+ * Format: this loader reads `*.yaml|yml|json` and `<name>/agent.yaml` (a full AgentProfile); coding's AgentLoader
18
+ * reads `*.json` (+ `.md` prompt) from the same directories. They are two formats on purpose, not one divergent copy.
19
+ */
20
+ export declare function discoverAgents(config: AgentDiscoveryConfig): Promise<AgentProfile[]>;
21
+ //# sourceMappingURL=discoverAgents.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/discoverAgents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAMpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAwD1F"}
@@ -0,0 +1,74 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.discoverAgents = discoverAgents;
4
+ const path_1 = require("path");
5
+ const workspace_trust_1 = require("../trust/workspace-trust");
6
+ const agent_core_1 = require("@backendkit-labs/agent-core");
7
+ const AgentPackageLoader_1 = require("./AgentPackageLoader");
8
+ const RemoteAgentRegistry_1 = require("./RemoteAgentRegistry");
9
+ const DEFAULT_APP_NAME = 'bk-agent';
10
+ /**
11
+ * Discover agents from local directories and/or a remote registry.
12
+ *
13
+ * Local layout (appName = 'bk-agent'):
14
+ * ~/.bk-agent/agents/ ← global agents (shared across projects)
15
+ * {workingDir}/.bk-agent/agents/ ← project-local agents (git-tracked); only in a TRUSTED project
16
+ *
17
+ * Remote:
18
+ * Fetch the registry index, download requested packages, cache locally.
19
+ * Re-running is fast — cached packages are reused until deleted.
20
+ *
21
+ * Deduplication: if the same agent id appears in multiple sources, the first occurrence wins:
22
+ * project → global → registry → static agents. The project overrides the global one, as in coding's AgentLoader.
23
+ *
24
+ * Format: this loader reads `*.yaml|yml|json` and `<name>/agent.yaml` (a full AgentProfile); coding's AgentLoader
25
+ * reads `*.json` (+ `.md` prompt) from the same directories. They are two formats on purpose, not one divergent copy.
26
+ */
27
+ async function discoverAgents(config) {
28
+ const appName = config.appName ?? DEFAULT_APP_NAME;
29
+ const cwd = config.workingDir ?? process.cwd();
30
+ const agents = [];
31
+ const seen = new Set();
32
+ const add = (incoming) => {
33
+ for (const a of incoming) {
34
+ if (!seen.has(a.id)) {
35
+ seen.add(a.id);
36
+ agents.push(a);
37
+ }
38
+ }
39
+ };
40
+ // 1. Local: the project first (it overrides), then the global ones
41
+ if (config.local !== false) {
42
+ const projectDir = (0, AgentPackageLoader_1.projectAgentsDir)(cwd, appName);
43
+ const trusted = config.trusted ?? (0, workspace_trust_1.isProjectTrusted)(appName, cwd).trusted;
44
+ if (trusted) {
45
+ add((0, AgentPackageLoader_1.loadAgentsFromDir)(projectDir, 'project'));
46
+ }
47
+ else {
48
+ const left = (0, AgentPackageLoader_1.listAgentEntries)(projectDir);
49
+ if (left.length > 0) {
50
+ console.warn(`[AgentDiscovery] This project is not trusted, so its own ${left.length} agent(s) (${left.join(', ')}) in ${projectDir} were NOT loaded. ` +
51
+ `Trust it with /trust add (or BK_TRUST_PROJECT=1) only if you trust whoever wrote that repository.`);
52
+ }
53
+ }
54
+ add((0, AgentPackageLoader_1.loadAgentsFromDir)((0, AgentPackageLoader_1.globalAgentsDir)(appName), 'global'));
55
+ }
56
+ // 2. Remote: install packages
57
+ if (config.install?.length) {
58
+ const cacheDir = config.cacheDir ?? (0, path_1.join)((0, agent_core_1.getFrameworkDir)(appName), 'agents', 'registry');
59
+ const registryUrl = config.remote ?? 'https://registry.backendkit.dev/agents';
60
+ const registry = new RemoteAgentRegistry_1.RemoteAgentRegistry(registryUrl, cacheDir);
61
+ const results = await Promise.allSettled(config.install.map(name => registry.installPackage(name)));
62
+ for (let i = 0; i < results.length; i++) {
63
+ const result = results[i];
64
+ if (result.status === 'fulfilled' && result.value) {
65
+ add([result.value]);
66
+ }
67
+ else if (result.status === 'rejected') {
68
+ console.warn(`[AgentDiscovery] Failed to install "${config.install[i]}": ${result.reason.message}`);
69
+ }
70
+ }
71
+ }
72
+ return agents;
73
+ }
74
+ //# sourceMappingURL=discoverAgents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/discoverAgents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * SSRF guard for the download URLs of a remote agent registry.
3
+ *
4
+ * The `downloadUrl` of every package comes from the registry index, which is data fetched over the
5
+ * network, so it is not trusted: it may point at localhost, the cloud metadata endpoint
6
+ * (169.254.169.254) or an internal service. A URL is accepted when:
7
+ * - the protocol is http or https, and
8
+ * - it has the same origin as the registry itself (the operator configured that host, so a registry
9
+ * inside the company network keeps working), or every address its host resolves to is public.
10
+ *
11
+ * Not covered: a host whose DNS answer changes between this check and the request (DNS rebinding).
12
+ * Redirects are refused by the caller (`redirect: 'error'`), since they would skip this check.
13
+ */
14
+ export type LookupFn = (host: string) => Promise<Array<{
15
+ address: string;
16
+ }>>;
17
+ /** True for loopback, private, link-local, CGNAT, unspecified and other non-public addresses. */
18
+ export declare function isPrivateIp(ip: string): boolean;
19
+ export declare function assertSafeDownloadUrl(raw: string, registryUrl: string, resolve?: LookupFn): Promise<void>;
20
+ //# sourceMappingURL=download-guard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/download-guard.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAM7E,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAoB/C;AAcD,wBAAsB,qBAAqB,CACvC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,QAAwB,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}
@@ -0,0 +1,84 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isPrivateIp = isPrivateIp;
4
+ exports.assertSafeDownloadUrl = assertSafeDownloadUrl;
5
+ const net_1 = require("net");
6
+ const promises_1 = require("dns/promises");
7
+ const defaultLookup = (host) => (0, promises_1.lookup)(host, { all: true });
8
+ const BLOCKED_HOSTS = /(^|\.)(localhost|local|internal|localdomain)$/;
9
+ /** True for loopback, private, link-local, CGNAT, unspecified and other non-public addresses. */
10
+ function isPrivateIp(ip) {
11
+ const v = ip.toLowerCase().replace(/^\[|\]$/g, '');
12
+ if ((0, net_1.isIPv4)(v))
13
+ return isPrivateV4(v.split('.').map(Number));
14
+ if (!(0, net_1.isIPv6)(v))
15
+ return true; // not an IP we understand: refuse
16
+ // IPv4-mapped (::ffff:a.b.c.d or ::ffff:7f00:1): judge the embedded IPv4 address.
17
+ const mappedDotted = /^::ffff:(\d+\.\d+\.\d+\.\d+)$/.exec(v);
18
+ if (mappedDotted)
19
+ return isPrivateV4(mappedDotted[1].split('.').map(Number));
20
+ const mappedHex = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(v);
21
+ if (mappedHex) {
22
+ const hi = parseInt(mappedHex[1], 16);
23
+ const lo = parseInt(mappedHex[2], 16);
24
+ return isPrivateV4([hi >> 8, hi & 255, lo >> 8, lo & 255]);
25
+ }
26
+ if (v === '::' || v === '::1')
27
+ return true;
28
+ const first = parseInt(v.split(':')[0] || '0', 16);
29
+ if ((first & 0xfe00) === 0xfc00)
30
+ return true; // fc00::/7 unique local
31
+ if ((first & 0xffc0) === 0xfe80)
32
+ return true; // fe80::/10 link-local
33
+ return false;
34
+ }
35
+ function isPrivateV4([a, b, c]) {
36
+ if (a === 0 || a === 10 || a === 127)
37
+ return true;
38
+ if (a === 100 && b >= 64 && b <= 127)
39
+ return true; // CGNAT
40
+ if (a === 169 && b === 254)
41
+ return true; // link-local, cloud metadata
42
+ if (a === 172 && b >= 16 && b <= 31)
43
+ return true;
44
+ if (a === 192 && b === 168)
45
+ return true;
46
+ if (a === 192 && b === 0 && c === 0)
47
+ return true;
48
+ if (a === 198 && (b === 18 || b === 19))
49
+ return true; // benchmarking
50
+ if (a >= 224)
51
+ return true; // multicast, reserved, broadcast
52
+ return false;
53
+ }
54
+ async function assertSafeDownloadUrl(raw, registryUrl, resolve = defaultLookup) {
55
+ let url;
56
+ try {
57
+ url = new URL(raw);
58
+ }
59
+ catch {
60
+ throw new Error(`Unsafe download URL (invalid): ${raw}`);
61
+ }
62
+ if (url.protocol !== 'https:' && url.protocol !== 'http:') {
63
+ throw new Error(`Unsafe download URL (protocol ${url.protocol} not allowed): ${raw}`);
64
+ }
65
+ try {
66
+ if (new URL(registryUrl).origin === url.origin)
67
+ return;
68
+ }
69
+ catch { /* an invalid registry URL cannot vouch for anything */ }
70
+ const host = url.hostname.toLowerCase().replace(/^\[|\]$/g, '');
71
+ if (BLOCKED_HOSTS.test(host) || host === 'metadata') {
72
+ throw new Error(`Unsafe download URL (host ${host} is internal): ${raw}`);
73
+ }
74
+ const addresses = (0, net_1.isIPv4)(host) || (0, net_1.isIPv6)(host) ? [{ address: host }] : await resolve(host);
75
+ if (addresses.length === 0) {
76
+ throw new Error(`Unsafe download URL (${host} did not resolve): ${raw}`);
77
+ }
78
+ for (const { address } of addresses) {
79
+ if (isPrivateIp(address)) {
80
+ throw new Error(`Unsafe download URL (${host} resolves to non-public address ${address}): ${raw}`);
81
+ }
82
+ }
83
+ }
84
+ //# sourceMappingURL=download-guard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/download-guard.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export { discoverAgents } from './discoverAgents';
2
+ export { RemoteAgentRegistry } from './RemoteAgentRegistry';
3
+ export { loadAgentsFromDir, globalAgentsDir, projectAgentsDir } from './AgentPackageLoader';
4
+ export type { AgentDiscoveryConfig, AgentPackageFile, RemotePackageListing, RemoteRegistryIndex, } from './types';
5
+ //# sourceMappingURL=index.d.ts.map