@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
|
@@ -26,7 +26,7 @@ const { spawnPiAgentWithModelFallback } = await import(spawnModulePath) as { spa
|
|
|
26
26
|
import { envelopePrompt, parseWithCorrections, type EnvelopeName } from "./envelopes.ts";
|
|
27
27
|
import { gateCorrectionPrompt, type Gate, type GateReport } from "./gates.ts";
|
|
28
28
|
import { enforce, snapshot, type PermissionPolicy } from "./permissions.ts";
|
|
29
|
-
import type
|
|
29
|
+
import { resolvePhaseModel, resolvePhaseThinking, type PersonaDefinition } from "./personas.ts";
|
|
30
30
|
import type { Run } from "./run.ts";
|
|
31
31
|
|
|
32
32
|
export type SpawnAgent = SpawnFallback;
|
|
@@ -35,6 +35,18 @@ export interface AgentPhaseOptions<T = unknown> {
|
|
|
35
35
|
spawn?: SpawnAgent; modelLookup?: (provider: string, modelId: string) => unknown; contextWindow?: number;
|
|
36
36
|
toolWatchdogMs?: number; turnDeadlineMs?: number; rulesPaths?: string[]; docsPaths?: string[];
|
|
37
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("-");
|
|
38
50
|
}
|
|
39
51
|
|
|
40
52
|
interface SessionMeta { contextTokens: number }
|
|
@@ -45,7 +57,9 @@ function readMeta(path: string): SessionMeta {
|
|
|
45
57
|
export async function runAgentPhase<T = unknown>(options: AgentPhaseOptions<T>): Promise<T> {
|
|
46
58
|
const cwd = options.cwd ?? process.cwd();
|
|
47
59
|
const agentKey = options.persona.name.toLowerCase();
|
|
48
|
-
const
|
|
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));
|
|
49
63
|
mkdirSync(directory, { recursive: true });
|
|
50
64
|
const sessionFile = resolve(directory, "session.json");
|
|
51
65
|
const metaFile = resolve(directory, "session-meta.json");
|
|
@@ -70,7 +84,7 @@ export async function runAgentPhase<T = unknown>(options: AgentPhaseOptions<T>):
|
|
|
70
84
|
const invoke = async (prompt: string): Promise<string> => {
|
|
71
85
|
runNumber++;
|
|
72
86
|
const replacement = nativeSpecialistSystemPrompt({ manifest, userLanguage: "English", agentKey, runNumber });
|
|
73
|
-
const window = resolveContextWindow(
|
|
87
|
+
const window = resolveContextWindow(model, { lookup: options.modelLookup, fallbackWindow: options.contextWindow ?? Number(process.env.AGENT_FLEET_CONTEXT_WINDOW ?? 0) });
|
|
74
88
|
let resume = existsSync(sessionFile);
|
|
75
89
|
const overflow = resume ? shouldRecycleBeforeSpawn({ priorTokens: meta.contextTokens, promptTokens: estimatePromptTokens(prompt) + estimatePromptTokens(replacement), window: window.window }) : null;
|
|
76
90
|
if (overflow) {
|
|
@@ -81,7 +95,7 @@ export async function runAgentPhase<T = unknown>(options: AgentPhaseOptions<T>):
|
|
|
81
95
|
}
|
|
82
96
|
let measuredTokens = meta.contextTokens;
|
|
83
97
|
const result = await spawnAgent({
|
|
84
|
-
model
|
|
98
|
+
model, tools: options.persona.tools, thinking,
|
|
85
99
|
systemPrompt: replacement, noSkills: true, noContextFiles: true, sessionFile, resume, prompt, cwd,
|
|
86
100
|
extensions: [".pi/harnesses/damage-control-continue/index.ts"], detached: true, signal: options.run.signal,
|
|
87
101
|
toolWatchdog: { timeoutMs: options.toolWatchdogMs ?? 120_000 }, turnDeadlineMs: options.turnDeadlineMs ?? 1_200_000,
|
|
@@ -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
|
+
}
|
|
@@ -17,10 +17,27 @@ export const ReviewEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
|
|
|
17
17
|
})]);
|
|
18
18
|
export const ScoutEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ findings: StringArray })]);
|
|
19
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
|
+
})]);
|
|
20
34
|
|
|
21
|
-
export const ENVELOPES = { plan: PlanEnvelope, build: BuildEnvelope, review: ReviewEnvelope, scout: ScoutEnvelope, document: DocumentEnvelope } as const;
|
|
35
|
+
export const ENVELOPES = { plan: PlanEnvelope, build: BuildEnvelope, review: ReviewEnvelope, scout: ScoutEnvelope, document: DocumentEnvelope, poll: PollEnvelope, debate: DebateEnvelope, merge: MergeEnvelope } as const;
|
|
22
36
|
export type EnvelopeName = keyof typeof ENVELOPES;
|
|
23
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>;
|
|
24
41
|
export const JSON_FIX_ATTEMPTS = 2;
|
|
25
42
|
|
|
26
43
|
export const ENVELOPE_EXAMPLES: Record<EnvelopeName, Record<string, unknown>> = {
|
|
@@ -29,6 +46,9 @@ export const ENVELOPE_EXAMPLES: Record<EnvelopeName, Record<string, unknown>> =
|
|
|
29
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: [] },
|
|
30
47
|
scout: { status: "success", summary: "Scout complete", artifacts: [], notes_for_next_agent: "", findings: ["X lives in src/x.ts"] },
|
|
31
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." },
|
|
32
52
|
};
|
|
33
53
|
|
|
34
54
|
export function envelopePrompt(name: EnvelopeName): string {
|
|
@@ -75,18 +95,26 @@ const ENVELOPE_FIELDS: Record<EnvelopeName, string[]> = {
|
|
|
75
95
|
review: [...BASE_FIELDS, "approved", "assertions_proven", "assertions_unproven", "assertions_failed", "open_risks", "requires_user_decision"],
|
|
76
96
|
scout: [...BASE_FIELDS, "findings"],
|
|
77
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"],
|
|
78
101
|
};
|
|
79
102
|
|
|
80
103
|
export interface EnvelopeValidation<T = unknown> { ok: boolean; value?: T; errors: string[] }
|
|
81
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
|
+
|
|
82
110
|
function schemaErrors(name: EnvelopeName, candidate: unknown): string[] {
|
|
83
111
|
if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return ["response: expected one complete Report JSON object"];
|
|
84
112
|
const schema: TSchema = ENVELOPES[name];
|
|
85
113
|
const typeErrors = [...Value.Errors(schema, candidate)];
|
|
86
|
-
const specificErrors = typeErrors.filter(error => error.path);
|
|
114
|
+
const specificErrors = typeErrors.filter(error => typeof error.path === "string" && error.path.length > 0);
|
|
87
115
|
const errors = [...new Set((specificErrors.length ? specificErrors : typeErrors).map(error => {
|
|
88
|
-
const field = error
|
|
89
|
-
return error.type === 45 || /required/i.test(error.message) ? `missing required field: ${field}` : `${field}: ${error.message}`;
|
|
116
|
+
const field = envelopeErrorField(error);
|
|
117
|
+
return error.type === 45 || /required/i.test(String(error.message ?? "")) ? `missing required field: ${field}` : `${field}: ${error.message}`;
|
|
90
118
|
}))];
|
|
91
119
|
const allowed = new Set(ENVELOPE_FIELDS[name]);
|
|
92
120
|
for (const field of Object.keys(candidate)) if (!allowed.has(field)) errors.push(`${field}: unexpected field for ${name} envelope`);
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { mkdirSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { runAgentPhase, type SpawnAgent } from "./agent-phase.ts";
|
|
3
|
+
import type { MergeReport } from "./envelopes.ts";
|
|
4
|
+
import type { PermissionPolicy } from "./permissions.ts";
|
|
5
|
+
import type { PersonaDefinition } from "./personas.ts";
|
|
6
|
+
import type { Run } from "./run.ts";
|
|
7
|
+
import { integratorVoice, resolvePanel, type Voice } from "./voices.ts";
|
|
8
|
+
import { POLL_PERMISSION_POLICY, POLL_TOOLS, pollArtifactDir, type PollVoiceResult } from "./poll.ts";
|
|
9
|
+
import { withWriterLease, writerLeaseFile, WriterLeaseHeldError } from "./writer-lease.ts";
|
|
10
|
+
|
|
11
|
+
export const MERGE_APPLY_TOOLS = "read,grep,find,ls,edit,write";
|
|
12
|
+
export const MERGE_APPLY_PERMISSION_POLICY: PermissionPolicy = { writes: ["**"] };
|
|
13
|
+
|
|
14
|
+
export class MergeUnavailableError extends Error {
|
|
15
|
+
constructor(panel: string) {
|
|
16
|
+
super(`Merge is unavailable: panel "${panel}" has no voice with integrator: true.`);
|
|
17
|
+
this.name = "MergeUnavailableError";
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export interface MergeOptions {
|
|
22
|
+
run: Run; cwd: string; persona: PersonaDefinition; panel: string; task: string; opinions: PollVoiceResult[];
|
|
23
|
+
voices?: Voice[]; spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<MergeReport>;
|
|
24
|
+
apply?: boolean; command?: string;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export function mergedPath(cwd: string, runId: string): string {
|
|
28
|
+
return `${pollArtifactDir(cwd, runId)}/merged.md`;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function mergeTask(question: string, opinions: PollVoiceResult[], apply = false): string {
|
|
32
|
+
const blocks = opinions.map(opinion => {
|
|
33
|
+
const body = opinion.ok ? `\`\`\`json\n${JSON.stringify(opinion.report, null, 2)}\n\`\`\`` : `FAILED: ${opinion.reason}`;
|
|
34
|
+
return `## ${opinion.voice.name} (${opinion.voice.model})\n\n${body}`;
|
|
35
|
+
});
|
|
36
|
+
return [
|
|
37
|
+
"Merge the independent poll opinions below into one attributed recommendation.",
|
|
38
|
+
"Do not invent claims that no voice made. Every consensus, divergence, minority, and rejected item must name a voice.",
|
|
39
|
+
"A minority opinion must not be dropped silently; rejecting it requires a reason.",
|
|
40
|
+
apply ? "You have write tools. Apply the recommendation to the working tree; stay inside the writes policy." : "You are read-only. Do not modify the working tree.",
|
|
41
|
+
"",
|
|
42
|
+
`Question:\n${question}`,
|
|
43
|
+
"",
|
|
44
|
+
"Opinions:",
|
|
45
|
+
...blocks,
|
|
46
|
+
].join("\n");
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function writeMerged(cwd: string, runId: string, integrator: Voice, report: MergeReport): string {
|
|
50
|
+
const directory = pollArtifactDir(cwd, runId);
|
|
51
|
+
mkdirSync(directory, { recursive: true });
|
|
52
|
+
const path = mergedPath(cwd, runId);
|
|
53
|
+
writeFileSync(path, `# Merge (${integrator.name})\n\n- model: ${integrator.model}\n\n\`\`\`json\n${JSON.stringify(report, null, 2)}\n\`\`\`\n`, "utf8");
|
|
54
|
+
return path;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export async function runMerge(options: MergeOptions): Promise<{ report: MergeReport; integrator: Voice; path: string }> {
|
|
58
|
+
const voices = options.voices ?? resolvePanel(options.panel, options.cwd);
|
|
59
|
+
const integrator = integratorVoice(voices);
|
|
60
|
+
if (!integrator) throw new MergeUnavailableError(options.panel);
|
|
61
|
+
const apply = Boolean(options.apply);
|
|
62
|
+
const agent = options.runAgent ?? runAgentPhase<MergeReport>;
|
|
63
|
+
const spawnIntegrator = () => agent({
|
|
64
|
+
run: options.run,
|
|
65
|
+
persona: {
|
|
66
|
+
...options.persona,
|
|
67
|
+
tools: apply ? MERGE_APPLY_TOOLS : POLL_TOOLS,
|
|
68
|
+
writes: apply ? MERGE_APPLY_PERMISSION_POLICY.writes : [],
|
|
69
|
+
},
|
|
70
|
+
task: mergeTask(options.task, options.opinions, apply),
|
|
71
|
+
envelope: "merge", cwd: options.cwd, spawn: options.spawn,
|
|
72
|
+
model: integrator.model, thinking: integrator.thinking,
|
|
73
|
+
sessionTag: "merge",
|
|
74
|
+
permissionPolicy: apply ? MERGE_APPLY_PERMISSION_POLICY : POLL_PERMISSION_POLICY,
|
|
75
|
+
});
|
|
76
|
+
if (!apply) {
|
|
77
|
+
const report = await spawnIntegrator();
|
|
78
|
+
return { report, integrator, path: writeMerged(options.cwd, options.run.trace.runId, integrator, report) };
|
|
79
|
+
}
|
|
80
|
+
const command = options.command ?? (options.run.command.join(" ") || "flow poll --apply");
|
|
81
|
+
try {
|
|
82
|
+
const merged = await withWriterLease({ cwd: options.cwd, owner: `merge:${integrator.name}`, command }, async lease => {
|
|
83
|
+
options.run.trace.write("log", { phase: "merge", message: "writer lease acquired", lease: lease.file, owner: lease.record.owner, ownerCommand: lease.record.command });
|
|
84
|
+
const report = await spawnIntegrator();
|
|
85
|
+
return { report, integrator, path: writeMerged(options.cwd, options.run.trace.runId, integrator, report) };
|
|
86
|
+
});
|
|
87
|
+
options.run.trace.write("log", { phase: "merge", message: "writer lease released", lease: writerLeaseFile(options.cwd) });
|
|
88
|
+
return merged;
|
|
89
|
+
} catch (error) {
|
|
90
|
+
if (error instanceof WriterLeaseHeldError) {
|
|
91
|
+
options.run.trace.write("error", { phase: "merge", message: error.message, lease: error.file, owner: error.record.owner, ownerCommand: error.record.command });
|
|
92
|
+
}
|
|
93
|
+
throw error;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
|
|
3
|
+
export type VisibilityCheckName = "registered" | "auth" | "child-visible";
|
|
4
|
+
export interface ModelCheck {
|
|
5
|
+
model: string;
|
|
6
|
+
ok: boolean;
|
|
7
|
+
failed: VisibilityCheckName[];
|
|
8
|
+
reasons: string[];
|
|
9
|
+
}
|
|
10
|
+
export interface ChildVisibilityReport { models: ModelCheck[]; diagnostic?: string }
|
|
11
|
+
export interface ModelRegistryAuth {
|
|
12
|
+
isRegistered(model: string): boolean;
|
|
13
|
+
hasAuth(model: string): boolean;
|
|
14
|
+
}
|
|
15
|
+
export type ModelListing = { models?: string[]; diagnostic?: string };
|
|
16
|
+
export type ListModels = () => ModelListing;
|
|
17
|
+
|
|
18
|
+
let listingCache: ModelListing | undefined;
|
|
19
|
+
|
|
20
|
+
export function resetModelVisibilityCache(): void {
|
|
21
|
+
listingCache = undefined;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function parseListModelsOutput(text: string): string[] {
|
|
25
|
+
const cleaned = text.replace(/\u001B\[[0-9;]*m/g, "");
|
|
26
|
+
const lines = cleaned.split(/\r?\n/).map(line => line.trimEnd()).filter(line => line.trim());
|
|
27
|
+
if (lines.length === 0) return [];
|
|
28
|
+
const models = new Set<string>();
|
|
29
|
+
for (const line of lines.slice(1)) {
|
|
30
|
+
const parts = line.trim().split(/\s+/);
|
|
31
|
+
if (parts.length < 2 || (parts[0] === "provider" && parts[1] === "model")) continue;
|
|
32
|
+
models.add(`${parts[0]}/${parts[1]}`);
|
|
33
|
+
}
|
|
34
|
+
return [...models];
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export function checkChildVisibility(models: string[], listModels?: ListModels): ChildVisibilityReport {
|
|
38
|
+
const listing = loadListing(listModels);
|
|
39
|
+
if (listing.diagnostic) {
|
|
40
|
+
return {
|
|
41
|
+
diagnostic: listing.diagnostic,
|
|
42
|
+
models: models.map(model => ({
|
|
43
|
+
model, ok: false, failed: [],
|
|
44
|
+
reasons: [`${model}: child-visible check not performed — ${listing.diagnostic}`],
|
|
45
|
+
})),
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
const visible = new Set(listing.models ?? []);
|
|
49
|
+
return {
|
|
50
|
+
models: models.map(model => visible.has(model)
|
|
51
|
+
? { model, ok: true, failed: [], reasons: [] }
|
|
52
|
+
: {
|
|
53
|
+
model, ok: false, failed: ["child-visible"],
|
|
54
|
+
reasons: [`${model}: child-visible check failed — not listed by pi --no-extensions --list-models`],
|
|
55
|
+
}),
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export function checkRegistryAuth(models: string[], registry: ModelRegistryAuth): ModelCheck[] {
|
|
60
|
+
return models.map(model => {
|
|
61
|
+
if (!registry.isRegistered(model)) {
|
|
62
|
+
return {
|
|
63
|
+
model, ok: false, failed: ["registered"],
|
|
64
|
+
reasons: [`${model}: registered check failed — model is not in the pi model registry`],
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
if (!registry.hasAuth(model)) {
|
|
68
|
+
return {
|
|
69
|
+
model, ok: false, failed: ["auth"],
|
|
70
|
+
reasons: [`${model}: auth check failed — no configured credentials`],
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
return { model, ok: true, failed: [], reasons: [] };
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function loadListing(listModels?: ListModels): ModelListing {
|
|
78
|
+
if (listingCache) return listingCache;
|
|
79
|
+
try { listingCache = listModels ? listModels() : defaultListModels(); }
|
|
80
|
+
catch (error) { listingCache = { diagnostic: error instanceof Error ? error.message : String(error) }; }
|
|
81
|
+
return listingCache;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function defaultListModels(): ModelListing {
|
|
85
|
+
const result = spawnSync("pi", ["--no-extensions", "--list-models"], { encoding: "utf8", timeout: 15_000 });
|
|
86
|
+
if (result.error) return { diagnostic: `pi --no-extensions --list-models failed: ${result.error.message}` };
|
|
87
|
+
if (result.status !== 0) {
|
|
88
|
+
const detail = (result.stderr || result.stdout || `exit ${result.status}`).trim();
|
|
89
|
+
return { diagnostic: `pi --no-extensions --list-models failed: ${detail}` };
|
|
90
|
+
}
|
|
91
|
+
return { models: parseListModelsOutput(result.stdout) };
|
|
92
|
+
}
|
|
@@ -42,3 +42,13 @@ export function resolvePersona(name: string, cwd = process.cwd()): PersonaDefini
|
|
|
42
42
|
if (!persona.model) throw new StartRefusedError(`Flow start refused: persona "${name}" declares no model.`);
|
|
43
43
|
return persona;
|
|
44
44
|
}
|
|
45
|
+
|
|
46
|
+
export function resolvePhaseModel(persona: PersonaDefinition, override?: string): string {
|
|
47
|
+
const model = override || persona.model;
|
|
48
|
+
if (!model) throw new StartRefusedError(`Flow start refused: persona "${persona.name}" declares no model.`);
|
|
49
|
+
return model;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function resolvePhaseThinking(persona: PersonaDefinition, override?: string): string {
|
|
53
|
+
return override ?? persona.thinking ?? "medium";
|
|
54
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
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 { PollReport } from "./envelopes.ts";
|
|
5
|
+
import type { PermissionPolicy } from "./permissions.ts";
|
|
6
|
+
import type { PersonaDefinition } from "./personas.ts";
|
|
7
|
+
import type { Run } from "./run.ts";
|
|
8
|
+
import { resolvePanel, type Voice } from "./voices.ts";
|
|
9
|
+
|
|
10
|
+
export const POLL_TOOLS = "read,grep,find,ls";
|
|
11
|
+
export const POLL_PERMISSION_POLICY: PermissionPolicy = { writes: [] };
|
|
12
|
+
export const POLL_ARTIFACTS_REL = ".pi/agent-sessions/artifacts/polls";
|
|
13
|
+
|
|
14
|
+
export interface PollVoiceSuccess { ok: true; voice: Voice; report: PollReport; path: string }
|
|
15
|
+
export interface PollVoiceFailure { ok: false; voice: Voice; reason: string; path: string }
|
|
16
|
+
export type PollVoiceResult = PollVoiceSuccess | PollVoiceFailure;
|
|
17
|
+
export interface PollResult { panel: string; directory: string; results: PollVoiceResult[] }
|
|
18
|
+
export interface PollVoiceOptions {
|
|
19
|
+
run: Run; cwd: string; persona: PersonaDefinition; voice: Voice; task: string; panel: string;
|
|
20
|
+
spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<PollReport>;
|
|
21
|
+
}
|
|
22
|
+
export interface PollOptions {
|
|
23
|
+
run: Run; cwd: string; persona: PersonaDefinition; panel: string; task: string; voices?: Voice[];
|
|
24
|
+
spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<PollReport>;
|
|
25
|
+
onVoice?: (result: PollVoiceResult) => void | Promise<void>;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function pollArtifactDir(cwd: string, runId: string): string {
|
|
29
|
+
return resolve(cwd, POLL_ARTIFACTS_REL, runId);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function pollVoicePath(cwd: string, runId: string, voiceName: string): string {
|
|
33
|
+
return resolve(pollArtifactDir(cwd, runId), `${voiceName}.md`);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export function formatVoiceArtifact(result: PollVoiceResult): string {
|
|
37
|
+
const header = [`# ${result.voice.name}`, "", `- model: ${result.voice.model}`, `- thinking: ${result.voice.thinking ?? "medium"}`];
|
|
38
|
+
if (!result.ok) return `${header.join("\n")}\n- status: failed\n- reason: ${result.reason}\n`;
|
|
39
|
+
return `${header.join("\n")}\n- status: success\n\n## Report\n\n\`\`\`json\n${JSON.stringify(result.report, null, 2)}\n\`\`\`\n`;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export function writeVoiceArtifact(cwd: string, runId: string, result: PollVoiceResult): string {
|
|
43
|
+
const directory = pollArtifactDir(cwd, runId);
|
|
44
|
+
mkdirSync(directory, { recursive: true });
|
|
45
|
+
const path = pollVoicePath(cwd, runId, result.voice.name);
|
|
46
|
+
writeFileSync(path, formatVoiceArtifact(result), "utf8");
|
|
47
|
+
return path;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function readOnlyPersona(persona: PersonaDefinition): PersonaDefinition {
|
|
51
|
+
return { ...persona, tools: POLL_TOOLS, writes: [] };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export async function pollVoice(options: PollVoiceOptions): Promise<PollVoiceResult> {
|
|
55
|
+
const path = pollVoicePath(options.cwd, options.run.trace.runId, options.voice.name);
|
|
56
|
+
const agent = options.runAgent ?? runAgentPhase<PollReport>;
|
|
57
|
+
try {
|
|
58
|
+
const report = await agent({
|
|
59
|
+
run: options.run, persona: readOnlyPersona(options.persona), task: options.task, envelope: "poll",
|
|
60
|
+
cwd: options.cwd, spawn: options.spawn, model: options.voice.model, thinking: options.voice.thinking,
|
|
61
|
+
sessionTag: options.voice.name, permissionPolicy: POLL_PERMISSION_POLICY,
|
|
62
|
+
});
|
|
63
|
+
const result: PollVoiceSuccess = { ok: true, voice: options.voice, report, path };
|
|
64
|
+
result.path = writeVoiceArtifact(options.cwd, options.run.trace.runId, result);
|
|
65
|
+
return result;
|
|
66
|
+
} catch (error) {
|
|
67
|
+
const result: PollVoiceFailure = { ok: false, voice: options.voice, reason: error instanceof Error ? error.message : String(error), path };
|
|
68
|
+
result.path = writeVoiceArtifact(options.cwd, options.run.trace.runId, result);
|
|
69
|
+
return result;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export async function runPoll(options: PollOptions): Promise<PollResult> {
|
|
74
|
+
const voices = options.voices ?? resolvePanel(options.panel, options.cwd);
|
|
75
|
+
const results = await Promise.all(voices.map(async voice => {
|
|
76
|
+
const result = await pollVoice({ ...options, voice });
|
|
77
|
+
try { await options.onVoice?.(result); } catch { /* progress is best-effort */ }
|
|
78
|
+
return result;
|
|
79
|
+
}));
|
|
80
|
+
const succeeded = results.filter(result => result.ok);
|
|
81
|
+
if (succeeded.length < 2) {
|
|
82
|
+
const failures = results.filter(result => !result.ok).map(result => `${result.voice.name}: ${result.reason}`).join("; ");
|
|
83
|
+
throw new Error(`Poll failed: ${succeeded.length} of ${voices.length} voices succeeded${failures ? ` (${failures})` : ""}`);
|
|
84
|
+
}
|
|
85
|
+
return { panel: options.panel, directory: pollArtifactDir(options.cwd, options.run.trace.runId), results };
|
|
86
|
+
}
|
|
@@ -29,6 +29,7 @@ export class PhaseContext {
|
|
|
29
29
|
|
|
30
30
|
export class Run {
|
|
31
31
|
readonly trace: FlowTrace;
|
|
32
|
+
readonly command: string[];
|
|
32
33
|
readonly repositoryBaseline?: PermissionSnapshot;
|
|
33
34
|
private finished = false;
|
|
34
35
|
private phaseFailed = false;
|
|
@@ -38,6 +39,7 @@ export class Run {
|
|
|
38
39
|
|
|
39
40
|
constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; repositoryBaseline?: PermissionSnapshot } = {}) {
|
|
40
41
|
this.trace = options.trace ?? new FlowTrace(options);
|
|
42
|
+
this.command = options.command ?? [];
|
|
41
43
|
this.repositoryBaseline = options.repositoryBaseline;
|
|
42
44
|
}
|
|
43
45
|
|