@chankov/agent-fleet 2.0.20 → 2.0.21

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 (626) hide show
  1. package/.pi/harnesses/agent-hub/README.md +3 -2
  2. package/.pi/harnesses/agent-hub/index.ts +7 -5
  3. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +26 -10
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/coms/index.ts +13 -10
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/coms-core-io.ts +29 -2
  9. package/.pi/harnesses/lib/coms-core.ts +144 -42
  10. package/.versions/2.0.21/.pi/agent-fleet/hermes/README.md +347 -0
  11. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  12. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  13. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  14. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  15. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  16. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  17. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  18. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  19. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  20. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  21. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  22. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  23. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  24. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  25. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  26. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  27. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  28. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  29. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  30. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  31. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  32. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  33. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  34. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  35. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  36. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  37. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  38. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  39. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  40. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  41. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  42. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  43. package/.versions/2.0.21/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  44. package/.versions/2.0.21/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  45. package/.versions/2.0.21/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  46. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  47. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  48. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  49. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  50. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  51. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet.ts +217 -0
  52. package/.versions/2.0.21/.pi/agent-fleet/scripts/flow.ts +157 -0
  53. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  54. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  55. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  56. package/.versions/2.0.21/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  57. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  58. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  59. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  60. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  61. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  62. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  63. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  64. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  65. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  66. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  67. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  68. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  69. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  70. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  71. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  72. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  73. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  74. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  75. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  76. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  77. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  78. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  79. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  80. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  81. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  82. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  83. package/.versions/2.0.21/.pi/agent-fleet/scripts/package-lock.json +35 -0
  84. package/.versions/2.0.21/.pi/agent-fleet/scripts/package.json +9 -0
  85. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  86. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  87. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  88. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-up.ts +378 -0
  89. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  90. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  91. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  92. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  93. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  94. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  95. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  96. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  97. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  98. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  99. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  100. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  101. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  102. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  103. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  104. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  105. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  106. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  107. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  108. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  109. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  110. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  111. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  112. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  113. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  114. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  115. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  116. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  117. package/.versions/2.0.21/.pi/agents/dispatch-policy.yaml +32 -0
  118. package/.versions/2.0.21/.pi/agents/model-profiles.yaml +134 -0
  119. package/.versions/2.0.21/.pi/agents/peers.yaml +147 -0
  120. package/.versions/2.0.21/.pi/agents/teams.yaml +41 -0
  121. package/.versions/2.0.21/.pi/agents/voices.yaml +13 -0
  122. package/.versions/2.0.21/.pi/damage-control-rules.yaml +297 -0
  123. package/.versions/2.0.21/.pi/extensions/btw/README.md +120 -0
  124. package/.versions/2.0.21/.pi/extensions/btw/index.ts +914 -0
  125. package/.versions/2.0.21/.pi/extensions/btw/package.json +6 -0
  126. package/.versions/2.0.21/.pi/extensions/btw/state.js +179 -0
  127. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  128. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  129. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  130. package/.versions/2.0.21/.pi/extensions/compact-and-continue/README.md +42 -0
  131. package/.versions/2.0.21/.pi/extensions/compact-and-continue/index.ts +136 -0
  132. package/.versions/2.0.21/.pi/extensions/compact-and-continue/package.json +6 -0
  133. package/.versions/2.0.21/.pi/extensions/mcp-bridge/README.md +46 -0
  134. package/.versions/2.0.21/.pi/extensions/mcp-bridge/index.ts +206 -0
  135. package/.versions/2.0.21/.pi/extensions/mcp-bridge/package.json +6 -0
  136. package/.versions/2.0.21/.pi/extensions/package-lock.json +1175 -0
  137. package/.versions/2.0.21/.pi/extensions/package.json +9 -0
  138. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/README.md +224 -0
  139. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/config.ts +198 -0
  140. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  141. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/index.ts +248 -0
  142. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/package.json +6 -0
  143. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  144. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  145. package/.versions/2.0.21/.pi/harnesses/agent-hub/README.md +1517 -0
  146. package/.versions/2.0.21/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  147. package/.versions/2.0.21/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  148. package/.versions/2.0.21/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  149. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  150. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  151. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  152. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  153. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  154. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  155. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  156. package/.versions/2.0.21/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  157. package/.versions/2.0.21/.pi/harnesses/agent-hub/artifacts.js +146 -0
  158. package/.versions/2.0.21/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  159. package/.versions/2.0.21/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  160. package/.versions/2.0.21/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  161. package/.versions/2.0.21/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  162. package/.versions/2.0.21/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  163. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  164. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  165. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  166. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  167. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  168. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  169. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  170. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  171. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  172. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  173. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  174. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  175. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  176. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  177. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  178. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  179. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  180. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  181. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  182. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  183. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  184. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  185. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  186. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  187. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  188. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  189. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  190. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  191. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  192. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  193. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  194. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  195. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  196. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  197. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  198. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  199. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  200. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  201. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  202. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  203. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  204. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  205. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  206. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  207. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  208. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  209. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  210. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  211. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  212. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  213. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  214. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-window.js +108 -0
  215. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  216. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  217. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  218. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  219. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  220. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  221. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  222. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  223. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  224. package/.versions/2.0.21/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  225. package/.versions/2.0.21/.pi/harnesses/agent-hub/delegate.ts +478 -0
  226. package/.versions/2.0.21/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  227. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  228. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  229. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  230. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  231. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  232. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  233. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +253 -0
  234. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  235. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  236. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  237. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  238. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  239. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  240. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  241. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  242. package/.versions/2.0.21/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  243. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  244. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  245. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  246. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  247. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  248. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  249. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  250. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  251. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  252. package/.versions/2.0.21/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  253. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  254. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  255. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  256. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  257. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  258. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  259. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  260. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  261. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  262. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  263. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  264. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  265. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  266. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  267. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  268. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  269. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  270. package/.versions/2.0.21/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  271. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  272. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.21/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.21/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.21/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  276. package/.versions/2.0.21/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  277. package/.versions/2.0.21/.pi/harnesses/agent-hub/index.ts +2616 -0
  278. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  279. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  280. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  281. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  282. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  283. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  284. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  285. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  286. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  287. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  288. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  289. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  290. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  291. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  292. package/.versions/2.0.21/.pi/harnesses/agent-hub/no-progress.ts +620 -0
  293. package/.versions/2.0.21/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  294. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  295. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  296. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  297. package/.versions/2.0.21/.pi/harnesses/agent-hub/package.json +7 -0
  298. package/.versions/2.0.21/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  299. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  300. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  301. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  302. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  303. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  304. package/.versions/2.0.21/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  305. package/.versions/2.0.21/.pi/harnesses/agent-hub/presentation.ts +48 -0
  306. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  307. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  308. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  309. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  310. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  311. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  312. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  313. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  314. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  315. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  316. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  317. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  318. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  319. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  320. package/.versions/2.0.21/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  321. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  322. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  323. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  324. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  325. package/.versions/2.0.21/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  326. package/.versions/2.0.21/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  327. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  328. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  329. package/.versions/2.0.21/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  330. package/.versions/2.0.21/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  331. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  332. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  333. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  334. package/.versions/2.0.21/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  335. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-contract.js +349 -0
  336. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-extract.js +77 -0
  337. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  338. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  339. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-findings.js +96 -0
  340. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  341. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  342. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  343. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-budget.js +342 -0
  344. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  345. package/.versions/2.0.21/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  346. package/.versions/2.0.21/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  347. package/.versions/2.0.21/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  348. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  349. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-health.js +110 -0
  350. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-start.ts +42 -0
  351. package/.versions/2.0.21/.pi/harnesses/agent-hub/spawn.ts +639 -0
  352. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  353. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  354. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  355. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  356. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  357. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  358. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  359. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  360. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  361. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  362. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  363. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  364. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  365. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  366. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  367. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  368. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  369. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  370. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  371. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  372. package/.versions/2.0.21/.pi/harnesses/agent-hub/timeline.ts +72 -0
  373. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  374. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  375. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  376. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  377. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  378. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  379. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  380. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  381. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  382. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +640 -0
  383. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  384. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  385. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  386. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  387. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  388. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  389. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  390. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  391. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  392. package/.versions/2.0.21/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  393. package/.versions/2.0.21/.pi/harnesses/agent-hub/types.ts +66 -0
  394. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  395. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  396. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  397. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  398. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  399. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  400. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  401. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  402. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  403. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  404. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  405. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  406. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  407. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  408. package/.versions/2.0.21/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  409. package/.versions/2.0.21/.pi/harnesses/agent-hub/version.ts +42 -0
  410. package/.versions/2.0.21/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  411. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  412. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  413. package/.versions/2.0.21/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  414. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/README.md +59 -0
  415. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/index.ts +569 -0
  416. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  417. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  418. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  419. package/.versions/2.0.21/.pi/harnesses/coms/README.md +100 -0
  420. package/.versions/2.0.21/.pi/harnesses/coms/index.ts +285 -0
  421. package/.versions/2.0.21/.pi/harnesses/coms/package.json +7 -0
  422. package/.versions/2.0.21/.pi/harnesses/coms/version.ts +42 -0
  423. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/README.md +161 -0
  424. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/index.ts +600 -0
  425. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/package.json +7 -0
  426. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  427. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  428. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  429. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  430. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/version.ts +42 -0
  431. package/.versions/2.0.21/.pi/harnesses/lib/approval-wait.ts +17 -0
  432. package/.versions/2.0.21/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  433. package/.versions/2.0.21/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  434. package/.versions/2.0.21/.pi/harnesses/lib/clarification-policy.ts +9 -0
  435. package/.versions/2.0.21/.pi/harnesses/lib/coms-core-io.ts +413 -0
  436. package/.versions/2.0.21/.pi/harnesses/lib/coms-core.ts +680 -0
  437. package/.versions/2.0.21/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  438. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  439. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  440. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-view.ts +112 -0
  441. package/.versions/2.0.21/.pi/harnesses/lib/context-budget.ts +114 -0
  442. package/.versions/2.0.21/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  443. package/.versions/2.0.21/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  444. package/.versions/2.0.21/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  445. package/.versions/2.0.21/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  446. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  447. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-view.ts +16 -0
  448. package/.versions/2.0.21/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  449. package/.versions/2.0.21/.pi/harnesses/lib/execution-trace.ts +45 -0
  450. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  451. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  452. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  453. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  454. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  455. package/.versions/2.0.21/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  456. package/.versions/2.0.21/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  457. package/.versions/2.0.21/.pi/harnesses/lib/fleet-panel.ts +34 -0
  458. package/.versions/2.0.21/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  459. package/.versions/2.0.21/.pi/harnesses/lib/fleet-selection.ts +24 -0
  460. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  461. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  462. package/.versions/2.0.21/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  463. package/.versions/2.0.21/.pi/harnesses/lib/herdr-client.ts +472 -0
  464. package/.versions/2.0.21/.pi/harnesses/lib/herdr-presence.ts +399 -0
  465. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  466. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  467. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  468. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  469. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  470. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  471. package/.versions/2.0.21/.pi/harnesses/lib/identical-dialog.ts +27 -0
  472. package/.versions/2.0.21/.pi/harnesses/lib/installation-state.js +62 -0
  473. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.js +106 -0
  474. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.ts +31 -0
  475. package/.versions/2.0.21/.pi/harnesses/lib/process-shared.ts +9 -0
  476. package/.versions/2.0.21/.pi/harnesses/lib/safe-source-read.js +29 -0
  477. package/.versions/2.0.21/.pi/harnesses/lib/semantic-approval.ts +80 -0
  478. package/.versions/2.0.21/.pi/harnesses/lib/spawned-peers.js +191 -0
  479. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  480. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  481. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  482. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  483. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-json.js +37 -0
  484. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-loader.js +44 -0
  485. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  486. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-triage.js +42 -0
  487. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-v2.js +112 -0
  488. package/.versions/2.0.21/.pi/harnesses/lib/system1/config.js +50 -0
  489. package/.versions/2.0.21/.pi/harnesses/lib/system1/contracts.ts +154 -0
  490. package/.versions/2.0.21/.pi/harnesses/lib/system1/demo.ts +95 -0
  491. package/.versions/2.0.21/.pi/harnesses/lib/system1/jev.ts +503 -0
  492. package/.versions/2.0.21/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  493. package/.versions/2.0.21/.pi/harnesses/lib/system1/selection.js +11 -0
  494. package/.versions/2.0.21/.pi/harnesses/lib/system1/service.ts +245 -0
  495. package/.versions/2.0.21/.pi/harnesses/lib/update-check.ts +222 -0
  496. package/.versions/2.0.21/.pi/harnesses/package-lock.json +2121 -0
  497. package/.versions/2.0.21/.pi/harnesses/package.json +13 -0
  498. package/.versions/2.0.21/.pi/prompts/af-build.md +27 -0
  499. package/.versions/2.0.21/.pi/prompts/af-code-simplify.md +22 -0
  500. package/.versions/2.0.21/.pi/prompts/af-constraints.md +31 -0
  501. package/.versions/2.0.21/.pi/prompts/af-plan.md +17 -0
  502. package/.versions/2.0.21/.pi/prompts/af-review.md +16 -0
  503. package/.versions/2.0.21/.pi/prompts/af-set-hermes-telegram.md +15 -0
  504. package/.versions/2.0.21/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  505. package/.versions/2.0.21/.pi/prompts/af-setup-rules.md +20 -0
  506. package/.versions/2.0.21/.pi/prompts/af-ship.md +17 -0
  507. package/.versions/2.0.21/.pi/prompts/af-spec.md +15 -0
  508. package/.versions/2.0.21/.pi/prompts/af-test.md +19 -0
  509. package/.versions/2.0.21/.pi/skills/bowser/SKILL.md +145 -0
  510. package/.versions/2.0.21/.version +1 -0
  511. package/.versions/2.0.21/agents/architect.md +24 -0
  512. package/.versions/2.0.21/agents/bowser.md +28 -0
  513. package/.versions/2.0.21/agents/builder.md +55 -0
  514. package/.versions/2.0.21/agents/code-reviewer.md +209 -0
  515. package/.versions/2.0.21/agents/deep-researcher.md +32 -0
  516. package/.versions/2.0.21/agents/documenter.md +22 -0
  517. package/.versions/2.0.21/agents/orchestrator.md +22 -0
  518. package/.versions/2.0.21/agents/plan-reviewer.md +83 -0
  519. package/.versions/2.0.21/agents/planner.md +107 -0
  520. package/.versions/2.0.21/agents/releaser.md +24 -0
  521. package/.versions/2.0.21/agents/researcher.md +30 -0
  522. package/.versions/2.0.21/agents/security-auditor.md +167 -0
  523. package/.versions/2.0.21/agents/test-engineer.md +153 -0
  524. package/.versions/2.0.21/agents/web-debugger.md +44 -0
  525. package/.versions/2.0.21/agents/web-performance-auditor.md +194 -0
  526. package/.versions/2.0.21/bin/catalog/harness-runtime-closure.json +73 -0
  527. package/.versions/2.0.21/codex/fleet-session-client/SKILL.md +34 -0
  528. package/.versions/2.0.21/codex/fleet-session-client.zip +0 -0
  529. package/.versions/2.0.21/docs/ARCHITECTURE.md +979 -0
  530. package/.versions/2.0.21/docs/agent-fleet-setup.md +1103 -0
  531. package/.versions/2.0.21/docs/claude-code-coms-bridge.md +147 -0
  532. package/.versions/2.0.21/docs/codex-session-bridge.md +219 -0
  533. package/.versions/2.0.21/docs/coms-hermes-bridge.md +188 -0
  534. package/.versions/2.0.21/docs/getting-started.md +126 -0
  535. package/.versions/2.0.21/docs/npm-install.md +535 -0
  536. package/.versions/2.0.21/docs/pi-extensions.md +455 -0
  537. package/.versions/2.0.21/docs/pi-setup.md +92 -0
  538. package/.versions/2.0.21/docs/skill-anatomy.md +150 -0
  539. package/.versions/2.0.21/install-manifest.json +3210 -0
  540. package/.versions/2.0.21/justfile +247 -0
  541. package/.versions/2.0.21/manifest-meta.json +1088 -0
  542. package/.versions/2.0.21/references/accessibility-checklist.md +160 -0
  543. package/.versions/2.0.21/references/communication-contract.md +26 -0
  544. package/.versions/2.0.21/references/definition-of-done.md +67 -0
  545. package/.versions/2.0.21/references/fleet-coordination-patterns.md +171 -0
  546. package/.versions/2.0.21/references/observability-checklist.md +92 -0
  547. package/.versions/2.0.21/references/orchestration-patterns.md +370 -0
  548. package/.versions/2.0.21/references/performance-checklist.md +236 -0
  549. package/.versions/2.0.21/references/prompting-patterns.md +380 -0
  550. package/.versions/2.0.21/references/security-checklist.md +245 -0
  551. package/.versions/2.0.21/references/testing-patterns.md +235 -0
  552. package/.versions/2.0.21/references/workflow-authoring.md +304 -0
  553. package/.versions/2.0.21/skills/_internal/grilling.md +59 -0
  554. package/.versions/2.0.21/skills/browser-testing-with-devtools/SKILL.md +351 -0
  555. package/.versions/2.0.21/skills/code-review-and-quality/SKILL.md +396 -0
  556. package/.versions/2.0.21/skills/compound-learning/SKILL.md +137 -0
  557. package/.versions/2.0.21/skills/constraint-driven-development/SKILL.md +338 -0
  558. package/.versions/2.0.21/skills/constraint-driven-development/references/floor-guard.md +99 -0
  559. package/.versions/2.0.21/skills/context-engineering/SKILL.md +341 -0
  560. package/.versions/2.0.21/skills/deprecation-and-migration/SKILL.md +247 -0
  561. package/.versions/2.0.21/skills/designing-agents/SKILL.md +394 -0
  562. package/.versions/2.0.21/skills/designing-agents/pi-harness-authoring.md +222 -0
  563. package/.versions/2.0.21/skills/drafting-workflows/SKILL.md +143 -0
  564. package/.versions/2.0.21/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  565. package/.versions/2.0.21/skills/frontend-ui-engineering/SKILL.md +328 -0
  566. package/.versions/2.0.21/skills/git-workflow-and-versioning/SKILL.md +316 -0
  567. package/.versions/2.0.21/skills/idea-refine/SKILL.md +182 -0
  568. package/.versions/2.0.21/skills/idea-refine/examples.md +238 -0
  569. package/.versions/2.0.21/skills/idea-refine/frameworks.md +99 -0
  570. package/.versions/2.0.21/skills/idea-refine/refinement-criteria.md +113 -0
  571. package/.versions/2.0.21/skills/idea-refine/scripts/idea-refine.sh +15 -0
  572. package/.versions/2.0.21/skills/incremental-implementation/SKILL.md +353 -0
  573. package/.versions/2.0.21/skills/incremental-implementation.zip +0 -0
  574. package/.versions/2.0.21/skills/interview-me/SKILL.md +226 -0
  575. package/.versions/2.0.21/skills/orchestration-verification/SKILL.md +182 -0
  576. package/.versions/2.0.21/skills/peer-coms/SKILL.md +90 -0
  577. package/.versions/2.0.21/skills/performance-optimization/SKILL.md +496 -0
  578. package/.versions/2.0.21/skills/planning-and-task-breakdown/SKILL.md +318 -0
  579. package/.versions/2.0.21/skills/planning-and-task-breakdown.zip +0 -0
  580. package/.versions/2.0.21/skills/repository-ai-setup/SKILL.md +135 -0
  581. package/.versions/2.0.21/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  582. package/.versions/2.0.21/skills/repository-ai-setup/references/apply-contract.md +74 -0
  583. package/.versions/2.0.21/skills/repository-ai-setup/references/provenance-template.md +16 -0
  584. package/.versions/2.0.21/skills/repository-ai-setup/references/setup-flow.md +108 -0
  585. package/.versions/2.0.21/skills/repository-ai-setup/references/verify-setup.md +20 -0
  586. package/.versions/2.0.21/skills/repository-ai-setup.zip +0 -0
  587. package/.versions/2.0.21/skills/security-and-hardening/SKILL.md +524 -0
  588. package/.versions/2.0.21/skills/spec-driven-development/SKILL.md +295 -0
  589. package/.versions/2.0.21/skills/spec-driven-development.zip +0 -0
  590. package/.versions/2.0.21/skills/using-agent-skills/SKILL.md +198 -0
  591. package/.versions/2.0.21/vendor/agent-skills-upstream/LICENSE +21 -0
  592. package/.versions/2.0.21/vendor/agent-skills-upstream/README.md +430 -0
  593. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  594. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  595. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  596. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  597. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  598. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  599. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  600. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  601. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  602. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  603. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  604. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  605. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  606. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  607. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  608. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  609. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  610. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  611. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  612. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  613. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  614. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  615. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  616. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  617. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  618. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  619. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  620. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  621. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  622. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  623. package/CHANGELOG.md +6 -0
  624. package/docs/ARCHITECTURE.md +4 -2
  625. package/install-manifest.json +1 -1
  626. package/package.json +1 -1
@@ -0,0 +1,35 @@
1
+ /** Operator-approved automatic policy. Explicit user compaction is independent. */
2
+ export const COMPACTION_MIN_PERCENT = 50;
3
+ export const COMPACTION_EARLY_PERCENT = 60;
4
+ export const COMPACTION_TARGET_PERCENT = 70;
5
+ export const COMPACTION_MAX_PERCENT = 80;
6
+ /** One hysteresis band of new history since the first post-compaction measurement. */
7
+ export const COMPACTION_REARM_GROWTH_PERCENT = COMPACTION_TARGET_PERCENT - COMPACTION_EARLY_PERCENT;
8
+
9
+ /** @param {unknown} value @returns {value is number} */
10
+ const count = value => typeof value === "number" && Number.isFinite(value) && value >= 0;
11
+
12
+ /** A window whose post-compaction baseline stays above the early threshold (system
13
+ * prompt, tool schemas, summary and kept recent turns) can never fall below it, so
14
+ * automatic compaction also re-arms once that much new history could be summarized.
15
+ * @param {number|null|undefined} baselineTokens first measurement after a compaction
16
+ * @param {number|null|undefined} tokens
17
+ * @param {number|null|undefined} contextWindow
18
+ */
19
+ export function compactionRearmed(baselineTokens, tokens, contextWindow) {
20
+ if (!count(tokens) || !count(baselineTokens) || !count(contextWindow) || contextWindow === 0) return false;
21
+ return tokens - baselineTokens >= contextWindow * COMPACTION_REARM_GROWTH_PERCENT / 100;
22
+ }
23
+
24
+ /** Compaction left usage between its target and the ceiling: another compaction
25
+ * cannot reach the target before one band of growth, so holding work at the ceiling
26
+ * would only stall it. A baseline at or above the ceiling still stops work, because
27
+ * the window cannot hold the history that compaction keeps.
28
+ * @param {number|null|undefined} baselineTokens
29
+ * @param {number|null|undefined} contextWindow
30
+ */
31
+ export function compactionShortOfTarget(baselineTokens, contextWindow) {
32
+ if (!count(baselineTokens) || !count(contextWindow) || contextWindow === 0) return false;
33
+ const percent = baselineTokens / contextWindow * 100;
34
+ return percent >= COMPACTION_TARGET_PERCENT && percent < COMPACTION_MAX_PERCENT;
35
+ }
@@ -0,0 +1,28 @@
1
+ import {createHash} from 'node:crypto';
2
+ const sha=(value:string)=>createHash('sha256').update(value).digest('hex');
3
+ function canonical(value:any,seen=new Set<object>()):any{
4
+ if(value===null||typeof value==='string'||typeof value==='boolean')return value;
5
+ if(typeof value==='number'){if(!Number.isFinite(value))throw Error('non_json_input');return value;}
6
+ if(typeof value!=='object')throw Error('non_json_input');
7
+ if(seen.has(value))throw Error('cyclic_input');seen.add(value);
8
+ try{
9
+ if(Array.isArray(value))return value.map(v=>canonical(v,seen));
10
+ if(![Object.prototype,null].includes(Object.getPrototypeOf(value)))throw Error('non_json_input');
11
+ return Object.fromEntries(Object.keys(value).sort().filter(k=>value[k]!==undefined).map(k=>[k,canonical(value[k],seen)]));
12
+ }finally{seen.delete(value);}
13
+ }
14
+ /** Full JSON input identity is independent of object-key order, not of field values. */
15
+ export function damageActionHashes(operation:string,input:unknown):{target:string;legacyTargets:readonly string[]}{
16
+ const target=sha(JSON.stringify(canonical(input))),legacy=new Set<string>();
17
+ // Compatibility for the previously unwired v1 helpers' raw JSON hashes.
18
+ // Only the small, known native scalar argument shapes are enumerated.
19
+ const fields=operation==='bash'?['command','timeout']:operation==='write'?['path','content']:operation==='edit'?['path','oldText','newText']:[];
20
+ if(input&&typeof input==='object'&&!Array.isArray(input)){
21
+ const row=input as Record<string,unknown>,keys=Object.keys(row);
22
+ if(keys.length&&keys.every(k=>fields.includes(k))){
23
+ const visit=(prefix:string[],remaining:string[])=>{if(!remaining.length){legacy.add(sha(JSON.stringify(Object.fromEntries(prefix.map(k=>[k,row[k]])))));return;}for(const key of remaining)visit([...prefix,key],remaining.filter(k=>k!==key));};
24
+ visit([],keys);
25
+ }
26
+ }
27
+ return {target,legacyTargets:Object.freeze([...legacy].filter(h=>h!==target).sort())};
28
+ }
@@ -0,0 +1,229 @@
1
+ /**
2
+ * Shared exemption + escalation plumbing for damage-control-continue and agent-hub.
3
+ *
4
+ * Exemptions are runtime, session-scoped allowances layered on top of
5
+ * `.pi/damage-control-rules.yaml` — they never edit the rules file and only
6
+ * ever apply to the path categories (zeroAccessPaths / readOnlyPaths /
7
+ * noDeletePaths), never to the destructive bashToolPatterns.
8
+ *
9
+ * Consumers:
10
+ * - damage-control-continue — /allow commands, block-time prompts, and
11
+ * escalation to the agent-hub dispatcher from headless children
12
+ * - agent-hub — computes the shared file path, passes the env plumbing to
13
+ * spawned children, and answers access_request envelopes on its coms socket
14
+ */
15
+
16
+ import * as fs from "fs";
17
+ import * as net from "net";
18
+ import * as os from "os";
19
+ import * as path from "path";
20
+ import { parse as parseYaml } from 'yaml';
21
+ import { safeSourceRead } from './safe-source-read.js';
22
+
23
+ /** Explicit file-access check for consumers outside the named tool hook. Invalid policy fails closed. */
24
+ export function currentFileAccessAllowed(root: string, target: string): boolean {
25
+ const project = path.join(root, '.pi/damage-control-rules.yaml');
26
+ const global = path.join(os.homedir(), '.pi/damage-control-rules.yaml');
27
+ try {
28
+ const selected = fs.existsSync(project) ? project : fs.existsSync(global) ? global : null;
29
+ if (!selected) return true;
30
+ const policy = parseYaml(safeSourceRead(selected === project ? root : os.homedir(), selected, 65536).toString('utf8'));
31
+ if (!policy || typeof policy !== 'object' || Array.isArray(policy) || (policy.zeroAccessPaths !== undefined && (!Array.isArray(policy.zeroAccessPaths) || policy.zeroAccessPaths.some((p: unknown) => typeof p !== 'string')))) return false;
32
+ return !(policy.zeroAccessPaths ?? []).some((p: string) => damageControlPathMatches(path.resolve(root, target), p, root));
33
+ } catch { return false; }
34
+ }
35
+
36
+ // Env plumbing agent-hub sets on spawned children. spawnPiAgent spreads
37
+ // process.env, so delegate grandchildren inherit these for free.
38
+ export const ASK_ENDPOINT_ENV = "AGENT_HUB_ASK_ENDPOINT";
39
+ export const EXEMPTIONS_FILE_ENV = "AGENT_HUB_EXEMPTIONS_FILE";
40
+ export const AGENT_ID_ENV = "AGENT_HUB_AGENT_ID";
41
+
42
+ export type ExemptionScope = "turn" | "session";
43
+ export type PathRuleCategory = "zero_access" | "read_only" | "no_delete";
44
+
45
+ export interface Exemption {
46
+ /** The protected pattern being unlocked — same syntax as the rules file entries. */
47
+ pattern: string;
48
+ scope: ExemptionScope;
49
+ /** When set, the exemption applies only to the spawned agent with this id. */
50
+ agent?: string;
51
+ grantedVia: "command" | "prompt" | "escalation";
52
+ grantedAt: string;
53
+ }
54
+
55
+ // ── shared exemptions file (one per hub session, read by spawned children) ──
56
+
57
+ export function exemptionsFilePath(sessionId: string): string {
58
+ const comsDir = process.env.PI_COMS_DIR || path.join(os.homedir(), ".pi", "coms");
59
+ return path.join(comsDir, "exemptions", `${sessionId}.json`);
60
+ }
61
+
62
+ export function readExemptionsFile(filePath: string | undefined): Exemption[] {
63
+ if (!filePath) return [];
64
+ try {
65
+ const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
66
+ if (!Array.isArray(parsed)) return [];
67
+ return parsed.filter((e): e is Exemption => !!e && typeof e.pattern === "string" && e.pattern.length > 0);
68
+ } catch {
69
+ return [];
70
+ }
71
+ }
72
+
73
+ /** Exemptions visible to one process: agent-agnostic entries plus those granted to `agentId`. */
74
+ export function fileExemptionsFor(filePath: string | undefined, agentId: string | undefined): Exemption[] {
75
+ return readExemptionsFile(filePath).filter((e) => !e.agent || e.agent === agentId);
76
+ }
77
+
78
+ export function appendExemptionToFile(filePath: string, exemption: Exemption): void {
79
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
80
+ const existing = readExemptionsFile(filePath);
81
+ const dup = existing.some((e) => e.pattern === exemption.pattern && (e.agent ?? "") === (exemption.agent ?? ""));
82
+ if (!dup) existing.push(exemption);
83
+ const tmp = `${filePath}.tmp`;
84
+ fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
85
+ fs.renameSync(tmp, filePath);
86
+ }
87
+
88
+ /** Remove every entry for `pattern` (any agent). Returns true when something was removed. */
89
+ export function removeExemptionFromFile(filePath: string | undefined, pattern: string): boolean {
90
+ if (!filePath) return false;
91
+ const existing = readExemptionsFile(filePath);
92
+ const next = existing.filter((e) => e.pattern !== pattern);
93
+ if (next.length === existing.length) return false;
94
+ try {
95
+ const tmp = `${filePath}.tmp`;
96
+ fs.writeFileSync(tmp, JSON.stringify(next, null, 2));
97
+ fs.renameSync(tmp, filePath);
98
+ return true;
99
+ } catch {
100
+ return false;
101
+ }
102
+ }
103
+
104
+ // ── escalation protocol (headless child → hub dispatcher) ──
105
+
106
+ /**
107
+ * Sent by a child's damage-control-continue to the hub's coms socket. Carries
108
+ * the Envelope base fields (sender_session = agent id, sender_endpoint = "")
109
+ * so the hub's isValidEnvelope accepts it.
110
+ */
111
+ export interface AccessRequest {
112
+ /** Diagnostic correlation only; these fields never authorize access. */
113
+ toolCallId?: string;
114
+ traceOwner?: string;
115
+ type: "access_request";
116
+ msg_id: string;
117
+ sender_session: string;
118
+ sender_endpoint: string;
119
+ hops: number;
120
+ timestamp: string;
121
+ agent: string;
122
+ tool: string;
123
+ rule: string;
124
+ pattern: string;
125
+ category: PathRuleCategory;
126
+ invocation: string;
127
+ }
128
+
129
+ export type AccessDecisionChoice = "deny" | "allow_once" | "allow_agent" | "allow_all";
130
+
131
+ /** Protected deletions are approved per invocation; broader grants stay operator-explicit. */
132
+ export function accessDecisionChoices(category: PathRuleCategory): AccessDecisionChoice[] {
133
+ return category === "no_delete"
134
+ ? ["deny", "allow_once"]
135
+ : ["deny", "allow_once", "allow_agent", "allow_all"];
136
+ }
137
+
138
+ /** Coalesce identical asks without letting one delete approval cover sibling paths. */
139
+ export function accessRequestCacheKey(
140
+ request: Pick<AccessRequest, "agent" | "pattern" | "category" | "invocation">,
141
+ ): string {
142
+ const base = `${request.agent}::${request.pattern}`;
143
+ return request.category === "no_delete" ? `${base}::${request.invocation}` : base;
144
+ }
145
+
146
+ export interface AccessDecision {
147
+ type: "access_decision";
148
+ msg_id: string;
149
+ decision: AccessDecisionChoice;
150
+ }
151
+
152
+ export const ESCALATION_TIMEOUT_MS = Number(process.env.AGENT_HUB_ASK_TIMEOUT_MS) || 60_000;
153
+
154
+ /**
155
+ * Ask the hub to approve a blocked call. Synchronous over a single connection:
156
+ * the child has no socket server of its own, so the hub keeps this socket open
157
+ * and writes the decision line whenever the user answers. Resolves "timeout" /
158
+ * "error" instead of rejecting — callers always fail closed.
159
+ */
160
+ export function requestAccessFromHub(
161
+ endpoint: string,
162
+ request: AccessRequest,
163
+ timeoutMs: number = ESCALATION_TIMEOUT_MS,
164
+ ): Promise<AccessDecisionChoice | "timeout" | "error"> {
165
+ return new Promise((resolve) => {
166
+ let settled = false;
167
+ let timer: ReturnType<typeof setTimeout> | undefined;
168
+ let sock: net.Socket;
169
+ const settle = (v: AccessDecisionChoice | "timeout" | "error") => {
170
+ if (settled) return;
171
+ settled = true;
172
+ if (timer) clearTimeout(timer);
173
+ try { sock.destroy(); } catch { /* ignore */ }
174
+ resolve(v);
175
+ };
176
+ try {
177
+ sock = net.createConnection({ path: endpoint });
178
+ } catch {
179
+ resolve("error");
180
+ return;
181
+ }
182
+ timer = setTimeout(() => settle("timeout"), timeoutMs);
183
+ let buf = "";
184
+ sock.on("connect", () => {
185
+ try {
186
+ sock.write(JSON.stringify(request) + "\n");
187
+ } catch {
188
+ settle("error");
189
+ }
190
+ });
191
+ sock.on("data", (chunk: Buffer) => {
192
+ buf += chunk.toString("utf-8");
193
+ const nl = buf.indexOf("\n");
194
+ if (nl < 0) return;
195
+ try {
196
+ const parsed = JSON.parse(buf.slice(0, nl));
197
+ if (
198
+ parsed &&
199
+ parsed.type === "access_decision" &&
200
+ (parsed.decision === "deny" || parsed.decision === "allow_once" ||
201
+ parsed.decision === "allow_agent" || parsed.decision === "allow_all")
202
+ ) {
203
+ settle(parsed.decision);
204
+ } else {
205
+ // nack or unknown reply (e.g. an older hub without escalation support)
206
+ settle("error");
207
+ }
208
+ } catch {
209
+ settle("error");
210
+ }
211
+ });
212
+ sock.on("error", () => settle("error"));
213
+ sock.on("close", () => settle("error"));
214
+ });
215
+ }
216
+
217
+ export function damageControlPathMatches(targetPath: string, pattern: string, cwd: string): boolean {
218
+ const resolvedPattern = pattern.startsWith("~") ? path.join(os.homedir(), pattern.slice(1)) : pattern;
219
+ if (resolvedPattern.endsWith("/")) {
220
+ const absolutePattern = path.isAbsolute(resolvedPattern) ? resolvedPattern : path.resolve(cwd, resolvedPattern);
221
+ return targetPath.startsWith(absolutePattern);
222
+ }
223
+ const regexPattern = resolvedPattern
224
+ .replace(/[.+^${}()|[\]\\]/g, "\\$&")
225
+ .replace(/\*/g, ".*");
226
+ const regex = new RegExp(`^${regexPattern}$|^${regexPattern}/|/${regexPattern}$|/${regexPattern}/`);
227
+ const relativePath = path.relative(cwd, targetPath);
228
+ return regex.test(targetPath) || regex.test(relativePath) || targetPath.includes(resolvedPattern) || relativePath.includes(resolvedPattern);
229
+ }
@@ -0,0 +1,25 @@
1
+ import {processShared} from './process-shared.ts';
2
+ export interface DamageCallEvent {toolName:string;toolCallId:string;input:unknown;}
3
+ export interface DamageCallContext {cwd:string;revalidateBaseline?():boolean;}
4
+ export interface DamageGuardPort {call(event:DamageCallEvent,ctx:DamageCallContext):Promise<{block:boolean;reason?:string}>;}
5
+ // The Hub registers in its module instance while Damage-Control assesses in another.
6
+ const state=processShared<{port?:DamageGuardPort;spawned?:{assignment:unknown}}>('agent-fleet.damage-guard-port.v1',()=>({}));
7
+ /** Process-owned adapter only. Missing registration preserves standalone baseline, not a second provider. */
8
+ export function registerDamageGuard(next:DamageGuardPort){state.port=next;return ()=>{if(state.port===next)state.port=undefined;};}
9
+ export function assessDamageCall(event:DamageCallEvent,ctx:DamageCallContext){return state.port?state.port.call(event,ctx):Promise.resolve({block:false});}
10
+ export const DAMAGE_ASSIGNMENT_ENV='AF_D6_ASSIGNMENT';
11
+ const parsed=(raw:string):unknown=>{try{return JSON.parse(raw);}catch{return null;}};
12
+ /** Pi calls an extension factory without dependencies, so a native child's fresh assignment
13
+ * arrives through the trusted spawn environment. Damage-Control takes it before any tool runs:
14
+ * Bash subprocesses (tests, nested pi) never inherit the capability. Malformed transport stays
15
+ * assigned, so the child fails closed instead of silently losing D6. */
16
+ export function takeSpawnedDamageAssignment():unknown {
17
+ const raw=process.env[DAMAGE_ASSIGNMENT_ENV];
18
+ if(raw!==undefined){delete process.env[DAMAGE_ASSIGNMENT_ENV];state.spawned={assignment:parsed(raw)};}
19
+ return state.spawned?.assignment;
20
+ }
21
+ /** Descendant registration: a present transport wins, otherwise the copy Damage-Control took. */
22
+ export function spawnedDamageAssignment():unknown {
23
+ const raw=process.env[DAMAGE_ASSIGNMENT_ENV];
24
+ return raw!==undefined?parsed(raw):state.spawned?.assignment;
25
+ }
@@ -0,0 +1,25 @@
1
+ import {processShared} from './process-shared.ts';
2
+ /** Emission-local original evidence. Pi 1.1.0 passes the same event to each result hook,
3
+ * but loads each extension with its own module instance, so the capture is process-shared. */
4
+ interface EvidenceState {originals:WeakMap<object,unknown>;unavailable:WeakSet<object>;}
5
+ const {originals,unavailable}=processShared<EvidenceState>('agent-fleet.damage-result-evidence.v1',()=>({originals:new WeakMap(),unavailable:new WeakSet()}));
6
+ function freeze(value:any,seen=new Set<object>()){
7
+ if(!value||typeof value!=='object'||seen.has(value))return;
8
+ if(!Array.isArray(value)&&![Object.prototype,null].includes(Object.getPrototypeOf(value)))throw Error('unsupported_evidence');
9
+ seen.add(value);for(const child of Object.values(value))freeze(child,seen);Object.freeze(value);
10
+ }
11
+ export type DamageCaptureState='uncaptured'|'captured'|'failed';
12
+ /** Consumers requiring independent provenance must require the captured state. */
13
+ export function damageCaptureState(event:object):DamageCaptureState{
14
+ return unavailable.has(event)?'failed':originals.has(event)?'captured':'uncaptured';
15
+ }
16
+ /** Legacy parent compatibility: uncaptured is not a known capture failure. */
17
+ export function damageCaptureAvailable(event:object){return damageCaptureState(event)!=='failed';}
18
+ export function captureDamageResult<T extends {content:readonly unknown[]}>(event:T):T {
19
+ if(!originals.has(event)&&!unavailable.has(event)){
20
+ try{JSON.stringify(event);const snapshot=structuredClone(event);freeze(snapshot);originals.set(event,snapshot);}catch{unavailable.add(event);}
21
+ }
22
+ return (originals.get(event) as T|undefined)??event;
23
+ }
24
+ /** Failed capture is an explicit gap, never a mutable alias advertised as original. */
25
+ export function originalDamageResult<T extends object>(event:T):T|undefined{return unavailable.has(event)?undefined:(originals.get(event) as T|undefined)??event;}
@@ -0,0 +1,16 @@
1
+ /** Visible programmatic views carry the advisory as well as untouched original evidence. */
2
+ export function damageResultView<T extends {content:readonly any[];structuredContent?:unknown}>(event:T,text:string,metadata:unknown,key:'damageGuard'|'fileDiscovery'='damageGuard'):T{
3
+ const original=event.structuredContent;
4
+ const advisory={metadata,text};
5
+ let structuredContent:unknown=original;
6
+ if(typeof original==='string')structuredContent=original+'\n'+text;
7
+ else if(original!==undefined){
8
+ const plain=!!original&&typeof original==='object'&&!Array.isArray(original)&&Object.getPrototypeOf(original)===Object.prototype;
9
+ // D8 composes onto the D6 view without replacing its warning or original slot.
10
+ if(key==='fileDiscovery'&&plain&&!Object.hasOwn(original as object,key))structuredContent={...original as object,[key]:advisory};
11
+ else structuredContent=plain&&!Object.hasOwn(original as object,key)&&!Object.hasOwn(original as object,'originalStructuredContent')?{...original as object,originalStructuredContent:original,[key]:advisory}:{originalStructuredContent:original,[key]:advisory};
12
+ }
13
+ // Strings retain their declared native output type; the emission-local evidence
14
+ // snapshot and untouched original text block retain the exact original string.
15
+ return {...event,content:[...event.content,{type:'text',text}],structuredContent} as T;
16
+ }
@@ -0,0 +1,25 @@
1
+ export type DeterministicFilesystemHandle = {
2
+ v: 1;
3
+ kind: "file" | "inventory";
4
+ path: string;
5
+ hash: string;
6
+ offset: number;
7
+ rootId?: string;
8
+ };
9
+
10
+ export function decodeDeterministicHandle(value: string): DeterministicFilesystemHandle {
11
+ try {
12
+ if (!value.startsWith("t5:")) throw new Error();
13
+ const parsed = JSON.parse(Buffer.from(value.slice(3), "base64url").toString("utf8"));
14
+ if (parsed?.v !== 1 || !["file", "inventory"].includes(parsed.kind) || typeof parsed.path !== "string" || typeof parsed.hash !== "string" || !Number.isSafeInteger(parsed.offset) || parsed.offset < 0) throw new Error();
15
+ if (parsed.rootId !== undefined && (typeof parsed.rootId !== "string" || !parsed.rootId)) throw new Error();
16
+ return parsed;
17
+ } catch {
18
+ throw new Error("Invalid deterministic filesystem handle");
19
+ }
20
+ }
21
+
22
+ /** Resolve a handle's bound path without reading source bytes; used by policy hooks before execution. */
23
+ export function deterministicHandlePath(value: string): string {
24
+ return decodeDeterministicHandle(value).path;
25
+ }
@@ -0,0 +1,45 @@
1
+ /** Metadata-only observations. These messages never carry permission or evidence authority. */
2
+ export const EXECUTION_TRACE_CHANNEL = "agent-fleet:execution-trace";
3
+ export const TRACE_OWNER_ENV = "AGENT_FLEET_TRACE_OWNER";
4
+ export type TraceKind = "input" | "turn" | "model" | "tool" | "policy" | "approval" | "queue" | "child";
5
+ export type TraceSource = "runtime" | "native" | "process" | "task-triage" | "damage-control" | "damage-guard" | "access-escalation";
6
+ export type TraceStatus = "pending" | "completed" | "failed" | "allowed" | "denied" | "blocked" | "cancelled" | "interrupted" | "unavailable" | "reused" | "not_started" | "busy";
7
+ export interface TraceStart {
8
+ kind: TraceKind; id: string; owner?: string; parentId?: string; parentKind?: TraceKind;
9
+ source?: TraceSource; tool?: string; rule?: string; reason?: string; fingerprint?: string; actor?: string;
10
+ }
11
+ export interface TraceEnd { status: TraceStatus; durationMs?: number; childId?: string; rule?: string; reason?: string; analysis?: "static_operands" | "conservative_text"; decision?: "selected_first" | "selected_second" | "freeform" | "multiple" | "none"; }
12
+ export interface TraceBus { emit(channel: string, value: unknown): void; }
13
+ export interface TraceEnvelope { start: TraceStart; end?: TraceEnd; token?: object; finish?: (end: TraceEnd) => void; }
14
+
15
+ /** The collector supplies a session-fenced completion callback synchronously. */
16
+ export function beginRuntimeTrace(bus: TraceBus | undefined, start: TraceStart): (end: TraceEnd) => void {
17
+ const envelope: TraceEnvelope = { start };
18
+ try { bus?.emit(EXECUTION_TRACE_CHANNEL, envelope); } catch { /* Diagnostic only. */ }
19
+ return end => { try { envelope.finish?.(end); } catch { /* Diagnostic only. */ } };
20
+ }
21
+ export function emitRuntimeTrace(bus: TraceBus | undefined, signal: TraceStart & {status: TraceStatus}): void {
22
+ beginRuntimeTrace(bus, signal)({ status: signal.status });
23
+ }
24
+
25
+ /** Record answer shape, never answer text or inferred permission semantics. */
26
+ export function traceAskResult(result: unknown, options: readonly unknown[]): TraceEnd {
27
+ const value = result as { isError?: boolean; details?: { cancelled?: boolean; response?: { kind?: string; selections?: unknown[] } } } | null;
28
+ if (value?.isError) return { status: "failed" };
29
+ if (value?.details?.cancelled) return { status: "cancelled", decision: "none" };
30
+ const response = value?.details?.response;
31
+ const selections = response?.selections ?? [];
32
+ const label = (option: unknown) => typeof option === "string" ? option : (option as {title?:unknown})?.title;
33
+ const index = selections.length === 1 ? options.findIndex(option => label(option) === selections[0]) : -1;
34
+ return { status: "completed",
35
+ decision: response?.kind === "freeform" ? "freeform" : selections.length > 1 ? "multiple" : index === 0 ? "selected_first" : index === 1 ? "selected_second" : "none" };
36
+ }
37
+
38
+ export function policyTraceReason(text:string):string {
39
+ if(/zero.access|Glob matches|Find pattern matches/i.test(text))return 'zero_access';
40
+ if(/read.only/i.test(text))return 'read_only';
41
+ if(/delete\/move protected|no.delete/i.test(text))return 'no_delete';
42
+ if(/authority changed|revoked/i.test(text))return 'authority_changed';
43
+ if(/user denied|keep blocked/i.test(text))return 'human_denial';
44
+ return 'policy_rule';
45
+ }
@@ -0,0 +1,11 @@
1
+ [
2
+ {"name":"greeting","plane":"hub","prompt":"stable core policy","tools":["ask_user"]},
3
+ {"name":"direct-coding","plane":"hub","prompt":"stable direct coding policy","tools":["read","edit","write","bash"]},
4
+ {"name":"fleet","plane":"hub","prompt":"stable fleet policy","tools":["dispatch_agent","spawn_research","set_task_tier"]},
5
+ {"name":"verification","plane":"hub","prompt":"stable verification policy","tools":["set_assertions","update_assertion","get_assertions"]},
6
+ {"name":"peer","plane":"hub","prompt":"stable peer policy","tools":["coms_list","coms_send","coms_await"]},
7
+ {"name":"workspace","plane":"hub","prompt":"stable workspace policy","tools":["herdr_spawn_peer","herdr_read_pane","herdr_close_pane"]},
8
+ {"name":"compaction-full-fleet","plane":"hub","prompt":"stable full fleet policy","tools":["dispatch_agent","spawn_research","request_compaction","coms_send","herdr_spawn_pane"]},
9
+ {"name":"research-helper","plane":"research","prompt":"read-only research policy","tools":["read","grep","find","ls"]},
10
+ {"name":"specialist","plane":"specialist","prompt":"specialist policy","tools":["read","edit","write","bash"]}
11
+ ]
@@ -0,0 +1,73 @@
1
+ You are the Fleet operator. You may work on the codebase directly and may also coordinate specialist agents when delegation adds value. You have these tools: `dispatch_agent`, `spawn_research`.
2
+
3
+ ## Language
4
+ - ALWAYS communicate with the human user in **English**.
5
+
6
+ ## Native Roster: default
7
+ Members: Builder, Reviewer
8
+ You can ONLY dispatch to agents listed below. Do not attempt to dispatch to agents
9
+ outside this team. The roster CAN change mid-session: the human via /af-agents-add,
10
+ /af-agents-drop, /af-agents-team — or you via `team_adjust` (add/drop with a reason)
11
+ when the current roster genuinely cannot serve the task. Use it sparingly; more
12
+ personas is usually the wrong answer.
13
+
14
+ ## How to Work
15
+ - Analyze the user's request and break it into clear sub-tasks.
16
+ - Choose the right agent(s) for each sub-task.
17
+ - Dispatch tasks via `dispatch_agent`.
18
+ - Choose `backend: native` when the user explicitly requests a local Pi specialist, `backend: coms` when they explicitly request a live same-name peer, and `backend: auto` otherwise. Never substitute one explicit backend for another.
19
+ - Review results and dispatch follow-up agents if needed.
20
+ - If a task fails, try a different agent or adjust the task description.
21
+ - Summarize the outcome for the user in English.
22
+
23
+ ## ask_user is NOT available in this session
24
+
25
+ ## Task triage (before dispatch)
26
+ ## Verification Contract
27
+
28
+ ## Research helpers (read-only)
29
+ - `spawn_research` runs a READ-ONLY helper (read/grep/find/ls — no bash, no writes)
30
+ and returns its findings to you inline. Use it for reconnaissance, code search, and
31
+ reading docs/code BEFORE you dispatch a builder — or to fan out background research.
32
+ - Two flavours: pass `persona` to spawn one of the research personas listed below (it
33
+ brings its own role/model); omit `persona` for an ad-hoc helper (optional `model`).
34
+ - Match the helper to the job: use a lighter/faster persona for simple reads and a
35
+ higher-capability one for ambiguous, cross-cutting, or high-stakes research. Compare
36
+ the **Model** / **Thinking** shown for each persona below and pick deliberately.
37
+ - Specialists you dispatch are sandboxed and CANNOT spawn their own helpers. When a
38
+ specialist needs research help, YOU run `spawn_research`, collect the findings, and
39
+ fold them into the specialist's task — do not ask the specialist to do it itself.
40
+ - Research helpers are ephemeral and read-only, so they are always safe to run.
41
+
42
+ ## Hard Rules
43
+ - You MAY read, execute, edit, and write directly in operator work mode.
44
+ - Use direct tools for focused work when they are the simplest path; delegate when specialization, parallelism, or independent verification adds value.
45
+ - Give concurrent writable agents explicit non-overlapping scopes and inspect overlap warnings before proceeding.
46
+ - NEVER proceed past an ambiguity by guessing.
47
+ - You can chain agents: spawn_research to gather context, builder to implement.
48
+ - You can dispatch the same agent multiple times with different tasks.
49
+ - Keep tasks focused — one clear objective per dispatch.
50
+
51
+ ## Agents
52
+
53
+ ### Builder
54
+ **Dispatch as:** `builder`
55
+ Implements slices.
56
+ **Tools:** read,write
57
+
58
+ ### Reviewer
59
+ **Dispatch as:** `reviewer`
60
+ Reviews code.
61
+ **Tools:** read
62
+
63
+ ## Research personas
64
+
65
+ ### Deep Researcher
66
+ **Spawn as:** `spawn_research(persona: "deep-researcher")`
67
+ **Model:** local · **Thinking:** off
68
+ Cross-cutting recon.
69
+
70
+ ### Coverage Scout
71
+ **Spawn as:** `spawn_research(persona: "coverage-scout")`
72
+ **Model:** local · **Thinking:** off
73
+ Test inventory.
@@ -0,0 +1,73 @@
1
+ You are a dispatcher agent — an orchestrator. You coordinate specialist agents to accomplish tasks. You do NOT have direct access to the codebase. You have these tools: `dispatch_agent`, `spawn_research`.
2
+
3
+ ## Language
4
+ - ALWAYS communicate with the human user in **English**.
5
+
6
+ ## Native Roster: default
7
+ Members: Builder, Reviewer
8
+ You can ONLY dispatch to agents listed below. Do not attempt to dispatch to agents
9
+ outside this team. The roster CAN change mid-session: the human via /af-agents-add,
10
+ /af-agents-drop, /af-agents-team — or you via `team_adjust` (add/drop with a reason)
11
+ when the current roster genuinely cannot serve the task. Use it sparingly; more
12
+ personas is usually the wrong answer.
13
+
14
+ ## How to Work
15
+ - Analyze the user's request and break it into clear sub-tasks.
16
+ - Choose the right agent(s) for each sub-task.
17
+ - Dispatch tasks via `dispatch_agent`.
18
+ - Choose `backend: native` when the user explicitly requests a local Pi specialist, `backend: coms` when they explicitly request a live same-name peer, and `backend: auto` otherwise. Never substitute one explicit backend for another.
19
+ - Review results and dispatch follow-up agents if needed.
20
+ - If a task fails, try a different agent or adjust the task description.
21
+ - Summarize the outcome for the user in English.
22
+
23
+ ## ask_user is NOT available in this session
24
+
25
+ ## Task triage (before dispatch)
26
+ ## Verification Contract
27
+
28
+ ## Research helpers (read-only)
29
+ - `spawn_research` runs a READ-ONLY helper (read/grep/find/ls — no bash, no writes)
30
+ and returns its findings to you inline. Use it for reconnaissance, code search, and
31
+ reading docs/code BEFORE you dispatch a builder — or to fan out background research.
32
+ - Two flavours: pass `persona` to spawn one of the research personas listed below (it
33
+ brings its own role/model); omit `persona` for an ad-hoc helper (optional `model`).
34
+ - Match the helper to the job: use a lighter/faster persona for simple reads and a
35
+ higher-capability one for ambiguous, cross-cutting, or high-stakes research. Compare
36
+ the **Model** / **Thinking** shown for each persona below and pick deliberately.
37
+ - Specialists you dispatch are sandboxed and CANNOT spawn their own helpers. When a
38
+ specialist needs research help, YOU run `spawn_research`, collect the findings, and
39
+ fold them into the specialist's task — do not ask the specialist to do it itself.
40
+ - Research helpers are ephemeral and read-only, so they are always safe to run.
41
+
42
+ ## Hard Rules
43
+ - NEVER try to read, write, or execute code directly — you have no such tools.
44
+ - ALWAYS use `dispatch_agent` to get implementation work done; use `spawn_research` for read-only recon.
45
+ - `herdr_spawn_pane` is only for auxiliary processes such as watchers or servers; NEVER use it to bypass delegation by reading, editing, testing, or implementing code in a raw pane.
46
+ - NEVER proceed past an ambiguity by guessing.
47
+ - You can chain agents: spawn_research to gather context, builder to implement.
48
+ - You can dispatch the same agent multiple times with different tasks.
49
+ - Keep tasks focused — one clear objective per dispatch.
50
+
51
+ ## Agents
52
+
53
+ ### Builder
54
+ **Dispatch as:** `builder`
55
+ Implements slices.
56
+ **Tools:** read,write
57
+
58
+ ### Reviewer
59
+ **Dispatch as:** `reviewer`
60
+ Reviews code.
61
+ **Tools:** read
62
+
63
+ ## Research personas
64
+
65
+ ### Deep Researcher
66
+ **Spawn as:** `spawn_research(persona: "deep-researcher")`
67
+ **Model:** local · **Thinking:** off
68
+ Cross-cutting recon.
69
+
70
+ ### Coverage Scout
71
+ **Spawn as:** `spawn_research(persona: "coverage-scout")`
72
+ **Model:** local · **Thinking:** off
73
+ Test inventory.