@chankov/agent-fleet 2.0.5 → 2.0.6
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 +74 -10
- package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.pi/harnesses/agent-hub/artifacts.js +1 -1
- package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
- package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
- package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
- package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
- package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
- package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
- package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +22 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +25 -11
- package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
- package/.pi/harnesses/agent-hub/index.ts +79 -43
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
- package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
- package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
- package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
- package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
- package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
- package/.pi/harnesses/agent-hub/research/runtime.ts +17 -2
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +14 -6
- package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
- package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +65 -24
- package/.pi/harnesses/agent-hub/types.ts +1 -0
- package/.pi/harnesses/agent-hub/ui/pool.ts +6 -1
- package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
- package/.pi/harnesses/ask-user-remote/README.md +8 -2
- package/.pi/harnesses/ask-user-remote/index.ts +40 -14
- package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
- package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.pi/harnesses/coms/README.md +1 -1
- package/.pi/harnesses/coms/index.ts +7 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
- package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
- package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.6/.pi/extensions/package.json +9 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.6/.version +1 -0
- package/.versions/2.0.6/agents/architect.md +25 -0
- package/.versions/2.0.6/agents/bowser.md +28 -0
- package/.versions/2.0.6/agents/builder.md +56 -0
- package/.versions/2.0.6/agents/code-reviewer.md +210 -0
- package/.versions/2.0.6/agents/deep-researcher.md +33 -0
- package/.versions/2.0.6/agents/documenter.md +23 -0
- package/.versions/2.0.6/agents/orchestrator.md +23 -0
- package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.6/agents/planner.md +106 -0
- package/.versions/2.0.6/agents/releaser.md +25 -0
- package/.versions/2.0.6/agents/researcher.md +31 -0
- package/.versions/2.0.6/agents/security-auditor.md +168 -0
- package/.versions/2.0.6/agents/test-engineer.md +154 -0
- package/.versions/2.0.6/agents/web-debugger.md +44 -0
- package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
- package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
- package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
- package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.6/docs/getting-started.md +126 -0
- package/.versions/2.0.6/docs/npm-install.md +301 -0
- package/.versions/2.0.6/docs/pi-extensions.md +446 -0
- package/.versions/2.0.6/docs/pi-setup.md +76 -0
- package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.6/hermes/README.md +347 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.6/install-manifest.json +2924 -0
- package/.versions/2.0.6/justfile +247 -0
- package/.versions/2.0.6/manifest-meta.json +976 -0
- package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.6/references/communication-contract.md +26 -0
- package/.versions/2.0.6/references/definition-of-done.md +67 -0
- package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.6/references/observability-checklist.md +91 -0
- package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.6/references/performance-checklist.md +153 -0
- package/.versions/2.0.6/references/prompting-patterns.md +380 -0
- package/.versions/2.0.6/references/security-checklist.md +179 -0
- package/.versions/2.0.6/references/testing-patterns.md +236 -0
- package/.versions/2.0.6/references/workflow-authoring.md +304 -0
- package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
- package/.versions/2.0.6/scripts/fleet.ts +216 -0
- package/.versions/2.0.6/scripts/flow.ts +137 -0
- package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.6/scripts/package-lock.json +35 -0
- package/.versions/2.0.6/scripts/package.json +9 -0
- package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
- package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.6/scripts/team-up.ts +378 -0
- package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +23 -0
- package/README.md +12 -14
- package/bin/catalog/harness-runtime-closure.json +1 -6
- package/bin/lib/desired.js +2 -2
- package/bin/lib/features.js +8 -1
- package/bin/snapshot-version.js +1 -2
- package/codex/fleet-session-client/SKILL.md +34 -0
- package/codex/fleet-session-client.zip +0 -0
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/MIGRATION-agent-fleet.md +2 -2
- package/docs/assets/branding/README.md +33 -0
- package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
- package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
- package/docs/codex-session-bridge.md +219 -0
- package/docs/coms-hermes-bridge.md +4 -5
- package/docs/getting-started.md +2 -0
- package/docs/npm-install.md +3 -1
- package/docs/pi-setup.md +2 -0
- package/hermes/README.md +1 -1
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
- package/install-manifest.json +54 -72
- package/justfile +0 -42
- package/manifest-meta.json +50 -43
- package/package.json +10 -7
- package/scripts/coms-cli.ts +2 -61
- package/scripts/fleet-codex-client.ts +69 -0
- package/scripts/fleet-codex-read.py +146 -0
- package/scripts/fleet.ts +0 -6
- package/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/scripts/lib/fleet-codex-operations.ts +190 -0
- package/scripts/lib/fleet-codex-session.ts +166 -0
- package/scripts/lib/fleet-codex-transport.ts +124 -0
- package/scripts/lib/fleet-command.ts +5 -23
- package/scripts/lib/team-project.ts +15 -50
- package/scripts/team-up.ts +6 -34
- package/codex/CONDUCTOR.md +0 -148
- package/docs/codex-remote-conductor.md +0 -170
- package/scripts/codex-conductor.ts +0 -41
- package/scripts/codex-remote-control.ts +0 -167
- package/scripts/lib/codex-conductor.ts +0 -88
- package/scripts/lib/codex-remote-control.ts +0 -482
- package/systemd/user/agent-fleet-codex-remote-control.service.in +0 -23
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
// Unified `just fleet` command dispatcher. Parsing is kept pure and tested in
|
|
2
|
+
// scripts/lib/fleet-command.test.ts; this entrypoint only hands the resolved
|
|
3
|
+
// recipe back to Just so existing compatibility recipes remain one source of truth.
|
|
4
|
+
|
|
5
|
+
import { spawnSync } from "node:child_process";
|
|
6
|
+
import { parseFleetCommand } from "./lib/fleet-command.ts";
|
|
7
|
+
import { resolveMonitorEnv } from "./lib/monitor-env.ts";
|
|
8
|
+
import { assertRuntimeDependencies } from "./lib/runtime-dependencies.js";
|
|
9
|
+
|
|
10
|
+
const PI_LAUNCH_RECIPES = new Set([
|
|
11
|
+
"_fleet-core",
|
|
12
|
+
"_fleet-hub",
|
|
13
|
+
"_fleet-hub-team",
|
|
14
|
+
"_fleet-team-up",
|
|
15
|
+
"_fleet-conductor",
|
|
16
|
+
"_fleet-team-resume",
|
|
17
|
+
]);
|
|
18
|
+
|
|
19
|
+
const HELP = `Agent Fleet — one guarded Hub runtime, two work modes, independent topology
|
|
20
|
+
|
|
21
|
+
SET UP A NEW REPOSITORY
|
|
22
|
+
npx @chankov/agent-fleet@latest setup
|
|
23
|
+
Run this from the target repository. A repository without Agent Fleet has
|
|
24
|
+
no justfile yet — setup writes it — so the first install cannot use just.
|
|
25
|
+
Select Default/Full and optional features, inspect the exact plan, then
|
|
26
|
+
confirm once to apply it. Follow with just fleet deps, then just fleet doctor.
|
|
27
|
+
Source checkout development: node bin/cli.js setup.
|
|
28
|
+
Once installed, just fleet setup wraps the same command for this repository.
|
|
29
|
+
|
|
30
|
+
QUICK START
|
|
31
|
+
just fleet # Hub/operator, empty native roster
|
|
32
|
+
just fleet --agents frontend # Hub/orchestrator with native specialists
|
|
33
|
+
just fleet --herdr --project af
|
|
34
|
+
# Hub/operator in a one-pane Herdr workspace
|
|
35
|
+
just fleet --agents frontend --peers frontend --project af
|
|
36
|
+
# matching native roster + standing peers
|
|
37
|
+
|
|
38
|
+
DETERMINISTIC FLOWS
|
|
39
|
+
just flow quality
|
|
40
|
+
just flow scout "where is authentication configured?"
|
|
41
|
+
just flow build-test "add the validated endpoint"
|
|
42
|
+
Run code-owned headless phase graphs on isolated flow/<name>-<runId> branches.
|
|
43
|
+
|
|
44
|
+
just flow cleanup # list flow branches and prompt for a number
|
|
45
|
+
just flow cleanup 2 # safely remove empty/integrated selection 2
|
|
46
|
+
just flow merge # list flow branches and prompt for a number
|
|
47
|
+
just flow merge 2 # squash-merge accepted selection 2, then remove it
|
|
48
|
+
Cleanup and merge require Worktrunk. Dirty worktrees are refused; merge
|
|
49
|
+
targets the source branch recorded when the run started. See
|
|
50
|
+
.pi/agent-fleet/docs/workflows.md.
|
|
51
|
+
|
|
52
|
+
FLEET CORE — loaded in every Pi mode
|
|
53
|
+
Damage Control Continue · local/remote ask_user · Compact & Continue
|
|
54
|
+
BTW side sessions · update checker (voice is opt-in with --voice)
|
|
55
|
+
|
|
56
|
+
UNIFIED HUB
|
|
57
|
+
just fleet [--work-mode operator|orchestrator] [--agents <roster>]
|
|
58
|
+
[--herdr] [--peers <preset>] [--no-coms] [PI_ARGS...]
|
|
59
|
+
Bare Fleet always loads Agent Hub in operator work mode. Operator keeps
|
|
60
|
+
read/bash/edit/write plus orchestration; the initial native roster is empty.
|
|
61
|
+
--agents selects .pi/agents/teams.yaml and implies orchestrator unless an
|
|
62
|
+
explicit --work-mode operator is supplied. --no-coms leaves direct/native work
|
|
63
|
+
available while coms, peer dispatch, and handoff refuse actionably.
|
|
64
|
+
|
|
65
|
+
WORK MODE AND ROSTER
|
|
66
|
+
/af-work-mode # report work mode and capability state
|
|
67
|
+
/af-agents-add code-reviewer # add a native Pi specialist at runtime
|
|
68
|
+
/af-work-mode orchestrator # remove direct coding tools; keep orchestration
|
|
69
|
+
/af-work-mode operator # restore the approved direct tool surface
|
|
70
|
+
|
|
71
|
+
Work mode is independent from the native roster and peer topology. Budgets follow task tier.
|
|
72
|
+
All Hub slash commands, including /af-handoff, stay registered in both work modes;
|
|
73
|
+
actions whose coms/Herdr capability is unavailable return remediation guidance.
|
|
74
|
+
|
|
75
|
+
Explicit dispatch backend examples (inside the Hub):
|
|
76
|
+
dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "native" })
|
|
77
|
+
dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "coms" })
|
|
78
|
+
backend "auto" follows .pi/agents/dispatch-policy.yaml; native always starts
|
|
79
|
+
the local Pi specialist, while coms requires a live same-name peer and never
|
|
80
|
+
falls back to native.
|
|
81
|
+
|
|
82
|
+
HERDR TOPOLOGY — requires a running Herdr server (https://herdr.dev)
|
|
83
|
+
just fleet --herdr [--project <name>]
|
|
84
|
+
Hub-only workspace using the empty base peer preset.
|
|
85
|
+
|
|
86
|
+
just fleet --peers <preset> [--agents <roster>] [--project <name>]
|
|
87
|
+
Add standing Pi/Claude peers from .pi/agents/peers.yaml. Hub and every peer
|
|
88
|
+
receive the same project. Add --dry-run to print the redacted layout only.
|
|
89
|
+
|
|
90
|
+
Dynamic Claude reviewer from a Hub already running inside Herdr:
|
|
91
|
+
herdr_spawn_peer({ name: "code-reviewer" })
|
|
92
|
+
coms_send({ target: "code-reviewer", prompt: "Review the current diff" })
|
|
93
|
+
coms_await({ msg_id: "<returned-id>" })
|
|
94
|
+
/af-handoff code-reviewer
|
|
95
|
+
The declared runner may be Claude Code. Spawn requires Herdr; messaging and
|
|
96
|
+
handoff require coms readiness and a target visible in this Hub's project pool.
|
|
97
|
+
Every spawned peer gets a sibling pane and is locked to the Hub's project.
|
|
98
|
+
|
|
99
|
+
ONE STANDALONE PEER
|
|
100
|
+
just fleet peer <name> [--runner pi|claude-code] [--persona <p>|--no-persona]
|
|
101
|
+
[--model <m>] [--project <p>] [--extensions a,b]
|
|
102
|
+
[--browser] [--all-extensions] [--direction right|down]
|
|
103
|
+
[--here] [--dry-run] [-- PI_ARGS...]
|
|
104
|
+
A single addressable peer. Inside Herdr it splits the current pane; outside
|
|
105
|
+
it creates a one-pane workspace; --here uses this terminal. A peers.yaml
|
|
106
|
+
declaration controls runner/model/extensions/env_file. A matching persona
|
|
107
|
+
starts guarded Pi; --runner claude-code starts Claude Code plus its bridge.
|
|
108
|
+
|
|
109
|
+
TEAM LIFECYCLE
|
|
110
|
+
just fleet snapshot <preset> [--project <name>]
|
|
111
|
+
just fleet down <preset> [--project <name>]
|
|
112
|
+
just fleet resume <preset> [--project <name>]
|
|
113
|
+
Save session refs, close cleanly, and rebuild available Pi/Claude sessions.
|
|
114
|
+
|
|
115
|
+
HERMES CONDUCTOR
|
|
116
|
+
just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
|
|
117
|
+
Start Hermes with a peer team, or preview the layout with --dry-run.
|
|
118
|
+
|
|
119
|
+
CAPABILITY FLAGS
|
|
120
|
+
--browser Add Chrome DevTools MCP tools to the Hub/main Pi process.
|
|
121
|
+
--voice Load pi-voice-stt after selecting the voice setup feature.
|
|
122
|
+
--all-extensions Also auto-load project/global extensions outside Fleet Core.
|
|
123
|
+
--no-coms Disable only the Hub's embedded coms layer.
|
|
124
|
+
|
|
125
|
+
COMPATIBILITY ALIASES — accepted with migration warnings
|
|
126
|
+
just fleet hub [--solo] ... -> just fleet [--no-coms] ...
|
|
127
|
+
just fleet team <preset> ... -> just fleet --agents <roster> --peers <preset> ...
|
|
128
|
+
just fleet team <preset> --no-hub -> legacy peers-only topology
|
|
129
|
+
Legacy peer-only presets full/web/docs retain the default native roster.
|
|
130
|
+
|
|
131
|
+
LIFECYCLE
|
|
132
|
+
just fleet setup [--dry-run] [--preset default|full --features none --yes]
|
|
133
|
+
Reconcile desired state with the newest published package. Preset and
|
|
134
|
+
features are remembered in .ai/agent-fleet.json, so a plain setup needs no
|
|
135
|
+
flags; flags apply to one run unless --save-desired persists them.
|
|
136
|
+
just fleet deps
|
|
137
|
+
Install Node dependencies for .pi/extensions, .pi/harnesses, and scripts.
|
|
138
|
+
Does not launch Pi, configure STT, install ffmpeg/Herdr, or pair Codex.
|
|
139
|
+
just fleet doctor [--fix]
|
|
140
|
+
just fleet uninstall --all --yes
|
|
141
|
+
Reinstall after self-uninstall with npx @chankov/agent-fleet@latest setup.
|
|
142
|
+
|
|
143
|
+
UPDATE NOTE
|
|
144
|
+
Update with: just fleet setup --dry-run, then just fleet setup, then deps+doctor.
|
|
145
|
+
setup reconciles TOWARD the package: an artifact you edited in place is
|
|
146
|
+
refreshed and your edit overwritten. --dry-run shows that before it happens;
|
|
147
|
+
.ai/agent-fleet-overrides.md is the customization no lifecycle command touches.
|
|
148
|
+
If you and the new version changed the same file, setup exits 3 having written
|
|
149
|
+
nothing — re-run with --on-conflict theirs or --on-conflict ours.
|
|
150
|
+
pi update --extensions updates pi extensions only; it does not update this npm
|
|
151
|
+
installer. just fleet install was removed; use setup or deps.
|
|
152
|
+
|
|
153
|
+
HELP
|
|
154
|
+
just Show this complete command guide.
|
|
155
|
+
just fleet help Show this complete command guide.
|
|
156
|
+
just --list Show the intentionally small public recipe surface.
|
|
157
|
+
|
|
158
|
+
Configuration:
|
|
159
|
+
Native rosters: .pi/agents/teams.yaml
|
|
160
|
+
Peer presets: .pi/agents/peers.yaml
|
|
161
|
+
Routing: .pi/agents/dispatch-policy.yaml
|
|
162
|
+
Overrides: .ai/agent-fleet-overrides.md
|
|
163
|
+
Safety: .pi/damage-control-rules.yaml
|
|
164
|
+
Full docs: docs/pi-extensions.md and docs/pi-setup.md
|
|
165
|
+
`;
|
|
166
|
+
|
|
167
|
+
function main(): void {
|
|
168
|
+
const argv = process.argv.slice(2);
|
|
169
|
+
if (argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
|
|
170
|
+
process.stdout.write(HELP);
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
173
|
+
let invocation;
|
|
174
|
+
try {
|
|
175
|
+
invocation = parseFleetCommand(argv);
|
|
176
|
+
} catch (err) {
|
|
177
|
+
console.error(`fleet: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
178
|
+
process.stderr.write(HELP);
|
|
179
|
+
process.exitCode = 2;
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
for (const warning of invocation.warnings ?? []) {
|
|
183
|
+
console.error(`fleet: warning: ${warning}`);
|
|
184
|
+
}
|
|
185
|
+
// Refuse before Just/Pi starts. Without this guard a top-level extension
|
|
186
|
+
// import can fail before agent-hub registers flags such as --project, making
|
|
187
|
+
// a missing npm tree look like an unrelated "Unknown option" parser error.
|
|
188
|
+
if (PI_LAUNCH_RECIPES.has(invocation.recipe)) {
|
|
189
|
+
try {
|
|
190
|
+
assertRuntimeDependencies(process.cwd());
|
|
191
|
+
} catch (error) {
|
|
192
|
+
console.error(`fleet: ${error instanceof Error ? error.message : String(error)}`);
|
|
193
|
+
process.exitCode = 1;
|
|
194
|
+
return;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
// Every mode gets the monitor variables, not just `hub`: a plain `just fleet`
|
|
198
|
+
// or a `peer` loads no agent-hub and so reads them never, while `hub` and
|
|
199
|
+
// `team` both reach the hub through a Just recipe that inherits this
|
|
200
|
+
// environment. Deciding here rather than per recipe keeps it one line of
|
|
201
|
+
// truth; a null answer (opted out, or no directory we can make private)
|
|
202
|
+
// leaves the environment untouched and the hub unmonitored, exactly as
|
|
203
|
+
// before this existed.
|
|
204
|
+
const result = spawnSync("just", [invocation.recipe, ...invocation.args], {
|
|
205
|
+
stdio: "inherit",
|
|
206
|
+
env: { ...process.env, ...(resolveMonitorEnv() ?? {}) },
|
|
207
|
+
});
|
|
208
|
+
if (result.error) {
|
|
209
|
+
console.error(`fleet: could not run just: ${result.error.message}`);
|
|
210
|
+
process.exitCode = 1;
|
|
211
|
+
return;
|
|
212
|
+
}
|
|
213
|
+
process.exitCode = result.status ?? 1;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
main();
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { existsSync } from "node:fs";
|
|
3
|
+
import { dirname, resolve } from "node:path";
|
|
4
|
+
import { fileURLToPath, pathToFileURL } from "node:url";
|
|
5
|
+
import { makeRunId } from "../.pi/harnesses/agent-hub/run-namespace.js";
|
|
6
|
+
import { parseFlowCommand, parseFlowMaintenanceCommand, type FlowCommand } from "./lib/flow-command.ts";
|
|
7
|
+
import { runFlowMaintenance } from "./lib/flow-maintenance.ts";
|
|
8
|
+
import { loadEnv } from "./workflows/lib/env.ts";
|
|
9
|
+
import { createFlowBranch, recordFlowResult, requireCleanTree, StartRefusedError } from "./workflows/lib/git.ts";
|
|
10
|
+
import { snapshot } from "./workflows/lib/permissions.ts";
|
|
11
|
+
import { Run, type FinishResult } from "./workflows/lib/run.ts";
|
|
12
|
+
import { buildTestWorkflow, buildTestWorkflowPreflight } from "./workflows/wf-build-test.ts";
|
|
13
|
+
import { documentWorkflow, documentWorkflowPreflight } from "./workflows/wf-document.ts";
|
|
14
|
+
import { qualityWorkflow, qualityWorkflowPreflight } from "./workflows/wf-quality.ts";
|
|
15
|
+
import { scoutWorkflow, scoutWorkflowPreflight } from "./workflows/wf-scout.ts";
|
|
16
|
+
import { pollWorkflow, pollWorkflowPreflight, pollWorkflowValidate } from "./workflows/wf-poll.ts";
|
|
17
|
+
import { debateWorkflow, debateWorkflowPreflight, debateWorkflowValidate } from "./workflows/wf-debate.ts";
|
|
18
|
+
|
|
19
|
+
export type Workflow = (run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }) => Promise<FinishResult>;
|
|
20
|
+
export interface WorkflowDefinition {
|
|
21
|
+
run: Workflow;
|
|
22
|
+
validate?: (command: FlowCommand, cwd: string) => void;
|
|
23
|
+
preflight?: (cwd: string, command: FlowCommand) => void;
|
|
24
|
+
}
|
|
25
|
+
export const workflows: Record<string, WorkflowDefinition> = {
|
|
26
|
+
"build-test": {
|
|
27
|
+
run: buildTestWorkflow,
|
|
28
|
+
validate: command => { if (!command.args.join(" ").trim()) throw Object.assign(new Error("build-test flow requires an implementation request"), { exitCode: 2 }); },
|
|
29
|
+
preflight: buildTestWorkflowPreflight,
|
|
30
|
+
},
|
|
31
|
+
document: { run: documentWorkflow, preflight: documentWorkflowPreflight },
|
|
32
|
+
quality: { run: qualityWorkflow, preflight: qualityWorkflowPreflight },
|
|
33
|
+
scout: {
|
|
34
|
+
run: scoutWorkflow,
|
|
35
|
+
validate: command => { if (!command.args.join(" ").trim()) throw Object.assign(new Error("scout flow requires a question"), { exitCode: 2 }); },
|
|
36
|
+
preflight: scoutWorkflowPreflight,
|
|
37
|
+
},
|
|
38
|
+
poll: {
|
|
39
|
+
run: pollWorkflow,
|
|
40
|
+
validate: pollWorkflowValidate,
|
|
41
|
+
preflight: pollWorkflowPreflight,
|
|
42
|
+
},
|
|
43
|
+
debate: {
|
|
44
|
+
run: debateWorkflow,
|
|
45
|
+
validate: debateWorkflowValidate,
|
|
46
|
+
preflight: debateWorkflowPreflight,
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
function workflowExportName(name: string): string {
|
|
51
|
+
return `${name.replace(/-([a-z0-9])/g, (_, char: string) => char.toUpperCase())}Workflow`;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export async function resolveWorkflow(name: string, workflowsDir = resolve(dirname(fileURLToPath(import.meta.url)), "workflows")): Promise<WorkflowDefinition | undefined> {
|
|
55
|
+
if (workflows[name]) return workflows[name];
|
|
56
|
+
const path = resolve(workflowsDir, `wf-${name}.ts`);
|
|
57
|
+
if (!existsSync(path)) return undefined;
|
|
58
|
+
const module = await import(`${pathToFileURL(path).href}?flow=${Date.now()}`) as Record<string, unknown>;
|
|
59
|
+
const exportName = workflowExportName(name);
|
|
60
|
+
const run = module[exportName];
|
|
61
|
+
if (typeof run !== "function") throw Object.assign(new Error(`Flow ${name} must export ${exportName}().`), { exitCode: 2 });
|
|
62
|
+
const preflight = module[`${exportName}Preflight`];
|
|
63
|
+
if (preflight !== undefined && typeof preflight !== "function") throw Object.assign(new Error(`Flow ${name} has an invalid ${exportName}Preflight export.`), { exitCode: 2 });
|
|
64
|
+
return { run: run as Workflow, ...(typeof preflight === "function" ? { preflight: preflight as (cwd: string) => void } : {}) };
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string } = {}): Promise<FinishResult> {
|
|
68
|
+
const cwd = options.cwd ?? process.cwd();
|
|
69
|
+
const workflow = await resolveWorkflow(command.name, options.workflowsDir);
|
|
70
|
+
if (!workflow) throw Object.assign(new Error(`Unknown flow: ${command.name}`), { exitCode: 2 });
|
|
71
|
+
workflow.validate?.(command, cwd);
|
|
72
|
+
loadEnv(cwd);
|
|
73
|
+
// All refusal checks precede branch creation and the FlowTrace constructor.
|
|
74
|
+
requireCleanTree(cwd, command.allowDirty);
|
|
75
|
+
workflow.preflight?.(cwd, command);
|
|
76
|
+
const runId = command.runId ?? makeRunId();
|
|
77
|
+
const repositoryBaseline = snapshot(cwd);
|
|
78
|
+
const branch = createFlowBranch(command.name, runId, cwd);
|
|
79
|
+
const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline });
|
|
80
|
+
const persistResult = (result: FinishResult) => {
|
|
81
|
+
try { recordFlowResult(branch, result.status, cwd); }
|
|
82
|
+
catch (error) { console.error(`Warning: flow result metadata was not recorded: ${error instanceof Error ? error.message : String(error)}`); }
|
|
83
|
+
};
|
|
84
|
+
let interruption: FinishResult | undefined;
|
|
85
|
+
const onSignal = (signal: NodeJS.Signals) => {
|
|
86
|
+
if (interruption) return;
|
|
87
|
+
interruption = run.interrupt(signal);
|
|
88
|
+
};
|
|
89
|
+
process.once("SIGINT", onSignal);
|
|
90
|
+
process.once("SIGTERM", onSignal);
|
|
91
|
+
try {
|
|
92
|
+
const result = await workflow.run(run, { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply });
|
|
93
|
+
const finalResult = interruption ?? result;
|
|
94
|
+
persistResult(finalResult);
|
|
95
|
+
console.error(finalResult.banner);
|
|
96
|
+
return finalResult;
|
|
97
|
+
} catch (error) {
|
|
98
|
+
if (!interruption) {
|
|
99
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
100
|
+
const rejected = run.abort(message);
|
|
101
|
+
persistResult(rejected);
|
|
102
|
+
console.error(rejected.banner);
|
|
103
|
+
throw error;
|
|
104
|
+
}
|
|
105
|
+
persistResult(interruption);
|
|
106
|
+
console.error(interruption.banner);
|
|
107
|
+
return interruption;
|
|
108
|
+
} finally {
|
|
109
|
+
process.removeListener("SIGINT", onSignal);
|
|
110
|
+
process.removeListener("SIGTERM", onSignal);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
export async function main(argv = process.argv.slice(2)): Promise<number> {
|
|
115
|
+
if (argv[0] === "cleanup" || argv[0] === "merge") {
|
|
116
|
+
let command;
|
|
117
|
+
try { command = parseFlowMaintenanceCommand(argv); }
|
|
118
|
+
catch (error) { console.error(error instanceof Error ? error.message : String(error)); return 2; }
|
|
119
|
+
try { return await runFlowMaintenance(command); }
|
|
120
|
+
catch (error) {
|
|
121
|
+
console.error(error instanceof Error ? error.message : String(error));
|
|
122
|
+
return Number((error as { exitCode?: number })?.exitCode ?? 1);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
let parsed: FlowCommand;
|
|
126
|
+
try { parsed = parseFlowCommand(argv); }
|
|
127
|
+
catch (error) { console.error(error instanceof Error ? error.message : String(error)); return 2; }
|
|
128
|
+
try {
|
|
129
|
+
return (await executeFlow(parsed)).exitCode;
|
|
130
|
+
} catch (error) {
|
|
131
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
132
|
+
console.error(message);
|
|
133
|
+
return Number((error as { exitCode?: number })?.exitCode ?? (error instanceof StartRefusedError ? 3 : 1));
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) process.exitCode = await main();
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import * as fs from 'node:fs';import * as path from 'node:path';import * as crypto from 'node:crypto';import {fileURLToPath} from 'node:url';import {spawn as realSpawn} from 'node:child_process';
|
|
2
|
+
export function parseRunnerArgs(argv:string[]){if(argv[0]!=='verify')throw Error('unsupported command');const out:any={};for(let i=1;i<argv.length;i+=2){const k=argv[i],v=argv[i+1];if(!['--root','--artifact'].includes(k)||!v||out[k])throw Error('invalid arguments');out[k]=v;}if(!out['--root']||!out['--artifact'])throw Error('missing arguments');return{root:out['--root'],artifact:out['--artifact']};}
|
|
3
|
+
export function verifyGateArtifact(root:string,artifactPath:string){root=validateOwnedRoot(root);const st=fs.lstatSync(artifactPath);if(st.isSymbolicLink()||!st.isFile())throw Error('unsafe gate artifact');const a=JSON.parse(fs.readFileSync(artifactPath,'utf8'));const bad=()=>{throw Error('gate artifact failed closed')};if(a.schema!=='agent-fleet.hermes-gate-c-capabilities'||a.schemaVersion!==1||a.gate!=='C'||a.status!=='passed'||a.runtimeVerified!==true)bad();const argv=a.argv??{};for(const k of ['pluginEnableArgv','backendStartArgv','backendStopArgv','desktopStartArgv','desktopStopArgv'])if(!Array.isArray(argv[k])||!argv[k].length||argv[k].some((x:any)=>typeof x!=='string'||!x))bad();if(!a.capabilities?.desktopDebugAttachment?.url||!a.capabilities?.desktopDebugAttachment?.probeExpression)bad();const proof=a.pluginLoadProof;if(proof?.backendPluginId!=='agent-fleet-monitor'||proof?.desktopPluginId!=='agent-fleet-monitor')bad();if(a.validation?.status!=='passed'||a.gateDecision?.status!=='pass'||a.gateDecision?.implementationMayProceed!==true)bad();const raw=JSON.stringify(a);if(/(api[_-]?key|token|password|\/home\/|\.pi\/agent)/i.test(raw))bad();return{sha256:crypto.createHash('sha256').update(raw).digest('hex'),argv:{enable:argv.pluginEnableArgv,backend:argv.backendStartArgv,desktop:argv.desktopStartArgv},debug:a.capabilities.desktopDebugAttachment,proof};}
|
|
4
|
+
export type Owned={root:string;pid?:number;argv:string[];executable:string;start?:string;reservation:string};
|
|
5
|
+
export function ownedIndexPath(root:string,file:string){root=validateOwnedRoot(root);const target=path.resolve(root,file);if(path.dirname(target)!==root||path.basename(target)!==file)throw Error('owned index must be direct child');return target;}
|
|
6
|
+
export function writeOwnedIndex(root:string,file:string,value:any){const target=ownedIndexPath(root,file);if(!value||value.schema!==1||value.root!==validateOwnedRoot(root)||typeof value.owner!=='string'||typeof value.artifactSha256!=='string'||typeof value.components!=='object')throw Error('invalid owned index');for(const [component,item] of Object.entries(value.components)){componentName(component);const x:any=item;if(!x||x.registry!==`registry-${component}.json`||typeof x.owner!=='string')throw Error('invalid owned index component');}const tmp=path.join(root,`.${path.basename(file)}.${process.pid}.tmp`);fs.writeFileSync(tmp,JSON.stringify(value),{mode:0o600});fs.renameSync(tmp,target);return value;}
|
|
7
|
+
export function readOwnedIndex(root:string,file:string){const target=ownedIndexPath(root,file),st=fs.lstatSync(target);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error('unsafe owned index');return JSON.parse(fs.readFileSync(target,'utf8'));}
|
|
8
|
+
const SENTINEL='.agent-fleet-hermes-monitor-smoke',REGISTRY='owned-registry.json';const componentName=(v:string)=>{if(!/^[A-Za-z0-9._-]+$/.test(v)||v.includes('..'))throw Error('invalid component');return v};
|
|
9
|
+
export async function terminateExactChild(child:any,deps:any={}){if(!child||typeof child.kill!=='function')throw Error('child handle required');if(child.exitCode!==null&&child.exitCode!==undefined)return{exited:true};const set=deps.setTimeout??setTimeout,clear=deps.clearTimeout??clearTimeout,waitMs=deps.waitMs??5000;let resolve:any;const exited=new Promise(r=>resolve=r);child.once?.('exit',()=>resolve(true));const wait=()=>new Promise(r=>{timer=set(r,waitMs)});try{child.kill('SIGTERM')}catch(e:any){if(e?.code==='ESRCH')return{exited:true};throw e}let timer:any;try{const first=await Promise.race([exited,wait()]);if(first)return{exited:true};try{child.kill('SIGKILL')}catch(e:any){if(e?.code==='ESRCH')return{exited:true};throw e}const second=await Promise.race([exited,wait()]);return{exited:!!second};}finally{if(timer!==undefined)clear(timer);}}
|
|
10
|
+
const finalizedLaunchErrors=new Set<string>();export async function finalizeDurableLaunchError(root:string,component:string,owner:string,reservation:string,child:any,deps:any={}){const key=`${root}:${component}:${owner}`;if(finalizedLaunchErrors.has(key))return;finalizedLaunchErrors.add(key);try{if(child?.exitCode===null||child?.exitCode===undefined)await terminateExactChild(child,deps);}catch{}try{const record=readOwnedRegistry(root,component);if(record.owner!==owner||record.state==='exited')return;writeOwnedRegistry(root,{...record,state:'failed'},component);const value=JSON.parse(fs.readFileSync(reservation,'utf8'));if(value.owner===owner)fs.unlinkSync(reservation);}catch{}}
|
|
11
|
+
export function safeRoot(root:string){const r=path.resolve(root);if(r===path.parse(r).root)throw Error('owned root required');return r;}
|
|
12
|
+
export function validateOwnedRoot(root:string){root=safeRoot(root);const st=fs.lstatSync(root);if(st.isSymbolicLink()||!st.isDirectory()||(st.mode&0o777)!==0o700)throw Error('unsafe owned root');const sentinel=path.join(root,SENTINEL),ss=fs.lstatSync(sentinel);if(ss.isSymbolicLink()||!ss.isFile()||(ss.mode&0o777)!==0o600)throw Error('unsafe owned sentinel');const value=JSON.parse(fs.readFileSync(sentinel,'utf8'));if(value?.schema!==1||value?.owner!=='agent-fleet'||value?.root!==fs.realpathSync(root))throw Error('invalid owned sentinel');return fs.realpathSync(root);}
|
|
13
|
+
export function buildOwnedEnv(root:string,env:any={}){root=validateOwnedRoot(root);const child=(n:string)=>path.join(root,n);for(const n of ['home','config','state','runtime','cache','hermes','sockets']){const p=child(n);fs.mkdirSync(p,{recursive:true,mode:0o700});const st=fs.lstatSync(p);if(st.isSymbolicLink()||!st.isDirectory()||(st.mode&0o777)!==0o700)throw Error('unsafe owned env path');}return{...env,HOME:child('home'),XDG_CONFIG_HOME:child('config'),XDG_STATE_HOME:child('state'),XDG_RUNTIME_DIR:child('runtime'),XDG_CACHE_HOME:child('cache'),HERMES_HOME:child('hermes'),HERDR_SOCKET_PATH:path.join(child('sockets'),'herdr.sock')};}
|
|
14
|
+
export function writeOwnedRegistry(root:string,value:any,component?:string){root=validateOwnedRoot(root);if(component)componentName(component);if(!Array.isArray(value.argv)||!value.argv.length||value.argv.some((x:any)=>typeof x!=='string'||!x))throw Error('invalid owned argv');const clean={schema:1,root,component:(typeof value.component==='string'&&/^[A-Za-z0-9._-]+$/.test(value.component)?value.component:(()=>{throw Error('invalid component')})()),executable:fs.realpathSync(value.executable),argv:[...(value.argv??[])].map(String),pid:Number(value.pid),start:String(value.start),state:String(value.state??'running'),owner:typeof value.owner==='string'?value.owner:undefined,createdAt:value.createdAt??new Date().toISOString(),updatedAt:new Date().toISOString()};const name=component?`registry-${component}.json`:REGISTRY,file=path.join(root,name),tmp=path.join(root,`.${name}.${process.pid}.tmp`);fs.writeFileSync(tmp,JSON.stringify(clean),{mode:0o600});fs.renameSync(tmp,file);return clean;}
|
|
15
|
+
export function readOwnedRegistry(root:string,component?:string){root=validateOwnedRoot(root);if(component)componentName(component);const file=path.join(root,component?`registry-${component}.json`:REGISTRY),st=fs.lstatSync(file);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error('unsafe owned registry');const v=JSON.parse(fs.readFileSync(file,'utf8'));if(v?.schema!==1||v.root!==root||!Array.isArray(v.argv)||!v.argv.length||v.argv.some((x:any)=>typeof x!=='string'||!x)||typeof v.component!=='string'||typeof v.pid!=='number'||v.pid<=0||typeof v.start!=='string'||!v.start||typeof v.owner!=='string'||!v.owner||!['starting','running','stopping','exited','failed'].includes(v.state))throw Error('invalid owned registry');return v;}
|
|
16
|
+
export async function launchOwnedDurable(root:string,component:string,argv:string[],deps:any={}){root=validateOwnedRoot(root);if(!/^[A-Za-z0-9._-]+$/.test(component)||!Array.isArray(argv)||!argv.length||argv.some(x=>typeof x!=='string'||!x))throw Error('invalid durable launch');const f=deps.fs??fs,spawn=deps.spawn??realSpawn,owner=deps.uuid?.()??crypto.randomUUID(),reservation=path.join(root,`.reservation-${component}`);try{f.writeFileSync(reservation,JSON.stringify({owner,component}),{flag:'wx',mode:0o600});}catch{throw Error('component reservation exists')}let child:any=null;const fail=(state:string)=>{try{writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:0,start:'',state,owner},component)}catch{}try{const value=JSON.parse(f.readFileSync(reservation,'utf8'));if(value.owner===owner)f.unlinkSync(reservation)}catch{}};try{writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:0,start:'pending',state:'starting',owner},component);child=spawn(argv[0],argv.slice(1),{cwd:root,env:buildOwnedEnv(root),shell:false,stdio:'ignore'});child.once?.('error',()=>{void finalizeDurableLaunchError(root,component,owner,reservation,child,deps).catch(()=>{})});const start=(deps.startOf??startOf)(child.pid);const record=writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:child.pid,start,state:'running',owner},component);child.once?.('exit',()=>{try{const current=readOwnedRegistry(root,component);if(current.component===component&¤t.pid===child.pid&¤t.start===start)writeOwnedRegistry(root,{...current,state:'exited'},component);}catch{}});return{child,record,reservation};}catch(error){if(child){await finalizeDurableLaunchError(root,component,owner,reservation,child,deps);fail('failed')}else fail('failed');throw error;}}
|
|
17
|
+
export async function waitOwnedFromRegistry(root:string,component:string,deps:any={}){const now=deps.now??Date.now,sleep=deps.sleep??((ms:number)=>new Promise(r=>setTimeout(r,ms))),start=deps.startOf??startOf,timeout=deps.timeout??10_000;const record=readOwnedRegistry(root,component);if(record.component!==component||!['running','stopping'].includes(record.state))return record;if(start(record.pid)!==record.start)throw Error('owned process identity changed');const began=now();while(now()-began<timeout){try{if(start(record.pid)!==record.start){const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);return exited;}}catch{return writeOwnedRegistry(root,{...record,state:'exited'},component)}await sleep(10);}throw Error('owned wait timeout');}
|
|
18
|
+
export async function stopOwnedFromRegistry(root:string,component:string,deps:any={}){const signal=deps.signal??((pid:number,s:string)=>process.kill(pid,s)),start=deps.startOf??startOf,sleep=deps.sleep??((ms:number)=>new Promise(r=>setTimeout(r,ms)));let record=readOwnedRegistry(root,component);if(record.component!==component||record.state!=='running')throw Error('component not running');const markExited=()=>{const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);try{const p=path.join(root,`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===record.owner)fs.unlinkSync(p)}catch{}return exited};const same=()=>{try{const value=start(record.pid);if(value===undefined||value===null)return null;return value===record.start}catch(e:any){if(e?.code==='ESRCH')return null;throw e}};const initial=same();if(initial===null)return markExited();if(!initial)throw Error('owned process identity changed');record=writeOwnedRegistry(root,{...record,state:'stopping'},component);try{signal(record.pid,'SIGTERM')}catch(e:any){if(e?.code==='ESRCH'){const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);try{const p=path.join(root,`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===record.owner)fs.unlinkSync(p)}catch{}return exited;}throw e}try{await waitOwnedFromRegistry(root,component,{...deps,timeout:5000});}catch{const beforeKill=same();if(beforeKill===null)return markExited();if(!beforeKill)throw Error('owned process identity changed');try{signal(record.pid,'SIGKILL')}catch(e:any){if(e?.code==='ESRCH')return writeOwnedRegistry(root,{...record,state:'exited'},component);throw e}try{await waitOwnedFromRegistry(root,component,{...deps,timeout:5000});}catch{writeOwnedRegistry(root,{...record,state:'failed'},component);throw Error('owned stop timeout');}}const final=readOwnedRegistry(root,component);try{const p=path.join(validateOwnedRoot(root),`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===final.owner)fs.unlinkSync(p)}catch{}return final;}
|
|
19
|
+
export async function launchOwnedIndexed(root:string,component:string,argv:string[],ownedFile:string,artifactSha:string,deps:any={}){root=validateOwnedRoot(root);const lock=path.join(root,'.owned-index.lock');let fd,acquired=false;let launched:any,index:any,prior:any;try{fd=fs.openSync(lock,'wx',0o600);acquired=true;try{index=readOwnedIndex(root,ownedFile)}catch{index={schema:1,root,owner:crypto.randomUUID(),artifactSha256:artifactSha,components:{}}}if(index.artifactSha256!==artifactSha)throw Error('artifact mismatch');prior=index.components[component];launched=await launchOwnedDurable(root,component,argv,deps);const record=readOwnedRegistry(root,component);index.components[component]={registry:`registry-${component}.json`,owner:record.owner};writeOwnedIndex(root,ownedFile,index);return launched;}catch(error){if(launched){try{const record=readOwnedRegistry(root,component);if(record.owner===launched.record.owner&&record.pid===launched.record.pid&&record.start===launched.record.start)await stopOwnedFromRegistry(root,component,deps);}catch{}try{if(index){if(prior)index.components[component]=prior;else delete index.components[component];writeOwnedIndex(root,ownedFile,index);}}catch{}}throw error;}finally{if(acquired){try{fs.closeSync(fd)}catch{};try{fs.unlinkSync(lock)}catch{}}}}
|
|
20
|
+
export async function waitOwnedIndexed(root:string,component:string,ownedFile:string,artifactSha:string,deps:any={}){const index=readOwnedIndex(root,ownedFile),entry=index.components?.[component],record=readOwnedRegistry(root,component);if(index.artifactSha256!==artifactSha||!entry||entry.registry!==`registry-${component}.json`||entry.owner!==record.owner)throw Error('owned index mismatch');return waitOwnedFromRegistry(root,component,deps);}
|
|
21
|
+
export async function stopOwnedIndexed(root:string,component:string,ownedFile:string,artifactSha:string,deps:any={}){const index=readOwnedIndex(root,ownedFile),record=readOwnedRegistry(root,component),entry=index.components?.[component];if(!entry||entry.owner!==record.owner||index.artifactSha256!==artifactSha)throw Error('owned index mismatch');const result=await stopOwnedFromRegistry(root,component,deps);if(['exited','failed'].includes(result.state)&&index.components[component]?.owner===record.owner){delete index.components[component];writeOwnedIndex(root,ownedFile,index);}return result;}
|
|
22
|
+
if(process.argv[1]===fileURLToPath(import.meta.url)){try{const a=parseRunnerArgs(process.argv.slice(2)),v=verifyGateArtifact(a.root,a.artifact);process.stdout.write(JSON.stringify({ok:true,sha256:v.sha256})+'\n');}catch{process.stdout.write(JSON.stringify({ok:false,error:'verification_failed'})+'\n');process.exitCode=2;}}
|
|
23
|
+
export function writeGateArtifact(root:string,value:unknown){root=validateOwnedRoot(root);fs.mkdirSync(root,{recursive:true,mode:0o700});const file=path.join(root,'gate-c.json'),tmp=`${file}.${process.pid}.${Math.random()}.tmp`;fs.writeFileSync(tmp,JSON.stringify(value),{mode:0o600});fs.renameSync(tmp,file);return file;}
|
|
24
|
+
const startOf=(pid:number,read=(p:string)=>fs.readFileSync(p,'utf8'))=>{const stat=read(`/proc/${pid}/stat`),tail=stat.slice(stat.lastIndexOf(')')+2).split(' ');return tail[19];};
|
|
25
|
+
export async function runOwned(argv:string[],root:string,deps:any={}){if(!Array.isArray(argv)||!argv.length||argv.some(x=>typeof x!=='string'))throw Error('argv required');root=validateOwnedRoot(root);const f=deps.fs??fs,spawn=deps.spawn??realSpawn,set=deps.setTimeout??setTimeout,clear=deps.clearTimeout??clearTimeout,signals=deps.signals??process;f.mkdirSync(root,{recursive:true,mode:0o700});const reservation=path.join(root,'.reservation');let fd;try{fd=f.openSync(reservation,'wx',0o600);}catch{throw Error('owned reservation exists')}const owned:Owned={root,argv:[...argv],executable:argv[0],reservation};let child:any,exitResolve:any;const exited=new Promise(r=>exitResolve=r);let released=false,timer:any;const release=()=>{if(released)return;released=true;try{f.unlinkSync(reservation)}catch{};try{f.unlinkSync(path.join(root,'gate-c.json'))}catch{}};try{writeGateArtifact(root,{root,argv,executable:argv[0]});child=spawn(argv[0],argv.slice(1),{cwd:root,env:{...process.env,HOME:path.join(root,'home')},shell:false,stdio:'ignore'});owned.pid=child.pid;owned.start=(deps.startOf??startOf)(child.pid);child.once('exit',(code:any)=>{if(timer!==undefined)clear(timer);exitResolve(code);release();});}catch(e){release();throw e}const valid=()=>!!owned.pid&&(deps.startOf??startOf)(owned.pid)===owned.start;const stop=async()=>{if(released)return;if(!valid())throw Error('owned process identity changed');child.kill('SIGTERM');timer=set(()=>{if(valid())child.kill('SIGKILL')},5000);await exited;};const wait=()=>exited;const onSignal=()=>void stop();signals.once('SIGINT',onSignal);signals.once('SIGTERM',onSignal);return{child,owned,wait,stop,dispose:()=>{signals.removeListener('SIGINT',onSignal);signals.removeListener('SIGTERM',onSignal);release()}};}
|