@chankov/agent-fleet 2.0.8 → 2.0.9

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 (453) hide show
  1. package/.pi/harnesses/agent-hub/README.md +20 -6
  2. package/.pi/harnesses/agent-hub/footer.ts +1 -1
  3. package/.pi/harnesses/agent-hub/index.ts +47 -66
  4. package/.pi/harnesses/agent-hub/input/shortcuts.ts +2 -0
  5. package/.pi/harnesses/agent-hub/package.json +1 -1
  6. package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  7. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +16 -42
  8. package/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  9. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  10. package/.pi/harnesses/agent-hub/ui/grid.ts +145 -33
  11. package/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -139
  12. package/.pi/harnesses/coms/package.json +1 -1
  13. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  14. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +17 -0
  15. package/.pi/harnesses/lib/fleet-dashboard-view.ts +22 -36
  16. package/.pi/harnesses/lib/fleet-read-model.ts +109 -27
  17. package/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  18. package/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  19. package/.versions/2.0.9/.pi/agent-fleet/hermes/README.md +347 -0
  20. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  21. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  22. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  23. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  24. package/.versions/2.0.9/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  25. package/.versions/2.0.9/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  26. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  27. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  28. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  29. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  30. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  31. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  32. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  33. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  34. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  35. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  36. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  37. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  38. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  39. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  40. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  41. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  42. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  43. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  44. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  45. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  46. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  47. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  48. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  49. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  50. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  51. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  52. package/.versions/2.0.9/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  53. package/.versions/2.0.9/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  54. package/.versions/2.0.9/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  55. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  56. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  57. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  58. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  59. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  60. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet.ts +216 -0
  61. package/.versions/2.0.9/.pi/agent-fleet/scripts/flow.ts +137 -0
  62. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  63. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  64. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  65. package/.versions/2.0.9/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  66. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  67. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  68. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  69. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  70. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  71. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  72. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  73. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  74. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  75. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  76. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  77. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  78. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  79. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  80. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  81. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  82. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  83. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  84. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  85. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  86. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  87. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  88. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  89. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  90. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  91. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  92. package/.versions/2.0.9/.pi/agent-fleet/scripts/package-lock.json +35 -0
  93. package/.versions/2.0.9/.pi/agent-fleet/scripts/package.json +9 -0
  94. package/.versions/2.0.9/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  95. package/.versions/2.0.9/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  96. package/.versions/2.0.9/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  97. package/.versions/2.0.9/.pi/agent-fleet/scripts/team-up.ts +378 -0
  98. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  99. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  100. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  101. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  102. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  103. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  104. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  105. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  106. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  107. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  108. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  109. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  110. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  111. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  112. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  113. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  114. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  115. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  116. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  117. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  118. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  119. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  120. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  121. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  122. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  123. package/.versions/2.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  124. package/.versions/2.0.9/.pi/agents/model-profiles.yaml +83 -0
  125. package/.versions/2.0.9/.pi/agents/peers.yaml +147 -0
  126. package/.versions/2.0.9/.pi/agents/teams.yaml +41 -0
  127. package/.versions/2.0.9/.pi/agents/voices.yaml +13 -0
  128. package/.versions/2.0.9/.pi/damage-control-rules.yaml +297 -0
  129. package/.versions/2.0.9/.pi/extensions/btw/README.md +120 -0
  130. package/.versions/2.0.9/.pi/extensions/btw/index.ts +914 -0
  131. package/.versions/2.0.9/.pi/extensions/btw/package.json +6 -0
  132. package/.versions/2.0.9/.pi/extensions/btw/state.js +179 -0
  133. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  134. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  135. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  136. package/.versions/2.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  137. package/.versions/2.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  138. package/.versions/2.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  139. package/.versions/2.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  140. package/.versions/2.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  141. package/.versions/2.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  142. package/.versions/2.0.9/.pi/extensions/package-lock.json +1175 -0
  143. package/.versions/2.0.9/.pi/extensions/package.json +9 -0
  144. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/README.md +205 -0
  145. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  146. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  147. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  148. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  149. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  150. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  151. package/.versions/2.0.9/.pi/harnesses/agent-hub/README.md +1217 -0
  152. package/.versions/2.0.9/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  153. package/.versions/2.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  154. package/.versions/2.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  155. package/.versions/2.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  156. package/.versions/2.0.9/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  157. package/.versions/2.0.9/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  158. package/.versions/2.0.9/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  159. package/.versions/2.0.9/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  160. package/.versions/2.0.9/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  161. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  162. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  163. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  164. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  165. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  166. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  167. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  168. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  169. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  170. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  171. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  172. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  173. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  174. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  175. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  176. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  177. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  178. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  179. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  180. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  181. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  182. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  183. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  184. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  185. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  186. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  187. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  188. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  189. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  190. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  191. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  192. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  193. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  194. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  195. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  196. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  197. package/.versions/2.0.9/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  198. package/.versions/2.0.9/.pi/harnesses/agent-hub/delegate.ts +446 -0
  199. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  200. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  201. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  202. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  203. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  204. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  205. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  206. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  207. package/.versions/2.0.9/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  208. package/.versions/2.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  209. package/.versions/2.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  210. package/.versions/2.0.9/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  211. package/.versions/2.0.9/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  212. package/.versions/2.0.9/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  213. package/.versions/2.0.9/.pi/harnesses/agent-hub/footer.ts +30 -0
  214. package/.versions/2.0.9/.pi/harnesses/agent-hub/helpers.ts +266 -0
  215. package/.versions/2.0.9/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  216. package/.versions/2.0.9/.pi/harnesses/agent-hub/index.ts +2132 -0
  217. package/.versions/2.0.9/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  218. package/.versions/2.0.9/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  219. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  220. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  221. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  222. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  223. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  224. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  225. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  226. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  227. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  228. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  229. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  230. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  231. package/.versions/2.0.9/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  232. package/.versions/2.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  233. package/.versions/2.0.9/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  234. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  235. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  236. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  237. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  238. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  239. package/.versions/2.0.9/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  240. package/.versions/2.0.9/.pi/harnesses/agent-hub/presentation.ts +48 -0
  241. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  242. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  243. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  244. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  245. package/.versions/2.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  246. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  247. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  248. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  249. package/.versions/2.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  250. package/.versions/2.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  251. package/.versions/2.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  252. package/.versions/2.0.9/.pi/harnesses/agent-hub/review-findings.js +102 -0
  253. package/.versions/2.0.9/.pi/harnesses/agent-hub/run-budget.js +537 -0
  254. package/.versions/2.0.9/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  255. package/.versions/2.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  256. package/.versions/2.0.9/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  257. package/.versions/2.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  258. package/.versions/2.0.9/.pi/harnesses/agent-hub/session-start.ts +42 -0
  259. package/.versions/2.0.9/.pi/harnesses/agent-hub/spawn.ts +404 -0
  260. package/.versions/2.0.9/.pi/harnesses/agent-hub/timeline.ts +54 -0
  261. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  262. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  263. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  264. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  265. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  266. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  267. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  268. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  269. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  270. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  271. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  272. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  273. package/.versions/2.0.9/.pi/harnesses/agent-hub/types.ts +63 -0
  274. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  275. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  276. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  277. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  278. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  279. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  280. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  281. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  282. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  283. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  284. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  285. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  286. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  287. package/.versions/2.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  288. package/.versions/2.0.9/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  289. package/.versions/2.0.9/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  290. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/README.md +59 -0
  291. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/index.ts +558 -0
  292. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  293. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  294. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  295. package/.versions/2.0.9/.pi/harnesses/coms/README.md +100 -0
  296. package/.versions/2.0.9/.pi/harnesses/coms/index.ts +282 -0
  297. package/.versions/2.0.9/.pi/harnesses/coms/package.json +7 -0
  298. package/.versions/2.0.9/.pi/harnesses/coms/version.ts +42 -0
  299. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/README.md +135 -0
  300. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/index.ts +541 -0
  301. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  302. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  303. package/.versions/2.0.9/.pi/harnesses/lib/coms-core-io.ts +385 -0
  304. package/.versions/2.0.9/.pi/harnesses/lib/coms-core.ts +577 -0
  305. package/.versions/2.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  306. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  307. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  308. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-view.ts +107 -0
  309. package/.versions/2.0.9/.pi/harnesses/lib/context-budget.ts +114 -0
  310. package/.versions/2.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  311. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  312. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  313. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  314. package/.versions/2.0.9/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  315. package/.versions/2.0.9/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  316. package/.versions/2.0.9/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  317. package/.versions/2.0.9/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  318. package/.versions/2.0.9/.pi/harnesses/lib/fleet-panel.ts +34 -0
  319. package/.versions/2.0.9/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  320. package/.versions/2.0.9/.pi/harnesses/lib/fleet-selection.ts +24 -0
  321. package/.versions/2.0.9/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  322. package/.versions/2.0.9/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  323. package/.versions/2.0.9/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  324. package/.versions/2.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  325. package/.versions/2.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  326. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  327. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  328. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  329. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  330. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  331. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  332. package/.versions/2.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  333. package/.versions/2.0.9/.pi/harnesses/lib/update-check.ts +222 -0
  334. package/.versions/2.0.9/.pi/harnesses/package-lock.json +2039 -0
  335. package/.versions/2.0.9/.pi/harnesses/package.json +10 -0
  336. package/.versions/2.0.9/.pi/prompts/af-build.md +24 -0
  337. package/.versions/2.0.9/.pi/prompts/af-code-simplify.md +22 -0
  338. package/.versions/2.0.9/.pi/prompts/af-constraints.md +31 -0
  339. package/.versions/2.0.9/.pi/prompts/af-plan.md +17 -0
  340. package/.versions/2.0.9/.pi/prompts/af-review.md +16 -0
  341. package/.versions/2.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  342. package/.versions/2.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  343. package/.versions/2.0.9/.pi/prompts/af-ship.md +17 -0
  344. package/.versions/2.0.9/.pi/prompts/af-spec.md +15 -0
  345. package/.versions/2.0.9/.pi/prompts/af-test.md +19 -0
  346. package/.versions/2.0.9/.pi/skills/bowser/SKILL.md +145 -0
  347. package/.versions/2.0.9/.version +1 -0
  348. package/.versions/2.0.9/agents/architect.md +25 -0
  349. package/.versions/2.0.9/agents/bowser.md +28 -0
  350. package/.versions/2.0.9/agents/builder.md +56 -0
  351. package/.versions/2.0.9/agents/code-reviewer.md +210 -0
  352. package/.versions/2.0.9/agents/deep-researcher.md +33 -0
  353. package/.versions/2.0.9/agents/documenter.md +23 -0
  354. package/.versions/2.0.9/agents/orchestrator.md +23 -0
  355. package/.versions/2.0.9/agents/plan-reviewer.md +84 -0
  356. package/.versions/2.0.9/agents/planner.md +106 -0
  357. package/.versions/2.0.9/agents/releaser.md +25 -0
  358. package/.versions/2.0.9/agents/researcher.md +31 -0
  359. package/.versions/2.0.9/agents/security-auditor.md +168 -0
  360. package/.versions/2.0.9/agents/test-engineer.md +154 -0
  361. package/.versions/2.0.9/agents/web-debugger.md +44 -0
  362. package/.versions/2.0.9/agents/web-performance-auditor.md +194 -0
  363. package/.versions/2.0.9/bin/catalog/harness-runtime-closure.json +32 -0
  364. package/.versions/2.0.9/codex/fleet-session-client/SKILL.md +34 -0
  365. package/.versions/2.0.9/codex/fleet-session-client.zip +0 -0
  366. package/.versions/2.0.9/docs/ARCHITECTURE.md +416 -0
  367. package/.versions/2.0.9/docs/agent-fleet-setup.md +568 -0
  368. package/.versions/2.0.9/docs/claude-code-coms-bridge.md +134 -0
  369. package/.versions/2.0.9/docs/codex-session-bridge.md +219 -0
  370. package/.versions/2.0.9/docs/coms-hermes-bridge.md +188 -0
  371. package/.versions/2.0.9/docs/getting-started.md +126 -0
  372. package/.versions/2.0.9/docs/npm-install.md +356 -0
  373. package/.versions/2.0.9/docs/pi-extensions.md +449 -0
  374. package/.versions/2.0.9/docs/pi-setup.md +76 -0
  375. package/.versions/2.0.9/docs/skill-anatomy.md +150 -0
  376. package/.versions/2.0.9/install-manifest.json +2991 -0
  377. package/.versions/2.0.9/justfile +247 -0
  378. package/.versions/2.0.9/manifest-meta.json +970 -0
  379. package/.versions/2.0.9/references/accessibility-checklist.md +160 -0
  380. package/.versions/2.0.9/references/communication-contract.md +26 -0
  381. package/.versions/2.0.9/references/definition-of-done.md +67 -0
  382. package/.versions/2.0.9/references/fleet-coordination-patterns.md +171 -0
  383. package/.versions/2.0.9/references/observability-checklist.md +92 -0
  384. package/.versions/2.0.9/references/orchestration-patterns.md +370 -0
  385. package/.versions/2.0.9/references/performance-checklist.md +236 -0
  386. package/.versions/2.0.9/references/prompting-patterns.md +380 -0
  387. package/.versions/2.0.9/references/security-checklist.md +245 -0
  388. package/.versions/2.0.9/references/testing-patterns.md +235 -0
  389. package/.versions/2.0.9/references/workflow-authoring.md +304 -0
  390. package/.versions/2.0.9/skills/_internal/grilling.md +59 -0
  391. package/.versions/2.0.9/skills/browser-testing-with-devtools/SKILL.md +351 -0
  392. package/.versions/2.0.9/skills/code-review-and-quality/SKILL.md +396 -0
  393. package/.versions/2.0.9/skills/compound-learning/SKILL.md +137 -0
  394. package/.versions/2.0.9/skills/constraint-driven-development/SKILL.md +338 -0
  395. package/.versions/2.0.9/skills/constraint-driven-development/references/floor-guard.md +99 -0
  396. package/.versions/2.0.9/skills/context-engineering/SKILL.md +341 -0
  397. package/.versions/2.0.9/skills/deprecation-and-migration/SKILL.md +247 -0
  398. package/.versions/2.0.9/skills/designing-agents/SKILL.md +394 -0
  399. package/.versions/2.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  400. package/.versions/2.0.9/skills/drafting-workflows/SKILL.md +143 -0
  401. package/.versions/2.0.9/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  402. package/.versions/2.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/.versions/2.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  404. package/.versions/2.0.9/skills/idea-refine/SKILL.md +182 -0
  405. package/.versions/2.0.9/skills/idea-refine/examples.md +238 -0
  406. package/.versions/2.0.9/skills/idea-refine/frameworks.md +99 -0
  407. package/.versions/2.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/.versions/2.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/.versions/2.0.9/skills/incremental-implementation/SKILL.md +302 -0
  410. package/.versions/2.0.9/skills/interview-me/SKILL.md +226 -0
  411. package/.versions/2.0.9/skills/orchestration-verification/SKILL.md +181 -0
  412. package/.versions/2.0.9/skills/peer-coms/SKILL.md +90 -0
  413. package/.versions/2.0.9/skills/performance-optimization/SKILL.md +496 -0
  414. package/.versions/2.0.9/skills/planning-and-task-breakdown/SKILL.md +289 -0
  415. package/.versions/2.0.9/skills/security-and-hardening/SKILL.md +524 -0
  416. package/.versions/2.0.9/skills/spec-driven-development/SKILL.md +295 -0
  417. package/.versions/2.0.9/skills/using-agent-skills/SKILL.md +198 -0
  418. package/.versions/2.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  419. package/.versions/2.0.9/vendor/agent-skills-upstream/README.md +430 -0
  420. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  421. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  422. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  423. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  424. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  425. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  426. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  427. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  428. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  429. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  430. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  431. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  432. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  433. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  434. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  435. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  436. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  437. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  438. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  439. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  440. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  441. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  442. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  443. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  444. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  445. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  446. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  447. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  448. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  449. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  450. package/CHANGELOG.md +24 -0
  451. package/docs/pi-extensions.md +3 -0
  452. package/install-manifest.json +1 -1
  453. package/package.json +34 -12
@@ -0,0 +1,282 @@
1
+ /**
2
+ * coms — Peer-to-peer messaging between Pi agents on the same machine.
3
+ *
4
+ * Transport, registry, presence, and correlation state live in the shared
5
+ * harness core. This entry point owns only Pi registrations and presentation.
6
+ */
7
+
8
+ import type { ExtensionAPI, ExtensionContext, Theme } from "@mariozechner/pi-coding-agent";
9
+ import { Text, truncateToWidth } from "@mariozechner/pi-tui";
10
+ import { Type } from "@sinclair/typebox";
11
+
12
+ import {
13
+ abbreviateModel,
14
+ ComsConnectError,
15
+ createComsPeer,
16
+ hexFg,
17
+ readAllRegistryEntries,
18
+ readAllRegistryEntriesAcrossProjects,
19
+ type ComsIdentity,
20
+ TIMEOUT_MS,
21
+ } from "../lib/coms-core.ts";
22
+ import { registerVersionStatus } from "./version.ts";
23
+ import { handleQuestionEnvelope, registerQuestionPeer } from "../ask-user-remote/questions.ts";
24
+
25
+ export default function (pi: ExtensionAPI) {
26
+ pi.registerFlag("name", { description: "Override agent name (otherwise from frontmatter or auto-generated)", type: "string", default: undefined });
27
+ pi.registerFlag("purpose", { description: "Override agent purpose (otherwise from frontmatter description)", type: "string", default: undefined });
28
+ pi.registerFlag("project", { description: "Project namespace for peer discovery", type: "string", default: "default" });
29
+ pi.registerFlag("color", { description: "Hex color #RRGGBB (otherwise from frontmatter or palette fallback)", type: "string", default: undefined });
30
+ pi.registerFlag("explicit", { description: "Hide this agent from auto-discovery; only addressable by exact name", type: "boolean", default: false });
31
+
32
+ let currentCtx: ExtensionContext | null = null;
33
+ const peer = createComsPeer({
34
+ pi,
35
+ getContext: () => currentCtx,
36
+ onPeersChanged: () => { if (currentCtx?.hasUI) installPoolWidget(currentCtx); },
37
+ handleCustomEnvelope: handleQuestionEnvelope,
38
+ });
39
+ const unregisterQuestions = registerQuestionPeer(() => peer.ready && peer.identity ? {
40
+ project: peer.identity.project, peer: peer.identity.name,
41
+ sessionId: peer.identity.session_id, startedAt: peer.identity.started_at,
42
+ } : null);
43
+
44
+ function renderPool(width: number, theme: Theme): string[] {
45
+ const identity = peer.identity;
46
+ const projectFilter = peer.scope.displayProject ?? identity?.project ?? "default";
47
+ const registryEntries = projectFilter === "*"
48
+ ? readAllRegistryEntriesAcrossProjects()
49
+ : readAllRegistryEntries(projectFilter);
50
+ const rows: Array<{
51
+ name: string; model: string; color: string; purpose: string;
52
+ pct: number | null; pending: boolean; stale: boolean;
53
+ }> = [];
54
+ const seenSessions = new Set<string>();
55
+ for (const [sessionId, card] of peer.peerCards) {
56
+ if (identity && sessionId === identity.session_id) continue;
57
+ seenSessions.add(sessionId);
58
+ rows.push({
59
+ name: card.name, model: card.model, color: card.color, purpose: card.purpose,
60
+ pct: card.context_used_pct, pending: false, stale: card.staleCount >= 3,
61
+ });
62
+ }
63
+ const seenNames = new Set(rows.map(row => row.name));
64
+ for (const entry of registryEntries) {
65
+ if (identity && entry.session_id === identity.session_id) continue;
66
+ if (!peer.scope.includeExplicit && entry.explicit) continue;
67
+ if (seenSessions.has(entry.session_id) || seenNames.has(entry.name)) continue;
68
+ rows.push({
69
+ name: entry.name, model: entry.model, color: entry.color, purpose: entry.purpose,
70
+ pct: null, pending: true, stale: false,
71
+ });
72
+ }
73
+
74
+ const safeWidth = Math.max(0, width);
75
+ let topBorder: string;
76
+ let bottomBorder: string;
77
+ if (safeWidth < 12) {
78
+ topBorder = theme.fg("dim", "━".repeat(safeWidth));
79
+ bottomBorder = theme.fg("dim", "━".repeat(safeWidth));
80
+ } else {
81
+ const left = theme.fg("dim", "┏━") + theme.fg("border", " coms ");
82
+ const nameLength = identity?.name.length ?? 0;
83
+ const rightTagLength = identity ? nameLength + 4 : 0;
84
+ const remaining = safeWidth - 9 - rightTagLength - 1;
85
+ if (identity && remaining >= 1) {
86
+ topBorder = left + theme.fg("dim", "━" + "━".repeat(remaining)) +
87
+ theme.fg("dim", " ") + hexFg(identity.color, identity.name) + theme.fg("dim", " ━┓");
88
+ } else {
89
+ topBorder = left + theme.fg("dim", "━".repeat(Math.max(0, safeWidth - 9)) + "┓");
90
+ }
91
+ bottomBorder = theme.fg("dim", `┗${"━".repeat(safeWidth - 2)}┛`);
92
+ }
93
+ if (rows.length === 0) {
94
+ return [topBorder, truncateToWidth(theme.fg("dim", " ") + theme.fg("muted", "no peers connected"), width), bottomBorder];
95
+ }
96
+ rows.sort((a, b) => a.name.localeCompare(b.name));
97
+ const output = [topBorder];
98
+ for (const row of rows) {
99
+ const percent = row.pct ?? 0;
100
+ const filled = Math.max(0, Math.min(15, Math.round(percent / 100 * 15)));
101
+ const percentLabel = row.pct == null ? "--%" : `${row.pct}%`;
102
+ if (row.stale) {
103
+ output.push(truncateToWidth(` ${theme.fg("dim", `✗ ${row.name.padEnd(12)} ${abbreviateModel(row.model).padEnd(14)} [${"-".repeat(15)}] ${percentLabel.padStart(4)} — ${row.purpose}`)}`, width));
104
+ continue;
105
+ }
106
+ const swatch = row.pending ? theme.fg("dim", "●") : hexFg(row.color, "●");
107
+ const barFill = row.pending
108
+ ? theme.fg("dim", "-".repeat(15))
109
+ : hexFg(row.color, "#".repeat(filled)) + theme.fg("dim", "-".repeat(15 - filled));
110
+ const line = ` ${swatch} ${theme.fg("accent", row.name.padEnd(12))} ${theme.fg("dim", abbreviateModel(row.model).padEnd(14))} ` +
111
+ theme.fg("warning", "[") + barFill + theme.fg("warning", "]") +
112
+ ` ${theme.fg("accent", percentLabel.padStart(4))}${theme.fg("dim", " — ")}${theme.fg("muted", row.purpose)}`;
113
+ output.push(truncateToWidth(line, width));
114
+ }
115
+ output.push(bottomBorder);
116
+ return output;
117
+ }
118
+
119
+ function installPoolWidget(ctx: ExtensionContext): void {
120
+ if (!ctx.hasUI) return;
121
+ try {
122
+ ctx.ui.setWidget("coms-pool", (_tui, theme) => ({ invalidate() {}, render: (width: number) => renderPool(width, theme) }), { placement: "belowEditor" });
123
+ } catch { /* non-fatal */ }
124
+ }
125
+
126
+ pi.registerTool({
127
+ name: "coms_list",
128
+ label: "Coms List",
129
+ description:
130
+ "List the peer agents in your current coms pool — the ones shown in the pool widget. Returns " +
131
+ "names, models, live context-window usage, the herdr pane_id, and status (idle | working | " +
132
+ "booting). CHECK STATUS BEFORE SENDING: `working` means the peer is mid-turn and your send " +
133
+ "will wait for it; `booting` means it registered but is not addressable yet. Use this instead " +
134
+ "of reading the peer's pane to guess whether it is busy. Discovery is scoped to what the human " +
135
+ "displays via /af-coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
136
+ parameters: Type.Object({
137
+ project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /af-coms displays — a widening request is ignored." })),
138
+ include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /af-coms --all." })),
139
+ }),
140
+ async execute(_callId, params) {
141
+ if (!peer.identity) return { content: [{ type: "text" as const, text: "coms not initialised." }], details: { agents: [], project: null } };
142
+ const result = await peer.list(params);
143
+ const notice = result.widenRequested
144
+ ? `\n\n(Discovery is scoped to "${result.project}"${peer.scope.includeExplicit ? "" : ", explicit peers hidden"}. ` +
145
+ `Widening to other projects or revealing --explicit peers is a human action via ` +
146
+ `/af-coms --project <name> or /af-coms --all.)`
147
+ : "";
148
+ const lines = result.agents.length === 0
149
+ ? "No peer agents in your pool."
150
+ : result.agents.map(agent => {
151
+ const context = agent.context_used_pct != null ? ` ${agent.context_used_pct}%` : " ?%";
152
+ const state = ` [${agent.alive ? (agent.status ?? "unknown") : "unreachable"}${agent.pane_id ? ` pane ${agent.pane_id}` : ""}]`;
153
+ return `${agent.alive ? "●" : "✗"} ${agent.name} (${agent.model})${context}${state}${agent.purpose ? ` — ${agent.purpose}` : ""}`;
154
+ }).join("\n");
155
+ return { content: [{ type: "text" as const, text: `${result.agents.length} peer(s) in pool (project ${result.project}):\n${lines}${notice}` }], details: result };
156
+ },
157
+ renderCall(args, theme) {
158
+ const project = (args as any).project;
159
+ return new Text(theme.fg("toolTitle", theme.bold("coms_list")) + theme.fg("dim", project ? ` ${project}` : ""), 0, 0);
160
+ },
161
+ renderResult(result, options, theme) {
162
+ const agents: any[] = (result.details as any)?.agents ?? [];
163
+ const header = theme.fg("accent", `📡 ${agents.length} peer(s)`);
164
+ if (!options.expanded || agents.length === 0) return new Text(header, 0, 0);
165
+ const rows = agents.map(agent => {
166
+ const dot = agent.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
167
+ const percent = agent.context_used_pct != null ? `${agent.context_used_pct}%` : "?%";
168
+ const state = agent.alive ? (agent.status ?? "unknown") : "unreachable";
169
+ const stateColor = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
170
+ return `${dot} ${theme.fg("accent", agent.name)} ${theme.fg("dim", agent.model)} ${theme.fg("warning", percent)} ` +
171
+ `${theme.fg(stateColor as any, state)}${agent.pane_id ? theme.fg("dim", ` ${agent.pane_id}`) : ""}`;
172
+ }).join("\n");
173
+ return new Text(header + "\n" + rows, 0, 0);
174
+ },
175
+ });
176
+
177
+ pi.registerTool({
178
+ name: "coms_send",
179
+ label: "Coms Send",
180
+ description:
181
+ "Send a prompt to a peer agent. Returns synchronously with a msg_id once the receiver acks. " +
182
+ "Use coms_get (non-blocking) or coms_await (blocking) with the msg_id to retrieve the response. " +
183
+ "Throws if the receiver is unreachable or rejects the envelope.",
184
+ parameters: Type.Object({
185
+ target: Type.String({ description: "Peer name (preferred) or session_id — must be a peer currently in your coms pool (shown in the widget). Out-of-pool targets are refused; ask the human to widen scope with /af-coms --project or /af-coms --all." }),
186
+ prompt: Type.String({ description: "The prompt to send." }),
187
+ conversation_id: Type.Optional(Type.String()),
188
+ response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
189
+ reply_timeout_ms: Type.Optional(Type.Number({ description: "How long you will wait for the reply (ms). Pass the same value you intend to give coms_await: a receiver that drives an interactive agent (e.g. a Claude Code pane) uses this instead of its own default, so long reviews are not cut short. Clamped to 1 hour." })),
190
+ }),
191
+ async execute(_callId, params) {
192
+ const sent = await peer.send(params);
193
+ return { content: [{ type: "text" as const, text: `coms_send → ${sent.target}\nmsg_id ${sent.msg_id}\nhops ${sent.hops}` }], details: { msg_id: sent.msg_id, target: sent.target, target_session: sent.target_session, hops: sent.hops } };
194
+ },
195
+ renderCall(args, theme) {
196
+ const target = (args as any).target ?? "?";
197
+ const prompt = (args as any).prompt ?? "";
198
+ const preview = prompt.length > 60 ? prompt.slice(0, 57) + "..." : prompt;
199
+ return new Text(theme.fg("toolTitle", theme.bold("coms_send ")) + theme.fg("accent", target) +
200
+ theme.fg("dim", " — ") + theme.fg("muted", preview), 0, 0);
201
+ },
202
+ renderResult(result, _options, theme) {
203
+ const details = result.details as any;
204
+ if (!details) {
205
+ const content = result.content[0];
206
+ return new Text(content?.type === "text" ? content.text : "", 0, 0);
207
+ }
208
+ return new Text(theme.fg("success", "→ ") + theme.fg("accent", details.target) +
209
+ theme.fg("dim", " msg_id ") + theme.fg("warning", details.msg_id), 0, 0);
210
+ },
211
+ });
212
+
213
+ pi.registerTool({
214
+ name: "coms_get",
215
+ label: "Coms Get",
216
+ description: "Non-blocking poll of a pending coms_send reply. Returns status pending|complete|error and (when complete) the response.",
217
+ parameters: Type.Object({ msg_id: Type.String({ description: "msg_id returned by coms_send." }) }),
218
+ async execute(_callId, params) {
219
+ const result = peer.get(params.msg_id);
220
+ const text = result.status === "error" ? `coms_get: unknown msg_id ${params.msg_id}` : result.status === "pending" ? "coms_get: pending" : result.error ? `coms_get: error — ${result.error}` : `coms_get: complete\n${typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2)}`;
221
+ return { content: [{ type: "text" as const, text }], details: result };
222
+ },
223
+ renderCall(args, theme) { return new Text(theme.fg("toolTitle", theme.bold("coms_get ")) + theme.fg("warning", (args as any).msg_id ?? "?"), 0, 0); },
224
+ renderResult(result, _options, theme) { const status = (result.details as any)?.status ?? "?"; return new Text(theme.fg(status === "complete" ? "success" : status === "pending" ? "warning" : "error", status), 0, 0); },
225
+ });
226
+
227
+ pi.registerTool({
228
+ name: "coms_await",
229
+ label: "Coms Await",
230
+ description: "Block until a pending coms_send reply lands or the timeout fires. Default timeout 30 minutes (PI_COMS_TIMEOUT_MS).",
231
+ parameters: Type.Object({
232
+ msg_id: Type.String({ description: "msg_id returned by coms_send." }),
233
+ timeout_ms: Type.Optional(Type.Number({ description: "Override the default timeout (ms)." })),
234
+ }),
235
+ async execute(_callId, params) {
236
+ const result = await peer.await(params.msg_id, typeof params.timeout_ms === "number" && params.timeout_ms > 0 ? params.timeout_ms : TIMEOUT_MS);
237
+ if (result.status === "pending") return { content: [{ type: "text" as const, text: "coms_await: pending — wait budget exhausted; the peer may still complete" }], details: { status: "pending" } };
238
+ if (result.status === "error") {
239
+ const unknown = result.error === "unknown msg_id";
240
+ return {
241
+ content: [{ type: "text" as const, text: unknown ? `coms_await: unknown msg_id ${params.msg_id}` : `coms_await: error — ${result.error}` }],
242
+ details: unknown ? { error: "unknown msg_id" } : { status: "error", error: result.error },
243
+ };
244
+ }
245
+ return {
246
+ content: [{ type: "text" as const, text: typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2) }],
247
+ details: { response: result.response },
248
+ };
249
+ },
250
+ renderCall(args, theme) { return new Text(theme.fg("toolTitle", theme.bold("coms_await ")) + theme.fg("warning", (args as any).msg_id ?? "?"), 0, 0); },
251
+ renderResult(result, _options, theme) { const details = result.details as any; return new Text(theme.fg(details?.status === "pending" ? "warning" : details?.status === "error" ? "error" : "success", details?.status === "pending" ? "⏳ pending" : details?.status === "error" ? `✗ ${details.error}` : "✓ response received"), 0, 0); },
252
+ });
253
+
254
+ pi.registerCommand("af-coms", {
255
+ description: "Force-refresh the coms pool widget (or filter with --all / --project <name>)",
256
+ handler: async (args, ctx) => { await peer.updateScope((args ?? "").trim(), ctx); },
257
+ });
258
+
259
+ pi.on("session_start", async (_event, ctx) => {
260
+ registerVersionStatus(ctx);
261
+ currentCtx = ctx;
262
+ let identity: ComsIdentity;
263
+ try {
264
+ identity = await peer.connect({ ctx, defaultNamePrefix: "agent", defaultPurpose: "" });
265
+ } catch (error) {
266
+ if (!(error instanceof ComsConnectError)) throw error;
267
+ const label = error.stage === "dirs" ? "failed to create dirs" : error.stage === "registry" ? "registry write failed" : "bind failed";
268
+ ctx.ui?.notify?.(`📡 coms: ${label} — ${error instanceof Error ? error.message : String(error)}`, "error");
269
+ return;
270
+ }
271
+ try {
272
+ ctx.ui.setStatus("coms", `📡 ${identity.name}@${identity.project}`);
273
+ installPoolWidget(ctx);
274
+ ctx.ui.notify(`📡 coms ready · ${identity.name}@${identity.project} · ${peer.scope.displayProject ?? identity.project} pool`, "info");
275
+ } catch { /* UI is optional */ }
276
+ });
277
+ pi.on("before_agent_start", async () => { await peer.setTurnState("working"); });
278
+ pi.on("agent_end", async (_event, ctx) => { await peer.setTurnState("idle"); await peer.respond(ctx); });
279
+ pi.on("session_shutdown", async () => { unregisterQuestions(); await peer.shutdown(); if (currentCtx?.hasUI) currentCtx.ui.setWidget("coms-pool", undefined); });
280
+ process.on("SIGINT", () => { void peer.shutdown(); });
281
+ process.on("SIGTERM", () => { void peer.shutdown(); });
282
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "name": "agent-fleet-pi-coms",
3
+ "private": true,
4
+ "type": "module",
5
+ "main": "index.ts",
6
+ "version": "2.0.9"
7
+ }
@@ -0,0 +1,42 @@
1
+ import { readFileSync } from "node:fs";
2
+
3
+ export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+ export const VERSION_LABEL = "agent fleet";
5
+ export const VERSION_LABEL_URL = "https://github.com/chankov/agent-fleet";
6
+
7
+ /**
8
+ * Wrap `text` in an OSC 8 hyperlink. Terminals that support it make the label
9
+ * clickable and hand the URL to the OS opener; terminals that don't ignore the
10
+ * sequence and render `text` unchanged. pi's TUI strips OSC sequences before
11
+ * measuring (`visibleWidth`) and truncating, so a linked label costs no footer
12
+ * columns. Multiplexers that mangle unknown OSC (GNU screen, tmux before 3.4)
13
+ * are the reason for the AGENT_FLEET_NO_LINKS opt-out below.
14
+ */
15
+ export function linkify(text: string, url: string): string {
16
+ return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
17
+ }
18
+
19
+ function linksEnabled(): boolean {
20
+ const optOut = process.env.AGENT_FLEET_NO_LINKS;
21
+ return !optOut || optOut === "0" || optOut === "false";
22
+ }
23
+
24
+ export function formatVersionLabel(version: string): string {
25
+ const label = linksEnabled() ? linkify(VERSION_LABEL, VERSION_LABEL_URL) : VERSION_LABEL;
26
+ return `${label} v${version}`;
27
+ }
28
+
29
+ function readAdjacentVersion(): string | null {
30
+ try {
31
+ const manifest = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
32
+ return typeof manifest.version === "string" && manifest.version.length > 0 ? manifest.version : null;
33
+ } catch {
34
+ return null;
35
+ }
36
+ }
37
+
38
+ export const HARNESS_VERSION = readAdjacentVersion();
39
+
40
+ export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
41
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, formatVersionLabel(HARNESS_VERSION));
42
+ }
@@ -0,0 +1,135 @@
1
+ # damage-control-continue
2
+
3
+ Safety auditing — blocks destructive tool calls, but lets the agent **adapt and keep working**.
4
+
5
+ > Ported from [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) by [disler](https://github.com/disler) (MIT). See the [extension catalog](../../../docs/pi-extensions.md).
6
+
7
+ ## What it does
8
+
9
+ It loads `.pi/damage-control-rules.yaml` (`bashToolPatterns`, `zeroAccessPaths`,
10
+ `readOnlyPaths`, `noDeletePaths`) and checks every tool call against it.
11
+
12
+ On a match, `damage-control-continue` replaces the tool result with **actionable
13
+ feedback** that distinguishes destructive from non-destructive intent and tells
14
+ the agent how to adapt. It does **not** call `ctx.abort()`: the blocked operation
15
+ fails closed, but the turn continues so the agent can report the block or take a
16
+ safe alternative. Protected-path calls may proceed only through the explicit
17
+ approval/exemption paths below; inherently dangerous command patterns never can.
18
+
19
+ ## Version footer and provenance
20
+
21
+ This persistent-UI harness shows `agent fleet v<version>` below the prompt. It shares one common-key
22
+ status with `agent-hub` and `coms`, so a stack renders the version once. Its
23
+ version remains separate from the mutable `damage-control` status: active-rule and
24
+ last-violation feedback never replaces it. The root `package.json` is canonical;
25
+ `bin/sync-harness-versions.js` synchronizes its value into this adjacent manifest. The local
26
+ `version.ts` reader supports copied or symlinked harness directories by resolving that adjacent
27
+ stamp, but those targets still require the pre-existing full `.pi/harnesses/` dependency
28
+ installation.
29
+
30
+ The `agent fleet` half of the label is an OSC 8 terminal hyperlink to the project homepage —
31
+ clickable in terminals that support hyperlinks, ignored (rendered as plain text) elsewhere, and
32
+ free of footer columns because pi strips OSC sequences before measuring width. It opens the
33
+ repository in a browser, not a TUI panel: pi has no mouse tracking, so a click never reaches the
34
+ harness. `AGENT_FLEET_NO_LINKS=1` restores the plain label on multiplexers that mangle OSC 8
35
+ (GNU screen, tmux before 3.4).
36
+
37
+ ## Exemptions — allow access per turn or per session
38
+
39
+ Runtime allowances layered on top of the rules file (which is never modified).
40
+ They apply to the **path categories only** — `zeroAccessPaths`, `readOnlyPaths`,
41
+ `noDeletePaths`. Destructive `bashToolPatterns` (`rm -rf`, `git push --force`,
42
+ `DROP TABLE`, …) can never be exempted.
43
+
44
+ **Pre-authorize** (when you know the agent will need it):
45
+
46
+ ```
47
+ /af-allow .env # exempt for the rest of the session (default)
48
+ /af-allow .env turn # exempt until the end of the current/next turn
49
+ /af-allowed # list active exemptions
50
+ /af-revoke .env # remove an exemption
51
+ ```
52
+
53
+ **Block-time dialog** (when you forgot): in an interactive session a path block
54
+ opens a selector — *Keep blocked / Allow once / Allow for this turn / Allow for
55
+ this session*. An approved call proceeds immediately (the agent never sees the
56
+ block); *Keep blocked* is remembered for the rest of the turn so the agent can't
57
+ re-prompt you; no answer within 60s fails closed.
58
+
59
+ **Escalation from headless children**: when this harness runs inside a subagent
60
+ spawned by agent-hub (no UI, `AGENT_HUB_ASK_ENDPOINT` set), a path block sends an
61
+ `access_request` to the hub's coms socket instead. The dispatcher session shows
62
+ who is asking, for what, and why it was blocked. Ordinary protected reads/writes
63
+ offer *Deny / Allow once / Allow for this agent / Allow for all agents (session)*.
64
+ A protected deletion offers only *Deny / Allow once*, so approving one file does
65
+ not grant its parent directory. The child waits up to 60s and fails closed on
66
+ timeout. At most 3 escalations per child run; denials are cached.
67
+
68
+ **Shared exemptions file**: agent-hub keeps one session-scoped file
69
+ (`~/.pi/coms/exemptions/<session>.json`, deleted on shutdown) and passes it to
70
+ every spawned child via `AGENT_HUB_EXEMPTIONS_FILE`. `/af-allow <pattern> session`
71
+ in the hub lands there, so it covers the whole team. Every native specialist,
72
+ research helper, and nested delegate uses this harness and re-reads the file on
73
+ every block, so mid-session grants reach already-running children. Everything
74
+ (grants, revokes, escalation
75
+ outcomes) is logged to the `damage-control-log` session entries.
76
+
77
+ ## When it's used (this repo)
78
+
79
+ Every `just fleet` Pi mode loads this harness: the default interactive session,
80
+ standalone peers, Hub, and Herdr Pi peers. Agent Hub additionally re-loads it into
81
+ every native **specialist, research helper, and nested delegate**. If the harness cannot be resolved, Agent Hub
82
+ refuses guarded child dispatch rather than launching an unprotected process.
83
+
84
+ ## Commands & tools
85
+
86
+ - `/af-allow <pattern> [turn|session]` — exempt a protected path pattern
87
+ - `/af-allowed` — list active exemptions
88
+ - `/af-revoke <pattern>` — remove an exemption
89
+
90
+ Blocking itself runs passively on the `tool_call` event.
91
+
92
+ ## Package update check
93
+
94
+ On `session_start` this harness also schedules the shared Fleet Core helper
95
+ [`.pi/harnesses/lib/update-check.ts`](../lib/update-check.ts). In an interactive
96
+ session with a `version:` line in `.ai/agent-fleet-setup.md`, it compares that
97
+ record to the npm registry (24h shared cache with the CLI) and, when a newer
98
+ version exists, notifies with the exact `npx @chankov/agent-fleet@latest setup`
99
+ command — plus `--dry-run` and the releases URL. Headless hub children, CI, and
100
+ `AGENT_SKILLS_NO_UPDATE_CHECK` / `NO_UPDATE_NOTIFIER` skip the check. It never
101
+ blocks session start and never writes the install record.
102
+
103
+ ## Requires
104
+
105
+ - `.pi/damage-control-rules.yaml` — the rule set (shipped in this repo)
106
+ - Optional, injected by agent-hub into spawned children: `AGENT_HUB_ASK_ENDPOINT`
107
+ (escalation socket), `AGENT_HUB_EXEMPTIONS_FILE` (shared grants),
108
+ `AGENT_HUB_AGENT_ID` (requester identity). Without them the harness behaves
109
+ standalone: dialog when a UI is present, plain block+feedback otherwise.
110
+
111
+ ## Usage
112
+
113
+ ```bash
114
+ # standalone continue-mode guardrail session
115
+ just fleet
116
+ pi -e .pi/harnesses/damage-control-continue/index.ts
117
+
118
+ # Hub variants
119
+ just fleet hub
120
+ just fleet hub --solo
121
+
122
+ # direct continue-guarded hub launch
123
+ pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/index.ts
124
+ ```
125
+
126
+ ## Upstream changes
127
+
128
+ - Theme integration removed — the `themeMap.ts` import and the `applyExtensionDefaults()`
129
+ call were stripped (this repo does not ship pi themes).
130
+ - The `find` tool's `pattern` is matched against `zeroAccessPaths`, closing a gap
131
+ where `find` could still locate secret files.
132
+ - Exemption layer added (not in upstream): `/af-allow`/`/af-allowed`/`/af-revoke`,
133
+ block-time approval dialog, and escalation from headless agent-hub children to
134
+ the dispatcher — see the Exemptions section above. Shared plumbing lives in
135
+ [`../lib/damage-control-shared.ts`](../lib/damage-control-shared.ts).