@chankov/agent-fleet 2.0.5 → 2.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/harnesses/agent-hub/README.md +74 -10
- package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.pi/harnesses/agent-hub/artifacts.js +1 -1
- package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
- package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
- package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
- package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
- package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
- package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
- package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +22 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +25 -11
- package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
- package/.pi/harnesses/agent-hub/index.ts +79 -43
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
- package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
- package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
- package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
- package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
- package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
- package/.pi/harnesses/agent-hub/research/runtime.ts +17 -2
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +14 -6
- package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
- package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +65 -24
- package/.pi/harnesses/agent-hub/types.ts +1 -0
- package/.pi/harnesses/agent-hub/ui/pool.ts +6 -1
- package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
- package/.pi/harnesses/ask-user-remote/README.md +8 -2
- package/.pi/harnesses/ask-user-remote/index.ts +40 -14
- package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
- package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.pi/harnesses/coms/README.md +1 -1
- package/.pi/harnesses/coms/index.ts +7 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
- package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
- package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.6/.pi/extensions/package.json +9 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.6/.version +1 -0
- package/.versions/2.0.6/agents/architect.md +25 -0
- package/.versions/2.0.6/agents/bowser.md +28 -0
- package/.versions/2.0.6/agents/builder.md +56 -0
- package/.versions/2.0.6/agents/code-reviewer.md +210 -0
- package/.versions/2.0.6/agents/deep-researcher.md +33 -0
- package/.versions/2.0.6/agents/documenter.md +23 -0
- package/.versions/2.0.6/agents/orchestrator.md +23 -0
- package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.6/agents/planner.md +106 -0
- package/.versions/2.0.6/agents/releaser.md +25 -0
- package/.versions/2.0.6/agents/researcher.md +31 -0
- package/.versions/2.0.6/agents/security-auditor.md +168 -0
- package/.versions/2.0.6/agents/test-engineer.md +154 -0
- package/.versions/2.0.6/agents/web-debugger.md +44 -0
- package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
- package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
- package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
- package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.6/docs/getting-started.md +126 -0
- package/.versions/2.0.6/docs/npm-install.md +301 -0
- package/.versions/2.0.6/docs/pi-extensions.md +446 -0
- package/.versions/2.0.6/docs/pi-setup.md +76 -0
- package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.6/hermes/README.md +347 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.6/install-manifest.json +2924 -0
- package/.versions/2.0.6/justfile +247 -0
- package/.versions/2.0.6/manifest-meta.json +976 -0
- package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.6/references/communication-contract.md +26 -0
- package/.versions/2.0.6/references/definition-of-done.md +67 -0
- package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.6/references/observability-checklist.md +91 -0
- package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.6/references/performance-checklist.md +153 -0
- package/.versions/2.0.6/references/prompting-patterns.md +380 -0
- package/.versions/2.0.6/references/security-checklist.md +179 -0
- package/.versions/2.0.6/references/testing-patterns.md +236 -0
- package/.versions/2.0.6/references/workflow-authoring.md +304 -0
- package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
- package/.versions/2.0.6/scripts/fleet.ts +216 -0
- package/.versions/2.0.6/scripts/flow.ts +137 -0
- package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.6/scripts/package-lock.json +35 -0
- package/.versions/2.0.6/scripts/package.json +9 -0
- package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
- package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.6/scripts/team-up.ts +378 -0
- package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +23 -0
- package/README.md +12 -14
- package/bin/catalog/harness-runtime-closure.json +1 -6
- package/bin/lib/desired.js +2 -2
- package/bin/lib/features.js +8 -1
- package/bin/snapshot-version.js +1 -2
- package/codex/fleet-session-client/SKILL.md +34 -0
- package/codex/fleet-session-client.zip +0 -0
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/MIGRATION-agent-fleet.md +2 -2
- package/docs/assets/branding/README.md +33 -0
- package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
- package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
- package/docs/codex-session-bridge.md +219 -0
- package/docs/coms-hermes-bridge.md +4 -5
- package/docs/getting-started.md +2 -0
- package/docs/npm-install.md +3 -1
- package/docs/pi-setup.md +2 -0
- package/hermes/README.md +1 -1
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
- package/install-manifest.json +54 -72
- package/justfile +0 -42
- package/manifest-meta.json +50 -43
- package/package.json +10 -7
- package/scripts/coms-cli.ts +2 -61
- package/scripts/fleet-codex-client.ts +69 -0
- package/scripts/fleet-codex-read.py +146 -0
- package/scripts/fleet.ts +0 -6
- package/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/scripts/lib/fleet-codex-operations.ts +190 -0
- package/scripts/lib/fleet-codex-session.ts +166 -0
- package/scripts/lib/fleet-codex-transport.ts +124 -0
- package/scripts/lib/fleet-command.ts +5 -23
- package/scripts/lib/team-project.ts +15 -50
- package/scripts/team-up.ts +6 -34
- package/codex/CONDUCTOR.md +0 -148
- package/docs/codex-remote-conductor.md +0 -170
- package/scripts/codex-conductor.ts +0 -41
- package/scripts/codex-remote-control.ts +0 -167
- package/scripts/lib/codex-conductor.ts +0 -88
- package/scripts/lib/codex-remote-control.ts +0 -482
- package/systemd/user/agent-fleet-codex-remote-control.service.in +0 -23
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { mkdirSync } from "node:fs";
|
|
1
3
|
import type { ChildProcess } from "child_process";
|
|
2
4
|
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
3
5
|
import type { Termination, spawnPiAgentWithModelFallback } from "../spawn.ts";
|
|
@@ -34,6 +36,9 @@ export interface ResearchAgentDef {
|
|
|
34
36
|
|
|
35
37
|
export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef> {
|
|
36
38
|
id: number;
|
|
39
|
+
dispatchId: string;
|
|
40
|
+
sessionPath: string;
|
|
41
|
+
evidenceDir: string;
|
|
37
42
|
def: TDef;
|
|
38
43
|
persona: boolean;
|
|
39
44
|
model: string;
|
|
@@ -55,6 +60,9 @@ export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef>
|
|
|
55
60
|
}
|
|
56
61
|
|
|
57
62
|
export interface ResearchResult {
|
|
63
|
+
dispatchId?: string;
|
|
64
|
+
evidencePath?: string;
|
|
65
|
+
transcriptPath?: string;
|
|
58
66
|
output: string;
|
|
59
67
|
exitCode: number;
|
|
60
68
|
elapsed: number;
|
|
@@ -120,7 +128,8 @@ export function parseResearchHandle(arg: string): number | null {
|
|
|
120
128
|
}
|
|
121
129
|
|
|
122
130
|
export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: ResearchRuntimeDeps<TDef>): ResearchRuntime<TDef> {
|
|
123
|
-
const
|
|
131
|
+
const paths = new Map<number, string>();
|
|
132
|
+
const sessionPath = (id: number) => { const path = paths.get(id); if (!path) throw new Error(`Unknown research handle r${id}`); return path; };
|
|
124
133
|
const finalized = new WeakSet<ResearchState<TDef>>();
|
|
125
134
|
const finalize = (state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome) => {
|
|
126
135
|
if (finalized.has(state)) return;
|
|
@@ -145,6 +154,7 @@ export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: Resea
|
|
|
145
154
|
return {
|
|
146
155
|
states: deps.getResearchStates,
|
|
147
156
|
reset() {
|
|
157
|
+
paths.clear();
|
|
148
158
|
deps.setResearchStates(new Map());
|
|
149
159
|
deps.setNextResearchId(1);
|
|
150
160
|
},
|
|
@@ -162,8 +172,13 @@ export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: Resea
|
|
|
162
172
|
createState(def, persona, model) {
|
|
163
173
|
const id = deps.getNextResearchId();
|
|
164
174
|
deps.setNextResearchId(id + 1);
|
|
175
|
+
const dispatchId = randomUUID();
|
|
176
|
+
const evidenceDir = safePathWithin(deps.hubState.getSessionDir(), "dispatches", dispatchId);
|
|
177
|
+
mkdirSync(evidenceDir, { recursive: true, mode: 0o700 });
|
|
178
|
+
const rawSession = safePathWithin(evidenceDir, "session.json");
|
|
179
|
+
paths.set(id, rawSession);
|
|
165
180
|
const state: ResearchState<TDef> = {
|
|
166
|
-
id, def, persona, model, status: "running", task: "", toolCount: 0, messageCount: 0,
|
|
181
|
+
id, dispatchId, evidenceDir, sessionPath: rawSession, def, persona, model, status: "running", task: "", toolCount: 0, messageCount: 0,
|
|
167
182
|
elapsed: 0, lastWork: "", contextPct: 0, contextTokens: 0, timeline: [],
|
|
168
183
|
};
|
|
169
184
|
deps.getResearchStates().set(id, state);
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { dirname } from "node:path";
|
|
2
|
+
import { beginExecutionEvidence, finishExecutionEvidence } from "../execution-evidence.ts";
|
|
1
3
|
import { profileFallback } from '../policy/profile-runtime.ts';
|
|
2
4
|
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
3
5
|
import { contextPct, resolveContextWindow } from "../context-window.js";
|
|
@@ -19,7 +21,7 @@ function completeOutput<TDef extends ResearchAgentDef>(state: ResearchState<TDef
|
|
|
19
21
|
output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
|
|
20
22
|
}
|
|
21
23
|
if (res.exitCode !== 0) {
|
|
22
|
-
const errText =
|
|
24
|
+
const errText = [res.assistantError, res.stderr].filter(Boolean).join("\n\n").trim();
|
|
23
25
|
const tail = errText.length > 1500 ? `...\n${errText.slice(-1500)}` : errText;
|
|
24
26
|
const errBlock = tail ? `\n\n[stderr]\n${tail}` : "";
|
|
25
27
|
output = output ? `${output}${errBlock}` : `Research helper r${state.id} exited with code ${res.exitCode} and produced no output.${errBlock}`;
|
|
@@ -33,14 +35,19 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
|
33
35
|
): Promise<ResearchResult> {
|
|
34
36
|
const startTime = Date.now();
|
|
35
37
|
let result: ResearchResult | undefined;
|
|
38
|
+
let diagnostics: object | null = null;
|
|
39
|
+
const transcriptPath = safePathWithin(state.evidenceDir, "transcript.jsonl");
|
|
40
|
+
|
|
36
41
|
const settle = (status: ResearchFinalizeOutcome["status"], historyStatus: ResearchFinalizeOutcome["historyStatus"], lastWork: string, settled: ResearchResult): ResearchResult => {
|
|
37
42
|
state.elapsed = settled.elapsed;
|
|
38
43
|
deps.finalize(state, { status, historyStatus, lastWork });
|
|
39
|
-
|
|
40
|
-
|
|
44
|
+
deps.flushTimelineStore(state);
|
|
45
|
+
result = finishExecutionEvidence(state.evidenceDir, { ...settled, dispatchId: state.dispatchId, transcriptPath, sessionPath: state.sessionPath, diagnostics });
|
|
46
|
+
return result;
|
|
41
47
|
};
|
|
42
48
|
|
|
43
49
|
try {
|
|
50
|
+
beginExecutionEvidence(dirname(dirname(state.evidenceDir)), state.dispatchId, { task: prompt, agent: state.def.name, modelRequested: state.model }, inputArtifacts);
|
|
44
51
|
if (!state.histEntry) state.histEntry = deps.executionHistory.start("research", `Research r${state.id}`);
|
|
45
52
|
|
|
46
53
|
const safety = deps.requireSafetyHarness(deps.getSafetyHarnessPath());
|
|
@@ -55,7 +62,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
|
55
62
|
state.killedByOperator = false;
|
|
56
63
|
deps.flushTimelineStore(state);
|
|
57
64
|
state.timeline = [];
|
|
58
|
-
state.transcriptStore = deps.createTranscriptStore(
|
|
65
|
+
state.transcriptStore = deps.createTranscriptStore(transcriptPath);
|
|
59
66
|
|
|
60
67
|
state.timer = setInterval(() => {
|
|
61
68
|
state.elapsed = Date.now() - startTime;
|
|
@@ -63,7 +70,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
|
63
70
|
}, 1000);
|
|
64
71
|
const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
|
|
65
72
|
const wantThinking = thinkingLevel !== "off";
|
|
66
|
-
const sessionPath =
|
|
73
|
+
const sessionPath = state.sessionPath;
|
|
67
74
|
const researchWindow = resolveContextWindow(state.model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
|
|
68
75
|
const fallbackCandidate = profileFallback(deps.substitutedModel(deps.fallbackModelFor(state.def, state.model)));
|
|
69
76
|
const fallback = fallbackCandidate === state.model ? undefined : fallbackCandidate;
|
|
@@ -116,6 +123,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
|
116
123
|
},
|
|
117
124
|
}, { midRun: isReadOnlyToolList(deps.researchTools) }));
|
|
118
125
|
|
|
126
|
+
diagnostics = { assistantError: res.assistantError ?? null, stderr: res.stderr, spawnError: res.spawnError ?? null, modelUsed: res.modelUsed ?? null, toolCallsStarted: res.toolCallsStarted ?? null, termination: res.termination ?? null, processExitCode: res.exitCode };
|
|
119
127
|
state.elapsed = Date.now() - startTime;
|
|
120
128
|
state.proc = undefined;
|
|
121
129
|
if (res.spawnError) {
|
|
@@ -127,7 +135,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
|
127
135
|
}
|
|
128
136
|
if (state.killedByOperator) {
|
|
129
137
|
state.killedByOperator = false;
|
|
130
|
-
return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode
|
|
138
|
+
return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode == null || res.exitCode === 0 ? 143 : res.exitCode, elapsed: state.elapsed });
|
|
131
139
|
}
|
|
132
140
|
|
|
133
141
|
const status = res.exitCode === 0 ? "done" : "error";
|
|
@@ -1,19 +1,47 @@
|
|
|
1
1
|
import { execFileSync } from "node:child_process";
|
|
2
|
+
import { createHash } from "node:crypto";
|
|
3
|
+
import { lstatSync, readFileSync, readlinkSync } from "node:fs";
|
|
4
|
+
import { join } from "node:path";
|
|
2
5
|
|
|
3
6
|
export function snapshotWorktree(cwd) {
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
+
const status = gitStatus(cwd);
|
|
8
|
+
if (status.skipped) return { skipped: true, reason: status.reason, paths: new Set() };
|
|
9
|
+
try {
|
|
10
|
+
const fingerprints = new Map(status.paths.map(path => [path, fileFingerprint(cwd, path)]));
|
|
11
|
+
let head = "";
|
|
12
|
+
try { head = execFileSync("git", ["-C", cwd, "rev-parse", "HEAD"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim(); } catch {}
|
|
13
|
+
return { skipped: false, paths: new Set(status.paths), fingerprints, head };
|
|
14
|
+
} catch (error) { return { skipped: true, reason: String(error), paths: new Set() }; }
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
function fileFingerprint(cwd, path) {
|
|
18
|
+
try {
|
|
19
|
+
const file = join(cwd, path), stat = lstatSync(file);
|
|
20
|
+
if (!stat.isFile() && !stat.isSymbolicLink()) throw new Error(`Cannot prove file-content delta for ${path}`);
|
|
21
|
+
return createHash("sha256").update(String(stat.mode)).update("\0").update(stat.isSymbolicLink() ? readlinkSync(file) : readFileSync(file)).digest("hex");
|
|
22
|
+
} catch (error) { if (error.code === "ENOENT") return "missing"; throw error; }
|
|
7
23
|
}
|
|
8
24
|
|
|
9
25
|
export function diffAgainst(snapshot, cwd) {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
26
|
+
const current = snapshotWorktree(cwd);
|
|
27
|
+
if (snapshot?.skipped || current.skipped || snapshot?.head !== current.head) {
|
|
28
|
+
return { skipped: true, reason: snapshot?.reason || current.reason || "HEAD changed during observation; content attribution is incomplete", paths: [] };
|
|
29
|
+
}
|
|
30
|
+
try {
|
|
31
|
+
const paths = [...new Set([...snapshot.paths, ...current.paths])].filter(path => {
|
|
32
|
+
const before = snapshot.fingerprints.get(path);
|
|
33
|
+
return before === undefined || before !== (current.fingerprints.get(path) ?? fileFingerprint(cwd, path));
|
|
34
|
+
}).sort();
|
|
35
|
+
return { skipped: false, paths };
|
|
36
|
+
} catch (error) { return { skipped: true, reason: String(error), paths: [] }; }
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Runtime outputs are not input progress. Callers add explicitly supplied evidence separately. */
|
|
40
|
+
export function worktreeRevision(cwd, scopes = []) {
|
|
41
|
+
const snapshot = snapshotWorktree(cwd);
|
|
42
|
+
if (snapshot.skipped) return "unavailable";
|
|
43
|
+
const entries = [...snapshot.fingerprints].filter(([path]) => !path.startsWith(".pi/agent-sessions/") && (!scopes.length || checkScope([path], scopes).inScope.length)).sort(([a], [b]) => a.localeCompare(b));
|
|
44
|
+
return createHash("sha256").update(JSON.stringify([snapshot.head, entries])).digest("hex");
|
|
17
45
|
}
|
|
18
46
|
|
|
19
47
|
export function checkScope(changedPaths, scopeGlobs) {
|
|
@@ -31,7 +59,7 @@ export function checkScope(changedPaths, scopeGlobs) {
|
|
|
31
59
|
|
|
32
60
|
function gitStatus(cwd) {
|
|
33
61
|
try {
|
|
34
|
-
const output = execFileSync("git", ["-C", cwd, "status", "--porcelain", "--untracked-files=all"], {
|
|
62
|
+
const output = execFileSync("git", ["-C", cwd, "status", "--porcelain", "-z", "--untracked-files=all"], {
|
|
35
63
|
encoding: "utf-8",
|
|
36
64
|
stdio: ["ignore", "pipe", "pipe"],
|
|
37
65
|
});
|
|
@@ -42,15 +70,13 @@ function gitStatus(cwd) {
|
|
|
42
70
|
}
|
|
43
71
|
|
|
44
72
|
function parsePorcelain(output) {
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
}
|
|
53
|
-
return uniqueSorted(paths.filter(Boolean));
|
|
73
|
+
const entries = String(output || "").split("\0"), paths = [];
|
|
74
|
+
for (let i = 0; i < entries.length; i++) {
|
|
75
|
+
const entry = entries[i]; if (!entry) continue;
|
|
76
|
+
paths.push(entry.slice(3));
|
|
77
|
+
if (/[RC]/.test(entry.slice(0, 2)) && entries[i + 1]) paths.push(entries[++i]);
|
|
78
|
+
}
|
|
79
|
+
return uniqueSorted(paths);
|
|
54
80
|
}
|
|
55
81
|
|
|
56
82
|
function matchesScope(changedPath, scope) {
|
|
@@ -69,11 +95,13 @@ function globToRegExp(glob) {
|
|
|
69
95
|
const c = glob[i];
|
|
70
96
|
if (c === "*") {
|
|
71
97
|
if (glob[i + 1] === "*") {
|
|
72
|
-
out += "
|
|
73
|
-
i++;
|
|
98
|
+
if (glob[i + 2] === "/") { out += "(?:.*/)?"; i += 2; }
|
|
99
|
+
else { out += ".*"; i++; }
|
|
74
100
|
} else {
|
|
75
101
|
out += "[^/]*";
|
|
76
102
|
}
|
|
103
|
+
} else if (c === "?") {
|
|
104
|
+
out += "[^/]";
|
|
77
105
|
} else {
|
|
78
106
|
out += escapeRegExp(c);
|
|
79
107
|
}
|
|
@@ -90,14 +118,6 @@ function uniqueSorted(values) {
|
|
|
90
118
|
return [...new Set(values)].sort();
|
|
91
119
|
}
|
|
92
120
|
|
|
93
|
-
function unquotePorcelainPath(value) {
|
|
94
|
-
const trimmed = String(value || "").trim();
|
|
95
|
-
if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
|
|
96
|
-
try { return JSON.parse(trimmed); } catch { return trimmed.slice(1, -1); }
|
|
97
|
-
}
|
|
98
|
-
return trimmed;
|
|
99
|
-
}
|
|
100
|
-
|
|
101
121
|
function escapeRegExp(value) {
|
|
102
122
|
return value.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
|
|
103
123
|
}
|
|
@@ -13,6 +13,8 @@ export function registerDispatchAgent(pi: ExtensionAPI, toolCtx: ToolContext): v
|
|
|
13
13
|
task: Type.String({ description: "Task description for the agent to execute" }),
|
|
14
14
|
artifacts: Type.Optional(Type.Array(Type.String({ description: "Input artifact path; the specialist reads it." }))),
|
|
15
15
|
scope: Type.Optional(Type.Array(Type.String({ description: "Advisory writable-file globs; violations are reported, never reverted." }))),
|
|
16
|
+
deliverables: Type.Optional(Type.Array(Type.String({ description: "Expected output file path, read back after execution. Presence is not semantic acceptance." }))),
|
|
17
|
+
scope_mode: Type.Optional(Type.Union([Type.Literal("existing"), Type.Literal("create")], { description: "Default existing: refuse missing scope roots; create explicitly permits new roots." })),
|
|
16
18
|
watchdog: Type.Optional(Type.Boolean({ description: "Override this dispatch's drift watchdog." })),
|
|
17
19
|
review_reason: Type.Optional(Type.String({ description: "Why a docs-only review is needed." })),
|
|
18
20
|
backend: Type.Optional(Type.Union([
|
|
@@ -55,10 +57,11 @@ export function registerDispatchAgent(pi: ExtensionAPI, toolCtx: ToolContext): v
|
|
|
55
57
|
);
|
|
56
58
|
}
|
|
57
59
|
|
|
58
|
-
const
|
|
59
|
-
const
|
|
60
|
+
const completed = details.executionStatus === "completed";
|
|
61
|
+
const icon = details.accepted === true ? "✓" : completed || details.pending ? "○" : "✗";
|
|
62
|
+
const color = details.accepted === true ? "success" : completed || details.pending ? "warning" : "error";
|
|
60
63
|
const elapsed = typeof details.elapsed === "number" ? Math.round(details.elapsed / 1000) : 0;
|
|
61
|
-
const header = theme.fg(color, `${icon} ${details.agent}`) +
|
|
64
|
+
const header = theme.fg(color, `${icon} ${details.agent}${completed && !details.accepted ? " — completed; acceptance unproven" : ""}`) +
|
|
62
65
|
theme.fg("dim", ` ${elapsed}s`);
|
|
63
66
|
|
|
64
67
|
const questions: string[] = Array.isArray(details.questions) ? details.questions : [];
|
|
@@ -1,10 +1,14 @@
|
|
|
1
|
+
import { retainDeliverable } from "../execution-evidence.ts";
|
|
2
|
+
import { preflightDeliverables, readBackDeliverables, type DeliverableContract } from "../acceptance.ts";
|
|
3
|
+
import { withNoProgress, type NoProgressGuard } from "../no-progress.ts";
|
|
4
|
+
import { randomUUID } from "node:crypto";
|
|
1
5
|
import { mkdirSync, writeFileSync } from "node:fs";
|
|
2
6
|
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
3
7
|
import { blockingFindingCap, checkReviewRoundCap, checkTaskBudget, checkTierPersonaGate, checkTurnBudget, isReviewPersona, remainingTaskResearch, reviewBudgetClause, reviewRoundCap } from "../run-budget.js";
|
|
4
8
|
import { countReviewFindings, findingBudgetNotice } from "../review-findings.js";
|
|
5
9
|
import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
|
|
6
10
|
import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
|
|
7
|
-
import {
|
|
11
|
+
import type { BudgetRecovery } from "../budget-recovery.ts";
|
|
8
12
|
import { checkScope, diffAgainst, snapshotWorktree } from "../scope-gate.js";
|
|
9
13
|
import { crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
|
|
10
14
|
import { shouldExtractReturn } from "../return-extract.js";
|
|
@@ -15,7 +19,7 @@ import type { AssertionsArtifactsContext, InputArtifactPreview } from "../contex
|
|
|
15
19
|
import type { DispatchAgentParams, SpawnResearchParams, ToolExecutionResult, ToolExecutor, ToolUpdate } from "./context.ts";
|
|
16
20
|
|
|
17
21
|
type Gate = { reason: string; message: string } | null;
|
|
18
|
-
type DispatchResult =
|
|
22
|
+
type DispatchResult = import("../dispatch-native-types.ts").NativeDispatchResult;
|
|
19
23
|
type AgentState = { def: { name: string; tools: string }; runCount: number; contextPct: number; lastBackend?: string | null };
|
|
20
24
|
|
|
21
25
|
export interface DispatchExecutionState {
|
|
@@ -41,8 +45,10 @@ export interface DispatchExecutionState {
|
|
|
41
45
|
}
|
|
42
46
|
|
|
43
47
|
export interface DispatchExecutorDeps {
|
|
48
|
+
noProgress: NoProgressGuard;
|
|
44
49
|
state: DispatchExecutionState;
|
|
45
50
|
budget: BudgetContext;
|
|
51
|
+
budgetRecovery: BudgetRecovery;
|
|
46
52
|
artifacts: AssertionsArtifactsContext;
|
|
47
53
|
research: ResearchRuntime<any>;
|
|
48
54
|
provisionalCapabilityRefusal(pack: "fleet"): ToolExecutionResult | null;
|
|
@@ -54,7 +60,7 @@ export interface DispatchExecutorDeps {
|
|
|
54
60
|
displayName(name: string): string;
|
|
55
61
|
}
|
|
56
62
|
|
|
57
|
-
interface PreparedDispatch { agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
|
|
63
|
+
interface PreparedDispatch { taskToken: object; contract: DeliverableContract; sessionDir: string; agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
|
|
58
64
|
interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; autoResearchTaskCapped: boolean; }
|
|
59
65
|
interface Tracking { writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; }
|
|
60
66
|
|
|
@@ -109,9 +115,12 @@ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentPa
|
|
|
109
115
|
const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(s.getTaskTier(), agent, s.getTaskReviewRounds()) ?? checkDocsLane(agent, scope || [], review_reason);
|
|
110
116
|
if (preflight) return refusal(d, agent, task, preflight.reason, preflight.message, preflight.reason);
|
|
111
117
|
const taskRefusal = checkTaskBudget("dispatch", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
|
|
112
|
-
if (taskRefusal)
|
|
118
|
+
if (taskRefusal) return refusal(d, agent, task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
|
|
113
119
|
const turnRefusal = checkTurnBudget("dispatch", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
|
|
114
|
-
if (turnRefusal)
|
|
120
|
+
if (turnRefusal) return refusal(d, agent, task, "budget_refused", turnRefusal.message, turnRefusal.reason);
|
|
121
|
+
let contract: DeliverableContract;
|
|
122
|
+
try { contract = preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: s.getSessionDir() }); }
|
|
123
|
+
catch (error) { return refusal(d, agent, task, "scope_preflight_failed", String(error)); }
|
|
115
124
|
const fingerprint = taskFingerprint(agent, task);
|
|
116
125
|
if (s.getTurnDispatchFingerprints().has(fingerprint)) return refusal(d, agent, task, "duplicate_refused", `⚠ Duplicate dispatch refused: you already dispatched ${agent} with this task (or a trivial rewording of it) THIS turn. Use the earlier result — re-read its digest/returnPath — or change the task materially (new instructions, corrected inputs) before re-dispatching.`);
|
|
117
126
|
let inputArtifacts: InputArtifactPreview[];
|
|
@@ -120,7 +129,8 @@ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentPa
|
|
|
120
129
|
s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1);
|
|
121
130
|
if (isReviewPersona(agent)) s.setTaskReviewRounds(s.getTaskReviewRounds() + 1);
|
|
122
131
|
s.getSessionTotals().dispatches++; d.budget.updateModeStatus();
|
|
123
|
-
|
|
132
|
+
const declaredTask = contract.files.length ? `${task}\n\n## Expected deliverables (explicit contract)\nProduce these exact files and report their paths. The hub will read them back; a prose claim is not delivery.\n${contract.files.map(file => `- ${file.path}`).join("\n")}` : task;
|
|
133
|
+
return { taskToken: d.noProgress.taskToken(), contract, sessionDir: s.getSessionDir(), agent, task: declaredTask, inputArtifacts, scopeGlobs: (scope || []).map(String).map(x => x.trim()).filter(Boolean), fingerprint };
|
|
124
134
|
}
|
|
125
135
|
|
|
126
136
|
function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx: ExtensionContext): Tracking {
|
|
@@ -139,19 +149,20 @@ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch,
|
|
|
139
149
|
const findingClause = reviewBudgetClause(d.state.getTaskTier(), p.agent); const dispatchedTask = findingClause ? `${p.task}\n\n${findingClause}` : p.task;
|
|
140
150
|
let result = await d.dispatchAgent(p.agent, dispatchedTask, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto");
|
|
141
151
|
let billed = result.billed ?? 0; let out = result.out ?? 0; const researchRounds: RunData["researchRounds"] = []; let autoResearchTaskCapped = false;
|
|
142
|
-
while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS) {
|
|
152
|
+
while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS && p.taskToken === d.noProgress.taskToken() && p.sessionDir === d.state.getSessionDir()) {
|
|
143
153
|
const left = remainingTaskResearch(d.budget.currentTaskBudget(), d.budget.taskCounters()); if (left === 0) { autoResearchTaskCapped = true; break; }
|
|
144
154
|
const questions = d.extractNeedsResearch(result.output).slice(0, left == null ? MAX_AUTO_RESEARCH_QUESTIONS : Math.min(MAX_AUTO_RESEARCH_QUESTIONS, left)); if (!questions.length) break;
|
|
145
155
|
d.state.setTaskResearchCount(d.state.getTaskResearchCount() + questions.length); d.budget.updateModeStatus();
|
|
146
156
|
onUpdate?.({ content: [{ type: "text", text: `${p.agent} paused for research (${questions.length} question(s)) — spawning read-only helpers...` }], details: { agent: p.agent, task: p.task, status: "researching" } });
|
|
147
|
-
const findingsDir = safePathWithin(
|
|
157
|
+
const findingsDir = safePathWithin(p.sessionDir, "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
|
|
148
158
|
const answered = await Promise.all(questions.map(async question => {
|
|
149
159
|
const def = d.research.anonymousDef(); const state = d.research.createState(def, false, d.research.resolveModel(def, undefined, ctx));
|
|
150
|
-
const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}
|
|
151
|
-
writeFileSync(file, `# Research findings r${state.id}\n\n**Question:** ${question}\n\n${response.exitCode === 0 ? response.output : `(research helper failed, exit ${response.exitCode})\n\n${response.output}`}\n`, "utf-8"); return { question, file };
|
|
160
|
+
const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-${response.dispatchId ?? randomUUID()}.md`);
|
|
161
|
+
writeFileSync(file, `# Research findings r${state.id}\n\n**Question:** ${question}\n\n${response.exitCode === 0 ? response.output : `(research helper failed, exit ${response.exitCode})\n\n${response.output}`}\n`, { encoding: "utf-8", flag: "wx" }); return { question, file };
|
|
152
162
|
}));
|
|
153
163
|
researchRounds.push({ questions, files: answered.map(a => a.file) });
|
|
154
164
|
const resume = "Research findings for your NEEDS_RESEARCH questions are ready. Read each file with your read tool, then continue from where you paused:\n" + answered.map((a, i) => `${i + 1}. ${a.question}\n → ${a.file}`).join("\n");
|
|
165
|
+
if (p.taskToken !== d.noProgress.taskToken() || p.sessionDir !== d.state.getSessionDir()) break;
|
|
155
166
|
result = await d.dispatchAgent(p.agent, resume, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", true); billed += result.billed ?? 0; out += result.out ?? 0;
|
|
156
167
|
}
|
|
157
168
|
return { result, billed, out, researchRounds, autoResearchTaskCapped };
|
|
@@ -165,20 +176,37 @@ function scopeResult(d: DispatchExecutorDeps, p: PreparedDispatch, tracking: Tra
|
|
|
165
176
|
}
|
|
166
177
|
|
|
167
178
|
async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
|
|
168
|
-
const s = d.state; const { result, researchRounds } = run;
|
|
179
|
+
const s = d.state; const { result, researchRounds } = run;
|
|
180
|
+
const sameTask = p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir(); const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
|
|
169
181
|
let { parsed: parsedReturn, notices: contractNotices } = parseDeliveredReturn(result.output, ids, disposition.delivered); const shouldUseDigest = ids.length > 0 || !!parsedReturn;
|
|
170
|
-
const state = s.getAgentStates().get(p.agent.toLowerCase()); const key = safeAgentKey(state?.def.name ?? p.agent);
|
|
171
|
-
const
|
|
182
|
+
const state = sameTask ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined; const key = safeAgentKey(state?.def.name ?? p.agent);
|
|
183
|
+
const failureMetadata = { dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null,
|
|
184
|
+
agent: p.agent, task: p.task, scope: p.scopeGlobs, exitCode: result.exitCode, diagnostics: result.diagnostics ?? null };
|
|
185
|
+
const artifactOutput = disposition.delivered ? result.output
|
|
186
|
+
: `# Dispatch failure\n\n\`\`\`json\n${JSON.stringify(failureMetadata, null, 2)}\n\`\`\`\n\n## Output\n\n${result.output}`;
|
|
187
|
+
const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind, result.dispatchId, p.sessionDir) : null;
|
|
172
188
|
const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
|
|
173
189
|
if (returnPath && shouldExtractReturn(parsedReturn, ids)) {
|
|
174
190
|
onUpdate?.({ content: [{ type: "text", text: `${p.agent} returned no structured block — extracting it from the report...` }], details: { agent: p.agent, task: p.task, status: "extracting_return" } });
|
|
175
191
|
const recovered = await d.runReturnExtraction(returnPath, ids, ctx); if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
|
|
176
192
|
}
|
|
177
|
-
|
|
178
|
-
|
|
193
|
+
const assessmentId = result.dispatchId ?? randomUUID();
|
|
194
|
+
const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd: ctx.cwd || process.cwd(), sessionDir: p.sessionDir },
|
|
195
|
+
(index, bytes) => retainDeliverable(p.sessionDir, assessmentId, index, bytes));
|
|
196
|
+
const deliverableFailed = readback.some(file => file.status !== "read");
|
|
197
|
+
const executionStatus = disposition.pending ? "pending" : disposition.delivered ? "completed" : "failed";
|
|
198
|
+
const status = disposition.delivered ? deliverableFailed ? "verification_failed" : "completed_unverified" : disposition.status;
|
|
199
|
+
const acceptanceStatus = disposition.pending || !disposition.delivered ? "not_available" : deliverableFailed ? "deliverable_failed" : "needs_verification";
|
|
200
|
+
const assessment = { executionStatus, acceptanceStatus, accepted: false, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots, assertions: ids };
|
|
201
|
+
const assessmentPath = disposition.pending ? null : d.artifacts.writeRunArtifact(`${key}-acceptance`, state?.runCount ?? 0, JSON.stringify(assessment, null, 2), "evidence", assessmentId, p.sessionDir);
|
|
202
|
+
if (sameTask && [0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
|
|
203
|
+
if (sameTask) { s.getTurnReport().dispatches.push({ agent: p.agent, status, elapsed: result.elapsed, billed: run.billed, out: run.out }); s.getSessionTotals().billed += run.billed; s.getSessionTotals().out += run.out; }
|
|
179
204
|
const questions = d.extractAskUserQuestions(result.output); const unresolved = d.extractNeedsResearch(result.output); const answered = researchRounds.reduce((n, r) => n + r.questions.length, 0);
|
|
180
205
|
const notices: string[] = [];
|
|
181
|
-
|
|
206
|
+
if (!sameTask) notices.push("Late result from a prior task/session: evidence retained in its original namespace; current-task counters and blockers were not changed.");
|
|
207
|
+
if (disposition.delivered) notices.push(`Execution completed, NOT accepted. ${deliverableFailed ? "Expected deliverable readback failed." : "Verify correctness against the assertion ledger; file presence and exit 0 are not proof."} Acceptance check: ${assessmentPath}`);
|
|
208
|
+
if (readback.some(file => file.changed === false)) notices.push("Some deliverables already existed unchanged. Do not attribute their creation to this execution.");
|
|
209
|
+
const blockers = extractExternalBlockers(result.output); if (sameTask && blockers.length) { for (const what of blockers) if (!s.getExternalBlockers().some(b => b.what === what)) s.getExternalBlockers().push({ agent: p.agent, what }); s.setExternalBlockerAcknowledged(false); s.setExternalBlockerRefusedOnce(false); notices.push(`⛔ ${p.agent} reported an EXTERNAL BLOCKER — something outside the fleet's reach is missing:\n${blockers.map((w, i) => ` ${i + 1}. ${w}`).join("\n")}\nThe next dispatch/research call is refused until you escalate this to the human. Do not build a substitute for the missing fact.`); }
|
|
182
210
|
if (questions.length) notices.push(`⚠ ${questions.length} ASK_USER question(s) raised by ${p.agent}. You MUST call ask_user for each (in ${s.getUserLanguage()}) before re-dispatching:\n${questions.map((q, i) => ` ${i + 1}. ${q}`).join("\n")}`);
|
|
183
211
|
if (researchRounds.length) notices.push(`ℹ ${p.agent} auto-paused for research ${researchRounds.length} round(s); ${answered} question(s) answered by read-only helpers. Findings were saved under ${safePathWithin(s.getSessionDir(), "findings")} and read by the agent directly — they are NOT inlined here.`);
|
|
184
212
|
if (unresolved.length && researchRounds.length >= MAX_AUTO_RESEARCH_ROUNDS) notices.push(`⚠ ${p.agent} still requests research (${unresolved.length} question(s)) but the auto-research budget is exhausted. Run spawn_research yourself and re-dispatch with the findings, or simplify the task.`);
|
|
@@ -193,37 +221,50 @@ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, para
|
|
|
193
221
|
const docs = docsLaneNotice(p.agent, p.scopeGlobs); if (docs) notices.push(docs);
|
|
194
222
|
const contract = contractNoticeText(contractNotices); const extraction = returnExtracted ? "ℹ The specialist declared no structured return. The block below was EXTRACTED from its report by a cheap read-only pass — weaker than a declared return. Verify the named evidence before you gate on it." : "";
|
|
195
223
|
const digest = shouldUseDigest ? [extraction, structuredReturnDigest(parsedReturn) || "Structured return: (none parsed)", contract].filter(Boolean).join("\n\n") : (result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output);
|
|
196
|
-
return { content: [{ type: "text", text: `[${p.agent}] ${
|
|
224
|
+
return { content: [{ type: "text", text: `[${p.agent}] ${status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status, executionStatus, acceptanceStatus, accepted: false, staleTask: !sameTask, deliverableReadback: readback, scopeRoots: p.contract.scopeRoots, assessmentPath, backendRequested: params.backend ?? "auto", backendUsed: state?.lastBackend ?? null, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null, diagnostics: result.diagnostics ?? null, evidencePath: result.evidencePath ?? null, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
|
|
197
225
|
}
|
|
198
226
|
|
|
199
227
|
export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
|
|
200
|
-
return async (_id, params,
|
|
228
|
+
return withNoProgress(d, "dispatch", async (_id, params, signal, onUpdate, ctx) => {
|
|
201
229
|
const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability;
|
|
230
|
+
d.budget.ensureTaskTier();
|
|
231
|
+
const agent = normalizeAgentInput(params.agent);
|
|
232
|
+
const invalid = validateDispatchAgent(d, agent, params.task); if (invalid) return invalid;
|
|
233
|
+
const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(d.state.getTaskTier(), agent, d.state.getTaskReviewRounds()) ?? checkDocsLane(agent, params.scope || [], params.review_reason);
|
|
234
|
+
if (preflight) return refusal(d, agent, params.task, preflight.reason, preflight.message);
|
|
235
|
+
try { preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: d.state.getSessionDir() }); }
|
|
236
|
+
catch (error) { return refusal(d, agent, params.task, "scope_preflight_failed", String(error)); }
|
|
237
|
+
const budgetBlock = await d.budgetRecovery.ensure("dispatch", `${agent}: ${params.task}`, ctx, signal);
|
|
238
|
+
if (budgetBlock) return refusal(d, agent, params.task, budgetBlock.reason, budgetBlock.message);
|
|
239
|
+
if (signal?.aborted) return refusal(d, agent, params.task, "cancelled", "Operation cancelled before dispatch.");
|
|
202
240
|
const prepared = prepareDispatch(d, params, ctx); if (!("agent" in prepared)) return prepared;
|
|
203
241
|
const tracking = startTracking(d, prepared, ctx);
|
|
204
242
|
try { onUpdate?.({ content: [{ type: "text", text: `Dispatching to ${prepared.agent}...` }], details: { agent: prepared.agent, task: prepared.task, status: "dispatching" } }); return await finishDispatch(d, prepared, params, await runWithAutoResearch(d, prepared, params, ctx, onUpdate), tracking, ctx, onUpdate); }
|
|
205
243
|
catch (err: any) { return { content: [{ type: "text", text: `Error dispatching to ${prepared.agent}: ${err?.message || err}` }], details: { agent: prepared.agent, task: prepared.task, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
|
|
206
244
|
finally { if (tracking.writable) d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); }
|
|
207
|
-
};
|
|
245
|
+
});
|
|
208
246
|
}
|
|
209
247
|
|
|
210
248
|
export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
|
|
211
|
-
return async (_id, params, signal, onUpdate, ctx) => {
|
|
249
|
+
return withNoProgress(d, "research", async (_id, params, signal, onUpdate, ctx) => {
|
|
212
250
|
const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability; const s = d.state; d.budget.ensureTaskTier();
|
|
213
251
|
const preflight = preflightGate(d, params.persona || ""); if (preflight) return refusal(d, "", params.task, preflight.reason, preflight.message, preflight.reason);
|
|
252
|
+
const budgetBlock = await d.budgetRecovery.ensure("research", params.task, ctx, signal);
|
|
253
|
+
if (budgetBlock) return refusal(d, "", params.task, budgetBlock.reason, budgetBlock.message);
|
|
254
|
+
if (signal?.aborted) return refusal(d, "", params.task, "cancelled", "Operation cancelled before research.");
|
|
214
255
|
const taskRefusal = checkTaskBudget("research", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
|
|
215
|
-
if (taskRefusal)
|
|
256
|
+
if (taskRefusal) return refusal(d, "", params.task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
|
|
216
257
|
const turnRefusal = checkTurnBudget("research", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
|
|
217
|
-
if (turnRefusal)
|
|
258
|
+
if (turnRefusal) return refusal(d, "", params.task, "budget_refused", turnRefusal.message, turnRefusal.reason);
|
|
218
259
|
let def: any; let persona = false;
|
|
219
260
|
if (params.persona) { def = s.getResearchPersonas().find(x => x.name.toLowerCase() === params.persona!.toLowerCase()); if (!def) return { content: [{ type: "text", text: `No research persona "${params.persona}". Available: ${s.getResearchPersonas().map(x => x.name).join(", ") || "(none defined)"}. Omit \`persona\` for an ad-hoc helper. (Not counted against the turn budget.)` }], details: { status: "error" } }; persona = true; } else def = d.research.anonymousDef();
|
|
220
261
|
const model = d.research.resolveModel(def, persona ? undefined : params.model, ctx); let artifacts: InputArtifactPreview[];
|
|
221
262
|
try { artifacts = d.artifacts.loadInputArtifacts(params.artifacts, ctx); } catch (err: any) { return { content: [{ type: "text", text: `⚠ Research NOT spawned and NOT counted against the turn budget — input artifact could not be resolved:\n${err?.message || err}\n\nFix the path and try again.` }], details: { status: "artifact_preflight_failed" } }; }
|
|
222
263
|
s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; s.getSessionTotals().research++; d.budget.updateModeStatus();
|
|
223
264
|
const state = d.research.createState(def, persona, model); onUpdate?.({ content: [{ type: "text", text: `Spawning research helper r${state.id}...` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, status: "spawning" } });
|
|
224
|
-
try { const result = await d.research.spawn(state, params.task, ctx, artifacts, signal); const status = result.termination ? result.termination.reason : result.exitCode === 0 ? "done" : "error"; const output = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output; return { content: [{ type: "text", text: `[research r${state.id} · ${persona ? d.displayName(def.name) : "ad-hoc"} · read-only] ${status} in ${Math.round(result.elapsed / 1000)}s\n\n${output}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, termination: result.termination, artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
|
|
265
|
+
try { const result = await d.research.spawn(state, params.task, ctx, artifacts, signal); const status = result.termination ? result.termination.reason : result.exitCode === 0 ? "done" : "error"; const output = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output; return { content: [{ type: "text", text: `[research r${state.id} · ${persona ? d.displayName(def.name) : "ad-hoc"} · read-only] ${status} in ${Math.round(result.elapsed / 1000)}s\n\n${output}${result.evidencePath ? `\n\nFull execution evidence: ${result.evidencePath}` : ""}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId, evidencePath: result.evidencePath, transcriptPath: result.transcriptPath, termination: result.termination, artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
|
|
225
266
|
catch (err: any) { return { content: [{ type: "text", text: `Error spawning research helper: ${err?.message || err}` }], details: { handle: `r${state.id}`, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
|
|
226
|
-
};
|
|
267
|
+
});
|
|
227
268
|
}
|
|
228
269
|
|
|
229
270
|
function hasWriteCapability(tools: string): boolean { const set = new Set(String(tools || "").split(",").map(x => x.trim()).filter(Boolean)); return ["write", "edit", "bash"].some(x => set.has(x)); }
|
|
@@ -64,7 +64,12 @@ export function createPoolPresentation(deps: PoolPresentationDeps): PoolPresenta
|
|
|
64
64
|
const left = theme.fg("dim", "┏━") + theme.fg("border", " coms ");
|
|
65
65
|
const remaining = safeWidth - 9 - (identity ? identity.name.length + 4 : 0) - 1;
|
|
66
66
|
if (identity && remaining >= 1) {
|
|
67
|
-
|
|
67
|
+
const projectTag = `project: ${identity.project}`;
|
|
68
|
+
const projectFill = remaining + 1 - projectTag.length - 3;
|
|
69
|
+
const middle = projectFill >= 1
|
|
70
|
+
? theme.fg("dim", "━".repeat(projectFill)) + theme.fg("border", projectTag) + theme.fg("dim", "━━━")
|
|
71
|
+
: theme.fg("dim", "━".repeat(remaining + 1));
|
|
72
|
+
topBorder = left + middle + theme.fg("dim", " ") + hexFg(identity.color, identity.name) + theme.fg("dim", " ━┓");
|
|
68
73
|
} else {
|
|
69
74
|
topBorder = left + theme.fg("dim", "━".repeat(Math.max(0, safeWidth - 9)) + "┓");
|
|
70
75
|
}
|
|
@@ -38,7 +38,7 @@ export function workModePickerOptions(current: WorkMode): { title: string; optio
|
|
|
38
38
|
const options = workModes.map(workMode => formatPickerOption(
|
|
39
39
|
workMode === current,
|
|
40
40
|
workMode,
|
|
41
|
-
workMode === "operator" ? "Direct tools enabled" : "Delegate-only;
|
|
41
|
+
workMode === "operator" ? "Direct tools enabled" : "Delegate-only; auto-loads the first valid team if no agents are active",
|
|
42
42
|
));
|
|
43
43
|
return { title: `Fleet Work Mode — Alt+M · current ${current}`, options, workModes };
|
|
44
44
|
}
|
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
Harness wrapper for `pi-ask-user` that preserves the stock `ask_user` UI and result shape while optionally racing it against the Hermes `user-remote` coms peer.
|
|
4
4
|
|
|
5
|
-
The experimental
|
|
5
|
+
The experimental ChatGPT Fleet session client can explicitly list and answer wrapper-owned questions through the existing coms socket. Local UI, Hermes and addressed client responses share the same first-valid-answer race. See the [session client runbook](https://github.com/chankov/agent-fleet/blob/main/docs/codex-session-bridge.md).
|
|
6
6
|
|
|
7
7
|
- The stock `pi-ask-user` extension is loaded through a capture proxy; its `ask_user` tool is not registered directly.
|
|
8
|
-
- If
|
|
8
|
+
- If neither an addressed question channel nor a live `user-remote` peer is available, the wrapper calls stock `execute` with the original arguments and signal unchanged.
|
|
9
9
|
- Remote lookup follows the explicit Pi `--project <name>` flag at tool-execution time (then `pi.getFlag`, `PI_COMS_PROJECT`, and finally `default`), so a hub and bridge in the same non-default pool can race correctly even though Pi finishes CLI parsing after extension factories load.
|
|
10
10
|
- If `user-remote` is present, the wrapper races local stock UI against the remote coms request using `race-core.js`; first answer wins and local-first emits one best-effort cancel.
|
|
11
11
|
- If another extension already registered `ask_user`, registration failure is caught and logged as a warning instead of crashing the session.
|
|
@@ -51,3 +51,9 @@ Pick **one** path for Agent Fleet skills and lifecycle prompts:
|
|
|
51
51
|
`agent-fleet verify` / `doctor` emit a read-only `pi-package-ownership` advisory when both paths overlap. See [docs/pi-setup.md](../../../docs/pi-setup.md).
|
|
52
52
|
|
|
53
53
|
Tests use fakes for the stock TUI and coms peer. The abort test proves signal propagation and the stock-shaped `{cancelled:true}` result through a fake captured tool; it does not drive a live TUI overlay.
|
|
54
|
+
|
|
55
|
+
## Addressed client questions
|
|
56
|
+
|
|
57
|
+
When co-loaded with an updated Hub or coms harness, the wrapper exposes its pending questions to `fleet-codex-client.ts questions`. The session-specific coms custom-envelope route checks owner identity and dispatches `list`, `answer` and `cancel` requests directly into the same local/remote race latch. No extra remote peer or service is needed.
|
|
58
|
+
|
|
59
|
+
Only valid responses allowed by the question flags can win. The accepted answer returns the stock tool result; local-first and remote-first races classify later submissions explicitly. Tool abort and session reset expire the address. The process keeps bounded pending/terminal records; a restart never makes old question IDs answerable. Unsupported/skipped wrappers are reported as such. See [client runbook](../../../docs/codex-session-bridge.md) for the CLI, limits and recovery semantics.
|