@chankov/agent-fleet 2.0.18 → 2.0.19

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 (583) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/agent-hub/proactive-external-git.ts +28 -5
  3. package/.pi/harnesses/agent-hub/proactive-external.ts +83 -18
  4. package/.pi/harnesses/agent-hub/proactive-rules.ts +3 -3
  5. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +23 -10
  6. package/.pi/harnesses/agent-hub/prompts/fragments.ts +6 -6
  7. package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +1 -1
  8. package/.pi/harnesses/coms/package.json +1 -1
  9. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  10. package/.pi/harnesses/lib/policy-roots.js +106 -0
  11. package/.pi/harnesses/lib/policy-roots.ts +7 -118
  12. package/.versions/2.0.19/.pi/agent-fleet/hermes/README.md +347 -0
  13. package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  14. package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  15. package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  16. package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  17. package/.versions/2.0.19/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  18. package/.versions/2.0.19/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  19. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  20. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  21. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  22. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  23. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  24. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  25. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  26. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  27. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  28. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  29. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  30. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  31. package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  32. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  33. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  34. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  35. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  36. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  37. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  38. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  39. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  40. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  41. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  42. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  43. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  44. package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  45. package/.versions/2.0.19/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  46. package/.versions/2.0.19/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  47. package/.versions/2.0.19/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  48. package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  49. package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  50. package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  51. package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  52. package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  53. package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet.ts +217 -0
  54. package/.versions/2.0.19/.pi/agent-fleet/scripts/flow.ts +157 -0
  55. package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  56. package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  57. package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  58. package/.versions/2.0.19/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  59. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  60. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  61. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  62. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  63. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  64. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  65. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  66. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  67. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  68. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  69. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  70. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  71. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  72. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  73. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  74. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  75. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  76. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  77. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  78. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  79. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  80. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  81. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  82. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  83. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  84. package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  85. package/.versions/2.0.19/.pi/agent-fleet/scripts/package-lock.json +35 -0
  86. package/.versions/2.0.19/.pi/agent-fleet/scripts/package.json +9 -0
  87. package/.versions/2.0.19/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  88. package/.versions/2.0.19/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  89. package/.versions/2.0.19/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  90. package/.versions/2.0.19/.pi/agent-fleet/scripts/team-up.ts +378 -0
  91. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  92. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  93. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  94. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  95. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  96. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  97. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  98. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  99. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  100. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  101. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  102. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  103. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  104. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  105. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  106. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  107. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  108. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  109. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  110. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  111. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  112. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  113. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  114. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  115. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  116. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  117. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  118. package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  119. package/.versions/2.0.19/.pi/agents/dispatch-policy.yaml +32 -0
  120. package/.versions/2.0.19/.pi/agents/model-profiles.yaml +134 -0
  121. package/.versions/2.0.19/.pi/agents/peers.yaml +147 -0
  122. package/.versions/2.0.19/.pi/agents/teams.yaml +41 -0
  123. package/.versions/2.0.19/.pi/agents/voices.yaml +13 -0
  124. package/.versions/2.0.19/.pi/damage-control-rules.yaml +297 -0
  125. package/.versions/2.0.19/.pi/extensions/btw/README.md +120 -0
  126. package/.versions/2.0.19/.pi/extensions/btw/index.ts +914 -0
  127. package/.versions/2.0.19/.pi/extensions/btw/package.json +6 -0
  128. package/.versions/2.0.19/.pi/extensions/btw/state.js +179 -0
  129. package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  130. package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  131. package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  132. package/.versions/2.0.19/.pi/extensions/compact-and-continue/README.md +42 -0
  133. package/.versions/2.0.19/.pi/extensions/compact-and-continue/index.ts +120 -0
  134. package/.versions/2.0.19/.pi/extensions/compact-and-continue/package.json +6 -0
  135. package/.versions/2.0.19/.pi/extensions/mcp-bridge/README.md +46 -0
  136. package/.versions/2.0.19/.pi/extensions/mcp-bridge/index.ts +206 -0
  137. package/.versions/2.0.19/.pi/extensions/mcp-bridge/package.json +6 -0
  138. package/.versions/2.0.19/.pi/extensions/package-lock.json +1175 -0
  139. package/.versions/2.0.19/.pi/extensions/package.json +9 -0
  140. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/README.md +224 -0
  141. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/config.ts +198 -0
  142. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  143. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/index.ts +248 -0
  144. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/package.json +6 -0
  145. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  146. package/.versions/2.0.19/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  147. package/.versions/2.0.19/.pi/harnesses/agent-hub/README.md +1483 -0
  148. package/.versions/2.0.19/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  149. package/.versions/2.0.19/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  150. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  151. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  152. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  153. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  154. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  155. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  156. package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  157. package/.versions/2.0.19/.pi/harnesses/agent-hub/artifacts.js +146 -0
  158. package/.versions/2.0.19/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  159. package/.versions/2.0.19/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  160. package/.versions/2.0.19/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  161. package/.versions/2.0.19/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  162. package/.versions/2.0.19/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  163. package/.versions/2.0.19/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  164. package/.versions/2.0.19/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  165. package/.versions/2.0.19/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  166. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  167. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  168. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  169. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  170. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  171. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  172. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  173. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  174. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  175. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  176. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  177. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  178. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  179. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  180. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  181. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  182. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  183. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  184. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  185. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  186. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  187. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  188. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  189. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  190. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  191. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  192. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  193. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  194. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  195. package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  196. package/.versions/2.0.19/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  197. package/.versions/2.0.19/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  198. package/.versions/2.0.19/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  199. package/.versions/2.0.19/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  200. package/.versions/2.0.19/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  201. package/.versions/2.0.19/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  202. package/.versions/2.0.19/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  203. package/.versions/2.0.19/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  204. package/.versions/2.0.19/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  205. package/.versions/2.0.19/.pi/harnesses/agent-hub/context-window.js +108 -0
  206. package/.versions/2.0.19/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  207. package/.versions/2.0.19/.pi/harnesses/agent-hub/delegate.ts +478 -0
  208. package/.versions/2.0.19/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
  209. package/.versions/2.0.19/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  210. package/.versions/2.0.19/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  211. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  212. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  213. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  214. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
  215. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
  216. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
  217. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  218. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  219. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  220. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  221. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  222. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  223. package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  224. package/.versions/2.0.19/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  225. package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  226. package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  227. package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  228. package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  229. package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  230. package/.versions/2.0.19/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  231. package/.versions/2.0.19/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  232. package/.versions/2.0.19/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  233. package/.versions/2.0.19/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  234. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  235. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  236. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  237. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  238. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  239. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  240. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  241. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  242. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  243. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  244. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
  245. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  246. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  247. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  248. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  249. package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  250. package/.versions/2.0.19/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
  251. package/.versions/2.0.19/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  252. package/.versions/2.0.19/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  253. package/.versions/2.0.19/.pi/harnesses/agent-hub/footer.ts +30 -0
  254. package/.versions/2.0.19/.pi/harnesses/agent-hub/helpers.ts +270 -0
  255. package/.versions/2.0.19/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  256. package/.versions/2.0.19/.pi/harnesses/agent-hub/index.ts +2625 -0
  257. package/.versions/2.0.19/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  258. package/.versions/2.0.19/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  259. package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  260. package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  261. package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  262. package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  263. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  264. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  265. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  266. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  267. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  268. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  269. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  270. package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  271. package/.versions/2.0.19/.pi/harnesses/agent-hub/no-progress.ts +593 -0
  272. package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  273. package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  274. package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  275. package/.versions/2.0.19/.pi/harnesses/agent-hub/package.json +7 -0
  276. package/.versions/2.0.19/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  277. package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  278. package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  279. package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  280. package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  281. package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
  282. package/.versions/2.0.19/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  283. package/.versions/2.0.19/.pi/harnesses/agent-hub/presentation.ts +48 -0
  284. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  285. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  286. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  287. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  288. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  289. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  290. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  291. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  292. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  293. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  294. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  295. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  296. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  297. package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  298. package/.versions/2.0.19/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  299. package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
  300. package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
  301. package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  302. package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  303. package/.versions/2.0.19/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  304. package/.versions/2.0.19/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  305. package/.versions/2.0.19/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  306. package/.versions/2.0.19/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  307. package/.versions/2.0.19/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  308. package/.versions/2.0.19/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  309. package/.versions/2.0.19/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  310. package/.versions/2.0.19/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
  311. package/.versions/2.0.19/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
  312. package/.versions/2.0.19/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  313. package/.versions/2.0.19/.pi/harnesses/agent-hub/return-contract.js +349 -0
  314. package/.versions/2.0.19/.pi/harnesses/agent-hub/return-extract.js +77 -0
  315. package/.versions/2.0.19/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  316. package/.versions/2.0.19/.pi/harnesses/agent-hub/review-findings.js +104 -0
  317. package/.versions/2.0.19/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  318. package/.versions/2.0.19/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  319. package/.versions/2.0.19/.pi/harnesses/agent-hub/run-budget.js +554 -0
  320. package/.versions/2.0.19/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  321. package/.versions/2.0.19/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  322. package/.versions/2.0.19/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  323. package/.versions/2.0.19/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  324. package/.versions/2.0.19/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  325. package/.versions/2.0.19/.pi/harnesses/agent-hub/session-health.js +110 -0
  326. package/.versions/2.0.19/.pi/harnesses/agent-hub/session-start.ts +42 -0
  327. package/.versions/2.0.19/.pi/harnesses/agent-hub/spawn.ts +563 -0
  328. package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  329. package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
  330. package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  331. package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  332. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  333. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  334. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  335. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  336. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  337. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  338. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  339. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  340. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  341. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  342. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  343. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  344. package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  345. package/.versions/2.0.19/.pi/harnesses/agent-hub/timeline.ts +72 -0
  346. package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  347. package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  348. package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  349. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
  350. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  351. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  352. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  353. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  354. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  355. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
  356. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  357. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  358. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  359. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  360. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  361. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  362. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  363. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  364. package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  365. package/.versions/2.0.19/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  366. package/.versions/2.0.19/.pi/harnesses/agent-hub/types.ts +66 -0
  367. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  368. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  369. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  370. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  371. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  372. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  373. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  374. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  375. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  376. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  377. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  378. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  379. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  380. package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  381. package/.versions/2.0.19/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  382. package/.versions/2.0.19/.pi/harnesses/agent-hub/version.ts +42 -0
  383. package/.versions/2.0.19/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  384. package/.versions/2.0.19/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  385. package/.versions/2.0.19/.pi/harnesses/agent-hub/work-mode.ts +187 -0
  386. package/.versions/2.0.19/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  387. package/.versions/2.0.19/.pi/harnesses/ask-user-remote/README.md +59 -0
  388. package/.versions/2.0.19/.pi/harnesses/ask-user-remote/index.ts +558 -0
  389. package/.versions/2.0.19/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  390. package/.versions/2.0.19/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  391. package/.versions/2.0.19/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  392. package/.versions/2.0.19/.pi/harnesses/coms/README.md +100 -0
  393. package/.versions/2.0.19/.pi/harnesses/coms/index.ts +282 -0
  394. package/.versions/2.0.19/.pi/harnesses/coms/package.json +7 -0
  395. package/.versions/2.0.19/.pi/harnesses/coms/version.ts +42 -0
  396. package/.versions/2.0.19/.pi/harnesses/damage-control-continue/README.md +135 -0
  397. package/.versions/2.0.19/.pi/harnesses/damage-control-continue/index.ts +533 -0
  398. package/.versions/2.0.19/.pi/harnesses/damage-control-continue/package.json +7 -0
  399. package/.versions/2.0.19/.pi/harnesses/damage-control-continue/version.ts +42 -0
  400. package/.versions/2.0.19/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  401. package/.versions/2.0.19/.pi/harnesses/lib/coms-core-io.ts +385 -0
  402. package/.versions/2.0.19/.pi/harnesses/lib/coms-core.ts +577 -0
  403. package/.versions/2.0.19/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  404. package/.versions/2.0.19/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
  405. package/.versions/2.0.19/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  406. package/.versions/2.0.19/.pi/harnesses/lib/context-budget-view.ts +107 -0
  407. package/.versions/2.0.19/.pi/harnesses/lib/context-budget.ts +114 -0
  408. package/.versions/2.0.19/.pi/harnesses/lib/damage-control-shared.ts +226 -0
  409. package/.versions/2.0.19/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  410. package/.versions/2.0.19/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  411. package/.versions/2.0.19/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  412. package/.versions/2.0.19/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  413. package/.versions/2.0.19/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  414. package/.versions/2.0.19/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  415. package/.versions/2.0.19/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  416. package/.versions/2.0.19/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  417. package/.versions/2.0.19/.pi/harnesses/lib/fleet-panel.ts +34 -0
  418. package/.versions/2.0.19/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  419. package/.versions/2.0.19/.pi/harnesses/lib/fleet-selection.ts +24 -0
  420. package/.versions/2.0.19/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  421. package/.versions/2.0.19/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  422. package/.versions/2.0.19/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  423. package/.versions/2.0.19/.pi/harnesses/lib/herdr-client.ts +472 -0
  424. package/.versions/2.0.19/.pi/harnesses/lib/herdr-presence.ts +399 -0
  425. package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  426. package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  427. package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  428. package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  429. package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  430. package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  431. package/.versions/2.0.19/.pi/harnesses/lib/policy-roots.js +106 -0
  432. package/.versions/2.0.19/.pi/harnesses/lib/policy-roots.ts +31 -0
  433. package/.versions/2.0.19/.pi/harnesses/lib/safe-source-read.js +29 -0
  434. package/.versions/2.0.19/.pi/harnesses/lib/spawned-peers.js +191 -0
  435. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  436. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  437. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-json.js +37 -0
  438. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-loader.js +44 -0
  439. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  440. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-triage.js +42 -0
  441. package/.versions/2.0.19/.pi/harnesses/lib/system1/config-v2.js +106 -0
  442. package/.versions/2.0.19/.pi/harnesses/lib/system1/config.js +50 -0
  443. package/.versions/2.0.19/.pi/harnesses/lib/system1/contracts.ts +154 -0
  444. package/.versions/2.0.19/.pi/harnesses/lib/system1/demo.ts +95 -0
  445. package/.versions/2.0.19/.pi/harnesses/lib/system1/jev.ts +503 -0
  446. package/.versions/2.0.19/.pi/harnesses/lib/system1/selection.js +11 -0
  447. package/.versions/2.0.19/.pi/harnesses/lib/system1/service.ts +245 -0
  448. package/.versions/2.0.19/.pi/harnesses/lib/update-check.ts +222 -0
  449. package/.versions/2.0.19/.pi/harnesses/package-lock.json +2039 -0
  450. package/.versions/2.0.19/.pi/harnesses/package.json +10 -0
  451. package/.versions/2.0.19/.pi/prompts/af-build.md +27 -0
  452. package/.versions/2.0.19/.pi/prompts/af-code-simplify.md +22 -0
  453. package/.versions/2.0.19/.pi/prompts/af-constraints.md +31 -0
  454. package/.versions/2.0.19/.pi/prompts/af-plan.md +17 -0
  455. package/.versions/2.0.19/.pi/prompts/af-review.md +16 -0
  456. package/.versions/2.0.19/.pi/prompts/af-set-hermes-telegram.md +15 -0
  457. package/.versions/2.0.19/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  458. package/.versions/2.0.19/.pi/prompts/af-setup-rules.md +20 -0
  459. package/.versions/2.0.19/.pi/prompts/af-ship.md +17 -0
  460. package/.versions/2.0.19/.pi/prompts/af-spec.md +15 -0
  461. package/.versions/2.0.19/.pi/prompts/af-test.md +19 -0
  462. package/.versions/2.0.19/.pi/skills/bowser/SKILL.md +145 -0
  463. package/.versions/2.0.19/.version +1 -0
  464. package/.versions/2.0.19/agents/architect.md +24 -0
  465. package/.versions/2.0.19/agents/bowser.md +28 -0
  466. package/.versions/2.0.19/agents/builder.md +55 -0
  467. package/.versions/2.0.19/agents/code-reviewer.md +209 -0
  468. package/.versions/2.0.19/agents/deep-researcher.md +32 -0
  469. package/.versions/2.0.19/agents/documenter.md +22 -0
  470. package/.versions/2.0.19/agents/orchestrator.md +22 -0
  471. package/.versions/2.0.19/agents/plan-reviewer.md +83 -0
  472. package/.versions/2.0.19/agents/planner.md +105 -0
  473. package/.versions/2.0.19/agents/releaser.md +24 -0
  474. package/.versions/2.0.19/agents/researcher.md +30 -0
  475. package/.versions/2.0.19/agents/security-auditor.md +167 -0
  476. package/.versions/2.0.19/agents/test-engineer.md +153 -0
  477. package/.versions/2.0.19/agents/web-debugger.md +44 -0
  478. package/.versions/2.0.19/agents/web-performance-auditor.md +194 -0
  479. package/.versions/2.0.19/bin/catalog/harness-runtime-closure.json +73 -0
  480. package/.versions/2.0.19/codex/fleet-session-client/SKILL.md +34 -0
  481. package/.versions/2.0.19/codex/fleet-session-client.zip +0 -0
  482. package/.versions/2.0.19/docs/ARCHITECTURE.md +874 -0
  483. package/.versions/2.0.19/docs/agent-fleet-setup.md +1101 -0
  484. package/.versions/2.0.19/docs/claude-code-coms-bridge.md +147 -0
  485. package/.versions/2.0.19/docs/codex-session-bridge.md +219 -0
  486. package/.versions/2.0.19/docs/coms-hermes-bridge.md +188 -0
  487. package/.versions/2.0.19/docs/getting-started.md +126 -0
  488. package/.versions/2.0.19/docs/npm-install.md +535 -0
  489. package/.versions/2.0.19/docs/pi-extensions.md +454 -0
  490. package/.versions/2.0.19/docs/pi-setup.md +92 -0
  491. package/.versions/2.0.19/docs/skill-anatomy.md +150 -0
  492. package/.versions/2.0.19/install-manifest.json +3197 -0
  493. package/.versions/2.0.19/justfile +247 -0
  494. package/.versions/2.0.19/manifest-meta.json +1075 -0
  495. package/.versions/2.0.19/references/accessibility-checklist.md +160 -0
  496. package/.versions/2.0.19/references/communication-contract.md +26 -0
  497. package/.versions/2.0.19/references/definition-of-done.md +67 -0
  498. package/.versions/2.0.19/references/fleet-coordination-patterns.md +171 -0
  499. package/.versions/2.0.19/references/observability-checklist.md +92 -0
  500. package/.versions/2.0.19/references/orchestration-patterns.md +370 -0
  501. package/.versions/2.0.19/references/performance-checklist.md +236 -0
  502. package/.versions/2.0.19/references/prompting-patterns.md +380 -0
  503. package/.versions/2.0.19/references/security-checklist.md +245 -0
  504. package/.versions/2.0.19/references/testing-patterns.md +235 -0
  505. package/.versions/2.0.19/references/workflow-authoring.md +304 -0
  506. package/.versions/2.0.19/skills/_internal/grilling.md +59 -0
  507. package/.versions/2.0.19/skills/browser-testing-with-devtools/SKILL.md +351 -0
  508. package/.versions/2.0.19/skills/code-review-and-quality/SKILL.md +396 -0
  509. package/.versions/2.0.19/skills/compound-learning/SKILL.md +137 -0
  510. package/.versions/2.0.19/skills/constraint-driven-development/SKILL.md +338 -0
  511. package/.versions/2.0.19/skills/constraint-driven-development/references/floor-guard.md +99 -0
  512. package/.versions/2.0.19/skills/context-engineering/SKILL.md +341 -0
  513. package/.versions/2.0.19/skills/deprecation-and-migration/SKILL.md +247 -0
  514. package/.versions/2.0.19/skills/designing-agents/SKILL.md +394 -0
  515. package/.versions/2.0.19/skills/designing-agents/pi-harness-authoring.md +222 -0
  516. package/.versions/2.0.19/skills/drafting-workflows/SKILL.md +143 -0
  517. package/.versions/2.0.19/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  518. package/.versions/2.0.19/skills/frontend-ui-engineering/SKILL.md +328 -0
  519. package/.versions/2.0.19/skills/git-workflow-and-versioning/SKILL.md +316 -0
  520. package/.versions/2.0.19/skills/idea-refine/SKILL.md +182 -0
  521. package/.versions/2.0.19/skills/idea-refine/examples.md +238 -0
  522. package/.versions/2.0.19/skills/idea-refine/frameworks.md +99 -0
  523. package/.versions/2.0.19/skills/idea-refine/refinement-criteria.md +113 -0
  524. package/.versions/2.0.19/skills/idea-refine/scripts/idea-refine.sh +15 -0
  525. package/.versions/2.0.19/skills/incremental-implementation/SKILL.md +353 -0
  526. package/.versions/2.0.19/skills/interview-me/SKILL.md +226 -0
  527. package/.versions/2.0.19/skills/orchestration-verification/SKILL.md +182 -0
  528. package/.versions/2.0.19/skills/peer-coms/SKILL.md +90 -0
  529. package/.versions/2.0.19/skills/performance-optimization/SKILL.md +496 -0
  530. package/.versions/2.0.19/skills/planning-and-task-breakdown/SKILL.md +318 -0
  531. package/.versions/2.0.19/skills/repository-ai-setup/SKILL.md +135 -0
  532. package/.versions/2.0.19/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  533. package/.versions/2.0.19/skills/repository-ai-setup/references/apply-contract.md +74 -0
  534. package/.versions/2.0.19/skills/repository-ai-setup/references/provenance-template.md +16 -0
  535. package/.versions/2.0.19/skills/repository-ai-setup/references/setup-flow.md +108 -0
  536. package/.versions/2.0.19/skills/repository-ai-setup/references/verify-setup.md +20 -0
  537. package/.versions/2.0.19/skills/repository-ai-setup.zip +0 -0
  538. package/.versions/2.0.19/skills/security-and-hardening/SKILL.md +524 -0
  539. package/.versions/2.0.19/skills/spec-driven-development/SKILL.md +295 -0
  540. package/.versions/2.0.19/skills/using-agent-skills/SKILL.md +198 -0
  541. package/.versions/2.0.19/vendor/agent-skills-upstream/LICENSE +21 -0
  542. package/.versions/2.0.19/vendor/agent-skills-upstream/README.md +430 -0
  543. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  544. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  545. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  546. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  547. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  548. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  549. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  550. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  551. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  552. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  553. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  554. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  555. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  556. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  557. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  558. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  559. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  560. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  561. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  562. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  563. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  564. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  565. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  566. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  567. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  568. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  569. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  570. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  571. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  572. package/.versions/2.0.19/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  573. package/CHANGELOG.md +6 -0
  574. package/bin/cli.js +1 -1
  575. package/bin/lib/doctor.js +8 -2
  576. package/bin/lib/system1-migration.js +17 -8
  577. package/bin/lib/system1-policy-context.js +57 -0
  578. package/bin/lib/transaction.js +1 -1
  579. package/docs/agent-fleet-setup.md +1 -1
  580. package/docs/external-project-ai-content.md +17 -1
  581. package/install-manifest.json +5 -1
  582. package/manifest-meta.json +4 -0
  583. package/package.json +1 -1
@@ -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; traceDirectory?: string; repositoryBaseline?: PermissionSnapshot } = {}) {
41
+ this.trace = options.trace ?? new FlowTrace({ ...options, directory: options.traceDirectory });
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,55 @@
1
+ import { existsSync, lstatSync, realpathSync } from "node:fs";
2
+ import { isAbsolute, relative, resolve, sep } from "node:path";
3
+
4
+ export const SCOUT_DATA_ROOT_ENV = "AGENT_FLEET_SCOUT_DATA_ROOT";
5
+ const FILESYSTEM_TOOLS = new Set(["read", "grep", "find", "ls"]);
6
+
7
+ function hasTraversal(value: string): boolean {
8
+ return value.replaceAll("\\", "/").split("/").includes("..");
9
+ }
10
+
11
+ function inside(root: string, candidate: string): boolean {
12
+ const fromRoot = relative(root, candidate);
13
+ return fromRoot === "" || (!isAbsolute(fromRoot) && fromRoot !== ".." && !fromRoot.startsWith(`..${sep}`));
14
+ }
15
+
16
+ /** Validate model-declared filesystem data paths without restricting runtime/library reads. */
17
+ export function validateScoutDataPath(rootValue: string, cwdValue: string, inputValue: unknown): string | null {
18
+ if (typeof inputValue !== "string" || inputValue.includes("\0")) return "Scout filesystem path must be a plain string.";
19
+ if (hasTraversal(inputValue)) return "Scout filesystem traversal is denied.";
20
+ const root = realpathSync(resolve(rootValue));
21
+ // Canonicalize cwd too: Darwin tmpdir aliases (/var vs /private/var) would
22
+ // otherwise make every in-snapshot read look like an escape.
23
+ const cwd = realpathSync(resolve(cwdValue));
24
+ const candidate = resolve(cwd, inputValue || ".");
25
+ if (!inside(root, candidate)) return "Scout filesystem reads are limited to the isolated snapshot.";
26
+ let current = root;
27
+ const fromRoot = relative(root, candidate);
28
+ for (const part of fromRoot ? fromRoot.split(sep) : []) {
29
+ current = resolve(current, part);
30
+ if (!existsSync(current)) break;
31
+ if (lstatSync(current).isSymbolicLink()) return "Scout filesystem symlink traversal is denied.";
32
+ }
33
+ if (existsSync(candidate) && !inside(root, realpathSync(candidate))) return "Scout filesystem symlink escape is denied.";
34
+ return null;
35
+ }
36
+
37
+ function validatePattern(value: unknown): string | null {
38
+ if (value === undefined) return null;
39
+ if (typeof value !== "string" || value.includes("\0") || isAbsolute(value) || hasTraversal(value)) return "Scout filesystem pattern traversal is denied.";
40
+ return null;
41
+ }
42
+
43
+ export default function scoutDataBoundary(pi: { on(name: "tool_call", handler: (event: { toolName?: string; input: unknown }, ctx: { cwd: string }) => unknown): void }): void {
44
+ pi.on("tool_call", (event, ctx) => {
45
+ const tool = String(event.toolName ?? "").toLowerCase();
46
+ if (!FILESYSTEM_TOOLS.has(tool)) return;
47
+ const root = process.env[SCOUT_DATA_ROOT_ENV];
48
+ if (!root) return { block: true, reason: "Scout filesystem boundary is unavailable." };
49
+ const input = event.input as Record<string, unknown>;
50
+ const reason = validateScoutDataPath(root, ctx.cwd, tool === "read" ? input.path : (input.path ?? "."))
51
+ ?? (tool === "grep" ? validatePattern(input.glob) : null)
52
+ ?? (tool === "find" ? validatePattern(input.pattern) : null);
53
+ return reason ? { block: true, reason } : { block: false };
54
+ });
55
+ }
@@ -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; directory?: string } = {}) {
16
+ this.runId = options.runId ?? makeRunId();
17
+ this.cwd = resolve(options.cwd ?? process.cwd());
18
+ this.directory = options.directory ? resolve(options.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
+ }
@@ -0,0 +1,128 @@
1
+ import { readActiveProfile, profilePanel } from './model-profile.ts';
2
+ import { existsSync, readFileSync } from "node:fs";
3
+ import { resolve } from "node:path";
4
+ import { parse as parseYaml } from "yaml";
5
+
6
+ export const VOICES_REL = ".pi/agents/voices.yaml";
7
+ export const VOICE_NAME = /^[A-Za-z0-9_-]{1,16}$/;
8
+ export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"] as const;
9
+ export type ThinkingLevel = (typeof THINKING_LEVELS)[number];
10
+ const THINKING = new Set<string>(THINKING_LEVELS);
11
+ const VOICE_KEYS = new Set(["name", "model", "thinking", "integrator"]);
12
+ const MIN_VOICES = 2;
13
+ const MAX_VOICES = 5;
14
+
15
+ export interface Voice {
16
+ name: string;
17
+ model: string;
18
+ thinking?: ThinkingLevel;
19
+ integrator?: boolean;
20
+ }
21
+ export interface VoicesFile { path: string; rel: string; panels: Record<string, Voice[]> }
22
+ export class VoicesError extends Error {
23
+ readonly errors: string[];
24
+ readonly exitCode = 2;
25
+ constructor(errors: string[]) {
26
+ super(errors.join("\n"));
27
+ this.errors = errors;
28
+ this.name = "VoicesError";
29
+ }
30
+ }
31
+
32
+ export function voicesPath(cwd = process.cwd()): string {
33
+ return resolve(cwd, VOICES_REL);
34
+ }
35
+
36
+ export function listPanelNames(cwd = process.cwd()): string[] {
37
+ const active=readActiveProfile();if(active) return [active.name];
38
+ try { return Object.keys(loadVoices(cwd).panels); } catch { return []; }
39
+ }
40
+
41
+ export function resolvePanel(name: string, cwd = process.cwd()): Voice[] {
42
+ const selected=profilePanel(name);if(selected) return selected;
43
+ const file = loadVoices(cwd);
44
+ const voices = file.panels[name];
45
+ if (!voices) {
46
+ const available = Object.keys(file.panels);
47
+ throw new VoicesError([`${file.rel} panel "${name}" was not found. Available panels: ${available.length ? available.join(", ") : "(none)"}`]);
48
+ }
49
+ return voices;
50
+ }
51
+
52
+ export function integratorVoice(voices: Voice[]): Voice | undefined {
53
+ return voices.find(voice => voice.integrator === true);
54
+ }
55
+
56
+ export function loadVoices(cwd = process.cwd()): VoicesFile {
57
+ const path = voicesPath(cwd);
58
+ if (!existsSync(path)) throw new VoicesError([`${VOICES_REL}: file not found`]);
59
+ let raw: unknown;
60
+ try { raw = parseYaml(readFileSync(path, "utf8")); }
61
+ catch (error) { throw new VoicesError([`${VOICES_REL}: invalid YAML (${error instanceof Error ? error.message : String(error)})`]); }
62
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new VoicesError([`${VOICES_REL}: file must be a mapping of panel name to voice lists`]);
63
+ const errors: string[] = [];
64
+ const panels: Record<string, Voice[]> = {};
65
+ for (const [panel, value] of Object.entries(raw as Record<string, unknown>)) {
66
+ const voices = validatePanel(panel, value, errors);
67
+ if (voices) panels[panel] = voices;
68
+ }
69
+ if (errors.length) throw new VoicesError(errors);
70
+ return { path, rel: VOICES_REL, panels };
71
+ }
72
+
73
+ function validatePanel(panel: string, value: unknown, errors: string[]): Voice[] | undefined {
74
+ const prefix = `${VOICES_REL} panel "${panel}"`;
75
+ if (!Array.isArray(value)) {
76
+ errors.push(`${prefix}: must be a list of voices`);
77
+ return undefined;
78
+ }
79
+ if (value.length < MIN_VOICES || value.length > MAX_VOICES) {
80
+ errors.push(`${prefix}: has ${value.length} voices; a panel must have between ${MIN_VOICES} and ${MAX_VOICES}`);
81
+ }
82
+ const voices: Voice[] = [];
83
+ const seen = new Set<string>();
84
+ let integrators = 0;
85
+ for (const [index, entry] of value.entries()) {
86
+ const parsed = validateVoice(prefix, index, entry, errors);
87
+ if (parsed.name) {
88
+ if (seen.has(parsed.name)) errors.push(`${prefix}: duplicate voice name "${parsed.name}"`);
89
+ seen.add(parsed.name);
90
+ }
91
+ if (parsed.integrator) integrators++;
92
+ if (parsed.voice) voices.push(parsed.voice);
93
+ }
94
+ if (integrators > 1) errors.push(`${prefix}: has ${integrators} voices with integrator: true; at most one is allowed`);
95
+ return voices;
96
+ }
97
+
98
+ function validateVoice(prefix: string, index: number, entry: unknown, errors: string[]): { voice?: Voice; name?: string; integrator: boolean } {
99
+ const label = `${prefix} voice[${index}]`;
100
+ if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
101
+ errors.push(`${label}: must be a mapping with name and model`);
102
+ return { integrator: false };
103
+ }
104
+ const raw = entry as Record<string, unknown>;
105
+ for (const key of Object.keys(raw)) {
106
+ if (!VOICE_KEYS.has(key)) errors.push(`${label}: unknown key "${key}"`);
107
+ }
108
+ const name = typeof raw.name === "string" && VOICE_NAME.test(raw.name) ? raw.name : undefined;
109
+ if (!name) errors.push(`${label}: name is required, unique in the panel, and must match ${VOICE_NAME}`);
110
+ const model = raw.model;
111
+ const modelOk = typeof model === "string" && model.includes("/") && !model.startsWith("/") && !model.endsWith("/") && model.split("/").every(part => part);
112
+ if (!modelOk) errors.push(`${label}: model must be fully qualified provider/id (got ${JSON.stringify(raw.model)})`);
113
+ let thinking: ThinkingLevel | undefined;
114
+ if (raw.thinking !== undefined) {
115
+ if (typeof raw.thinking !== "string" || !THINKING.has(raw.thinking)) {
116
+ errors.push(`${label}: thinking must be one of ${[...THINKING_LEVELS].join("|")}`);
117
+ } else thinking = raw.thinking as ThinkingLevel;
118
+ }
119
+ if (raw.integrator !== undefined && typeof raw.integrator !== "boolean") {
120
+ errors.push(`${label}: integrator must be a boolean`);
121
+ }
122
+ const integrator = raw.integrator === true;
123
+ if (!name || !modelOk) return { name, integrator };
124
+ return {
125
+ name, integrator,
126
+ voice: { name, model: model as string, ...(thinking ? { thinking } : {}), ...(integrator ? { integrator: true } : {}) },
127
+ };
128
+ }
@@ -0,0 +1,112 @@
1
+ import { mkdirSync, readFileSync, realpathSync, statSync, unlinkSync, writeFileSync } from "node:fs";
2
+ import { dirname, resolve } from "node:path";
3
+ import { createHash } from "node:crypto";
4
+
5
+ export interface WriterLeaseRecord {
6
+ owner: string;
7
+ pid: number;
8
+ command: string;
9
+ path: string;
10
+ createdAt: string;
11
+ }
12
+
13
+ export interface WriterLeaseHandle {
14
+ file: string;
15
+ record: WriterLeaseRecord;
16
+ }
17
+
18
+ export class WriterLeaseHeldError extends Error {
19
+ readonly record: WriterLeaseRecord;
20
+ readonly file: string;
21
+ constructor(record: WriterLeaseRecord, file: string) {
22
+ super(`Writer lease held by ${record.owner} pid ${record.pid} (${record.command}) at ${file}`);
23
+ this.name = "WriterLeaseHeldError";
24
+ this.record = record;
25
+ this.file = file;
26
+ }
27
+ }
28
+
29
+ export function writerLeaseKey(cwd: string): string {
30
+ return createHash("sha256").update(realpathSync(cwd)).digest("hex");
31
+ }
32
+
33
+ export function writerLeaseFile(cwd: string): string {
34
+ const real = realpathSync(cwd);
35
+ return resolve(real, ".pi", "writer-leases", `${writerLeaseKey(cwd)}.lock`);
36
+ }
37
+
38
+ function pidAlive(pid: number): boolean {
39
+ if (!Number.isInteger(pid) || pid <= 0) return false;
40
+ try {
41
+ process.kill(pid, 0);
42
+ return true;
43
+ } catch (error) {
44
+ return (error as NodeJS.ErrnoException).code === "EPERM";
45
+ }
46
+ }
47
+
48
+ function readRecord(file: string): WriterLeaseRecord | undefined {
49
+ try {
50
+ const value = JSON.parse(readFileSync(file, "utf8")) as WriterLeaseRecord;
51
+ if (!value || typeof value.owner !== "string" || typeof value.command !== "string" || !Number.isInteger(value.pid)) return undefined;
52
+ return value;
53
+ } catch {
54
+ return undefined;
55
+ }
56
+ }
57
+
58
+ function writeExclusive(file: string, record: WriterLeaseRecord): void {
59
+ mkdirSync(dirname(file), { recursive: true });
60
+ writeFileSync(file, `${JSON.stringify(record)}\n`, { flag: "wx", mode: 0o600 });
61
+ }
62
+
63
+ export function acquireWriterLease(options: { cwd: string; owner: string; command: string; pid?: number }): WriterLeaseHandle {
64
+ const path = realpathSync(options.cwd);
65
+ const file = writerLeaseFile(options.cwd);
66
+ const record: WriterLeaseRecord = {
67
+ owner: options.owner,
68
+ pid: options.pid ?? process.pid,
69
+ command: options.command,
70
+ path,
71
+ createdAt: new Date().toISOString(),
72
+ };
73
+ try {
74
+ writeExclusive(file, record);
75
+ return { file, record };
76
+ } catch (error) {
77
+ if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
78
+ }
79
+ const existing = readRecord(file);
80
+ if (existing && pidAlive(existing.pid)) throw new WriterLeaseHeldError(existing, file);
81
+ try { unlinkSync(file); } catch { /* stolen or already gone */ }
82
+ try {
83
+ writeExclusive(file, record);
84
+ return { file, record };
85
+ } catch (error) {
86
+ if ((error as NodeJS.ErrnoException).code === "EEXIST") {
87
+ const raced = readRecord(file);
88
+ if (raced) throw new WriterLeaseHeldError(raced, file);
89
+ }
90
+ throw error;
91
+ }
92
+ }
93
+
94
+ export function releaseWriterLease(handle: WriterLeaseHandle): void {
95
+ const existing = readRecord(handle.file);
96
+ if (!existing) return;
97
+ if (existing.pid !== handle.record.pid || existing.owner !== handle.record.owner) return;
98
+ try { unlinkSync(handle.file); } catch { /* already gone */ }
99
+ }
100
+
101
+ export function writerLeaseMode(file: string): number {
102
+ return statSync(file).mode & 0o777;
103
+ }
104
+
105
+ export async function withWriterLease<T>(options: { cwd: string; owner: string; command: string; pid?: number }, body: (lease: WriterLeaseHandle) => Promise<T> | T): Promise<T> {
106
+ const lease = acquireWriterLease(options);
107
+ try {
108
+ return await body(lease);
109
+ } finally {
110
+ releaseWriterLease(lease);
111
+ }
112
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "compilerOptions": {
3
+ "allowImportingTsExtensions": true,
4
+ "allowJs": true,
5
+ "checkJs": false,
6
+ "esModuleInterop": true,
7
+ "module": "NodeNext",
8
+ "moduleResolution": "NodeNext",
9
+ "noEmit": true,
10
+ "skipLibCheck": true,
11
+ "strict": true,
12
+ "target": "ES2022",
13
+ "types": ["node"]
14
+ },
15
+ "include": [
16
+ "./*.ts",
17
+ "./lib/*.ts"
18
+ ],
19
+ "exclude": [
20
+ "./**/*.test.ts"
21
+ ]
22
+ }
@@ -0,0 +1,61 @@
1
+ import { runAgentPhase } from "./lib/agent-phase.ts";
2
+ import { ENVELOPE_EXAMPLES, validateEnvelope, type BuildEnvelope as BuildEnvelopeSchema } from "./lib/envelopes.ts";
3
+ import { artifactsExist, diffMatchesClaims } from "./lib/gates.ts";
4
+ import { commitAll } from "./lib/git.ts";
5
+ import { snapshot, type PermissionSnapshot } from "./lib/permissions.ts";
6
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
7
+ import { qualityCommand, runTests, type QualityResult } from "./lib/quality.ts";
8
+ import type { FinishResult, Run } from "./lib/run.ts";
9
+ import type { Static } from "@sinclair/typebox";
10
+
11
+ export type BuildReport = Static<typeof BuildEnvelopeSchema>;
12
+ export const MAX_BUILD_FIX_ATTEMPTS = 2;
13
+ const BUILDER_PERMISSION_POLICY = { writes: ["**"] };
14
+ export interface BuildTestDeps {
15
+ agent?: (options: Parameters<typeof runAgentPhase<BuildReport>>[0]) => Promise<BuildReport>;
16
+ tests?: (run: Run, options: { cwd: string }) => Promise<QualityResult>;
17
+ commit?: (message: string, cwd: string, baseline: PermissionSnapshot, policy: { writes?: string[] }) => string | null;
18
+ persona?: PersonaDefinition;
19
+ baseline?: PermissionSnapshot;
20
+ maxFixAttempts?: number;
21
+ }
22
+ export function buildTestWorkflowPreflight(cwd: string): void { resolvePersona("builder", cwd); qualityCommand(cwd); }
23
+ function dryBuild(): BuildReport {
24
+ const parsed = validateEnvelope<BuildReport>("build", JSON.stringify(ENVELOPE_EXAMPLES.build));
25
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
26
+ return parsed.value!;
27
+ }
28
+ function redOutput(result: QualityResult): string { return `${result.stdout}${result.stderr}`; }
29
+
30
+ /** Phases: engineer(request) → agent(builder) → code(test) → agent(builder-fix, bounded) → code(commit) */
31
+ export async function buildTestWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string }, deps: BuildTestDeps = {}): Promise<FinishResult> {
32
+ const request = input.args.join(" ").trim();
33
+ if (!request) throw Object.assign(new Error("build-test flow requires an implementation request"), { exitCode: 2 });
34
+ const persona = deps.persona ?? resolvePersona("builder", input.cwd);
35
+ const baseline = deps.baseline ?? run.repositoryBaseline ?? snapshot(input.cwd);
36
+ const agent = deps.agent ?? runAgentPhase<BuildReport>;
37
+ const tests = deps.tests ?? ((activeRun, options) => runTests(activeRun, options));
38
+ const commit = deps.commit ?? commitAll;
39
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Preserve the exact implementation outcome the operator asked for" }, phase => phase.log(request));
40
+ let report = await run.phase({ name: "build", kind: "agent", owner: "builder", description: "Implement the requested change before deterministic verification" }, () => input.dryRun ? dryBuild() : agent({ run, persona, task: request, envelope: "build", cwd: input.cwd, gates: [artifactsExist, diffMatchesClaims], gateRetries: 1, permissionPolicy: BUILDER_PERMISSION_POLICY }));
41
+ let quality = await run.phase({ name: "test", kind: "code", owner: "quality", description: "Measure the implementation with the configured suite before any commit" }, async phase => {
42
+ if (input.dryRun) { phase.log("dry-run: green quality result stubbed"); return { argv: ["dry-run"], exitCode: 0, stdout: "", stderr: "", logPath: run.trace.file, passed: true }; }
43
+ const result = await tests(run, { cwd: input.cwd }); phase.log(result.passed ? "suite passed" : "suite failed", { exitCode: result.exitCode, logPath: result.logPath }); return result;
44
+ });
45
+ for (let attempt = 1; !quality.passed && attempt <= (deps.maxFixAttempts ?? MAX_BUILD_FIX_ATTEMPTS); attempt++) {
46
+ const output = redOutput(quality);
47
+ report = await run.phase({ name: `builder-fix-${attempt}`, kind: "agent", owner: "builder", description: "Correct the implementation using verbatim evidence from the red suite" }, () => input.dryRun ? dryBuild() : agent({
48
+ run, persona, envelope: "build", cwd: input.cwd, gates: [artifactsExist, diffMatchesClaims], gateRetries: 1, permissionPolicy: BUILDER_PERMISSION_POLICY,
49
+ task: `The deterministic test suite is red. Correct the implementation. The suite output below is forwarded verbatim:\n--- BEGIN VERBATIM TEST OUTPUT ---\n${output}\n--- END VERBATIM TEST OUTPUT ---`,
50
+ }));
51
+ quality = await run.phase({ name: `test-after-fix-${attempt}`, kind: "code", owner: "quality", description: "Re-run the same configured suite to decide whether repair succeeded" }, async () => tests(run, { cwd: input.cwd }));
52
+ }
53
+ if (!quality.passed) return run.finish({ accepted: false, reason: `the suite remained red after ${deps.maxFixAttempts ?? MAX_BUILD_FIX_ATTEMPTS} builder fix attempts` });
54
+ await run.phase({ name: "commit", kind: "code", owner: "git", description: "Create one commit only after deterministic verification is green" }, phase => {
55
+ if (input.dryRun) return phase.log("dry-run: commit skipped");
56
+ const hash = commit(report.commit_message, input.cwd, baseline, { writes: persona.writes });
57
+ if (hash) phase.log("verified work committed", { hash });
58
+ else phase.log("no flow-introduced changes to commit");
59
+ });
60
+ return run.finish({ accepted: true });
61
+ }
@@ -0,0 +1,87 @@
1
+ import { ENVELOPE_EXAMPLES, validateEnvelope, type DebateReport } from "./lib/envelopes.ts";
2
+ import { StartRefusedError } from "./lib/git.ts";
3
+ import { debateVoiceRound, resolveDebateRounds, writeDebateArtifact, type DebateVoiceResult } from "./lib/debate.ts";
4
+ import { checkChildVisibility, type ChildVisibilityReport } from "./lib/model-visibility.ts";
5
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
6
+ import type { FinishResult, Run } from "./lib/run.ts";
7
+ import { listPanelNames, resolvePanel, type Voice } from "./lib/voices.ts";
8
+
9
+ export interface DebateWorkflowDeps {
10
+ persona?: PersonaDefinition;
11
+ voices?: Voice[];
12
+ debate?: typeof debateVoiceRound;
13
+ checkVisibility?: (models: string[]) => ChildVisibilityReport;
14
+ }
15
+
16
+ function stubDebate(): DebateReport {
17
+ const parsed = validateEnvelope<DebateReport>("debate", JSON.stringify(ENVELOPE_EXAMPLES.debate));
18
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
19
+ return parsed.value!;
20
+ }
21
+
22
+ export function debateWorkflowValidate(command: { panel?: string; args: string[]; rounds?: number; apply?: boolean }, cwd: string): void {
23
+ if (command.apply) throw Object.assign(new Error("debate flow is read-only and does not take --apply"), { exitCode: 2 });
24
+ if (!command.panel) {
25
+ const available = listPanelNames(cwd);
26
+ throw Object.assign(new Error(`debate flow requires --panel. Available panels: ${available.length ? available.join(", ") : "(none)"}`), { exitCode: 2 });
27
+ }
28
+ if (!command.args.join(" ").trim()) throw Object.assign(new Error("debate flow requires a question"), { exitCode: 2 });
29
+ resolveDebateRounds(command.rounds);
30
+ resolvePanel(command.panel, cwd);
31
+ }
32
+
33
+ export function debateWorkflowPreflight(cwd: string, command?: { panel?: string }, deps: DebateWorkflowDeps = {}): void {
34
+ resolvePersona("researcher", cwd);
35
+ const panel = command?.panel;
36
+ if (!panel) return;
37
+ const voices = deps.voices ?? resolvePanel(panel, cwd);
38
+ const report = (deps.checkVisibility ?? checkChildVisibility)(voices.map(voice => voice.model));
39
+ if (report.diagnostic) throw new StartRefusedError(`Flow start refused: could not verify clean-room model visibility (${report.diagnostic}).`);
40
+ const hidden = report.models.filter(model => !model.ok);
41
+ if (hidden.length) {
42
+ throw new StartRefusedError(`Flow start refused: panel "${panel}" has models not visible to a clean-room child: ${hidden.map(model => model.reasons[0] ?? model.model).join("; ")}`);
43
+ }
44
+ }
45
+
46
+ /** Phases: engineer(request) → for each round: agent×N(debate) → code(collect). No judge. */
47
+ export async function debateWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }, deps: DebateWorkflowDeps = {}): Promise<FinishResult> {
48
+ const request = input.args.join(" ").trim();
49
+ if (!request) throw Object.assign(new Error("debate flow requires a question"), { exitCode: 2 });
50
+ if (!input.panel) throw Object.assign(new Error("debate flow requires --panel"), { exitCode: 2 });
51
+ if (input.apply) throw Object.assign(new Error("debate flow is read-only and does not take --apply"), { exitCode: 2 });
52
+ const rounds = resolveDebateRounds(input.rounds);
53
+ const persona = deps.persona ?? resolvePersona("researcher", input.cwd);
54
+ const voices = deps.voices ?? resolvePanel(input.panel, input.cwd);
55
+ const debate = deps.debate ?? debateVoiceRound;
56
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Preserve the exact question every panel voice must debate" }, phase => phase.log(request));
57
+ let active = [...voices];
58
+ let previous: Extract<DebateVoiceResult, { ok: true }>[] = [];
59
+ for (let round = 1; round <= rounds; round++) {
60
+ if (active.length < 2) break;
61
+ const results = await Promise.all(active.map(voice => run.phase({
62
+ name: `debate-${voice.name}-r${round}`, kind: "agent", owner: voice.name,
63
+ description: `Collect a labeled debate turn from this panel voice in round ${round}`,
64
+ }, async (): Promise<DebateVoiceResult> => {
65
+ if (input.dryRun) {
66
+ const stub: DebateVoiceResult = { ok: true, voice, round, report: stubDebate(), path: "" };
67
+ stub.path = writeDebateArtifact(input.cwd, run.trace.runId, stub);
68
+ return stub;
69
+ }
70
+ const others = previous.filter(item => item.voice.name !== voice.name);
71
+ return debate({ run, cwd: input.cwd, persona, voice, task: request, panel: input.panel!, round, rounds, others });
72
+ })));
73
+ await run.phase({ name: `collect-r${round}`, kind: "code", owner: "debate", description: `Write round ${round} voice conclusions to disk before the next round` }, phase => {
74
+ phase.log("debate round collected", { round, count: results.length, paths: results.map(item => item.path) });
75
+ });
76
+ const succeeded = results.filter((item): item is Extract<DebateVoiceResult, { ok: true }> => item.ok);
77
+ if (succeeded.length < 2) {
78
+ if (round === 1) {
79
+ return run.finish({ accepted: false, reason: `debate produced ${succeeded.length} of ${active.length} successful voices in round 1; at least 2 are required` });
80
+ }
81
+ break;
82
+ }
83
+ previous = succeeded;
84
+ active = succeeded.map(item => item.voice);
85
+ }
86
+ return run.finish({ accepted: previous.length >= 2 });
87
+ }