@chankov/agent-fleet 2.0.11 → 2.0.12
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/lib/flow-maintenance.ts +1 -1
- package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +3 -3
- package/.pi/harnesses/agent-hub/README.md +63 -6
- package/.pi/harnesses/agent-hub/budget-recovery.ts +24 -1
- package/.pi/harnesses/agent-hub/capability-packs.ts +2 -1
- package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
- package/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
- package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
- package/.pi/harnesses/agent-hub/config/overrides.ts +8 -1
- package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +2 -0
- package/.pi/harnesses/agent-hub/delegate.ts +3 -1
- package/.pi/harnesses/agent-hub/dispatch-coms.ts +20 -5
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +9 -3
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +56 -51
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +8 -2
- package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
- package/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.pi/harnesses/agent-hub/drift-watchdog.js +140 -9
- package/.pi/harnesses/agent-hub/index.ts +81 -43
- package/.pi/harnesses/agent-hub/input/completions.ts +8 -2
- package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +4 -2
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
- package/.pi/harnesses/agent-hub/no-progress.ts +169 -16
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -2
- package/.pi/harnesses/agent-hub/prompts/context.ts +1 -1
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -2
- package/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
- package/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.pi/harnesses/agent-hub/recovery-contract.ts +3 -1
- package/.pi/harnesses/agent-hub/research/controls.ts +1 -1
- package/.pi/harnesses/agent-hub/research/runtime.ts +1 -1
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +1 -1
- package/.pi/harnesses/agent-hub/return-extract.js +3 -1
- package/.pi/harnesses/agent-hub/review-findings.js +2 -0
- package/.pi/harnesses/agent-hub/run-budget.js +6 -1
- package/.pi/harnesses/agent-hub/run-namespace.js +6 -0
- package/.pi/harnesses/agent-hub/session-audit.ts +68 -3
- package/.pi/harnesses/agent-hub/spawn.ts +76 -8
- package/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
- package/.pi/harnesses/agent-hub/system1-report.ts +84 -0
- package/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
- package/.pi/harnesses/agent-hub/timeline.ts +23 -5
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +14 -1
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
- package/.pi/harnesses/agent-hub/types.ts +1 -0
- package/.pi/harnesses/agent-hub/ui/activity-dots.ts +12 -3
- package/.pi/harnesses/agent-hub/ui/context-budget.ts +4 -3
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +11 -18
- package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +3 -1
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +2 -2
- package/.pi/harnesses/agent-hub/ui/fleet-source.ts +14 -1
- package/.pi/harnesses/agent-hub/ui/grid.ts +6 -6
- package/.pi/harnesses/agent-hub/ui/pool.ts +1 -1
- package/.pi/harnesses/agent-hub/ui/zoom.ts +5 -3
- package/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-core.ts +1 -1
- package/.pi/harnesses/lib/context-budget.ts +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
- package/.pi/harnesses/lib/fleet-detail-view.ts +35 -4
- package/.pi/harnesses/lib/fleet-read-model.ts +206 -14
- package/.pi/harnesses/lib/fleet-strip-view.ts +17 -5
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/spawned-peers.js +1 -0
- package/.pi/harnesses/lib/system1/config.js +61 -0
- package/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.pi/harnesses/lib/system1/demo.ts +106 -0
- package/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.12/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/flow.ts +155 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.12/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.12/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.12/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.12/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.12/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.12/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.12/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.12/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.12/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.12/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.12/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.12/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.12/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.12/.pi/extensions/package.json +9 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/README.md +1309 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context.ts +45 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/delegate.ts +465 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +202 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-types.ts +251 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/index.ts +2301 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/no-progress.ts +359 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/run-budget.js +542 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/session-audit.ts +226 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/spawn.ts +526 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-report.ts +84 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/context.ts +142 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/detail-panel.ts +171 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-source.ts +170 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode.ts +173 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.12/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.12/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.12/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.12/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.12/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.12/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.12/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.12/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.12/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-view.ts +136 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-detail-view.ts +278 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-read-model.ts +405 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-view.ts +144 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.12/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.12/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.12/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/config.js +61 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/demo.ts +106 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.12/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.12/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.12/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.12/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.12/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.12/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.12/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.12/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.12/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.12/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.12/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.12/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.12/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.12/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.12/.version +1 -0
- package/.versions/2.0.12/agents/architect.md +25 -0
- package/.versions/2.0.12/agents/bowser.md +28 -0
- package/.versions/2.0.12/agents/builder.md +56 -0
- package/.versions/2.0.12/agents/code-reviewer.md +210 -0
- package/.versions/2.0.12/agents/deep-researcher.md +33 -0
- package/.versions/2.0.12/agents/documenter.md +23 -0
- package/.versions/2.0.12/agents/orchestrator.md +23 -0
- package/.versions/2.0.12/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.12/agents/planner.md +106 -0
- package/.versions/2.0.12/agents/releaser.md +25 -0
- package/.versions/2.0.12/agents/researcher.md +31 -0
- package/.versions/2.0.12/agents/security-auditor.md +168 -0
- package/.versions/2.0.12/agents/test-engineer.md +154 -0
- package/.versions/2.0.12/agents/web-debugger.md +44 -0
- package/.versions/2.0.12/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.12/bin/catalog/harness-runtime-closure.json +61 -0
- package/.versions/2.0.12/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.12/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.12/docs/ARCHITECTURE.md +705 -0
- package/.versions/2.0.12/docs/agent-fleet-setup.md +682 -0
- package/.versions/2.0.12/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.12/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.12/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.12/docs/getting-started.md +126 -0
- package/.versions/2.0.12/docs/npm-install.md +468 -0
- package/.versions/2.0.12/docs/pi-extensions.md +449 -0
- package/.versions/2.0.12/docs/pi-setup.md +92 -0
- package/.versions/2.0.12/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.12/install-manifest.json +3053 -0
- package/.versions/2.0.12/justfile +247 -0
- package/.versions/2.0.12/manifest-meta.json +995 -0
- package/.versions/2.0.12/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.12/references/communication-contract.md +26 -0
- package/.versions/2.0.12/references/definition-of-done.md +67 -0
- package/.versions/2.0.12/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.12/references/observability-checklist.md +92 -0
- package/.versions/2.0.12/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.12/references/performance-checklist.md +236 -0
- package/.versions/2.0.12/references/prompting-patterns.md +380 -0
- package/.versions/2.0.12/references/security-checklist.md +245 -0
- package/.versions/2.0.12/references/testing-patterns.md +235 -0
- package/.versions/2.0.12/references/workflow-authoring.md +304 -0
- package/.versions/2.0.12/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.12/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.12/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.12/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.12/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.12/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.12/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.12/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.12/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.12/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.12/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.12/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.12/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.12/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.12/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.12/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.12/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.12/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.12/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.12/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.12/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.12/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.12/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.12/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.12/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.12/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.12/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.12/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +10 -0
- package/bin/cli.js +3 -3
- package/bin/lib/doctor.js +63 -1
- package/docs/ARCHITECTURE.md +113 -3
- package/docs/agent-fleet-setup.md +96 -0
- package/docs/npm-install.md +87 -2
- package/install-manifest.json +34 -1
- package/manifest-meta.json +25 -0
- package/package.json +6 -2
|
@@ -1,10 +1,15 @@
|
|
|
1
1
|
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import { isDeepStrictEqual } from 'node:util';
|
|
2
3
|
import { readFileSync } from "node:fs";
|
|
3
|
-
import { posix, resolve } from "node:path";
|
|
4
|
+
import { posix, resolve, relative } from "node:path";
|
|
4
5
|
import { worktreeRevision } from "./scope-gate.js";
|
|
5
6
|
import { checkTaskBudget, checkTurnBudget } from "./run-budget.js";
|
|
6
7
|
import { recoveryCategoryFromDetails, recoveryDecision, type RecoveryCategory } from "./recovery-contract.ts";
|
|
8
|
+
import { createRecoverState, type RecoverEvent } from './recover-state.ts';
|
|
9
|
+
import { readBackDeliverables } from './acceptance.ts';
|
|
7
10
|
import type { DispatchExecutorDeps } from "./tools/dispatch-execution.ts";
|
|
11
|
+
import { reconcileTechnical, type TechnicalEvidence } from './reconcile.ts';
|
|
12
|
+
import { renderRecoverCommands, renderNextInvocation } from './recover-policy.ts';
|
|
8
13
|
import type { ToolExecutor, DispatchAgentParams, SpawnResearchParams } from "./tools/context.ts";
|
|
9
14
|
|
|
10
15
|
interface Failure {
|
|
@@ -16,51 +21,105 @@ interface Failure {
|
|
|
16
21
|
catalogVersion?: string;
|
|
17
22
|
toolStateChanged?: boolean;
|
|
18
23
|
}
|
|
19
|
-
interface Ticket { allowed: boolean; key: string; executorKey: string; scope: string[]; generation: object; id: object; failure?: Failure; refusal?: "busy" | "recovery"; }
|
|
24
|
+
interface Ticket { allowed: boolean; key: string; executorKey: string; scope: string[]; generation: object; id: object; operationId?: string; attemptId?: string; failure?: Failure; refusal?: "busy" | "recovery"; }
|
|
20
25
|
interface RecordedFailure { fingerprint: string; failure: Failure; authorized: boolean; }
|
|
21
26
|
|
|
22
|
-
export
|
|
27
|
+
export const RECOVER_ENTRY = 'agent-hub-recover-event';
|
|
28
|
+
/** A snapshot is a checkpoint of the preceding projection, never an alternative history. */
|
|
29
|
+
export function projectRecoveryRows(entries: readonly unknown[]): any[] {
|
|
30
|
+
const available = entries.filter((row: any) => (row?.customType ?? row?.type) === RECOVER_ENTRY).map((row: any) => row.data);
|
|
31
|
+
let rows: any[] = [];
|
|
32
|
+
for (const [index, row] of available.entries()) {
|
|
33
|
+
if (row?.kind === 'snapshot') {
|
|
34
|
+
if (!Array.isArray(row.rows) || (index > 0 && !isDeepStrictEqual(row.rows, rows))) throw new Error('Invalid recovery snapshot');
|
|
35
|
+
rows = row.rows;
|
|
36
|
+
} else {
|
|
37
|
+
if (!row || !['ledger', 'guard'].includes(row.kind)) throw new Error('Invalid recovery history');
|
|
38
|
+
rows = [...rows, row];
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
if (rows.some(row => !row || !['ledger', 'guard'].includes(row.kind))) throw new Error('Invalid recovery history');
|
|
42
|
+
return rows;
|
|
43
|
+
}
|
|
44
|
+
export type GuardHistory = { type: 'failure' | 'authorize' | 'evidence' | 'task' | 'consume' | 'invocation'; key?: string; fingerprint?: string; failure?: Failure; executorKey?: string; scope?: string[]; dispatchId?: string; taskId?: string; evidence?: DispatchEvidence; operationId?: string; invocation?: { tool: 'dispatch_agent' | 'spawn_research'; params: DispatchAgentParams | SpawnResearchParams } };
|
|
45
|
+
export interface DispatchEvidence { dispatchId: string; taskId: string; executor: string; revision: string; changedScope: string[]; readback: TechnicalEvidence['readback']; concurrentWriters: boolean; effectsRef?: string; completed: boolean; blockingFindings: number; coveredScope: string[]; edited: boolean; evidenceRef: string; openRequirements: string[] };
|
|
46
|
+
function validInvocation(value: NonNullable<GuardHistory['invocation']>): boolean {
|
|
47
|
+
if (!value || !['dispatch_agent', 'spawn_research'].includes(value.tool) || !value.params || typeof value.params !== 'object' || Array.isArray(value.params)) return false;
|
|
48
|
+
const params = value.params as unknown as Record<string, unknown>;
|
|
49
|
+
const keys = value.tool === 'dispatch_agent' ? ['agent','task','artifacts','scope','scope_mode','deliverables','watchdog','review_reason','backend'] : ['task','persona','model','artifacts','read_scope','goal','expected_result'];
|
|
50
|
+
if (Object.keys(params).some(key => !keys.includes(key)) || typeof params.task !== 'string' || !params.task.trim()) return false;
|
|
51
|
+
if (value.tool === 'dispatch_agent' && (typeof params.agent !== 'string' || !params.agent.trim())) return false;
|
|
52
|
+
return Object.entries(params).every(([key, item]) => item === undefined || (['artifacts','scope','deliverables','read_scope'].includes(key) ? Array.isArray(item) && item.every(s => typeof s === 'string') : key === 'watchdog' ? typeof item === 'boolean' : typeof item === 'string'));
|
|
53
|
+
}
|
|
54
|
+
export function createNoProgressGuard(persist?: (type: string, data: unknown) => void) {
|
|
55
|
+
let recovery = createRecoverState([], event => persist?.(RECOVER_ENTRY, { kind: 'ledger', event }));
|
|
23
56
|
let generation = {};
|
|
24
|
-
let taskId = randomUUID();
|
|
57
|
+
let taskId: string = randomUUID();
|
|
25
58
|
const pending = new Map<string, object>();
|
|
26
59
|
const pendingExecutors = new Map<string, object>();
|
|
60
|
+
const pendingLineages = new Map<string, { operationId: string; attemptId: string }>();
|
|
27
61
|
const failures = new Map<string, RecordedFailure>();
|
|
62
|
+
const dispatchEvidence = new Map<string, DispatchEvidence>();
|
|
63
|
+
const invocations = new Map<string, NonNullable<GuardHistory['invocation']>>();
|
|
28
64
|
const cancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
|
|
29
65
|
return {
|
|
30
66
|
taskToken: () => generation,
|
|
31
67
|
taskId: () => taskId,
|
|
32
|
-
begin(key: string, fingerprint: string, executorKey = key, scope: string[] = []): Ticket {
|
|
68
|
+
begin(key: string, fingerprint: string, executorKey = key, scope: string[] = [], currentRevision?: string): Ticket {
|
|
33
69
|
const cancelled = [...cancellations.values()].filter(item => item.executorKey === executorKey);
|
|
34
70
|
const old = cancelled.find(item => !item.entry.authorized)?.entry ?? cancelled[0]?.entry ?? failures.get(key), id = {};
|
|
35
71
|
if (pendingExecutors.has(executorKey)) return { allowed: false, key, executorKey, scope, generation, id, refusal: "busy" };
|
|
72
|
+
// An interrupted append can leave a ledger failure without its guard snapshot.
|
|
73
|
+
// Never treat that as a fresh contract or an unlocked replay.
|
|
74
|
+
if (!old && recovery.findContract(key)?.attempts.at(-1)?.category) {
|
|
75
|
+
const last = recovery.findContract(key)!.attempts.at(-1)!;
|
|
76
|
+
return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery', failure: { category: last.category!, dispatchId: last.dispatchId, reason: 'guard_history_missing' } };
|
|
77
|
+
}
|
|
36
78
|
if (old) {
|
|
37
79
|
const category = old.failure.category ?? "indeterminate";
|
|
38
80
|
const changed = old.fingerprint !== fingerprint || (category === "unknown_tool" && old.failure.toolStateChanged === true);
|
|
39
81
|
const decision = recoveryDecision(category, {
|
|
40
82
|
explicitInvocation: true,
|
|
41
|
-
relevantConditionsChanged: changed || category === "busy",
|
|
42
|
-
freshOneUseAuthorization: old.authorized,
|
|
83
|
+
relevantConditionsChanged: changed || category === "busy" || (category === 'verification_failed' && !!currentRevision && recovery.findContract(key)?.technical?.status === 'cleared' && recovery.findContract(key)?.technical?.revision === currentRevision),
|
|
84
|
+
freshOneUseAuthorization: old.authorized || (category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId),
|
|
85
|
+
processSettled: category === 'indeterminate' && !!recovery.findContract(key)?.attempts.at(-1)?.settled,
|
|
86
|
+
indeterminateGrantUsed: category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId,
|
|
43
87
|
effectsEstablished: old.failure.effectsEstablished === true,
|
|
44
88
|
toolStateChanged: old.failure.toolStateChanged === true,
|
|
45
89
|
executorIdle: !pendingExecutors.has(executorKey),
|
|
46
90
|
});
|
|
47
91
|
if (!decision.allowed) return { allowed: false, key, executorKey, scope, generation, id, failure: { ...old.failure, category }, refusal: "recovery" };
|
|
48
92
|
}
|
|
49
|
-
|
|
50
|
-
|
|
93
|
+
const lineage = recovery.start(recovery.findContract(key)?.taskId ?? taskId, key, executorKey, randomUUID());
|
|
94
|
+
if (!lineage) return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery' };
|
|
95
|
+
for (const item of cancelled) {
|
|
96
|
+
const failedKey = [...failures].find(([, entry]) => entry === item.entry)?.[0];
|
|
97
|
+
if (failedKey) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key: failedKey, dispatchId: item.entry.failure.dispatchId } satisfies GuardHistory });
|
|
98
|
+
cancellations.delete(item.entry.failure.dispatchId);
|
|
99
|
+
if (failedKey) failures.delete(failedKey);
|
|
100
|
+
}
|
|
101
|
+
if (failures.has(key)) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key, dispatchId: failures.get(key)!.failure.dispatchId } satisfies GuardHistory });
|
|
102
|
+
failures.delete(key);
|
|
51
103
|
pending.set(key, id);
|
|
52
104
|
pendingExecutors.set(executorKey, id);
|
|
53
|
-
|
|
105
|
+
pendingLineages.set(executorKey, lineage);
|
|
106
|
+
return { allowed: true, key, executorKey, scope, generation, id, ...lineage };
|
|
54
107
|
},
|
|
55
108
|
finish(ticket: Ticket, fingerprint: string, failure?: Failure) {
|
|
56
109
|
if (!ticket.allowed || ticket.generation !== generation || pending.get(ticket.key) !== ticket.id || pendingExecutors.get(ticket.executorKey) !== ticket.id) return;
|
|
57
110
|
pending.delete(ticket.key);
|
|
58
111
|
pendingExecutors.delete(ticket.executorKey);
|
|
112
|
+
pendingLineages.delete(ticket.executorKey);
|
|
59
113
|
if (failure) {
|
|
114
|
+
if (ticket.operationId && ticket.attemptId) {
|
|
115
|
+
recovery.bindDispatch(ticket.operationId, ticket.attemptId, failure.dispatchId);
|
|
116
|
+
recovery.fail(ticket.operationId, ticket.attemptId, failure.category);
|
|
117
|
+
}
|
|
60
118
|
const entry = { fingerprint, failure, authorized: false };
|
|
61
119
|
failures.set(ticket.key, entry);
|
|
62
120
|
if (failure.category === "operator_cancelled") cancellations.set(failure.dispatchId, { executorKey: ticket.executorKey, scope: ticket.scope, entry });
|
|
63
|
-
|
|
121
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'failure', key: ticket.key, fingerprint, failure, executorKey: ticket.executorKey, scope: ticket.scope } satisfies GuardHistory });
|
|
122
|
+
} else if (ticket.operationId && ticket.attemptId) recovery.complete(ticket.operationId, ticket.attemptId);
|
|
64
123
|
},
|
|
65
124
|
/** Internal runtime port, not model input. Caller must retain an effects inspection artifact;
|
|
66
125
|
* unchanged conditions still cannot retry or replay observed effects. */
|
|
@@ -85,16 +144,102 @@ export function createNoProgressGuard() {
|
|
|
85
144
|
}
|
|
86
145
|
return established;
|
|
87
146
|
},
|
|
147
|
+
prepareSessionRestore() { /* Keep the previous guard installed until a validated restore can replace it. */ },
|
|
148
|
+
compact(entries: readonly unknown[]) {
|
|
149
|
+
const rows = projectRecoveryRows(entries);
|
|
150
|
+
persist?.(RECOVER_ENTRY, { kind: 'snapshot', rows: structuredClone(rows) });
|
|
151
|
+
},
|
|
152
|
+
restore(entries: readonly unknown[]) {
|
|
153
|
+
const rows = projectRecoveryRows(entries);
|
|
154
|
+
const ledger = rows.filter(row => row?.kind === 'ledger').map(row => row.event as RecoverEvent);
|
|
155
|
+
const validated = createRecoverState(ledger, event => persist?.(RECOVER_ENTRY, { kind: 'ledger', event }));
|
|
156
|
+
const nextFailures = new Map<string, RecordedFailure>();
|
|
157
|
+
const nextCancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
|
|
158
|
+
const nextEvidence = new Map<string, DispatchEvidence>();
|
|
159
|
+
const nextInvocations = new Map<string, NonNullable<GuardHistory['invocation']>>();
|
|
160
|
+
let nextTaskId = taskId;
|
|
161
|
+
for (const row of rows.filter(row => row?.kind === 'guard')) {
|
|
162
|
+
const event = row.event as GuardHistory;
|
|
163
|
+
if (event.type === 'failure' && event.failure && event.key && event.fingerprint && event.executorKey && validated.byDispatch(event.failure.dispatchId)?.contract === event.key && validated.byDispatch(event.failure.dispatchId)?.executor === event.executorKey && validated.byDispatch(event.failure.dispatchId)?.attempts.some(a => a.dispatchId === event.failure!.dispatchId && a.category === event.failure!.category)) {
|
|
164
|
+
const entry = { fingerprint: event.fingerprint, failure: event.failure, authorized: false };
|
|
165
|
+
nextFailures.set(event.key, entry);
|
|
166
|
+
if (event.failure.category === 'operator_cancelled') nextCancellations.set(event.failure.dispatchId, { executorKey: event.executorKey, scope: event.scope ?? [], entry });
|
|
167
|
+
} else if (event.type === 'consume' && event.key && event.dispatchId && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId) {
|
|
168
|
+
nextFailures.delete(event.key);
|
|
169
|
+
for (const [id, item] of nextCancellations) if (item.entry.failure.dispatchId === event.dispatchId) nextCancellations.delete(id);
|
|
170
|
+
} else if (event.type === 'authorize' && event.dispatchId && event.key && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId) {
|
|
171
|
+
nextFailures.get(event.key)!.authorized = true;
|
|
172
|
+
} else if (event.type === 'task' && event.taskId) {
|
|
173
|
+
nextTaskId = event.taskId;
|
|
174
|
+
} else if (event.type === 'invocation' && event.operationId && event.key && event.invocation && validated.inspect(event.operationId)?.contract === event.key && !nextInvocations.has(event.operationId) && validInvocation(event.invocation)) {
|
|
175
|
+
nextInvocations.set(event.operationId, structuredClone(event.invocation));
|
|
176
|
+
} else if (event.type === 'evidence' && event.evidence && event.evidence.dispatchId && event.evidence.taskId) {
|
|
177
|
+
nextEvidence.set(event.evidence.dispatchId, event.evidence);
|
|
178
|
+
} else throw new Error('Invalid recovery guard history');
|
|
179
|
+
}
|
|
180
|
+
if (!rows.some(row => row?.kind === 'guard' && row.event?.type === 'task')) {
|
|
181
|
+
const latest = [...ledger].reverse().find(event => event.type === 'start');
|
|
182
|
+
if (latest?.type === 'start') nextTaskId = latest.taskId;
|
|
183
|
+
}
|
|
184
|
+
recovery = validated; taskId = nextTaskId;
|
|
185
|
+
failures.clear(); for (const [key, value] of nextFailures) failures.set(key, value);
|
|
186
|
+
cancellations.clear(); for (const [key, value] of nextCancellations) cancellations.set(key, value);
|
|
187
|
+
dispatchEvidence.clear(); for (const [key, value] of nextEvidence) dispatchEvidence.set(key, value);
|
|
188
|
+
invocations.clear(); for (const [key, value] of nextInvocations) invocations.set(key, value);
|
|
189
|
+
generation = {}; pending.clear(); pendingExecutors.clear(); pendingLineages.clear();
|
|
190
|
+
},
|
|
191
|
+
reviewCoverage(taskId: string) { return [...dispatchEvidence.values()].filter(row => row.taskId === taskId && !row.completed).flatMap(row => row.changedScope); },
|
|
192
|
+
recordDispatchEvidence(evidence: DispatchEvidence) {
|
|
193
|
+
if (!evidence.dispatchId || !evidence.taskId || dispatchEvidence.has(evidence.dispatchId)) return false;
|
|
194
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'evidence', evidence } satisfies GuardHistory });
|
|
195
|
+
dispatchEvidence.set(evidence.dispatchId, structuredClone(evidence)); return true;
|
|
196
|
+
},
|
|
197
|
+
reconcile(operationId: string, attemptId: string, currentRevision: string, roots: { cwd: string; sessionDir: string }) {
|
|
198
|
+
const op = recovery.inspect(operationId), attempt = op?.attempts.find(a => a.attemptId === attemptId);
|
|
199
|
+
const original = attempt && dispatchEvidence.get(attempt.dispatchId);
|
|
200
|
+
if (!op || !attempt || !original || original.taskId !== op.taskId || original.executor !== op.executor) return { cleared: false as const, reason: 'missing_original_runtime_evidence' };
|
|
201
|
+
if (currentRevision === 'unavailable' || worktreeRevision(roots.cwd, []) !== currentRevision) return { cleared: false as const, reason: 'stale_or_unavailable_revision' };
|
|
202
|
+
const currentReadback = readBackDeliverables({ files: original.readback.map(row => ({ input: row.path, path: row.path, before: row.sha256 ?? null })), scopeRoots: [] }, roots);
|
|
203
|
+
if (original.readback.some((row, i) => row.status !== 'read' || !row.sha256 || currentReadback[i]?.status !== 'read' || currentReadback[i]?.sha256 !== row.sha256)) return { cleared: false as const, reason: 'readback_changed_or_unsafe' };
|
|
204
|
+
const verifiedReadback = original.readback.map((row, i) => ({ ...row, path: relative(roots.cwd, row.path).replace(/\\/g, '/'), sha256: currentReadback[i]!.sha256 }));
|
|
205
|
+
const reviewer = [...dispatchEvidence.values()].find(row => row.taskId === op.taskId && row.executor !== op.executor && row.completed && row.revision === currentRevision && !row.edited && row.blockingFindings === 0 && row.changedScope.length === 0 && original.changedScope.every(path => row.coveredScope.includes(path)));
|
|
206
|
+
return reconcileTechnical(recovery, { taskId: op.taskId, operationId, attemptId, currentRevision, observedRevision: original.revision, originalExecutor: original.executor, changedScope: original.changedScope, readback: verifiedReadback, concurrentWriters: original.concurrentWriters, effectsRef: original.effectsRef, reviewer: reviewer && { taskId: reviewer.taskId, executor: reviewer.executor, revision: reviewer.revision, completed: reviewer.completed, blockingFindings: reviewer.blockingFindings, coveredScope: reviewer.coveredScope, edited: reviewer.edited, evidenceRef: reviewer.evidenceRef }, openRequirements: original.openRequirements });
|
|
207
|
+
},
|
|
208
|
+
inspect(operationId: string) { return recovery.inspect(operationId); },
|
|
209
|
+
invocation(operationId: string) { const item = invocations.get(operationId); return item ? structuredClone(item) : null; },
|
|
210
|
+
recordInvocation(operationId: string, key: string, invocation: NonNullable<GuardHistory['invocation']>) {
|
|
211
|
+
if (recovery.inspect(operationId)?.contract !== key || invocations.has(operationId) || !validInvocation(invocation)) return false;
|
|
212
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'invocation', operationId, key, invocation: structuredClone(invocation) } satisfies GuardHistory });
|
|
213
|
+
invocations.set(operationId, structuredClone(invocation)); return true;
|
|
214
|
+
},
|
|
215
|
+
byDispatch(dispatchId: string) { return recovery.byDispatch(dispatchId); },
|
|
216
|
+
assess(operationId: string, attemptId: string, revision: string, status: 'open' | 'cleared', evidence: string) { return recovery.assess(operationId, attemptId, revision, status, evidence); },
|
|
217
|
+
abandon(operationId: string, attemptId: string, nonce: string) { return recovery.abandon(operationId, attemptId, nonce); },
|
|
218
|
+
isIdle(executor: string) { return !pendingExecutors.has(executor); },
|
|
219
|
+
/** Only independent runtime process settlement evidence may call this port. */
|
|
220
|
+
settle(operationId: string, attemptId: string, evidence: string) { return recovery.settle(operationId, attemptId, evidence); },
|
|
221
|
+
authorizeIndeterminate(operationId: string, attemptId: string, nonce: string): boolean {
|
|
222
|
+
const op = recovery.inspect(operationId);
|
|
223
|
+
if (!op || op.attempts.at(-1)?.attemptId !== attemptId || !op.attempts.at(-1)?.settled || pendingExecutors.has(op.executor) || op.abandoned || op.indeterminateGrantUsed) return false;
|
|
224
|
+
return recovery.grant(operationId, attemptId, nonce);
|
|
225
|
+
},
|
|
226
|
+
canAuthorize(operationId: string, attemptId: string) {
|
|
227
|
+
const op = recovery.inspect(operationId), attempt = op?.attempts.at(-1);
|
|
228
|
+
return !!op && op.taskId === taskId && !op.abandoned && attempt?.attemptId === attemptId && !!attempt.category && !pendingExecutors.has(op.executor) && (attempt.category === 'indeterminate' ? !!attempt.settled && !op.indeterminateGrantUsed : attempt.category === 'operator_cancelled' && !!cancellations.get(attempt.dispatchId) && !cancellations.get(attempt.dispatchId)!.entry.authorized);
|
|
229
|
+
},
|
|
88
230
|
authorize(dispatchId: string): boolean {
|
|
89
231
|
for (const { entry } of cancellations.values()) {
|
|
90
232
|
if (entry.failure.dispatchId !== dispatchId || entry.authorized || entry.failure.category !== "operator_cancelled") continue;
|
|
233
|
+
const key = [...failures].find(([, value]) => value === entry)?.[0];
|
|
234
|
+
if (!key) return false;
|
|
235
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'authorize', key, dispatchId } satisfies GuardHistory });
|
|
91
236
|
entry.authorized = true;
|
|
92
237
|
return true;
|
|
93
238
|
}
|
|
94
239
|
return false;
|
|
95
240
|
},
|
|
96
|
-
adopt(id: string) { generation = {}; taskId = id;
|
|
97
|
-
reset() { this.adopt(randomUUID()); },
|
|
241
|
+
adopt(id: string, persistIdentity = true) { /* A live process is never synthesized as completed during reset. */ pendingLineages.clear(); generation = {}; taskId = id; if (persistIdentity) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'task', taskId: id } satisfies GuardHistory }); pending.clear(); pendingExecutors.clear(); /* Preserve failure/fence lineage across task reset. */ },
|
|
242
|
+
reset(persistIdentity = true) { this.adopt(randomUUID(), persistIdentity); },
|
|
98
243
|
};
|
|
99
244
|
}
|
|
100
245
|
export type NoProgressGuard = ReturnType<typeof createNoProgressGuard>;
|
|
@@ -153,7 +298,8 @@ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchPara
|
|
|
153
298
|
conditions,
|
|
154
299
|
});
|
|
155
300
|
const executorKey = canonical([resolve(cwd), actor]);
|
|
156
|
-
const ticket = d.noProgress.begin(key, fingerprint(), executorKey, scope);
|
|
301
|
+
const ticket = d.noProgress.begin(key, fingerprint(), executorKey, scope, worktreeRevision(cwd, []));
|
|
302
|
+
if (ticket.allowed && ticket.operationId && !d.noProgress.invocation(ticket.operationId)) d.noProgress.recordInvocation(ticket.operationId, key, { tool: kind === 'dispatch' ? 'dispatch_agent' : 'spawn_research', params: structuredClone(params) });
|
|
157
303
|
if (!ticket.allowed) {
|
|
158
304
|
if (ticket.refusal === "busy") {
|
|
159
305
|
const recovery = recoveryDecision("busy", { explicitInvocation: true, relevantConditionsChanged: false, executorIdle: false });
|
|
@@ -172,9 +318,13 @@ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchPara
|
|
|
172
318
|
b.updateModeStatus();
|
|
173
319
|
}
|
|
174
320
|
const recovery = recoveryDecision(failure.category, { explicitInvocation: true });
|
|
321
|
+
const operation = d.noProgress.byDispatch(failure.dispatchId);
|
|
322
|
+
const attempt = operation?.attempts.find(a => a.dispatchId === failure.dispatchId);
|
|
323
|
+
const rendered = operation && attempt && renderRecoverCommands(d.noProgress, operation.operationId, attempt.attemptId);
|
|
324
|
+
const commands = rendered ? `Commands (subject to prerequisites): ${rendered}; legacy: /af-retry ${failure.dispatchId}. ${renderNextInvocation(d.noProgress, operation!.operationId) ? `Original-contract invocation after authorization: ${renderNextInvocation(d.noProgress, operation!.operationId)}.` : 'Original validated invocation unavailable.'} These commands do not start a dispatch.` : '';
|
|
175
325
|
const authorization = failure.category === "operator_cancelled"
|
|
176
|
-
? `Fresh one-use authorization is required
|
|
177
|
-
|
|
326
|
+
? `Fresh one-use authorization is required. Scope mode, model, and prose changes are not authorization. ${commands}`
|
|
327
|
+
: `${recovery.reason} ${commands}`;
|
|
178
328
|
return { content: [{ type: "text", text: `No-progress refusal after ${failure.category}: ${failure.reason}. Previous attempt: ${failure.dispatchId}${failure.evidencePath ? ` (${failure.evidencePath})` : ""}. ${authorization} No automatic retry or waiting was performed.` }], details: { status: "no_progress_refused", reason: "unchanged_or_unauthorized", recoveryCategory: failure.category, recovery, exitCode: 1, previousDispatchId: failure.dispatchId, evidencePath: failure.evidencePath } };
|
|
179
329
|
}
|
|
180
330
|
let failure: Failure | undefined;
|
|
@@ -197,6 +347,9 @@ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchPara
|
|
|
197
347
|
throw error;
|
|
198
348
|
} finally {
|
|
199
349
|
d.noProgress.finish(ticket, fingerprint(), failure);
|
|
350
|
+
if (failure?.category === 'indeterminate' && ticket.operationId && ticket.attemptId && result?.details?.pending !== true && Number.isInteger(result?.details?.exitCode) && result?.details?.dispatchId) {
|
|
351
|
+
d.noProgress.settle(ticket.operationId, ticket.attemptId, `runtime-exit:${result.details.dispatchId}:${result.details.exitCode}`);
|
|
352
|
+
}
|
|
200
353
|
const effectsRef = (result?.details as any)?.protocolEffectsEvidenceRef;
|
|
201
354
|
if (failure?.category === "tool_protocol_error" && typeof effectsRef === "string") {
|
|
202
355
|
d.noProgress.establishEffects(failure.dispatchId, ticket.generation, effectsRef);
|
|
@@ -6,7 +6,7 @@ import { selectedPickerValue, workModeChangeBlockedByRoster, workModePickerOptio
|
|
|
6
6
|
|
|
7
7
|
export interface WorkModeUiPort {
|
|
8
8
|
hasUI?: boolean;
|
|
9
|
-
ui: { notify(message: string, level: "error" | "warning" | "info"
|
|
9
|
+
ui: { notify(message: string, level: "error" | "warning" | "info"): void; setStatus(key: string, value: string | undefined): void; select(title: string, options: string[]): Promise<string | undefined> };
|
|
10
10
|
}
|
|
11
11
|
export interface PersistedCapabilityRestore { taskPacks: CapabilityPack[]; provisional: CapabilityPack[]; confirmation: CapabilityConfirmationState }
|
|
12
12
|
export interface WorkModePolicyPorts {
|
|
@@ -102,7 +102,7 @@ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMo
|
|
|
102
102
|
async function applySelection(next: WorkMode, ctx: WorkModeUiPort): Promise<void> {
|
|
103
103
|
const result = await commit(next, ctx);
|
|
104
104
|
if (result === "roster") { ctx.ui.notify(refusalMessage(), "warning"); return; }
|
|
105
|
-
ctx.ui.notify(`${statusText()}\nPrompt and tools update on the next model call.${watchdogNote(next)}`,
|
|
105
|
+
ctx.ui.notify(`${statusText()}\nPrompt and tools update on the next model call.${watchdogNote(next)}`, "info");
|
|
106
106
|
}
|
|
107
107
|
async function openPicker(ctx: WorkModeUiPort): Promise<void> {
|
|
108
108
|
const picker = workModePickerOptions(workMode);
|
|
@@ -29,7 +29,7 @@ export interface HubPromptState {
|
|
|
29
29
|
taskReviewRounds: number;
|
|
30
30
|
turnBudget: { maxDispatches: number | null; maxResearch: number | null };
|
|
31
31
|
taskBudget: { wallMs: number | null };
|
|
32
|
-
provisionalConfirmations: readonly { pack: CapabilityPack; reason: string; question: string }[];
|
|
32
|
+
provisionalConfirmations: readonly { pack: CapabilityPack; reason: string; question: string | { question: string; context?: string; options?: string[] } }[];
|
|
33
33
|
}
|
|
34
34
|
|
|
35
35
|
/** Read-only prompt dependencies. Mutable Hub state remains owned by index.ts. */
|
|
@@ -61,14 +61,14 @@ export interface SessionFooterDependencies {
|
|
|
61
61
|
}
|
|
62
62
|
|
|
63
63
|
export function createSessionFooter(deps: SessionFooterDependencies) {
|
|
64
|
-
return (_tui: unknown, theme: Theme, footerData: { getExtensionStatuses?():
|
|
64
|
+
return (_tui: unknown, theme: Theme, footerData: { getExtensionStatuses?(): ReadonlyMap<string, string> } | undefined) => ({
|
|
65
65
|
dispose: () => {},
|
|
66
66
|
invalidate() {},
|
|
67
67
|
render(width: number): string[] {
|
|
68
68
|
const model = deps.getModel();
|
|
69
69
|
const think = deps.thinkingSuffix(deps.getThinkingLevel());
|
|
70
70
|
const usage = deps.ctx.getContextUsage();
|
|
71
|
-
const pct = usage
|
|
71
|
+
const pct = usage?.percent ?? 0;
|
|
72
72
|
const filled = Math.round(pct / 10);
|
|
73
73
|
const bar = "#".repeat(filled) + "-".repeat(10 - filled);
|
|
74
74
|
const left = deps.renderLeft(theme, deps.version, model, think);
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { RecoverState } from './recover-state.ts';
|
|
2
|
+
import type { DeliverableReadback } from './acceptance.ts';
|
|
3
|
+
|
|
4
|
+
/** Technical attribution is independent of parent T2/T11 acceptance. No model text is a check. */
|
|
5
|
+
export interface TechnicalEvidence {
|
|
6
|
+
taskId: string; operationId: string; attemptId: string; currentRevision: string; observedRevision: string;
|
|
7
|
+
originalExecutor: string; changedScope: string[]; readback: DeliverableReadback[];
|
|
8
|
+
concurrentWriters: boolean; effectsRef?: string;
|
|
9
|
+
reviewer?: { taskId: string; executor: string; revision: string; completed: boolean; blockingFindings: number; coveredScope: string[]; edited: boolean; evidenceRef: string };
|
|
10
|
+
openRequirements: string[];
|
|
11
|
+
}
|
|
12
|
+
export function reconcileTechnical(state: RecoverState, input: TechnicalEvidence) {
|
|
13
|
+
const op = state.inspect(input.operationId);
|
|
14
|
+
const attempt = op?.attempts.find(a => a.attemptId === input.attemptId);
|
|
15
|
+
const refuse = (reason: string) => ({ cleared: false as const, reason, acceptance: 'not_accepted' as const });
|
|
16
|
+
if (!op || !attempt?.category || op.abandoned || op.taskId !== input.taskId || op.executor !== input.originalExecutor || op.attempts.at(-1) !== attempt) return refuse('stale_or_unknown_attempt');
|
|
17
|
+
if (!input.currentRevision || input.observedRevision !== input.currentRevision || input.concurrentWriters) return refuse('stale_or_ambiguous_revision');
|
|
18
|
+
if (attempt.category === 'tool_protocol_error' && !input.effectsRef) return refuse('trusted_T3_effects_required');
|
|
19
|
+
const readback = input.readback.filter(file => file.status === 'read' && file.changed === true && !!file.retainedPath && input.changedScope.includes(file.path));
|
|
20
|
+
if (!readback.length || !input.changedScope.length) return refuse('attributable_changed_readback_required');
|
|
21
|
+
const review = input.reviewer;
|
|
22
|
+
if (!review || !review.completed || review.taskId !== op.taskId || review.executor === op.executor || review.revision !== input.currentRevision || review.edited || review.blockingFindings !== 0 || !review.evidenceRef || input.changedScope.some(path => !review.coveredScope.includes(path))) return refuse('independent_current_revision_review_required');
|
|
23
|
+
const evidence = JSON.stringify({ review: review.evidenceRef, readback: readback.map(file => file.retainedPath), effects: input.effectsRef ?? null });
|
|
24
|
+
if (!state.assess(op.operationId, attempt.attemptId, input.currentRevision, 'cleared', evidence)) return refuse('technical_assessment_conflict');
|
|
25
|
+
return { cleared: true as const, technical_block: 'cleared' as const, acceptance: 'not_accepted' as const, execution: 'failed' as const, provenScope: readback.map(file => file.path), openRequirements: [...input.openRequirements], evidence };
|
|
26
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { recoveryDecision, type RecoveryCategory, type RecoveryConditions } from './recovery-contract.ts';
|
|
2
|
+
import type { RecoverState } from './recover-state.ts';
|
|
3
|
+
import type { NoProgressGuard } from './no-progress.ts';
|
|
4
|
+
|
|
5
|
+
/** Policy assessment is inert: it cannot grant, dispatch, renew budgets or launch a process. */
|
|
6
|
+
export function assessRecovery(category: RecoveryCategory, conditions: RecoveryConditions) {
|
|
7
|
+
return recoveryDecision(category, conditions);
|
|
8
|
+
}
|
|
9
|
+
const ID = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/;
|
|
10
|
+
/** Render only code-owned command grammar from validated IDs, never model-supplied prose. */
|
|
11
|
+
export function renderRecoveryInvocation(state: RecoverState, operationId: string, attemptId: string, command: 'inspect' | 'retry' | 'reconcile' | 'abandon' = 'retry'): string | null {
|
|
12
|
+
if (!ID.test(operationId) || !ID.test(attemptId)) return null;
|
|
13
|
+
const operation = state.inspect(operationId);
|
|
14
|
+
if (!operation || !operation.attempts.some(attempt => attempt.attemptId === attemptId)) return null;
|
|
15
|
+
return command === 'inspect' ? `/af-recover inspect ${operationId}` : `/af-recover ${command} ${operationId} ${attemptId}`;
|
|
16
|
+
}
|
|
17
|
+
/** Human-facing invocation; the tool call is a template, never executed here. */
|
|
18
|
+
export function renderNextInvocation(guard: NoProgressGuard, operationId: string): string | null {
|
|
19
|
+
const operation = guard.inspect(operationId), invocation = guard.invocation(operationId);
|
|
20
|
+
if (!operation || !invocation || operation.abandoned || !ID.test(operationId)) return null;
|
|
21
|
+
return `${invocation.tool}(${JSON.stringify(invocation.params)})`;
|
|
22
|
+
}
|
|
23
|
+
export function renderRecoverCommands(guard: NoProgressGuard, operationId: string, attemptId: string): string | null {
|
|
24
|
+
const op = guard.inspect(operationId);
|
|
25
|
+
if (!op || !ID.test(operationId) || !ID.test(attemptId) || !op.attempts.some(a => a.attemptId === attemptId)) return null;
|
|
26
|
+
return [`/af-recover inspect ${operationId}`, `/af-recover retry ${operationId} ${attemptId}`, `/af-recover reconcile ${operationId} ${attemptId}`, `/af-recover abandon ${operationId} ${attemptId}`].join('; ');
|
|
27
|
+
}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import type { RecoveryCategory } from './recovery-contract.ts';
|
|
3
|
+
|
|
4
|
+
export type RecoverEvent =
|
|
5
|
+
| { type: 'start'; operationId: string; attemptId: string; taskId: string; contract: string; executor: string; dispatchId: string }
|
|
6
|
+
| { type: 'complete'; operationId: string; attemptId: string }
|
|
7
|
+
| { type: 'failure'; operationId: string; attemptId: string; category: RecoveryCategory }
|
|
8
|
+
| { type: 'settled'; operationId: string; attemptId: string; evidence: string }
|
|
9
|
+
| { type: 'dispatch'; operationId: string; attemptId: string; dispatchId: string }
|
|
10
|
+
| { type: 'abandon'; operationId: string; attemptId: string; nonce: string }
|
|
11
|
+
| { type: 'grant'; operationId: string; attemptId: string; nonce: string }
|
|
12
|
+
| { type: 'technical'; operationId: string; attemptId: string; revision: string; status: 'open' | 'cleared'; evidence: string };
|
|
13
|
+
type Attempt = { attemptId: string; dispatchId: string; category?: RecoveryCategory; completed?: boolean; settled?: string };
|
|
14
|
+
type Operation = { operationId: string; taskId: string; contract: string; executor: string; attempts: Attempt[]; indeterminateGrantUsed: boolean; grantedAttemptId?: string; abandoned?: boolean; technical?: { status: 'open' | 'cleared'; revision: string; evidence: string } };
|
|
15
|
+
|
|
16
|
+
/** Pure replay plus a validated append seam. The caller owns durable session-entry storage. */
|
|
17
|
+
export function createRecoverState(history: readonly RecoverEvent[] = [], append?: (event: RecoverEvent) => void) {
|
|
18
|
+
const operations = new Map<string, Operation>();
|
|
19
|
+
const byContract = new Map<string, string>();
|
|
20
|
+
const active = new Map<string, string>();
|
|
21
|
+
const usedIds = new Set<string>();
|
|
22
|
+
const usedNonces = new Set<string>();
|
|
23
|
+
const key = (taskId: string, contract: string) => JSON.stringify([taskId, contract]);
|
|
24
|
+
const nonempty = (value: unknown) => typeof value === 'string' && value.trim().length > 0;
|
|
25
|
+
function apply(event: RecoverEvent) {
|
|
26
|
+
if (!event || !nonempty(event.operationId) || !nonempty(event.attemptId)) throw new Error('Invalid recovery history');
|
|
27
|
+
if (event.type === 'start') {
|
|
28
|
+
if (![event.taskId, event.contract, event.executor, event.dispatchId].every(nonempty) || usedIds.has(event.attemptId) || usedIds.has(event.dispatchId)) throw new Error('Invalid recovery history');
|
|
29
|
+
const k = key(event.taskId, event.contract), existing = byContract.get(k);
|
|
30
|
+
if (existing && existing !== event.operationId || active.has(event.executor) || (operations.has(event.operationId) && existing !== event.operationId)) throw new Error('Invalid recovery history');
|
|
31
|
+
if (!existing) {
|
|
32
|
+
if (usedIds.has(event.operationId)) throw new Error('Invalid recovery history');
|
|
33
|
+
operations.set(event.operationId, { operationId: event.operationId, taskId: event.taskId, contract: event.contract, executor: event.executor, attempts: [], indeterminateGrantUsed: false });
|
|
34
|
+
byContract.set(k, event.operationId); usedIds.add(event.operationId);
|
|
35
|
+
}
|
|
36
|
+
const op = operations.get(event.operationId)!;
|
|
37
|
+
if (op.executor !== event.executor || op.abandoned || (op.attempts.length && !op.attempts.at(-1)?.category && !op.attempts.at(-1)?.completed)) throw new Error('Invalid recovery history');
|
|
38
|
+
op.attempts.push({ attemptId: event.attemptId, dispatchId: event.dispatchId });
|
|
39
|
+
usedIds.add(event.attemptId); usedIds.add(event.dispatchId); active.set(event.executor, event.attemptId);
|
|
40
|
+
return;
|
|
41
|
+
}
|
|
42
|
+
const op = operations.get(event.operationId), attempt = op?.attempts.find(a => a.attemptId === event.attemptId);
|
|
43
|
+
if (!op || !attempt) throw new Error('Invalid recovery history');
|
|
44
|
+
switch (event.type) {
|
|
45
|
+
case 'dispatch':
|
|
46
|
+
if (!nonempty(event.dispatchId) || usedIds.has(event.dispatchId) || attempt.category || attempt.completed || active.get(op.executor) !== attempt.attemptId) throw new Error('Invalid recovery history');
|
|
47
|
+
attempt.dispatchId = event.dispatchId; usedIds.add(event.dispatchId); return;
|
|
48
|
+
case 'abandon':
|
|
49
|
+
if (!attempt.category || op.abandoned || op.attempts.at(-1) !== attempt || !nonempty(event.nonce) || usedNonces.has(event.nonce)) throw new Error('Invalid recovery history');
|
|
50
|
+
usedNonces.add(event.nonce); op.abandoned = true; return;
|
|
51
|
+
case 'complete':
|
|
52
|
+
if (attempt.category || attempt.completed || active.get(op.executor) !== attempt.attemptId) throw new Error('Invalid recovery history');
|
|
53
|
+
attempt.completed = true; active.delete(op.executor); return;
|
|
54
|
+
case 'failure':
|
|
55
|
+
if (attempt.category || active.get(op.executor) !== attempt.attemptId || !['invalid_input','resource_exhausted','operator_cancelled','verification_failed','tool_protocol_error','unknown_tool','indeterminate'].includes(event.category)) throw new Error('Invalid recovery history');
|
|
56
|
+
attempt.category = event.category; active.delete(op.executor); return;
|
|
57
|
+
case 'settled':
|
|
58
|
+
if (!attempt.category || attempt.settled || !nonempty(event.evidence)) throw new Error('Invalid recovery history');
|
|
59
|
+
attempt.settled = event.evidence; return;
|
|
60
|
+
case 'grant':
|
|
61
|
+
if (attempt.category !== 'indeterminate' || !attempt.settled || active.has(op.executor) || op.indeterminateGrantUsed || op.attempts.at(-1) !== attempt || !nonempty(event.nonce) || usedNonces.has(event.nonce)) throw new Error('Invalid recovery history');
|
|
62
|
+
usedNonces.add(event.nonce); op.indeterminateGrantUsed = true; op.grantedAttemptId = attempt.attemptId; return;
|
|
63
|
+
case 'technical':
|
|
64
|
+
if (!attempt.category || !nonempty(event.revision) || !nonempty(event.evidence) || !['open','cleared'].includes(event.status) || (op.technical?.status === 'cleared' && event.status === 'cleared' && op.technical.revision === event.revision)) throw new Error('Invalid recovery history');
|
|
65
|
+
op.technical = { status: event.status, revision: event.revision, evidence: event.evidence }; return;
|
|
66
|
+
default: throw new Error('Invalid recovery history');
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
for (const event of history) apply(event);
|
|
70
|
+
let uncertainAppend = false;
|
|
71
|
+
function record(event: RecoverEvent): boolean {
|
|
72
|
+
// An append that throws may already have committed. Refuse every further mutation
|
|
73
|
+
// until the owner reloads durable history into a replacement state.
|
|
74
|
+
if (uncertainAppend) return false;
|
|
75
|
+
try { createRecoverState([...historySnapshot(), event]); } catch { return false; }
|
|
76
|
+
try { append?.(event); } catch { uncertainAppend = true; return false; }
|
|
77
|
+
apply(event); journal.push(event); return true;
|
|
78
|
+
}
|
|
79
|
+
const journal: RecoverEvent[] = [...history];
|
|
80
|
+
const historySnapshot = () => journal;
|
|
81
|
+
return {
|
|
82
|
+
start(taskId: string, contract: string, executor: string, dispatchId: string) {
|
|
83
|
+
if (![taskId, contract, executor, dispatchId].every(nonempty) || active.has(executor)) return null;
|
|
84
|
+
const operationId = byContract.get(key(taskId, contract)) ?? randomUUID(), attemptId = randomUUID();
|
|
85
|
+
return record({ type: 'start', taskId, contract, executor, dispatchId, operationId, attemptId }) ? { operationId, attemptId } : null;
|
|
86
|
+
},
|
|
87
|
+
bindDispatch(operationId: string, attemptId: string, dispatchId: string) { return record({ type: 'dispatch', operationId, attemptId, dispatchId }); },
|
|
88
|
+
abandon(operationId: string, attemptId: string, nonce: string) { return record({ type: 'abandon', operationId, attemptId, nonce }); },
|
|
89
|
+
byDispatch(dispatchId: string) { for (const op of operations.values()) if (op.attempts.some(a => a.dispatchId === dispatchId)) return this.inspect(op.operationId); return null; },
|
|
90
|
+
complete(operationId: string, attemptId: string) { return record({ type: 'complete', operationId, attemptId }); },
|
|
91
|
+
fail(operationId: string, attemptId: string, category: RecoveryCategory) { return record({ type: 'failure', operationId, attemptId, category }); },
|
|
92
|
+
settle(operationId: string, attemptId: string, evidence: string) { return record({ type: 'settled', operationId, attemptId, evidence }); },
|
|
93
|
+
grant(operationId: string, attemptId: string, nonce: string) { return record({ type: 'grant', operationId, attemptId, nonce }); },
|
|
94
|
+
assess(operationId: string, attemptId: string, revision: string, status: 'open' | 'cleared', evidence: string) { return record({ type: 'technical', operationId, attemptId, revision, status, evidence }); },
|
|
95
|
+
events(): RecoverEvent[] { return structuredClone(journal); },
|
|
96
|
+
inspect(operationId: string): Readonly<Operation> | null {
|
|
97
|
+
const op = operations.get(operationId);
|
|
98
|
+
return op ? structuredClone(op) : null;
|
|
99
|
+
},
|
|
100
|
+
findContract(contract: string) { for (const op of operations.values()) if (op.contract === contract) return this.inspect(op.operationId); return null; },
|
|
101
|
+
find(taskId: string, contract: string) { const id = byContract.get(key(taskId, contract)); return id ? this.inspect(id) : null; },
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
export type RecoverState = ReturnType<typeof createRecoverState>;
|
|
@@ -19,6 +19,8 @@ export interface RecoveryConditions {
|
|
|
19
19
|
freshOneUseAuthorization?: boolean;
|
|
20
20
|
toolStateChanged?: boolean;
|
|
21
21
|
effectsEstablished?: boolean;
|
|
22
|
+
processSettled?: boolean;
|
|
23
|
+
indeterminateGrantUsed?: boolean;
|
|
22
24
|
}
|
|
23
25
|
|
|
24
26
|
export interface RecoveryDecision {
|
|
@@ -56,7 +58,7 @@ export function recoveryDecision(category: RecoveryCategory, conditions: Recover
|
|
|
56
58
|
case "unknown_tool":
|
|
57
59
|
return { ...base, allowed: explicit && changed && conditions.toolStateChanged === true, nextStep: "correct_and_reinvoke", reason: "the effective tool catalog must have trusted runtime change evidence; /af-retry and prose cannot authorize this failure" };
|
|
58
60
|
case "indeterminate":
|
|
59
|
-
return { ...base, allowed:
|
|
61
|
+
return { ...base, allowed: explicit && conditions.executorIdle === true && conditions.processSettled === true && conditions.freshOneUseAuthorization === true && conditions.indeterminateGrantUsed === true, nextStep: "authorize_once_and_reinvoke", reason: "one human-authorized retry only after the old process is settled and the executor idle; partial side effects may exist and retry may duplicate them" };
|
|
60
62
|
}
|
|
61
63
|
}
|
|
62
64
|
|
|
@@ -43,7 +43,7 @@ export function createResearchControls<TDef extends ResearchAgentDef>(ports: Res
|
|
|
43
43
|
ports.runtime.finalize(state, { status: "idle", historyStatus: "idle", lastWork: "(killed by operator)" });
|
|
44
44
|
}
|
|
45
45
|
ports.refresh();
|
|
46
|
-
ctx.ui.notify(total === 0 ? "No research helpers to clear." : `Cleared ${total} research helper${total !== 1 ? "s" : ""}${killed > 0 ? ` (${killed} killed)` : ""}.`,
|
|
46
|
+
ctx.ui.notify(total === 0 ? "No research helpers to clear." : `Cleared ${total} research helper${total !== 1 ? "s" : ""}${killed > 0 ? ` (${killed} killed)` : ""}.`, "info");
|
|
47
47
|
},
|
|
48
48
|
restartSpecialist: ports.restartSpecialist,
|
|
49
49
|
async handleKill(args, ctx) {
|
|
@@ -97,7 +97,7 @@ export interface ResearchRuntimeDeps<TDef extends ResearchAgentDef> extends Rese
|
|
|
97
97
|
resolveThinkingLevel(value: string | undefined): string;
|
|
98
98
|
fallbackModelFor(def: TDef, model: string): string | undefined;
|
|
99
99
|
substitutedModel(model: string | undefined): string | undefined;
|
|
100
|
-
modelWindowLookup(ctx: ExtensionContext): (provider: string, modelId: string) =>
|
|
100
|
+
modelWindowLookup(ctx: ExtensionContext): (provider: string, modelId: string) => { contextWindow?: number } | undefined;
|
|
101
101
|
guardrailEnv(agentId: string): Record<string, string>;
|
|
102
102
|
notifyProviderQueue(model: string, label: string, ctx: ExtensionContext): void;
|
|
103
103
|
spawnPiAgentWithModelFallback: typeof spawnPiAgentWithModelFallback;
|
|
@@ -156,7 +156,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
|
|
|
156
156
|
const completed = completeOutput(state, res);
|
|
157
157
|
const parent = res.boundedOutput ? boundOutput({ content: completed, retentionDir: safePathWithin(state.evidenceDir, "bounded-output", "parent"), label: "parent-summary" }) : null;
|
|
158
158
|
const settled = settle(status, status, lastWork, { output: parent?.reply ?? completed, exitCode: res.exitCode ?? 1, elapsed: state.elapsed });
|
|
159
|
-
ctx.ui.notify(`Research r${state.id} ${status} in ${Math.round(state.elapsed / 1000)}s`, status === "done" ? "
|
|
159
|
+
ctx.ui.notify(`Research r${state.id} ${status} in ${Math.round(state.elapsed / 1000)}s`, status === "done" ? "info" : "error");
|
|
160
160
|
return settled;
|
|
161
161
|
} catch (err: unknown) {
|
|
162
162
|
const message = err instanceof Error ? err.message : String(err);
|
|
@@ -38,7 +38,9 @@ export function shouldExtractReturn(parsed, dispatchedIds) {
|
|
|
38
38
|
return !parsed && Array.isArray(dispatchedIds) && dispatchedIds.length > 0;
|
|
39
39
|
}
|
|
40
40
|
|
|
41
|
-
/** The extraction prompt: restate, never evaluate.
|
|
41
|
+
/** The extraction prompt: restate, never evaluate.
|
|
42
|
+
* @param {{returnPath: string, assertionIds?: string[]}} input
|
|
43
|
+
*/
|
|
42
44
|
export function buildExtractionPrompt({ returnPath, assertionIds = [] }) {
|
|
43
45
|
return `A specialist agent has already finished its work and written its report to a file.
|
|
44
46
|
Your ONLY job is to restate what that report says in a fixed format.
|
|
@@ -81,6 +81,8 @@ export function countReviewFindings(text) {
|
|
|
81
81
|
* blocking findings than the tier's cap. Instructional, never corrective: the
|
|
82
82
|
* dispatcher is told to rank and close, and told what NOT to do with the rest.
|
|
83
83
|
* Returns null when the review is within budget or there is nothing to judge.
|
|
84
|
+
* @param {number|null} [roundsSpent]
|
|
85
|
+
* @param {number|null} [roundCap]
|
|
84
86
|
*/
|
|
85
87
|
export function findingBudgetNotice(agent, tierCap, counts, roundsSpent = null, roundCap = null) {
|
|
86
88
|
if (tierCap == null || !counts) return null;
|
|
@@ -119,6 +119,7 @@ function refusalTail(tier) {
|
|
|
119
119
|
* Gate one dispatcher tool call against the turn budget.
|
|
120
120
|
* kind: "dispatch" | "research"; counters: { dispatches, research } — calls
|
|
121
121
|
* already made this turn. Returns null when allowed, else { reason, message }.
|
|
122
|
+
* @param {string|null} [tier]
|
|
122
123
|
*/
|
|
123
124
|
export function checkTurnBudget(kind, counters, budget, elapsedWallMs, tier = DEFAULT_TASK_TIER) {
|
|
124
125
|
const label = normalizeTaskTier(tier) ?? DEFAULT_TASK_TIER;
|
|
@@ -178,7 +179,10 @@ export function contextOverflowDiagnostic(runsSinceFresh, contextPct, { agent =
|
|
|
178
179
|
);
|
|
179
180
|
}
|
|
180
181
|
|
|
181
|
-
/** One-line status chip: "Tier: small · 1/2 disp · 0/2 res · task 4/6".
|
|
182
|
+
/** One-line status chip: "Tier: small · 1/2 disp · 0/2 res · task 4/6".
|
|
183
|
+
* @param {string|null} [tier]
|
|
184
|
+
* @param {{counters: {dispatches: number}, budget: {maxDispatches: number|null}}|null} [task]
|
|
185
|
+
*/
|
|
182
186
|
export function budgetStatusLine(counters, budget, tier = null, task = null) {
|
|
183
187
|
const cap = (n) => (n == null ? "∞" : String(n));
|
|
184
188
|
const tierLabel = tier || DEFAULT_TASK_TIER;
|
|
@@ -369,6 +373,7 @@ export function resetTaskClock(clock, now) {
|
|
|
369
373
|
* `activeTaskMs` is ACTIVE time (see turnActiveMs), never raw wall clock.
|
|
370
374
|
* kind: "dispatch" | "research". Returns null when allowed, else { reason, message }.
|
|
371
375
|
*/
|
|
376
|
+
/** @param {string|null} [tier] */
|
|
372
377
|
export function checkTaskBudget(kind, counters, taskBudget, activeTaskMs, tier = null) {
|
|
373
378
|
const label = tier ? `tier ${tier}` : "current tier";
|
|
374
379
|
if (taskBudget.wallMs != null && activeTaskMs >= taskBudget.wallMs) {
|