@chankov/agent-fleet 0.0.6 → 0.0.7
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/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/harnesses/agent-hub/README.md +75 -16
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +58 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +723 -159
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +29 -3
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +4 -3
- package/.pi/harnesses/coms/index.ts +80 -58
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +134 -0
- package/README.md +175 -18
- package/agents/code-reviewer.md +2 -2
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +40 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +64 -12
- package/docs/agent-fleet-setup.md +2 -2
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +10 -0
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
|
@@ -70,7 +70,7 @@ import {
|
|
|
70
70
|
type AutocompleteItem, truncateToWidth, visibleWidth,
|
|
71
71
|
} from "@mariozechner/pi-tui";
|
|
72
72
|
import { spawn, type ChildProcess } from "child_process";
|
|
73
|
-
import { spawnPiAgent, killPiTree, type PiRunControl, type Termination } from "./spawn.ts";
|
|
73
|
+
import { spawnPiAgent, spawnPiAgentWithModelFallback, killPiTree, type PiRunControl, type SpawnPiAgentCallbacks, type SpawnPiAgentOptions, type Termination } from "./spawn.ts";
|
|
74
74
|
import { researchTerminationOutcome, researchWatchdogSpawnOptions } from "./research-watchdog.ts";
|
|
75
75
|
import { renderHubFooterLeft } from "./footer.ts";
|
|
76
76
|
import { HARNESS_VERSION, registerVersionStatus } from "./version.ts";
|
|
@@ -80,33 +80,42 @@ import { MonitorRegistry } from "../lib/hermes-monitor-registry.ts";
|
|
|
80
80
|
import { MonitorStore } from "../lib/hermes-monitor-store.ts";
|
|
81
81
|
import { createMonitorSessionBridge } from "./monitor-session-bridge.ts";
|
|
82
82
|
import { MonitorRuntime } from "./monitor-runtime.ts";
|
|
83
|
+
import { MonitorEventJournal } from "../lib/hermes-monitor-events.ts";
|
|
84
|
+
import { MonitorInvokeJournal } from "./monitor-invoke-journal.ts";
|
|
85
|
+
import { createMonitorInvokeAdmission, createWatchdogFollowUpEnqueue } from "./monitor-invoke.ts";
|
|
83
86
|
import { monitorReconcileEvidence, stableMonitorHubId } from "./monitor-recovery.ts";
|
|
84
87
|
import {
|
|
85
88
|
AGENT_ID_ENV, ASK_ENDPOINT_ENV, EXEMPTIONS_FILE_ENV,
|
|
86
89
|
exemptionsFilePath, type AccessRequest,
|
|
87
90
|
} from "../lib/damage-control-shared.ts";
|
|
88
|
-
import { clampDelegateDepth, DELEGATE_TREE_SPAWN_BUDGET, MAX_DELEGATE_DEPTH, normalizeAgentInput, parseTeamsYaml, safeAgentKey, safePathWithin, taskFingerprint, upsertTeamInYaml } from "./helpers.ts";
|
|
89
|
-
import { DEFAULT_HUB_MODE, DEFAULT_TASK_TIER, HUB_MODES, TASK_TIERS, budgetStatusLine, checkTurnBudget, normalizeHubMode, normalizeTaskTier, resolveTurnBudget, shouldRecycleSession } from "./run-budget.js";
|
|
90
|
-
import {
|
|
91
|
+
import { applyModelOverride, clampDelegateDepth, DELEGATE_TREE_SPAWN_BUDGET, fallbackModelFor, isReadOnlyToolList, MAX_DELEGATE_DEPTH, normalizeAgentInput, parseTeamsYaml, safeAgentKey, safePathWithin, taskFingerprint, upsertTeamInYaml } from "./helpers.ts";
|
|
92
|
+
import { DEFAULT_HUB_MODE, DEFAULT_TASK_TIER, HUB_MODES, TASK_TIERS, budgetStatusLine, checkTurnBudget, contextOverflowDiagnostic, normalizeHubMode, normalizeTaskTier, resolveTurnBudget, shouldRecycleSession } from "./run-budget.js";
|
|
93
|
+
import { MAX_OPEN_ASSERTIONS, validateAssertionBatch } from "./assertion-ledger.js";
|
|
94
|
+
import { DEFAULT_PROVIDER_LIMITS, createProviderSemaphore, parseProviderLimits } from "./provider-semaphore.js";
|
|
95
|
+
import { PEER_READY_TIMEOUT_MS, peerReadyDelayMs, peerReadyVerdict, unaddressedPeerSweep } from "./spawned-peers.js";
|
|
96
|
+
import { contextPct, estimatePromptTokens, overWindowDiagnostic, resolveContextWindow, shouldRecycleBeforeSpawn } from "./context-window.js";
|
|
97
|
+
import { DEFAULT_WATCHDOG_SETTING, WATCHDOG_SETTINGS, buildJudgePrompt, createDriftMonitor, hubOwnedScopeGlobs, normalizeWatchdogSetting, parseJudgeVerdict, resolveWatchdogActive } from "./drift-watchdog.js";
|
|
98
|
+
import { forceQuarantineSession, isCorruptSessionExit, quarantineIfUnusable } from "./session-health.js";
|
|
99
|
+
import { EXTRACTION_DEADLINE_MS, EXTRACTION_MODEL, buildExtractionPrompt, extractionSessionName, shouldExtractReturn } from "./return-extract.js";
|
|
91
100
|
import { artifactPreviewFromText, formatInputArtifactsSection, resolveArtifactPaths, ARTIFACT_KINDS } from "./artifacts.js";
|
|
92
|
-
import { crossCheck, extractAssertionIds, parseStructuredReturn } from "./return-contract.js";
|
|
101
|
+
import { crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn, parseStructuredReturn } from "./return-contract.js";
|
|
93
102
|
import { checkScope, diffAgainst, snapshotWorktree } from "./scope-gate.js";
|
|
94
103
|
import { validateEvidence } from "./evidence-rules.js";
|
|
95
104
|
import { comsRequiredRefusal, parseDispatchPolicy, resolveDispatchBackend } from "./backend-policy.js";
|
|
96
105
|
import { DEFAULT_RESEARCH_KEEP, parseResearchKeep, selectResearchPrunable } from "./research-retention.js";
|
|
97
106
|
import { requireSafetyHarness, resolveSafetyHarness } from "./safety-routing.ts";
|
|
98
107
|
import { createAccessApprovalRouter } from "./access-approval.ts";
|
|
99
|
-
import { readdirSync, readFileSync, existsSync, mkdirSync, unlinkSync, writeFileSync, rmSync } from "fs";
|
|
108
|
+
import { readdirSync, readFileSync, existsSync, mkdirSync, renameSync, unlinkSync, writeFileSync, rmSync } from "fs";
|
|
100
109
|
import {
|
|
101
|
-
formatPeerStatus,
|
|
102
110
|
HerdrAgentWatch,
|
|
103
111
|
HerdrPresence,
|
|
104
112
|
herdrPaneId,
|
|
105
113
|
herdrPresenceAvailable,
|
|
106
|
-
|
|
114
|
+
peerNameFrom,
|
|
107
115
|
type HerdrAgentInfo,
|
|
108
116
|
} from "../lib/herdr-presence.ts";
|
|
109
117
|
import { herdr as herdrApi, herdrAvailable } from "../lib/herdr-client.ts";
|
|
118
|
+
import { buildLiveRegistryEntry, type ComsRegistryEntry } from "../lib/coms-registry-entry.ts";
|
|
110
119
|
import { peerCommand } from "../../../scripts/lib/herdr-layout.ts";
|
|
111
120
|
import { join, resolve } from "path";
|
|
112
121
|
import * as net from "node:net";
|
|
@@ -123,6 +132,8 @@ interface AgentDef {
|
|
|
123
132
|
description: string;
|
|
124
133
|
tools: string;
|
|
125
134
|
model?: string;
|
|
135
|
+
// Original frontmatter model retained when project/session overrides apply.
|
|
136
|
+
fallbackModel?: string;
|
|
126
137
|
// Allowed switch targets for /af-agent-model and model profiles (frontmatter
|
|
127
138
|
// `models:` list). The default `model:` is implicitly a candidate too.
|
|
128
139
|
models?: string[];
|
|
@@ -186,6 +197,8 @@ interface InputArtifactPreview {
|
|
|
186
197
|
path: string;
|
|
187
198
|
displayPath: string;
|
|
188
199
|
preview: string;
|
|
200
|
+
/** Set when the file was found under a different artifact kind than requested. */
|
|
201
|
+
resolvedFromKind?: string | null;
|
|
189
202
|
}
|
|
190
203
|
|
|
191
204
|
interface AgentState {
|
|
@@ -196,6 +209,10 @@ interface AgentState {
|
|
|
196
209
|
elapsed: number;
|
|
197
210
|
lastWork: string;
|
|
198
211
|
contextPct: number;
|
|
212
|
+
// Last measured prompt size in tokens (input + cache reads + writes). Kept
|
|
213
|
+
// alongside contextPct because the pre-spawn guard needs the absolute number:
|
|
214
|
+
// a percentage cannot be compared against a window it was not divided by.
|
|
215
|
+
contextTokens: number;
|
|
199
216
|
sessionFile: string | null;
|
|
200
217
|
runCount: number;
|
|
201
218
|
// Runs served by the CURRENT accumulated session (-c resume chain). Reset on
|
|
@@ -642,6 +659,8 @@ function parseModelProfilesYaml(raw: string): Record<string, Record<string, stri
|
|
|
642
659
|
interface SubagentRole {
|
|
643
660
|
model: string;
|
|
644
661
|
tools?: string;
|
|
662
|
+
// Original role model retained across project/session overrides.
|
|
663
|
+
fallbackModel?: string;
|
|
645
664
|
}
|
|
646
665
|
|
|
647
666
|
// Inline forms of a subagents role value: `role: <model-spec>` shorthand or
|
|
@@ -1286,6 +1305,7 @@ interface PromptEnvelope extends Envelope {
|
|
|
1286
1305
|
sender_cwd: string;
|
|
1287
1306
|
conversation_id?: string | null;
|
|
1288
1307
|
response_schema?: object | null;
|
|
1308
|
+
reply_timeout_ms?: number | null;
|
|
1289
1309
|
}
|
|
1290
1310
|
|
|
1291
1311
|
interface ResponseEnvelope extends Envelope {
|
|
@@ -1305,6 +1325,8 @@ interface AgentCard {
|
|
|
1305
1325
|
color: string;
|
|
1306
1326
|
context_used_pct: number;
|
|
1307
1327
|
queue_depth: number;
|
|
1328
|
+
pane_id?: string | null;
|
|
1329
|
+
status?: "idle" | "working" | "booting";
|
|
1308
1330
|
}
|
|
1309
1331
|
|
|
1310
1332
|
interface Pong {
|
|
@@ -1313,24 +1335,10 @@ interface Pong {
|
|
|
1313
1335
|
agent_card: AgentCard;
|
|
1314
1336
|
}
|
|
1315
1337
|
|
|
1316
|
-
|
|
1317
|
-
|
|
1318
|
-
|
|
1319
|
-
|
|
1320
|
-
model: string;
|
|
1321
|
-
color: string;
|
|
1322
|
-
pid: number;
|
|
1323
|
-
endpoint: string;
|
|
1324
|
-
cwd: string;
|
|
1325
|
-
started_at: string;
|
|
1326
|
-
explicit: boolean;
|
|
1327
|
-
version: number;
|
|
1328
|
-
// Live status snapshot — refreshed every KEEPALIVE_INTERVAL_MS by the heartbeat.
|
|
1329
|
-
// Optional so older entries (pre-heartbeat-refresh) still parse cleanly.
|
|
1330
|
-
context_used_pct?: number;
|
|
1331
|
-
queue_depth?: number;
|
|
1332
|
-
heartbeat_at?: string;
|
|
1333
|
-
}
|
|
1338
|
+
// The registry shape and the heartbeat builder are shared with the standalone
|
|
1339
|
+
// coms harness — see ../lib/coms-registry-entry.ts. Both used to keep their own
|
|
1340
|
+
// copy of this literal, and both refreshed `started_at` every 30 seconds.
|
|
1341
|
+
type RegistryEntry = ComsRegistryEntry;
|
|
1334
1342
|
|
|
1335
1343
|
interface PendingReply {
|
|
1336
1344
|
resolve: (value: any) => void;
|
|
@@ -1769,6 +1777,8 @@ export default function (pi: ExtensionAPI) {
|
|
|
1769
1777
|
model: string;
|
|
1770
1778
|
endpoint: string;
|
|
1771
1779
|
registryFile: string;
|
|
1780
|
+
// Set once, at registration. The heartbeat reads it; nothing rewrites it.
|
|
1781
|
+
started_at: string;
|
|
1772
1782
|
} | null = null;
|
|
1773
1783
|
const peerCards: Map<string, AgentCard & { staleCount: number }> = new Map();
|
|
1774
1784
|
const pendingReplies: Map<string, PendingReply> = new Map();
|
|
@@ -1776,7 +1786,9 @@ export default function (pi: ExtensionAPI) {
|
|
|
1776
1786
|
let server: net.Server | null = null;
|
|
1777
1787
|
let monitorLifecycle: ReturnType<typeof createMonitorLifecycle> | null = null;
|
|
1778
1788
|
let monitorHubId: string | null = null;
|
|
1789
|
+
let monitorTurnId: string | null = null;
|
|
1779
1790
|
let monitorBridge: ReturnType<typeof createMonitorSessionBridge> | null = null;
|
|
1791
|
+
let monitorOwnerId: string | undefined;
|
|
1780
1792
|
let pingTimer: NodeJS.Timeout | null = null;
|
|
1781
1793
|
let keepaliveTimer: NodeJS.Timeout | null = null;
|
|
1782
1794
|
// herdr presence backend (active when this session runs inside a herdr
|
|
@@ -1934,9 +1946,9 @@ export default function (pi: ExtensionAPI) {
|
|
|
1934
1946
|
let gridCols = 2;
|
|
1935
1947
|
// View mode toggled by Alt+A: "dashboard" = full bordered card grid above the
|
|
1936
1948
|
// editor; "compact" = one line per *running* agent (name · context · state)
|
|
1937
|
-
// rendered BELOW the editor, just above the footer.
|
|
1938
|
-
//
|
|
1939
|
-
let viewMode: "dashboard" | "compact" = "
|
|
1949
|
+
// rendered BELOW the editor, just above the footer. Compact is the default;
|
|
1950
|
+
// idle/done agents are hidden so an idle session shows only the prompt + footer.
|
|
1951
|
+
let viewMode: "dashboard" | "compact" = "compact";
|
|
1940
1952
|
// Compact-view agent switcher: the key of the marked subagent (lowercase persona
|
|
1941
1953
|
// name for team specialists, `rN` for research helpers — matching /af-zoom
|
|
1942
1954
|
// resolution), or null when nothing is marked. main is never listed (it is the
|
|
@@ -1946,6 +1958,36 @@ export default function (pi: ExtensionAPI) {
|
|
|
1946
1958
|
let widgetCtx: any;
|
|
1947
1959
|
let sessionDir = "";
|
|
1948
1960
|
let contextWindow = 0;
|
|
1961
|
+
// Per-provider in-flight cap for the hub's OWN spawns (specialists and
|
|
1962
|
+
// research helpers, which the dispatcher can start in parallel). Delegate
|
|
1963
|
+
// children are gated by the same policy inside their parent's process. The
|
|
1964
|
+
// drift judge and the return extractor are deliberately NOT gated: both run
|
|
1965
|
+
// while a specialist holds a permit, so queueing them behind that specialist
|
|
1966
|
+
// would stall the very watchdog that is supposed to stop it.
|
|
1967
|
+
const providerSemaphore = createProviderSemaphore({
|
|
1968
|
+
...DEFAULT_PROVIDER_LIMITS,
|
|
1969
|
+
...parseProviderLimits(process.env.AGENT_HUB_PROVIDER_LIMITS),
|
|
1970
|
+
});
|
|
1971
|
+
/**
|
|
1972
|
+
* pi's model registry as a plain lookup — the documented source for every
|
|
1973
|
+
* model's window, and the same one the dispatcher's own window comes from.
|
|
1974
|
+
*/
|
|
1975
|
+
function modelWindowLookup(ctx: any): (provider: string, modelId: string) => any {
|
|
1976
|
+
return (provider, modelId) => ctx?.modelRegistry?.find?.(provider, modelId);
|
|
1977
|
+
}
|
|
1978
|
+
|
|
1979
|
+
/** Say so when a run is about to wait on a provider permit, not just hang. */
|
|
1980
|
+
function notifyProviderQueue(model: string, label: string, ctx: any): void {
|
|
1981
|
+
const cap = providerSemaphore.limitFor(model);
|
|
1982
|
+
if (cap == null || providerSemaphore.inFlight(model) < cap) return;
|
|
1983
|
+
const ahead = providerSemaphore.queued(model) + 1;
|
|
1984
|
+
ctx?.ui?.notify(
|
|
1985
|
+
`${label}: queued — ${cap} requests already in flight on this provider (${ahead} waiting). ` +
|
|
1986
|
+
"Raise or disable the cap with AGENT_HUB_PROVIDER_LIMITS (e.g. custom=4, custom=off).",
|
|
1987
|
+
"info",
|
|
1988
|
+
);
|
|
1989
|
+
}
|
|
1990
|
+
|
|
1949
1991
|
let activeWritableDispatches = 0;
|
|
1950
1992
|
let writableOverlapCounter = 0;
|
|
1951
1993
|
let pendingHandoff: { target: string; token: string } | null = null;
|
|
@@ -2069,6 +2111,7 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2069
2111
|
id: string; // A1, A2, …
|
|
2070
2112
|
tag: string; // test | runtime-ui | code-grep | manual
|
|
2071
2113
|
text: string; // one checkable pass condition
|
|
2114
|
+
source: string; // where it came from — plan/spec line, user request, finding id
|
|
2072
2115
|
status: AssertionStatus;
|
|
2073
2116
|
evidence?: string; // named evidence for proven / failed
|
|
2074
2117
|
}
|
|
@@ -2095,7 +2138,8 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2095
2138
|
function renderAssertionLedgerLines(): string[] {
|
|
2096
2139
|
return assertions.map(a => {
|
|
2097
2140
|
const ev = a.evidence ? ` — evidence: ${a.evidence}` : "";
|
|
2098
|
-
|
|
2141
|
+
const src = a.source ? ` ⇐ ${a.source}` : "";
|
|
2142
|
+
return `${a.id} [${a.tag}] ${a.status.toUpperCase()}: ${a.text}${src}${ev}`;
|
|
2099
2143
|
});
|
|
2100
2144
|
}
|
|
2101
2145
|
|
|
@@ -2212,11 +2256,16 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2212
2256
|
return `\n\n⚠ Scope advisory: changed outside declared scope: ${scopeViolations.outOfScope.join(", ")}. Review these paths and decide whether to accept them or explicitly order cleanup; the hub did not revert anything.${overlap}`;
|
|
2213
2257
|
}
|
|
2214
2258
|
|
|
2215
|
-
|
|
2259
|
+
/**
|
|
2260
|
+
* Persist a run's output. `kind` is "returns" for a run that completed and
|
|
2261
|
+
* "failures" for one that errored or timed out — an error stub filed as a
|
|
2262
|
+
* return reads as a specialist verdict and is acted on as one.
|
|
2263
|
+
*/
|
|
2264
|
+
function writeRunArtifact(agentKey: string, runCount: number, output: string, kind: "returns" | "failures" = "returns"): string {
|
|
2216
2265
|
const root = ensureArtifactsLayout();
|
|
2217
|
-
const
|
|
2218
|
-
mkdirSync(
|
|
2219
|
-
const file = safePathWithin(
|
|
2266
|
+
const dir = safePathWithin(root, kind);
|
|
2267
|
+
mkdirSync(dir, { recursive: true });
|
|
2268
|
+
const file = safePathWithin(dir, `${agentKey}-run${runCount}.md`);
|
|
2220
2269
|
writeFileSync(file, output, "utf-8");
|
|
2221
2270
|
return file;
|
|
2222
2271
|
}
|
|
@@ -2285,7 +2334,10 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2285
2334
|
lines.push(`${key}:`);
|
|
2286
2335
|
for (const entry of entries) {
|
|
2287
2336
|
const evidence = entry.evidence ? ` — evidence: ${entry.evidence}` : "";
|
|
2288
|
-
|
|
2337
|
+
// Line-form verdicts carry evidence and no separate note; printing
|
|
2338
|
+
// "(no note)" next to real evidence is noise, not information.
|
|
2339
|
+
const note = entry.note || (entry.evidence ? "" : "(no note)");
|
|
2340
|
+
lines.push(`- ${entry.id}${note ? `: ${note}` : ""}${evidence}`);
|
|
2289
2341
|
}
|
|
2290
2342
|
}
|
|
2291
2343
|
for (const key of ["changed_files", "tests_run", "open_risks", "requires_user_decision"]) {
|
|
@@ -2376,9 +2428,33 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2376
2428
|
}
|
|
2377
2429
|
}
|
|
2378
2430
|
|
|
2379
|
-
|
|
2380
|
-
|
|
2381
|
-
|
|
2431
|
+
// Only the first record decides whether pi will accept a session file, and these
|
|
2432
|
+
// files reach megabytes (one observed at 2.1 MB) — so read a head slice, not the
|
|
2433
|
+
// whole thing. This check runs on every dispatch and every team activation.
|
|
2434
|
+
const SESSION_HEAD_BYTES = 64 * 1024;
|
|
2435
|
+
function readSessionHead(file: string): string {
|
|
2436
|
+
const fd = fs.openSync(file, "r");
|
|
2437
|
+
try {
|
|
2438
|
+
const buf = Buffer.alloc(SESSION_HEAD_BYTES);
|
|
2439
|
+
const read = fs.readSync(fd, buf, 0, SESSION_HEAD_BYTES, 0);
|
|
2440
|
+
return buf.subarray(0, read).toString("utf-8");
|
|
2441
|
+
} finally {
|
|
2442
|
+
fs.closeSync(fd);
|
|
2443
|
+
}
|
|
2444
|
+
}
|
|
2445
|
+
const sessionHealthIo = { existsSync, readFileSync: readSessionHead, renameSync };
|
|
2446
|
+
|
|
2447
|
+
// Would the persona's on-disk session file survive contact with pi? A corrupt
|
|
2448
|
+
// one must never be adopted: doing so is what made every `builder` dispatch
|
|
2449
|
+
// fail in ~1s, and re-adding the agent re-adopted the same bad file, so
|
|
2450
|
+
// drop + add looked like a recovery that could not work.
|
|
2451
|
+
function adoptableSessionFile(def: AgentDef): { file: string | null; quarantined: string | null; reason: string | null } {
|
|
2452
|
+
const sessionFile = safePathWithin(sessionDir, `${safeAgentKey(def.name)}.json`);
|
|
2453
|
+
const health = quarantineIfUnusable(sessionFile, sessionHealthIo);
|
|
2454
|
+
return { file: health.usable ? sessionFile : null, quarantined: health.quarantined, reason: health.reason };
|
|
2455
|
+
}
|
|
2456
|
+
|
|
2457
|
+
function freshAgentState(def: AgentDef, adoption = adoptableSessionFile(def)): AgentState {
|
|
2382
2458
|
return {
|
|
2383
2459
|
def,
|
|
2384
2460
|
status: "idle",
|
|
@@ -2387,7 +2463,8 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2387
2463
|
elapsed: 0,
|
|
2388
2464
|
lastWork: "",
|
|
2389
2465
|
contextPct: 0,
|
|
2390
|
-
|
|
2466
|
+
contextTokens: 0,
|
|
2467
|
+
sessionFile: adoption.file,
|
|
2391
2468
|
runCount: 0,
|
|
2392
2469
|
runsSinceFresh: 0,
|
|
2393
2470
|
timeline: [],
|
|
@@ -2429,10 +2506,14 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2429
2506
|
if (agentStates.has(def.name.toLowerCase())) {
|
|
2430
2507
|
return { ok: false, message: `${displayName(def.name)} is already in the active team` };
|
|
2431
2508
|
}
|
|
2432
|
-
|
|
2509
|
+
const adoption = adoptableSessionFile(def);
|
|
2510
|
+
agentStates.set(def.name.toLowerCase(), freshAgentState(def, adoption));
|
|
2433
2511
|
recomputeGrid();
|
|
2434
2512
|
updateWidget();
|
|
2435
|
-
|
|
2513
|
+
const quarantineNote = adoption.quarantined
|
|
2514
|
+
? ` — its previous session file was unusable (${adoption.reason}) and was quarantined to ${adoption.quarantined}; it starts clean`
|
|
2515
|
+
: "";
|
|
2516
|
+
return { ok: true, message: `${displayName(def.name)} added to the active team${quarantineNote}` };
|
|
2436
2517
|
}
|
|
2437
2518
|
|
|
2438
2519
|
function rosterDrop(name: string): { ok: boolean; message: string } {
|
|
@@ -2450,7 +2531,20 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2450
2531
|
agentStates.delete(key);
|
|
2451
2532
|
recomputeGrid();
|
|
2452
2533
|
updateWidget();
|
|
2453
|
-
|
|
2534
|
+
// Promise a reusable session file only when pi would actually accept it.
|
|
2535
|
+
// The old unconditional "kept for re-adding" is what made a corrupt file
|
|
2536
|
+
// look re-addable: the dispatcher dropped the agent, added it back, and got
|
|
2537
|
+
// the same instant failures.
|
|
2538
|
+
const health = quarantineIfUnusable(
|
|
2539
|
+
safePathWithin(sessionDir, `${safeAgentKey(state.def.name)}.json`),
|
|
2540
|
+
sessionHealthIo,
|
|
2541
|
+
);
|
|
2542
|
+
const fileNote = health.usable
|
|
2543
|
+
? " (its session file is kept for re-adding)"
|
|
2544
|
+
: health.quarantined
|
|
2545
|
+
? ` (its session file was unusable — ${health.reason} — and was quarantined to ${health.quarantined}; re-adding starts clean)`
|
|
2546
|
+
: " (it has no session file; re-adding starts clean)";
|
|
2547
|
+
return { ok: true, message: `${displayName(state.def.name)} dropped from the active team${fileNote}` };
|
|
2454
2548
|
}
|
|
2455
2549
|
|
|
2456
2550
|
// ── Grid Rendering ───────────────────────────
|
|
@@ -2923,6 +3017,16 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
2923
3017
|
}
|
|
2924
3018
|
}
|
|
2925
3019
|
child.zoomRender?.();
|
|
3020
|
+
} else if (e.t === "model_fallback") {
|
|
3021
|
+
child.model = e.to || child.model;
|
|
3022
|
+
child.lastWork = `model fallback: ${e.from || "override"} → ${e.to || "original"}`;
|
|
3023
|
+
child.timeline.push({
|
|
3024
|
+
kind: "text",
|
|
3025
|
+
title: "Model fallback",
|
|
3026
|
+
content: `${e.from || "override"} failed before work began; retrying with ${e.to || "original"}. ${e.reason || ""}`.trim(),
|
|
3027
|
+
timestamp: Date.now(),
|
|
3028
|
+
});
|
|
3029
|
+
child.zoomRender?.();
|
|
2926
3030
|
} else if (e.t === "tool") {
|
|
2927
3031
|
child.toolCount++;
|
|
2928
3032
|
child.timeline.push({
|
|
@@ -3011,7 +3115,7 @@ APIs, commands, structure), say so in your final response so the docs can be upd
|
|
|
3011
3115
|
ctx: any,
|
|
3012
3116
|
inputArtifacts: InputArtifactPreview[],
|
|
3013
3117
|
scopeGlobs: string[],
|
|
3014
|
-
): Promise<{ output: string; exitCode: number; elapsed: number; abandoned?: boolean } | null> {
|
|
3118
|
+
): Promise<{ output: string; exitCode: number; elapsed: number; abandoned?: boolean; pending?: boolean } | null> {
|
|
3015
3119
|
const peer = resolveTarget(peerName);
|
|
3016
3120
|
if (!peer || !identity) {
|
|
3017
3121
|
if (allowNativeFallback) return null;
|
|
@@ -3052,6 +3156,7 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3052
3156
|
prompt,
|
|
3053
3157
|
conversation_id: null,
|
|
3054
3158
|
response_schema: null,
|
|
3159
|
+
reply_timeout_ms: timeoutMs,
|
|
3055
3160
|
};
|
|
3056
3161
|
try {
|
|
3057
3162
|
await sendEnvelope(peer.endpoint, env);
|
|
@@ -3072,12 +3177,10 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3072
3177
|
rejectFn = rej;
|
|
3073
3178
|
});
|
|
3074
3179
|
const entry: PendingReply = { resolve: resolveFn, reject: rejectFn, timer: null, promise, target_name: peer.name, created_at: nowIso() };
|
|
3075
|
-
|
|
3076
|
-
|
|
3077
|
-
entry.
|
|
3078
|
-
|
|
3079
|
-
}, timeoutMs);
|
|
3080
|
-
try { (entry.timer as any).unref?.(); } catch { /* ignore */ }
|
|
3180
|
+
const timeoutPromise = new Promise<{ error: string }>((resolve) => {
|
|
3181
|
+
entry.timer = setTimeout(() => resolve({ error: "timeout" }), timeoutMs);
|
|
3182
|
+
try { (entry.timer as any).unref?.(); } catch { /* ignore */ }
|
|
3183
|
+
});
|
|
3081
3184
|
pendingReplies.set(msg_id, entry);
|
|
3082
3185
|
try {
|
|
3083
3186
|
pi.appendEntry("coms-log", { event: "outbound_prompt", msg_id, target: peer.name, hops: env.hops, dispatched_as: state.def.name });
|
|
@@ -3094,13 +3197,15 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3094
3197
|
res({ error: "abandoned" });
|
|
3095
3198
|
};
|
|
3096
3199
|
});
|
|
3097
|
-
const outcome = await Promise.race([entry.promise, abortPromise]);
|
|
3200
|
+
const outcome = await Promise.race([entry.promise, abortPromise, timeoutPromise]);
|
|
3098
3201
|
state.comsAbort = undefined;
|
|
3099
3202
|
if (entry.timer) {
|
|
3100
3203
|
try { clearTimeout(entry.timer); } catch { /* ignore */ }
|
|
3101
3204
|
entry.timer = null;
|
|
3102
3205
|
}
|
|
3103
|
-
|
|
3206
|
+
// A timeout leaves the correlation entry live: the peer may still finish,
|
|
3207
|
+
// and coms_get/coms_await must be able to collect that late response.
|
|
3208
|
+
if (outcome.error !== "timeout") pendingReplies.delete(msg_id);
|
|
3104
3209
|
|
|
3105
3210
|
// Refresh the context badge from the peer's registry heartbeat.
|
|
3106
3211
|
const after = resolveTarget(peer.name);
|
|
@@ -3115,11 +3220,17 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3115
3220
|
};
|
|
3116
3221
|
}
|
|
3117
3222
|
const err = outcome.error;
|
|
3223
|
+
if (err === "timeout") {
|
|
3224
|
+
return {
|
|
3225
|
+
output: `coms dispatch pending after ${Math.round(timeoutMs / 1000)}s (msg_id ${msg_id}). The peer may still complete; use coms_get/coms_await with this msg_id instead of re-dispatching.`,
|
|
3226
|
+
exitCode: 1,
|
|
3227
|
+
elapsed: 0,
|
|
3228
|
+
pending: true,
|
|
3229
|
+
};
|
|
3230
|
+
}
|
|
3118
3231
|
if (err) {
|
|
3119
3232
|
return {
|
|
3120
|
-
output:
|
|
3121
|
-
? `coms peer "${peer.name}" did not reply within ${Math.round(timeoutMs / 1000)}s. The peer may still be working in its pane — check it before re-dispatching.`
|
|
3122
|
-
: `coms peer "${peer.name}" returned an error: ${err}`,
|
|
3233
|
+
output: `coms peer "${peer.name}" returned an error: ${err}`,
|
|
3123
3234
|
exitCode: 1,
|
|
3124
3235
|
elapsed: 0,
|
|
3125
3236
|
};
|
|
@@ -3137,7 +3248,15 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3137
3248
|
// runs WHILE the specialist keeps working; only a negative verdict stops the
|
|
3138
3249
|
// run. Judge failures fail open — a broken judge must never kill good work.
|
|
3139
3250
|
async function runDriftJudge(
|
|
3140
|
-
input: {
|
|
3251
|
+
input: {
|
|
3252
|
+
agentLabel: string;
|
|
3253
|
+
agentKey: string;
|
|
3254
|
+
task: string;
|
|
3255
|
+
scopeGlobs: string[];
|
|
3256
|
+
hubOwnedGlobs: string[];
|
|
3257
|
+
trail: string[];
|
|
3258
|
+
violation: { rule: string; terminal?: boolean; detail: string };
|
|
3259
|
+
},
|
|
3141
3260
|
ctx: any,
|
|
3142
3261
|
): Promise<{ verdict: string; reason: string } | null> {
|
|
3143
3262
|
const researcherDef = allAgentDefs.find(d => d.name.toLowerCase() === "researcher");
|
|
@@ -3153,7 +3272,14 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3153
3272
|
thinking: "off",
|
|
3154
3273
|
appendSystemPrompt: "You are a strict, terse runtime watchdog. Answer with exactly one VERDICT line.",
|
|
3155
3274
|
sessionFile: judgeSession,
|
|
3156
|
-
prompt: buildJudgePrompt({
|
|
3275
|
+
prompt: buildJudgePrompt({
|
|
3276
|
+
agent: input.agentLabel,
|
|
3277
|
+
task: input.task,
|
|
3278
|
+
scopeGlobs: input.scopeGlobs,
|
|
3279
|
+
hubOwnedGlobs: input.hubOwnedGlobs,
|
|
3280
|
+
trail: input.trail,
|
|
3281
|
+
violation: input.violation,
|
|
3282
|
+
}),
|
|
3157
3283
|
detached: true,
|
|
3158
3284
|
turnDeadlineMs: 60_000,
|
|
3159
3285
|
});
|
|
@@ -3166,6 +3292,35 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3166
3292
|
}
|
|
3167
3293
|
}
|
|
3168
3294
|
|
|
3295
|
+
// One cheap read-only pass that restates an already-written report in the
|
|
3296
|
+
// structured schema. Runs only when nothing parsed and assertions were tracked
|
|
3297
|
+
// (shouldExtractReturn): the alternative is discarding a whole run's evidence
|
|
3298
|
+
// over a formatting miss. Bounded — one attempt, own deadline, own throwaway
|
|
3299
|
+
// session, never counted against the turn budget — and the caller labels the
|
|
3300
|
+
// result so extracted evidence never passes for declared evidence.
|
|
3301
|
+
async function runReturnExtraction(returnPath: string, assertionIds: string[], _ctx: any): Promise<any | null> {
|
|
3302
|
+
const extractSession = safePathWithin(sessionDir, extractionSessionName(returnPath));
|
|
3303
|
+
try { unlinkSync(extractSession); } catch {}
|
|
3304
|
+
try {
|
|
3305
|
+
const res = await spawnPiAgent({
|
|
3306
|
+
model: EXTRACTION_MODEL,
|
|
3307
|
+
tools: "read",
|
|
3308
|
+
thinking: "off",
|
|
3309
|
+
appendSystemPrompt: "You restate an existing report in a fixed format. You never judge the work and never invent evidence.",
|
|
3310
|
+
sessionFile: extractSession,
|
|
3311
|
+
prompt: buildExtractionPrompt({ returnPath, assertionIds }),
|
|
3312
|
+
detached: true,
|
|
3313
|
+
turnDeadlineMs: EXTRACTION_DEADLINE_MS,
|
|
3314
|
+
});
|
|
3315
|
+
if (res.spawnError || res.exitCode !== 0) return null;
|
|
3316
|
+
return parseStructuredReturn(res.output);
|
|
3317
|
+
} catch {
|
|
3318
|
+
return null;
|
|
3319
|
+
} finally {
|
|
3320
|
+
try { unlinkSync(extractSession); } catch {}
|
|
3321
|
+
}
|
|
3322
|
+
}
|
|
3323
|
+
|
|
3169
3324
|
async function dispatchAgent(
|
|
3170
3325
|
agentName: string,
|
|
3171
3326
|
task: string,
|
|
@@ -3173,7 +3328,15 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3173
3328
|
inputArtifacts: InputArtifactPreview[] = [],
|
|
3174
3329
|
scopeGlobs: string[] = [],
|
|
3175
3330
|
watchdogParam?: boolean,
|
|
3176
|
-
): Promise<{
|
|
3331
|
+
): Promise<{
|
|
3332
|
+
output: string;
|
|
3333
|
+
exitCode: number;
|
|
3334
|
+
elapsed: number;
|
|
3335
|
+
billed?: number;
|
|
3336
|
+
out?: number;
|
|
3337
|
+
sessionReset?: { reason: string; quarantined: string | null; retried: boolean } | null;
|
|
3338
|
+
pending?: boolean;
|
|
3339
|
+
}> {
|
|
3177
3340
|
const key = normalizeAgentInput(agentName);
|
|
3178
3341
|
const state = agentStates.get(key);
|
|
3179
3342
|
if (!state) {
|
|
@@ -3211,7 +3374,9 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3211
3374
|
const agentKey = safeAgentKey(state.def.name);
|
|
3212
3375
|
const runNumber = state.runCount;
|
|
3213
3376
|
const monitorKey = monitorKeyForAgent(state.def.name, state.runCount);
|
|
3214
|
-
const monitorStart =
|
|
3377
|
+
const monitorStart = monitorTurnId
|
|
3378
|
+
? monitorBridge?.startChild({ key: monitorKey, id: `run-${agentKey}-${state.runCount}`, generation: 1, parentId: monitorTurnId, specialist: agentKey }, process.env)
|
|
3379
|
+
: undefined;
|
|
3215
3380
|
const startTime = Date.now();
|
|
3216
3381
|
state.timer = setInterval(() => {
|
|
3217
3382
|
state.elapsed = Date.now() - startTime;
|
|
@@ -3224,8 +3389,12 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3224
3389
|
// at any point. A coms-preferring member with a live same-name pool peer
|
|
3225
3390
|
// is served by that peer; everything downstream (return contract, ASK_USER,
|
|
3226
3391
|
// research pipe, history) consumes the same result shape either way.
|
|
3227
|
-
const finishRun = async (output: string, exitCode: number, opts?: { idle?: boolean; notice?: string }) => {
|
|
3228
|
-
await monitorStart?.then(task => monitorBridge?.finalizeChildFor(
|
|
3392
|
+
const finishRun = async (output: string, exitCode: number, opts?: { idle?: boolean; pending?: boolean; notice?: string }) => {
|
|
3393
|
+
await monitorStart?.then(task => monitorBridge?.finalizeChildFor(
|
|
3394
|
+
task,
|
|
3395
|
+
output,
|
|
3396
|
+
opts?.pending ? "blocked" : exitCode === 0 ? "completed" : "failed",
|
|
3397
|
+
));
|
|
3229
3398
|
clearInterval(state.timer);
|
|
3230
3399
|
state.elapsed = Date.now() - startTime;
|
|
3231
3400
|
state.status = opts?.idle ? "idle" : exitCode === 0 ? "done" : "error";
|
|
@@ -3240,7 +3409,7 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3240
3409
|
const onTerminate = state.onTerminate;
|
|
3241
3410
|
state.onTerminate = undefined;
|
|
3242
3411
|
onTerminate?.();
|
|
3243
|
-
return { output, exitCode, elapsed: state.elapsed };
|
|
3412
|
+
return { output, exitCode, elapsed: state.elapsed, ...(opts?.pending ? { pending: true } : {}) };
|
|
3244
3413
|
};
|
|
3245
3414
|
|
|
3246
3415
|
const personaKey = state.def.name.toLowerCase();
|
|
@@ -3273,10 +3442,13 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3273
3442
|
if (comsRes) {
|
|
3274
3443
|
histEntry.name = `${displayName(state.def.name)} (coms)`;
|
|
3275
3444
|
return finishRun(comsRes.output, comsRes.exitCode, {
|
|
3276
|
-
idle: comsRes.abandoned,
|
|
3445
|
+
idle: comsRes.abandoned || comsRes.pending,
|
|
3446
|
+
pending: comsRes.pending,
|
|
3277
3447
|
notice: comsRes.abandoned
|
|
3278
3448
|
? `${displayName(state.def.name)} coms dispatch abandoned (the peer pane keeps running)`
|
|
3279
|
-
:
|
|
3449
|
+
: comsRes.pending
|
|
3450
|
+
? `${displayName(state.def.name)} coms dispatch is pending (the peer pane keeps running)`
|
|
3451
|
+
: `${displayName(state.def.name)} ${comsRes.exitCode === 0 ? "done" : "error"} in ${Math.round((Date.now() - startTime) / 1000)}s (coms peer)`,
|
|
3280
3452
|
});
|
|
3281
3453
|
}
|
|
3282
3454
|
// Envelope undeliverable + fallback allowed — continue as a plain native dispatch.
|
|
@@ -3291,6 +3463,12 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3291
3463
|
?? (ctx.model
|
|
3292
3464
|
? `${ctx.model.provider}/${ctx.model.id}`
|
|
3293
3465
|
: "openrouter/google/gemini-3-flash-preview");
|
|
3466
|
+
const originalModelFallback = fallbackModelFor(state.def, model);
|
|
3467
|
+
|
|
3468
|
+
// THIS specialist's window, not the dispatcher's. Measuring a 49k local
|
|
3469
|
+
// model against a hosted model's window is what produced readings like
|
|
3470
|
+
// "315%" that nobody could act on.
|
|
3471
|
+
const agentWindow = resolveContextWindow(model, { lookup: modelWindowLookup(ctx), fallbackWindow: contextWindow });
|
|
3294
3472
|
|
|
3295
3473
|
// Session file for this agent
|
|
3296
3474
|
const agentSessionFile = safePathWithin(sessionDir, `${agentKey}.json`);
|
|
@@ -3307,10 +3485,42 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3307
3485
|
state.sessionFile = null;
|
|
3308
3486
|
state.runsSinceFresh = 0;
|
|
3309
3487
|
state.contextPct = 0;
|
|
3488
|
+
state.contextTokens = 0;
|
|
3310
3489
|
sessionRecycled = true;
|
|
3311
3490
|
turnReport.recycles++;
|
|
3312
3491
|
sessionTotals.recycles++;
|
|
3313
3492
|
ctx.ui.notify(`${displayName(state.def.name)}: session recycled (stale context) — starting fresh`, "info");
|
|
3493
|
+
} else {
|
|
3494
|
+
// The reading recycling cannot act on: a fresh session already over a
|
|
3495
|
+
// full window. Surfaced so a mis-resolved contextWindow stays
|
|
3496
|
+
// distinguishable from a genuine single-run overflow.
|
|
3497
|
+
const overflow = contextOverflowDiagnostic(state.runsSinceFresh, state.contextPct, {
|
|
3498
|
+
agent: displayName(state.def.name),
|
|
3499
|
+
model: resolvedModel(state.def) ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "unknown model"),
|
|
3500
|
+
});
|
|
3501
|
+
if (overflow) ctx.ui.notify(overflow, "warning");
|
|
3502
|
+
}
|
|
3503
|
+
|
|
3504
|
+
// Session health preflight: `--session <file>` is passed on EVERY run, resume
|
|
3505
|
+
// or not, so a single corrupt file bricks the persona — later dispatches die
|
|
3506
|
+
// in ~1s with no output. Neither drop + re-add nor /af-agents-restart could
|
|
3507
|
+
// recover it: both only clear the in-memory pointer while the bad file stays
|
|
3508
|
+
// on disk and keeps reaching pi. So this check is unconditional, not gated on
|
|
3509
|
+
// an intended resume — move the file aside and let the run start clean.
|
|
3510
|
+
let sessionReset: { reason: string; quarantined: string | null; retried: boolean } | null = null;
|
|
3511
|
+
{
|
|
3512
|
+
const health = quarantineIfUnusable(agentSessionFile, sessionHealthIo);
|
|
3513
|
+
if (!health.usable && health.reason) {
|
|
3514
|
+
sessionReset = { reason: health.reason, quarantined: health.quarantined, retried: false };
|
|
3515
|
+
state.sessionFile = null;
|
|
3516
|
+
state.runsSinceFresh = 0;
|
|
3517
|
+
state.contextPct = 0;
|
|
3518
|
+
state.contextTokens = 0;
|
|
3519
|
+
ctx.ui.notify(
|
|
3520
|
+
`${displayName(state.def.name)}: unusable session file quarantined (${health.reason}) — starting fresh`,
|
|
3521
|
+
"warning",
|
|
3522
|
+
);
|
|
3523
|
+
}
|
|
3314
3524
|
}
|
|
3315
3525
|
|
|
3316
3526
|
// Clarification protocol — every specialist learns to bubble up questions
|
|
@@ -3360,7 +3570,7 @@ for decisions a human must make; use NEEDS_RESEARCH for facts that can be looked
|
|
|
3360
3570
|
const subagentRoles = state.def.subagents && Object.keys(state.def.subagents).length > 0
|
|
3361
3571
|
? Object.fromEntries(Object.entries(state.def.subagents).map(([role, r]) => {
|
|
3362
3572
|
const override = subagentModelOverrides.get(`${personaKey}.${role.toLowerCase()}`);
|
|
3363
|
-
return [role, override ?
|
|
3573
|
+
return [role, override ? applyModelOverride(r, override) : r];
|
|
3364
3574
|
}))
|
|
3365
3575
|
: null;
|
|
3366
3576
|
// Fast mode is a single-specialist path: no nested delegation trees.
|
|
@@ -3425,24 +3635,35 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3425
3635
|
// ── Drift watchdog: layer-1 rules on the live stream, judge on escalation ──
|
|
3426
3636
|
// Precedence: dispatch param > per-agent /af-watchdog override > hub setting.
|
|
3427
3637
|
const watchdogArmed = resolveWatchdogActive(watchdogParam, watchdogAgentOverrides.get(key), watchdogSetting);
|
|
3428
|
-
|
|
3638
|
+
// The hub ORDERS every specialist to write its deliverable under the session
|
|
3639
|
+
// artifacts tree, which no dispatcher `scope:` ever lists — so those paths are
|
|
3640
|
+
// implicitly in scope. Both path forms: the specialist may use either.
|
|
3641
|
+
const hubOwnedGlobs = hubOwnedScopeGlobs(sessionDir, path.relative(ctx.cwd || process.cwd(), sessionDir));
|
|
3642
|
+
const driftMonitor = watchdogArmed ? createDriftMonitor({ scopeGlobs, allowGlobs: hubOwnedGlobs }) : null;
|
|
3429
3643
|
let driftControl: PiRunControl | undefined;
|
|
3430
3644
|
let driftStop: { rule: string; detail: string; verdict: string; reason: string } | null = null;
|
|
3645
|
+
// Advisory signals (scope) that the judge called drift: reported to the
|
|
3646
|
+
// dispatcher, never fatal. The post-run scope gate reverts nothing, so the
|
|
3647
|
+
// live rule watching the same thing must not kill either.
|
|
3648
|
+
const driftAdvisories: { rule: string; detail: string; verdict: string; reason: string }[] = [];
|
|
3431
3649
|
let judgeBusy = false;
|
|
3432
3650
|
let judgeCooldownUntil = 0;
|
|
3433
|
-
const escalateDrift = (violation: { rule: string; detail: string }) => {
|
|
3651
|
+
const escalateDrift = (violation: { rule: string; terminal?: boolean; detail: string }) => {
|
|
3434
3652
|
if (!driftMonitor || judgeBusy || driftStop || Date.now() < judgeCooldownUntil) return;
|
|
3435
3653
|
judgeBusy = true;
|
|
3436
3654
|
void runDriftJudge(
|
|
3437
|
-
{ agentLabel: displayName(state.def.name), agentKey, task, scopeGlobs, trail: driftMonitor.trail(), violation },
|
|
3655
|
+
{ agentLabel: displayName(state.def.name), agentKey, task, scopeGlobs, hubOwnedGlobs, trail: driftMonitor.trail(), violation },
|
|
3438
3656
|
ctx,
|
|
3439
3657
|
).then(v => {
|
|
3440
3658
|
judgeBusy = false;
|
|
3441
3659
|
judgeCooldownUntil = Date.now() + 90_000;
|
|
3442
|
-
if (v
|
|
3443
|
-
|
|
3444
|
-
|
|
3660
|
+
if (!v || (v.verdict !== "drifting" && v.verdict !== "stuck")) return;
|
|
3661
|
+
if (violation.terminal === false) {
|
|
3662
|
+
driftAdvisories.push({ rule: violation.rule, detail: violation.detail, verdict: v.verdict, reason: v.reason });
|
|
3663
|
+
return;
|
|
3445
3664
|
}
|
|
3665
|
+
driftStop = { rule: violation.rule, detail: violation.detail, verdict: v.verdict, reason: v.reason };
|
|
3666
|
+
driftControl?.terminate("drift_stop");
|
|
3446
3667
|
}).catch(() => { judgeBusy = false; });
|
|
3447
3668
|
};
|
|
3448
3669
|
|
|
@@ -3453,14 +3674,44 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3453
3674
|
let fullText = "";
|
|
3454
3675
|
let runBilled = 0;
|
|
3455
3676
|
let runOut = 0;
|
|
3456
|
-
|
|
3677
|
+
let overWindowWarned = false;
|
|
3678
|
+
const runPrompt = appendDeclaredScope(appendInputArtifacts(task, inputArtifacts), scopeGlobs);
|
|
3679
|
+
|
|
3680
|
+
// Pre-spawn overflow guard. The threshold check above runs on the PREVIOUS
|
|
3681
|
+
// run's percentage; this one asks whether THIS prompt still fits before we
|
|
3682
|
+
// pay for it. Recycling after the run is what made the post-mortem's
|
|
3683
|
+
// warnings land 985s of billed work too late.
|
|
3684
|
+
if (state.sessionFile && !sessionRecycled) {
|
|
3685
|
+
const overflow = shouldRecycleBeforeSpawn({
|
|
3686
|
+
priorTokens: state.contextTokens,
|
|
3687
|
+
promptTokens: estimatePromptTokens(runPrompt) + estimatePromptTokens(appendedSystemPrompt),
|
|
3688
|
+
window: agentWindow.window,
|
|
3689
|
+
});
|
|
3690
|
+
if (overflow) {
|
|
3691
|
+
try { unlinkSync(agentSessionFile); } catch {}
|
|
3692
|
+
state.sessionFile = null;
|
|
3693
|
+
state.runsSinceFresh = 0;
|
|
3694
|
+
state.contextPct = 0;
|
|
3695
|
+
state.contextTokens = 0;
|
|
3696
|
+
sessionRecycled = true;
|
|
3697
|
+
turnReport.recycles++;
|
|
3698
|
+
sessionTotals.recycles++;
|
|
3699
|
+
ctx.ui.notify(
|
|
3700
|
+
`${displayName(state.def.name)}: session recycled before spawn — ${overflow.message}. ` +
|
|
3701
|
+
"Resuming would have overflowed the window mid-run; the task text and artifact paths carry the state.",
|
|
3702
|
+
"info",
|
|
3703
|
+
);
|
|
3704
|
+
}
|
|
3705
|
+
}
|
|
3706
|
+
|
|
3707
|
+
const spawnOptions: SpawnPiAgentOptions = {
|
|
3457
3708
|
model,
|
|
3458
3709
|
tools: effectiveTools,
|
|
3459
3710
|
thinking: thinkingLevel,
|
|
3460
3711
|
appendSystemPrompt: appendedSystemPrompt,
|
|
3461
3712
|
sessionFile: agentSessionFile,
|
|
3462
3713
|
resume: !!state.sessionFile,
|
|
3463
|
-
prompt:
|
|
3714
|
+
prompt: runPrompt,
|
|
3464
3715
|
extensions,
|
|
3465
3716
|
env: { ...guardrailEnv(agentKey), ...(delegateEnv || {}) },
|
|
3466
3717
|
detached: true,
|
|
@@ -3469,8 +3720,14 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3469
3720
|
...(RESEARCHER_PERSONAS.has(personaKey) ? { toolWatchdog: { timeoutMs: reconSearchTimeoutMs } } : {}),
|
|
3470
3721
|
// Whole-run deadline from the active mode's budget (null in strict mode).
|
|
3471
3722
|
turnDeadlineMs: turnBudget.agentTurnMs,
|
|
3472
|
-
}
|
|
3723
|
+
};
|
|
3724
|
+
const spawnCallbacks: SpawnPiAgentCallbacks = {
|
|
3473
3725
|
onProcess: (p) => { state.proc = p; void monitorStart?.then(task => monitorBridge?.registerOwnedProcessFor(task, p)); },
|
|
3726
|
+
onModelFallback: ({ from, to, reason }) => {
|
|
3727
|
+
state.lastWork = `model fallback: ${shortModel(from)} → ${shortModel(to)}`;
|
|
3728
|
+
ctx.ui.notify(`${displayName(state.def.name)}: overridden model ${from} failed before work began; retrying with persona model ${to} (${reason})`, "warning");
|
|
3729
|
+
updateWidget();
|
|
3730
|
+
},
|
|
3474
3731
|
...(driftMonitor ? { onControl: (c: PiRunControl) => { driftControl = c; } } : {}),
|
|
3475
3732
|
onTextDelta: (delta) => {
|
|
3476
3733
|
void monitorStart?.then(task => monitorBridge?.appendOutputFor(task, delta));
|
|
@@ -3509,14 +3766,68 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3509
3766
|
runBilled += (usage.input || 0) + (usage.cacheRead || 0) + (usage.cacheWrite || 0);
|
|
3510
3767
|
runOut += usage.output || 0;
|
|
3511
3768
|
}
|
|
3512
|
-
if (
|
|
3769
|
+
if (agentWindow.window > 0) {
|
|
3513
3770
|
// Real context = fresh input + cache reads + cache writes. Counting
|
|
3514
3771
|
// usage.input alone showed 1–20% while tens of thousands of cached
|
|
3515
3772
|
// tokens were re-sent per step, so the restart advice never fired.
|
|
3516
|
-
state.
|
|
3773
|
+
state.contextTokens = (usage.input || 0) + (usage.cacheRead || 0) + (usage.cacheWrite || 0);
|
|
3774
|
+
state.contextPct = contextPct(usage, agentWindow.window);
|
|
3775
|
+
// Once per run: a reading over a full window is either a wrong
|
|
3776
|
+
// window or a real overflow, and the source line is what tells
|
|
3777
|
+
// them apart. Silent 315% readings are how this went unfixed.
|
|
3778
|
+
if (state.contextPct >= 100 && !overWindowWarned) {
|
|
3779
|
+
overWindowWarned = true;
|
|
3780
|
+
ctx.ui.notify(
|
|
3781
|
+
overWindowDiagnostic({
|
|
3782
|
+
agent: displayName(state.def.name),
|
|
3783
|
+
model,
|
|
3784
|
+
pct: state.contextPct,
|
|
3785
|
+
window: agentWindow.window,
|
|
3786
|
+
source: agentWindow.source,
|
|
3787
|
+
}),
|
|
3788
|
+
"warning",
|
|
3789
|
+
);
|
|
3790
|
+
}
|
|
3517
3791
|
updateWidget();
|
|
3518
3792
|
}
|
|
3519
3793
|
},
|
|
3794
|
+
};
|
|
3795
|
+
notifyProviderQueue(model, displayName(state.def.name), ctx);
|
|
3796
|
+
// One permit for the whole dispatch, corrupt-session retry included: the
|
|
3797
|
+
// retry is the same run starting over, not a second request to schedule.
|
|
3798
|
+
const res = await providerSemaphore.run(model, async () => {
|
|
3799
|
+
let r = await spawnPiAgentWithModelFallback(spawnOptions, originalModelFallback, spawnCallbacks);
|
|
3800
|
+
|
|
3801
|
+
// Post-hoc corrupt-session detection: the preflight cannot model every
|
|
3802
|
+
// reason pi refuses a session file. This signature — non-zero exit, no
|
|
3803
|
+
// output at all, "not a valid pi session" on stderr — means the run never
|
|
3804
|
+
// started, so exactly one retry on a clean session is safe and cannot
|
|
3805
|
+
// duplicate work. Any other failure stays a failure.
|
|
3806
|
+
if (!r.spawnError && isCorruptSessionExit({ code: r.exitCode, output: r.output, stderr: r.stderr })) {
|
|
3807
|
+
const quarantine = forceQuarantineSession(agentSessionFile, sessionHealthIo);
|
|
3808
|
+
state.sessionFile = null;
|
|
3809
|
+
state.runsSinceFresh = 0;
|
|
3810
|
+
state.contextPct = 0;
|
|
3811
|
+
state.contextTokens = 0;
|
|
3812
|
+
sessionReset = {
|
|
3813
|
+
reason: quarantine.ok ? "pi rejected the session file" : quarantine.error!,
|
|
3814
|
+
quarantined: quarantine.quarantined,
|
|
3815
|
+
retried: quarantine.ok,
|
|
3816
|
+
};
|
|
3817
|
+
if (quarantine.ok) {
|
|
3818
|
+
ctx.ui.notify(
|
|
3819
|
+
`${displayName(state.def.name)}: pi rejected the session file — quarantined, retrying once from a clean session`,
|
|
3820
|
+
"warning",
|
|
3821
|
+
);
|
|
3822
|
+
r = await spawnPiAgentWithModelFallback({ ...spawnOptions, resume: false }, originalModelFallback, spawnCallbacks);
|
|
3823
|
+
} else {
|
|
3824
|
+
ctx.ui.notify(
|
|
3825
|
+
`${displayName(state.def.name)}: pi rejected the session file, but it could not be quarantined — clean retry refused (${quarantine.error})`,
|
|
3826
|
+
"error",
|
|
3827
|
+
);
|
|
3828
|
+
}
|
|
3829
|
+
}
|
|
3830
|
+
return r;
|
|
3520
3831
|
});
|
|
3521
3832
|
|
|
3522
3833
|
clearInterval(state.timer);
|
|
@@ -3651,6 +3962,9 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3651
3962
|
// (e.g. a bad --model spec or a provider whose API key isn't configured)
|
|
3652
3963
|
// reach the dispatcher as a readable message instead of an empty result.
|
|
3653
3964
|
let output = full;
|
|
3965
|
+
if (res.modelFallback) {
|
|
3966
|
+
output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
|
|
3967
|
+
}
|
|
3654
3968
|
if (code !== 0) {
|
|
3655
3969
|
const errText = res.stderr.trim();
|
|
3656
3970
|
const tail = errText.length > 1500 ? "...\n" + errText.slice(-1500) : errText;
|
|
@@ -3662,6 +3976,21 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3662
3976
|
if (sessionRecycled) {
|
|
3663
3977
|
output = `(ℹ ${displayName(state.def.name)}'s session was recycled before this run — it has no memory of earlier dispatches; state must travel via task text/artifacts.)\n\n${output}`;
|
|
3664
3978
|
}
|
|
3979
|
+
if (driftAdvisories.length > 0) {
|
|
3980
|
+
output += `\n\n⚠ Drift advisory (run NOT stopped): ` +
|
|
3981
|
+
driftAdvisories.map(a => `rule "${a.rule}" — ${a.detail}; judge said ${a.verdict.toUpperCase()}: ${a.reason || "(no reason)"}`).join(" | ") +
|
|
3982
|
+
`\nReview whether the work still serves the task; nothing was reverted and nothing was killed.`;
|
|
3983
|
+
}
|
|
3984
|
+
if (sessionReset) {
|
|
3985
|
+
// Named explicitly so a reset never reads as "the specialist failed" —
|
|
3986
|
+
// that misreading is what turned a broken file into a dropped persona.
|
|
3987
|
+
const resetSummary = sessionReset.retried
|
|
3988
|
+
? `was unusable and was quarantined${sessionReset.quarantined ? ` to ${sessionReset.quarantined}` : ""} (${sessionReset.reason}). This run started from a clean session after one automatic retry — the agent has no memory of earlier dispatches, and this is NOT a reason to drop it from the team.`
|
|
3989
|
+
: sessionReset.quarantined
|
|
3990
|
+
? `was unusable and was quarantined to ${sessionReset.quarantined} (${sessionReset.reason}) before the run. This run started from a clean session — the agent has no memory of earlier dispatches.`
|
|
3991
|
+
: `was rejected by pi but could not be quarantined (${sessionReset.reason}). No clean retry was attempted; fix the file permissions/path before retrying.`;
|
|
3992
|
+
output = `(⚠ ${displayName(state.def.name)}'s session file ${resetSummary})\n\n${output}`;
|
|
3993
|
+
}
|
|
3665
3994
|
|
|
3666
3995
|
return {
|
|
3667
3996
|
output,
|
|
@@ -3669,6 +3998,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3669
3998
|
elapsed: state.elapsed,
|
|
3670
3999
|
billed: runBilled,
|
|
3671
4000
|
out: runOut,
|
|
4001
|
+
sessionReset,
|
|
3672
4002
|
};
|
|
3673
4003
|
}
|
|
3674
4004
|
|
|
@@ -3785,7 +4115,9 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3785
4115
|
|
|
3786
4116
|
// READ-ONLY by construction: RESEARCH_TOOLS only, regardless of persona frontmatter.
|
|
3787
4117
|
let fullText = "";
|
|
3788
|
-
const
|
|
4118
|
+
const researchWindow = resolveContextWindow(state.model, { lookup: modelWindowLookup(ctx), fallbackWindow: contextWindow });
|
|
4119
|
+
notifyProviderQueue(state.model, `Research r${state.id}`, ctx);
|
|
4120
|
+
const res = await providerSemaphore.run(state.model, () => spawnPiAgentWithModelFallback({
|
|
3789
4121
|
model: state.model,
|
|
3790
4122
|
tools: RESEARCH_TOOLS,
|
|
3791
4123
|
thinking: thinkingLevel,
|
|
@@ -3804,8 +4136,13 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3804
4136
|
...researchWatchdogSpawnOptions(reconSearchTimeoutMs, signal),
|
|
3805
4137
|
// Whole-run deadline from the active mode's budget (null in strict mode).
|
|
3806
4138
|
turnDeadlineMs: currentBudget().agentTurnMs,
|
|
3807
|
-
}, {
|
|
4139
|
+
}, fallbackModelFor(state.def, state.model), {
|
|
3808
4140
|
onProcess: (p) => { state.proc = p; },
|
|
4141
|
+
onModelFallback: ({ from, to, reason }) => {
|
|
4142
|
+
state.lastWork = `model fallback: ${shortModel(from)} → ${shortModel(to)}`;
|
|
4143
|
+
ctx.ui.notify(`Research r${state.id}: overridden model ${from} failed before work began; retrying with persona model ${to} (${reason})`, "warning");
|
|
4144
|
+
updateResearchWidget();
|
|
4145
|
+
},
|
|
3809
4146
|
onTextDelta: (delta) => {
|
|
3810
4147
|
fullText += delta;
|
|
3811
4148
|
state.lastWork = fullText.split("\n").filter((l: string) => l.trim()).pop() || "";
|
|
@@ -3830,13 +4167,18 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3830
4167
|
state.zoomRender?.();
|
|
3831
4168
|
},
|
|
3832
4169
|
onUsage: (usage) => {
|
|
3833
|
-
if (
|
|
3834
|
-
// Same context truth as dispatchAgent: include cache reads/writes
|
|
3835
|
-
|
|
4170
|
+
if (researchWindow.window > 0) {
|
|
4171
|
+
// Same context truth as dispatchAgent: include cache reads/writes,
|
|
4172
|
+
// measured against THIS helper's window rather than the dispatcher's.
|
|
4173
|
+
state.contextPct = contextPct(usage, researchWindow.window);
|
|
3836
4174
|
updateResearchWidget();
|
|
3837
4175
|
}
|
|
3838
4176
|
},
|
|
3839
|
-
}
|
|
4177
|
+
}, {
|
|
4178
|
+
// Read-only by construction (RESEARCH_TOOLS), so a provider failure
|
|
4179
|
+
// mid-run is recoverable: re-running a reader repeats nothing.
|
|
4180
|
+
midRun: isReadOnlyToolList(RESEARCH_TOOLS),
|
|
4181
|
+
}));
|
|
3840
4182
|
|
|
3841
4183
|
clearInterval(state.timer);
|
|
3842
4184
|
state.elapsed = Date.now() - startTime;
|
|
@@ -3913,6 +4255,9 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
3913
4255
|
);
|
|
3914
4256
|
|
|
3915
4257
|
let output = full;
|
|
4258
|
+
if (res.modelFallback) {
|
|
4259
|
+
output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
|
|
4260
|
+
}
|
|
3916
4261
|
if (code !== 0) {
|
|
3917
4262
|
const errText = res.stderr.trim();
|
|
3918
4263
|
const tail = errText.length > 1500 ? "...\n" + errText.slice(-1500) : errText;
|
|
@@ -4054,6 +4399,8 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4054
4399
|
color: ident?.color ?? "#36F9F6",
|
|
4055
4400
|
context_used_pct: pct,
|
|
4056
4401
|
queue_depth: inboundQueue.size,
|
|
4402
|
+
pane_id: herdrPaneId() ?? null,
|
|
4403
|
+
status: turnState === "working" || inboundQueue.size > 0 ? "working" : "idle",
|
|
4057
4404
|
};
|
|
4058
4405
|
const pong: Pong = { type: "pong", msg_id: env.msg_id, agent_card: card };
|
|
4059
4406
|
try {
|
|
@@ -4141,22 +4488,13 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4141
4488
|
if (!identity) return;
|
|
4142
4489
|
try {
|
|
4143
4490
|
const ctx = currentCtx;
|
|
4144
|
-
const live: RegistryEntry = {
|
|
4145
|
-
|
|
4146
|
-
name: identity.name,
|
|
4147
|
-
purpose: identity.purpose,
|
|
4148
|
-
model: ctx?.model?.id ?? identity.model,
|
|
4149
|
-
color: identity.color,
|
|
4491
|
+
const live: RegistryEntry = buildLiveRegistryEntry(identity, {
|
|
4492
|
+
now: nowIso(),
|
|
4150
4493
|
pid: process.pid,
|
|
4151
|
-
|
|
4152
|
-
|
|
4153
|
-
|
|
4154
|
-
|
|
4155
|
-
version: 1,
|
|
4156
|
-
context_used_pct: Math.round(ctx?.getContextUsage()?.percent ?? 0),
|
|
4157
|
-
queue_depth: inboundQueue.size,
|
|
4158
|
-
heartbeat_at: nowIso(),
|
|
4159
|
-
};
|
|
4494
|
+
model: ctx?.model?.id,
|
|
4495
|
+
contextUsedPct: ctx?.getContextUsage()?.percent,
|
|
4496
|
+
queueDepth: inboundQueue.size,
|
|
4497
|
+
});
|
|
4160
4498
|
writeRegistryAtomic(live, identity.project);
|
|
4161
4499
|
} catch {
|
|
4162
4500
|
// best-effort
|
|
@@ -4419,8 +4757,8 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4419
4757
|
}
|
|
4420
4758
|
|
|
4421
4759
|
// Join herdr's live pane states back to the coms registry: a herdr agent
|
|
4422
|
-
//
|
|
4423
|
-
//
|
|
4760
|
+
// that advertises a coms peer name maps to that peer's registry entry
|
|
4761
|
+
// (which carries the full card a pane annotation has no room for).
|
|
4424
4762
|
// Pool-scope semantics are preserved — only entries from peersInScope()
|
|
4425
4763
|
// become cards; peers outside herdr panes stay visible as registry-only
|
|
4426
4764
|
// "pending" rows exactly like an unpinged peer in the files backend.
|
|
@@ -4428,7 +4766,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4428
4766
|
if (!identity) return;
|
|
4429
4767
|
const liveNames = new Set<string>();
|
|
4430
4768
|
for (const a of agents) {
|
|
4431
|
-
const peerName =
|
|
4769
|
+
const peerName = peerNameFrom(a);
|
|
4432
4770
|
if (peerName) liveNames.add(peerName);
|
|
4433
4771
|
}
|
|
4434
4772
|
let changed = false;
|
|
@@ -4530,6 +4868,24 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4530
4868
|
details: { agent, task, status: "duplicate_refused", elapsed: 0, exitCode: 1, fullOutput: "" },
|
|
4531
4869
|
};
|
|
4532
4870
|
}
|
|
4871
|
+
// Input artifacts resolve BEFORE the dispatch is counted. Validation used to
|
|
4872
|
+
// run after the increment, so four "Artifact not found" typos each burned a
|
|
4873
|
+
// real budget slot — and the turn budget was exhausted three times in the
|
|
4874
|
+
// same session. A path the hub cannot resolve is a pre-flight error: nothing
|
|
4875
|
+
// was spawned, so nothing should be charged.
|
|
4876
|
+
let inputArtifacts: InputArtifactPreview[];
|
|
4877
|
+
try {
|
|
4878
|
+
inputArtifacts = loadInputArtifacts(artifacts, ctx);
|
|
4879
|
+
} catch (err: any) {
|
|
4880
|
+
return {
|
|
4881
|
+
content: [{
|
|
4882
|
+
type: "text",
|
|
4883
|
+
text: `⚠ Dispatch NOT sent and NOT counted against the turn budget — input artifact could not be resolved:\n` +
|
|
4884
|
+
`${err?.message || err}\n\nFix the path and dispatch again.`,
|
|
4885
|
+
}],
|
|
4886
|
+
details: { agent, task, status: "artifact_preflight_failed", elapsed: 0, exitCode: 1, fullOutput: "" },
|
|
4887
|
+
};
|
|
4888
|
+
}
|
|
4533
4889
|
turnDispatchCount++;
|
|
4534
4890
|
sessionTotals.dispatches++;
|
|
4535
4891
|
updateModeStatus();
|
|
@@ -4547,7 +4903,6 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4547
4903
|
}
|
|
4548
4904
|
|
|
4549
4905
|
const dispatchedAssertionIds = extractAssertionIds(task);
|
|
4550
|
-
const inputArtifacts = loadInputArtifacts(artifacts, ctx);
|
|
4551
4906
|
const scopeGlobs = (scope || []).map(s => String(s).trim()).filter(Boolean);
|
|
4552
4907
|
const stateForScope = agentStates.get(agent.toLowerCase());
|
|
4553
4908
|
const agentCanWrite = !!stateForScope && hasWriteCapability(stateForScope.def.tools);
|
|
@@ -4623,14 +4978,46 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4623
4978
|
}
|
|
4624
4979
|
}
|
|
4625
4980
|
|
|
4626
|
-
const
|
|
4627
|
-
const
|
|
4981
|
+
const disposition = deliveryDisposition(result.exitCode, result.pending === true);
|
|
4982
|
+
const pendingDelivery = disposition.pending;
|
|
4983
|
+
const delivered = disposition.delivered;
|
|
4984
|
+
let { parsed: parsedReturn, notices: contractNotices } = parseDeliveredReturn(
|
|
4985
|
+
result.output,
|
|
4986
|
+
dispatchedAssertionIds,
|
|
4987
|
+
delivered,
|
|
4988
|
+
);
|
|
4628
4989
|
const shouldUseDigest = dispatchedAssertionIds.length > 0 || !!parsedReturn;
|
|
4629
4990
|
const state = agentStates.get(agent.toLowerCase());
|
|
4630
4991
|
const agentKey = safeAgentKey(state?.def.name ?? agent);
|
|
4631
|
-
|
|
4632
|
-
|
|
4992
|
+
// A failed run delivered no result. Its output — a coms error, a
|
|
4993
|
+
// timeout stub, a truncated crash — goes to failures/, never returns/:
|
|
4994
|
+
// a return path is read as "the specialist answered", and one 142-byte
|
|
4995
|
+
// error stub filed as a return cost a 103s dispatch investigating a
|
|
4996
|
+
// review that had actually succeeded.
|
|
4997
|
+
const runArtifactPath = disposition.artifactKind && (shouldUseDigest || !delivered)
|
|
4998
|
+
? writeRunArtifact(agentKey, state?.runCount ?? 0, result.output, disposition.artifactKind)
|
|
4633
4999
|
: null;
|
|
5000
|
+
const returnPath = delivered ? runArtifactPath : null;
|
|
5001
|
+
const failurePath = delivered ? null : runArtifactPath;
|
|
5002
|
+
|
|
5003
|
+
// Nothing parsed but assertions were tracked: give the report one cheap
|
|
5004
|
+
// read-only pass before writing the whole run off as unproven. Never on
|
|
5005
|
+
// a failure — there is no report to extract from.
|
|
5006
|
+
let returnExtracted = false;
|
|
5007
|
+
if (returnPath && shouldExtractReturn(parsedReturn, dispatchedAssertionIds)) {
|
|
5008
|
+
if (onUpdate) {
|
|
5009
|
+
onUpdate({
|
|
5010
|
+
content: [{ type: "text", text: `${agent} returned no structured block — extracting it from the report...` }],
|
|
5011
|
+
details: { agent, task, status: "extracting_return" },
|
|
5012
|
+
});
|
|
5013
|
+
}
|
|
5014
|
+
const recovered = await runReturnExtraction(returnPath, dispatchedAssertionIds, ctx);
|
|
5015
|
+
if (recovered) {
|
|
5016
|
+
parsedReturn = recovered;
|
|
5017
|
+
contractNotices = crossCheck(recovered, dispatchedAssertionIds);
|
|
5018
|
+
returnExtracted = true;
|
|
5019
|
+
}
|
|
5020
|
+
}
|
|
4634
5021
|
|
|
4635
5022
|
const truncated = result.output.length > 8000
|
|
4636
5023
|
? result.output.slice(0, 8000) + "\n\n... [truncated]"
|
|
@@ -4639,7 +5026,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4639
5026
|
// Extract bubble-up questions emitted via the clarification protocol.
|
|
4640
5027
|
const questions = extractAskUserQuestions(result.output);
|
|
4641
5028
|
|
|
4642
|
-
const status =
|
|
5029
|
+
const status = disposition.status;
|
|
4643
5030
|
// Record the fingerprint only for completed or watchdog/deadline-stopped
|
|
4644
5031
|
// runs — those must not be repeated unchanged. A failed spawn or plain
|
|
4645
5032
|
// error stays retryable (the failure may be transient).
|
|
@@ -4668,17 +5055,43 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4668
5055
|
: "";
|
|
4669
5056
|
|
|
4670
5057
|
const returnPathNotice = returnPath ? `\n\nFull specialist output: ${returnPath}` : "";
|
|
5058
|
+
// Named as a delivery failure, not a result: the run did not answer.
|
|
5059
|
+
// Whether the work itself succeeded is unknown from here — a lost coms
|
|
5060
|
+
// reply looks identical to a crash, and treating the stub as a verdict
|
|
5061
|
+
// is what turned a successful review into a re-investigation.
|
|
5062
|
+
const pendingNotice = pendingDelivery
|
|
5063
|
+
? `\n\n⏳ DELIVERY PENDING — no result or assertion evidence is available yet, and no return/failure artifact was written. Use the msg_id above with coms_get/coms_await; do not re-dispatch.`
|
|
5064
|
+
: "";
|
|
5065
|
+
const failurePathNotice = failurePath
|
|
5066
|
+
? `\n\n⚠ DELIVERY FAILURE (exit ${result.exitCode}) — no specialist result was returned. ` +
|
|
5067
|
+
`The error output is at ${failurePath}; it is NOT a return and carries no assertion evidence. ` +
|
|
5068
|
+
"The work may or may not have happened — check the artifacts the task was supposed to produce before re-dispatching."
|
|
5069
|
+
: "";
|
|
5070
|
+
// Tell the dispatcher which path actually held the file, so the next
|
|
5071
|
+
// dispatch names it directly instead of guessing the kind again.
|
|
5072
|
+
const corrected = inputArtifacts.filter(a => a.resolvedFromKind);
|
|
5073
|
+
const artifactKindNotice = corrected.length > 0
|
|
5074
|
+
? `\n\nℹ Artifact path corrected: ${corrected.map(a => `"${a.input}" → ${a.displayPath}`).join("; ")}. ` +
|
|
5075
|
+
`Use the corrected path from now on.`
|
|
5076
|
+
: "";
|
|
4671
5077
|
const contextNotice = state && contextPressure(state.contextPct)
|
|
4672
5078
|
? `\n\n⚠ ${displayName(state.def.name)} context at ${Math.ceil(state.contextPct)}% — consider /af-agents-restart ${state.def.name} (state lives in the artifacts/ledger, a restart is cheap).`
|
|
4673
5079
|
: "";
|
|
4674
5080
|
const scopeNotice = scopeNoticeText(scopeViolations);
|
|
4675
5081
|
const contractNotice = contractNoticeText(contractNotices);
|
|
5082
|
+
// An extracted block is labelled every time it is shown: it was restated
|
|
5083
|
+
// by a cheap pass, not declared by the specialist, and it must never be
|
|
5084
|
+
// mistaken for first-hand evidence when gating on it.
|
|
5085
|
+
const extractionNotice = returnExtracted
|
|
5086
|
+
? `ℹ The specialist declared no structured return. The block below was EXTRACTED from its report ` +
|
|
5087
|
+
`by a cheap read-only pass — weaker than a declared return. Verify the named evidence before you gate on it.`
|
|
5088
|
+
: "";
|
|
4676
5089
|
const digest = shouldUseDigest
|
|
4677
|
-
? [structuredReturnDigest(parsedReturn) || "Structured return: (none parsed)", contractNotice].filter(Boolean).join("\n\n")
|
|
5090
|
+
? [extractionNotice, structuredReturnDigest(parsedReturn) || "Structured return: (none parsed)", contractNotice].filter(Boolean).join("\n\n")
|
|
4678
5091
|
: truncated;
|
|
4679
5092
|
|
|
4680
5093
|
return {
|
|
4681
|
-
content: [{ type: "text", text: `${summary}${questionsNotice}${researchNotice}${budgetNotice}${returnPathNotice}${contextNotice}${scopeNotice}\n\n${digest}` }],
|
|
5094
|
+
content: [{ type: "text", text: `${summary}${questionsNotice}${researchNotice}${budgetNotice}${returnPathNotice}${pendingNotice}${failurePathNotice}${artifactKindNotice}${contextNotice}${scopeNotice}\n\n${digest}` }],
|
|
4682
5095
|
details: {
|
|
4683
5096
|
agent,
|
|
4684
5097
|
task,
|
|
@@ -4687,12 +5100,16 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4687
5100
|
exitCode: result.exitCode,
|
|
4688
5101
|
fullOutput: result.output,
|
|
4689
5102
|
structuredReturn: parsedReturn,
|
|
5103
|
+
returnExtracted,
|
|
5104
|
+
pending: pendingDelivery,
|
|
4690
5105
|
returnPath,
|
|
5106
|
+
failurePath,
|
|
4691
5107
|
contractNotices,
|
|
4692
5108
|
questions,
|
|
4693
5109
|
researchRounds,
|
|
4694
5110
|
scopeViolations,
|
|
4695
|
-
|
|
5111
|
+
sessionReset: result.sessionReset ?? null,
|
|
5112
|
+
artifacts: inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })),
|
|
4696
5113
|
},
|
|
4697
5114
|
};
|
|
4698
5115
|
} catch (err: any) {
|
|
@@ -4793,11 +5210,9 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4793
5210
|
details: { status: "budget_refused", reason: budgetRefusal.reason },
|
|
4794
5211
|
};
|
|
4795
5212
|
}
|
|
4796
|
-
|
|
4797
|
-
|
|
4798
|
-
|
|
4799
|
-
updateModeStatus();
|
|
4800
|
-
|
|
5213
|
+
// Pre-flight BEFORE the research slot is spent — same rule as dispatch_agent:
|
|
5214
|
+
// an unknown persona or an unresolvable artifact path never reached a helper,
|
|
5215
|
+
// so it must not be charged against the turn budget.
|
|
4801
5216
|
let def: AgentDef;
|
|
4802
5217
|
let isPersona = false;
|
|
4803
5218
|
if (persona) {
|
|
@@ -4805,7 +5220,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4805
5220
|
if (!found) {
|
|
4806
5221
|
const available = researchPersonas.map(d => d.name).join(", ") || "(none defined)";
|
|
4807
5222
|
return {
|
|
4808
|
-
content: [{ type: "text", text: `No research persona "${persona}". Available: ${available}. Omit \`persona\` for an ad-hoc helper
|
|
5223
|
+
content: [{ type: "text", text: `No research persona "${persona}". Available: ${available}. Omit \`persona\` for an ad-hoc helper. (Not counted against the turn budget.)` }],
|
|
4809
5224
|
details: { status: "error" },
|
|
4810
5225
|
};
|
|
4811
5226
|
}
|
|
@@ -4816,7 +5231,25 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4816
5231
|
}
|
|
4817
5232
|
|
|
4818
5233
|
const resolvedModel = resolveResearchModel(def, isPersona ? undefined : model, ctx);
|
|
4819
|
-
|
|
5234
|
+
let inputArtifacts: InputArtifactPreview[];
|
|
5235
|
+
try {
|
|
5236
|
+
inputArtifacts = loadInputArtifacts(artifacts, ctx);
|
|
5237
|
+
} catch (err: any) {
|
|
5238
|
+
return {
|
|
5239
|
+
content: [{
|
|
5240
|
+
type: "text",
|
|
5241
|
+
text: `⚠ Research NOT spawned and NOT counted against the turn budget — input artifact could not be resolved:\n` +
|
|
5242
|
+
`${err?.message || err}\n\nFix the path and try again.`,
|
|
5243
|
+
}],
|
|
5244
|
+
details: { status: "artifact_preflight_failed" },
|
|
5245
|
+
};
|
|
5246
|
+
}
|
|
5247
|
+
|
|
5248
|
+
turnResearchCount++;
|
|
5249
|
+
turnReport.research++;
|
|
5250
|
+
sessionTotals.research++;
|
|
5251
|
+
updateModeStatus();
|
|
5252
|
+
|
|
4820
5253
|
const state = createResearchState(def, isPersona, resolvedModel);
|
|
4821
5254
|
updateResearchWidget();
|
|
4822
5255
|
|
|
@@ -4848,7 +5281,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
4848
5281
|
exitCode: result.exitCode,
|
|
4849
5282
|
fullOutput: result.output,
|
|
4850
5283
|
termination: result.termination,
|
|
4851
|
-
artifacts: inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview })),
|
|
5284
|
+
artifacts: inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })),
|
|
4852
5285
|
},
|
|
4853
5286
|
};
|
|
4854
5287
|
} catch (err: any) {
|
|
@@ -5005,31 +5438,36 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5005
5438
|
name: "set_assertions",
|
|
5006
5439
|
label: "Set Assertions",
|
|
5007
5440
|
description:
|
|
5008
|
-
|
|
5441
|
+
`Record the acceptance-assertion ledger for the current task (the Verification Contract). Call this BEFORE dispatching a builder, with one checkable assertion per requirement, and again to REBUILD the whole ledger on a 'wrong again' regression reset (it replaces any existing list). Each assertion needs an id (A1, A2, …), a verification tag (test | runtime-ui | code-grep | manual), one pass condition, and a source naming where the requirement comes from. Keep at most ${MAX_OPEN_ASSERTIONS} open at a time — declare later batches when they start. See skills/orchestration-verification/SKILL.md for the format. The ledger is persisted and its status is shown to the human; it does not block dispatch.`,
|
|
5009
5442
|
parameters: Type.Object({
|
|
5010
5443
|
assertions: Type.Array(
|
|
5011
5444
|
Type.Object({
|
|
5012
5445
|
id: Type.String({ description: "Stable id, e.g. A1, A2 — referenced verbatim in dispatches and returns." }),
|
|
5013
5446
|
tag: Type.String({ description: "How it will be proven: test | runtime-ui | code-grep | manual." }),
|
|
5014
5447
|
text: Type.String({ description: "One checkable pass condition (split compound requirements into separate assertions)." }),
|
|
5448
|
+
source: Type.String({ description: "Where this requirement comes from — \"PLAN-x.md:585-595\", \"user request\", \"review finding F3\". Required: a specialist asked to prove the assertion must be able to read its origin instead of asking." }),
|
|
5015
5449
|
}),
|
|
5016
|
-
{ description:
|
|
5450
|
+
{ description: `The full assertion list — replaces any existing ledger. Soft cap ${MAX_OPEN_ASSERTIONS} per batch.` },
|
|
5017
5451
|
),
|
|
5018
5452
|
}),
|
|
5019
|
-
async execute(_callId, params, _signal, _onUpdate,
|
|
5020
|
-
const input = (params as { assertions: Array<{ id: string; tag: string; text: string }> }).assertions
|
|
5021
|
-
|
|
5022
|
-
|
|
5023
|
-
|
|
5024
|
-
|
|
5025
|
-
|
|
5026
|
-
|
|
5453
|
+
async execute(_callId, params, _signal, _onUpdate, ctx) {
|
|
5454
|
+
const input = (params as { assertions: Array<{ id: string; tag: string; text: string; source?: string }> }).assertions;
|
|
5455
|
+
const verdict = validateAssertionBatch(input);
|
|
5456
|
+
if (!verdict.ok) {
|
|
5457
|
+
return {
|
|
5458
|
+
content: [{ type: "text" as const, text: verdict.refusal! }],
|
|
5459
|
+
details: { status: "rejected", reason: "missing-source" },
|
|
5460
|
+
};
|
|
5461
|
+
}
|
|
5462
|
+
assertions = verdict.assertions.map(a => ({ ...a, status: "open" as AssertionStatus }));
|
|
5027
5463
|
persistAssertions();
|
|
5028
5464
|
updateAssertionStatus();
|
|
5465
|
+
if (verdict.warning) ctx.ui.notify(verdict.warning, "warning");
|
|
5029
5466
|
const ids = assertions.map(a => a.id).join(", ") || "(none)";
|
|
5467
|
+
const head = `Ledger set: ${assertions.length} assertion(s) open — ${ids}. Pass the relevant ones verbatim into each dispatch and advance only on proven.`;
|
|
5030
5468
|
return {
|
|
5031
|
-
content: [{ type: "text" as const, text:
|
|
5032
|
-
details: { count: assertions.length },
|
|
5469
|
+
content: [{ type: "text" as const, text: verdict.warning ? `${head}\n\n${verdict.warning}` : head }],
|
|
5470
|
+
details: { count: assertions.length, capWarning: Boolean(verdict.warning) },
|
|
5033
5471
|
};
|
|
5034
5472
|
},
|
|
5035
5473
|
renderCall(args, theme) {
|
|
@@ -5141,8 +5579,9 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5141
5579
|
label: "Coms List",
|
|
5142
5580
|
description:
|
|
5143
5581
|
"List the peer agents in your current coms pool — the ones shown in the pool widget. Returns " +
|
|
5144
|
-
"names, models,
|
|
5145
|
-
"
|
|
5582
|
+
"names, models, live context-window usage, pane_id, and status (idle | working | booting). " +
|
|
5583
|
+
"Check status before sending instead of polling the pane. Discovery is scoped to what the human " +
|
|
5584
|
+
"displays via /af-coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
|
|
5146
5585
|
parameters: Type.Object({
|
|
5147
5586
|
project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /af-coms displays — a widening request is ignored." })),
|
|
5148
5587
|
include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /af-coms --all." })),
|
|
@@ -5197,6 +5636,9 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5197
5636
|
project: c.project,
|
|
5198
5637
|
alive: pong != null,
|
|
5199
5638
|
context_used_pct: pong ? pong.context_used_pct : null,
|
|
5639
|
+
pane_id: pong?.pane_id ?? null,
|
|
5640
|
+
status: pong?.status ?? null,
|
|
5641
|
+
queue_depth: pong ? pong.queue_depth : null,
|
|
5200
5642
|
color: c.entry.color,
|
|
5201
5643
|
};
|
|
5202
5644
|
});
|
|
@@ -5212,7 +5654,8 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5212
5654
|
: agents.map((a) => {
|
|
5213
5655
|
const ctxStr = a.context_used_pct != null ? ` ${a.context_used_pct}%` : " ?%";
|
|
5214
5656
|
const live = a.alive ? "●" : "✗";
|
|
5215
|
-
|
|
5657
|
+
const state = a.alive ? (a.status ?? "unknown") : "unreachable";
|
|
5658
|
+
return `${live} ${a.name} (${a.model})${ctxStr} [${state}${a.pane_id ? ` pane ${a.pane_id}` : ""}]${a.purpose ? ` — ${a.purpose}` : ""}`;
|
|
5216
5659
|
}).join("\n");
|
|
5217
5660
|
|
|
5218
5661
|
return {
|
|
@@ -5238,7 +5681,10 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5238
5681
|
const rows = agents.map((a) => {
|
|
5239
5682
|
const dot = a.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
|
|
5240
5683
|
const pct = a.context_used_pct != null ? `${a.context_used_pct}%` : "?%";
|
|
5241
|
-
|
|
5684
|
+
const state = a.alive ? (a.status ?? "unknown") : "unreachable";
|
|
5685
|
+
const stateFg = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
|
|
5686
|
+
return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)} ` +
|
|
5687
|
+
`${theme.fg(stateFg as any, state)}${a.pane_id ? theme.fg("dim", ` ${a.pane_id}`) : ""}`;
|
|
5242
5688
|
}).join("\n");
|
|
5243
5689
|
return new Text(header + "\n" + rows, 0, 0);
|
|
5244
5690
|
},
|
|
@@ -5257,6 +5703,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5257
5703
|
handoff_token: Type.Optional(Type.String({ description: "Internal /af-handoff token. Only include when the /af-handoff follow-up explicitly gives you one; it authorizes the machine-appended ledger/artifact appendix." })),
|
|
5258
5704
|
conversation_id: Type.Optional(Type.String()),
|
|
5259
5705
|
response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
|
|
5706
|
+
reply_timeout_ms: Type.Optional(Type.Number({ description: "Receiver-side reply deadline in ms; pass the same budget used for coms_await. Clamped by the receiver." })),
|
|
5260
5707
|
}),
|
|
5261
5708
|
async execute(_callId, params) {
|
|
5262
5709
|
if (!identity) {
|
|
@@ -5301,10 +5748,12 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5301
5748
|
prompt: outboundPrompt,
|
|
5302
5749
|
conversation_id: params.conversation_id ?? null,
|
|
5303
5750
|
response_schema: (params.response_schema as object | undefined) ?? null,
|
|
5751
|
+
reply_timeout_ms: params.reply_timeout_ms ?? null,
|
|
5304
5752
|
};
|
|
5305
5753
|
|
|
5306
5754
|
// Send the envelope synchronously and wait for the receiver's ack.
|
|
5307
5755
|
await sendEnvelope(target.endpoint, env);
|
|
5756
|
+
markPeerAddressed(target.name);
|
|
5308
5757
|
if (handoffAppendAuthorized) pendingHandoff = null;
|
|
5309
5758
|
|
|
5310
5759
|
// Register a pending entry whose promise the receiver-side handleResponse
|
|
@@ -5323,13 +5772,8 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5323
5772
|
target_name: target.name,
|
|
5324
5773
|
created_at: nowIso(),
|
|
5325
5774
|
};
|
|
5326
|
-
|
|
5327
|
-
|
|
5328
|
-
entry.result = { error: "timeout" };
|
|
5329
|
-
try { entry.resolve(entry.result); } catch { /* ignore */ }
|
|
5330
|
-
}, TIMEOUT_MS);
|
|
5331
|
-
// Don't keep the event loop alive solely for this timer.
|
|
5332
|
-
try { (entry.timer as any).unref?.(); } catch { /* ignore */ }
|
|
5775
|
+
// A local wait deadline does not convert unfinished remote work into an
|
|
5776
|
+
// error. Keep the entry pending so a later await can collect the response.
|
|
5333
5777
|
pendingReplies.set(msg_id, entry);
|
|
5334
5778
|
|
|
5335
5779
|
try {
|
|
@@ -5449,10 +5893,16 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5449
5893
|
});
|
|
5450
5894
|
|
|
5451
5895
|
const winner = await Promise.race([entry.promise, timed]);
|
|
5896
|
+
if ((winner as any).error === "timeout") {
|
|
5897
|
+
return {
|
|
5898
|
+
content: [{ type: "text" as const, text: "coms_await: pending — wait budget exhausted; the peer may still complete" }],
|
|
5899
|
+
details: { status: "pending" },
|
|
5900
|
+
};
|
|
5901
|
+
}
|
|
5452
5902
|
if ((winner as any).error) {
|
|
5453
5903
|
return {
|
|
5454
5904
|
content: [{ type: "text" as const, text: `coms_await: error — ${(winner as any).error}` }],
|
|
5455
|
-
details: { error: (winner as any).error },
|
|
5905
|
+
details: { status: "error", error: (winner as any).error },
|
|
5456
5906
|
};
|
|
5457
5907
|
}
|
|
5458
5908
|
const resp = (winner as any).response;
|
|
@@ -5471,6 +5921,7 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5471
5921
|
renderResult(result, _options, theme) {
|
|
5472
5922
|
const d = result.details as any;
|
|
5473
5923
|
if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
|
|
5924
|
+
if (d?.status === "pending") return new Text(theme.fg("warning", "⏳ pending"), 0, 0);
|
|
5474
5925
|
return new Text(theme.fg("success", "✓ response received"), 0, 0);
|
|
5475
5926
|
},
|
|
5476
5927
|
});
|
|
@@ -5488,11 +5939,35 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5488
5939
|
|
|
5489
5940
|
let herdrFleetReady = false;
|
|
5490
5941
|
|
|
5942
|
+
// Peers this hub spawned, and whether anyone ever sent to them. A spawned
|
|
5943
|
+
// coms peer boots idle and waits — spawning it delivers no work, so an
|
|
5944
|
+
// unaddressed one is an empty pane holding a model session.
|
|
5945
|
+
const hubSpawnedPeers = new Map<string, { name: string; paneId: string | null; addressed: boolean }>();
|
|
5946
|
+
const markPeerAddressed = (name: string) => {
|
|
5947
|
+
const entry = hubSpawnedPeers.get(String(name || "").toLowerCase());
|
|
5948
|
+
if (entry) entry.addressed = true;
|
|
5949
|
+
};
|
|
5950
|
+
|
|
5951
|
+
/** Bounded wait for a spawned peer to register in the coms pool. */
|
|
5952
|
+
async function waitForPeerRegistration(name: string, timeoutMs = PEER_READY_TIMEOUT_MS): Promise<{ found: boolean; waitedMs: number }> {
|
|
5953
|
+
const wanted = String(name).toLowerCase();
|
|
5954
|
+
const started = Date.now();
|
|
5955
|
+
for (let attempt = 0; ; attempt++) {
|
|
5956
|
+
const live = comsReady && identity ? peersInScope() : [];
|
|
5957
|
+
if (live.some(e => e.name.toLowerCase() === wanted)) {
|
|
5958
|
+
return { found: true, waitedMs: Date.now() - started };
|
|
5959
|
+
}
|
|
5960
|
+
const remaining = timeoutMs - (Date.now() - started);
|
|
5961
|
+
if (remaining <= 0) return { found: false, waitedMs: Date.now() - started };
|
|
5962
|
+
await new Promise(r => setTimeout(r, Math.min(peerReadyDelayMs(attempt), remaining)));
|
|
5963
|
+
}
|
|
5964
|
+
}
|
|
5965
|
+
|
|
5491
5966
|
pi.registerTool({
|
|
5492
5967
|
name: "herdr_spawn_peer",
|
|
5493
5968
|
label: "Herdr Spawn Peer",
|
|
5494
5969
|
description:
|
|
5495
|
-
"Spawn a pane in the CURRENT herdr workspace: either a peers.yaml-style coms peer (persona [+ name/model], launched via `just _peer`) or a raw command pane.
|
|
5970
|
+
"Spawn a pane in the CURRENT herdr workspace: either a peers.yaml-style coms peer (persona [+ name/model], launched via `just _peer`) or a raw command pane. A persona peer boots IDLE and does nothing until you coms_send to it — spawning delivers no work. The call waits (bounded) for the peer to register and returns `peer_ready` plus its coms name, or `peer_ready: false` with the wait stated. Spawn one only immediately before the first message you will send it; a peer that receives no work is named in the session digest.",
|
|
5496
5971
|
parameters: Type.Object({
|
|
5497
5972
|
persona: Type.Optional(Type.String({ description: "Persona under agents/ (e.g. researcher). Omit for a raw command pane." })),
|
|
5498
5973
|
name: Type.String({ description: "Pane label; for persona peers also the coms peer name." }),
|
|
@@ -5525,9 +6000,21 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5525
6000
|
focus: false,
|
|
5526
6001
|
});
|
|
5527
6002
|
try { await herdrApi.paneRename(pane.pane_id, params.name); } catch { /* cosmetic */ }
|
|
6003
|
+
// A raw command pane is not a coms peer — nothing to wait for and
|
|
6004
|
+
// nothing to sweep. A persona peer is only useful once addressable,
|
|
6005
|
+
// so report that verdict instead of a bare pane id.
|
|
6006
|
+
if (!params.persona) {
|
|
6007
|
+
return {
|
|
6008
|
+
content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}` }],
|
|
6009
|
+
details: { pane_id: pane.pane_id, name: params.name },
|
|
6010
|
+
};
|
|
6011
|
+
}
|
|
6012
|
+
hubSpawnedPeers.set(params.name.toLowerCase(), { name: params.name, paneId: pane.pane_id, addressed: false });
|
|
6013
|
+
const { found, waitedMs } = await waitForPeerRegistration(params.name);
|
|
6014
|
+
const verdict = peerReadyVerdict({ name: params.name, paneId: pane.pane_id, found, waitedMs });
|
|
5528
6015
|
return {
|
|
5529
|
-
content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}` }],
|
|
5530
|
-
details: { pane_id: pane.pane_id, name: params.name },
|
|
6016
|
+
content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}\n\n${verdict.message}` }],
|
|
6017
|
+
details: { pane_id: pane.pane_id, name: params.name, ...verdict },
|
|
5531
6018
|
};
|
|
5532
6019
|
} catch (err) {
|
|
5533
6020
|
const m = err instanceof Error ? err.message : String(err);
|
|
@@ -5955,6 +6442,10 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
5955
6442
|
`${fmtTok(sessionTotals.billed)} billed / ${fmtTok(sessionTotals.out)} out · ${sessionTotals.recycles} recycle(s) · ` +
|
|
5956
6443
|
`${sessionTotals.driftStops} drift stop(s) · ${sessionTotals.refusals} refusal(s)`,
|
|
5957
6444
|
);
|
|
6445
|
+
// A spawned peer that never received work is a running pane nobody is
|
|
6446
|
+
// using — the digest is where it stops being invisible.
|
|
6447
|
+
const sweep = unaddressedPeerSweep(Array.from(hubSpawnedPeers.values()));
|
|
6448
|
+
if (sweep) lines.push(sweep.message);
|
|
5958
6449
|
ctx.ui.notify(lines.join("\n\n"), "info");
|
|
5959
6450
|
},
|
|
5960
6451
|
});
|
|
@@ -6869,6 +7360,8 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
6869
7360
|
await terminated;
|
|
6870
7361
|
}
|
|
6871
7362
|
// Re-run fresh: a frozen session file may be inconsistent, so drop it (no -c).
|
|
7363
|
+
// The file itself still reaches pi via --session, so an unusable one is
|
|
7364
|
+
// quarantined by dispatchAgent's session preflight, not here.
|
|
6872
7365
|
state.sessionFile = null;
|
|
6873
7366
|
ctx.ui.notify(`Restarting ${displayName(state.def.name)} (fresh)...`, "info");
|
|
6874
7367
|
const result = await dispatchAgent(state.def.name, task, ctx);
|
|
@@ -6959,16 +7452,25 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
|
|
|
6959
7452
|
// context % rides the keepalive refresh.
|
|
6960
7453
|
pi.on("before_agent_start", async () => {
|
|
6961
7454
|
turnState = "working";
|
|
7455
|
+
if (monitorBridge && monitorTurnId) monitorBridge.finishParent(monitorTurnId, "completed");
|
|
7456
|
+
if (monitorBridge && monitorHubId) {
|
|
7457
|
+
monitorTurnId = `hub-turn-${monitorHubId}-${crypto.randomUUID()}`;
|
|
7458
|
+
monitorBridge.startParent({ id: monitorTurnId, hubInstanceId: monitorHubId, checkoutId: currentCtx?.cwd || process.cwd() });
|
|
7459
|
+
} else monitorTurnId = null;
|
|
6962
7460
|
if (herdrPresence && identity) {
|
|
6963
7461
|
const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
|
|
6964
|
-
void herdrPresence.report("working",
|
|
7462
|
+
void herdrPresence.report("working", { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
|
|
6965
7463
|
}
|
|
6966
7464
|
});
|
|
6967
7465
|
pi.on("agent_end", async () => {
|
|
6968
7466
|
turnState = "idle";
|
|
7467
|
+
if (monitorBridge && monitorTurnId) {
|
|
7468
|
+
monitorBridge.finishParent(monitorTurnId, "completed");
|
|
7469
|
+
monitorTurnId = null;
|
|
7470
|
+
}
|
|
6969
7471
|
if (herdrPresence && identity) {
|
|
6970
7472
|
const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
|
|
6971
|
-
void herdrPresence.report("idle",
|
|
7473
|
+
void herdrPresence.report("idle", { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
|
|
6972
7474
|
}
|
|
6973
7475
|
});
|
|
6974
7476
|
|
|
@@ -7261,6 +7763,12 @@ acceptance assertions; build it before you dispatch, and refuse "done" until eac
|
|
|
7261
7763
|
assertions and record them with \`set_assertions\` — one pass condition each, tagged
|
|
7262
7764
|
test | runtime-ui | code-grep | manual (see skills/orchestration-verification/SKILL.md).
|
|
7263
7765
|
Pass the relevant assertions VERBATIM into each dispatch.
|
|
7766
|
+
- Every assertion NAMES ITS SOURCE (\`source: "PLAN-x.md:585-595"\`, \`"user request"\`,
|
|
7767
|
+
\`"review finding F3"\`). The hub refuses a sourceless batch by id: a specialist told to
|
|
7768
|
+
prove A9 must be able to read where A9 came from instead of asking you.
|
|
7769
|
+
- Keep at most ${MAX_OPEN_ASSERTIONS} assertions OPEN at once. A large task still has many
|
|
7770
|
+
assertions — declare the batch the next dispatches actually prove, and \`set_assertions\`
|
|
7771
|
+
the next batch when it starts. Over the cap the hub accepts the call but warns.
|
|
7264
7772
|
- Keep assertions NARROW: one subsystem / one behavior each. Never bundle several
|
|
7265
7773
|
subsystems into one giant assertion — a compound assertion forces a full re-audit after
|
|
7266
7774
|
every small fix. After a fix, re-verify the touched assertions only.
|
|
@@ -7305,6 +7813,9 @@ your own team you can talk to the peers in your coms POOL — the agents shown i
|
|
|
7305
7813
|
scoped to YOUR project and excludes private (explicit) peers. You CANNOT widen this — only the human
|
|
7306
7814
|
can, with \`/af-coms --project <name>\` or \`/af-coms --all\`. Do not ask coms_list for other projects.
|
|
7307
7815
|
- \`coms_send\` returns a msg_id; then \`coms_await\` (blocking) or \`coms_get\` (poll) reads the reply.
|
|
7816
|
+
For long work put the SAME budget on both calls: \`coms_send(reply_timeout_ms: N, ...)\`, then
|
|
7817
|
+
\`coms_await(timeout_ms: N, ...)\`. The send controls the receiver; await controls only your local
|
|
7818
|
+
wait. A timeout returns pending — await/get the same msg_id again, never re-send the task.
|
|
7308
7819
|
This lets you use a peer as an on-demand subagent: send a SELF-CONTAINED task, await it, and fold the
|
|
7309
7820
|
result into your plan. A peer does NOT share your context — spell out everything it needs.
|
|
7310
7821
|
- Only peers in your pool are reachable. \`coms_send\`/\`/af-handoff\` to anyone outside it is refused. If
|
|
@@ -7365,9 +7876,17 @@ This session runs inside a herdr workspace and can drive panes:
|
|
|
7365
7876
|
- \`herdr_spawn_peer\` stands up an extra worker next to you — a persona peer (joins the coms
|
|
7366
7877
|
pool, then talk to it via \`coms_send\`) or a raw command pane (a build watcher, a server).
|
|
7367
7878
|
Spawn deliberately; every pane is a process the human sees. Tear down what you spawned.
|
|
7879
|
+
- A spawned persona peer BOOTS IDLE and waits for \`coms_send\`: the spawn hands it no task.
|
|
7880
|
+
The call waits for it to register and returns \`peer_ready\` with its coms name. Spawn one
|
|
7881
|
+
only immediately before the first message you will send it — a peer spawned "to have it
|
|
7882
|
+
ready" and never addressed is an empty pane named like a worker. If you sent it no work
|
|
7883
|
+
by the end of the turn, say so and offer to close it; the hub names unaddressed
|
|
7884
|
+
hub-spawned peers in the session digest.
|
|
7368
7885
|
- \`herdr_read_pane\` is read-to-decide: peek at a worker/tool pane's recent output before
|
|
7369
|
-
acting on it. It is NOT a messaging channel —
|
|
7370
|
-
|
|
7886
|
+
acting on it. It is NOT a messaging channel and NOT a status poll — \`coms_list\` already
|
|
7887
|
+
reports each peer's \`pane_id\` and \`status\` (idle | working | booting), so check that
|
|
7888
|
+
before sending. Prefer \`coms_send\`/\`coms_await\` for pi and bridged peers; reading screens
|
|
7889
|
+
is the last resort for unbridged tools and post-mortems.
|
|
7371
7890
|
- \`herdr_close_pane\` kills a pane and asks the HUMAN to confirm first. Close only panes you
|
|
7372
7891
|
spawned, when their job is done or they are stuck.
|
|
7373
7892
|
- \`herdr_notify\` reaches the human via desktop notification when they are away — use it when
|
|
@@ -7435,6 +7954,7 @@ ${researchCatalog}`;
|
|
|
7435
7954
|
st.delegationsWatcher = undefined;
|
|
7436
7955
|
}
|
|
7437
7956
|
delegatedTokens = 0;
|
|
7957
|
+
hubSpawnedPeers.clear();
|
|
7438
7958
|
widgetCtx = _ctx;
|
|
7439
7959
|
contextWindow = _ctx.model?.contextWindow || 0;
|
|
7440
7960
|
safetyHarnessPath = resolveSafetyHarness(_ctx.cwd);
|
|
@@ -7502,7 +8022,12 @@ ${researchCatalog}`;
|
|
|
7502
8022
|
});
|
|
7503
8023
|
},
|
|
7504
8024
|
});
|
|
8025
|
+
const eventJournal = new MonitorEventJournal({ file: path.join(monitorConfig.runtimeDir, `monitor-events-${stableHubId}.ndjson`) });
|
|
8026
|
+
const invokeJournal = new MonitorInvokeJournal(path.join(monitorConfig.runtimeDir, `monitor-invokes-${stableHubId}.ndjson`));
|
|
7505
8027
|
monitorBridge = createMonitorSessionBridge({
|
|
8028
|
+
events: eventJournal,
|
|
8029
|
+
hubInstanceId: stableHubId,
|
|
8030
|
+
onEventJournalError: (error: unknown) => _ctx.ui.notify(`Agent Fleet monitor event journal unavailable: ${error instanceof Error ? error.message : String(error)}`, "warning"),
|
|
7506
8031
|
runtime: new MonitorRuntime({
|
|
7507
8032
|
runtimeDir: monitorConfig.runtimeDir,
|
|
7508
8033
|
profileId: monitorConfig.profileId,
|
|
@@ -7518,8 +8043,20 @@ ${researchCatalog}`;
|
|
|
7518
8043
|
reason: "unsupported",
|
|
7519
8044
|
},
|
|
7520
8045
|
});
|
|
7521
|
-
|
|
7522
|
-
|
|
8046
|
+
const invoke = createMonitorInvokeAdmission({
|
|
8047
|
+
journal: invokeJournal,
|
|
8048
|
+
task: (id: string, generation: number) => monitorBridge?.snapshot().tasks.find((task: any) => task.id === id && task.generation === generation),
|
|
8049
|
+
owner: () => monitorOwnerId,
|
|
8050
|
+
queueDepth: () => inboundQueue.size,
|
|
8051
|
+
queueLimit: 64,
|
|
8052
|
+
enqueue: createWatchdogFollowUpEnqueue((message, options) => pi.sendMessage(message, options)),
|
|
8053
|
+
publish: (kind: "action.requested" | "action.accepted" | "action.rejected" | "action.completed" | "hub.queue_depth_changed", task: any, extra?: any) => monitorBridge?.publishEvent(kind, task, extra),
|
|
8054
|
+
});
|
|
8055
|
+
const registration = await monitorLifecycle.startBridge(monitorBridge, {
|
|
8056
|
+
profilePath: monitorConfig.profilePath, profileId: monitorConfig.profileId, hubInstanceId: stableHubId,
|
|
8057
|
+
events: (request: any) => eventJournal.replay(request.afterSequence, request.limit, request.waitMs, request.signal), invoke,
|
|
8058
|
+
});
|
|
8059
|
+
monitorOwnerId = registration?.ownerId;
|
|
7523
8060
|
} catch (error) {
|
|
7524
8061
|
monitorLifecycle = null;
|
|
7525
8062
|
_ctx.ui.notify(`Agent Fleet monitor disabled: ${error instanceof Error ? error.message : String(error)}`, "warning");
|
|
@@ -7572,14 +8109,15 @@ ${researchCatalog}`;
|
|
|
7572
8109
|
|
|
7573
8110
|
server = await bindEndpoint(endpoint, connHandler);
|
|
7574
8111
|
|
|
8112
|
+
const started_at = nowIso();
|
|
7575
8113
|
const entry: RegistryEntry = {
|
|
7576
8114
|
session_id, name, purpose, model, color,
|
|
7577
8115
|
pid: process.pid, endpoint, cwd,
|
|
7578
|
-
started_at
|
|
8116
|
+
started_at, explicit, version: 1,
|
|
7579
8117
|
};
|
|
7580
8118
|
const registryFile = writeRegistryAtomic(entry, project);
|
|
7581
8119
|
|
|
7582
|
-
identity = { session_id, name, purpose, color, project, explicit, cwd, model, endpoint, registryFile };
|
|
8120
|
+
identity = { session_id, name, purpose, color, project, explicit, cwd, model, endpoint, registryFile, started_at };
|
|
7583
8121
|
includeExplicit = false;
|
|
7584
8122
|
displayProject = project;
|
|
7585
8123
|
comsReady = true;
|
|
@@ -7593,14 +8131,26 @@ ${researchCatalog}`;
|
|
|
7593
8131
|
// Presence backend: herdr (push events, no polling) when this
|
|
7594
8132
|
// session runs inside a herdr pane with a live server; the files
|
|
7595
8133
|
// ping loop otherwise. The registry keepalive runs in BOTH — it
|
|
7596
|
-
// carries the full agent card (
|
|
7597
|
-
//
|
|
7598
|
-
//
|
|
8134
|
+
// carries the full agent card (purpose, model, colour) that a
|
|
8135
|
+
// pane annotation is no place for, and keeps us discoverable
|
|
8136
|
+
// to peers running outside herdr panes.
|
|
7599
8137
|
const useHerdr = await herdrPresenceAvailable();
|
|
7600
8138
|
if (useHerdr) {
|
|
7601
8139
|
const paneId = herdrPaneId()!;
|
|
7602
|
-
herdrPresence = new HerdrPresence({
|
|
7603
|
-
|
|
8140
|
+
herdrPresence = new HerdrPresence({
|
|
8141
|
+
paneId,
|
|
8142
|
+
source: `coms:${session_id}`,
|
|
8143
|
+
// A herdr that rejects our annotation dialect used to
|
|
8144
|
+
// be invisible: presence swallows errors, so the
|
|
8145
|
+
// sidebar simply stayed blank and every watcher saw
|
|
8146
|
+
// "detached" forever.
|
|
8147
|
+
onError: (err, dialect) => {
|
|
8148
|
+
try {
|
|
8149
|
+
pi.appendEntry("coms-log", { event: "presence_dialect_rejected", dialect, reason: err?.message ?? String(err) });
|
|
8150
|
+
} catch { /* best-effort */ }
|
|
8151
|
+
},
|
|
8152
|
+
});
|
|
8153
|
+
void herdrPresence.report("idle", { name, project, contextUsedPct: 0, queueDepth: 0 });
|
|
7604
8154
|
herdrWatch = new HerdrAgentWatch({
|
|
7605
8155
|
ownPaneId: paneId,
|
|
7606
8156
|
onChange: (agents) => herdrSyncPeerCards(agents),
|
|
@@ -7625,7 +8175,7 @@ ${researchCatalog}`;
|
|
|
7625
8175
|
// cards against the registry heartbeats just written.
|
|
7626
8176
|
if (herdrPresence && identity) {
|
|
7627
8177
|
const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
|
|
7628
|
-
void herdrPresence.report(turnState,
|
|
8178
|
+
void herdrPresence.report(turnState, { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
|
|
7629
8179
|
}
|
|
7630
8180
|
if (herdrWatch) herdrSyncPeerCards(herdrWatch.current());
|
|
7631
8181
|
}, KEEPALIVE_INTERVAL_MS);
|
|
@@ -7713,7 +8263,7 @@ ${researchCatalog}`;
|
|
|
7713
8263
|
thinkingOverrides.clear();
|
|
7714
8264
|
for (const def of allAgentDefs) {
|
|
7715
8265
|
const lower = def.name.toLowerCase();
|
|
7716
|
-
if (overrides.personaModels[lower]) def
|
|
8266
|
+
if (overrides.personaModels[lower]) Object.assign(def, applyModelOverride(def, overrides.personaModels[lower]));
|
|
7717
8267
|
if (overrides.personaModelLists[lower]) def.models = overrides.personaModelLists[lower];
|
|
7718
8268
|
if (overrides.personaThinking[lower]) def.thinking = overrides.personaThinking[lower];
|
|
7719
8269
|
// Delegation overrides: replace/add individual sub-roles (other declared
|
|
@@ -7721,7 +8271,15 @@ ${researchCatalog}`;
|
|
|
7721
8271
|
const subOv = overrides.personaSubagents[lower];
|
|
7722
8272
|
if (subOv) {
|
|
7723
8273
|
def.subagents = { ...(def.subagents || {}) };
|
|
7724
|
-
for (const [role, r] of Object.entries(subOv))
|
|
8274
|
+
for (const [role, r] of Object.entries(subOv)) {
|
|
8275
|
+
const declared = def.subagents[role];
|
|
8276
|
+
// A model-only override keeps the declared tool cap; an explicit
|
|
8277
|
+
// tools= value replaces it. Either way the frontmatter model is
|
|
8278
|
+
// retained as the one-shot runtime fallback.
|
|
8279
|
+
def.subagents[role] = declared
|
|
8280
|
+
? applyModelOverride({ ...declared, ...(r.tools ? { tools: r.tools } : {}) }, r.model)
|
|
8281
|
+
: r;
|
|
8282
|
+
}
|
|
7725
8283
|
}
|
|
7726
8284
|
if (overrides.personaDelegateDepth[lower] !== undefined) {
|
|
7727
8285
|
def.delegateDepth = overrides.personaDelegateDepth[lower];
|
|
@@ -7920,6 +8478,12 @@ ${researchCatalog}`;
|
|
|
7920
8478
|
historyRender?.();
|
|
7921
8479
|
}
|
|
7922
8480
|
|
|
8481
|
+
// End-of-turn sweep: a peer spawned this turn and never sent to is still
|
|
8482
|
+
// running. Named once per turn it stays unaddressed; the close itself is
|
|
8483
|
+
// the human's call (herdr_close_pane keeps its confirmation).
|
|
8484
|
+
const peerSweep = unaddressedPeerSweep(Array.from(hubSpawnedPeers.values()));
|
|
8485
|
+
if (peerSweep) ctx.ui.notify(peerSweep.message, "warning");
|
|
8486
|
+
|
|
7923
8487
|
const inbound = [...inboundQueue.values()].reverse().find((i) => !i.fulfilled);
|
|
7924
8488
|
if (!inbound || !identity) return;
|
|
7925
8489
|
|