@chankov/agent-fleet 2.0.1 → 2.0.2
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/agents/voices.yaml +13 -0
- package/.pi/harnesses/agent-hub/README.md +3 -1
- package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
- package/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.pi/harnesses/agent-hub/config/agents.ts +14 -5
- package/.pi/harnesses/agent-hub/config/overrides.ts +44 -4
- package/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.pi/harnesses/agent-hub/delegate.ts +2 -2
- package/.pi/harnesses/agent-hub/index.ts +197 -0
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +5 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -0
- package/.pi/harnesses/agent-hub/types.ts +1 -0
- package/.pi/harnesses/ask-user-remote/README.md +1 -1
- package/.pi/harnesses/coms/README.md +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.versions/2.0.2/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.2/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.2/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.2/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.2/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.2/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.2/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.2/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.2/.pi/extensions/package.json +9 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/README.md +1163 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/context.ts +41 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/config/agents.ts +180 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/config/overrides.ts +158 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/index.ts +2047 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/types.ts +61 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.2/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.2/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.2/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.2/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.2/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.2/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.2/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.2/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.2/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.2/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.2/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.2/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.2/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.2/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.2/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.2/.version +1 -0
- package/.versions/2.0.2/agents/architect.md +25 -0
- package/.versions/2.0.2/agents/bowser.md +28 -0
- package/.versions/2.0.2/agents/builder.md +56 -0
- package/.versions/2.0.2/agents/code-reviewer.md +210 -0
- package/.versions/2.0.2/agents/deep-researcher.md +33 -0
- package/.versions/2.0.2/agents/documenter.md +22 -0
- package/.versions/2.0.2/agents/orchestrator.md +23 -0
- package/.versions/2.0.2/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.2/agents/planner.md +105 -0
- package/.versions/2.0.2/agents/releaser.md +25 -0
- package/.versions/2.0.2/agents/researcher.md +31 -0
- package/.versions/2.0.2/agents/security-auditor.md +168 -0
- package/.versions/2.0.2/agents/test-engineer.md +154 -0
- package/.versions/2.0.2/agents/web-debugger.md +44 -0
- package/.versions/2.0.2/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.2/bin/catalog/harness-runtime-closure.json +34 -0
- package/.versions/2.0.2/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.2/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.2/docs/agent-fleet-setup.md +473 -0
- package/.versions/2.0.2/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.2/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.2/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.2/docs/getting-started.md +119 -0
- package/.versions/2.0.2/docs/npm-install.md +292 -0
- package/.versions/2.0.2/docs/pi-extensions.md +444 -0
- package/.versions/2.0.2/docs/pi-setup.md +74 -0
- package/.versions/2.0.2/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.2/hermes/README.md +347 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.2/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.2/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.2/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.2/install-manifest.json +2905 -0
- package/.versions/2.0.2/justfile +288 -0
- package/.versions/2.0.2/manifest-meta.json +945 -0
- package/.versions/2.0.2/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.2/references/communication-contract.md +26 -0
- package/.versions/2.0.2/references/definition-of-done.md +67 -0
- package/.versions/2.0.2/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.2/references/observability-checklist.md +91 -0
- package/.versions/2.0.2/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.2/references/performance-checklist.md +153 -0
- package/.versions/2.0.2/references/prompting-patterns.md +380 -0
- package/.versions/2.0.2/references/security-checklist.md +179 -0
- package/.versions/2.0.2/references/testing-patterns.md +236 -0
- package/.versions/2.0.2/references/workflow-authoring.md +304 -0
- package/.versions/2.0.2/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.2/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.2/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.2/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.2/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.2/scripts/fleet.ts +199 -0
- package/.versions/2.0.2/scripts/flow.ts +137 -0
- package/.versions/2.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.2/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.2/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.2/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.2/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.2/scripts/lib/codex-remote-control.ts +482 -0
- package/.versions/2.0.2/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.2/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.2/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.2/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.2/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.2/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.2/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.2/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.2/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.2/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.2/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.2/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.2/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.2/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.2/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.2/scripts/team-up.ts +406 -0
- package/.versions/2.0.2/scripts/workflows/lib/agent-phase.ts +132 -0
- package/.versions/2.0.2/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.2/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.2/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.2/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.2/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.2/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.2/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.2/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.2/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.2/scripts/workflows/lib/personas.ts +54 -0
- package/.versions/2.0.2/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.2/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.2/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.2/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.2/scripts/workflows/lib/voices.ts +125 -0
- package/.versions/2.0.2/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.2/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.2/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.2/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.2/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.2/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.2/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.2/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.2/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.2/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.2/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.2/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.2/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.2/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.2/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.2/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.2/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.2/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.2/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.2/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.2/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.2/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.2/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.2/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.2/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.2/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.2/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.2/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/agents/planner.md +40 -8
- package/bin/catalog/harness-runtime-closure.json +0 -4
- package/bin/lib/apply.js +65 -2
- package/bin/lib/doctor.js +143 -1
- package/bin/lib/plan.js +2 -0
- package/bin/lib/transaction.js +14 -1
- package/bin/lib/validate-overrides.js +20 -0
- package/bin/lib/verify.js +22 -1
- package/codex/CONDUCTOR.md +1 -1
- package/docs/agent-fleet-setup.md +8 -3
- package/docs/codex-remote-conductor.md +3 -3
- package/docs/pi-extensions.md +5 -0
- package/docs/workflows.md +7 -0
- package/install-manifest.json +84 -9
- package/justfile +2 -0
- package/manifest-meta.json +37 -5
- package/node_modules/yaml/LICENSE +13 -0
- package/node_modules/yaml/README.md +172 -0
- package/node_modules/yaml/bin.mjs +11 -0
- package/node_modules/yaml/browser/dist/compose/compose-collection.js +88 -0
- package/node_modules/yaml/browser/dist/compose/compose-doc.js +43 -0
- package/node_modules/yaml/browser/dist/compose/compose-node.js +109 -0
- package/node_modules/yaml/browser/dist/compose/compose-scalar.js +86 -0
- package/node_modules/yaml/browser/dist/compose/composer.js +219 -0
- package/node_modules/yaml/browser/dist/compose/resolve-block-map.js +115 -0
- package/node_modules/yaml/browser/dist/compose/resolve-block-scalar.js +198 -0
- package/node_modules/yaml/browser/dist/compose/resolve-block-seq.js +49 -0
- package/node_modules/yaml/browser/dist/compose/resolve-end.js +37 -0
- package/node_modules/yaml/browser/dist/compose/resolve-flow-collection.js +207 -0
- package/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +225 -0
- package/node_modules/yaml/browser/dist/compose/resolve-props.js +146 -0
- package/node_modules/yaml/browser/dist/compose/util-contains-newline.js +34 -0
- package/node_modules/yaml/browser/dist/compose/util-empty-scalar-position.js +26 -0
- package/node_modules/yaml/browser/dist/compose/util-flow-indent-check.js +15 -0
- package/node_modules/yaml/browser/dist/compose/util-map-includes.js +13 -0
- package/node_modules/yaml/browser/dist/doc/Document.js +335 -0
- package/node_modules/yaml/browser/dist/doc/anchors.js +71 -0
- package/node_modules/yaml/browser/dist/doc/applyReviver.js +55 -0
- package/node_modules/yaml/browser/dist/doc/createNode.js +88 -0
- package/node_modules/yaml/browser/dist/doc/directives.js +176 -0
- package/node_modules/yaml/browser/dist/errors.js +57 -0
- package/node_modules/yaml/browser/dist/index.js +17 -0
- package/node_modules/yaml/browser/dist/log.js +11 -0
- package/node_modules/yaml/browser/dist/nodes/Alias.js +116 -0
- package/node_modules/yaml/browser/dist/nodes/Collection.js +147 -0
- package/node_modules/yaml/browser/dist/nodes/Node.js +38 -0
- package/node_modules/yaml/browser/dist/nodes/Pair.js +36 -0
- package/node_modules/yaml/browser/dist/nodes/Scalar.js +24 -0
- package/node_modules/yaml/browser/dist/nodes/YAMLMap.js +144 -0
- package/node_modules/yaml/browser/dist/nodes/YAMLSeq.js +113 -0
- package/node_modules/yaml/browser/dist/nodes/addPairToJSMap.js +63 -0
- package/node_modules/yaml/browser/dist/nodes/identity.js +36 -0
- package/node_modules/yaml/browser/dist/nodes/toJS.js +37 -0
- package/node_modules/yaml/browser/dist/parse/cst-scalar.js +214 -0
- package/node_modules/yaml/browser/dist/parse/cst-stringify.js +61 -0
- package/node_modules/yaml/browser/dist/parse/cst-visit.js +97 -0
- package/node_modules/yaml/browser/dist/parse/cst.js +98 -0
- package/node_modules/yaml/browser/dist/parse/lexer.js +721 -0
- package/node_modules/yaml/browser/dist/parse/line-counter.js +39 -0
- package/node_modules/yaml/browser/dist/parse/parser.js +975 -0
- package/node_modules/yaml/browser/dist/public-api.js +102 -0
- package/node_modules/yaml/browser/dist/schema/Schema.js +37 -0
- package/node_modules/yaml/browser/dist/schema/common/map.js +17 -0
- package/node_modules/yaml/browser/dist/schema/common/null.js +15 -0
- package/node_modules/yaml/browser/dist/schema/common/seq.js +17 -0
- package/node_modules/yaml/browser/dist/schema/common/string.js +14 -0
- package/node_modules/yaml/browser/dist/schema/core/bool.js +19 -0
- package/node_modules/yaml/browser/dist/schema/core/float.js +43 -0
- package/node_modules/yaml/browser/dist/schema/core/int.js +38 -0
- package/node_modules/yaml/browser/dist/schema/core/schema.js +23 -0
- package/node_modules/yaml/browser/dist/schema/json/schema.js +62 -0
- package/node_modules/yaml/browser/dist/schema/tags.js +96 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/binary.js +58 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/bool.js +26 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/float.js +46 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/int.js +71 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/merge.js +67 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/omap.js +74 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/pairs.js +78 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/schema.js +39 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/set.js +93 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/timestamp.js +101 -0
- package/node_modules/yaml/browser/dist/stringify/foldFlowLines.js +146 -0
- package/node_modules/yaml/browser/dist/stringify/stringify.js +129 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyCollection.js +153 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyComment.js +20 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyDocument.js +85 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyNumber.js +25 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyPair.js +150 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyString.js +336 -0
- package/node_modules/yaml/browser/dist/util.js +11 -0
- package/node_modules/yaml/browser/dist/visit.js +233 -0
- package/node_modules/yaml/browser/index.js +5 -0
- package/node_modules/yaml/browser/package.json +3 -0
- package/node_modules/yaml/dist/cli.d.ts +8 -0
- package/node_modules/yaml/dist/cli.mjs +201 -0
- package/node_modules/yaml/dist/compose/compose-collection.d.ts +11 -0
- package/node_modules/yaml/dist/compose/compose-collection.js +90 -0
- package/node_modules/yaml/dist/compose/compose-doc.d.ts +7 -0
- package/node_modules/yaml/dist/compose/compose-doc.js +45 -0
- package/node_modules/yaml/dist/compose/compose-node.d.ts +29 -0
- package/node_modules/yaml/dist/compose/compose-node.js +112 -0
- package/node_modules/yaml/dist/compose/compose-scalar.d.ts +5 -0
- package/node_modules/yaml/dist/compose/compose-scalar.js +88 -0
- package/node_modules/yaml/dist/compose/composer.d.ts +63 -0
- package/node_modules/yaml/dist/compose/composer.js +224 -0
- package/node_modules/yaml/dist/compose/resolve-block-map.d.ts +6 -0
- package/node_modules/yaml/dist/compose/resolve-block-map.js +117 -0
- package/node_modules/yaml/dist/compose/resolve-block-scalar.d.ts +11 -0
- package/node_modules/yaml/dist/compose/resolve-block-scalar.js +200 -0
- package/node_modules/yaml/dist/compose/resolve-block-seq.d.ts +6 -0
- package/node_modules/yaml/dist/compose/resolve-block-seq.js +51 -0
- package/node_modules/yaml/dist/compose/resolve-end.d.ts +6 -0
- package/node_modules/yaml/dist/compose/resolve-end.js +39 -0
- package/node_modules/yaml/dist/compose/resolve-flow-collection.d.ts +7 -0
- package/node_modules/yaml/dist/compose/resolve-flow-collection.js +209 -0
- package/node_modules/yaml/dist/compose/resolve-flow-scalar.d.ts +10 -0
- package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +227 -0
- package/node_modules/yaml/dist/compose/resolve-props.d.ts +23 -0
- package/node_modules/yaml/dist/compose/resolve-props.js +148 -0
- package/node_modules/yaml/dist/compose/util-contains-newline.d.ts +2 -0
- package/node_modules/yaml/dist/compose/util-contains-newline.js +36 -0
- package/node_modules/yaml/dist/compose/util-empty-scalar-position.d.ts +2 -0
- package/node_modules/yaml/dist/compose/util-empty-scalar-position.js +28 -0
- package/node_modules/yaml/dist/compose/util-flow-indent-check.d.ts +3 -0
- package/node_modules/yaml/dist/compose/util-flow-indent-check.js +17 -0
- package/node_modules/yaml/dist/compose/util-map-includes.d.ts +4 -0
- package/node_modules/yaml/dist/compose/util-map-includes.js +15 -0
- package/node_modules/yaml/dist/doc/Document.d.ts +141 -0
- package/node_modules/yaml/dist/doc/Document.js +337 -0
- package/node_modules/yaml/dist/doc/anchors.d.ts +24 -0
- package/node_modules/yaml/dist/doc/anchors.js +76 -0
- package/node_modules/yaml/dist/doc/applyReviver.d.ts +9 -0
- package/node_modules/yaml/dist/doc/applyReviver.js +57 -0
- package/node_modules/yaml/dist/doc/createNode.d.ts +17 -0
- package/node_modules/yaml/dist/doc/createNode.js +90 -0
- package/node_modules/yaml/dist/doc/directives.d.ts +49 -0
- package/node_modules/yaml/dist/doc/directives.js +178 -0
- package/node_modules/yaml/dist/errors.d.ts +21 -0
- package/node_modules/yaml/dist/errors.js +62 -0
- package/node_modules/yaml/dist/index.d.ts +25 -0
- package/node_modules/yaml/dist/index.js +50 -0
- package/node_modules/yaml/dist/log.d.ts +3 -0
- package/node_modules/yaml/dist/log.js +19 -0
- package/node_modules/yaml/dist/nodes/Alias.d.ts +29 -0
- package/node_modules/yaml/dist/nodes/Alias.js +118 -0
- package/node_modules/yaml/dist/nodes/Collection.d.ts +73 -0
- package/node_modules/yaml/dist/nodes/Collection.js +151 -0
- package/node_modules/yaml/dist/nodes/Node.d.ts +53 -0
- package/node_modules/yaml/dist/nodes/Node.js +40 -0
- package/node_modules/yaml/dist/nodes/Pair.d.ts +22 -0
- package/node_modules/yaml/dist/nodes/Pair.js +39 -0
- package/node_modules/yaml/dist/nodes/Scalar.d.ts +47 -0
- package/node_modules/yaml/dist/nodes/Scalar.js +27 -0
- package/node_modules/yaml/dist/nodes/YAMLMap.d.ts +53 -0
- package/node_modules/yaml/dist/nodes/YAMLMap.js +147 -0
- package/node_modules/yaml/dist/nodes/YAMLSeq.d.ts +60 -0
- package/node_modules/yaml/dist/nodes/YAMLSeq.js +115 -0
- package/node_modules/yaml/dist/nodes/addPairToJSMap.d.ts +4 -0
- package/node_modules/yaml/dist/nodes/addPairToJSMap.js +65 -0
- package/node_modules/yaml/dist/nodes/identity.d.ts +23 -0
- package/node_modules/yaml/dist/nodes/identity.js +53 -0
- package/node_modules/yaml/dist/nodes/toJS.d.ts +29 -0
- package/node_modules/yaml/dist/nodes/toJS.js +39 -0
- package/node_modules/yaml/dist/options.d.ts +350 -0
- package/node_modules/yaml/dist/parse/cst-scalar.d.ts +64 -0
- package/node_modules/yaml/dist/parse/cst-scalar.js +218 -0
- package/node_modules/yaml/dist/parse/cst-stringify.d.ts +8 -0
- package/node_modules/yaml/dist/parse/cst-stringify.js +63 -0
- package/node_modules/yaml/dist/parse/cst-visit.d.ts +39 -0
- package/node_modules/yaml/dist/parse/cst-visit.js +99 -0
- package/node_modules/yaml/dist/parse/cst.d.ts +109 -0
- package/node_modules/yaml/dist/parse/cst.js +112 -0
- package/node_modules/yaml/dist/parse/lexer.d.ts +87 -0
- package/node_modules/yaml/dist/parse/lexer.js +723 -0
- package/node_modules/yaml/dist/parse/line-counter.d.ts +22 -0
- package/node_modules/yaml/dist/parse/line-counter.js +41 -0
- package/node_modules/yaml/dist/parse/parser.d.ts +84 -0
- package/node_modules/yaml/dist/parse/parser.js +980 -0
- package/node_modules/yaml/dist/public-api.d.ts +44 -0
- package/node_modules/yaml/dist/public-api.js +107 -0
- package/node_modules/yaml/dist/schema/Schema.d.ts +17 -0
- package/node_modules/yaml/dist/schema/Schema.js +39 -0
- package/node_modules/yaml/dist/schema/common/map.d.ts +2 -0
- package/node_modules/yaml/dist/schema/common/map.js +19 -0
- package/node_modules/yaml/dist/schema/common/null.d.ts +4 -0
- package/node_modules/yaml/dist/schema/common/null.js +17 -0
- package/node_modules/yaml/dist/schema/common/seq.d.ts +2 -0
- package/node_modules/yaml/dist/schema/common/seq.js +19 -0
- package/node_modules/yaml/dist/schema/common/string.d.ts +2 -0
- package/node_modules/yaml/dist/schema/common/string.js +16 -0
- package/node_modules/yaml/dist/schema/core/bool.d.ts +4 -0
- package/node_modules/yaml/dist/schema/core/bool.js +21 -0
- package/node_modules/yaml/dist/schema/core/float.d.ts +4 -0
- package/node_modules/yaml/dist/schema/core/float.js +47 -0
- package/node_modules/yaml/dist/schema/core/int.d.ts +4 -0
- package/node_modules/yaml/dist/schema/core/int.js +42 -0
- package/node_modules/yaml/dist/schema/core/schema.d.ts +1 -0
- package/node_modules/yaml/dist/schema/core/schema.js +25 -0
- package/node_modules/yaml/dist/schema/json/schema.d.ts +2 -0
- package/node_modules/yaml/dist/schema/json/schema.js +64 -0
- package/node_modules/yaml/dist/schema/json-schema.d.ts +69 -0
- package/node_modules/yaml/dist/schema/tags.d.ts +48 -0
- package/node_modules/yaml/dist/schema/tags.js +99 -0
- package/node_modules/yaml/dist/schema/types.d.ts +92 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/binary.d.ts +2 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/binary.js +70 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/bool.d.ts +7 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/bool.js +29 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/float.d.ts +4 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/float.js +50 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/int.d.ts +5 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/int.js +76 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/merge.d.ts +9 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/merge.js +71 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/omap.d.ts +22 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/omap.js +77 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/pairs.d.ts +10 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/pairs.js +82 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/schema.d.ts +1 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/schema.js +41 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/set.d.ts +28 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/set.js +96 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.d.ts +6 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.js +105 -0
- package/node_modules/yaml/dist/stringify/foldFlowLines.d.ts +34 -0
- package/node_modules/yaml/dist/stringify/foldFlowLines.js +151 -0
- package/node_modules/yaml/dist/stringify/stringify.d.ts +21 -0
- package/node_modules/yaml/dist/stringify/stringify.js +132 -0
- package/node_modules/yaml/dist/stringify/stringifyCollection.d.ts +17 -0
- package/node_modules/yaml/dist/stringify/stringifyCollection.js +155 -0
- package/node_modules/yaml/dist/stringify/stringifyComment.d.ts +10 -0
- package/node_modules/yaml/dist/stringify/stringifyComment.js +24 -0
- package/node_modules/yaml/dist/stringify/stringifyDocument.d.ts +4 -0
- package/node_modules/yaml/dist/stringify/stringifyDocument.js +87 -0
- package/node_modules/yaml/dist/stringify/stringifyNumber.d.ts +2 -0
- package/node_modules/yaml/dist/stringify/stringifyNumber.js +27 -0
- package/node_modules/yaml/dist/stringify/stringifyPair.d.ts +3 -0
- package/node_modules/yaml/dist/stringify/stringifyPair.js +152 -0
- package/node_modules/yaml/dist/stringify/stringifyString.d.ts +9 -0
- package/node_modules/yaml/dist/stringify/stringifyString.js +338 -0
- package/node_modules/yaml/dist/test-events.d.ts +4 -0
- package/node_modules/yaml/dist/test-events.js +134 -0
- package/node_modules/yaml/dist/util.d.ts +16 -0
- package/node_modules/yaml/dist/util.js +28 -0
- package/node_modules/yaml/dist/visit.d.ts +102 -0
- package/node_modules/yaml/dist/visit.js +236 -0
- package/node_modules/yaml/package.json +97 -0
- package/node_modules/yaml/util.js +2 -0
- package/package.json +4 -3
- package/references/communication-contract.md +26 -0
- package/references/fleet-coordination-patterns.md +20 -0
- package/references/orchestration-patterns.md +2 -2
- package/references/workflow-authoring.md +1 -1
- package/scripts/fleet.ts +2 -1
- package/scripts/flow.ts +23 -7
- package/scripts/lib/codex-remote-control.ts +3 -1
- package/scripts/lib/flow-command.ts +19 -3
- package/scripts/workflows/lib/agent-phase.ts +18 -4
- package/scripts/workflows/lib/debate.ts +149 -0
- package/scripts/workflows/lib/envelopes.ts +32 -4
- package/scripts/workflows/lib/merge.ts +95 -0
- package/scripts/workflows/lib/model-visibility.ts +92 -0
- package/scripts/workflows/lib/personas.ts +10 -0
- package/scripts/workflows/lib/poll.ts +86 -0
- package/scripts/workflows/lib/run.ts +2 -0
- package/scripts/workflows/lib/voices.ts +125 -0
- package/scripts/workflows/lib/writer-lease.ts +112 -0
- package/scripts/workflows/wf-debate.ts +87 -0
- package/scripts/workflows/wf-poll.ts +95 -0
- package/skills/drafting-workflows/SKILL.md +1 -1
- package/skills/planning-and-task-breakdown/SKILL.md +2 -0
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
import type { ChildProcess } from "node:child_process";
|
|
2
|
+
import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { resolve } from "node:path";
|
|
4
|
+
|
|
5
|
+
interface SpawnPiAgentOptions {
|
|
6
|
+
model: string; tools: string; thinking: string; systemPrompt?: string; noSkills?: boolean; noContextFiles?: boolean;
|
|
7
|
+
sessionFile: string; resume?: boolean; prompt: string; cwd?: string; extensions?: string[]; detached?: boolean;
|
|
8
|
+
signal?: AbortSignal; toolWatchdog?: { timeoutMs: number | null }; turnDeadlineMs?: number | null;
|
|
9
|
+
}
|
|
10
|
+
interface SpawnPiAgentResult { output: string; exitCode: number | null; assistantError?: string; spawnError?: string; stderr?: string }
|
|
11
|
+
interface SpawnCallbacks { onProcess?(process: ChildProcess): void; onUsage?(usage: { input?: number; output?: number; cacheRead?: number; cacheWrite?: number }): void }
|
|
12
|
+
type SpawnFallback = (options: SpawnPiAgentOptions, fallbackModel?: string, callbacks?: SpawnCallbacks, fallbackOptions?: { midRun?: boolean }) => Promise<SpawnPiAgentResult>;
|
|
13
|
+
const promptModulePath: string = "../../../.pi/harnesses/lib/context-budget-child-prompt.ts";
|
|
14
|
+
const contextModulePath: string = "../../../.pi/harnesses/agent-hub/context-window.js";
|
|
15
|
+
const spawnModulePath: string = "../../../.pi/harnesses/agent-hub/spawn.ts";
|
|
16
|
+
const { buildSpecialistContextManifest, nativeSpecialistSystemPrompt } = await import(promptModulePath) as {
|
|
17
|
+
buildSpecialistContextManifest(options: Record<string, unknown>): unknown;
|
|
18
|
+
nativeSpecialistSystemPrompt(options: Record<string, unknown>): string;
|
|
19
|
+
};
|
|
20
|
+
const { estimatePromptTokens, resolveContextWindow, shouldRecycleBeforeSpawn } = await import(contextModulePath) as {
|
|
21
|
+
estimatePromptTokens(text: string): number;
|
|
22
|
+
resolveContextWindow(model: string, options: { lookup?: AgentPhaseOptions["modelLookup"]; fallbackWindow?: number }): { window: number };
|
|
23
|
+
shouldRecycleBeforeSpawn(options: { priorTokens: number; promptTokens: number; window: number }): { message: string } | null;
|
|
24
|
+
};
|
|
25
|
+
const { spawnPiAgentWithModelFallback } = await import(spawnModulePath) as { spawnPiAgentWithModelFallback: SpawnFallback };
|
|
26
|
+
import { envelopePrompt, parseWithCorrections, type EnvelopeName } from "./envelopes.ts";
|
|
27
|
+
import { gateCorrectionPrompt, type Gate, type GateReport } from "./gates.ts";
|
|
28
|
+
import { enforce, snapshot, type PermissionPolicy } from "./permissions.ts";
|
|
29
|
+
import { resolvePhaseModel, resolvePhaseThinking, type PersonaDefinition } from "./personas.ts";
|
|
30
|
+
import type { Run } from "./run.ts";
|
|
31
|
+
|
|
32
|
+
export type SpawnAgent = SpawnFallback;
|
|
33
|
+
export interface AgentPhaseOptions<T = unknown> {
|
|
34
|
+
run: Run; persona: PersonaDefinition; task: string; envelope: EnvelopeName; cwd?: string;
|
|
35
|
+
spawn?: SpawnAgent; modelLookup?: (provider: string, modelId: string) => unknown; contextWindow?: number;
|
|
36
|
+
toolWatchdogMs?: number; turnDeadlineMs?: number; rulesPaths?: string[]; docsPaths?: string[];
|
|
37
|
+
gates?: Gate<T>[]; gateRetries?: number; protectedGlobs?: string[]; permissionPolicy?: PermissionPolicy;
|
|
38
|
+
model?: string; thinking?: string; sessionTag?: string;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export function modelTag(model: string): string {
|
|
42
|
+
return model.replace(/[^A-Za-z0-9._-]/g, "-");
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export function phaseSessionKey(personaName: string, modelOverride?: string, sessionTag?: string): string {
|
|
46
|
+
const parts = [personaName.toLowerCase()];
|
|
47
|
+
if (modelOverride !== undefined) parts.push(modelTag(modelOverride));
|
|
48
|
+
if (sessionTag) parts.push(modelTag(sessionTag));
|
|
49
|
+
return parts.join("-");
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
interface SessionMeta { contextTokens: number }
|
|
53
|
+
function readMeta(path: string): SessionMeta {
|
|
54
|
+
try { const value = JSON.parse(readFileSync(path, "utf8")); return { contextTokens: Number(value.contextTokens) || 0 }; } catch { return { contextTokens: 0 }; }
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export async function runAgentPhase<T = unknown>(options: AgentPhaseOptions<T>): Promise<T> {
|
|
58
|
+
const cwd = options.cwd ?? process.cwd();
|
|
59
|
+
const agentKey = options.persona.name.toLowerCase();
|
|
60
|
+
const model = resolvePhaseModel(options.persona, options.model);
|
|
61
|
+
const thinking = resolvePhaseThinking(options.persona, options.thinking);
|
|
62
|
+
const directory = resolve(options.run.trace.directory, phaseSessionKey(options.persona.name, options.model, options.sessionTag));
|
|
63
|
+
mkdirSync(directory, { recursive: true });
|
|
64
|
+
const sessionFile = resolve(directory, "session.json");
|
|
65
|
+
const metaFile = resolve(directory, "session-meta.json");
|
|
66
|
+
let meta = readMeta(metaFile);
|
|
67
|
+
let runNumber = 0;
|
|
68
|
+
if (options.permissionPolicy === undefined && options.persona.writes === undefined) {
|
|
69
|
+
throw new Error(`Flow agent persona ${options.persona.name} has no writes policy; declare persona writes or pass an explicit permissionPolicy.`);
|
|
70
|
+
}
|
|
71
|
+
let permissionBaseline = snapshot(cwd);
|
|
72
|
+
const permissionPolicy: PermissionPolicy = {
|
|
73
|
+
...(options.permissionPolicy ?? { writes: options.persona.writes }),
|
|
74
|
+
protectedGlobs: options.protectedGlobs ?? options.permissionPolicy?.protectedGlobs,
|
|
75
|
+
alwaysWritable: [...(options.permissionPolicy?.alwaysWritable ?? []), options.run.trace.directory],
|
|
76
|
+
};
|
|
77
|
+
const spawnAgent = options.spawn ?? spawnPiAgentWithModelFallback;
|
|
78
|
+
const manifest = buildSpecialistContextManifest({
|
|
79
|
+
personaName: options.persona.name, personaPath: options.persona.file, personaPrompt: options.persona.systemPrompt,
|
|
80
|
+
task: options.task, rulesPaths: options.rulesPaths ?? [], docsPaths: options.docsPaths ?? [],
|
|
81
|
+
hasAssertions: /\bA\d+\b/.test(options.task), hasScope: false, hasArtifacts: false, delegateRoles: [],
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
const invoke = async (prompt: string): Promise<string> => {
|
|
85
|
+
runNumber++;
|
|
86
|
+
const replacement = nativeSpecialistSystemPrompt({ manifest, userLanguage: "English", agentKey, runNumber });
|
|
87
|
+
const window = resolveContextWindow(model, { lookup: options.modelLookup, fallbackWindow: options.contextWindow ?? Number(process.env.AGENT_FLEET_CONTEXT_WINDOW ?? 0) });
|
|
88
|
+
let resume = existsSync(sessionFile);
|
|
89
|
+
const overflow = resume ? shouldRecycleBeforeSpawn({ priorTokens: meta.contextTokens, promptTokens: estimatePromptTokens(prompt) + estimatePromptTokens(replacement), window: window.window }) : null;
|
|
90
|
+
if (overflow) {
|
|
91
|
+
try { unlinkSync(sessionFile); } catch {}
|
|
92
|
+
meta = { contextTokens: 0 };
|
|
93
|
+
resume = false;
|
|
94
|
+
options.run.trace.write("log", { phase: options.persona.name, message: `session recycled before spawn — ${overflow.message}` });
|
|
95
|
+
}
|
|
96
|
+
let measuredTokens = meta.contextTokens;
|
|
97
|
+
const result = await spawnAgent({
|
|
98
|
+
model, tools: options.persona.tools, thinking,
|
|
99
|
+
systemPrompt: replacement, noSkills: true, noContextFiles: true, sessionFile, resume, prompt, cwd,
|
|
100
|
+
extensions: [".pi/harnesses/damage-control-continue/index.ts"], detached: true, signal: options.run.signal,
|
|
101
|
+
toolWatchdog: { timeoutMs: options.toolWatchdogMs ?? 120_000 }, turnDeadlineMs: options.turnDeadlineMs ?? 1_200_000,
|
|
102
|
+
}, options.persona.fallbackModel, {
|
|
103
|
+
onProcess: process => options.run.registerProcess(process, options.persona.name),
|
|
104
|
+
onUsage: usage => {
|
|
105
|
+
measuredTokens = Math.max(measuredTokens, Number(usage.input ?? 0) + Number(usage.output ?? 0) + Number((usage as any).cacheRead ?? 0) + Number((usage as any).cacheWrite ?? 0));
|
|
106
|
+
},
|
|
107
|
+
}, { midRun: !/(^|,)(write|edit)(,|$)/.test(options.persona.tools) });
|
|
108
|
+
meta = { contextTokens: measuredTokens };
|
|
109
|
+
writeFileSync(metaFile, JSON.stringify(meta), "utf8");
|
|
110
|
+
const after = snapshot(cwd);
|
|
111
|
+
enforce(permissionBaseline, after, permissionPolicy);
|
|
112
|
+
permissionBaseline = after;
|
|
113
|
+
if (result.exitCode !== 0) throw new Error(`Persona ${options.persona.name} failed (exit ${result.exitCode ?? "unknown"}): ${result.assistantError || result.spawnError || result.stderr || "no diagnostic"}`);
|
|
114
|
+
return result.output;
|
|
115
|
+
};
|
|
116
|
+
|
|
117
|
+
const parse = (output: string) => parseWithCorrections<T>(options.envelope, output, prompt => invoke(prompt), (attempt, errors) => {
|
|
118
|
+
options.run.trace.write("error", { phase: options.persona.name, invalidEnvelope: true, attempt: attempt + 1, errors });
|
|
119
|
+
});
|
|
120
|
+
let report = await parse(await invoke(`${options.task}\n\n${envelopePrompt(options.envelope)}`));
|
|
121
|
+
const retries = options.gateRetries ?? 0;
|
|
122
|
+
for (let attempt = 0; ; attempt++) {
|
|
123
|
+
const gateReports: GateReport[] = [];
|
|
124
|
+
for (const gate of options.gates ?? []) gateReports.push(await gate(report, options.run));
|
|
125
|
+
for (const gateReport of gateReports) {
|
|
126
|
+
options.run.trace.write("gate_report", { phase: options.persona.name, gate: gateReport.gate, ok: gateReport.ok, checks: gateReport.checks });
|
|
127
|
+
}
|
|
128
|
+
if (gateReports.every(gate => gate.ok)) return report;
|
|
129
|
+
if (attempt >= retries) throw Object.assign(new Error(`Executable gates failed after ${attempt + 1} attempt(s): ${gateReports.flatMap(gate => gate.failures().map(check => `${gate.gate}/${check.item}: ${check.note}`)).join("; ")}`), { terminal: true });
|
|
130
|
+
report = await parse(await invoke(gateCorrectionPrompt(gateReports)));
|
|
131
|
+
}
|
|
132
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import type { Run } from "./run.ts";
|
|
3
|
+
|
|
4
|
+
export interface BaseRef { ref: string; diffBase: string; reason: string; scenario: "ahead" | "dirty" | "fallback" }
|
|
5
|
+
export interface ChangeSet { base: BaseRef; changedFiles: string[]; untrackedFiles: string[]; diff: string; hiddenLines: number }
|
|
6
|
+
export interface ChangesEnvelope {
|
|
7
|
+
status: "success";
|
|
8
|
+
summary: string;
|
|
9
|
+
artifacts: string[];
|
|
10
|
+
notes_for_next_agent: string;
|
|
11
|
+
changed_files: string[];
|
|
12
|
+
base: string;
|
|
13
|
+
reason: string;
|
|
14
|
+
}
|
|
15
|
+
function git(cwd: string, args: string[]): string {
|
|
16
|
+
const result = spawnSync("git", args, { cwd, encoding: "utf8" });
|
|
17
|
+
if (result.status !== 0) throw new Error((result.stderr || result.stdout || `git ${args.join(" ")} failed`).trim());
|
|
18
|
+
return result.stdout;
|
|
19
|
+
}
|
|
20
|
+
function lines(value: string): string[] { return value.split(/\r?\n/).map(line => line.trim()).filter(Boolean); }
|
|
21
|
+
|
|
22
|
+
export function resolveBase(ref: string, cwd = process.cwd()): BaseRef {
|
|
23
|
+
git(cwd, ["rev-parse", "--verify", ref]);
|
|
24
|
+
const ahead = Number(git(cwd, ["rev-list", "--count", `${ref}..HEAD`]).trim());
|
|
25
|
+
if (ahead > 0) return { ref, diffBase: ref, reason: `HEAD is ahead of \`${ref}\``, scenario: "ahead" };
|
|
26
|
+
const dirty = git(cwd, ["status", "--porcelain", "--untracked-files=all"]).trim().length > 0;
|
|
27
|
+
if (dirty) return { ref, diffBase: "HEAD", reason: "diffing the uncommitted working tree", scenario: "dirty" };
|
|
28
|
+
const fallback = git(cwd, ["rev-parse", "--verify", "HEAD~1"]).trim();
|
|
29
|
+
return { ref, diffBase: fallback, reason: "clean tree — falling back to the last commit (HEAD~1)", scenario: "fallback" };
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function capture(run: Run, params: { ref?: string; cwd?: string; maxDiffLines?: number } = {}): ChangeSet {
|
|
33
|
+
const cwd = params.cwd ?? run.trace.cwd;
|
|
34
|
+
const base = resolveBase(params.ref ?? "main", cwd);
|
|
35
|
+
const runtimePrefix = `.pi/flow-sessions/${run.trace.runId}/`;
|
|
36
|
+
const tracked = lines(git(cwd, ["diff", "--name-only", base.diffBase, "--"])).filter(path => !path.startsWith(runtimePrefix));
|
|
37
|
+
const untrackedFiles = lines(git(cwd, ["ls-files", "--others", "--exclude-standard"])).filter(path => !path.startsWith(runtimePrefix));
|
|
38
|
+
const changedFiles = [...new Set([...tracked, ...untrackedFiles])].sort();
|
|
39
|
+
let diff = git(cwd, ["diff", "--no-ext-diff", "--unified=3", base.diffBase, "--"]);
|
|
40
|
+
if (untrackedFiles.length) diff += `${diff && !diff.endsWith("\n") ? "\n" : ""}Untracked files:\n${untrackedFiles.map(path => `?? ${path}`).join("\n")}\n`;
|
|
41
|
+
const allLines = diff.split(/\r?\n/);
|
|
42
|
+
if (allLines.at(-1) === "") allLines.pop();
|
|
43
|
+
const max = params.maxDiffLines ?? 2000;
|
|
44
|
+
const hiddenLines = Math.max(0, allLines.length - max);
|
|
45
|
+
if (hiddenLines) diff = `${allLines.slice(0, max).join("\n")}\n... ${hiddenLines} diff lines hidden by maxDiffLines ...`;
|
|
46
|
+
else diff = allLines.join("\n");
|
|
47
|
+
run.trace.write("log", { phase: "changes", message: base.reason, base: base.diffBase, ref: base.ref, changedFiles, untrackedFiles, hiddenLines });
|
|
48
|
+
return { base, changedFiles, untrackedFiles, diff, hiddenLines };
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export function asEnvelope(changes: ChangeSet, notes = ""): ChangesEnvelope {
|
|
52
|
+
return {
|
|
53
|
+
status: "success",
|
|
54
|
+
summary: `${changes.changedFiles.length} changed path(s) captured`,
|
|
55
|
+
artifacts: [],
|
|
56
|
+
notes_for_next_agent: [changes.diff, notes].filter(Boolean).join("\n\n"),
|
|
57
|
+
changed_files: changes.changedFiles,
|
|
58
|
+
base: changes.base.diffBase,
|
|
59
|
+
reason: changes.base.reason,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
import { mkdirSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { resolve } from "node:path";
|
|
3
|
+
import { runAgentPhase, type SpawnAgent } from "./agent-phase.ts";
|
|
4
|
+
import type { DebateReport } from "./envelopes.ts";
|
|
5
|
+
import type { PersonaDefinition } from "./personas.ts";
|
|
6
|
+
import { POLL_PERMISSION_POLICY, POLL_TOOLS, pollArtifactDir } from "./poll.ts";
|
|
7
|
+
import type { Run } from "./run.ts";
|
|
8
|
+
import { resolvePanel, type Voice } from "./voices.ts";
|
|
9
|
+
|
|
10
|
+
export const DEBATE_DEFAULT_ROUNDS = 3;
|
|
11
|
+
export const DEBATE_MIN_ROUNDS = 2;
|
|
12
|
+
export const DEBATE_MAX_ROUNDS = 5;
|
|
13
|
+
export const DEBATE_FOREIGN_PACKET_MAX_BYTES = 16_384;
|
|
14
|
+
|
|
15
|
+
export interface DebateVoiceSuccess { ok: true; voice: Voice; round: number; report: DebateReport; path: string }
|
|
16
|
+
export interface DebateVoiceFailure { ok: false; voice: Voice; round: number; reason: string; path: string }
|
|
17
|
+
export type DebateVoiceResult = DebateVoiceSuccess | DebateVoiceFailure;
|
|
18
|
+
export interface DebateRoundResult { round: number; results: DebateVoiceResult[] }
|
|
19
|
+
export interface DebateResult { panel: string; directory: string; rounds: number; roundsRun: DebateRoundResult[] }
|
|
20
|
+
|
|
21
|
+
export interface DebateVoiceRoundOptions {
|
|
22
|
+
run: Run; cwd: string; persona: PersonaDefinition; voice: Voice; task: string; panel: string;
|
|
23
|
+
round: number; rounds: number; others: DebateVoiceSuccess[];
|
|
24
|
+
spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<DebateReport>;
|
|
25
|
+
}
|
|
26
|
+
export interface DebateOptions {
|
|
27
|
+
run: Run; cwd: string; persona: PersonaDefinition; panel: string; task: string;
|
|
28
|
+
rounds?: number; voices?: Voice[];
|
|
29
|
+
spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<DebateReport>;
|
|
30
|
+
onVoice?: (result: DebateVoiceResult, round: number) => void | Promise<void>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export function resolveDebateRounds(value?: number): number {
|
|
34
|
+
const rounds = value ?? DEBATE_DEFAULT_ROUNDS;
|
|
35
|
+
if (!Number.isInteger(rounds) || rounds < DEBATE_MIN_ROUNDS || rounds > DEBATE_MAX_ROUNDS) {
|
|
36
|
+
throw Object.assign(new Error(`debate --rounds must be an integer from ${DEBATE_MIN_ROUNDS} to ${DEBATE_MAX_ROUNDS} (got ${value ?? rounds})`), { exitCode: 2 });
|
|
37
|
+
}
|
|
38
|
+
return rounds;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export function debateArtifactDir(cwd: string, runId: string): string {
|
|
42
|
+
return resolve(pollArtifactDir(cwd, runId), "debate");
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export function debateRoundDir(cwd: string, runId: string, round: number): string {
|
|
46
|
+
return resolve(debateArtifactDir(cwd, runId), `round-${round}`);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export function debateVoicePath(cwd: string, runId: string, round: number, voiceName: string): string {
|
|
50
|
+
return resolve(debateRoundDir(cwd, runId, round), `${voiceName}.md`);
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export function formatForeignPacket(others: DebateVoiceSuccess[]): string {
|
|
54
|
+
if (!others.length) return "";
|
|
55
|
+
const blocks = others.map(item => `## ${item.voice.name} (${item.voice.model})\n\n\`\`\`json\n${JSON.stringify(item.report, null, 2)}\n\`\`\``);
|
|
56
|
+
return ["Labeled positions from the previous round:", "", ...blocks].join("\n");
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export function assertForeignPacketSize(packet: string): void {
|
|
60
|
+
const bytes = Buffer.byteLength(packet, "utf8");
|
|
61
|
+
if (bytes > DEBATE_FOREIGN_PACKET_MAX_BYTES) {
|
|
62
|
+
throw new Error(`Debate refused: foreign opinion packet is ${bytes} bytes (cap ${DEBATE_FOREIGN_PACKET_MAX_BYTES})`);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export function debateRoundTask(question: string, round: number, total: number, others: DebateVoiceSuccess[]): string {
|
|
67
|
+
const packet = formatForeignPacket(others);
|
|
68
|
+
assertForeignPacketSize(packet);
|
|
69
|
+
return [
|
|
70
|
+
`Debate round ${round} of ${total}.`,
|
|
71
|
+
"You are one voice answering the same question. When labeled positions from other voices are present, address them by name.",
|
|
72
|
+
"Keep your own session; do not pretend to be another voice. There is no judge.",
|
|
73
|
+
"",
|
|
74
|
+
`Question:\n${question}`,
|
|
75
|
+
packet ? `\n${packet}` : "",
|
|
76
|
+
].filter(Boolean).join("\n");
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function readOnlyPersona(persona: PersonaDefinition): PersonaDefinition {
|
|
80
|
+
return { ...persona, tools: POLL_TOOLS, writes: [] };
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export function formatDebateArtifact(result: DebateVoiceResult): string {
|
|
84
|
+
const header = [`# ${result.voice.name}`, "", `- model: ${result.voice.model}`, `- round: ${result.round}`, `- thinking: ${result.voice.thinking ?? "medium"}`];
|
|
85
|
+
if (!result.ok) return `${header.join("\n")}\n- status: failed\n- reason: ${result.reason}\n`;
|
|
86
|
+
return `${header.join("\n")}\n- status: success\n\n## Report\n\n\`\`\`json\n${JSON.stringify(result.report, null, 2)}\n\`\`\`\n`;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export function writeDebateArtifact(cwd: string, runId: string, result: DebateVoiceResult): string {
|
|
90
|
+
const directory = debateRoundDir(cwd, runId, result.round);
|
|
91
|
+
mkdirSync(directory, { recursive: true });
|
|
92
|
+
const path = debateVoicePath(cwd, runId, result.round, result.voice.name);
|
|
93
|
+
writeFileSync(path, formatDebateArtifact(result), "utf8");
|
|
94
|
+
return path;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export async function debateVoiceRound(options: DebateVoiceRoundOptions): Promise<DebateVoiceResult> {
|
|
98
|
+
const path = debateVoicePath(options.cwd, options.run.trace.runId, options.round, options.voice.name);
|
|
99
|
+
const agent = options.runAgent ?? runAgentPhase<DebateReport>;
|
|
100
|
+
try {
|
|
101
|
+
const report = await agent({
|
|
102
|
+
run: options.run, persona: readOnlyPersona(options.persona),
|
|
103
|
+
task: debateRoundTask(options.task, options.round, options.rounds, options.others),
|
|
104
|
+
envelope: "debate", cwd: options.cwd, spawn: options.spawn,
|
|
105
|
+
model: options.voice.model, thinking: options.voice.thinking,
|
|
106
|
+
sessionTag: options.voice.name, permissionPolicy: POLL_PERMISSION_POLICY,
|
|
107
|
+
});
|
|
108
|
+
const result: DebateVoiceSuccess = { ok: true, voice: options.voice, round: options.round, report, path };
|
|
109
|
+
result.path = writeDebateArtifact(options.cwd, options.run.trace.runId, result);
|
|
110
|
+
return result;
|
|
111
|
+
} catch (error) {
|
|
112
|
+
const result: DebateVoiceFailure = {
|
|
113
|
+
ok: false, voice: options.voice, round: options.round,
|
|
114
|
+
reason: error instanceof Error ? error.message : String(error), path,
|
|
115
|
+
};
|
|
116
|
+
result.path = writeDebateArtifact(options.cwd, options.run.trace.runId, result);
|
|
117
|
+
return result;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export async function runDebate(options: DebateOptions): Promise<DebateResult> {
|
|
122
|
+
const rounds = resolveDebateRounds(options.rounds);
|
|
123
|
+
const voices = options.voices ?? resolvePanel(options.panel, options.cwd);
|
|
124
|
+
let active = [...voices];
|
|
125
|
+
const roundsRun: DebateRoundResult[] = [];
|
|
126
|
+
let previousSuccesses: DebateVoiceSuccess[] = [];
|
|
127
|
+
for (let round = 1; round <= rounds; round++) {
|
|
128
|
+
if (active.length < 2) break;
|
|
129
|
+
const results = await Promise.all(active.map(async voice => {
|
|
130
|
+
const others = previousSuccesses.filter(item => item.voice.name !== voice.name);
|
|
131
|
+
assertForeignPacketSize(formatForeignPacket(others));
|
|
132
|
+
const result = await debateVoiceRound({ ...options, voice, round, rounds, others });
|
|
133
|
+
try { await options.onVoice?.(result, round); } catch { /* progress is best-effort */ }
|
|
134
|
+
return result;
|
|
135
|
+
}));
|
|
136
|
+
roundsRun.push({ round, results });
|
|
137
|
+
const succeeded = results.filter((item): item is DebateVoiceSuccess => item.ok);
|
|
138
|
+
if (succeeded.length < 2) {
|
|
139
|
+
if (round === 1) {
|
|
140
|
+
const failures = results.filter(item => !item.ok).map(item => `${item.voice.name}: ${item.reason}`).join("; ");
|
|
141
|
+
throw new Error(`Debate failed: ${succeeded.length} of ${active.length} voices succeeded in round 1${failures ? ` (${failures})` : ""}`);
|
|
142
|
+
}
|
|
143
|
+
break;
|
|
144
|
+
}
|
|
145
|
+
previousSuccesses = succeeded;
|
|
146
|
+
active = succeeded.map(item => item.voice);
|
|
147
|
+
}
|
|
148
|
+
return { panel: options.panel, directory: debateArtifactDir(options.cwd, options.run.trace.runId), rounds, roundsRun };
|
|
149
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
+
import { resolve } from "node:path";
|
|
3
|
+
|
|
4
|
+
export function parseEnv(text: string): Record<string, string> {
|
|
5
|
+
const values: Record<string, string> = {};
|
|
6
|
+
for (const raw of text.split(/\r?\n/)) {
|
|
7
|
+
const line = raw.trim();
|
|
8
|
+
if (!line || line.startsWith("#")) continue;
|
|
9
|
+
const match = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
|
|
10
|
+
if (!match) continue;
|
|
11
|
+
let value = match[2].trim();
|
|
12
|
+
if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
|
|
13
|
+
const quote = value[0];
|
|
14
|
+
value = value.slice(1, -1);
|
|
15
|
+
if (quote === '"') value = value.replace(/\\n/g, "\n").replace(/\\r/g, "\r").replace(/\\t/g, "\t").replace(/\\"/g, '"').replace(/\\\\/g, "\\");
|
|
16
|
+
} else {
|
|
17
|
+
value = value.replace(/\s+#.*$/, "").trim();
|
|
18
|
+
}
|
|
19
|
+
values[match[1]] = value;
|
|
20
|
+
}
|
|
21
|
+
return values;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function loadEnv(cwd = process.cwd(), env: NodeJS.ProcessEnv = process.env): Record<string, string> {
|
|
25
|
+
const file = resolve(cwd, ".env");
|
|
26
|
+
if (!existsSync(file)) return {};
|
|
27
|
+
const loaded: Record<string, string> = {};
|
|
28
|
+
for (const [key, value] of Object.entries(parseEnv(readFileSync(file, "utf8")))) {
|
|
29
|
+
if (env[key] !== undefined) continue;
|
|
30
|
+
env[key] = value;
|
|
31
|
+
loaded[key] = value;
|
|
32
|
+
}
|
|
33
|
+
return loaded;
|
|
34
|
+
}
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import { Type, type Static, type TSchema } from "@sinclair/typebox";
|
|
2
|
+
import { Value } from "@sinclair/typebox/value";
|
|
3
|
+
const returnContractPath: string = "../../../.pi/harnesses/agent-hub/return-contract.js";
|
|
4
|
+
const { parseStructuredReturn } = await import(returnContractPath) as { parseStructuredReturn(text: string): Record<string, unknown> | null };
|
|
5
|
+
const StringArray = Type.Array(Type.String());
|
|
6
|
+
const EnvelopeBase = Type.Object({
|
|
7
|
+
status: Type.Union([Type.Literal("success"), Type.Literal("fail")]),
|
|
8
|
+
summary: Type.String(),
|
|
9
|
+
artifacts: StringArray,
|
|
10
|
+
notes_for_next_agent: Type.String(),
|
|
11
|
+
});
|
|
12
|
+
export const PlanEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ commit_message: Type.String() })]);
|
|
13
|
+
export const BuildEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ changed_files: StringArray, commit_message: Type.String() })]);
|
|
14
|
+
export const ReviewEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
|
|
15
|
+
approved: Type.Boolean(), assertions_proven: StringArray, assertions_unproven: StringArray,
|
|
16
|
+
assertions_failed: StringArray, open_risks: StringArray, requires_user_decision: StringArray,
|
|
17
|
+
})]);
|
|
18
|
+
export const ScoutEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ findings: StringArray })]);
|
|
19
|
+
export const DocumentEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ document_path: Type.String(), documented_files: StringArray, commit_message: Type.String() })]);
|
|
20
|
+
const AttributedClaim = Type.Object({ voice: Type.String({ minLength: 1 }), statement: Type.String({ minLength: 1 }) });
|
|
21
|
+
const RejectedClaim = Type.Object({ voice: Type.String({ minLength: 1 }), statement: Type.String({ minLength: 1 }), reason: Type.String({ minLength: 1 }) });
|
|
22
|
+
export const PollEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
|
|
23
|
+
position: Type.String(), case: StringArray,
|
|
24
|
+
confidence: Type.Union([Type.Literal("low"), Type.Literal("medium"), Type.Literal("high")]),
|
|
25
|
+
would_change_my_mind: StringArray,
|
|
26
|
+
})]);
|
|
27
|
+
export const DebateEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
|
|
28
|
+
position: Type.String(), changed: Type.Boolean(), aligned_with: StringArray, refutes: StringArray, evidence_that_moved_me: StringArray,
|
|
29
|
+
})]);
|
|
30
|
+
export const MergeEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
|
|
31
|
+
consensus: Type.Array(AttributedClaim), divergence: Type.Array(AttributedClaim), minority: Type.Array(AttributedClaim),
|
|
32
|
+
rejected: Type.Array(RejectedClaim), recommendation: Type.String(),
|
|
33
|
+
})]);
|
|
34
|
+
|
|
35
|
+
export const ENVELOPES = { plan: PlanEnvelope, build: BuildEnvelope, review: ReviewEnvelope, scout: ScoutEnvelope, document: DocumentEnvelope, poll: PollEnvelope, debate: DebateEnvelope, merge: MergeEnvelope } as const;
|
|
36
|
+
export type EnvelopeName = keyof typeof ENVELOPES;
|
|
37
|
+
export type ScoutReport = Static<typeof ScoutEnvelope>;
|
|
38
|
+
export type PollReport = Static<typeof PollEnvelope>;
|
|
39
|
+
export type DebateReport = Static<typeof DebateEnvelope>;
|
|
40
|
+
export type MergeReport = Static<typeof MergeEnvelope>;
|
|
41
|
+
export const JSON_FIX_ATTEMPTS = 2;
|
|
42
|
+
|
|
43
|
+
export const ENVELOPE_EXAMPLES: Record<EnvelopeName, Record<string, unknown>> = {
|
|
44
|
+
plan: { status: "success", summary: "Plan ready", artifacts: [], notes_for_next_agent: "", commit_message: "docs: add plan" },
|
|
45
|
+
build: { status: "success", summary: "Build complete", artifacts: [], notes_for_next_agent: "", changed_files: ["src/app.ts"], commit_message: "feat: build" },
|
|
46
|
+
review: { status: "success", summary: "Review clean", artifacts: [], notes_for_next_agent: "", approved: true, assertions_proven: [], assertions_unproven: [], assertions_failed: [], open_risks: [], requires_user_decision: [] },
|
|
47
|
+
scout: { status: "success", summary: "Scout complete", artifacts: [], notes_for_next_agent: "", findings: ["X lives in src/x.ts"] },
|
|
48
|
+
document: { status: "success", summary: "Docs complete", artifacts: [], notes_for_next_agent: "", document_path: "docs/x.md", documented_files: ["src/x.ts"], commit_message: "docs: explain x" },
|
|
49
|
+
poll: { status: "success", summary: "Opinion recorded", artifacts: [], notes_for_next_agent: "", position: "Prefer approach A.", case: ["It matches existing seams", "Less migration risk"], confidence: "high", would_change_my_mind: ["Evidence that A breaks the permission model"] },
|
|
50
|
+
debate: { status: "success", summary: "Round complete", artifacts: [], notes_for_next_agent: "", position: "Still prefer A.", changed: false, aligned_with: ["opus"], refutes: ["grok's rewrite is out of scope"], evidence_that_moved_me: [] },
|
|
51
|
+
merge: { status: "success", summary: "Merge complete", artifacts: [], notes_for_next_agent: "", consensus: [{ voice: "sol", statement: "Use approach A" }, { voice: "opus", statement: "Use approach A" }], divergence: [{ voice: "grok", statement: "Prefer approach B" }], minority: [{ voice: "grok", statement: "Approach B isolates failure better" }], rejected: [{ voice: "grok", statement: "Rewrite the module", reason: "Out of scope for this change" }], recommendation: "Adopt approach A; keep grok's isolation concern as a follow-up." },
|
|
52
|
+
};
|
|
53
|
+
|
|
54
|
+
export function envelopePrompt(name: EnvelopeName): string {
|
|
55
|
+
return `Finish by emitting ONLY your Report JSON with exactly this shape:\n${JSON.stringify(ENVELOPE_EXAMPLES[name], null, 2)}`;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function reportJsonCandidates(text: string): unknown[] {
|
|
59
|
+
const candidates: unknown[] = [];
|
|
60
|
+
for (let start = text.indexOf("{"); start >= 0; start = text.indexOf("{", start + 1)) {
|
|
61
|
+
let depth = 0, inString = false, escaped = false;
|
|
62
|
+
for (let end = start; end < text.length; end++) {
|
|
63
|
+
const char = text[end];
|
|
64
|
+
if (inString) {
|
|
65
|
+
if (escaped) escaped = false;
|
|
66
|
+
else if (char === "\\") escaped = true;
|
|
67
|
+
else if (char === '"') inString = false;
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
if (char === '"') { inString = true; continue; }
|
|
71
|
+
if (char === "{") { depth++; continue; }
|
|
72
|
+
if (char !== "}" || --depth !== 0) continue;
|
|
73
|
+
try { candidates.push(JSON.parse(text.slice(start, end + 1))); } catch {}
|
|
74
|
+
break;
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
return candidates;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function explicitlyParsedHubFields(text: string, parsed: Record<string, unknown>): Record<string, unknown> {
|
|
81
|
+
const candidate: Record<string, unknown> = {};
|
|
82
|
+
for (const [field, value] of Object.entries(parsed)) {
|
|
83
|
+
const label = field.replaceAll("_", "[_ -]");
|
|
84
|
+
const declared = new RegExp(`(?:^|\\n)\\s*(?:#{1,6}\\s+)?${label}\\s*:`, "i").test(text)
|
|
85
|
+
|| (Array.isArray(value) && value.length > 0);
|
|
86
|
+
if (declared) candidate[field] = value;
|
|
87
|
+
}
|
|
88
|
+
return candidate;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
const BASE_FIELDS = ["status", "summary", "artifacts", "notes_for_next_agent"];
|
|
92
|
+
const ENVELOPE_FIELDS: Record<EnvelopeName, string[]> = {
|
|
93
|
+
plan: [...BASE_FIELDS, "commit_message"],
|
|
94
|
+
build: [...BASE_FIELDS, "changed_files", "commit_message"],
|
|
95
|
+
review: [...BASE_FIELDS, "approved", "assertions_proven", "assertions_unproven", "assertions_failed", "open_risks", "requires_user_decision"],
|
|
96
|
+
scout: [...BASE_FIELDS, "findings"],
|
|
97
|
+
document: [...BASE_FIELDS, "document_path", "documented_files", "commit_message"],
|
|
98
|
+
poll: [...BASE_FIELDS, "position", "case", "confidence", "would_change_my_mind"],
|
|
99
|
+
debate: [...BASE_FIELDS, "position", "changed", "aligned_with", "refutes", "evidence_that_moved_me"],
|
|
100
|
+
merge: [...BASE_FIELDS, "consensus", "divergence", "minority", "rejected", "recommendation"],
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
export interface EnvelopeValidation<T = unknown> { ok: boolean; value?: T; errors: string[] }
|
|
104
|
+
|
|
105
|
+
export function envelopeErrorField(error: { path?: unknown }): string {
|
|
106
|
+
const path = typeof error.path === "string" ? error.path : "";
|
|
107
|
+
return path.replace(/^\//, "").replaceAll("/", ".") || "response";
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function schemaErrors(name: EnvelopeName, candidate: unknown): string[] {
|
|
111
|
+
if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return ["response: expected one complete Report JSON object"];
|
|
112
|
+
const schema: TSchema = ENVELOPES[name];
|
|
113
|
+
const typeErrors = [...Value.Errors(schema, candidate)];
|
|
114
|
+
const specificErrors = typeErrors.filter(error => typeof error.path === "string" && error.path.length > 0);
|
|
115
|
+
const errors = [...new Set((specificErrors.length ? specificErrors : typeErrors).map(error => {
|
|
116
|
+
const field = envelopeErrorField(error);
|
|
117
|
+
return error.type === 45 || /required/i.test(String(error.message ?? "")) ? `missing required field: ${field}` : `${field}: ${error.message}`;
|
|
118
|
+
}))];
|
|
119
|
+
const allowed = new Set(ENVELOPE_FIELDS[name]);
|
|
120
|
+
for (const field of Object.keys(candidate)) if (!allowed.has(field)) errors.push(`${field}: unexpected field for ${name} envelope`);
|
|
121
|
+
return errors;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
function selectCandidate(name: EnvelopeName, output: string, hubParsed: Record<string, unknown> | null): unknown {
|
|
125
|
+
const jsonCandidates = reportJsonCandidates(output).filter(candidate => candidate && typeof candidate === "object" && !Array.isArray(candidate));
|
|
126
|
+
for (let index = jsonCandidates.length - 1; index >= 0; index--) {
|
|
127
|
+
if (schemaErrors(name, jsonCandidates[index]).length === 0) return jsonCandidates[index];
|
|
128
|
+
}
|
|
129
|
+
const hubCandidate = hubParsed ? explicitlyParsedHubFields(output, hubParsed) : null;
|
|
130
|
+
const candidates = hubCandidate && Object.keys(hubCandidate).length > 0 ? [...jsonCandidates, hubCandidate] : jsonCandidates;
|
|
131
|
+
const expected = new Set(ENVELOPE_FIELDS[name]);
|
|
132
|
+
return candidates.reduce<unknown>((best, candidate) => {
|
|
133
|
+
if (!best) return candidate;
|
|
134
|
+
const score = Object.keys(candidate as object).filter(field => expected.has(field)).length;
|
|
135
|
+
const bestScore = Object.keys(best as object).filter(field => expected.has(field)).length;
|
|
136
|
+
return score >= bestScore ? candidate : best;
|
|
137
|
+
}, null);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
export function validateEnvelope<T = unknown>(name: EnvelopeName, output: string): EnvelopeValidation<T> {
|
|
141
|
+
// The shared hub parser is deliberately the first parser. Its normalized result is
|
|
142
|
+
// only an input to selection: required flow fields must still exist in the emitted
|
|
143
|
+
// object and pass the exact TypeBox envelope below.
|
|
144
|
+
const hubParsed = parseStructuredReturn(output);
|
|
145
|
+
const candidate = selectCandidate(name, output, hubParsed);
|
|
146
|
+
if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return { ok: false, errors: ["response: expected one complete Report JSON object"] };
|
|
147
|
+
const errors = schemaErrors(name, candidate);
|
|
148
|
+
if (errors.length) return { ok: false, errors };
|
|
149
|
+
const value = candidate as T;
|
|
150
|
+
if ((value as { status: string }).status === "fail") return { ok: false, errors: [`status: agent declared fail${(value as any).summary ? ` — ${(value as any).summary}` : ""}`] };
|
|
151
|
+
return { ok: true, value, errors: [] };
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
export function correctionPrompt(errors: string[]): string {
|
|
155
|
+
return `Your previous response failed validation:\n${errors.map(error => `- ${error}`).join("\n")}\nFix these problems, then re-emit ONLY your Report JSON.`;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
export async function parseWithCorrections<T>(name: EnvelopeName, initialOutput: string, correct: (prompt: string, attempt: number) => Promise<string>, onInvalid?: (attempt: number, errors: string[]) => void): Promise<T> {
|
|
159
|
+
let output = initialOutput;
|
|
160
|
+
for (let attempt = 0; attempt <= JSON_FIX_ATTEMPTS; attempt++) {
|
|
161
|
+
const result = validateEnvelope<T>(name, output);
|
|
162
|
+
if (result.ok) return result.value!;
|
|
163
|
+
onInvalid?.(attempt, result.errors);
|
|
164
|
+
if (result.errors.some(error => error.startsWith("status: agent declared fail"))) throw Object.assign(new Error(result.errors[0]), { terminal: true });
|
|
165
|
+
if (attempt === JSON_FIX_ATTEMPTS) throw Object.assign(new Error(`${name} envelope invalid after ${attempt + 1} attempts: ${result.errors.join("; ")}`), { terminal: true });
|
|
166
|
+
output = await correct(correctionPrompt(result.errors), attempt + 1);
|
|
167
|
+
}
|
|
168
|
+
throw new Error(`${name} envelope validation exhausted`);
|
|
169
|
+
}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { statSync, readFileSync } from "node:fs";
|
|
2
|
+
import { isAbsolute, resolve } from "node:path";
|
|
3
|
+
import type { Run } from "./run.ts";
|
|
4
|
+
import { executeQuality } from "./quality.ts";
|
|
5
|
+
|
|
6
|
+
export interface GateCheck { item: string; ok: boolean; note: string }
|
|
7
|
+
export class GateReport {
|
|
8
|
+
readonly gate: string;
|
|
9
|
+
readonly checks: GateCheck[] = [];
|
|
10
|
+
constructor(gate: string) { this.gate = gate; }
|
|
11
|
+
check(item: string, ok: boolean, note: string): this { this.checks.push({ item, ok, note }); return this; }
|
|
12
|
+
get ok(): boolean { return this.checks.length > 0 && this.checks.every(check => check.ok); }
|
|
13
|
+
failures(): GateCheck[] { return this.checks.filter(check => !check.ok); }
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export type Gate<T = any> = (envelope: T, run: Run) => GateReport | Promise<GateReport>;
|
|
17
|
+
|
|
18
|
+
function artifactPath(path: string, run: Run): string { return isAbsolute(path) ? path : resolve(run.trace.cwd, path); }
|
|
19
|
+
|
|
20
|
+
export const artifactsExist: Gate<{ artifacts?: string[] }> = (envelope, run) => {
|
|
21
|
+
const report = new GateReport("artifactsExist");
|
|
22
|
+
for (const item of envelope.artifacts ?? []) {
|
|
23
|
+
try { const stat = statSync(artifactPath(item, run)); report.check(item, true, `${stat.size} bytes`); }
|
|
24
|
+
catch { report.check(item, false, "declared artifact does not exist"); }
|
|
25
|
+
}
|
|
26
|
+
return envelope.artifacts?.length ? report : report.check("artifacts", true, "no artifacts declared");
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
export const filesNonEmpty: Gate<{ artifacts?: string[] }> = (envelope, run) => {
|
|
30
|
+
const report = new GateReport("filesNonEmpty");
|
|
31
|
+
for (const item of envelope.artifacts ?? []) {
|
|
32
|
+
try { const size = statSync(artifactPath(item, run)).size; report.check(item, size > 0, `${size} bytes`); }
|
|
33
|
+
catch { report.check(item, false, "file cannot be read"); }
|
|
34
|
+
}
|
|
35
|
+
return envelope.artifacts?.length ? report : report.check("artifacts", true, "no artifacts declared");
|
|
36
|
+
};
|
|
37
|
+
|
|
38
|
+
export const jsonParses: Gate<{ artifacts?: string[] }> = (envelope, run) => {
|
|
39
|
+
const report = new GateReport("jsonParses");
|
|
40
|
+
const items = (envelope.artifacts ?? []).filter(item => item.toLowerCase().endsWith(".json"));
|
|
41
|
+
for (const item of items) {
|
|
42
|
+
try { JSON.parse(readFileSync(artifactPath(item, run), "utf8")); report.check(item, true, "JSON.parse succeeded"); }
|
|
43
|
+
catch (error) { report.check(item, false, error instanceof Error ? error.message : String(error)); }
|
|
44
|
+
}
|
|
45
|
+
return items.length ? report : report.check("json artifacts", true, "no JSON artifacts declared");
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
export const diffMatchesClaims: Gate<{ changed_files?: string[] }> = (envelope, run) => {
|
|
49
|
+
const report = new GateReport("diffMatchesClaims");
|
|
50
|
+
for (const item of envelope.changed_files ?? []) {
|
|
51
|
+
try { const stat = statSync(artifactPath(item, run)); report.check(item, true, `${stat.size} bytes on disk`); }
|
|
52
|
+
catch { report.check(item, false, "claimed changed file does not exist"); }
|
|
53
|
+
}
|
|
54
|
+
return envelope.changed_files?.length ? report : report.check("changed_files", true, "no changed files claimed");
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
export function testsPass(argv: string[], options: { cwd?: string; timeoutSeconds?: number } = {}): Gate {
|
|
58
|
+
return async (_envelope, run) => {
|
|
59
|
+
const logPath = resolve(run.trace.directory, `gate-tests-${Date.now()}.log`);
|
|
60
|
+
const result = await executeQuality(argv, { cwd: options.cwd ?? run.trace.cwd, logPath, timeoutSeconds: options.timeoutSeconds, signal: run.signal });
|
|
61
|
+
const evidence = result.passed ? `exit 0; ${logPath}` : `${(result.stderr || result.stdout).slice(-4000)}\n${logPath}`;
|
|
62
|
+
return new GateReport("testsPass").check(argv.join(" "), result.passed, evidence);
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export const verdictConsistent: Gate<{ approved?: boolean; assertions_failed?: unknown[]; assertions_unproven?: unknown[]; open_risks?: unknown[]; requires_user_decision?: unknown[] }> = envelope => {
|
|
67
|
+
const report = new GateReport("verdictConsistent");
|
|
68
|
+
const failed = envelope.assertions_failed ?? [];
|
|
69
|
+
const unproven = envelope.assertions_unproven ?? [];
|
|
70
|
+
const decisions = envelope.requires_user_decision ?? [];
|
|
71
|
+
const problems = [...failed, ...unproven, ...(envelope.open_risks ?? []), ...decisions];
|
|
72
|
+
report.check("approved vs failed assertions", !envelope.approved || failed.length === 0, envelope.approved && failed.length ? "approved verdict has blocking failed assertions" : "consistent");
|
|
73
|
+
report.check("approved vs unresolved work", !envelope.approved || (unproven.length === 0 && decisions.length === 0), envelope.approved && (unproven.length || decisions.length) ? "approved verdict has unresolved assertions or decisions" : "consistent");
|
|
74
|
+
report.check("rejection names a problem", envelope.approved !== false || problems.length > 0, envelope.approved === false && problems.length === 0 ? "rejected verdict names no problem" : "consistent");
|
|
75
|
+
return report;
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
export function gateCorrectionPrompt(reports: GateReport[]): string {
|
|
79
|
+
const failures = reports.flatMap(report => report.failures().map(check => `- ${report.gate} / ${check.item}: ${check.note}`));
|
|
80
|
+
return `Your previous work failed executable gates:\n${failures.join("\n")}\nCorrect the work in this same session, then re-emit ONLY your Report JSON.`;
|
|
81
|
+
}
|