@chankov/agent-fleet 2.0.2 → 2.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/harnesses/agent-hub/README.md +26 -31
- package/.pi/harnesses/agent-hub/commands/agents-restart.ts +1 -1
- package/.pi/harnesses/agent-hub/config/overrides.ts +2 -7
- package/.pi/harnesses/agent-hub/index.ts +14 -25
- package/.pi/harnesses/agent-hub/input/completions.ts +2 -2
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +0 -2
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
- package/.pi/harnesses/agent-hub/research/controls.ts +15 -16
- package/.pi/harnesses/agent-hub/research/runtime.ts +30 -39
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +108 -111
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +2 -3
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +3 -3
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +0 -7
- package/.pi/harnesses/agent-hub/ui/grid.ts +21 -183
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +23 -12
- package/.versions/2.0.3/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.3/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.3/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.3/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.3/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.3/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.3/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.3/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.3/.pi/extensions/package.json +9 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/README.md +1158 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context.ts +41 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/config/agents.ts +180 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/index.ts +2036 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research/spawn-run.ts +143 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/types.ts +61 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.3/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.3/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.3/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.3/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.3/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.3/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.3/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.3/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.3/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.3/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.3/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.3/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.3/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.3/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.3/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.3/.version +1 -0
- package/.versions/2.0.3/agents/architect.md +25 -0
- package/.versions/2.0.3/agents/bowser.md +28 -0
- package/.versions/2.0.3/agents/builder.md +56 -0
- package/.versions/2.0.3/agents/code-reviewer.md +210 -0
- package/.versions/2.0.3/agents/deep-researcher.md +33 -0
- package/.versions/2.0.3/agents/documenter.md +22 -0
- package/.versions/2.0.3/agents/orchestrator.md +23 -0
- package/.versions/2.0.3/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.3/agents/planner.md +105 -0
- package/.versions/2.0.3/agents/releaser.md +25 -0
- package/.versions/2.0.3/agents/researcher.md +31 -0
- package/.versions/2.0.3/agents/security-auditor.md +168 -0
- package/.versions/2.0.3/agents/test-engineer.md +154 -0
- package/.versions/2.0.3/agents/web-debugger.md +44 -0
- package/.versions/2.0.3/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.3/bin/catalog/harness-runtime-closure.json +34 -0
- package/.versions/2.0.3/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.3/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.3/docs/agent-fleet-setup.md +473 -0
- package/.versions/2.0.3/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.3/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.3/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.3/docs/getting-started.md +119 -0
- package/.versions/2.0.3/docs/npm-install.md +292 -0
- package/.versions/2.0.3/docs/pi-extensions.md +447 -0
- package/.versions/2.0.3/docs/pi-setup.md +74 -0
- package/.versions/2.0.3/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.3/hermes/README.md +347 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.3/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.3/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.3/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.3/install-manifest.json +2940 -0
- package/.versions/2.0.3/justfile +289 -0
- package/.versions/2.0.3/manifest-meta.json +969 -0
- package/.versions/2.0.3/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.3/references/communication-contract.md +26 -0
- package/.versions/2.0.3/references/definition-of-done.md +67 -0
- package/.versions/2.0.3/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.3/references/observability-checklist.md +91 -0
- package/.versions/2.0.3/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.3/references/performance-checklist.md +153 -0
- package/.versions/2.0.3/references/prompting-patterns.md +380 -0
- package/.versions/2.0.3/references/security-checklist.md +179 -0
- package/.versions/2.0.3/references/testing-patterns.md +236 -0
- package/.versions/2.0.3/references/workflow-authoring.md +304 -0
- package/.versions/2.0.3/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.3/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.3/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.3/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.3/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.3/scripts/fleet.ts +199 -0
- package/.versions/2.0.3/scripts/flow.ts +137 -0
- package/.versions/2.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.3/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.3/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.3/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.3/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.3/scripts/lib/codex-remote-control.ts +482 -0
- package/.versions/2.0.3/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.3/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.3/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.3/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.3/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.3/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.3/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.3/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.3/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.3/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.3/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.3/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.3/scripts/package-lock.json +35 -0
- package/.versions/2.0.3/scripts/package.json +9 -0
- package/.versions/2.0.3/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.3/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.3/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.3/scripts/team-up.ts +406 -0
- package/.versions/2.0.3/scripts/workflows/lib/agent-phase.ts +132 -0
- package/.versions/2.0.3/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.3/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.3/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.3/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.3/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.3/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.3/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.3/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.3/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.3/scripts/workflows/lib/personas.ts +54 -0
- package/.versions/2.0.3/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.3/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.3/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.3/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.3/scripts/workflows/lib/voices.ts +125 -0
- package/.versions/2.0.3/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.3/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.3/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.3/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.3/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.3/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.3/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.3/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.3/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.3/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.3/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.3/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.3/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.3/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.3/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.3/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.3/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.3/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.3/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.3/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.3/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.3/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.3/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.3/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.3/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.3/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.3/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/README.md +2 -2
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/model-visibility.js +64 -0
- package/docs/agent-fleet-setup.md +1 -1
- package/docs/getting-started.md +2 -2
- package/docs/npm-install.md +1 -1
- package/docs/pi-extensions.md +13 -10
- package/install-manifest.json +36 -1
- package/justfile +1 -0
- package/manifest-meta.json +25 -1
- package/package.json +4 -2
- package/scripts/fleet.ts +1 -1
- package/scripts/package-lock.json +35 -0
- package/scripts/package.json +9 -0
- package/.pi/harnesses/agent-hub/research-retention.js +0 -34
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# coms
|
|
2
|
+
|
|
3
|
+
Peer-to-peer messaging between pi agents on the same machine.
|
|
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
|
+
Lets multiple pi agents running on the same machine talk to each other. Each agent listens
|
|
10
|
+
on a single endpoint — a unix socket on POSIX, a named pipe on Windows — and discovers
|
|
11
|
+
peers through per-project registry files under `~/.pi/coms/projects/<project>/agents/`.
|
|
12
|
+
|
|
13
|
+
Surfaces a live "pool" widget of connected peers, with ping and keepalive cycles and a
|
|
14
|
+
clean shutdown lifecycle.
|
|
15
|
+
|
|
16
|
+
## Version footer and provenance
|
|
17
|
+
|
|
18
|
+
This persistent-UI harness shows `agent fleet v<version>` below the prompt. It shares one common-key
|
|
19
|
+
status with `agent-hub` and `damage-control-continue`, so a stack renders the
|
|
20
|
+
version once. The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes
|
|
21
|
+
its value into this adjacent manifest. The local `version.ts` reader is retained so a copied or
|
|
22
|
+
symlinked harness resolves its own adjacent stamp, not the launch directory. That provenance
|
|
23
|
+
pair does not carry dependencies: copy/symlink targets still require the existing full
|
|
24
|
+
`.pi/harnesses/` dependency installation.
|
|
25
|
+
|
|
26
|
+
The `agent fleet` half of the label is an OSC 8 terminal hyperlink to the project homepage —
|
|
27
|
+
clickable in terminals that support hyperlinks, ignored (rendered as plain text) elsewhere, and
|
|
28
|
+
free of footer columns because pi strips OSC sequences before measuring width. It opens the
|
|
29
|
+
repository in a browser, not a TUI panel: pi has no mouse tracking, so a click never reaches the
|
|
30
|
+
harness. `AGENT_FLEET_NO_LINKS=1` restores the plain label on multiplexers that mangle OSC 8
|
|
31
|
+
(GNU screen, tmux before 3.4).
|
|
32
|
+
|
|
33
|
+
## Presence backends: herdr vs files
|
|
34
|
+
|
|
35
|
+
Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
|
|
36
|
+
tools, and pool-scope boundary are identical in both**:
|
|
37
|
+
|
|
38
|
+
- **herdr** — active automatically when the session runs inside a [herdr](https://herdr.dev)
|
|
39
|
+
pane (`HERDR_ENV=1`) and the server answers ping. Presence goes push: this peer reports
|
|
40
|
+
itself via `pane.report_agent` + `pane.report_metadata` (`tokens` = `coms`/`proj`/
|
|
41
|
+
`ctx`/`q` on herdr >= 0.7.4, one latched fallback to the legacy 32-char
|
|
42
|
+
`custom_status` = `<name> <pct>% q<depth>`), and the pool widget populates
|
|
43
|
+
from `agent.list` + `events.subscribe` — **no periodic ping traffic**; peer state
|
|
44
|
+
changes arrive within ~1s and dead panes disappear on `pane.exited`. Turn state
|
|
45
|
+
(idle/working) in the herdr sidebar comes from herdr's own pi integration when
|
|
46
|
+
installed (`herdr integration install`); coms adds the name/context/queue annotation.
|
|
47
|
+
- **files** — everywhere else: the original 10s ping cycle over the peer endpoints,
|
|
48
|
+
byte-for-byte today's behavior.
|
|
49
|
+
|
|
50
|
+
The file registry keeps being written in BOTH backends (it carries the full agent card
|
|
51
|
+
that a pane annotation cannot, and keeps this peer discoverable to peers
|
|
52
|
+
running outside herdr panes). Peers outside herdr panes appear as dimmed "pending" rows
|
|
53
|
+
when you are on the herdr backend.
|
|
54
|
+
|
|
55
|
+
## Commands & tools
|
|
56
|
+
|
|
57
|
+
- `/af-coms` — open the coms control surface; `--project <name>` retargets the pool (use `*` for
|
|
58
|
+
every project) and `--all` toggles private (`--explicit`) peers into view
|
|
59
|
+
- `coms_list` / `coms_send` / `coms_get` / `coms_await` tools — discover peers and
|
|
60
|
+
exchange messages
|
|
61
|
+
|
|
62
|
+
## External conductors
|
|
63
|
+
|
|
64
|
+
Two optional phone-facing conductors use this same pool without becoming pane owners:
|
|
65
|
+
|
|
66
|
+
- **Hermes/Telegram** is the inbound `ask_user` route and can also perform bounded coms delegation.
|
|
67
|
+
- **Codex Remote Control** is an experimental outbound-only Android route. Its user-systemd service loads a managed contract from an external user-state workspace, and `scripts/codex-conductor.ts` permits only scoped `list` plus one serialized `send --await`. See the [operator runbook](https://github.com/chankov/agent-fleet/blob/main/docs/codex-remote-conductor.md).
|
|
68
|
+
|
|
69
|
+
Both must use the same validated project as the peers they target. Neither conductor may drive Herdr lifecycle.
|
|
70
|
+
|
|
71
|
+
Standalone `coms-cli` queues are project-scoped under `~/.pi/coms/cli/projects/<project>/<name>/`. Legacy name-only queues fail closed until an operator assigns and moves the complete queue; `projects` is a reserved identity name.
|
|
72
|
+
|
|
73
|
+
## Pool scope is the reach boundary
|
|
74
|
+
|
|
75
|
+
The pool widget defines who you can reach: `coms_list` and `coms_send` resolve targets through one
|
|
76
|
+
`peersInScope()` helper, so a peer is reachable only if it is in the pool. By default the
|
|
77
|
+
pool is your own project and excludes `--explicit` peers. **Widening is a human-only action** — the
|
|
78
|
+
`coms_list` tool cannot widen scope; only `/af-coms --project` / `/af-coms --all` can. This prevents an
|
|
79
|
+
agent from messaging a cross-project peer that the widget never showed.
|
|
80
|
+
|
|
81
|
+
## Requires
|
|
82
|
+
|
|
83
|
+
Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at runtime.
|
|
84
|
+
|
|
85
|
+
## Usage
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
pi -e .pi/harnesses/coms/index.ts
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
For a guarded coms node, use `just fleet peer <name>`. It loads Fleet Core plus `coms`
|
|
92
|
+
with deterministic extension discovery. Add `--browser` for Chrome DevTools or
|
|
93
|
+
`--all-extensions` when the peer intentionally needs arbitrary project/global extensions;
|
|
94
|
+
those tools stay scoped to that process and never leak into Agent Hub's
|
|
95
|
+
`--no-extensions` specialists.
|
|
96
|
+
|
|
97
|
+
## Upstream changes
|
|
98
|
+
|
|
99
|
+
- Theme integration removed — the `themeMap.ts` import and the `applyExtensionDefaults()`
|
|
100
|
+
call were stripped (this repo does not ship pi themes).
|
|
@@ -0,0 +1,276 @@
|
|
|
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
|
+
|
|
24
|
+
export default function (pi: ExtensionAPI) {
|
|
25
|
+
pi.registerFlag("name", { description: "Override agent name (otherwise from frontmatter or auto-generated)", type: "string", default: undefined });
|
|
26
|
+
pi.registerFlag("purpose", { description: "Override agent purpose (otherwise from frontmatter description)", type: "string", default: undefined });
|
|
27
|
+
pi.registerFlag("project", { description: "Project namespace for peer discovery", type: "string", default: "default" });
|
|
28
|
+
pi.registerFlag("color", { description: "Hex color #RRGGBB (otherwise from frontmatter or palette fallback)", type: "string", default: undefined });
|
|
29
|
+
pi.registerFlag("explicit", { description: "Hide this agent from auto-discovery; only addressable by exact name", type: "boolean", default: false });
|
|
30
|
+
|
|
31
|
+
let currentCtx: ExtensionContext | null = null;
|
|
32
|
+
const peer = createComsPeer({
|
|
33
|
+
pi,
|
|
34
|
+
getContext: () => currentCtx,
|
|
35
|
+
onPeersChanged: () => { if (currentCtx?.hasUI) installPoolWidget(currentCtx); },
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
function renderPool(width: number, theme: Theme): string[] {
|
|
39
|
+
const identity = peer.identity;
|
|
40
|
+
const projectFilter = peer.scope.displayProject ?? identity?.project ?? "default";
|
|
41
|
+
const registryEntries = projectFilter === "*"
|
|
42
|
+
? readAllRegistryEntriesAcrossProjects()
|
|
43
|
+
: readAllRegistryEntries(projectFilter);
|
|
44
|
+
const rows: Array<{
|
|
45
|
+
name: string; model: string; color: string; purpose: string;
|
|
46
|
+
pct: number | null; pending: boolean; stale: boolean;
|
|
47
|
+
}> = [];
|
|
48
|
+
const seenSessions = new Set<string>();
|
|
49
|
+
for (const [sessionId, card] of peer.peerCards) {
|
|
50
|
+
if (identity && sessionId === identity.session_id) continue;
|
|
51
|
+
seenSessions.add(sessionId);
|
|
52
|
+
rows.push({
|
|
53
|
+
name: card.name, model: card.model, color: card.color, purpose: card.purpose,
|
|
54
|
+
pct: card.context_used_pct, pending: false, stale: card.staleCount >= 3,
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
const seenNames = new Set(rows.map(row => row.name));
|
|
58
|
+
for (const entry of registryEntries) {
|
|
59
|
+
if (identity && entry.session_id === identity.session_id) continue;
|
|
60
|
+
if (!peer.scope.includeExplicit && entry.explicit) continue;
|
|
61
|
+
if (seenSessions.has(entry.session_id) || seenNames.has(entry.name)) continue;
|
|
62
|
+
rows.push({
|
|
63
|
+
name: entry.name, model: entry.model, color: entry.color, purpose: entry.purpose,
|
|
64
|
+
pct: null, pending: true, stale: false,
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
const safeWidth = Math.max(0, width);
|
|
69
|
+
let topBorder: string;
|
|
70
|
+
let bottomBorder: string;
|
|
71
|
+
if (safeWidth < 12) {
|
|
72
|
+
topBorder = theme.fg("dim", "━".repeat(safeWidth));
|
|
73
|
+
bottomBorder = theme.fg("dim", "━".repeat(safeWidth));
|
|
74
|
+
} else {
|
|
75
|
+
const left = theme.fg("dim", "┏━") + theme.fg("border", " coms ");
|
|
76
|
+
const nameLength = identity?.name.length ?? 0;
|
|
77
|
+
const rightTagLength = identity ? nameLength + 4 : 0;
|
|
78
|
+
const remaining = safeWidth - 9 - rightTagLength - 1;
|
|
79
|
+
if (identity && remaining >= 1) {
|
|
80
|
+
topBorder = left + theme.fg("dim", "━" + "━".repeat(remaining)) +
|
|
81
|
+
theme.fg("dim", " ") + hexFg(identity.color, identity.name) + theme.fg("dim", " ━┓");
|
|
82
|
+
} else {
|
|
83
|
+
topBorder = left + theme.fg("dim", "━".repeat(Math.max(0, safeWidth - 9)) + "┓");
|
|
84
|
+
}
|
|
85
|
+
bottomBorder = theme.fg("dim", `┗${"━".repeat(safeWidth - 2)}┛`);
|
|
86
|
+
}
|
|
87
|
+
if (rows.length === 0) {
|
|
88
|
+
return [topBorder, truncateToWidth(theme.fg("dim", " ") + theme.fg("muted", "no peers connected"), width), bottomBorder];
|
|
89
|
+
}
|
|
90
|
+
rows.sort((a, b) => a.name.localeCompare(b.name));
|
|
91
|
+
const output = [topBorder];
|
|
92
|
+
for (const row of rows) {
|
|
93
|
+
const percent = row.pct ?? 0;
|
|
94
|
+
const filled = Math.max(0, Math.min(15, Math.round(percent / 100 * 15)));
|
|
95
|
+
const percentLabel = row.pct == null ? "--%" : `${row.pct}%`;
|
|
96
|
+
if (row.stale) {
|
|
97
|
+
output.push(truncateToWidth(` ${theme.fg("dim", `✗ ${row.name.padEnd(12)} ${abbreviateModel(row.model).padEnd(14)} [${"-".repeat(15)}] ${percentLabel.padStart(4)} — ${row.purpose}`)}`, width));
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
const swatch = row.pending ? theme.fg("dim", "●") : hexFg(row.color, "●");
|
|
101
|
+
const barFill = row.pending
|
|
102
|
+
? theme.fg("dim", "-".repeat(15))
|
|
103
|
+
: hexFg(row.color, "#".repeat(filled)) + theme.fg("dim", "-".repeat(15 - filled));
|
|
104
|
+
const line = ` ${swatch} ${theme.fg("accent", row.name.padEnd(12))} ${theme.fg("dim", abbreviateModel(row.model).padEnd(14))} ` +
|
|
105
|
+
theme.fg("warning", "[") + barFill + theme.fg("warning", "]") +
|
|
106
|
+
` ${theme.fg("accent", percentLabel.padStart(4))}${theme.fg("dim", " — ")}${theme.fg("muted", row.purpose)}`;
|
|
107
|
+
output.push(truncateToWidth(line, width));
|
|
108
|
+
}
|
|
109
|
+
output.push(bottomBorder);
|
|
110
|
+
return output;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
function installPoolWidget(ctx: ExtensionContext): void {
|
|
114
|
+
if (!ctx.hasUI) return;
|
|
115
|
+
try {
|
|
116
|
+
ctx.ui.setWidget("coms-pool", (_tui, theme) => ({ invalidate() {}, render: (width: number) => renderPool(width, theme) }), { placement: "belowEditor" });
|
|
117
|
+
} catch { /* non-fatal */ }
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
pi.registerTool({
|
|
121
|
+
name: "coms_list",
|
|
122
|
+
label: "Coms List",
|
|
123
|
+
description:
|
|
124
|
+
"List the peer agents in your current coms pool — the ones shown in the pool widget. Returns " +
|
|
125
|
+
"names, models, live context-window usage, the herdr pane_id, and status (idle | working | " +
|
|
126
|
+
"booting). CHECK STATUS BEFORE SENDING: `working` means the peer is mid-turn and your send " +
|
|
127
|
+
"will wait for it; `booting` means it registered but is not addressable yet. Use this instead " +
|
|
128
|
+
"of reading the peer's pane to guess whether it is busy. Discovery is scoped to what the human " +
|
|
129
|
+
"displays via /af-coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
|
|
130
|
+
parameters: Type.Object({
|
|
131
|
+
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." })),
|
|
132
|
+
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." })),
|
|
133
|
+
}),
|
|
134
|
+
async execute(_callId, params) {
|
|
135
|
+
if (!peer.identity) return { content: [{ type: "text" as const, text: "coms not initialised." }], details: { agents: [], project: null } };
|
|
136
|
+
const result = await peer.list(params);
|
|
137
|
+
const notice = result.widenRequested
|
|
138
|
+
? `\n\n(Discovery is scoped to "${result.project}"${peer.scope.includeExplicit ? "" : ", explicit peers hidden"}. ` +
|
|
139
|
+
`Widening to other projects or revealing --explicit peers is a human action via ` +
|
|
140
|
+
`/af-coms --project <name> or /af-coms --all.)`
|
|
141
|
+
: "";
|
|
142
|
+
const lines = result.agents.length === 0
|
|
143
|
+
? "No peer agents in your pool."
|
|
144
|
+
: result.agents.map(agent => {
|
|
145
|
+
const context = agent.context_used_pct != null ? ` ${agent.context_used_pct}%` : " ?%";
|
|
146
|
+
const state = ` [${agent.alive ? (agent.status ?? "unknown") : "unreachable"}${agent.pane_id ? ` pane ${agent.pane_id}` : ""}]`;
|
|
147
|
+
return `${agent.alive ? "●" : "✗"} ${agent.name} (${agent.model})${context}${state}${agent.purpose ? ` — ${agent.purpose}` : ""}`;
|
|
148
|
+
}).join("\n");
|
|
149
|
+
return { content: [{ type: "text" as const, text: `${result.agents.length} peer(s) in pool (project ${result.project}):\n${lines}${notice}` }], details: result };
|
|
150
|
+
},
|
|
151
|
+
renderCall(args, theme) {
|
|
152
|
+
const project = (args as any).project;
|
|
153
|
+
return new Text(theme.fg("toolTitle", theme.bold("coms_list")) + theme.fg("dim", project ? ` ${project}` : ""), 0, 0);
|
|
154
|
+
},
|
|
155
|
+
renderResult(result, options, theme) {
|
|
156
|
+
const agents: any[] = (result.details as any)?.agents ?? [];
|
|
157
|
+
const header = theme.fg("accent", `📡 ${agents.length} peer(s)`);
|
|
158
|
+
if (!options.expanded || agents.length === 0) return new Text(header, 0, 0);
|
|
159
|
+
const rows = agents.map(agent => {
|
|
160
|
+
const dot = agent.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
|
|
161
|
+
const percent = agent.context_used_pct != null ? `${agent.context_used_pct}%` : "?%";
|
|
162
|
+
const state = agent.alive ? (agent.status ?? "unknown") : "unreachable";
|
|
163
|
+
const stateColor = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
|
|
164
|
+
return `${dot} ${theme.fg("accent", agent.name)} ${theme.fg("dim", agent.model)} ${theme.fg("warning", percent)} ` +
|
|
165
|
+
`${theme.fg(stateColor as any, state)}${agent.pane_id ? theme.fg("dim", ` ${agent.pane_id}`) : ""}`;
|
|
166
|
+
}).join("\n");
|
|
167
|
+
return new Text(header + "\n" + rows, 0, 0);
|
|
168
|
+
},
|
|
169
|
+
});
|
|
170
|
+
|
|
171
|
+
pi.registerTool({
|
|
172
|
+
name: "coms_send",
|
|
173
|
+
label: "Coms Send",
|
|
174
|
+
description:
|
|
175
|
+
"Send a prompt to a peer agent. Returns synchronously with a msg_id once the receiver acks. " +
|
|
176
|
+
"Use coms_get (non-blocking) or coms_await (blocking) with the msg_id to retrieve the response. " +
|
|
177
|
+
"Throws if the receiver is unreachable or rejects the envelope.",
|
|
178
|
+
parameters: Type.Object({
|
|
179
|
+
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." }),
|
|
180
|
+
prompt: Type.String({ description: "The prompt to send." }),
|
|
181
|
+
conversation_id: Type.Optional(Type.String()),
|
|
182
|
+
response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
|
|
183
|
+
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." })),
|
|
184
|
+
}),
|
|
185
|
+
async execute(_callId, params) {
|
|
186
|
+
const sent = await peer.send(params);
|
|
187
|
+
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 } };
|
|
188
|
+
},
|
|
189
|
+
renderCall(args, theme) {
|
|
190
|
+
const target = (args as any).target ?? "?";
|
|
191
|
+
const prompt = (args as any).prompt ?? "";
|
|
192
|
+
const preview = prompt.length > 60 ? prompt.slice(0, 57) + "..." : prompt;
|
|
193
|
+
return new Text(theme.fg("toolTitle", theme.bold("coms_send ")) + theme.fg("accent", target) +
|
|
194
|
+
theme.fg("dim", " — ") + theme.fg("muted", preview), 0, 0);
|
|
195
|
+
},
|
|
196
|
+
renderResult(result, _options, theme) {
|
|
197
|
+
const details = result.details as any;
|
|
198
|
+
if (!details) {
|
|
199
|
+
const content = result.content[0];
|
|
200
|
+
return new Text(content?.type === "text" ? content.text : "", 0, 0);
|
|
201
|
+
}
|
|
202
|
+
return new Text(theme.fg("success", "→ ") + theme.fg("accent", details.target) +
|
|
203
|
+
theme.fg("dim", " msg_id ") + theme.fg("warning", details.msg_id), 0, 0);
|
|
204
|
+
},
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
pi.registerTool({
|
|
208
|
+
name: "coms_get",
|
|
209
|
+
label: "Coms Get",
|
|
210
|
+
description: "Non-blocking poll of a pending coms_send reply. Returns status pending|complete|error and (when complete) the response.",
|
|
211
|
+
parameters: Type.Object({ msg_id: Type.String({ description: "msg_id returned by coms_send." }) }),
|
|
212
|
+
async execute(_callId, params) {
|
|
213
|
+
const result = peer.get(params.msg_id);
|
|
214
|
+
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)}`;
|
|
215
|
+
return { content: [{ type: "text" as const, text }], details: result };
|
|
216
|
+
},
|
|
217
|
+
renderCall(args, theme) { return new Text(theme.fg("toolTitle", theme.bold("coms_get ")) + theme.fg("warning", (args as any).msg_id ?? "?"), 0, 0); },
|
|
218
|
+
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); },
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
pi.registerTool({
|
|
222
|
+
name: "coms_await",
|
|
223
|
+
label: "Coms Await",
|
|
224
|
+
description: "Block until a pending coms_send reply lands or the timeout fires. Default timeout 30 minutes (PI_COMS_TIMEOUT_MS).",
|
|
225
|
+
parameters: Type.Object({
|
|
226
|
+
msg_id: Type.String({ description: "msg_id returned by coms_send." }),
|
|
227
|
+
timeout_ms: Type.Optional(Type.Number({ description: "Override the default timeout (ms)." })),
|
|
228
|
+
}),
|
|
229
|
+
async execute(_callId, params) {
|
|
230
|
+
const result = await peer.await(params.msg_id, typeof params.timeout_ms === "number" && params.timeout_ms > 0 ? params.timeout_ms : TIMEOUT_MS);
|
|
231
|
+
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" } };
|
|
232
|
+
if (result.status === "error") {
|
|
233
|
+
const unknown = result.error === "unknown msg_id";
|
|
234
|
+
return {
|
|
235
|
+
content: [{ type: "text" as const, text: unknown ? `coms_await: unknown msg_id ${params.msg_id}` : `coms_await: error — ${result.error}` }],
|
|
236
|
+
details: unknown ? { error: "unknown msg_id" } : { status: "error", error: result.error },
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
return {
|
|
240
|
+
content: [{ type: "text" as const, text: typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2) }],
|
|
241
|
+
details: { response: result.response },
|
|
242
|
+
};
|
|
243
|
+
},
|
|
244
|
+
renderCall(args, theme) { return new Text(theme.fg("toolTitle", theme.bold("coms_await ")) + theme.fg("warning", (args as any).msg_id ?? "?"), 0, 0); },
|
|
245
|
+
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); },
|
|
246
|
+
});
|
|
247
|
+
|
|
248
|
+
pi.registerCommand("af-coms", {
|
|
249
|
+
description: "Force-refresh the coms pool widget (or filter with --all / --project <name>)",
|
|
250
|
+
handler: async (args, ctx) => { await peer.updateScope((args ?? "").trim(), ctx); },
|
|
251
|
+
});
|
|
252
|
+
|
|
253
|
+
pi.on("session_start", async (_event, ctx) => {
|
|
254
|
+
registerVersionStatus(ctx);
|
|
255
|
+
currentCtx = ctx;
|
|
256
|
+
let identity: ComsIdentity;
|
|
257
|
+
try {
|
|
258
|
+
identity = await peer.connect({ ctx, defaultNamePrefix: "agent", defaultPurpose: "" });
|
|
259
|
+
} catch (error) {
|
|
260
|
+
if (!(error instanceof ComsConnectError)) throw error;
|
|
261
|
+
const label = error.stage === "dirs" ? "failed to create dirs" : error.stage === "registry" ? "registry write failed" : "bind failed";
|
|
262
|
+
ctx.ui?.notify?.(`📡 coms: ${label} — ${error instanceof Error ? error.message : String(error)}`, "error");
|
|
263
|
+
return;
|
|
264
|
+
}
|
|
265
|
+
try {
|
|
266
|
+
ctx.ui.setStatus("coms", `📡 ${identity.name}@${identity.project}`);
|
|
267
|
+
installPoolWidget(ctx);
|
|
268
|
+
ctx.ui.notify(`📡 coms ready · ${identity.name}@${identity.project} · ${peer.scope.displayProject ?? identity.project} pool`, "info");
|
|
269
|
+
} catch { /* UI is optional */ }
|
|
270
|
+
});
|
|
271
|
+
pi.on("before_agent_start", async () => { await peer.setTurnState("working"); });
|
|
272
|
+
pi.on("agent_end", async (_event, ctx) => { await peer.setTurnState("idle"); await peer.respond(ctx); });
|
|
273
|
+
pi.on("session_shutdown", async () => { await peer.shutdown(); if (currentCtx?.hasUI) currentCtx.ui.setWidget("coms-pool", undefined); });
|
|
274
|
+
process.on("SIGINT", () => { void peer.shutdown(); });
|
|
275
|
+
process.on("SIGTERM", () => { void peer.shutdown(); });
|
|
276
|
+
}
|
|
@@ -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,124 @@
|
|
|
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
|
+
## Requires
|
|
93
|
+
|
|
94
|
+
- `.pi/damage-control-rules.yaml` — the rule set (shipped in this repo)
|
|
95
|
+
- Optional, injected by agent-hub into spawned children: `AGENT_HUB_ASK_ENDPOINT`
|
|
96
|
+
(escalation socket), `AGENT_HUB_EXEMPTIONS_FILE` (shared grants),
|
|
97
|
+
`AGENT_HUB_AGENT_ID` (requester identity). Without them the harness behaves
|
|
98
|
+
standalone: dialog when a UI is present, plain block+feedback otherwise.
|
|
99
|
+
|
|
100
|
+
## Usage
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
# standalone continue-mode guardrail session
|
|
104
|
+
just fleet
|
|
105
|
+
pi -e .pi/harnesses/damage-control-continue/index.ts
|
|
106
|
+
|
|
107
|
+
# Hub variants
|
|
108
|
+
just fleet hub
|
|
109
|
+
just fleet hub --solo
|
|
110
|
+
|
|
111
|
+
# direct continue-guarded hub launch
|
|
112
|
+
pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/index.ts
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Upstream changes
|
|
116
|
+
|
|
117
|
+
- Theme integration removed — the `themeMap.ts` import and the `applyExtensionDefaults()`
|
|
118
|
+
call were stripped (this repo does not ship pi themes).
|
|
119
|
+
- The `find` tool's `pattern` is matched against `zeroAccessPaths`, closing a gap
|
|
120
|
+
where `find` could still locate secret files.
|
|
121
|
+
- Exemption layer added (not in upstream): `/af-allow`/`/af-allowed`/`/af-revoke`,
|
|
122
|
+
block-time approval dialog, and escalation from headless agent-hub children to
|
|
123
|
+
the dispatcher — see the Exemptions section above. Shared plumbing lives in
|
|
124
|
+
[`../lib/damage-control-shared.ts`](../lib/damage-control-shared.ts).
|