@chankov/agent-fleet 1.0.4 → 2.0.0
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 +57 -66
- package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
- package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
- package/.pi/harnesses/agent-hub/footer.ts +3 -9
- package/.pi/harnesses/agent-hub/helpers.ts +2 -2
- package/.pi/harnesses/agent-hub/index.ts +1324 -9645
- package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
- package/.pi/harnesses/coms/index.ts +139 -1630
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
- package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.0/.pi/extensions/package.json +9 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.0/.version +1 -0
- package/.versions/2.0.0/agents/architect.md +25 -0
- package/.versions/2.0.0/agents/bowser.md +28 -0
- package/.versions/2.0.0/agents/builder.md +56 -0
- package/.versions/2.0.0/agents/code-reviewer.md +209 -0
- package/.versions/2.0.0/agents/deep-researcher.md +33 -0
- package/.versions/2.0.0/agents/documenter.md +19 -0
- package/.versions/2.0.0/agents/orchestrator.md +23 -0
- package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.0/agents/planner.md +71 -0
- package/.versions/2.0.0/agents/releaser.md +25 -0
- package/.versions/2.0.0/agents/researcher.md +29 -0
- package/.versions/2.0.0/agents/security-auditor.md +168 -0
- package/.versions/2.0.0/agents/test-engineer.md +154 -0
- package/.versions/2.0.0/agents/web-debugger.md +44 -0
- package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
- package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
- package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.0/docs/getting-started.md +98 -0
- package/.versions/2.0.0/docs/npm-install.md +292 -0
- package/.versions/2.0.0/docs/pi-extensions.md +439 -0
- package/.versions/2.0.0/docs/pi-setup.md +74 -0
- package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.0/hermes/README.md +347 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.0/install-manifest.json +2745 -0
- package/.versions/2.0.0/justfile +272 -0
- package/.versions/2.0.0/manifest-meta.json +882 -0
- package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.0/references/definition-of-done.md +67 -0
- package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
- package/.versions/2.0.0/references/observability-checklist.md +91 -0
- package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.0/references/performance-checklist.md +153 -0
- package/.versions/2.0.0/references/prompting-patterns.md +380 -0
- package/.versions/2.0.0/references/security-checklist.md +179 -0
- package/.versions/2.0.0/references/testing-patterns.md +236 -0
- package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.0/scripts/fleet.ts +185 -0
- package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.0/scripts/team-up.ts +406 -0
- package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +33 -0
- package/README.md +5 -5
- package/agents/orchestrator.md +3 -1
- package/bin/lib/overrides.js +2 -0
- package/bin/lib/validate-overrides.js +1 -1
- package/docs/ARCHITECTURE.md +42 -13
- package/docs/MIGRATION-agent-fleet.md +4 -4
- package/docs/agent-fleet-setup.md +15 -15
- package/docs/npm-install.md +1 -1
- package/docs/pi-extensions.md +16 -18
- package/install-manifest.json +1 -1
- package/justfile +2 -2
- package/package.json +3 -2
- package/scripts/fleet.ts +10 -10
- package/scripts/lib/fleet-command.ts +15 -11
- package/scripts/lib/team-project.ts +2 -2
- package/scripts/team-up.ts +10 -10
- package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { MAX_OPEN_ASSERTIONS } from "../assertion-ledger.js";
|
|
2
|
+
import { CAPABILITY_PACKS, type CapabilityPack } from "../capability-packs.ts";
|
|
3
|
+
import { workModePrompt } from "../work-mode.ts";
|
|
4
|
+
import { component, type ContextBudgetComponent } from "../../lib/context-budget.ts";
|
|
5
|
+
import { assembleHubSystemPrompt, HUB_HERDR_SECTION, namedHubLedgerParts, recordHubLedger } from "../../lib/context-budget-hub-prompt.ts";
|
|
6
|
+
import type { HubPromptContext } from "./context.ts";
|
|
7
|
+
import {
|
|
8
|
+
ambiguityFragment,
|
|
9
|
+
askUserFragment,
|
|
10
|
+
COMPACTION_FRAGMENT,
|
|
11
|
+
comsFragment,
|
|
12
|
+
dispatchFragment,
|
|
13
|
+
languageFragment,
|
|
14
|
+
stateCapsuleFragment,
|
|
15
|
+
TASK_TRIAGE_FRAGMENT,
|
|
16
|
+
verificationFragment,
|
|
17
|
+
} from "./fragments.ts";
|
|
18
|
+
|
|
19
|
+
export interface BuiltHubSystemPrompt {
|
|
20
|
+
systemPrompt: string;
|
|
21
|
+
ledger: ContextBudgetComponent[];
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
function capabilityStatus(pack: CapabilityPack, ctx: HubPromptContext, active: readonly CapabilityPack[], provisional: readonly CapabilityPack[]): string {
|
|
25
|
+
if (active.includes(pack)) return "active";
|
|
26
|
+
if (provisional.includes(pack)) return "provisional";
|
|
27
|
+
if ((pack === "peer" && ctx.isComsReady()) || (pack === "workspace" && ctx.isHerdrFleetReady())) return "ready-inactive";
|
|
28
|
+
return pack === "peer" || pack === "workspace" ? "unavailable" : "inactive";
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Pure text and ledger assembly. Turn lifecycle resets are owned by index.ts. */
|
|
32
|
+
export function buildHubSystemPrompt(ctx: HubPromptContext): BuiltHubSystemPrompt {
|
|
33
|
+
const resolution = ctx.getCapabilityResolution();
|
|
34
|
+
const modelPacks = new Set<CapabilityPack>([...resolution.active, ...resolution.provisional]);
|
|
35
|
+
const fleetActive = modelPacks.has("fleet");
|
|
36
|
+
const verificationActive = modelPacks.has("verification");
|
|
37
|
+
const peerActive = modelPacks.has("peer");
|
|
38
|
+
const workspaceActive = modelPacks.has("workspace");
|
|
39
|
+
const compactionActive = modelPacks.has("compaction");
|
|
40
|
+
const agents = fleetActive ? ctx.getAgents() : [];
|
|
41
|
+
const agentCards = agents.map(agent => ({
|
|
42
|
+
id: agent.name,
|
|
43
|
+
text: `### ${agent.displayName}\n**Dispatch as:** \`${agent.name}\`\n${agent.description}\n**Tools:** ${agent.tools}`,
|
|
44
|
+
}));
|
|
45
|
+
const agentCatalog = agentCards.map(card => card.text).join("\n\n");
|
|
46
|
+
const teamMembers = agents.map(agent => agent.displayName).join(", ");
|
|
47
|
+
const researchPersonas = fleetActive ? ctx.getResearchPersonas() : [];
|
|
48
|
+
const researchCards = researchPersonas.map(persona => ({
|
|
49
|
+
id: persona.name,
|
|
50
|
+
text: `### ${persona.displayName}\n**Spawn as:** \`spawn_research(persona: "${persona.name}")\`\n**Model:** ${persona.model || "(dispatcher’s default)"} · **Thinking:** ${persona.thinking}\n${persona.description}`,
|
|
51
|
+
}));
|
|
52
|
+
const researchCatalog = !fleetActive ? "" : researchCards.length > 0
|
|
53
|
+
? researchCards.map(card => card.text).join("\n\n")
|
|
54
|
+
: "(No research personas defined. Call `spawn_research` without `persona` for an ad-hoc read-only helper.)";
|
|
55
|
+
const askUserAvailable = ctx.isAskUserAvailable();
|
|
56
|
+
const userLanguage = ctx.getUserLanguage();
|
|
57
|
+
const askUserBlock = askUserFragment(askUserAvailable, userLanguage);
|
|
58
|
+
const dispatchSection = dispatchFragment(fleetActive, askUserAvailable, userLanguage);
|
|
59
|
+
const ambiguityRule = ambiguityFragment(askUserAvailable, userLanguage);
|
|
60
|
+
const languageLines = languageFragment(askUserAvailable, userLanguage);
|
|
61
|
+
const stateCapsule = stateCapsuleFragment(ctx.getPromptState(), resolution);
|
|
62
|
+
const stableModeSection = fleetActive ? TASK_TRIAGE_FRAGMENT : "";
|
|
63
|
+
const verificationSection = verificationActive ? verificationFragment(MAX_OPEN_ASSERTIONS) : "";
|
|
64
|
+
const comsSection = comsFragment(peerActive, ctx.isComsReady(), ctx.getIdentity());
|
|
65
|
+
const workModeText = workModePrompt(ctx.getWorkMode());
|
|
66
|
+
const herdrSection = workspaceActive && ctx.isHerdrFleetReady() ? HUB_HERDR_SECTION : "";
|
|
67
|
+
const compactionSection = compactionActive ? COMPACTION_FRAGMENT : "";
|
|
68
|
+
const systemPrompt = assembleHubSystemPrompt({
|
|
69
|
+
intro: workModeText.intro,
|
|
70
|
+
toolList: `these active packs: ${[...modelPacks].join(", ")}. Tools: ${ctx.getActiveTools().map(name => `\`${name}\``).join(", ") || "(none)"}`,
|
|
71
|
+
languageLines,
|
|
72
|
+
activeTeamName: ctx.getActiveTeamName(),
|
|
73
|
+
teamMembers,
|
|
74
|
+
dispatchSection,
|
|
75
|
+
userLanguage,
|
|
76
|
+
askUserBlock,
|
|
77
|
+
modeSection: stableModeSection,
|
|
78
|
+
verificationSection,
|
|
79
|
+
stateCapsule,
|
|
80
|
+
comsSection,
|
|
81
|
+
herdrSection,
|
|
82
|
+
compactionSection,
|
|
83
|
+
hardRules: workModeText.hardRules,
|
|
84
|
+
ambiguityRule,
|
|
85
|
+
agentCatalog,
|
|
86
|
+
researchCatalog,
|
|
87
|
+
});
|
|
88
|
+
const ledger = recordHubLedger(systemPrompt, namedHubLedgerParts({
|
|
89
|
+
intro: workModeText.intro,
|
|
90
|
+
languageLines,
|
|
91
|
+
teamMembers,
|
|
92
|
+
agentCards,
|
|
93
|
+
dispatchSection,
|
|
94
|
+
modeSection: stableModeSection,
|
|
95
|
+
verificationSection,
|
|
96
|
+
stateCapsule,
|
|
97
|
+
researchCards,
|
|
98
|
+
researchCatalog,
|
|
99
|
+
comsSection,
|
|
100
|
+
herdrSection,
|
|
101
|
+
compactionSection,
|
|
102
|
+
})).concat(CAPABILITY_PACKS.map(pack => {
|
|
103
|
+
const status = capabilityStatus(pack, ctx, resolution.active, resolution.provisional);
|
|
104
|
+
return component({
|
|
105
|
+
id: `hub/capability/${pack}`, plane: "hub", category: "system", label: `Capability ${pack}: ${status}`,
|
|
106
|
+
source: resolution.reasons[pack], persistence: "turn", visibility: "ui-only", confidence: "exact-chars", chars: 0,
|
|
107
|
+
});
|
|
108
|
+
}));
|
|
109
|
+
return { systemPrompt, ledger };
|
|
110
|
+
}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
import { unlinkSync } from "node:fs";
|
|
3
|
+
import type { ResearchAgentDef, ResearchRuntime, ResearchState } from "./runtime.ts";
|
|
4
|
+
|
|
5
|
+
export interface ResearchControlPorts<TDef extends ResearchAgentDef> {
|
|
6
|
+
runtime: ResearchRuntime<TDef>;
|
|
7
|
+
refresh(): void;
|
|
8
|
+
restartSpecialist(state: any, ctx: ExtensionContext): Promise<void>;
|
|
9
|
+
getAgents(): Map<string, any>;
|
|
10
|
+
displayName(name: string): string;
|
|
11
|
+
modelWorkBlocked(ctx: ExtensionContext): boolean;
|
|
12
|
+
cancelWait(state: any, kind: "wait_only_cancelled" | "restart"): Promise<void>;
|
|
13
|
+
cancelOwned(state: any): void;
|
|
14
|
+
}
|
|
15
|
+
export interface ResearchControls<TDef extends ResearchAgentDef> {
|
|
16
|
+
remove(state: ResearchState<TDef>, ctx: ExtensionContext): void;
|
|
17
|
+
clear(ctx: ExtensionContext): void;
|
|
18
|
+
restart(state: ResearchState<TDef>, ctx: ExtensionContext): void;
|
|
19
|
+
restartSpecialist(state: any, ctx: ExtensionContext): Promise<void>;
|
|
20
|
+
handleKill(args: string | undefined, ctx: ExtensionContext): Promise<void>;
|
|
21
|
+
handleRestart(args: string | undefined, ctx: ExtensionContext): Promise<void>;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
const researchId = (name: string | undefined) => { const match = name?.match(/^#?r?(\d+)$/i); return match ? parseInt(match[1], 10) : null; };
|
|
25
|
+
const knownTargets = <TDef extends ResearchAgentDef>(ports: ResearchControlPorts<TDef>) => [
|
|
26
|
+
...Array.from(ports.getAgents().values()).map(state => ports.displayName(state.def.name)),
|
|
27
|
+
...Array.from(ports.runtime.states().values()).map(state => `r${state.id}`),
|
|
28
|
+
].join(", ");
|
|
29
|
+
|
|
30
|
+
export function createResearchControls<TDef extends ResearchAgentDef>(ports: ResearchControlPorts<TDef>): ResearchControls<TDef> {
|
|
31
|
+
const remove = (state: ResearchState<TDef>, ctx: ExtensionContext) => {
|
|
32
|
+
if (state.proc && state.status === "running") { state.killedByOperator = true; state.proc.kill("SIGTERM"); ctx.ui.notify(`Research r${state.id} killed and removed.`, "warning"); }
|
|
33
|
+
else ctx.ui.notify(`Research r${state.id} removed.`, "info");
|
|
34
|
+
try { unlinkSync(ports.runtime.sessionPath(state.id)); } catch {}
|
|
35
|
+
ports.runtime.states().delete(state.id); ports.refresh();
|
|
36
|
+
};
|
|
37
|
+
const controls: ResearchControls<TDef> = {
|
|
38
|
+
remove,
|
|
39
|
+
clear(ctx) {
|
|
40
|
+
let killed = 0; const states = ports.runtime.states(); const total = states.size;
|
|
41
|
+
for (const state of Array.from(states.values())) { if (state.proc && state.status === "running") { state.killedByOperator = true; state.proc.kill("SIGTERM"); killed++; } try { unlinkSync(ports.runtime.sessionPath(state.id)); } catch {} }
|
|
42
|
+
ports.runtime.reset(); ports.refresh();
|
|
43
|
+
ctx.ui.notify(total === 0 ? "No research helpers to clear." : `Cleared ${total} research helper${total !== 1 ? "s" : ""}${killed > 0 ? ` (${killed} killed)` : ""}.`, total === 0 ? "info" : "success");
|
|
44
|
+
},
|
|
45
|
+
restart(state, ctx) { state.sessionFile = null; state.turnCount = 1; ports.refresh(); ports.runtime.spawn(state, state.task, ctx).then(result => ports.runtime.deliverFollowUp(state, result)); },
|
|
46
|
+
restartSpecialist: ports.restartSpecialist,
|
|
47
|
+
async handleKill(args, ctx) {
|
|
48
|
+
const name = args?.trim();
|
|
49
|
+
if (name?.toLowerCase() === "all") { controls.clear(ctx); return; }
|
|
50
|
+
const id = researchId(name);
|
|
51
|
+
if (id != null) { const research = ports.runtime.states().get(id); if (!research) ctx.ui.notify(`No research helper "${name}". Known: ${Array.from(ports.runtime.states().values()).map(item => `r${item.id}`).join(", ") || "none"}`, "error"); else controls.remove(research, ctx); return; }
|
|
52
|
+
const state = name ? ports.getAgents().get(name.toLowerCase()) : undefined;
|
|
53
|
+
if (!state) { ctx.ui.notify(`Usage: /af-agents-kill <name|rN|all>. Known: ${knownTargets(ports) || "none"}`, "error"); return; }
|
|
54
|
+
if (state.status !== "running" || (!state.proc && !state.comsAbort)) { ctx.ui.notify(`${ports.displayName(state.def.name)} is not running — nothing to kill.`, "warning"); return; }
|
|
55
|
+
if (!state.proc) { void ports.cancelWait(state, "wait_only_cancelled"); ctx.ui.notify(`Abandoning ${ports.displayName(state.def.name)}'s coms dispatch (the peer pane keeps running)...`, "info"); return; }
|
|
56
|
+
state.killedByOperator = true; ports.cancelOwned(state); ctx.ui.notify(`Killing ${ports.displayName(state.def.name)}...`, "info");
|
|
57
|
+
},
|
|
58
|
+
async handleRestart(args, ctx) {
|
|
59
|
+
if (ports.modelWorkBlocked(ctx)) return;
|
|
60
|
+
const name = args?.trim(); const id = researchId(name);
|
|
61
|
+
if (id != null) {
|
|
62
|
+
const research = ports.runtime.states().get(id);
|
|
63
|
+
if (!research) { ctx.ui.notify(`No research helper "${name}". Known: ${Array.from(ports.runtime.states().values()).map(item => `r${item.id}`).join(", ") || "none"}`, "error"); return; }
|
|
64
|
+
if (research.status === "running") { ctx.ui.notify(`Research r${research.id} is still running — wait for it to finish, or use /af-agents-kill r${research.id} to discard it; a new research request will spawn a fresh helper.`, "warning"); return; }
|
|
65
|
+
if (!research.task) { ctx.ui.notify(`Research r${research.id} has no previous task to restart.`, "warning"); return; }
|
|
66
|
+
ctx.ui.notify(`Restarting research r${research.id} (fresh)...`, "info"); controls.restart(research, ctx); return;
|
|
67
|
+
}
|
|
68
|
+
const state = name ? ports.getAgents().get(name.toLowerCase()) : undefined;
|
|
69
|
+
if (!state) { ctx.ui.notify(`Usage: /af-agents-restart <name|rN>. Known: ${knownTargets(ports) || "none"}`, "error"); return; }
|
|
70
|
+
if (!state.task) { ctx.ui.notify(`${ports.displayName(state.def.name)} has no previous task to restart.`, "warning"); return; }
|
|
71
|
+
ctx.ui.notify(`Restarting ${ports.displayName(state.def.name)} (fresh)...`, "info"); await ports.restartSpecialist(state, ctx);
|
|
72
|
+
},
|
|
73
|
+
};
|
|
74
|
+
return controls;
|
|
75
|
+
}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import type { ChildProcess } from "child_process";
|
|
2
|
+
import { unlinkSync } from "node:fs";
|
|
3
|
+
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
4
|
+
import type { Termination, spawnPiAgentWithModelFallback } from "../spawn.ts";
|
|
5
|
+
import type { TimelineEntry } from "../ui/zoom.ts";
|
|
6
|
+
import type { FleetTranscriptStore } from "../../lib/fleet-transcript-store.ts";
|
|
7
|
+
import type { HistoryEntry, ExecutionHistoryStore } from "../ui/history-store.ts";
|
|
8
|
+
import type { HubStateContext } from "../context/hub-state.ts";
|
|
9
|
+
import type { BudgetContext } from "../context/budgets.ts";
|
|
10
|
+
import type { InputArtifactPreview, AssertionsArtifactsContext } from "../context/assertions-artifacts.ts";
|
|
11
|
+
import type { createProviderSemaphore } from "../provider-semaphore.js";
|
|
12
|
+
import { DEFAULT_RESEARCH_KEEP, selectResearchPrunable } from "../research-retention.js";
|
|
13
|
+
import { safePathWithin } from "../helpers.ts";
|
|
14
|
+
import { runResearchSpawn, type ResearchSpawnPorts } from "./spawn-run.ts";
|
|
15
|
+
|
|
16
|
+
export const RESEARCH_TOOLS = "read,grep,find,ls";
|
|
17
|
+
export const MAX_AUTO_RESEARCH_ROUNDS = 2;
|
|
18
|
+
export const MAX_AUTO_RESEARCH_QUESTIONS = 4;
|
|
19
|
+
|
|
20
|
+
export const ANON_RESEARCH_PROMPT = `# Research Helper
|
|
21
|
+
|
|
22
|
+
You are an ad-hoc read-only research helper assisting a team of specialist agents.
|
|
23
|
+
Locate the relevant code or docs, read the surrounding context, and report concise,
|
|
24
|
+
well-cited findings the rest of the team can act on.`;
|
|
25
|
+
|
|
26
|
+
export interface ResearchAgentDef {
|
|
27
|
+
name: string;
|
|
28
|
+
description: string;
|
|
29
|
+
tools: string;
|
|
30
|
+
model?: string;
|
|
31
|
+
fallbackModel?: string;
|
|
32
|
+
thinking?: string;
|
|
33
|
+
systemPrompt: string;
|
|
34
|
+
file: string;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef> {
|
|
38
|
+
id: number;
|
|
39
|
+
def: TDef;
|
|
40
|
+
persona: boolean;
|
|
41
|
+
ephemeral: boolean;
|
|
42
|
+
model: string;
|
|
43
|
+
status: "idle" | "running" | "done" | "error";
|
|
44
|
+
task: string;
|
|
45
|
+
toolCount: number;
|
|
46
|
+
elapsed: number;
|
|
47
|
+
lastWork: string;
|
|
48
|
+
contextPct: number;
|
|
49
|
+
contextTokens: number;
|
|
50
|
+
sessionFile: string | null;
|
|
51
|
+
turnCount: number;
|
|
52
|
+
finishedAt?: number;
|
|
53
|
+
timer?: ReturnType<typeof setInterval>;
|
|
54
|
+
proc?: ChildProcess;
|
|
55
|
+
killedByOperator?: boolean;
|
|
56
|
+
timeline: TimelineEntry[];
|
|
57
|
+
transcriptStore?: FleetTranscriptStore;
|
|
58
|
+
zoomRender?: (force?: boolean) => void;
|
|
59
|
+
histEntry?: HistoryEntry;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
export interface ResearchResult {
|
|
63
|
+
output: string;
|
|
64
|
+
exitCode: number;
|
|
65
|
+
elapsed: number;
|
|
66
|
+
termination?: Termination;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export interface ResearchRuntimeStatePorts<TDef extends ResearchAgentDef> {
|
|
70
|
+
getResearchStates(): Map<number, ResearchState<TDef>>;
|
|
71
|
+
setResearchStates(value: Map<number, ResearchState<TDef>>): void;
|
|
72
|
+
getNextResearchId(): number;
|
|
73
|
+
setNextResearchId(value: number): void;
|
|
74
|
+
getResearchKeep(): number;
|
|
75
|
+
setResearchKeep(value: number): void;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export interface ResearchRuntimeDeps<TDef extends ResearchAgentDef> extends ResearchRuntimeStatePorts<TDef> {
|
|
79
|
+
hubState: Pick<HubStateContext, "getSessionDir">;
|
|
80
|
+
budget: Pick<BudgetContext, "currentBudget">;
|
|
81
|
+
artifacts: Pick<AssertionsArtifactsContext, "appendInputArtifacts">;
|
|
82
|
+
executionHistory: ExecutionHistoryStore;
|
|
83
|
+
providerSemaphore: ReturnType<typeof createProviderSemaphore>;
|
|
84
|
+
getSafetyHarnessPath(): string | null;
|
|
85
|
+
getReconSearchTimeoutMs(): number | null;
|
|
86
|
+
getContextWindow(): number;
|
|
87
|
+
resolvedModel(def: TDef): string | undefined;
|
|
88
|
+
resolvedThinking(def: TDef): string | undefined;
|
|
89
|
+
resolveThinkingLevel(value: string | undefined): string;
|
|
90
|
+
fallbackModelFor(def: TDef, model: string): string | undefined;
|
|
91
|
+
substitutedModel(model: string | undefined): string | undefined;
|
|
92
|
+
modelWindowLookup(ctx: ExtensionContext): (provider: string, modelId: string) => unknown;
|
|
93
|
+
guardrailEnv(agentId: string): Record<string, string>;
|
|
94
|
+
notifyProviderQueue(model: string, label: string, ctx: ExtensionContext): void;
|
|
95
|
+
spawnPiAgentWithModelFallback: typeof spawnPiAgentWithModelFallback;
|
|
96
|
+
nativeResearchSystemPrompt(input: { personaName?: string; personaPath?: string; cwd: string }): string;
|
|
97
|
+
requireSafetyHarness(path: string | null): { ok: true; extensions: string[] } | { ok: false; error: string };
|
|
98
|
+
shortModel(model: string): string;
|
|
99
|
+
displayName(name: string): string;
|
|
100
|
+
flushTimelineStore(state: ResearchState<TDef>): void;
|
|
101
|
+
appendTimelineText(state: ResearchState<TDef>, kind: "text" | "thinking", content: string): void;
|
|
102
|
+
appendTimelineEvent(state: ResearchState<TDef>, event: TimelineEntry): void;
|
|
103
|
+
createTranscriptStore(path: string): FleetTranscriptStore;
|
|
104
|
+
updateResearchWidget(): void;
|
|
105
|
+
sendResearchMessage(message: { customType: string; content: string; display: true }): void;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
export interface ResearchRuntime<TDef extends ResearchAgentDef = ResearchAgentDef> {
|
|
109
|
+
states(): Map<number, ResearchState<TDef>>;
|
|
110
|
+
reset(): void;
|
|
111
|
+
setRetention(keep: number): void;
|
|
112
|
+
sessionPath(id: number): string;
|
|
113
|
+
anonymousDef(): TDef;
|
|
114
|
+
resolveModel(def: TDef, explicit: string | undefined, ctx: ExtensionContext): string;
|
|
115
|
+
createState(def: TDef, persona: boolean, model: string, ephemeral?: boolean): ResearchState<TDef>;
|
|
116
|
+
prune(): void;
|
|
117
|
+
spawn(state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext, inputArtifacts?: InputArtifactPreview[], signal?: AbortSignal): Promise<ResearchResult>;
|
|
118
|
+
deliverFollowUp(state: ResearchState<TDef>, result: ResearchResult): void;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export function parseResearchHandle(arg: string): number | null {
|
|
122
|
+
const match = arg.trim().match(/^#?r?(\d+)$/i);
|
|
123
|
+
return match ? parseInt(match[1], 10) : null;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: ResearchRuntimeDeps<TDef>): ResearchRuntime<TDef> {
|
|
127
|
+
const sessionPath = (id: number) => safePathWithin(deps.hubState.getSessionDir(), `research-${id}.json`);
|
|
128
|
+
const prune = () => {
|
|
129
|
+
const states = deps.getResearchStates();
|
|
130
|
+
const ids = selectResearchPrunable(Array.from(states.values()), deps.getResearchKeep());
|
|
131
|
+
if (ids.length === 0) return;
|
|
132
|
+
for (const id of ids) {
|
|
133
|
+
try { unlinkSync(sessionPath(id)); } catch {}
|
|
134
|
+
states.delete(id);
|
|
135
|
+
}
|
|
136
|
+
deps.updateResearchWidget();
|
|
137
|
+
};
|
|
138
|
+
const spawnPorts: ResearchSpawnPorts<TDef> = { ...deps, researchTools: RESEARCH_TOOLS, sessionPath, prune };
|
|
139
|
+
|
|
140
|
+
return {
|
|
141
|
+
states: deps.getResearchStates,
|
|
142
|
+
reset() {
|
|
143
|
+
deps.setResearchStates(new Map());
|
|
144
|
+
deps.setNextResearchId(1);
|
|
145
|
+
},
|
|
146
|
+
setRetention(keep) { deps.setResearchKeep(keep); },
|
|
147
|
+
sessionPath,
|
|
148
|
+
anonymousDef() {
|
|
149
|
+
return {
|
|
150
|
+
name: "research", description: "Ad-hoc read-only research helper.", tools: RESEARCH_TOOLS,
|
|
151
|
+
systemPrompt: ANON_RESEARCH_PROMPT, file: "",
|
|
152
|
+
} as TDef;
|
|
153
|
+
},
|
|
154
|
+
resolveModel(def, explicit, ctx) {
|
|
155
|
+
if (explicit) return explicit;
|
|
156
|
+
return deps.resolvedModel(def) || (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
|
|
157
|
+
},
|
|
158
|
+
createState(def, persona, model, ephemeral = false) {
|
|
159
|
+
const id = deps.getNextResearchId();
|
|
160
|
+
deps.setNextResearchId(id + 1);
|
|
161
|
+
const state: ResearchState<TDef> = {
|
|
162
|
+
id, def, persona, ephemeral, model, status: "running", task: "", toolCount: 0,
|
|
163
|
+
elapsed: 0, lastWork: "", contextPct: 0, contextTokens: 0, sessionFile: null,
|
|
164
|
+
turnCount: 1, timeline: [],
|
|
165
|
+
};
|
|
166
|
+
deps.getResearchStates().set(id, state);
|
|
167
|
+
return state;
|
|
168
|
+
},
|
|
169
|
+
prune,
|
|
170
|
+
spawn(state, prompt, ctx, inputArtifacts = [], signal) {
|
|
171
|
+
return runResearchSpawn(spawnPorts, state, prompt, ctx, inputArtifacts, signal);
|
|
172
|
+
},
|
|
173
|
+
deliverFollowUp(state, result) {
|
|
174
|
+
const truncated = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output;
|
|
175
|
+
const label = state.persona ? deps.displayName(state.def.name) : "research";
|
|
176
|
+
deps.sendResearchMessage({
|
|
177
|
+
customType: "research-result", display: true,
|
|
178
|
+
content: `[research r${state.id} · ${label}${state.turnCount > 1 ? ` · Turn ${state.turnCount}` : ""}] ${result.exitCode === 0 ? "finished" : "failed"} in ${Math.round(result.elapsed / 1000)}s.\n\nFindings:\n${truncated}`,
|
|
179
|
+
});
|
|
180
|
+
},
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
export { DEFAULT_RESEARCH_KEEP };
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
import { contextPct, resolveContextWindow } from "../context-window.js";
|
|
3
|
+
import { isReadOnlyToolList, safePathWithin } from "../helpers.ts";
|
|
4
|
+
import { researchTerminationOutcome, researchWatchdogSpawnOptions } from "../research-watchdog.ts";
|
|
5
|
+
import type { InputArtifactPreview } from "../context/assertions-artifacts.ts";
|
|
6
|
+
import type { ResearchAgentDef, ResearchResult, ResearchRuntimeDeps, ResearchState } from "./runtime.ts";
|
|
7
|
+
|
|
8
|
+
export interface ResearchSpawnPorts<TDef extends ResearchAgentDef> extends ResearchRuntimeDeps<TDef> {
|
|
9
|
+
researchTools: string;
|
|
10
|
+
sessionPath(id: number): string;
|
|
11
|
+
prune(): void;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
function finish<TDef extends ResearchAgentDef>(
|
|
15
|
+
deps: ResearchSpawnPorts<TDef>, state: ResearchState<TDef>, status: "idle" | "done" | "error",
|
|
16
|
+
historyStatus: "idle" | "done" | "error", lastWork: string,
|
|
17
|
+
): void {
|
|
18
|
+
state.status = status;
|
|
19
|
+
state.finishedAt = Date.now();
|
|
20
|
+
state.lastWork = lastWork;
|
|
21
|
+
deps.updateResearchWidget();
|
|
22
|
+
state.zoomRender?.(true);
|
|
23
|
+
if (state.histEntry) deps.executionHistory.end(state.histEntry, historyStatus);
|
|
24
|
+
deps.prune();
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function completeOutput<TDef extends ResearchAgentDef>(state: ResearchState<TDef>, res: any): string {
|
|
28
|
+
let output = String(res.output ?? "");
|
|
29
|
+
if (res.modelFallback) {
|
|
30
|
+
output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
|
|
31
|
+
}
|
|
32
|
+
if (res.exitCode !== 0) {
|
|
33
|
+
const errText = String(res.stderr ?? "").trim();
|
|
34
|
+
const tail = errText.length > 1500 ? `...\n${errText.slice(-1500)}` : errText;
|
|
35
|
+
const errBlock = tail ? `\n\n[stderr]\n${tail}` : "";
|
|
36
|
+
output = output ? `${output}${errBlock}` : `Research helper r${state.id} exited with code ${res.exitCode} and produced no output.${errBlock}`;
|
|
37
|
+
}
|
|
38
|
+
return output;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
42
|
+
deps: ResearchSpawnPorts<TDef>, state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext,
|
|
43
|
+
inputArtifacts: InputArtifactPreview[] = [], signal?: AbortSignal,
|
|
44
|
+
): Promise<ResearchResult> {
|
|
45
|
+
const safety = deps.requireSafetyHarness(deps.getSafetyHarnessPath());
|
|
46
|
+
if (!safety.ok) return { output: safety.error, exitCode: 1, elapsed: 0 };
|
|
47
|
+
|
|
48
|
+
state.status = "running";
|
|
49
|
+
state.task = prompt;
|
|
50
|
+
state.toolCount = 0;
|
|
51
|
+
state.elapsed = 0;
|
|
52
|
+
state.lastWork = "";
|
|
53
|
+
state.killedByOperator = false;
|
|
54
|
+
deps.flushTimelineStore(state);
|
|
55
|
+
state.timeline = [];
|
|
56
|
+
state.transcriptStore = deps.createTranscriptStore(safePathWithin(deps.hubState.getSessionDir(), "transcripts", `research-r${state.id}-turn${state.turnCount}.jsonl`));
|
|
57
|
+
deps.updateResearchWidget();
|
|
58
|
+
state.histEntry = deps.executionHistory.start("research", `Research r${state.id}`);
|
|
59
|
+
|
|
60
|
+
const startTime = Date.now();
|
|
61
|
+
state.timer = setInterval(() => {
|
|
62
|
+
state.elapsed = Date.now() - startTime;
|
|
63
|
+
deps.updateResearchWidget();
|
|
64
|
+
}, 1000);
|
|
65
|
+
const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
|
|
66
|
+
const wantThinking = thinkingLevel !== "off";
|
|
67
|
+
const sessionPath = deps.sessionPath(state.id);
|
|
68
|
+
const researchWindow = resolveContextWindow(state.model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
|
|
69
|
+
const fallbackCandidate = deps.substitutedModel(deps.fallbackModelFor(state.def, state.model));
|
|
70
|
+
const fallback = fallbackCandidate === state.model ? undefined : fallbackCandidate;
|
|
71
|
+
let fullText = "";
|
|
72
|
+
deps.notifyProviderQueue(state.model, `Research r${state.id}`, ctx);
|
|
73
|
+
|
|
74
|
+
const res = await deps.providerSemaphore.run(state.model, () => deps.spawnPiAgentWithModelFallback({
|
|
75
|
+
model: state.model, tools: deps.researchTools, thinking: thinkingLevel,
|
|
76
|
+
systemPrompt: deps.nativeResearchSystemPrompt({
|
|
77
|
+
...(state.persona ? { personaName: state.def.name, personaPath: state.def.file } : {}),
|
|
78
|
+
cwd: ctx.cwd || process.cwd(),
|
|
79
|
+
}),
|
|
80
|
+
noSkills: true, noContextFiles: true, sessionFile: sessionPath, resume: !!state.sessionFile,
|
|
81
|
+
prompt: deps.artifacts.appendInputArtifacts(prompt, inputArtifacts), cwd: ctx.cwd || process.cwd(),
|
|
82
|
+
extensions: safety.extensions, env: deps.guardrailEnv(`research-r${state.id}`),
|
|
83
|
+
...researchWatchdogSpawnOptions(deps.getReconSearchTimeoutMs(), signal),
|
|
84
|
+
turnDeadlineMs: deps.budget.currentBudget().agentTurnMs,
|
|
85
|
+
}, fallback, {
|
|
86
|
+
onProcess: process => { state.proc = process; },
|
|
87
|
+
onModelFallback: ({ from, to, reason }) => {
|
|
88
|
+
state.lastWork = `model fallback: ${deps.shortModel(from)} → ${deps.shortModel(to)}`;
|
|
89
|
+
ctx.ui.notify(`Research r${state.id}: overridden model ${from} failed before work began; retrying with persona model ${to} (${reason})`, "warning");
|
|
90
|
+
deps.updateResearchWidget();
|
|
91
|
+
},
|
|
92
|
+
onTextDelta: delta => {
|
|
93
|
+
fullText += delta;
|
|
94
|
+
state.lastWork = fullText.split("\n").filter(line => line.trim()).pop() || "";
|
|
95
|
+
deps.appendTimelineText(state, "text", delta);
|
|
96
|
+
deps.updateResearchWidget();
|
|
97
|
+
state.zoomRender?.();
|
|
98
|
+
},
|
|
99
|
+
onThinkingDelta: delta => {
|
|
100
|
+
if (!wantThinking) return;
|
|
101
|
+
deps.appendTimelineText(state, "thinking", delta);
|
|
102
|
+
state.zoomRender?.();
|
|
103
|
+
},
|
|
104
|
+
onToolStart: (toolName, argStr, callId) => {
|
|
105
|
+
state.toolCount++;
|
|
106
|
+
deps.appendTimelineEvent(state, { kind: "tool-start", title: `Tool: ${toolName}`, content: argStr, timestamp: Date.now(), ...(callId ? { callId } : {}) });
|
|
107
|
+
deps.updateResearchWidget();
|
|
108
|
+
state.zoomRender?.();
|
|
109
|
+
},
|
|
110
|
+
onToolEnd: (toolName, callId, isError, resultText, durationMs) => {
|
|
111
|
+
deps.appendTimelineEvent(state, { kind: "tool-result", title: `Result: ${toolName}`, content: resultText ?? "", timestamp: Date.now(), ...(callId ? { callId } : {}), status: isError ? "error" : "success", ...(durationMs == null ? {} : { durationMs }) });
|
|
112
|
+
state.zoomRender?.();
|
|
113
|
+
},
|
|
114
|
+
onUsage: usage => {
|
|
115
|
+
state.contextTokens = (usage.input || 0) + (usage.cacheRead || 0) + (usage.cacheWrite || 0);
|
|
116
|
+
if (researchWindow.window > 0) {
|
|
117
|
+
state.contextPct = contextPct(usage, researchWindow.window);
|
|
118
|
+
deps.updateResearchWidget();
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
}, { midRun: isReadOnlyToolList(deps.researchTools) }));
|
|
122
|
+
|
|
123
|
+
if (state.timer) clearInterval(state.timer);
|
|
124
|
+
state.elapsed = Date.now() - startTime;
|
|
125
|
+
state.proc = undefined;
|
|
126
|
+
if (res.spawnError) {
|
|
127
|
+
finish(deps, state, "error", "error", `Error: ${res.spawnError}`);
|
|
128
|
+
return { output: `Error spawning research helper: ${res.spawnError}`, exitCode: 1, elapsed: state.elapsed };
|
|
129
|
+
}
|
|
130
|
+
if (res.termination) {
|
|
131
|
+
const outcome = researchTerminationOutcome(state.id, res.termination);
|
|
132
|
+
finish(deps, state, "error", "error", outcome.lastWork);
|
|
133
|
+
return { output: outcome.output, exitCode: outcome.exitCode, elapsed: state.elapsed, termination: res.termination };
|
|
134
|
+
}
|
|
135
|
+
if (state.killedByOperator) {
|
|
136
|
+
state.killedByOperator = false;
|
|
137
|
+
finish(deps, state, "idle", "idle", "(killed by operator)");
|
|
138
|
+
return { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode ?? 143, elapsed: state.elapsed };
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
const status = res.exitCode === 0 ? "done" : "error";
|
|
142
|
+
if (res.exitCode === 0) state.sessionFile = sessionPath;
|
|
143
|
+
finish(deps, state, status, status, String(res.output ?? "").split("\n").filter((line: string) => line.trim()).pop() || "");
|
|
144
|
+
ctx.ui.notify(`Research r${state.id} ${state.status} in ${Math.round(state.elapsed / 1000)}s`, state.status === "done" ? "success" : "error");
|
|
145
|
+
return { output: completeOutput(state, res), exitCode: res.exitCode ?? 1, elapsed: state.elapsed };
|
|
146
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
|
|
3
|
+
export const SESSION_START_STEP_ORDER = [
|
|
4
|
+
"resetSession",
|
|
5
|
+
"restartMonitor",
|
|
6
|
+
"initializeComs",
|
|
7
|
+
"initializeExemptions",
|
|
8
|
+
"loadAgents",
|
|
9
|
+
"applyOverrides",
|
|
10
|
+
"restoreRoster",
|
|
11
|
+
"resolveCapabilities",
|
|
12
|
+
"notifyStartup",
|
|
13
|
+
"updateWidget",
|
|
14
|
+
"installFooter",
|
|
15
|
+
] as const;
|
|
16
|
+
|
|
17
|
+
export type SessionStartStep = (typeof SESSION_START_STEP_ORDER)[number];
|
|
18
|
+
|
|
19
|
+
export type SessionStartContext = ExtensionContext;
|
|
20
|
+
|
|
21
|
+
export type SessionStartDependencies = {
|
|
22
|
+
[K in SessionStartStep]: (ctx: SessionStartContext) => void | Promise<void>;
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
function assertSessionStartDependencies(deps: SessionStartDependencies): void {
|
|
26
|
+
for (const name of SESSION_START_STEP_ORDER) {
|
|
27
|
+
if (typeof deps[name] !== "function") {
|
|
28
|
+
throw new TypeError(`session_start dependency "${name}" must be a function`);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export async function runSessionStart(ctx: SessionStartContext, deps: SessionStartDependencies): Promise<void> {
|
|
34
|
+
assertSessionStartDependencies(deps);
|
|
35
|
+
for (const name of SESSION_START_STEP_ORDER) await deps[name](ctx);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** Register the lifecycle hook while keeping all mutable Hub state composition-owned. */
|
|
39
|
+
export function registerSessionStart(pi: ExtensionAPI, deps: SessionStartDependencies): void {
|
|
40
|
+
assertSessionStartDependencies(deps);
|
|
41
|
+
pi.on("session_start", async (_event, ctx) => runSessionStart(ctx, deps));
|
|
42
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { redactTimelineEvent, type FleetTranscriptStore } from "../lib/fleet-transcript-store.ts";
|
|
2
|
+
import type { TimelineEntry } from "./ui/zoom.ts";
|
|
3
|
+
|
|
4
|
+
const MAX_LIVE_TIMELINE_ENTRIES = 500;
|
|
5
|
+
export const MAX_LIVE_ENTRY_CHARS = 64 * 1024;
|
|
6
|
+
|
|
7
|
+
export type TimelineTarget = {
|
|
8
|
+
timeline: TimelineEntry[];
|
|
9
|
+
transcriptStore?: FleetTranscriptStore;
|
|
10
|
+
transcriptPending?: TimelineEntry;
|
|
11
|
+
transcriptFlushTimer?: ReturnType<typeof setTimeout>;
|
|
12
|
+
zoomRender?: (force?: boolean) => void;
|
|
13
|
+
};
|
|
14
|
+
|
|
15
|
+
export function flushTimelineStore(target: TimelineTarget): void {
|
|
16
|
+
if (target.transcriptFlushTimer) clearTimeout(target.transcriptFlushTimer);
|
|
17
|
+
target.transcriptFlushTimer = undefined;
|
|
18
|
+
if (!target.transcriptPending) return;
|
|
19
|
+
target.transcriptStore?.append(target.transcriptPending as any);
|
|
20
|
+
target.transcriptPending = undefined;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function appendTimelineEvent(target: TimelineTarget, event: TimelineEntry): TimelineEntry {
|
|
24
|
+
flushTimelineStore(target);
|
|
25
|
+
const safe = redactTimelineEvent(event) as TimelineEntry;
|
|
26
|
+
target.transcriptStore?.append(safe as any);
|
|
27
|
+
target.timeline.push({ ...safe, content: safe.content.slice(-MAX_LIVE_ENTRY_CHARS) });
|
|
28
|
+
if (target.timeline.length > MAX_LIVE_TIMELINE_ENTRIES) target.timeline.splice(0, target.timeline.length - MAX_LIVE_TIMELINE_ENTRIES);
|
|
29
|
+
return safe;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function appendTimelineText(target: TimelineTarget, kind: "text" | "thinking", delta: string): void {
|
|
33
|
+
if (!delta) return;
|
|
34
|
+
const safe = redactTimelineEvent({ kind, title: kind === "text" ? "Assistant" : "Thinking", content: delta, timestamp: Date.now() }) as TimelineEntry;
|
|
35
|
+
if (target.transcriptPending?.kind === kind) target.transcriptPending.content += safe.content;
|
|
36
|
+
else { flushTimelineStore(target); target.transcriptPending = { ...safe }; }
|
|
37
|
+
if (!target.transcriptFlushTimer) {
|
|
38
|
+
target.transcriptFlushTimer = setTimeout(() => { flushTimelineStore(target); target.zoomRender?.(); }, 100);
|
|
39
|
+
try { (target.transcriptFlushTimer as any).unref?.(); } catch {}
|
|
40
|
+
}
|
|
41
|
+
let remaining = safe.content;
|
|
42
|
+
while (remaining) {
|
|
43
|
+
const last = target.timeline[target.timeline.length - 1];
|
|
44
|
+
if (last && last.kind === kind && last.content.length < MAX_LIVE_ENTRY_CHARS) {
|
|
45
|
+
const room = MAX_LIVE_ENTRY_CHARS - last.content.length;
|
|
46
|
+
last.content += remaining.slice(0, room);
|
|
47
|
+
remaining = remaining.slice(room);
|
|
48
|
+
} else {
|
|
49
|
+
target.timeline.push({ ...safe, content: remaining.slice(0, MAX_LIVE_ENTRY_CHARS) });
|
|
50
|
+
remaining = remaining.slice(MAX_LIVE_ENTRY_CHARS);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
if (target.timeline.length > MAX_LIVE_TIMELINE_ENTRIES) target.timeline.splice(0, target.timeline.length - MAX_LIVE_TIMELINE_ENTRIES);
|
|
54
|
+
}
|