@chankov/agent-fleet 2.0.14 → 2.0.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agent-fleet/scripts/fleet.ts +2 -1
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/harnesses/agent-hub/README.md +89 -10
- package/.pi/harnesses/agent-hub/budget-recovery.ts +2 -2
- package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
- package/.pi/harnesses/agent-hub/commands/recover.ts +13 -4
- package/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.pi/harnesses/agent-hub/context/budgets.ts +9 -7
- package/.pi/harnesses/agent-hub/deterministic-fs.ts +51 -12
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +4 -0
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +14 -3
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +3 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +9 -1
- package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +2 -1
- package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +2 -0
- package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +23 -5
- package/.pi/harnesses/agent-hub/docs-lane.js +2 -1
- package/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.pi/harnesses/agent-hub/filesystem-tool.ts +75 -11
- package/.pi/harnesses/agent-hub/index.ts +246 -19
- package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +13 -5
- package/.pi/harnesses/agent-hub/no-progress.ts +232 -28
- package/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +14 -5
- package/.pi/harnesses/agent-hub/process-obligations.ts +116 -15
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +9 -11
- package/.pi/harnesses/agent-hub/recover-policy.ts +18 -1
- package/.pi/harnesses/agent-hub/recover-state.ts +1 -1
- package/.pi/harnesses/agent-hub/recovery-contract.ts +70 -0
- package/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +2 -0
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +15 -6
- package/.pi/harnesses/agent-hub/return-contract.js +27 -5
- package/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.pi/harnesses/agent-hub/run-budget.js +12 -0
- package/.pi/harnesses/agent-hub/scope-gate.js +23 -2
- package/.pi/harnesses/agent-hub/session-audit.ts +94 -8
- package/.pi/harnesses/agent-hub/spawn.ts +10 -2
- package/.pi/harnesses/agent-hub/system1-activity.ts +116 -1
- package/.pi/harnesses/agent-hub/system1-communication-store.ts +47 -13
- package/.pi/harnesses/agent-hub/system1-report.ts +50 -0
- package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -2
- package/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
- package/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
- package/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +33 -10
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +86 -26
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +9 -0
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +9 -6
- package/.pi/harnesses/agent-hub/ui/fleet-source.ts +6 -2
- package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
- package/.pi/harnesses/agent-hub/work-mode.ts +13 -8
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +6 -1
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +29 -4
- package/.pi/harnesses/lib/fleet-read-model.ts +73 -0
- package/.pi/harnesses/lib/system1/demo.ts +2 -4
- package/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.pi/prompts/af-build.md +9 -6
- package/.versions/2.0.15/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.15/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.15/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.15/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.15/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.15/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.15/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.15/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.15/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.15/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.15/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.15/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.15/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.15/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.15/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.15/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.15/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.15/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.15/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.15/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.15/.pi/extensions/package.json +9 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.15/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/README.md +1448 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/delegate.ts +467 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +76 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/registration-surface.json +64 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/index.ts +2597 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/no-progress.ts +563 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/work-mode.ts +135 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/fragments.ts +116 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/spawn.ts +534 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-communication-store.ts +129 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-runtime.ts +280 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-closure.user-run.mjs +336 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs +157 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode.ts +179 -0
- package/.versions/2.0.15/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.15/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.15/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.15/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.15/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.15/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.15/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.15/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.15/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.15/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.15/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.15/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.15/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.15/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.15/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.15/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.15/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.15/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.15/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
- package/.versions/2.0.15/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.15/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.15/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.15/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.15/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.15/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.15/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.15/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.15/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.15/.pi/harnesses/lib/system1/config.js +61 -0
- package/.versions/2.0.15/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.versions/2.0.15/.pi/harnesses/lib/system1/demo.ts +104 -0
- package/.versions/2.0.15/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.15/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.15/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.15/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.15/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.15/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.15/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.15/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.15/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.15/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.15/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.15/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.15/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.15/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.15/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.15/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.15/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.15/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.15/.version +1 -0
- package/.versions/2.0.15/agents/architect.md +24 -0
- package/.versions/2.0.15/agents/bowser.md +28 -0
- package/.versions/2.0.15/agents/builder.md +55 -0
- package/.versions/2.0.15/agents/code-reviewer.md +209 -0
- package/.versions/2.0.15/agents/deep-researcher.md +32 -0
- package/.versions/2.0.15/agents/documenter.md +22 -0
- package/.versions/2.0.15/agents/orchestrator.md +22 -0
- package/.versions/2.0.15/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.15/agents/planner.md +105 -0
- package/.versions/2.0.15/agents/releaser.md +24 -0
- package/.versions/2.0.15/agents/researcher.md +30 -0
- package/.versions/2.0.15/agents/security-auditor.md +167 -0
- package/.versions/2.0.15/agents/test-engineer.md +153 -0
- package/.versions/2.0.15/agents/web-debugger.md +44 -0
- package/.versions/2.0.15/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.15/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.15/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.15/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.15/docs/ARCHITECTURE.md +829 -0
- package/.versions/2.0.15/docs/agent-fleet-setup.md +1090 -0
- package/.versions/2.0.15/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.15/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.15/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.15/docs/getting-started.md +126 -0
- package/.versions/2.0.15/docs/npm-install.md +525 -0
- package/.versions/2.0.15/docs/pi-extensions.md +454 -0
- package/.versions/2.0.15/docs/pi-setup.md +92 -0
- package/.versions/2.0.15/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.15/install-manifest.json +3193 -0
- package/.versions/2.0.15/justfile +247 -0
- package/.versions/2.0.15/manifest-meta.json +1071 -0
- package/.versions/2.0.15/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.15/references/communication-contract.md +26 -0
- package/.versions/2.0.15/references/definition-of-done.md +67 -0
- package/.versions/2.0.15/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.15/references/observability-checklist.md +92 -0
- package/.versions/2.0.15/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.15/references/performance-checklist.md +236 -0
- package/.versions/2.0.15/references/prompting-patterns.md +380 -0
- package/.versions/2.0.15/references/security-checklist.md +245 -0
- package/.versions/2.0.15/references/testing-patterns.md +235 -0
- package/.versions/2.0.15/references/workflow-authoring.md +304 -0
- package/.versions/2.0.15/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.15/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.15/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.15/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.15/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.15/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.15/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.15/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.15/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.15/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.15/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.15/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.15/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.15/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.15/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.15/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.15/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.15/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.15/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.15/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.15/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.15/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.15/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.15/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.15/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.15/skills/repository-ai-setup/SKILL.md +117 -0
- package/.versions/2.0.15/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.15/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.15/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.15/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.15/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.15/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.15/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.15/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.15/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +6 -0
- package/README.md +1 -1
- package/agents/builder.md +2 -2
- package/bin/cli.js +16 -2
- package/bin/lib/apply.js +5 -0
- package/bin/lib/doctor.js +85 -12
- package/bin/lib/reconcile.js +9 -1
- package/bin/lib/state.js +1 -0
- package/bin/lib/task-triage-setup.js +76 -0
- package/bin/lib/transaction.js +4 -0
- package/docs/ARCHITECTURE.md +99 -24
- package/docs/agent-fleet-setup.md +179 -6
- package/docs/npm-install.md +64 -15
- package/docs/pi-extensions.md +1 -1
- package/install-manifest.json +13 -3
- package/manifest-meta.json +6 -0
- package/package.json +9 -2
- package/skills/incremental-implementation/SKILL.md +64 -13
- package/skills/planning-and-task-breakdown/SKILL.md +43 -14
- package/skills/using-agent-skills/SKILL.md +2 -2
|
@@ -0,0 +1,349 @@
|
|
|
1
|
+
// Drift watchdog — the pure policy core behind in-flight specialist
|
|
2
|
+
// observation. Layer 1 is deterministic rules over the child's tool event
|
|
3
|
+
// stream (zero tokens); a firing rule is an ESCALATION SIGNAL, not a verdict —
|
|
4
|
+
// the harness then asks a cheap LLM judge (layer 2) whether the run is still
|
|
5
|
+
// on task, and only a DRIFTING/STUCK verdict terminates it (`drift_stop`).
|
|
6
|
+
// Everything here is data + pure functions so the policy is unit-testable
|
|
7
|
+
// away from the harness.
|
|
8
|
+
|
|
9
|
+
import { checkScope } from "./scope-gate.js";
|
|
10
|
+
|
|
11
|
+
export const WATCHDOG_SETTINGS = ["on", "off", "auto"];
|
|
12
|
+
export const DEFAULT_WATCHDOG_SETTING = "auto";
|
|
13
|
+
|
|
14
|
+
/** "On", " AUTO " → canonical setting, or null when unrecognized. */
|
|
15
|
+
export function normalizeWatchdogSetting(value) {
|
|
16
|
+
const v = String(value ?? "").trim().toLowerCase();
|
|
17
|
+
return WATCHDOG_SETTINGS.includes(v) ? v : null;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Is the watchdog armed for one dispatch?
|
|
22
|
+
* Operator (or omitted work mode): dispatch param > per-agent /af-watchdog
|
|
23
|
+
* override ("on"/"off") > hub-wide setting ("on"/"auto" arm, "off" disarms).
|
|
24
|
+
* Orchestrator: hub `off` or per-agent `off` still disarms; otherwise armed.
|
|
25
|
+
* A specialist cannot pass `watchdog: false` to sneak around orchestrator.
|
|
26
|
+
*/
|
|
27
|
+
export function resolveWatchdogActive(dispatchParam, agentOverride, hubSetting, workMode) {
|
|
28
|
+
if (workMode === "orchestrator") {
|
|
29
|
+
if (normalizeWatchdogSetting(hubSetting) === "off") return false;
|
|
30
|
+
if (agentOverride === "off") return false;
|
|
31
|
+
return true;
|
|
32
|
+
}
|
|
33
|
+
if (dispatchParam === true) return true;
|
|
34
|
+
if (dispatchParam === false) return false;
|
|
35
|
+
if (agentOverride === "on") return true;
|
|
36
|
+
if (agentOverride === "off") return false;
|
|
37
|
+
return normalizeWatchdogSetting(hubSetting) !== "off";
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// Conservative thresholds: a false positive kills a productive run, so every
|
|
41
|
+
// rule needs sustained evidence before it fires.
|
|
42
|
+
export const DRIFT_DEFAULTS = {
|
|
43
|
+
writeTools: ["write", "edit"],
|
|
44
|
+
maxRepeats: 4,
|
|
45
|
+
maxConsecutiveFailures: 5,
|
|
46
|
+
maxToolCalls: 200,
|
|
47
|
+
trailLimit: 60,
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
/** Specialist tool kinds that may appear in structured observations. Anything else is `other`. */
|
|
51
|
+
export const WATCHDOG_TOOL_KINDS = ["read", "write", "edit", "bash", "grep", "find", "ls"];
|
|
52
|
+
const WATCHDOG_TOOL_KIND_SET = new Set(WATCHDOG_TOOL_KINDS);
|
|
53
|
+
/** Calibrated structured window. Legacy `trailLimit` is a separate judge-text bound. */
|
|
54
|
+
export const WATCHDOG_STRUCTURED_EVENT_LIMIT = 40;
|
|
55
|
+
|
|
56
|
+
/** Session subtrees the hub itself tells specialists to write into. */
|
|
57
|
+
export const HUB_OWNED_SUBDIRS = ["artifacts", "findings", "delegations"];
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Globs for the paths the deliverable protocol ORDERS the specialist to write
|
|
61
|
+
* (`artifacts/<kind>/<agentKey>-run<N>.md` and friends). A dispatcher's `scope:`
|
|
62
|
+
* never lists them, so checking writes against the declared scope alone made the
|
|
63
|
+
* hub punish obedience: `planner` was killed after 1088s and `documenter` after
|
|
64
|
+
* 120s for writing exactly where they were told to.
|
|
65
|
+
*
|
|
66
|
+
* Pass every form the path can arrive in — the absolute session dir and its
|
|
67
|
+
* repo-relative twin — since the specialist may use either.
|
|
68
|
+
*/
|
|
69
|
+
export function hubOwnedScopeGlobs(...sessionDirs) {
|
|
70
|
+
const globs = [];
|
|
71
|
+
for (const dir of sessionDirs) {
|
|
72
|
+
const base = String(dir || "").trim().replace(/\\/g, "/").replace(/\/+$/, "");
|
|
73
|
+
if (!base) continue;
|
|
74
|
+
for (const sub of HUB_OWNED_SUBDIRS) globs.push(`${base}/${sub}/**`);
|
|
75
|
+
}
|
|
76
|
+
return [...new Set(globs)];
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
const pathFromArgs = (argStr) => {
|
|
80
|
+
try {
|
|
81
|
+
const args = JSON.parse(argStr || "{}");
|
|
82
|
+
for (const key of ["path", "file_path", "filePath", "file", "filename"]) {
|
|
83
|
+
if (typeof args[key] === "string" && args[key].trim()) return args[key].trim();
|
|
84
|
+
}
|
|
85
|
+
} catch {}
|
|
86
|
+
return null;
|
|
87
|
+
};
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Per-run monitor fed from the tool event stream. `onToolStart(tool, argStr)`
|
|
91
|
+
* and `onToolEnd(tool, isError)` return `null` while the run looks healthy, or
|
|
92
|
+
* `{ rule, terminal, detail }` when a rule crosses its threshold:
|
|
93
|
+
* scope — a write-capable tool touched a path outside the declared scope
|
|
94
|
+
* loop — the exact same (tool, args) call repeated maxRepeats times
|
|
95
|
+
* failures — maxConsecutiveFailures failed tool calls in a row
|
|
96
|
+
* toolcap — maxToolCalls total tool calls in one run
|
|
97
|
+
* Each rule instance fires once (at the crossing), so the caller escalates —
|
|
98
|
+
* it never gets spammed. `trail(n)` returns the recent tool trail for the judge.
|
|
99
|
+
*
|
|
100
|
+
* `terminal: false` marks a signal that must never end a run on its own: the
|
|
101
|
+
* post-run scope gate is advisory by design ("nothing is auto-reverted"), so the
|
|
102
|
+
* live rule watching the same thing cannot be a death sentence. `scope` reports;
|
|
103
|
+
* only the genuinely stuck rules stop work.
|
|
104
|
+
*/
|
|
105
|
+
export function createDriftMonitor(cfg = {}) {
|
|
106
|
+
const scopeGlobs = (cfg.scopeGlobs || []).filter(Boolean);
|
|
107
|
+
const allowGlobs = (cfg.allowGlobs || []).filter(Boolean);
|
|
108
|
+
// A path in EITHER the declared scope or the hub-owned allowlist is in scope.
|
|
109
|
+
const effectiveScope = [...scopeGlobs, ...allowGlobs];
|
|
110
|
+
const writeTools = new Set(cfg.writeTools || DRIFT_DEFAULTS.writeTools);
|
|
111
|
+
const maxRepeats = cfg.maxRepeats ?? DRIFT_DEFAULTS.maxRepeats;
|
|
112
|
+
const maxConsecutiveFailures = cfg.maxConsecutiveFailures ?? DRIFT_DEFAULTS.maxConsecutiveFailures;
|
|
113
|
+
const maxToolCalls = cfg.maxToolCalls ?? DRIFT_DEFAULTS.maxToolCalls;
|
|
114
|
+
const trailLimit = cfg.trailLimit ?? DRIFT_DEFAULTS.trailLimit;
|
|
115
|
+
|
|
116
|
+
const callCounts = new Map();
|
|
117
|
+
const trailLines = [];
|
|
118
|
+
const groupIds = new Map();
|
|
119
|
+
const groupCounts = new Map();
|
|
120
|
+
const structuredEvents = [];
|
|
121
|
+
let nextGroup = 1;
|
|
122
|
+
let totalCalls = 0;
|
|
123
|
+
let consecutiveFailures = 0;
|
|
124
|
+
let failureCount = 0;
|
|
125
|
+
let eventsSeen = 0;
|
|
126
|
+
let droppedByWindow = 0;
|
|
127
|
+
let droppedIncomplete = 0;
|
|
128
|
+
let unparsedEvents = 0;
|
|
129
|
+
|
|
130
|
+
const pushTrail = (line) => {
|
|
131
|
+
trailLines.push(line);
|
|
132
|
+
if (trailLines.length > trailLimit) trailLines.shift();
|
|
133
|
+
};
|
|
134
|
+
|
|
135
|
+
const pushStructured = (event) => {
|
|
136
|
+
structuredEvents.push(event);
|
|
137
|
+
while (structuredEvents.length > WATCHDOG_STRUCTURED_EVENT_LIMIT) {
|
|
138
|
+
const dropped = structuredEvents.shift();
|
|
139
|
+
if (dropped?.open) droppedIncomplete++;
|
|
140
|
+
else droppedByWindow++;
|
|
141
|
+
}
|
|
142
|
+
};
|
|
143
|
+
|
|
144
|
+
const noteStructuredStart = (toolName, argStr, callId) => {
|
|
145
|
+
if (typeof toolName !== "string" || (argStr != null && typeof argStr !== "string")) {
|
|
146
|
+
eventsSeen++;
|
|
147
|
+
unparsedEvents++;
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
const fingerprint = `${toolName}::${argStr || ""}`;
|
|
151
|
+
let group = groupIds.get(fingerprint);
|
|
152
|
+
if (!group) {
|
|
153
|
+
group = nextGroup++;
|
|
154
|
+
groupIds.set(fingerprint, group);
|
|
155
|
+
}
|
|
156
|
+
const repeat = (groupCounts.get(fingerprint) || 0) + 1;
|
|
157
|
+
groupCounts.set(fingerprint, repeat);
|
|
158
|
+
eventsSeen++;
|
|
159
|
+
const event = {
|
|
160
|
+
tool: WATCHDOG_TOOL_KIND_SET.has(toolName) ? toolName : "other",
|
|
161
|
+
outcome: "unknown",
|
|
162
|
+
repeat_group: group,
|
|
163
|
+
repeat_count: repeat,
|
|
164
|
+
open: true,
|
|
165
|
+
};
|
|
166
|
+
if (callId != null && callId !== "") event.callId = String(callId);
|
|
167
|
+
const path = pathFromArgs(argStr);
|
|
168
|
+
if (path) event.path = path;
|
|
169
|
+
pushStructured(event);
|
|
170
|
+
};
|
|
171
|
+
|
|
172
|
+
const closeStructured = (toolName, outcome, callId) => {
|
|
173
|
+
if (typeof toolName !== "string") {
|
|
174
|
+
unparsedEvents++;
|
|
175
|
+
return;
|
|
176
|
+
}
|
|
177
|
+
const kind = WATCHDOG_TOOL_KIND_SET.has(toolName) ? toolName : "other";
|
|
178
|
+
const close = (event) => {
|
|
179
|
+
event.outcome = outcome;
|
|
180
|
+
event.open = false;
|
|
181
|
+
};
|
|
182
|
+
if (callId != null && callId !== "") {
|
|
183
|
+
const id = String(callId);
|
|
184
|
+
const matches = structuredEvents.filter((event) => event.open && event.callId === id);
|
|
185
|
+
// Duplicate or mismatched ids are ambiguous — do not attach this end to another call.
|
|
186
|
+
if (matches.length !== 1 || matches[0].tool !== kind) {
|
|
187
|
+
unparsedEvents++;
|
|
188
|
+
return;
|
|
189
|
+
}
|
|
190
|
+
close(matches[0]);
|
|
191
|
+
return;
|
|
192
|
+
}
|
|
193
|
+
// No id: only an unambiguous unkeyed open of this kind. Never steal a callId-tracked event.
|
|
194
|
+
const unkeyed = structuredEvents.filter((event) => event.open && event.tool === kind && (event.callId == null || event.callId === ""));
|
|
195
|
+
if (unkeyed.length !== 1) {
|
|
196
|
+
unparsedEvents++;
|
|
197
|
+
return;
|
|
198
|
+
}
|
|
199
|
+
close(unkeyed[0]);
|
|
200
|
+
};
|
|
201
|
+
|
|
202
|
+
let lastScopeViolation = null;
|
|
203
|
+
let lastLoopViolation = null;
|
|
204
|
+
return {
|
|
205
|
+
isSignalCurrent(violation) {
|
|
206
|
+
switch (violation?.rule) {
|
|
207
|
+
case "scope": return lastScopeViolation === violation.detail;
|
|
208
|
+
case "loop": return lastLoopViolation === violation.detail;
|
|
209
|
+
case "toolcap": return totalCalls >= maxToolCalls;
|
|
210
|
+
case "failures": return consecutiveFailures >= maxConsecutiveFailures;
|
|
211
|
+
default: return false;
|
|
212
|
+
}
|
|
213
|
+
},
|
|
214
|
+
onToolStart(toolName, argStr, callId) {
|
|
215
|
+
totalCalls++;
|
|
216
|
+
pushTrail(`${toolName} ${String(argStr || "").slice(0, 120)}`.trim());
|
|
217
|
+
noteStructuredStart(toolName, argStr, callId);
|
|
218
|
+
|
|
219
|
+
lastScopeViolation = null;
|
|
220
|
+
if (scopeGlobs.length > 0 && writeTools.has(toolName)) {
|
|
221
|
+
const path = pathFromArgs(argStr);
|
|
222
|
+
if (path && checkScope([path], effectiveScope).outOfScope.length > 0) {
|
|
223
|
+
lastScopeViolation = `${toolName} touched ${path} — outside the declared scope (${scopeGlobs.join(", ")})`;
|
|
224
|
+
return { rule: "scope", terminal: false, detail: lastScopeViolation };
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
const fingerprint = `${toolName}::${argStr || ""}`;
|
|
229
|
+
const count = (callCounts.get(fingerprint) || 0) + 1;
|
|
230
|
+
callCounts.set(fingerprint, count);
|
|
231
|
+
if (count === maxRepeats) {
|
|
232
|
+
lastLoopViolation = `${toolName} called ${count}× with identical arguments — likely stuck in a loop`;
|
|
233
|
+
return { rule: "loop", terminal: true, detail: lastLoopViolation };
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
if (totalCalls === maxToolCalls) {
|
|
237
|
+
return { rule: "toolcap", terminal: true, detail: `${totalCalls} tool calls in one run — far beyond a focused task` };
|
|
238
|
+
}
|
|
239
|
+
return null;
|
|
240
|
+
},
|
|
241
|
+
|
|
242
|
+
onToolEnd(toolName, isError, callId) {
|
|
243
|
+
if (isError === true) {
|
|
244
|
+
consecutiveFailures++;
|
|
245
|
+
failureCount++;
|
|
246
|
+
pushTrail(" ↳ FAILED");
|
|
247
|
+
closeStructured(toolName, "error", callId);
|
|
248
|
+
if (consecutiveFailures % maxConsecutiveFailures === 0) {
|
|
249
|
+
return { rule: "failures", terminal: true, detail: `${consecutiveFailures} consecutive failed tool calls — no forward progress` };
|
|
250
|
+
}
|
|
251
|
+
} else if (isError === false) {
|
|
252
|
+
consecutiveFailures = 0;
|
|
253
|
+
closeStructured(toolName, "success", callId);
|
|
254
|
+
} else {
|
|
255
|
+
// Missing error flag is incomplete, not success, and must not stay open for a later end.
|
|
256
|
+
closeStructured(toolName, "unknown", callId);
|
|
257
|
+
}
|
|
258
|
+
return null;
|
|
259
|
+
},
|
|
260
|
+
|
|
261
|
+
trail(n = 40) {
|
|
262
|
+
return trailLines.slice(-n);
|
|
263
|
+
},
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* Structured observation for watchdog-state/v1. Not the legacy trail and not
|
|
267
|
+
* the outbound payload: no raw arguments, command text, write bodies, or detail.
|
|
268
|
+
* Repeat groups are local integers; the fingerprint map stays in this closure.
|
|
269
|
+
*/
|
|
270
|
+
structuredObservation() {
|
|
271
|
+
return {
|
|
272
|
+
events: structuredEvents.map((event) => {
|
|
273
|
+
const publicEvent = {
|
|
274
|
+
tool: event.tool,
|
|
275
|
+
outcome: event.open ? "unknown" : event.outcome,
|
|
276
|
+
repeat_group: event.repeat_group,
|
|
277
|
+
repeat_count: event.repeat_count,
|
|
278
|
+
};
|
|
279
|
+
if (event.path) publicEvent.path = event.path;
|
|
280
|
+
return publicEvent;
|
|
281
|
+
}),
|
|
282
|
+
counters: {
|
|
283
|
+
tool_calls: totalCalls,
|
|
284
|
+
failures: failureCount,
|
|
285
|
+
consecutive_failures: consecutiveFailures,
|
|
286
|
+
},
|
|
287
|
+
coverage: {
|
|
288
|
+
events_seen: eventsSeen,
|
|
289
|
+
dropped_by_window: droppedByWindow,
|
|
290
|
+
dropped_incomplete: droppedIncomplete,
|
|
291
|
+
unparsed_events: unparsedEvents,
|
|
292
|
+
missing_tool_end: structuredEvents.filter((event) => event.open).length,
|
|
293
|
+
},
|
|
294
|
+
};
|
|
295
|
+
},
|
|
296
|
+
};
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* The one-shot judge prompt: original task + declared scope + recent trail +
|
|
301
|
+
* the rule that fired. The judge answers with a single machine-parseable line.
|
|
302
|
+
* @param {{agent: string, task: string, scopeGlobs?: string[], hubOwnedGlobs?: string[], trail?: string[], violation?: {rule: string, detail: string, terminal?: boolean}}} input
|
|
303
|
+
*/
|
|
304
|
+
export function buildJudgePrompt({ agent, task, scopeGlobs = [], hubOwnedGlobs = [], trail = [], violation }) {
|
|
305
|
+
const scopeBlock = scopeGlobs.length > 0
|
|
306
|
+
? `\n## Declared file scope\n${scopeGlobs.map(s => `- ${s}`).join("\n")}\n`
|
|
307
|
+
: "";
|
|
308
|
+
// Without this block the judge reads a protocol-mandated artifact write as
|
|
309
|
+
// rogue behaviour and answers DRIFTING — which is how obedient runs got killed.
|
|
310
|
+
const hubOwnedBlock = hubOwnedGlobs.length > 0
|
|
311
|
+
? `\n## Hub-owned paths (writing here is REQUIRED, never drift)\nThe dispatcher orders every specialist to write its deliverable to these paths. ` +
|
|
312
|
+
`They are outside the declared scope by design — treat writes here as on-task:\n${hubOwnedGlobs.map(s => `- ${s}`).join("\n")}\n`
|
|
313
|
+
: "";
|
|
314
|
+
const advisoryBlock = violation?.terminal === false
|
|
315
|
+
? `\nThis signal is ADVISORY: it cannot stop the run by itself. Answer honestly about the whole trail, ` +
|
|
316
|
+
`not about this one write.\n`
|
|
317
|
+
: "";
|
|
318
|
+
return `You are a drift watchdog judging whether a running coding agent is still on task.
|
|
319
|
+
Do not solve the task. Judge only whether the agent's recent actions serve it.
|
|
320
|
+
|
|
321
|
+
## Agent
|
|
322
|
+
${agent}
|
|
323
|
+
|
|
324
|
+
## Original task (verbatim)
|
|
325
|
+
${task}
|
|
326
|
+
${scopeBlock}${hubOwnedBlock}
|
|
327
|
+
## Escalation signal
|
|
328
|
+
Rule "${violation?.rule || "unknown"}" fired: ${violation?.detail || "(no detail)"}
|
|
329
|
+
${advisoryBlock}
|
|
330
|
+
|
|
331
|
+
## Recent tool trail (oldest first)
|
|
332
|
+
${trail.length > 0 ? trail.join("\n") : "(no tool calls recorded)"}
|
|
333
|
+
|
|
334
|
+
## Your answer
|
|
335
|
+
Reply with EXACTLY one line, nothing else:
|
|
336
|
+
VERDICT: ON_TRACK — <why the actions still serve the task>
|
|
337
|
+
VERDICT: DRIFTING — <what the agent is doing instead of the task>
|
|
338
|
+
VERDICT: STUCK — <the loop or dead end it cannot escape>
|
|
339
|
+
Prefer ON_TRACK unless the trail clearly contradicts the task: false alarms kill
|
|
340
|
+
productive work.`;
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
/** Parse the judge's reply. Returns { verdict, reason } or null when unparseable. */
|
|
344
|
+
export function parseJudgeVerdict(text) {
|
|
345
|
+
const matches = [...String(text ?? "").matchAll(/VERDICT:\s*(ON_TRACK|DRIFTING|STUCK)\s*(?:[—:-]\s*(.*))?/gi)];
|
|
346
|
+
if (matches.length === 0) return null;
|
|
347
|
+
const last = matches[matches.length - 1];
|
|
348
|
+
return { verdict: last[1].toLowerCase(), reason: (last[2] || "").trim() };
|
|
349
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
export interface EvidenceManifestInput {
|
|
2
|
+
revision: string;
|
|
3
|
+
scope: string[];
|
|
4
|
+
changes: string[];
|
|
5
|
+
commands: { command: string; exitCode: number }[];
|
|
6
|
+
tests: { executed: number; passed: number; failed: number; testIds?: string[] };
|
|
7
|
+
evidenceRefs: string[];
|
|
8
|
+
openAssertions: string[];
|
|
9
|
+
observedRevision: string;
|
|
10
|
+
maxChanges?: number;
|
|
11
|
+
fullArtifact?: string;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface EvidenceManifest {
|
|
15
|
+
revision: string;
|
|
16
|
+
scope: string[];
|
|
17
|
+
changes: string[];
|
|
18
|
+
commands: { command: string; exitCode: number }[];
|
|
19
|
+
tests: EvidenceManifestInput["tests"];
|
|
20
|
+
evidenceRefs: string[];
|
|
21
|
+
openAssertions: string[];
|
|
22
|
+
truncated: boolean;
|
|
23
|
+
fullArtifact?: string;
|
|
24
|
+
stale: boolean;
|
|
25
|
+
mismatch: boolean;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function buildEvidenceManifest(input: EvidenceManifestInput): EvidenceManifest {
|
|
29
|
+
const limit = input.maxChanges ?? input.changes.length;
|
|
30
|
+
const truncated = input.changes.length > limit;
|
|
31
|
+
const outsideScope = input.changes.some(path => !input.scope.includes(path));
|
|
32
|
+
return {
|
|
33
|
+
revision: input.revision,
|
|
34
|
+
scope: [...input.scope],
|
|
35
|
+
changes: input.changes.slice(0, limit),
|
|
36
|
+
commands: input.commands.map(command => ({ ...command })),
|
|
37
|
+
tests: { ...input.tests, testIds: input.tests.testIds ? [...input.tests.testIds] : undefined },
|
|
38
|
+
evidenceRefs: [...input.evidenceRefs],
|
|
39
|
+
openAssertions: [...input.openAssertions],
|
|
40
|
+
truncated,
|
|
41
|
+
...(truncated ? { fullArtifact: input.fullArtifact } : {}),
|
|
42
|
+
stale: input.observedRevision !== input.revision,
|
|
43
|
+
mismatch: outsideScope,
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export function rawReadsRequired(manifest: EvidenceManifest, requested: string[]): string[] {
|
|
48
|
+
if (manifest.stale || manifest.mismatch || manifest.truncated) return [...requested];
|
|
49
|
+
const covered = new Set([...manifest.scope, ...manifest.changes, ...manifest.evidenceRefs]);
|
|
50
|
+
return requested.filter(path => !covered.has(path));
|
|
51
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { isAbsolute, relative, resolve } from "node:path";
|
|
2
|
+
|
|
3
|
+
const KNOWN_TAGS = new Set(["test", "runtime-ui", "code-grep", "manual"]);
|
|
4
|
+
|
|
5
|
+
export function validateEvidence(tag, evidence, options = {}) {
|
|
6
|
+
const normalizedTag = String(tag || "").trim().toLowerCase();
|
|
7
|
+
const text = String(evidence || "").trim();
|
|
8
|
+
if (!KNOWN_TAGS.has(normalizedTag)) {
|
|
9
|
+
return { ok: false, reason: `Unknown assertion tag "${tag}"; expected one of test, runtime-ui, code-grep, manual.` };
|
|
10
|
+
}
|
|
11
|
+
if (!text) return { ok: false, reason: "Evidence is required." };
|
|
12
|
+
|
|
13
|
+
if (normalizedTag === "test") return validateTestEvidence(text);
|
|
14
|
+
if (normalizedTag === "runtime-ui") return validateRuntimeUiEvidence(text, options);
|
|
15
|
+
if (normalizedTag === "code-grep") return validateCodeGrepEvidence(text);
|
|
16
|
+
if (normalizedTag === "manual") return validateManualEvidence(text);
|
|
17
|
+
return { ok: false, reason: `Unknown assertion tag "${tag}".` };
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
function validateTestEvidence(text) {
|
|
21
|
+
const hasIdentifier = /(?:\b(?:npm|pnpm|yarn|node|npx|vitest|jest|pytest|playwright|cargo|go test|bun)\b|\btest(?:s| name| file)?\b|`[^`]+`)/i.test(text);
|
|
22
|
+
const hasOutcome = /(?:\bpass(?:ed|es)?\b|\bgreen\b|\bok\b|\bexit\s*0\b|\b0\s+fail(?:ed|ures)?\b|\b\d+\/\d+\b|✓|✔)/i.test(text);
|
|
23
|
+
if (!hasIdentifier && !hasOutcome) return { ok: false, reason: "Test evidence must name the command/test identifier and its outcome." };
|
|
24
|
+
if (!hasIdentifier) return { ok: false, reason: "Test evidence must name the command or test identifier." };
|
|
25
|
+
if (!hasOutcome) return { ok: false, reason: "Test evidence must include the test outcome (pass/fail count, exit status, or equivalent)." };
|
|
26
|
+
return { ok: true };
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function validateRuntimeUiEvidence(text, options) {
|
|
30
|
+
const candidates = extractPathCandidates(text).filter((p) => /(?:^|\/)artifacts\/evidence\//.test(normalizePath(p)));
|
|
31
|
+
if (candidates.length === 0) {
|
|
32
|
+
return { ok: false, reason: "Runtime-ui evidence must reference a session artifact path under artifacts/evidence/." };
|
|
33
|
+
}
|
|
34
|
+
const fileExists = typeof options.fileExists === "function" ? options.fileExists : () => false;
|
|
35
|
+
const evidenceRoot = options.evidenceRoot ? resolve(options.evidenceRoot) : null;
|
|
36
|
+
const resolvedCandidates = candidates.map((p) => resolveSessionEvidenceCandidate(p, evidenceRoot)).filter(Boolean);
|
|
37
|
+
if (resolvedCandidates.length === 0) {
|
|
38
|
+
return { ok: false, reason: "Runtime-ui evidence must reference a session artifact evidence path, not a repo-local ./artifacts path." };
|
|
39
|
+
}
|
|
40
|
+
const existing = resolvedCandidates.find((p) => {
|
|
41
|
+
try { return fileExists(p); } catch { return false; }
|
|
42
|
+
});
|
|
43
|
+
if (!existing) {
|
|
44
|
+
return { ok: false, reason: `Runtime-ui evidence artifact does not exist: ${resolvedCandidates[0]}.` };
|
|
45
|
+
}
|
|
46
|
+
return { ok: true };
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function validateCodeGrepEvidence(text) {
|
|
50
|
+
const hasPattern = /(?:\bpattern\s*:|\bregex\s*:|\bgrep\b|`[^`]+`|\/[^/]+\/)/i.test(text);
|
|
51
|
+
const hasSample = /(?:\bmatch(?:ed|es)?\b|\bno[- ]?match(?:es)?\b|\b0\s+matches\b|\bfound\b|\bnot found\b|[\w./-]+:\d+)/i.test(text);
|
|
52
|
+
if (!hasPattern && !hasSample) return { ok: false, reason: "Code-grep evidence must include the searched pattern and a match/no-match result sample." };
|
|
53
|
+
if (!hasPattern) return { ok: false, reason: "Code-grep evidence must include the searched pattern." };
|
|
54
|
+
if (!hasSample) return { ok: false, reason: "Code-grep evidence must include a match/no-match result sample." };
|
|
55
|
+
return { ok: true };
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function validateManualEvidence(text) {
|
|
59
|
+
const hasConfirmation = /(?:\bask_user\b|\bhuman\s+confirm(?:ed|ation)\b|\buser\s+(?:confirmed|said|approved|chose|answered)\b|\bmanual\s+confirm(?:ed|ation)\b|"[^"]+")/i.test(text);
|
|
60
|
+
if (!hasConfirmation) return { ok: false, reason: "Manual evidence must reference the ask_user answer or explicit user confirmation." };
|
|
61
|
+
return { ok: true };
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function extractPathCandidates(text) {
|
|
65
|
+
const out = [];
|
|
66
|
+
const re = /(?:^|[\s(\[])(["']?)([^"'\s)\]]*(?:\.pi\/agent-sessions\/)?artifacts\/evidence\/[^"'\s)\]]+)\1/g;
|
|
67
|
+
let match;
|
|
68
|
+
while ((match = re.exec(text))) out.push(match[2].replace(/[.,;:]+$/, ""));
|
|
69
|
+
return out;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function resolveSessionEvidenceCandidate(candidate, evidenceRoot) {
|
|
73
|
+
const raw = String(candidate || "").trim();
|
|
74
|
+
const normalized = normalizePath(raw);
|
|
75
|
+
if (normalized.startsWith("./artifacts/evidence/")) return null;
|
|
76
|
+
if (evidenceRoot && normalized.startsWith("artifacts/evidence/")) {
|
|
77
|
+
return resolve(evidenceRoot, normalized.slice("artifacts/evidence/".length));
|
|
78
|
+
}
|
|
79
|
+
if (evidenceRoot && normalized.startsWith(".pi/agent-sessions/artifacts/evidence/")) {
|
|
80
|
+
return resolve(evidenceRoot, normalized.slice(".pi/agent-sessions/artifacts/evidence/".length));
|
|
81
|
+
}
|
|
82
|
+
if (isAbsolute(raw)) {
|
|
83
|
+
const abs = resolve(raw);
|
|
84
|
+
return !evidenceRoot || isWithin(evidenceRoot, abs) ? abs : null;
|
|
85
|
+
}
|
|
86
|
+
return null;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function isWithin(root, target) {
|
|
90
|
+
const rel = relative(resolve(root), resolve(target));
|
|
91
|
+
return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel));
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
function normalizePath(value) {
|
|
95
|
+
return String(value || "").replace(/\\/g, "/");
|
|
96
|
+
}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { constants, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { basename, dirname } from "node:path";
|
|
4
|
+
import { safePathWithin } from "./helpers.ts";
|
|
5
|
+
|
|
6
|
+
/** Allocate rather than clear: another live session may own any existing directory. */
|
|
7
|
+
export function createEvidenceSession(cwd: string): string {
|
|
8
|
+
const sessionId = randomUUID();
|
|
9
|
+
const dir = safePathWithin(cwd, ".pi", "agent-sessions", "sessions", sessionId);
|
|
10
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
11
|
+
writeFileSync(safePathWithin(dir, "session.json"), JSON.stringify({ sessionId, cwd, pid: process.pid, startedAt: new Date().toISOString() }, null, 2), { flag: "wx", mode: 0o600 });
|
|
12
|
+
return dir;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/** Request/result are separate create-exclusive records; even failed and resumed runs survive. */
|
|
16
|
+
export function beginExecutionEvidence(sessionDir: string, dispatchId: string, request: object, inputs: { path: string }[] = []): string {
|
|
17
|
+
const dir = safePathWithin(sessionDir, "dispatches", dispatchId);
|
|
18
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
19
|
+
const retainedInputs = inputs.map((input, i) => {
|
|
20
|
+
const retainedPath = safePathWithin(dir, `input-${i}`);
|
|
21
|
+
copyFileSync(input.path, retainedPath, constants.COPYFILE_EXCL);
|
|
22
|
+
return { path: input.path, retainedPath };
|
|
23
|
+
});
|
|
24
|
+
writeFileSync(safePathWithin(dir, "request.json"), JSON.stringify({ ...request, dispatchId, inputs: retainedInputs }, null, 2), { flag: "wx", mode: 0o600 });
|
|
25
|
+
return dir;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function finishExecutionEvidence<T extends object>(dir: string, result: T): T & { evidencePath: string } {
|
|
29
|
+
const evidencePath = safePathWithin(dir, "result.json");
|
|
30
|
+
const recorded = { ...result, evidencePath };
|
|
31
|
+
writeFileSync(evidencePath, JSON.stringify(recorded, null, 2), { flag: "wx", mode: 0o600 });
|
|
32
|
+
return recorded;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export function closeEvidenceSession(dir: string): void {
|
|
36
|
+
// Never claim or mutate the legacy shared root.
|
|
37
|
+
if (!existsSync(safePathWithin(dir, "session.json"))) return;
|
|
38
|
+
const meta = JSON.parse(readFileSync(safePathWithin(dir, "session.json"), "utf8"));
|
|
39
|
+
if (meta.sessionId !== basename(dir)) return;
|
|
40
|
+
try { writeFileSync(safePathWithin(dir, "closed.json"), JSON.stringify({ closedAt: new Date().toISOString() }), { flag: "wx", mode: 0o600 }); }
|
|
41
|
+
catch (error: any) { if (error.code !== "EEXIST") throw error; }
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function processAlive(pid: number): boolean {
|
|
45
|
+
if (!Number.isSafeInteger(pid) || pid <= 0) return true;
|
|
46
|
+
try { process.kill(pid, 0); return true; } catch (error: any) { return error.code !== "ESRCH"; }
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Existing keep limit applies only to safely closed new namespaces. Unknown/live data is protected. */
|
|
50
|
+
export function pruneEvidenceSessions(sessionDir: string, keep: number | null, alive = processAlive): void {
|
|
51
|
+
if (keep == null) return;
|
|
52
|
+
const root = dirname(sessionDir);
|
|
53
|
+
if (basename(root) !== "sessions") return;
|
|
54
|
+
const eligible: { dir: string; closedAt: string }[] = [];
|
|
55
|
+
for (const entry of readdirSync(root, { withFileTypes: true })) {
|
|
56
|
+
if (!entry.isDirectory() || !/^[a-f0-9-]{36}$/.test(entry.name)) continue;
|
|
57
|
+
const dir = safePathWithin(root, entry.name);
|
|
58
|
+
try {
|
|
59
|
+
const meta = JSON.parse(readFileSync(safePathWithin(dir, "session.json"), "utf8"));
|
|
60
|
+
const closed = JSON.parse(readFileSync(safePathWithin(dir, "closed.json"), "utf8"));
|
|
61
|
+
if (meta.sessionId !== entry.name || alive(meta.pid) || typeof closed.closedAt !== "string") continue;
|
|
62
|
+
const dispatches = safePathWithin(dir, "dispatches");
|
|
63
|
+
if (existsSync(dispatches) && readdirSync(dispatches).some(id => {
|
|
64
|
+
const result = JSON.parse(readFileSync(safePathWithin(dispatches, id, "result.json"), "utf8"));
|
|
65
|
+
return result.pending === true;
|
|
66
|
+
})) continue;
|
|
67
|
+
eligible.push({ dir, closedAt: closed.closedAt });
|
|
68
|
+
} catch { /* Missing, malformed or unfinished evidence is never a pruning candidate. */ }
|
|
69
|
+
}
|
|
70
|
+
eligible.sort((a, b) => a.closedAt.localeCompare(b.closedAt) || a.dir.localeCompare(b.dir));
|
|
71
|
+
for (const entry of eligible.slice(0, Math.max(0, eligible.length - keep))) rmSync(entry.dir, { recursive: true, force: true });
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export function retainDeliverable(sessionDir: string, dispatchId: string, index: number, bytes: Buffer): string {
|
|
75
|
+
const dir = safePathWithin(sessionDir, "dispatches", dispatchId, "deliverables");
|
|
76
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
77
|
+
const path = safePathWithin(dir, String(index));
|
|
78
|
+
writeFileSync(path, bytes, { flag: "wx", mode: 0o600 });
|
|
79
|
+
return path;
|
|
80
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
// External-blocker circuit breaker — the pure policy core behind "stop when the
|
|
2
|
+
// thing you need is not yours to get".
|
|
3
|
+
//
|
|
4
|
+
// The observed failure: a runtime-telemetry assertion could not be proven
|
|
5
|
+
// because the correlation destination did not exist outside the fleet. Nothing
|
|
6
|
+
// stopped the line, so the run kept substituting internal work for the missing
|
|
7
|
+
// external fact — building manifests, fixtures, and diagnostic packets — for
|
|
8
|
+
// hours, and the assertion ended UNPROVEN anyway. An external blocker is not a
|
|
9
|
+
// harder version of the task; it is the end of what delegation can buy.
|
|
10
|
+
//
|
|
11
|
+
// Protocol: a specialist that cannot proceed without something outside the
|
|
12
|
+
// fleet's reach emits `EXTERNAL_BLOCKED: <what is missing and who owns it>`.
|
|
13
|
+
// The hub records it and refuses the NEXT dispatch/research until the human has
|
|
14
|
+
// been addressed — the escalation is the deliverable at that point.
|
|
15
|
+
|
|
16
|
+
/** Pull `EXTERNAL_BLOCKED: …` markers out of a specialist's output. */
|
|
17
|
+
export function extractExternalBlockers(output) {
|
|
18
|
+
const blockers = [];
|
|
19
|
+
for (const rawLine of String(output || "").split("\n")) {
|
|
20
|
+
const line = rawLine.trim();
|
|
21
|
+
const match = line.match(/^EXTERNAL_BLOCKED\s*:\s*(.+)$/i);
|
|
22
|
+
if (match) {
|
|
23
|
+
const what = match[1].trim();
|
|
24
|
+
if (what && !blockers.includes(what)) blockers.push(what);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return blockers;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Gate the next dispatcher call while an external blocker is unacknowledged.
|
|
32
|
+
*
|
|
33
|
+
* state: {
|
|
34
|
+
* blockers: [{ agent, what }], // recorded, newest last
|
|
35
|
+
* acknowledged: boolean, // human addressed (ask_user called, or new user turn)
|
|
36
|
+
* askUserAvailable: boolean, // whether this session has the ask_user tool
|
|
37
|
+
* refusedOnce: boolean, // a refusal was already issued for this blocker set
|
|
38
|
+
* }
|
|
39
|
+
*
|
|
40
|
+
* Returns null when allowed, else { reason, message }. Without ask_user the gate
|
|
41
|
+
* fires exactly once: a session that cannot reach the human must still be able
|
|
42
|
+
* to finish and report, and an unbreakable gate there is a deadlock, not a stop.
|
|
43
|
+
*/
|
|
44
|
+
export function checkExternalBlockerGate(state) {
|
|
45
|
+
const blockers = state?.blockers || [];
|
|
46
|
+
if (blockers.length === 0) return null;
|
|
47
|
+
if (state?.acknowledged) return null;
|
|
48
|
+
if (!state?.askUserAvailable && state?.refusedOnce) return null;
|
|
49
|
+
|
|
50
|
+
const list = blockers.map((b) => ` - ${b.what}${b.agent ? ` (reported by ${b.agent})` : ""}`).join("\n");
|
|
51
|
+
const escalation = state?.askUserAvailable
|
|
52
|
+
? "Call `ask_user` with the packet below. The gate opens as soon as you do."
|
|
53
|
+
: "`ask_user` is unavailable in this session: put the packet below in your reply to the human and stop " +
|
|
54
|
+
"this line of work. (This gate fires once; further dispatches are allowed so you can finish and report.)";
|
|
55
|
+
|
|
56
|
+
return {
|
|
57
|
+
reason: "external_blocked",
|
|
58
|
+
message: `⛔ EXTERNAL BLOCKER — dispatch refused and NOT counted against any budget.\n\n` +
|
|
59
|
+
`A specialist reported that it needs something outside the fleet's reach:\n${list}\n\n` +
|
|
60
|
+
`Do NOT route around this. Substituting internal work for a missing external fact — building ` +
|
|
61
|
+
`scripts, manifests, fixtures, or diagnostic packets to approximate it — is how a blocked ` +
|
|
62
|
+
`assertion turns into hours of work that still ends UNPROVEN.\n\n` +
|
|
63
|
+
`${escalation}\n\n` +
|
|
64
|
+
`Owner escalation packet (one message, no dispatches):\n` +
|
|
65
|
+
` 1. WHAT is missing and who owns it.\n` +
|
|
66
|
+
` 2. WHICH assertions/tasks are blocked on it, by id.\n` +
|
|
67
|
+
` 3. WHAT is already proven and where the evidence lives (artifact paths).\n` +
|
|
68
|
+
` 4. The concrete OPTIONS for the human: provide the missing access, waive the assertion as ` +
|
|
69
|
+
`UNPROVEN (a waiver is not a PASS), or drop the item from scope.\n` +
|
|
70
|
+
` 5. What you will do while it is blocked — normally: the unrelated remaining work, or nothing.`,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** The protocol paragraph injected into every specialist's system prompt. */
|
|
75
|
+
export function externalBlockedProtocol() {
|
|
76
|
+
return [
|
|
77
|
+
"- External blocker: if you cannot proceed because something OUTSIDE this repo and outside your",
|
|
78
|
+
" tools is missing — an account, a permission, a deployment credential, a telemetry/monitoring",
|
|
79
|
+
" destination, a third-party service, a human-only console action — do NOT build a substitute for",
|
|
80
|
+
" it and do NOT keep trying alternatives. Emit a line of the form",
|
|
81
|
+
" `EXTERNAL_BLOCKED: <what is missing, who owns it, and what it blocks>`, report what you DID",
|
|
82
|
+
" prove, and stop. The dispatcher escalates it to the human; approximating the missing fact with",
|
|
83
|
+
" extra scripts, fixtures, or manifests is the failure this protocol exists to prevent.",
|
|
84
|
+
].join("\n");
|
|
85
|
+
}
|