@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,92 @@
1
+ import { spawnSync } from "node:child_process";
2
+
3
+ export type VisibilityCheckName = "registered" | "auth" | "child-visible";
4
+ export interface ModelCheck {
5
+ model: string;
6
+ ok: boolean;
7
+ failed: VisibilityCheckName[];
8
+ reasons: string[];
9
+ }
10
+ export interface ChildVisibilityReport { models: ModelCheck[]; diagnostic?: string }
11
+ export interface ModelRegistryAuth {
12
+ isRegistered(model: string): boolean;
13
+ hasAuth(model: string): boolean;
14
+ }
15
+ export type ModelListing = { models?: string[]; diagnostic?: string };
16
+ export type ListModels = () => ModelListing;
17
+
18
+ let listingCache: ModelListing | undefined;
19
+
20
+ export function resetModelVisibilityCache(): void {
21
+ listingCache = undefined;
22
+ }
23
+
24
+ export function parseListModelsOutput(text: string): string[] {
25
+ const cleaned = text.replace(/\u001B\[[0-9;]*m/g, "");
26
+ const lines = cleaned.split(/\r?\n/).map(line => line.trimEnd()).filter(line => line.trim());
27
+ if (lines.length === 0) return [];
28
+ const models = new Set<string>();
29
+ for (const line of lines.slice(1)) {
30
+ const parts = line.trim().split(/\s+/);
31
+ if (parts.length < 2 || (parts[0] === "provider" && parts[1] === "model")) continue;
32
+ models.add(`${parts[0]}/${parts[1]}`);
33
+ }
34
+ return [...models];
35
+ }
36
+
37
+ export function checkChildVisibility(models: string[], listModels?: ListModels): ChildVisibilityReport {
38
+ const listing = loadListing(listModels);
39
+ if (listing.diagnostic) {
40
+ return {
41
+ diagnostic: listing.diagnostic,
42
+ models: models.map(model => ({
43
+ model, ok: false, failed: [],
44
+ reasons: [`${model}: child-visible check not performed — ${listing.diagnostic}`],
45
+ })),
46
+ };
47
+ }
48
+ const visible = new Set(listing.models ?? []);
49
+ return {
50
+ models: models.map(model => visible.has(model)
51
+ ? { model, ok: true, failed: [], reasons: [] }
52
+ : {
53
+ model, ok: false, failed: ["child-visible"],
54
+ reasons: [`${model}: child-visible check failed — not listed by pi --no-extensions --list-models`],
55
+ }),
56
+ };
57
+ }
58
+
59
+ export function checkRegistryAuth(models: string[], registry: ModelRegistryAuth): ModelCheck[] {
60
+ return models.map(model => {
61
+ if (!registry.isRegistered(model)) {
62
+ return {
63
+ model, ok: false, failed: ["registered"],
64
+ reasons: [`${model}: registered check failed — model is not in the pi model registry`],
65
+ };
66
+ }
67
+ if (!registry.hasAuth(model)) {
68
+ return {
69
+ model, ok: false, failed: ["auth"],
70
+ reasons: [`${model}: auth check failed — no configured credentials`],
71
+ };
72
+ }
73
+ return { model, ok: true, failed: [], reasons: [] };
74
+ });
75
+ }
76
+
77
+ function loadListing(listModels?: ListModels): ModelListing {
78
+ if (listingCache) return listingCache;
79
+ try { listingCache = listModels ? listModels() : defaultListModels(); }
80
+ catch (error) { listingCache = { diagnostic: error instanceof Error ? error.message : String(error) }; }
81
+ return listingCache;
82
+ }
83
+
84
+ function defaultListModels(): ModelListing {
85
+ const result = spawnSync("pi", ["--no-extensions", "--list-models"], { encoding: "utf8", timeout: 15_000 });
86
+ if (result.error) return { diagnostic: `pi --no-extensions --list-models failed: ${result.error.message}` };
87
+ if (result.status !== 0) {
88
+ const detail = (result.stderr || result.stdout || `exit ${result.status}`).trim();
89
+ return { diagnostic: `pi --no-extensions --list-models failed: ${detail}` };
90
+ }
91
+ return { models: parseListModelsOutput(result.stdout) };
92
+ }
@@ -0,0 +1,130 @@
1
+ import { execFileSync } from "node:child_process";
2
+ import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
3
+ import { dirname, relative, resolve, sep } from "node:path";
4
+ import { createHash } from "node:crypto";
5
+
6
+ interface PathState {
7
+ path: string;
8
+ numstat: string;
9
+ index?: { mode: string; object: string; stage: string };
10
+ worktree?: { kind: "file" | "symlink"; data: string; hash: string };
11
+ headTracked: boolean;
12
+ }
13
+ export interface PermissionSnapshot { cwd: string; paths: Map<string, PathState> }
14
+ export interface PermissionPolicy { writes?: string[]; protectedGlobs?: string[]; alwaysWritable?: string[] }
15
+ export interface PermissionEnforcement { changed: string[]; violations: string[]; preDirtyPreserved: string[] }
16
+
17
+ export class PermissionBreach extends Error {
18
+ readonly paths: string[];
19
+ readonly exitCode = 1;
20
+ readonly terminal = true;
21
+ constructor(paths: string[], preserved: string[] = []) {
22
+ super(`PermissionBreach: unauthorized repository changes: ${paths.join(", ")}${preserved.length ? `; restored pre-dirty state for: ${preserved.join(", ")}` : ""}`);
23
+ this.name = "PermissionBreach";
24
+ this.paths = paths;
25
+ }
26
+ }
27
+
28
+ function git(cwd: string, args: string[]): string {
29
+ return execFileSync("git", args, { cwd, encoding: "utf8" });
30
+ }
31
+ function zlist(value: string): string[] { return value.split("\0").filter(Boolean); }
32
+ function worktreeState(cwd: string, path: string): PathState["worktree"] {
33
+ const full = resolve(cwd, path);
34
+ if (!existsSync(full)) return undefined;
35
+ const stat = lstatSync(full);
36
+ if (stat.isDirectory()) return undefined;
37
+ const kind = stat.isSymbolicLink() ? "symlink" : "file";
38
+ const data = kind === "symlink" ? Buffer.from(readlinkSync(full)).toString("base64") : readFileSync(full).toString("base64");
39
+ return { kind, data, hash: createHash("sha256").update(data).digest("hex") };
40
+ }
41
+ function indexState(cwd: string, path: string): PathState["index"] {
42
+ const raw = git(cwd, ["ls-files", "-s", "-z", "--", path]);
43
+ const match = raw.match(/^(\d+) ([0-9a-f]+) (\d+)\t/);
44
+ return match ? { mode: match[1], object: match[2], stage: match[3] } : undefined;
45
+ }
46
+ function headTracked(cwd: string, path: string): boolean {
47
+ try { execFileSync("git", ["cat-file", "-e", `HEAD:${path}`], { cwd, stdio: "ignore" }); return true; } catch { return false; }
48
+ }
49
+
50
+ export function snapshot(cwd = process.cwd()): PermissionSnapshot {
51
+ const numstat = git(cwd, ["diff", "HEAD", "--no-renames", "--numstat", "-z"]);
52
+ const rows = zlist(numstat);
53
+ const stats = new Map<string, string>();
54
+ for (const row of rows) {
55
+ const match = row.match(/^([^\t]+)\t([^\t]+)\t([\s\S]+)$/);
56
+ if (match) stats.set(match[3], `${match[1]}\t${match[2]}`);
57
+ }
58
+ const trackedChanges = zlist(git(cwd, ["diff", "HEAD", "--no-renames", "--name-only", "-z"]));
59
+ const untracked = zlist(git(cwd, ["ls-files", "--others", "--exclude-standard", "-z"]));
60
+ const paths = new Map<string, PathState>();
61
+ for (const path of new Set([...trackedChanges, ...untracked])) {
62
+ paths.set(path, { path, numstat: stats.get(path) ?? "untracked", index: indexState(cwd, path), worktree: worktreeState(cwd, path), headTracked: headTracked(cwd, path) });
63
+ }
64
+ return { cwd: resolve(cwd), paths };
65
+ }
66
+ function signature(state?: PathState): string { return state ? JSON.stringify(state) : "clean"; }
67
+ export function changedPaths(before: PermissionSnapshot, after: PermissionSnapshot): string[] {
68
+ const paths = new Set([...before.paths.keys(), ...after.paths.keys()]);
69
+ return [...paths].filter(path => signature(before.paths.get(path)) !== signature(after.paths.get(path))).sort();
70
+ }
71
+
72
+ function globRegex(pattern: string): RegExp {
73
+ let input = pattern.replaceAll("\\", "/").replace(/^\.\//, "");
74
+ if (input.endsWith("/")) input += "**";
75
+ let source = "^";
76
+ for (let i = 0; i < input.length; i++) {
77
+ const char = input[i];
78
+ if (char === "*" && input[i + 1] === "*") {
79
+ i++;
80
+ if (input[i + 1] === "/") { i++; source += "(?:.*/)?"; } else source += ".*";
81
+ } else if (char === "*") source += "[^/]*";
82
+ else if (char === "?") source += "[^/]";
83
+ else source += char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
84
+ }
85
+ return new RegExp(`${source}$`);
86
+ }
87
+ export function matchesWriteGlob(path: string, pattern: string): boolean { return globRegex(pattern).test(path.replaceAll("\\", "/")); }
88
+ export function permitted(path: string, policy: PermissionPolicy, cwd = process.cwd()): boolean {
89
+ const normalized = path.replaceAll("\\", "/").replace(/^\.\//, "");
90
+ for (const always of policy.alwaysWritable ?? []) {
91
+ const rel = relative(resolve(cwd), resolve(always)).split(sep).join("/");
92
+ if (normalized === rel || normalized.startsWith(`${rel}/`)) return true;
93
+ }
94
+ const explicitlyAllowed = policy.writes?.some(glob => matchesWriteGlob(normalized, glob)) ?? false;
95
+ if ((policy.protectedGlobs ?? []).some(glob => matchesWriteGlob(normalized, glob)) && !explicitlyAllowed) return false;
96
+ return policy.writes === undefined || explicitlyAllowed;
97
+ }
98
+
99
+ function restoreState(cwd: string, path: string, state?: PathState): void {
100
+ const full = resolve(cwd, path);
101
+ if (!state) {
102
+ if (headTracked(cwd, path)) execFileSync("git", ["restore", "--source=HEAD", "--staged", "--worktree", "--", path], { cwd });
103
+ else { rmSync(full, { recursive: true, force: true }); try { execFileSync("git", ["update-index", "--force-remove", "--", path], { cwd, stdio: "ignore" }); } catch {} }
104
+ return;
105
+ }
106
+ if (state.index) execFileSync("git", ["update-index", "--add", "--cacheinfo", `${state.index.mode},${state.index.object},${path}`], { cwd });
107
+ else { try { execFileSync("git", ["update-index", "--force-remove", "--", path], { cwd, stdio: "ignore" }); } catch {} }
108
+ rmSync(full, { recursive: true, force: true });
109
+ if (state.worktree) {
110
+ mkdirSync(dirname(full), { recursive: true });
111
+ const data = Buffer.from(state.worktree.data, "base64");
112
+ if (state.worktree.kind === "symlink") symlinkSync(data.toString(), full);
113
+ else writeFileSync(full, data);
114
+ }
115
+ }
116
+ export function rollBack(before: PermissionSnapshot, paths: string[]): string[] {
117
+ const preserved: string[] = [];
118
+ for (const path of paths) {
119
+ if (before.paths.has(path)) preserved.push(path);
120
+ restoreState(before.cwd, path, before.paths.get(path));
121
+ }
122
+ return preserved;
123
+ }
124
+ export function enforce(before: PermissionSnapshot, after: PermissionSnapshot, policy: PermissionPolicy): PermissionEnforcement {
125
+ const changed = changedPaths(before, after);
126
+ const violations = changed.filter(path => !permitted(path, policy, before.cwd));
127
+ const preDirtyPreserved = violations.length ? rollBack(before, violations) : [];
128
+ if (violations.length) throw new PermissionBreach(violations, preDirtyPreserved);
129
+ return { changed, violations, preDirtyPreserved };
130
+ }
@@ -0,0 +1,54 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { StartRefusedError } from "./git.ts";
3
+
4
+ interface ScannedPersona {
5
+ name: string; description: string; tools: string; model?: string; models?: string[];
6
+ thinking?: string; systemPrompt: string; file: string;
7
+ }
8
+ const agentsModulePath: string = "../../../.pi/harnesses/agent-hub/config/agents.ts";
9
+ const { scanAgentDirs } = await import(agentsModulePath) as { scanAgentDirs(cwd: string): ScannedPersona[] };
10
+ export type PersonaDefinition = ScannedPersona & { fallbackModel?: string; writes?: string[] };
11
+
12
+ function declaredWrites(file: string): string[] | undefined {
13
+ const frontmatter = readFileSync(file, "utf8").match(/^---\n([\s\S]*?)\n---/)?.[1] ?? "";
14
+ const lines = frontmatter.split("\n");
15
+ const index = lines.findIndex(line => /^writes\s*:/.test(line));
16
+ if (index < 0) return undefined;
17
+ const inline = lines[index].replace(/^writes\s*:\s*/, "").trim();
18
+ if (inline === "[]") return [];
19
+ if (inline) return inline.replace(/^\[|\]$/g, "").split(",").map(value => value.trim().replace(/^['\"]|['\"]$/g, "")).filter(Boolean);
20
+ const values: string[] = [];
21
+ for (let i = index + 1; i < lines.length; i++) {
22
+ const match = lines[i].match(/^\s+-\s+(.+)$/);
23
+ if (!match) break;
24
+ values.push(match[1].trim().replace(/^['\"]|['\"]$/g, ""));
25
+ }
26
+ return values;
27
+ }
28
+
29
+ export function listPersonas(cwd = process.cwd()): PersonaDefinition[] {
30
+ return scanAgentDirs(cwd).map(def => {
31
+ const override = process.env[`AGENT_FLEET_MODEL_${def.name.toUpperCase().replace(/-/g, "_")}`];
32
+ const model = override || def.model || def.models?.[0];
33
+ const fallbackModel = [def.model, ...(def.models ?? [])].find(candidate => candidate && candidate !== model);
34
+ const writes = declaredWrites(def.file);
35
+ return { ...def, model, fallbackModel, ...(writes === undefined ? {} : { writes }) };
36
+ });
37
+ }
38
+
39
+ export function resolvePersona(name: string, cwd = process.cwd()): PersonaDefinition {
40
+ const persona = listPersonas(cwd).find(def => def.name.toLowerCase() === name.toLowerCase());
41
+ if (!persona) throw new StartRefusedError(`Flow start refused: persona "${name}" was not found in agents/, .claude/agents/, or .pi/agents/.`);
42
+ if (!persona.model) throw new StartRefusedError(`Flow start refused: persona "${name}" declares no model.`);
43
+ return persona;
44
+ }
45
+
46
+ export function resolvePhaseModel(persona: PersonaDefinition, override?: string): string {
47
+ const model = override || persona.model;
48
+ if (!model) throw new StartRefusedError(`Flow start refused: persona "${persona.name}" declares no model.`);
49
+ return model;
50
+ }
51
+
52
+ export function resolvePhaseThinking(persona: PersonaDefinition, override?: string): string {
53
+ return override ?? persona.thinking ?? "medium";
54
+ }
@@ -0,0 +1,86 @@
1
+ import { mkdirSync, writeFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { runAgentPhase, type SpawnAgent } from "./agent-phase.ts";
4
+ import type { PollReport } from "./envelopes.ts";
5
+ import type { PermissionPolicy } from "./permissions.ts";
6
+ import type { PersonaDefinition } from "./personas.ts";
7
+ import type { Run } from "./run.ts";
8
+ import { resolvePanel, type Voice } from "./voices.ts";
9
+
10
+ export const POLL_TOOLS = "read,grep,find,ls";
11
+ export const POLL_PERMISSION_POLICY: PermissionPolicy = { writes: [] };
12
+ export const POLL_ARTIFACTS_REL = ".pi/agent-sessions/artifacts/polls";
13
+
14
+ export interface PollVoiceSuccess { ok: true; voice: Voice; report: PollReport; path: string }
15
+ export interface PollVoiceFailure { ok: false; voice: Voice; reason: string; path: string }
16
+ export type PollVoiceResult = PollVoiceSuccess | PollVoiceFailure;
17
+ export interface PollResult { panel: string; directory: string; results: PollVoiceResult[] }
18
+ export interface PollVoiceOptions {
19
+ run: Run; cwd: string; persona: PersonaDefinition; voice: Voice; task: string; panel: string;
20
+ spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<PollReport>;
21
+ }
22
+ export interface PollOptions {
23
+ run: Run; cwd: string; persona: PersonaDefinition; panel: string; task: string; voices?: Voice[];
24
+ spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<PollReport>;
25
+ onVoice?: (result: PollVoiceResult) => void | Promise<void>;
26
+ }
27
+
28
+ export function pollArtifactDir(cwd: string, runId: string): string {
29
+ return resolve(cwd, POLL_ARTIFACTS_REL, runId);
30
+ }
31
+
32
+ export function pollVoicePath(cwd: string, runId: string, voiceName: string): string {
33
+ return resolve(pollArtifactDir(cwd, runId), `${voiceName}.md`);
34
+ }
35
+
36
+ export function formatVoiceArtifact(result: PollVoiceResult): string {
37
+ const header = [`# ${result.voice.name}`, "", `- model: ${result.voice.model}`, `- thinking: ${result.voice.thinking ?? "medium"}`];
38
+ if (!result.ok) return `${header.join("\n")}\n- status: failed\n- reason: ${result.reason}\n`;
39
+ return `${header.join("\n")}\n- status: success\n\n## Report\n\n\`\`\`json\n${JSON.stringify(result.report, null, 2)}\n\`\`\`\n`;
40
+ }
41
+
42
+ export function writeVoiceArtifact(cwd: string, runId: string, result: PollVoiceResult): string {
43
+ const directory = pollArtifactDir(cwd, runId);
44
+ mkdirSync(directory, { recursive: true });
45
+ const path = pollVoicePath(cwd, runId, result.voice.name);
46
+ writeFileSync(path, formatVoiceArtifact(result), "utf8");
47
+ return path;
48
+ }
49
+
50
+ function readOnlyPersona(persona: PersonaDefinition): PersonaDefinition {
51
+ return { ...persona, tools: POLL_TOOLS, writes: [] };
52
+ }
53
+
54
+ export async function pollVoice(options: PollVoiceOptions): Promise<PollVoiceResult> {
55
+ const path = pollVoicePath(options.cwd, options.run.trace.runId, options.voice.name);
56
+ const agent = options.runAgent ?? runAgentPhase<PollReport>;
57
+ try {
58
+ const report = await agent({
59
+ run: options.run, persona: readOnlyPersona(options.persona), task: options.task, envelope: "poll",
60
+ cwd: options.cwd, spawn: options.spawn, model: options.voice.model, thinking: options.voice.thinking,
61
+ sessionTag: options.voice.name, permissionPolicy: POLL_PERMISSION_POLICY,
62
+ });
63
+ const result: PollVoiceSuccess = { ok: true, voice: options.voice, report, path };
64
+ result.path = writeVoiceArtifact(options.cwd, options.run.trace.runId, result);
65
+ return result;
66
+ } catch (error) {
67
+ const result: PollVoiceFailure = { ok: false, voice: options.voice, reason: error instanceof Error ? error.message : String(error), path };
68
+ result.path = writeVoiceArtifact(options.cwd, options.run.trace.runId, result);
69
+ return result;
70
+ }
71
+ }
72
+
73
+ export async function runPoll(options: PollOptions): Promise<PollResult> {
74
+ const voices = options.voices ?? resolvePanel(options.panel, options.cwd);
75
+ const results = await Promise.all(voices.map(async voice => {
76
+ const result = await pollVoice({ ...options, voice });
77
+ try { await options.onVoice?.(result); } catch { /* progress is best-effort */ }
78
+ return result;
79
+ }));
80
+ const succeeded = results.filter(result => result.ok);
81
+ if (succeeded.length < 2) {
82
+ const failures = results.filter(result => !result.ok).map(result => `${result.voice.name}: ${result.reason}`).join("; ");
83
+ throw new Error(`Poll failed: ${succeeded.length} of ${voices.length} voices succeeded${failures ? ` (${failures})` : ""}`);
84
+ }
85
+ return { panel: options.panel, directory: pollArtifactDir(options.cwd, options.run.trace.runId), results };
86
+ }
@@ -0,0 +1,64 @@
1
+ import { spawn } from "node:child_process";
2
+ import { existsSync, readFileSync, writeFileSync } from "node:fs";
3
+ import { resolve } from "node:path";
4
+ import type { Run } from "./run.ts";
5
+
6
+ export interface QualityResult { argv: string[]; exitCode: number; stdout: string; stderr: string; logPath: string; passed: boolean }
7
+ export interface VerifyEnvelope { status: "success" | "fail"; summary: string; artifacts: string[]; notes_for_next_agent: string; tests_run: string[] }
8
+
9
+ function splitArgv(value: string): string[] {
10
+ const matches = value.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) ?? [];
11
+ return matches.map(part => part.replace(/^("|')|("|')$/g, ""));
12
+ }
13
+
14
+ export function qualityCommand(cwd = process.cwd()): string[] {
15
+ const override = resolve(cwd, ".ai", "agent-fleet-overrides.md");
16
+ if (!existsSync(override)) throw Object.assign(new Error("Flow start refused: configure `quality:` under `## workflows` in .ai/agent-fleet-overrides.md."), { exitCode: 3 });
17
+ const text = readFileSync(override, "utf8");
18
+ const heading = text.match(/^## workflows\s*$/m);
19
+ const sectionStart = heading == null ? -1 : heading.index! + heading[0].length;
20
+ const tail = sectionStart < 0 ? "" : text.slice(sectionStart);
21
+ const nextHeading = tail.search(/^##\s/m);
22
+ const section = nextHeading < 0 ? tail : tail.slice(0, nextHeading);
23
+ const configured = section.match(/^quality\s*:\s*(.+)$/m)?.[1]?.trim();
24
+ const argv = configured ? splitArgv(configured) : [];
25
+ if (!argv.length) throw Object.assign(new Error("Flow start refused: configure a non-empty `quality:` argv under `## workflows` in .ai/agent-fleet-overrides.md."), { exitCode: 3 });
26
+ return argv;
27
+ }
28
+
29
+ export async function executeQuality(argv: string[], options: { cwd?: string; logPath: string; timeoutSeconds?: number; signal?: AbortSignal }): Promise<QualityResult> {
30
+ const cwd = options.cwd ?? process.cwd();
31
+ const timeoutMs = (options.timeoutSeconds ?? 1800) * 1000;
32
+ if (!argv.length || !argv[0]) throw new Error("Quality command requires a non-empty argv list");
33
+ const result = await new Promise<{ code: number; stdout: string; stderr: string }>(resolveResult => {
34
+ const child = spawn(argv[0], argv.slice(1), { cwd, env: process.env, shell: false, stdio: ["ignore", "pipe", "pipe"] });
35
+ let stdout = "", stderr = "", settled = false;
36
+ let timer: NodeJS.Timeout;
37
+ const onAbort = () => { stderr += "\nCancelled by flow signal"; child.kill("SIGTERM"); };
38
+ const finish = (code: number) => { if (!settled) { settled = true; clearTimeout(timer); options.signal?.removeEventListener("abort", onAbort); resolveResult({ code, stdout, stderr }); } };
39
+ if (options.signal?.aborted) onAbort(); else options.signal?.addEventListener("abort", onAbort, { once: true });
40
+ child.stdout?.on("data", chunk => { stdout += chunk; });
41
+ child.stderr?.on("data", chunk => { stderr += chunk; });
42
+ child.on("error", error => { stderr += error.message; finish((error as NodeJS.ErrnoException).code === "ENOENT" ? 127 : 1); });
43
+ child.on("close", code => finish(code ?? 1));
44
+ timer = setTimeout(() => { stderr += `\nTimed out after ${timeoutMs}ms`; child.kill("SIGTERM"); finish(1); }, timeoutMs);
45
+ });
46
+ const body = [`$ ${argv.join(" ")}`, result.stdout, result.stderr, `exit ${result.code}`].filter(Boolean).join("\n");
47
+ writeFileSync(options.logPath, body, "utf8");
48
+ return { argv, exitCode: result.code, stdout: result.stdout, stderr: result.stderr, logPath: options.logPath, passed: result.code === 0 };
49
+ }
50
+
51
+ export async function runTests(run: Run, options: { cwd?: string; argv?: string[]; timeoutSeconds?: number } = {}): Promise<QualityResult> {
52
+ const cwd = options.cwd ?? process.cwd();
53
+ return executeQuality(options.argv ?? qualityCommand(cwd), { cwd, timeoutSeconds: options.timeoutSeconds, signal: run.signal, logPath: resolve(run.trace.directory, "command.log") });
54
+ }
55
+
56
+ export function asEnvelope(result: QualityResult, what: string): VerifyEnvelope {
57
+ return {
58
+ status: result.passed ? "success" : "fail",
59
+ summary: result.passed ? `${what} passed` : `${what} failed with exit ${result.exitCode}`,
60
+ artifacts: [result.logPath],
61
+ notes_for_next_agent: result.passed ? "" : (result.stderr || result.stdout).slice(-4000),
62
+ tests_run: [`${result.argv.join(" ")} → ${result.exitCode}`],
63
+ };
64
+ }
@@ -0,0 +1,108 @@
1
+ import type { ChildProcess } from "node:child_process";
2
+ import type { PermissionSnapshot } from "./permissions.ts";
3
+ import { FlowTrace } from "./trace.ts";
4
+
5
+ export type PhaseKind = "engineer" | "agent" | "code";
6
+ export interface PhaseParams { name: string; kind: PhaseKind; owner: string; description: string; retries?: number }
7
+ export interface FinishResult { accepted: boolean; reason?: string; exitCode: number; status: "accepted" | "rejected"; banner: string; signal?: NodeJS.Signals }
8
+
9
+ function words(value: string): string[] {
10
+ return value.toLowerCase().replace(/[_-]+/g, " ").replace(/[^a-z0-9 ]/g, "").split(/\s+/).filter(Boolean);
11
+ }
12
+
13
+ export function validateDescription(name: string, description: string): void {
14
+ if (!description.trim()) throw new Error("Phase description must explain why the phase exists");
15
+ const nameWords = words(name);
16
+ const descriptionWords = words(description).filter(word => !["a", "an", "the", "to", "of"].includes(word));
17
+ if (nameWords.length > 0 && descriptionWords.join(" ") === nameWords.join(" ")) {
18
+ throw new Error("Phase description must explain why, not merely repeat its name");
19
+ }
20
+ }
21
+
22
+ export class PhaseContext {
23
+ status: "fail" | "success" = "fail";
24
+ readonly params: PhaseParams;
25
+ private readonly trace: FlowTrace;
26
+ constructor(params: PhaseParams, trace: FlowTrace) { this.params = params; this.trace = trace; }
27
+ log(message: string, data: Record<string, unknown> = {}): void { this.trace.write("log", { phase: this.params.name, message, ...data }); }
28
+ }
29
+
30
+ export class Run {
31
+ readonly trace: FlowTrace;
32
+ readonly command: string[];
33
+ readonly repositoryBaseline?: PermissionSnapshot;
34
+ private finished = false;
35
+ private phaseFailed = false;
36
+ private lastResult?: FinishResult;
37
+ private readonly cancellation = new AbortController();
38
+ readonly signal = this.cancellation.signal;
39
+
40
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; repositoryBaseline?: PermissionSnapshot } = {}) {
41
+ this.trace = options.trace ?? new FlowTrace(options);
42
+ this.command = options.command ?? [];
43
+ this.repositoryBaseline = options.repositoryBaseline;
44
+ }
45
+
46
+ async phase<T>(params: PhaseParams, body: (phase: PhaseContext) => Promise<T> | T): Promise<T> {
47
+ if (this.finished) throw new Error("Cannot start a phase after finish()");
48
+ validateDescription(params.name, params.description);
49
+ const retries = params.retries ?? 0;
50
+ if (!Number.isInteger(retries) || retries < 0) throw new Error("Phase retries must be a non-negative integer");
51
+ const phase = new PhaseContext(params, this.trace);
52
+ this.trace.write("phase_start", { phase: params.name, kind: params.kind, owner: params.owner, description: params.description, retries, status: phase.status });
53
+ for (let attempt = 0; attempt <= retries; attempt++) {
54
+ try {
55
+ const value = await body(phase);
56
+ if (this.finished) throw new Error("Run ended while phase was active");
57
+ phase.status = "success";
58
+ this.trace.write("phase_end", { phase: params.name, status: phase.status, attempt: attempt + 1 });
59
+ return value;
60
+ } catch (error) {
61
+ if (this.finished) throw error;
62
+ const message = error instanceof Error ? error.message : String(error);
63
+ this.trace.write("error", { phase: params.name, message, attempt: attempt + 1 });
64
+ const terminal = typeof error === "object" && error !== null && (error as { terminal?: boolean }).terminal === true;
65
+ if (attempt < retries && !terminal) {
66
+ this.trace.write("log", { phase: params.name, message: "retrying failed phase", nextAttempt: attempt + 2 });
67
+ continue;
68
+ }
69
+ this.phaseFailed = true;
70
+ this.trace.write("phase_end", { phase: params.name, status: phase.status, attempt: attempt + 1, error: message });
71
+ if (!this.finished) this.finalize(false, message);
72
+ throw error;
73
+ }
74
+ }
75
+ throw new Error("unreachable phase retry state");
76
+ }
77
+
78
+ registerProcess(process: ChildProcess, phase: string): void {
79
+ this.trace.write("agent_process", { phase, pid: process.pid ?? null, processGroup: process.pid == null ? null : -process.pid });
80
+ }
81
+
82
+ finish(input: { accepted: boolean; reason?: string }): FinishResult {
83
+ if (this.finished) throw new Error("finish() may be called exactly once");
84
+ return this.finalize(input.accepted && !this.phaseFailed, input.reason);
85
+ }
86
+
87
+ abort(reason: string, exitCode = 1): FinishResult {
88
+ this.cancellation.abort(reason);
89
+ if (this.finished) return this.lastResult!;
90
+ return this.finalize(false, reason, exitCode);
91
+ }
92
+
93
+ interrupt(signal: NodeJS.Signals): FinishResult {
94
+ const exitCode = 128 + (signal === "SIGINT" ? 2 : 15);
95
+ this.cancellation.abort(signal);
96
+ if (this.finished) return this.lastResult!;
97
+ return this.finalize(false, `interrupted by ${signal}`, exitCode, signal);
98
+ }
99
+
100
+ private finalize(accepted: boolean, reason?: string, exitCode = accepted ? 0 : 1, signal?: NodeJS.Signals): FinishResult {
101
+ this.finished = true;
102
+ const status = accepted ? "accepted" : "rejected";
103
+ const banner = accepted ? `FLOW ACCEPTED (${this.trace.runId})` : `FLOW REJECTED (${this.trace.runId})${reason ? `: ${reason}` : ""}`;
104
+ this.lastResult = { accepted, reason, exitCode, status, banner, ...(signal ? { signal } : {}) };
105
+ this.trace.write("run_end", { accepted, status, exitCode, reason: reason ?? "", banner, ...(signal ? { signal } : {}) });
106
+ return this.lastResult;
107
+ }
108
+ }
@@ -0,0 +1,34 @@
1
+ import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ const runNamespacePath: string = "../../../.pi/harnesses/agent-hub/run-namespace.js";
4
+ const { makeRunId } = await import(runNamespacePath) as { makeRunId(): string };
5
+
6
+ export type TraceEvent = Record<string, unknown> & { type: string; at: string; runId: string };
7
+
8
+ export class FlowTrace {
9
+ readonly runId: string;
10
+ readonly cwd: string;
11
+ readonly directory: string;
12
+ readonly file: string;
13
+ private ended = false;
14
+
15
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; pid?: number } = {}) {
16
+ this.runId = options.runId ?? makeRunId();
17
+ this.cwd = resolve(options.cwd ?? process.cwd());
18
+ this.directory = resolve(this.cwd, ".pi", "flow-sessions", this.runId);
19
+ this.file = resolve(this.directory, "trace.jsonl");
20
+ mkdirSync(this.directory, { recursive: true });
21
+ this.write("run_start", { pid: options.pid ?? process.pid, command: options.command ?? process.argv });
22
+ }
23
+
24
+ write(type: string, data: Record<string, unknown> = {}): void {
25
+ if (this.ended) return;
26
+ const event: TraceEvent = { type, at: new Date().toISOString(), runId: this.runId, ...data };
27
+ appendFileSync(this.file, `${JSON.stringify(event)}\n`, "utf8");
28
+ if (type === "run_end") this.ended = true;
29
+ }
30
+
31
+ events(): TraceEvent[] {
32
+ return readFileSync(this.file, "utf8").trim().split("\n").filter(Boolean).map(line => JSON.parse(line));
33
+ }
34
+ }