@chankov/agent-fleet 2.0.2 → 2.0.3

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 (438) hide show
  1. package/.pi/harnesses/agent-hub/README.md +26 -31
  2. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +1 -1
  3. package/.pi/harnesses/agent-hub/config/overrides.ts +2 -7
  4. package/.pi/harnesses/agent-hub/index.ts +14 -25
  5. package/.pi/harnesses/agent-hub/input/completions.ts +2 -2
  6. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +0 -2
  7. package/.pi/harnesses/agent-hub/package.json +1 -1
  8. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  9. package/.pi/harnesses/agent-hub/research/controls.ts +15 -16
  10. package/.pi/harnesses/agent-hub/research/runtime.ts +30 -39
  11. package/.pi/harnesses/agent-hub/research/spawn-run.ts +108 -111
  12. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +2 -3
  13. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +3 -3
  14. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +0 -7
  15. package/.pi/harnesses/agent-hub/ui/grid.ts +21 -183
  16. package/.pi/harnesses/coms/package.json +1 -1
  17. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  18. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +23 -12
  19. package/.versions/2.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  20. package/.versions/2.0.3/.pi/agents/model-profiles.yaml +27 -0
  21. package/.versions/2.0.3/.pi/agents/peers.yaml +142 -0
  22. package/.versions/2.0.3/.pi/agents/teams.yaml +41 -0
  23. package/.versions/2.0.3/.pi/agents/voices.yaml +13 -0
  24. package/.versions/2.0.3/.pi/damage-control-rules.yaml +297 -0
  25. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  26. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  27. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  28. package/.versions/2.0.3/.pi/extensions/btw/README.md +120 -0
  29. package/.versions/2.0.3/.pi/extensions/btw/index.ts +914 -0
  30. package/.versions/2.0.3/.pi/extensions/btw/package.json +6 -0
  31. package/.versions/2.0.3/.pi/extensions/btw/state.js +179 -0
  32. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  33. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  34. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  35. package/.versions/2.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  36. package/.versions/2.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  37. package/.versions/2.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  38. package/.versions/2.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  39. package/.versions/2.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  40. package/.versions/2.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  41. package/.versions/2.0.3/.pi/extensions/package-lock.json +1175 -0
  42. package/.versions/2.0.3/.pi/extensions/package.json +9 -0
  43. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  44. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  45. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  46. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  47. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  48. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  49. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  50. package/.versions/2.0.3/.pi/harnesses/agent-hub/README.md +1158 -0
  51. package/.versions/2.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  52. package/.versions/2.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  53. package/.versions/2.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  54. package/.versions/2.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  55. package/.versions/2.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  56. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  57. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  58. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  59. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  60. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  61. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  62. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  63. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  64. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  65. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  66. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  67. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  68. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  69. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  70. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  71. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  72. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  73. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  74. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  75. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  76. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  77. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  78. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  79. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  80. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  81. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  82. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/agents.ts +180 -0
  83. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  84. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  85. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  86. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  87. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  88. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  89. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  90. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  91. package/.versions/2.0.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  92. package/.versions/2.0.3/.pi/harnesses/agent-hub/delegate.ts +446 -0
  93. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  94. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  95. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  96. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  97. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  98. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  99. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  100. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  101. package/.versions/2.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  102. package/.versions/2.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  103. package/.versions/2.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  104. package/.versions/2.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  105. package/.versions/2.0.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  106. package/.versions/2.0.3/.pi/harnesses/agent-hub/footer.ts +30 -0
  107. package/.versions/2.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  108. package/.versions/2.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  109. package/.versions/2.0.3/.pi/harnesses/agent-hub/index.ts +2036 -0
  110. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  111. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  112. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  113. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  114. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  115. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  116. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  117. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  118. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  119. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  120. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  121. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  122. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  123. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  124. package/.versions/2.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  125. package/.versions/2.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  126. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  127. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  128. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  129. package/.versions/2.0.3/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  130. package/.versions/2.0.3/.pi/harnesses/agent-hub/presentation.ts +48 -0
  131. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  132. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  133. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  134. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  135. package/.versions/2.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  136. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  137. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  138. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/spawn-run.ts +143 -0
  139. package/.versions/2.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  140. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  141. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  142. package/.versions/2.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  143. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  144. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  145. package/.versions/2.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  146. package/.versions/2.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  147. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  148. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
  149. package/.versions/2.0.3/.pi/harnesses/agent-hub/spawn.ts +388 -0
  150. package/.versions/2.0.3/.pi/harnesses/agent-hub/timeline.ts +54 -0
  151. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  152. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  153. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  154. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  155. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  156. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  157. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  158. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  159. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  160. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  161. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  162. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  163. package/.versions/2.0.3/.pi/harnesses/agent-hub/types.ts +61 -0
  164. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  165. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  166. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  167. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  168. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  169. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  170. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  171. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  172. package/.versions/2.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  173. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  174. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  175. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  176. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  177. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  178. package/.versions/2.0.3/.pi/harnesses/coms/README.md +100 -0
  179. package/.versions/2.0.3/.pi/harnesses/coms/index.ts +276 -0
  180. package/.versions/2.0.3/.pi/harnesses/coms/package.json +7 -0
  181. package/.versions/2.0.3/.pi/harnesses/coms/version.ts +42 -0
  182. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  183. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  184. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  185. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  186. package/.versions/2.0.3/.pi/harnesses/lib/coms-core-io.ts +385 -0
  187. package/.versions/2.0.3/.pi/harnesses/lib/coms-core.ts +577 -0
  188. package/.versions/2.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  189. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  190. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  191. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  192. package/.versions/2.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  193. package/.versions/2.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  194. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  195. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  196. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  197. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  198. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  199. package/.versions/2.0.3/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  200. package/.versions/2.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  201. package/.versions/2.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  202. package/.versions/2.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  203. package/.versions/2.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  204. package/.versions/2.0.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  205. package/.versions/2.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  206. package/.versions/2.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  207. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  208. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  209. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  210. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  211. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  212. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  213. package/.versions/2.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  214. package/.versions/2.0.3/.pi/harnesses/package-lock.json +2039 -0
  215. package/.versions/2.0.3/.pi/harnesses/package.json +10 -0
  216. package/.versions/2.0.3/.pi/prompts/af-build.md +24 -0
  217. package/.versions/2.0.3/.pi/prompts/af-code-simplify.md +22 -0
  218. package/.versions/2.0.3/.pi/prompts/af-plan.md +17 -0
  219. package/.versions/2.0.3/.pi/prompts/af-review.md +16 -0
  220. package/.versions/2.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  221. package/.versions/2.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  222. package/.versions/2.0.3/.pi/prompts/af-ship.md +17 -0
  223. package/.versions/2.0.3/.pi/prompts/af-spec.md +15 -0
  224. package/.versions/2.0.3/.pi/prompts/af-test.md +19 -0
  225. package/.versions/2.0.3/.pi/skills/bowser/SKILL.md +145 -0
  226. package/.versions/2.0.3/.version +1 -0
  227. package/.versions/2.0.3/agents/architect.md +25 -0
  228. package/.versions/2.0.3/agents/bowser.md +28 -0
  229. package/.versions/2.0.3/agents/builder.md +56 -0
  230. package/.versions/2.0.3/agents/code-reviewer.md +210 -0
  231. package/.versions/2.0.3/agents/deep-researcher.md +33 -0
  232. package/.versions/2.0.3/agents/documenter.md +22 -0
  233. package/.versions/2.0.3/agents/orchestrator.md +23 -0
  234. package/.versions/2.0.3/agents/plan-reviewer.md +84 -0
  235. package/.versions/2.0.3/agents/planner.md +105 -0
  236. package/.versions/2.0.3/agents/releaser.md +25 -0
  237. package/.versions/2.0.3/agents/researcher.md +31 -0
  238. package/.versions/2.0.3/agents/security-auditor.md +168 -0
  239. package/.versions/2.0.3/agents/test-engineer.md +154 -0
  240. package/.versions/2.0.3/agents/web-debugger.md +44 -0
  241. package/.versions/2.0.3/agents/web-performance-auditor.md +194 -0
  242. package/.versions/2.0.3/bin/catalog/harness-runtime-closure.json +34 -0
  243. package/.versions/2.0.3/codex/CONDUCTOR.md +148 -0
  244. package/.versions/2.0.3/docs/ARCHITECTURE.md +407 -0
  245. package/.versions/2.0.3/docs/agent-fleet-setup.md +473 -0
  246. package/.versions/2.0.3/docs/claude-code-coms-bridge.md +128 -0
  247. package/.versions/2.0.3/docs/codex-remote-conductor.md +170 -0
  248. package/.versions/2.0.3/docs/coms-hermes-bridge.md +189 -0
  249. package/.versions/2.0.3/docs/getting-started.md +119 -0
  250. package/.versions/2.0.3/docs/npm-install.md +292 -0
  251. package/.versions/2.0.3/docs/pi-extensions.md +447 -0
  252. package/.versions/2.0.3/docs/pi-setup.md +74 -0
  253. package/.versions/2.0.3/docs/skill-anatomy.md +150 -0
  254. package/.versions/2.0.3/hermes/README.md +347 -0
  255. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  256. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  257. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  258. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  259. package/.versions/2.0.3/hermes/gates/gate-o-capability.md +8 -0
  260. package/.versions/2.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  261. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  262. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  263. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  264. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  265. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  266. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  267. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  268. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  269. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  270. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  271. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  272. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  273. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  274. package/.versions/2.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  275. package/.versions/2.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  276. package/.versions/2.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  277. package/.versions/2.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  278. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  279. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  280. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  281. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  282. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  283. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  284. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  285. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  286. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  287. package/.versions/2.0.3/hermes/watchdog-tests/__init__.py +0 -0
  288. package/.versions/2.0.3/hooks/coms-stop-hook.mjs +84 -0
  289. package/.versions/2.0.3/install-manifest.json +2940 -0
  290. package/.versions/2.0.3/justfile +289 -0
  291. package/.versions/2.0.3/manifest-meta.json +969 -0
  292. package/.versions/2.0.3/references/accessibility-checklist.md +160 -0
  293. package/.versions/2.0.3/references/communication-contract.md +26 -0
  294. package/.versions/2.0.3/references/definition-of-done.md +67 -0
  295. package/.versions/2.0.3/references/fleet-coordination-patterns.md +171 -0
  296. package/.versions/2.0.3/references/observability-checklist.md +91 -0
  297. package/.versions/2.0.3/references/orchestration-patterns.md +370 -0
  298. package/.versions/2.0.3/references/performance-checklist.md +153 -0
  299. package/.versions/2.0.3/references/prompting-patterns.md +380 -0
  300. package/.versions/2.0.3/references/security-checklist.md +179 -0
  301. package/.versions/2.0.3/references/testing-patterns.md +236 -0
  302. package/.versions/2.0.3/references/workflow-authoring.md +304 -0
  303. package/.versions/2.0.3/scripts/codex-conductor.ts +41 -0
  304. package/.versions/2.0.3/scripts/codex-remote-control.ts +167 -0
  305. package/.versions/2.0.3/scripts/coms-claude-bridge.ts +411 -0
  306. package/.versions/2.0.3/scripts/coms-cli.ts +484 -0
  307. package/.versions/2.0.3/scripts/coms-hermes-bridge.ts +413 -0
  308. package/.versions/2.0.3/scripts/fleet.ts +199 -0
  309. package/.versions/2.0.3/scripts/flow.ts +137 -0
  310. package/.versions/2.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  311. package/.versions/2.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  312. package/.versions/2.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  313. package/.versions/2.0.3/scripts/install-hermes-plugin.sh +180 -0
  314. package/.versions/2.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  315. package/.versions/2.0.3/scripts/lib/codex-conductor.ts +88 -0
  316. package/.versions/2.0.3/scripts/lib/codex-remote-control.ts +482 -0
  317. package/.versions/2.0.3/scripts/lib/coms-envelope.ts +582 -0
  318. package/.versions/2.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  319. package/.versions/2.0.3/scripts/lib/fleet-command.ts +270 -0
  320. package/.versions/2.0.3/scripts/lib/flow-command.ts +93 -0
  321. package/.versions/2.0.3/scripts/lib/flow-maintenance.ts +230 -0
  322. package/.versions/2.0.3/scripts/lib/herdr-layout.ts +281 -0
  323. package/.versions/2.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  324. package/.versions/2.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  325. package/.versions/2.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  326. package/.versions/2.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  327. package/.versions/2.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  328. package/.versions/2.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  329. package/.versions/2.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  330. package/.versions/2.0.3/scripts/lib/monitor-env.ts +146 -0
  331. package/.versions/2.0.3/scripts/lib/peer-launch.ts +318 -0
  332. package/.versions/2.0.3/scripts/lib/persona-banner.ts +62 -0
  333. package/.versions/2.0.3/scripts/lib/spawn-stagger.ts +101 -0
  334. package/.versions/2.0.3/scripts/lib/team-project.ts +213 -0
  335. package/.versions/2.0.3/scripts/lib/team-snapshot.ts +147 -0
  336. package/.versions/2.0.3/scripts/package-lock.json +35 -0
  337. package/.versions/2.0.3/scripts/package.json +9 -0
  338. package/.versions/2.0.3/scripts/peer-banner.ts +40 -0
  339. package/.versions/2.0.3/scripts/peer-launch.ts +259 -0
  340. package/.versions/2.0.3/scripts/team-snapshot.ts +237 -0
  341. package/.versions/2.0.3/scripts/team-up.ts +406 -0
  342. package/.versions/2.0.3/scripts/workflows/lib/agent-phase.ts +132 -0
  343. package/.versions/2.0.3/scripts/workflows/lib/changes.ts +61 -0
  344. package/.versions/2.0.3/scripts/workflows/lib/debate.ts +149 -0
  345. package/.versions/2.0.3/scripts/workflows/lib/env.ts +34 -0
  346. package/.versions/2.0.3/scripts/workflows/lib/envelopes.ts +169 -0
  347. package/.versions/2.0.3/scripts/workflows/lib/gates.ts +81 -0
  348. package/.versions/2.0.3/scripts/workflows/lib/git.ts +96 -0
  349. package/.versions/2.0.3/scripts/workflows/lib/merge.ts +95 -0
  350. package/.versions/2.0.3/scripts/workflows/lib/model-visibility.ts +92 -0
  351. package/.versions/2.0.3/scripts/workflows/lib/permissions.ts +130 -0
  352. package/.versions/2.0.3/scripts/workflows/lib/personas.ts +54 -0
  353. package/.versions/2.0.3/scripts/workflows/lib/poll.ts +86 -0
  354. package/.versions/2.0.3/scripts/workflows/lib/quality.ts +64 -0
  355. package/.versions/2.0.3/scripts/workflows/lib/run.ts +108 -0
  356. package/.versions/2.0.3/scripts/workflows/lib/trace.ts +34 -0
  357. package/.versions/2.0.3/scripts/workflows/lib/voices.ts +125 -0
  358. package/.versions/2.0.3/scripts/workflows/lib/writer-lease.ts +112 -0
  359. package/.versions/2.0.3/scripts/workflows/tsconfig.json +22 -0
  360. package/.versions/2.0.3/scripts/workflows/wf-build-test.ts +61 -0
  361. package/.versions/2.0.3/scripts/workflows/wf-debate.ts +87 -0
  362. package/.versions/2.0.3/scripts/workflows/wf-document.ts +50 -0
  363. package/.versions/2.0.3/scripts/workflows/wf-poll.ts +95 -0
  364. package/.versions/2.0.3/scripts/workflows/wf-quality.ts +20 -0
  365. package/.versions/2.0.3/scripts/workflows/wf-scout.ts +38 -0
  366. package/.versions/2.0.3/skills/_internal/grilling.md +59 -0
  367. package/.versions/2.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  368. package/.versions/2.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  369. package/.versions/2.0.3/skills/compound-learning/SKILL.md +137 -0
  370. package/.versions/2.0.3/skills/context-engineering/SKILL.md +291 -0
  371. package/.versions/2.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  372. package/.versions/2.0.3/skills/designing-agents/SKILL.md +394 -0
  373. package/.versions/2.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  374. package/.versions/2.0.3/skills/drafting-workflows/SKILL.md +143 -0
  375. package/.versions/2.0.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  376. package/.versions/2.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  377. package/.versions/2.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  378. package/.versions/2.0.3/skills/idea-refine/SKILL.md +182 -0
  379. package/.versions/2.0.3/skills/idea-refine/examples.md +238 -0
  380. package/.versions/2.0.3/skills/idea-refine/frameworks.md +99 -0
  381. package/.versions/2.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  382. package/.versions/2.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  383. package/.versions/2.0.3/skills/incremental-implementation/SKILL.md +298 -0
  384. package/.versions/2.0.3/skills/interview-me/SKILL.md +226 -0
  385. package/.versions/2.0.3/skills/orchestration-verification/SKILL.md +181 -0
  386. package/.versions/2.0.3/skills/peer-coms/SKILL.md +90 -0
  387. package/.versions/2.0.3/skills/performance-optimization/SKILL.md +350 -0
  388. package/.versions/2.0.3/skills/planning-and-task-breakdown/SKILL.md +265 -0
  389. package/.versions/2.0.3/skills/security-and-hardening/SKILL.md +461 -0
  390. package/.versions/2.0.3/skills/spec-driven-development/SKILL.md +256 -0
  391. package/.versions/2.0.3/skills/using-agent-skills/SKILL.md +197 -0
  392. package/.versions/2.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  393. package/.versions/2.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  394. package/.versions/2.0.3/vendor/agent-skills-upstream/README.md +11 -0
  395. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  396. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  397. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  398. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  399. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  400. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  401. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  402. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  403. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  404. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  405. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  406. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  407. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  408. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  409. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  410. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  411. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  412. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  413. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  414. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  415. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  416. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  417. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  418. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  419. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  420. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  421. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  422. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  423. package/CHANGELOG.md +7 -0
  424. package/README.md +2 -2
  425. package/bin/lib/doctor.js +1 -1
  426. package/bin/lib/model-visibility.js +64 -0
  427. package/docs/agent-fleet-setup.md +1 -1
  428. package/docs/getting-started.md +2 -2
  429. package/docs/npm-install.md +1 -1
  430. package/docs/pi-extensions.md +13 -10
  431. package/install-manifest.json +36 -1
  432. package/justfile +1 -0
  433. package/manifest-meta.json +25 -1
  434. package/package.json +4 -2
  435. package/scripts/fleet.ts +1 -1
  436. package/scripts/package-lock.json +35 -0
  437. package/scripts/package.json +9 -0
  438. package/.pi/harnesses/agent-hub/research-retention.js +0 -34
@@ -0,0 +1,180 @@
1
+ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+ import { parseTeamsYaml, safePathWithin } from "../helpers.ts";
4
+ import { parseDispatchPolicy } from "../backend-policy.js";
5
+ import { clampDelegateDepth, MAX_DELEGATE_DEPTH, safeAgentKey } from "../helpers.ts";
6
+ import type { AgentDef, SubagentRole } from "../types.ts";
7
+ import { normalizeThinkingLevel } from "./overrides.ts";
8
+
9
+ function parseInlineSubagentRole(value: string): { model?: string; tools?: string; thinking?: string } {
10
+ const input = value.trim();
11
+ if (!input) return {};
12
+ if (input.startsWith("{")) {
13
+ const model = input.match(/model\s*:\s*([^\s,}]+)/)?.[1];
14
+ const tools = input.match(/tools\s*:\s*([\w,-]+)/)?.[1];
15
+ const thinking = input.match(/thinking\s*:\s*([^\s,}]+)/)?.[1];
16
+ return { ...(model ? { model } : {}), ...(tools ? { tools } : {}), ...(thinking ? { thinking } : {}) };
17
+ }
18
+ return { model: input };
19
+ }
20
+
21
+ export function parseAgentFile(filePath: string): AgentDef | null {
22
+ try {
23
+ const raw = readFileSync(filePath, "utf-8");
24
+ const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
25
+ if (!match) return null;
26
+ const frontmatter: Record<string, string> = {};
27
+ const lists: Record<string, string[]> = {};
28
+ const warnings: string[] = [];
29
+ let subagents: Record<string, SubagentRole> | undefined;
30
+ const lines = match[1].split("\n");
31
+ for (let i = 0; i < lines.length; i++) {
32
+ const line = lines[i];
33
+ const idx = line.indexOf(":");
34
+ if (idx <= 0) continue;
35
+ const key = line.slice(0, idx).trim();
36
+ const value = line.slice(idx + 1).trim();
37
+ if (key === "subagents") {
38
+ const entries: Record<string, { model?: string; tools?: string; thinking?: string }> = {};
39
+ let currentRole: string | null = null;
40
+ let roleIndent = -1;
41
+ let j = i + 1;
42
+ while (j < lines.length) {
43
+ const found = lines[j].match(/^(\s+)([a-z0-9]+(?:-[a-z0-9]+)*)\s*:\s*(.*)$/);
44
+ if (!found) break;
45
+ const indent = found[1].length;
46
+ if (roleIndent === -1) roleIndent = indent;
47
+ if (indent < roleIndent) break;
48
+ if (indent === roleIndent) {
49
+ currentRole = found[2];
50
+ entries[currentRole] = parseInlineSubagentRole(found[3]);
51
+ } else if (currentRole) {
52
+ const nested = found[3].trim();
53
+ if (found[2] === "model" && nested) entries[currentRole].model = nested;
54
+ else if (found[2] === "tools" && nested) entries[currentRole].tools = nested;
55
+ else if (found[2] === "thinking" && nested) entries[currentRole].thinking = nested;
56
+ }
57
+ j++;
58
+ }
59
+ i = j - 1;
60
+ const roles: Record<string, SubagentRole> = {};
61
+ for (const [role, entry] of Object.entries(entries)) {
62
+ if (!entry.model) { warnings.push(`subagents role "${role}" declares no model — skipped`); continue; }
63
+ let thinking: string | undefined;
64
+ if (entry.thinking) {
65
+ const normalized = normalizeThinkingLevel(entry.thinking);
66
+ if (normalized.warning) warnings.push(`subagents role "${role}" ${normalized.warning}`);
67
+ else thinking = normalized.level;
68
+ }
69
+ roles[role] = { model: entry.model, ...(entry.tools ? { tools: entry.tools } : {}), ...(thinking ? { thinking } : {}) };
70
+ }
71
+ if (Object.keys(roles).length) subagents = roles;
72
+ continue;
73
+ }
74
+ if (value) { frontmatter[key] = value; continue; }
75
+ const items: string[] = [];
76
+ let j = i + 1;
77
+ while (j < lines.length) {
78
+ const item = lines[j].match(/^\s+-\s+(.+)$/);
79
+ if (!item) break;
80
+ items.push(item[1].trim());
81
+ j++;
82
+ }
83
+ if (items.length) { lists[key] = items; i = j - 1; }
84
+ }
85
+ if (!frontmatter.name) return null;
86
+ try { safeAgentKey(frontmatter.name); } catch { return null; }
87
+ let delegateDepth: number | undefined;
88
+ if (frontmatter.delegate_depth !== undefined) {
89
+ const depth = Number(frontmatter.delegate_depth);
90
+ if (Number.isInteger(depth) && depth >= 0) {
91
+ delegateDepth = clampDelegateDepth(depth);
92
+ if (depth > MAX_DELEGATE_DEPTH) warnings.push(`delegate_depth "${frontmatter.delegate_depth}" exceeds the maximum (${MAX_DELEGATE_DEPTH}) — clamped to ${MAX_DELEGATE_DEPTH}`);
93
+ } else warnings.push(`delegate_depth "${frontmatter.delegate_depth}" is not a non-negative integer — using default (1)`);
94
+ }
95
+ return {
96
+ name: frontmatter.name, description: frontmatter.description || "", tools: frontmatter.tools || "read,grep,find,ls",
97
+ model: frontmatter.model || undefined, models: lists.models, subagents, delegateDepth,
98
+ warnings: warnings.length ? warnings : undefined, kind: frontmatter.kind || undefined,
99
+ thinking: frontmatter.thinking || undefined, systemPrompt: match[2].trim(), file: filePath,
100
+ };
101
+ } catch { return null; }
102
+ }
103
+
104
+ export function parseModelProfilesYaml(raw: string): Record<string, Record<string, string>> {
105
+ const profiles: Record<string, Record<string, string>> = {};
106
+ let current: string | null = null;
107
+ for (const line of raw.split("\n")) {
108
+ if (/^\s*(#|$)/.test(line)) continue;
109
+ const top = line.match(/^(\S[^:]*):\s*$/);
110
+ if (top) { current = top[1].trim(); profiles[current] = {}; continue; }
111
+ const pair = line.match(/^\s+([\w-]+)\s*:\s*(.+?)\s*$/);
112
+ if (pair && current) profiles[current][pair[1].toLowerCase()] = pair[2];
113
+ }
114
+ return profiles;
115
+ }
116
+
117
+ export interface AgentConfigurationPorts {
118
+ setSessionDir(value: string): void;
119
+ getSessionDir(): string;
120
+ archivePreviousRun(): void;
121
+ ensureArtifactsLayout(): void;
122
+ resetAssertions(): void;
123
+ setAgentDefs(value: AgentDef[]): void;
124
+ setTeams(value: Record<string, string[]>): void;
125
+ setModelProfiles(value: Record<string, Record<string, string>>): void;
126
+ setDispatchPolicy(value: any): void;
127
+ setDispatchPolicyWarnings(value: string[]): void;
128
+ }
129
+
130
+ export function loadAgentConfiguration(cwd: string, ports: AgentConfigurationPorts): void {
131
+ ports.setSessionDir(safePathWithin(cwd, ".pi", "agent-sessions"));
132
+ const sessionDir = ports.getSessionDir();
133
+ if (!existsSync(sessionDir)) mkdirSync(sessionDir, { recursive: true });
134
+ for (const directory of ["findings", "delegations", "transcripts"]) {
135
+ try { rmSync(safePathWithin(sessionDir, directory), { recursive: true, force: true }); } catch {}
136
+ }
137
+ ports.archivePreviousRun();
138
+ ports.ensureArtifactsLayout();
139
+ try { rmSync(safePathWithin(sessionDir, "assertions.json"), { force: true }); } catch {}
140
+ ports.resetAssertions();
141
+ const defs = scanAgentDirs(cwd);
142
+ ports.setAgentDefs(defs);
143
+ const teamsPath = join(cwd, ".pi", "agents", "teams.yaml");
144
+ let teams: Record<string, string[]> = {};
145
+ if (existsSync(teamsPath)) try { teams = parseTeamsYaml(readFileSync(teamsPath, "utf-8")); } catch {}
146
+ if (!Object.keys(teams).length) teams = { all: defs.map(def => def.name) };
147
+ ports.setTeams(teams);
148
+ const profilesPath = join(cwd, ".pi", "agents", "model-profiles.yaml");
149
+ let profiles: Record<string, Record<string, string>> = {};
150
+ if (existsSync(profilesPath)) try { profiles = parseModelProfilesYaml(readFileSync(profilesPath, "utf-8")); } catch {}
151
+ ports.setModelProfiles(profiles);
152
+ const policyPath = join(cwd, ".pi", "agents", "dispatch-policy.yaml");
153
+ ports.setDispatchPolicy({ default: "native", grace_s: 30, substitutions: {} });
154
+ ports.setDispatchPolicyWarnings([]);
155
+ if (existsSync(policyPath)) {
156
+ try {
157
+ const parsed = parseDispatchPolicy(readFileSync(policyPath, "utf-8"));
158
+ ports.setDispatchPolicy(parsed.policy);
159
+ ports.setDispatchPolicyWarnings(parsed.warnings);
160
+ } catch (error) {
161
+ ports.setDispatchPolicyWarnings([`dispatch-policy.yaml unreadable: ${error instanceof Error ? error.message : String(error)}`]);
162
+ }
163
+ }
164
+ }
165
+
166
+ export function scanAgentDirs(cwd: string): AgentDef[] {
167
+ const agents: AgentDef[] = [];
168
+ const seen = new Set<string>();
169
+ for (const dir of [join(cwd, "agents"), join(cwd, ".claude", "agents"), join(cwd, ".pi", "agents")]) {
170
+ if (!existsSync(dir)) continue;
171
+ try {
172
+ for (const file of readdirSync(dir)) {
173
+ if (!file.endsWith(".md")) continue;
174
+ const def = parseAgentFile(resolve(dir, file));
175
+ if (def && !seen.has(def.name.toLowerCase())) { seen.add(def.name.toLowerCase()); agents.push(def); }
176
+ }
177
+ } catch {}
178
+ }
179
+ return agents;
180
+ }
@@ -0,0 +1,153 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { clampDelegateDepth, MAX_DELEGATE_DEPTH } from "../helpers.ts";
4
+ import { DEFAULT_RUN_HISTORY_KEEP, normalizeRunHistoryKeep } from "../run-namespace.js";
5
+ import { DEFAULT_WATCHDOG_SETTING, WATCHDOG_SETTINGS, normalizeWatchdogSetting } from "../drift-watchdog.js";
6
+ import type { SubagentRole } from "../types.ts";
7
+
8
+ export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"] as const;
9
+ const VALID_THINKING_LEVELS = new Set<string>(THINKING_LEVELS);
10
+
11
+ export function normalizeThinkingLevel(value: string | undefined | null): { level: string; warning?: string } {
12
+ if (value == null || String(value).trim() === "") return { level: "off" };
13
+ const level = String(value).trim().toLowerCase();
14
+ if (VALID_THINKING_LEVELS.has(level)) return { level };
15
+ return { level: "off", warning: `thinking "${value}" is not a valid level (off|minimal|low|medium|high|xhigh) — using off` };
16
+ }
17
+
18
+ export interface AgentTeamOverrides {
19
+ language: string;
20
+ personaModels: Record<string, string>;
21
+ personaModelLists: Record<string, string[]>;
22
+ personaThinking: Record<string, string>;
23
+ personaSubagents: Record<string, Record<string, SubagentRole>>;
24
+ personaDelegateDepth: Record<string, number>;
25
+ rulesDirs: string[];
26
+ docsPaths: string[];
27
+ reconSearchTimeoutMs: number | null;
28
+ budgetOverrides: { maxDispatches?: number | null; maxResearch?: number | null; wallMs?: number | null; agentTurnMs?: number | null; recycleRuns?: number | null };
29
+ watchdogSetting: string;
30
+ watchdogJudgeModel: string | null;
31
+ runHistoryKeep: number | null;
32
+ pollPanel: string | null;
33
+ warnings: string[];
34
+ }
35
+
36
+ export const DEFAULT_OVERRIDES: AgentTeamOverrides = {
37
+ language: "English", personaModels: {}, personaModelLists: {}, personaThinking: {}, personaSubagents: {}, personaDelegateDepth: {},
38
+ rulesDirs: [], docsPaths: [], reconSearchTimeoutMs: 120_000, budgetOverrides: {},
39
+ watchdogSetting: DEFAULT_WATCHDOG_SETTING, watchdogJudgeModel: null, runHistoryKeep: DEFAULT_RUN_HISTORY_KEEP, pollPanel: null, warnings: [],
40
+ };
41
+
42
+ function freshOverrides(): AgentTeamOverrides {
43
+ return { ...DEFAULT_OVERRIDES, personaModels: {}, personaModelLists: {}, personaThinking: {}, personaSubagents: {}, personaDelegateDepth: {}, rulesDirs: [], docsPaths: [], budgetOverrides: {}, pollPanel: null, warnings: [] };
44
+ }
45
+
46
+ function parseSubagentOverride(value: string): { model: string; tools?: string; thinking?: string } | null {
47
+ const trimmed = value.trim();
48
+ if (!trimmed) return null;
49
+ const match = trimmed.match(/^([^\s,]+)(?:\s*,\s*(.*))?$/);
50
+ if (!match) return null;
51
+ const result: { model: string; tools?: string; thinking?: string } = { model: match[1] };
52
+ const rest = match[2] ?? "";
53
+ if (!rest) return result;
54
+ for (const chunk of rest.split(/\s*,\s*(?=[A-Za-z][\w-]*\s*=)/)) {
55
+ const pair = chunk.match(/^([A-Za-z][\w-]*)\s*=\s*(.+)$/);
56
+ if (!pair) continue;
57
+ const key = pair[1].toLowerCase();
58
+ const item = pair[2].trim();
59
+ if (key === "tools" && item) result.tools = item;
60
+ else if (key === "thinking" && item) result.thinking = item;
61
+ }
62
+ return result;
63
+ }
64
+
65
+ export function parseAgentTeamOverrides(cwd: string): AgentTeamOverrides {
66
+ const file = join(cwd, ".ai", "agent-fleet-overrides.md");
67
+ if (!existsSync(file)) return freshOverrides();
68
+ let raw: string;
69
+ try { raw = readFileSync(file, "utf-8"); } catch { return freshOverrides(); }
70
+ const result = freshOverrides();
71
+ let inSection = false;
72
+ for (const rawLine of raw.split("\n")) {
73
+ const line = rawLine.replace(/\r$/, "");
74
+ const heading = line.match(/^##\s+(.+?)\s*$/);
75
+ if (heading) { const name = heading[1].trim().toLowerCase(); inSection = name === "agent-hub" || name === "agent-team"; continue; }
76
+ if (!inSection) continue;
77
+ const pair = line.match(/^\s*([a-zA-Z][\w.-]*)\s*:\s*(.+?)\s*$/);
78
+ if (!pair) continue;
79
+ const key = pair[1].toLowerCase();
80
+ const value = pair[2].trim();
81
+ if (key === "language" && value) result.language = value;
82
+ if (key === "rules" && value) result.rulesDirs = value.split(",").map(s => s.trim()).filter(Boolean);
83
+ if (key === "docs" && value) result.docsPaths = value.split(",").map(s => s.trim()).filter(Boolean);
84
+ if (key === "run-history-keep" && value) {
85
+ const keep = normalizeRunHistoryKeep(value);
86
+ if (keep === undefined) result.warnings.push(`run-history-keep "${value}" is not a positive integer or "off" — using the default (${DEFAULT_RUN_HISTORY_KEEP})`);
87
+ else result.runHistoryKeep = keep;
88
+ }
89
+ if (key === "research-keep" && value) {
90
+ result.warnings.push("research-keep is removed; live research helpers disappear when they finish. Delete this key.");
91
+ }
92
+ if (key === "recon-search-timeout-s" && value) {
93
+ if (value.toLowerCase() === "off") result.reconSearchTimeoutMs = null;
94
+ else if (/^\d+$/.test(value) && Number(value) >= 1 && Number(value) <= 3600) result.reconSearchTimeoutMs = Number(value) * 1000;
95
+ else result.warnings.push(`recon-search-timeout-s "${value}" is not an integer from 1 to 3600 or "off" — using the default (120)`);
96
+ }
97
+ if (key === "mode" && value) result.warnings.push(`mode "${value}" is ignored — execution modes were removed; budgets follow task tier. Remove this key.`);
98
+ if (key === "watchdog" && value) {
99
+ const setting = normalizeWatchdogSetting(value);
100
+ if (setting) result.watchdogSetting = setting;
101
+ else result.warnings.push(`watchdog "${value}" is not one of ${WATCHDOG_SETTINGS.join("|")} — using the default (${DEFAULT_WATCHDOG_SETTING})`);
102
+ }
103
+ if (key === "watchdog-judge-model" && value) result.watchdogJudgeModel = value;
104
+ if (key === "poll-panel" && value) result.pollPanel = value;
105
+ const budgetKeys: Record<string, { field: keyof AgentTeamOverrides["budgetOverrides"]; scaleMs: boolean }> = {
106
+ "max-dispatches-per-turn": { field: "maxDispatches", scaleMs: false }, "max-research-per-turn": { field: "maxResearch", scaleMs: false },
107
+ "turn-wall-time-s": { field: "wallMs", scaleMs: true }, "agent-turn-timeout-s": { field: "agentTurnMs", scaleMs: true }, "session-recycle-runs": { field: "recycleRuns", scaleMs: false },
108
+ };
109
+ if (budgetKeys[key] && value) {
110
+ const { field, scaleMs } = budgetKeys[key];
111
+ if (value.toLowerCase() === "off") result.budgetOverrides[field] = null;
112
+ else if (/^\d+$/.test(value) && Number(value) >= 1) result.budgetOverrides[field] = Number(value) * (scaleMs ? 1000 : 1);
113
+ else result.warnings.push(`${key} "${value}" is not a positive integer or "off" — using the task-tier default`);
114
+ }
115
+ const slug = "[a-z0-9]+(?:-[a-z0-9]+)*";
116
+ const model = key.match(new RegExp(`^model\\.(${slug})$`));
117
+ if (model && value) result.personaModels[model[1]] = value;
118
+ const models = key.match(new RegExp(`^models\\.(${slug})$`));
119
+ if (models && value) result.personaModelLists[models[1]] = value.split(",").map(s => s.trim()).filter(Boolean);
120
+ const thinking = key.match(new RegExp(`^thinking\\.(${slug})$`));
121
+ if (thinking && value) {
122
+ const level = value.toLowerCase();
123
+ if (VALID_THINKING_LEVELS.has(level)) result.personaThinking[thinking[1]] = level;
124
+ else result.warnings.push(`thinking.${thinking[1]} "${value}" is not a valid level (off|minimal|low|medium|high|xhigh) — ignored`);
125
+ }
126
+ const subagent = key.match(new RegExp(`^subagents\\.(${slug})\\.(${slug})$`));
127
+ if (subagent && value) {
128
+ const parsed = parseSubagentOverride(value);
129
+ if (parsed) {
130
+ let thinking: string | undefined;
131
+ if (parsed.thinking) {
132
+ const normalized = normalizeThinkingLevel(parsed.thinking);
133
+ if (normalized.warning) result.warnings.push(`subagents.${subagent[1]}.${subagent[2]} ${normalized.warning}`);
134
+ else thinking = normalized.level;
135
+ }
136
+ (result.personaSubagents[subagent[1]] ||= {})[subagent[2]] = {
137
+ model: parsed.model,
138
+ ...(parsed.tools ? { tools: parsed.tools } : {}),
139
+ ...(thinking ? { thinking } : {}),
140
+ };
141
+ }
142
+ }
143
+ const depth = key.match(new RegExp(`^delegate-depth\\.(${slug})$`));
144
+ if (depth && value) {
145
+ const count = Number(value);
146
+ if (Number.isInteger(count) && count >= 0) {
147
+ result.personaDelegateDepth[depth[1]] = clampDelegateDepth(count);
148
+ if (count > MAX_DELEGATE_DEPTH) result.warnings.push(`delegate-depth.${depth[1]} ${count} exceeds the maximum (${MAX_DELEGATE_DEPTH}) — clamped to ${MAX_DELEGATE_DEPTH}`);
149
+ }
150
+ }
151
+ }
152
+ return result;
153
+ }
@@ -0,0 +1,30 @@
1
+ import * as fs from "node:fs";
2
+ import { renameSync } from "node:fs";
3
+ import { quarantineIfUnusable } from "../session-health.js";
4
+ import { safeAgentKey, safePathWithin } from "../helpers.ts";
5
+ import type { AgentDef, AgentState } from "../types.ts";
6
+
7
+ const SESSION_HEAD_BYTES = 64 * 1024;
8
+
9
+ function readSessionHead(file: string): string {
10
+ const fd = fs.openSync(file, "r");
11
+ try {
12
+ const buffer = Buffer.alloc(SESSION_HEAD_BYTES);
13
+ const read = fs.readSync(fd, buffer, 0, SESSION_HEAD_BYTES, 0);
14
+ return buffer.subarray(0, read).toString("utf-8");
15
+ } finally { fs.closeSync(fd); }
16
+ }
17
+
18
+ export function createAgentStateFactory(getSessionDir: () => string) {
19
+ const io = { existsSync: fs.existsSync, readFileSync: readSessionHead, renameSync };
20
+ const adoptableSessionFile = (def: AgentDef) => {
21
+ const sessionFile = safePathWithin(getSessionDir(), `${safeAgentKey(def.name)}.json`);
22
+ const health = quarantineIfUnusable(sessionFile, io);
23
+ return { file: health.usable ? sessionFile : null, quarantined: health.quarantined, reason: health.reason };
24
+ };
25
+ const freshAgentState = (def: AgentDef, adoption = adoptableSessionFile(def)): AgentState => ({
26
+ def, status: "idle", task: "", toolCount: 0, elapsed: 0, lastWork: "", contextPct: 0, contextTokens: 0,
27
+ sessionFile: adoption.file, runCount: 0, runsSinceFresh: 0, timeline: [],
28
+ });
29
+ return { sessionHealthIo: io, adoptableSessionFile, freshAgentState, quarantine: (def: AgentDef) => quarantineIfUnusable(safePathWithin(getSessionDir(), `${safeAgentKey(def.name)}.json`), io) };
30
+ }
@@ -0,0 +1,211 @@
1
+ import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
2
+ import * as path from "node:path";
3
+ import { safePathWithin } from "../helpers.ts";
4
+ import { artifactPreviewFromText, formatInputArtifactsSection, resolveArtifactPaths, ARTIFACT_KINDS } from "../artifacts.js";
5
+ import { appendRunIndex, buildRunMeta, makeRunId, pruneRunDirs, RUN_INDEX_FILENAME, RUNS_DIRNAME } from "../run-namespace.js";
6
+
7
+ export type AssertionStatus = "open" | "proven" | "unproven" | "failed";
8
+
9
+ export interface Assertion {
10
+ id: string;
11
+ tag: string;
12
+ text: string;
13
+ source: string;
14
+ status: AssertionStatus;
15
+ evidence?: string;
16
+ }
17
+
18
+ export interface InputArtifactPreview {
19
+ input: string;
20
+ path: string;
21
+ displayPath: string;
22
+ preview: string;
23
+ resolvedFromKind?: string | null;
24
+ }
25
+
26
+ export interface AssertionsArtifactsStatePorts {
27
+ getAssertions(): Assertion[];
28
+ getSessionDir(): string;
29
+ getRunHistoryKeep(): number | null;
30
+ setStatus(key: string, value: string): void;
31
+ }
32
+
33
+ export interface AssertionsArtifactsContext {
34
+ persistAssertions(): void;
35
+ assertionStatusLine(): string;
36
+ renderAssertionLedgerLines(): string[];
37
+ renderAssertionLedgerText(): string;
38
+ updateAssertionStatus(): void;
39
+ artifactsRoot(): string;
40
+ ensureArtifactsLayout(): string;
41
+ archivePreviousRun(): string | null;
42
+ loadInputArtifacts(paths: string[] | undefined, ctx: { cwd?: string }): InputArtifactPreview[];
43
+ appendInputArtifacts(task: string, artifacts: InputArtifactPreview[]): string;
44
+ writeRunArtifact(agentKey: string, runCount: number, output: string, kind?: "returns" | "failures"): string;
45
+ evidencePathExists(evidencePath: string): boolean;
46
+ listArtifactFiles(): string[];
47
+ renderArtifactIndexText(): string;
48
+ appendMachineHandoffSections(brief: string): string;
49
+ }
50
+
51
+ export function createAssertionsArtifactsContext(state: AssertionsArtifactsStatePorts): AssertionsArtifactsContext {
52
+ const artifactsRoot = () => safePathWithin(state.getSessionDir(), "artifacts");
53
+ const ensureArtifactsLayout = () => {
54
+ const root = artifactsRoot();
55
+ mkdirSync(root, { recursive: true });
56
+ for (const kind of ARTIFACT_KINDS) mkdirSync(safePathWithin(root, kind), { recursive: true });
57
+ return root;
58
+ };
59
+ const assertionStatusLine = () => {
60
+ const assertions = state.getAssertions();
61
+ if (assertions.length === 0) return "";
62
+ const count = (status: AssertionStatus) => assertions.filter(assertion => assertion.status === status).length;
63
+ const open = assertions.filter(assertion => assertion.status === "open" || assertion.status === "unproven").map(assertion => assertion.id);
64
+ const failed = assertions.filter(assertion => assertion.status === "failed").map(assertion => assertion.id);
65
+ const head = `Assertions: ${count("proven")}✓ ${open.length}○ ${count("failed")}✗`;
66
+ if (failed.length) return `${head} · failed: ${failed.join(",")}`;
67
+ if (open.length) return `${head} · open: ${open.join(",")}`;
68
+ return `${head} · all proven`;
69
+ };
70
+ const renderAssertionLedgerLines = () => state.getAssertions().map(assertion => {
71
+ const evidence = assertion.evidence ? ` — evidence: ${assertion.evidence}` : "";
72
+ const source = assertion.source ? ` ⇐ ${assertion.source}` : "";
73
+ return `${assertion.id} [${assertion.tag}] ${assertion.status.toUpperCase()}: ${assertion.text}${source}${evidence}`;
74
+ });
75
+ const renderAssertionLedgerText = () => state.getAssertions().length === 0
76
+ ? ""
77
+ : `${assertionStatusLine()}\n${renderAssertionLedgerLines().join("\n")}`;
78
+ const listArtifactFiles = () => {
79
+ const root = artifactsRoot();
80
+ if (!existsSync(root)) return [];
81
+ const out: string[] = [];
82
+ const walk = (dir: string) => {
83
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
84
+ const full = path.join(dir, entry.name);
85
+ if (entry.isDirectory()) walk(full);
86
+ else if (entry.isFile()) out.push(full);
87
+ }
88
+ };
89
+ try { walk(root); } catch { return []; }
90
+ return out.sort();
91
+ };
92
+ const renderArtifactIndexText = () => {
93
+ const root = artifactsRoot();
94
+ return listArtifactFiles().map(file => {
95
+ const relative = path.relative(root, file).split(path.sep).join("/");
96
+ let preview = "(unreadable)";
97
+ try { preview = artifactPreviewFromText(readFileSync(file, "utf-8")); } catch {}
98
+ return `artifacts/${relative} — ${preview}`;
99
+ }).join("\n");
100
+ };
101
+
102
+ return {
103
+ persistAssertions() {
104
+ if (!state.getSessionDir()) return;
105
+ try { writeFileSync(safePathWithin(state.getSessionDir(), "assertions.json"), JSON.stringify(state.getAssertions(), null, 2)); } catch {}
106
+ },
107
+ assertionStatusLine,
108
+ renderAssertionLedgerLines,
109
+ renderAssertionLedgerText,
110
+ updateAssertionStatus() {
111
+ const line = assertionStatusLine();
112
+ if (!line) return;
113
+ try { state.setStatus("assertions", line); } catch {}
114
+ },
115
+ artifactsRoot,
116
+ ensureArtifactsLayout,
117
+ archivePreviousRun() {
118
+ const root = artifactsRoot();
119
+ if (!existsSync(root)) return null;
120
+ const counts: Record<string, number> = {};
121
+ let total = 0;
122
+ try {
123
+ for (const kind of ARTIFACT_KINDS) {
124
+ const dir = safePathWithin(root, kind);
125
+ if (!existsSync(dir)) continue;
126
+ const count = readdirSync(dir).length;
127
+ if (count > 0) counts[kind] = count;
128
+ total += count;
129
+ }
130
+ } catch {}
131
+ if (total === 0) {
132
+ try { rmSync(root, { recursive: true, force: true }); } catch {}
133
+ return null;
134
+ }
135
+ const runId = makeRunId();
136
+ try {
137
+ const sessionDir = state.getSessionDir();
138
+ const runsDir = safePathWithin(sessionDir, RUNS_DIRNAME);
139
+ const runDir = safePathWithin(runsDir, runId);
140
+ mkdirSync(runDir, { recursive: true });
141
+ renameSync(root, safePathWithin(runDir, "artifacts"));
142
+ const meta = buildRunMeta({
143
+ runId, archivedAt: Date.now(), cwd: sessionDir,
144
+ project: process.env.PI_COMS_PROJECT || null,
145
+ workspace: process.env.HERDR_WORKSPACE_ID || null,
146
+ artifactCounts: counts,
147
+ });
148
+ const metaPath = safePathWithin(runDir, "meta.json");
149
+ writeFileSync(metaPath, JSON.stringify(meta, null, 2));
150
+ try { chmodSync(metaPath, 0o444); } catch {}
151
+ const indexPath = safePathWithin(runsDir, RUN_INDEX_FILENAME);
152
+ let existing: unknown = null;
153
+ try { existing = JSON.parse(readFileSync(indexPath, "utf-8")); } catch {}
154
+ const index = appendRunIndex(existing, {
155
+ runId, archivedAt: meta.archivedAt, artifactCounts: counts,
156
+ project: meta.project, workspace: meta.workspace,
157
+ }, state.getRunHistoryKeep());
158
+ writeFileSync(indexPath, JSON.stringify(index, null, 2));
159
+ for (const stale of pruneRunDirs(readdirSync(runsDir), state.getRunHistoryKeep())) {
160
+ try { rmSync(safePathWithin(runsDir, stale), { recursive: true, force: true }); } catch {}
161
+ }
162
+ return runId;
163
+ } catch {
164
+ return null;
165
+ }
166
+ },
167
+ loadInputArtifacts(paths, ctx) {
168
+ if (!paths?.length) return [];
169
+ const root = ensureArtifactsLayout();
170
+ return resolveArtifactPaths(paths, {
171
+ repoDir: ctx.cwd || process.cwd(), sessionDir: state.getSessionDir(), artifactRoot: root, exists: existsSync,
172
+ }).map((item: any) => {
173
+ if (!existsSync(item.path)) throw new Error(`Artifact not found: ${item.input} (resolved to ${item.path})`);
174
+ return { ...item, preview: artifactPreviewFromText(readFileSync(item.path, "utf-8")) };
175
+ });
176
+ },
177
+ appendInputArtifacts(task, artifacts) { return artifacts.length ? task + formatInputArtifactsSection(artifacts) : task; },
178
+ writeRunArtifact(agentKey, runCount, output, kind = "returns") {
179
+ const dir = safePathWithin(ensureArtifactsLayout(), kind);
180
+ mkdirSync(dir, { recursive: true });
181
+ const file = safePathWithin(dir, `${agentKey}-run${runCount}.md`);
182
+ writeFileSync(file, output, "utf-8");
183
+ return file;
184
+ },
185
+ evidencePathExists(evidencePath) {
186
+ const raw = String(evidencePath || "").trim().replace(/\\/g, "/");
187
+ const evidenceRoot = safePathWithin(artifactsRoot(), "evidence");
188
+ let candidate: string | null = null;
189
+ try {
190
+ if (raw.startsWith("artifacts/evidence/")) candidate = safePathWithin(evidenceRoot, raw.slice("artifacts/evidence/".length));
191
+ else if (raw.startsWith(".pi/agent-sessions/artifacts/evidence/")) candidate = safePathWithin(evidenceRoot, raw.slice(".pi/agent-sessions/artifacts/evidence/".length));
192
+ else if (path.isAbsolute(raw)) {
193
+ const resolved = path.resolve(raw);
194
+ const relative = path.relative(evidenceRoot, resolved);
195
+ if (!relative.startsWith("..") && !path.isAbsolute(relative)) candidate = resolved;
196
+ }
197
+ } catch { candidate = null; }
198
+ return !!candidate && existsSync(candidate);
199
+ },
200
+ listArtifactFiles,
201
+ renderArtifactIndexText,
202
+ appendMachineHandoffSections(brief) {
203
+ const sections: string[] = [];
204
+ const ledger = renderAssertionLedgerText();
205
+ if (ledger) sections.push(`## Verification ledger (verbatim, machine-appended)\n${ledger}`);
206
+ const artifacts = renderArtifactIndexText();
207
+ if (artifacts) sections.push(`## Artifact index\n${artifacts}`);
208
+ return sections.length ? `${brief}\n\n${sections.join("\n\n")}` : brief;
209
+ },
210
+ };
211
+ }