@chankov/agent-fleet 2.0.18 → 2.0.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/proactive-external-git.ts +28 -5
- package/.pi/harnesses/agent-hub/proactive-external.ts +83 -18
- package/.pi/harnesses/agent-hub/proactive-rules.ts +3 -3
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +23 -10
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +6 -6
- package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/policy-roots.js +106 -0
- package/.pi/harnesses/lib/policy-roots.ts +7 -118
- package/.versions/2.0.19/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.19/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.19/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.19/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.19/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.19/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.19/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.19/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.19/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.19/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.19/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.19/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.19/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.19/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.19/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.19/.pi/extensions/package.json +9 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/README.md +1483 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/delegate.ts +478 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/index.ts +2625 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/no-progress.ts +593 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/spawn.ts +563 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/work-mode.ts +187 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.19/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.19/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.19/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.19/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/index.ts +533 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.19/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.19/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.19/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.19/.pi/harnesses/lib/damage-control-shared.ts +226 -0
- package/.versions/2.0.19/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.19/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.19/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.19/.pi/harnesses/lib/policy-roots.js +106 -0
- package/.versions/2.0.19/.pi/harnesses/lib/policy-roots.ts +31 -0
- package/.versions/2.0.19/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.versions/2.0.19/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-agentic.js +15 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-proactive.js +68 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-v2.js +106 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.19/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.19/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.19/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.19/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.19/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.19/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.19/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.19/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.19/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.19/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.19/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.19/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.19/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.19/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.19/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.19/.version +1 -0
- package/.versions/2.0.19/agents/architect.md +24 -0
- package/.versions/2.0.19/agents/bowser.md +28 -0
- package/.versions/2.0.19/agents/builder.md +55 -0
- package/.versions/2.0.19/agents/code-reviewer.md +209 -0
- package/.versions/2.0.19/agents/deep-researcher.md +32 -0
- package/.versions/2.0.19/agents/documenter.md +22 -0
- package/.versions/2.0.19/agents/orchestrator.md +22 -0
- package/.versions/2.0.19/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.19/agents/planner.md +105 -0
- package/.versions/2.0.19/agents/releaser.md +24 -0
- package/.versions/2.0.19/agents/researcher.md +30 -0
- package/.versions/2.0.19/agents/security-auditor.md +167 -0
- package/.versions/2.0.19/agents/test-engineer.md +153 -0
- package/.versions/2.0.19/agents/web-debugger.md +44 -0
- package/.versions/2.0.19/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.19/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.19/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.19/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.19/docs/ARCHITECTURE.md +874 -0
- package/.versions/2.0.19/docs/agent-fleet-setup.md +1101 -0
- package/.versions/2.0.19/docs/claude-code-coms-bridge.md +147 -0
- package/.versions/2.0.19/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.19/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.19/docs/getting-started.md +126 -0
- package/.versions/2.0.19/docs/npm-install.md +535 -0
- package/.versions/2.0.19/docs/pi-extensions.md +454 -0
- package/.versions/2.0.19/docs/pi-setup.md +92 -0
- package/.versions/2.0.19/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.19/install-manifest.json +3197 -0
- package/.versions/2.0.19/justfile +247 -0
- package/.versions/2.0.19/manifest-meta.json +1075 -0
- package/.versions/2.0.19/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.19/references/communication-contract.md +26 -0
- package/.versions/2.0.19/references/definition-of-done.md +67 -0
- package/.versions/2.0.19/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.19/references/observability-checklist.md +92 -0
- package/.versions/2.0.19/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.19/references/performance-checklist.md +236 -0
- package/.versions/2.0.19/references/prompting-patterns.md +380 -0
- package/.versions/2.0.19/references/security-checklist.md +245 -0
- package/.versions/2.0.19/references/testing-patterns.md +235 -0
- package/.versions/2.0.19/references/workflow-authoring.md +304 -0
- package/.versions/2.0.19/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.19/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.19/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.19/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.19/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.19/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.19/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.19/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.19/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.19/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.19/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.19/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.19/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.19/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.19/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.19/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.19/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.19/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.19/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.19/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.19/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.19/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.19/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.19/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.19/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.19/skills/repository-ai-setup/SKILL.md +135 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.19/skills/repository-ai-setup.zip +0 -0
- package/.versions/2.0.19/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.19/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.19/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +6 -0
- package/bin/cli.js +1 -1
- package/bin/lib/doctor.js +8 -2
- package/bin/lib/system1-migration.js +17 -8
- package/bin/lib/system1-policy-context.js +57 -0
- package/bin/lib/transaction.js +1 -1
- package/docs/agent-fleet-setup.md +1 -1
- package/docs/external-project-ai-content.md +17 -1
- package/install-manifest.json +5 -1
- package/manifest-meta.json +4 -0
- package/package.json +1 -1
|
@@ -0,0 +1,593 @@
|
|
|
1
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import { isDeepStrictEqual } from 'node:util';
|
|
3
|
+
import { readFileSync } from "node:fs";
|
|
4
|
+
import { posix, resolve, relative } from "node:path";
|
|
5
|
+
import { worktreeRevision } from "./scope-gate.js";
|
|
6
|
+
import { checkTaskBudget, checkTurnBudget } from "./run-budget.js";
|
|
7
|
+
import { explicitProcessLifecycle, recoveryCategoryFromDetails, recoveryDecision, type RecoveryCategory } from "./recovery-contract.ts";
|
|
8
|
+
import { createRecoverState, type RecoverEvent } from './recover-state.ts';
|
|
9
|
+
import { readBackDeliverables } from './acceptance.ts';
|
|
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';
|
|
13
|
+
import type { ToolExecutor, DispatchAgentParams, SpawnResearchParams } from "./tools/context.ts";
|
|
14
|
+
|
|
15
|
+
interface Failure {
|
|
16
|
+
dispatchId: string;
|
|
17
|
+
reason: string;
|
|
18
|
+
category: RecoveryCategory;
|
|
19
|
+
evidencePath?: string;
|
|
20
|
+
effectsEstablished?: boolean;
|
|
21
|
+
catalogVersion?: string;
|
|
22
|
+
toolStateChanged?: boolean;
|
|
23
|
+
// Runtime-owned proof that no process launched and no effects occurred.
|
|
24
|
+
// Set only from trusted lifecycle facts or an explicit no-launch port,
|
|
25
|
+
// never from missing records alone.
|
|
26
|
+
noLaunchEstablished?: boolean;
|
|
27
|
+
}
|
|
28
|
+
interface Ticket { allowed: boolean; key: string; executorKey: string; scope: string[]; generation: object; id: object; operationId?: string; attemptId?: string; failure?: Failure; refusal?: "busy" | "recovery"; }
|
|
29
|
+
interface RecordedFailure { fingerprint: string; failure: Failure; authorized: boolean; }
|
|
30
|
+
|
|
31
|
+
export const RECOVER_ENTRY = 'agent-hub-recover-event';
|
|
32
|
+
/** A snapshot is a checkpoint of the preceding projection, never an alternative history. */
|
|
33
|
+
export function projectRecoveryRows(entries: readonly unknown[]): any[] {
|
|
34
|
+
const available = entries.filter((row: any) => (row?.customType ?? row?.type) === RECOVER_ENTRY).map((row: any) => row.data);
|
|
35
|
+
let rows: any[] = [];
|
|
36
|
+
for (const [index, row] of available.entries()) {
|
|
37
|
+
if (row?.kind === 'snapshot') {
|
|
38
|
+
if (!Array.isArray(row.rows) || (index > 0 && !isDeepStrictEqual(row.rows, rows))) throw new Error('Invalid recovery snapshot');
|
|
39
|
+
rows = row.rows;
|
|
40
|
+
} else {
|
|
41
|
+
if (!row || !['ledger', 'guard'].includes(row.kind)) throw new Error('Invalid recovery history');
|
|
42
|
+
rows = [...rows, row];
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
if (rows.some(row => !row || !['ledger', 'guard'].includes(row.kind))) throw new Error('Invalid recovery history');
|
|
46
|
+
return rows;
|
|
47
|
+
}
|
|
48
|
+
export type GuardHistory = { type: 'failure' | 'authorize' | 'evidence' | 'task' | 'consume' | 'invocation' | 'no_launch'; key?: string; fingerprint?: string; failure?: Failure; executorKey?: string; scope?: string[]; dispatchId?: string; taskId?: string; evidence?: DispatchEvidence; operationId?: string; evidenceRef?: string; invocation?: { tool: 'dispatch_agent' | 'spawn_research'; params: DispatchAgentParams | SpawnResearchParams } };
|
|
49
|
+
|
|
50
|
+
/** Canonical executor identity shared by the wrapper and evidence producers.
|
|
51
|
+
* Resolves the F3 mismatch: previously the wrapper used canonical([cwd, actor])
|
|
52
|
+
* while the evidence writer used raw p.agent, so production reconcile always failed. */
|
|
53
|
+
export function canonicalExecutor(cwd: string, actor: string): string {
|
|
54
|
+
return canonical([resolve(cwd), actor.trim().toLowerCase().replace(/[\s_]+/g, "-")]);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** Distinct invocation availability for exact recovery responses (T6). */
|
|
58
|
+
export type InvocationStatus =
|
|
59
|
+
| { status: 'available'; invocation: NonNullable<GuardHistory['invocation']> }
|
|
60
|
+
| { status: 'missing'; reason: string; nextActions: string[] }
|
|
61
|
+
| { status: 'invalid'; reason: string; nextActions: string[] }
|
|
62
|
+
| { status: 'abandoned'; reason: string; nextActions: string[] }
|
|
63
|
+
| { status: 'unknown_process'; reason: string; nextActions: string[] };
|
|
64
|
+
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[] };
|
|
65
|
+
const EFFECT_FENCE = new Set<RecoveryCategory>(["operator_cancelled", "indeterminate", "tool_protocol_error", "unknown_tool"]);
|
|
66
|
+
const NO_EFFECT_CATEGORY = new Set<RecoveryCategory>(["not_started", "invalid_input"]);
|
|
67
|
+
type FenceAttempt = { category?: RecoveryCategory; dispatchId: string; completed?: boolean };
|
|
68
|
+
function latestEffectFenceIndex(attempts: readonly FenceAttempt[] | undefined): number {
|
|
69
|
+
if (!attempts) return -1;
|
|
70
|
+
for (let i = attempts.length - 1; i >= 0; i--) {
|
|
71
|
+
const category = attempts[i].category;
|
|
72
|
+
if (category && EFFECT_FENCE.has(category)) return i;
|
|
73
|
+
}
|
|
74
|
+
return -1;
|
|
75
|
+
}
|
|
76
|
+
function laterAttemptLaunched(attempts: readonly FenceAttempt[], index: number): boolean {
|
|
77
|
+
return attempts.slice(index + 1).some(attempt => {
|
|
78
|
+
const category = attempt.category;
|
|
79
|
+
return attempt.completed || (!!category && !NO_EFFECT_CATEGORY.has(category));
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
/** A new task may drop a contract only when every attempt is a proven no-effect refusal. */
|
|
83
|
+
function phantomSafeAttempts(attempts: readonly FenceAttempt[] | undefined, noLaunchEstablished: boolean): boolean {
|
|
84
|
+
if (!attempts?.length || attempts.some(attempt => { const category = attempt.category; return !category || !NO_EFFECT_CATEGORY.has(category); })) return false;
|
|
85
|
+
if (attempts.some(attempt => attempt.category === "invalid_input") && !noLaunchEstablished) return false;
|
|
86
|
+
return true;
|
|
87
|
+
}
|
|
88
|
+
function retainedFenceFailure(attempt: FenceAttempt, previous?: Failure): Failure {
|
|
89
|
+
return {
|
|
90
|
+
dispatchId: attempt.dispatchId,
|
|
91
|
+
reason: previous?.dispatchId === attempt.dispatchId ? previous.reason : "effect_fence_retained",
|
|
92
|
+
category: attempt.category as RecoveryCategory,
|
|
93
|
+
evidencePath: previous?.dispatchId === attempt.dispatchId ? previous.evidencePath : undefined,
|
|
94
|
+
// A no-launch retry must not spend a prior effects/catalog unlock.
|
|
95
|
+
effectsEstablished: false,
|
|
96
|
+
toolStateChanged: false,
|
|
97
|
+
noLaunchEstablished: false,
|
|
98
|
+
catalogVersion: previous?.dispatchId === attempt.dispatchId ? previous.catalogVersion : undefined,
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
interface InvocationDiagnostic { field: string; expected: string; actual: string; reason?: string; }
|
|
102
|
+
function invocationDiagnostics(value: NonNullable<GuardHistory['invocation']>): InvocationDiagnostic[] {
|
|
103
|
+
const type = (v: unknown) => v === undefined ? "missing" : v === null ? "null" : Array.isArray(v) ? "array" : typeof v;
|
|
104
|
+
if (!value || !['dispatch_agent', 'spawn_research'].includes(value.tool)) return [{ field: 'tool', expected: 'dispatch_agent | spawn_research', actual: type(value?.tool) }];
|
|
105
|
+
if (!value.params || typeof value.params !== 'object' || Array.isArray(value.params)) return [{ field: 'params', expected: 'object', actual: type(value.params) }];
|
|
106
|
+
const params = value.params as unknown as Record<string, unknown>;
|
|
107
|
+
const keys = value.tool === 'dispatch_agent' ? ['agent','task','artifacts','scope','scope_mode','deliverables','watchdog','review_reason','backend','triage_id','triage_reason'] : ['task','persona','model','artifacts','read_scope','goal','expected_result'];
|
|
108
|
+
const diagnostics: InvocationDiagnostic[] = [];
|
|
109
|
+
const add = (field: string, expected: string, item: unknown, reason?: string) => { if (diagnostics.length < 16) diagnostics.push({ field, expected, actual: type(item), ...(reason ? { reason } : {}) }); };
|
|
110
|
+
for (const key of ['task', ...(value.tool === 'dispatch_agent' ? ['agent'] : [])]) {
|
|
111
|
+
if (typeof params[key] !== 'string') add(key, 'nonblank string', params[key]);
|
|
112
|
+
else if (!(params[key] as string).trim()) add(key, 'nonblank string', params[key], 'blank');
|
|
113
|
+
}
|
|
114
|
+
const enums: Record<string, string[]> = { scope_mode: ['existing','create'], backend: ['auto','native','coms'], triage_reason: ['used','better_fit','changed_scope','independent_judgment'] };
|
|
115
|
+
for (const [key, item] of Object.entries(params)) {
|
|
116
|
+
if (!keys.includes(key)) { add('params.<unknown-key>', 'supported field', item, 'unknown key (redacted)'); continue; }
|
|
117
|
+
if (item === undefined || key === 'task' || key === 'agent') continue;
|
|
118
|
+
if (['artifacts','scope','deliverables','read_scope'].includes(key)) {
|
|
119
|
+
if (!Array.isArray(item)) add(key, 'array of strings', item);
|
|
120
|
+
else item.forEach((entry, i) => {
|
|
121
|
+
if (typeof entry !== 'string') add(`${key}[${i}]`, 'string', entry);
|
|
122
|
+
else if (key === 'read_scope' && (!entry.length || /^(?:\/|[A-Za-z]:)/.test(entry.trim()) || entry.replace(/\\/g, '/').split('/').includes('..'))) add(`${key}[${i}]`, 'repository-relative nonempty string', entry, 'empty or escaping path');
|
|
123
|
+
});
|
|
124
|
+
} else if (key === 'watchdog') { if (typeof item !== 'boolean') add(key, 'boolean', item); }
|
|
125
|
+
else if (typeof item !== 'string') add(key, enums[key]?.join(' | ') ?? 'string', item);
|
|
126
|
+
else if (enums[key] && !enums[key].includes(item)) add(key, enums[key].join(' | '), item, 'unsupported enum member');
|
|
127
|
+
}
|
|
128
|
+
return diagnostics;
|
|
129
|
+
}
|
|
130
|
+
function validInvocation(value: NonNullable<GuardHistory['invocation']>): boolean { return invocationDiagnostics(value).length === 0; }
|
|
131
|
+
function invocationRefusal(reason: string, diagnostics?: InvocationDiagnostic[]) {
|
|
132
|
+
const note = diagnostics ? `Invalid invocation shape: ${diagnostics.map(d => `${d.field}: expected ${d.expected}, actual ${d.actual}${d.reason ? ` (${d.reason})` : ''}`).join('; ')}. Correct these fields and re-invoke explicitly.` : 'Invocation persistence failed: the valid original contract could not be saved. Restore contract storage before explicitly re-invoking; do not reset or grant a retry.';
|
|
133
|
+
return { content: [{ type: "text" as const, text: `${note} No process launched and no effects occurred.` }], details: { status: diagnostics ? "invalid_input" : "not_started", reason, ...(diagnostics ? { diagnostics } : {}), recoveryCategory: diagnostics ? "invalid_input" as const : "not_started" as const, exitCode: 1, started: false, notStarted: true, effects: "none" } };
|
|
134
|
+
}
|
|
135
|
+
export function createNoProgressGuard(persist?: (type: string, data: unknown) => void) {
|
|
136
|
+
let recovery = createRecoverState([], event => persist?.(RECOVER_ENTRY, { kind: 'ledger', event }));
|
|
137
|
+
let generation = {};
|
|
138
|
+
let taskId: string = randomUUID();
|
|
139
|
+
let taskIdentityPersisted = false;
|
|
140
|
+
const pending = new Map<string, object>();
|
|
141
|
+
const pendingExecutors = new Map<string, object>();
|
|
142
|
+
const pendingLineages = new Map<string, { operationId: string; attemptId: string }>();
|
|
143
|
+
const failures = new Map<string, RecordedFailure>();
|
|
144
|
+
const heldFences = new Map<string, RecordedFailure>();
|
|
145
|
+
const dispatchEvidence = new Map<string, DispatchEvidence>();
|
|
146
|
+
const invocations = new Map<string, NonNullable<GuardHistory['invocation']>>();
|
|
147
|
+
const cancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
|
|
148
|
+
const userGrants: { dispatchId: string; question: string; taskId: string; scope: string[]; used: boolean; cancelled: boolean }[] = [];
|
|
149
|
+
const sameScope = (left: string[], right: string[]) => JSON.stringify([...left].map(path => path.replace(/\\/g, "/")).sort()) === JSON.stringify([...right].map(path => path.replace(/\\/g, "/")).sort());
|
|
150
|
+
return {
|
|
151
|
+
taskToken: () => generation,
|
|
152
|
+
taskId: () => taskId,
|
|
153
|
+
/** The first task has no reset event. Save its identity before binding any
|
|
154
|
+
* pre-model assessment so a resumed session cannot mint another task ID. */
|
|
155
|
+
persistTaskIdentity() {
|
|
156
|
+
if (taskIdentityPersisted) return;
|
|
157
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'task', taskId } satisfies GuardHistory });
|
|
158
|
+
taskIdentityPersisted = true;
|
|
159
|
+
},
|
|
160
|
+
begin(key: string, fingerprint: string, executorKey = key, scope: string[] = [], currentRevision?: string): Ticket {
|
|
161
|
+
let userGrant: (typeof userGrants)[number] | undefined;
|
|
162
|
+
const cancelled = [...cancellations.values()].filter(item => item.executorKey === executorKey);
|
|
163
|
+
const old = cancelled.find(item => !item.entry.authorized)?.entry ?? cancelled[0]?.entry ?? failures.get(key), id = {};
|
|
164
|
+
if (pendingExecutors.has(executorKey)) return { allowed: false, key, executorKey, scope, generation, id, refusal: "busy" };
|
|
165
|
+
// An interrupted append can leave a ledger failure without its guard snapshot.
|
|
166
|
+
// Never treat that as a fresh contract or an unlocked replay.
|
|
167
|
+
if (!old) {
|
|
168
|
+
const op = recovery.findContract(key);
|
|
169
|
+
const fenceIndex = latestEffectFenceIndex(op?.attempts);
|
|
170
|
+
const fence = op && fenceIndex >= 0 ? op.attempts[fenceIndex] : undefined;
|
|
171
|
+
if (op && fence?.category && !laterAttemptLaunched(op.attempts, fenceIndex)) {
|
|
172
|
+
return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery', failure: { category: fence.category, dispatchId: fence.dispatchId, reason: 'effect_fence_retained' } };
|
|
173
|
+
}
|
|
174
|
+
const last = op?.attempts.at(-1);
|
|
175
|
+
if (last?.category) return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery', failure: { category: last.category, dispatchId: last.dispatchId, reason: 'guard_history_missing' } };
|
|
176
|
+
}
|
|
177
|
+
if (old) {
|
|
178
|
+
const category = old.failure.category ?? "indeterminate";
|
|
179
|
+
const changed = old.fingerprint !== fingerprint || old.failure.noLaunchEstablished === true || (category === "unknown_tool" && old.failure.toolStateChanged === true);
|
|
180
|
+
userGrant = category === "blocked_on_user" ? userGrants.find(grant => grant.dispatchId === old.failure.dispatchId && !grant.used && !grant.cancelled && grant.taskId === taskId && sameScope(grant.scope, scope)) : undefined;
|
|
181
|
+
const decision = recoveryDecision(category, {
|
|
182
|
+
explicitInvocation: true,
|
|
183
|
+
relevantConditionsChanged: changed || category === "busy" || (category === 'verification_failed' && !!currentRevision && recovery.findContract(key)?.technical?.status === 'cleared' && recovery.findContract(key)?.technical?.revision === currentRevision),
|
|
184
|
+
freshOneUseAuthorization: old.authorized || !!userGrant || (category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId),
|
|
185
|
+
processSettled: category === 'indeterminate' && !!recovery.findContract(key)?.attempts.at(-1)?.settled,
|
|
186
|
+
indeterminateGrantUsed: category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId,
|
|
187
|
+
effectsEstablished: old.failure.effectsEstablished === true,
|
|
188
|
+
toolStateChanged: old.failure.toolStateChanged === true,
|
|
189
|
+
noLaunchEstablished: old.failure.noLaunchEstablished === true,
|
|
190
|
+
executorIdle: !pendingExecutors.has(executorKey),
|
|
191
|
+
});
|
|
192
|
+
if (!decision.allowed) return { allowed: false, key, executorKey, scope, generation, id, failure: { ...old.failure, category }, refusal: "recovery" };
|
|
193
|
+
}
|
|
194
|
+
// T2: task-scoped logical identity vs persistent effect fence.
|
|
195
|
+
// A phantom not_started attempt from another task never had a process or effects,
|
|
196
|
+
// so a truly new safe task must not inherit it. Cancel/unknown-write/indeterminate
|
|
197
|
+
// fences survive task/model/scope changes and are reused via the old taskId.
|
|
198
|
+
const existing = recovery.findContract(key);
|
|
199
|
+
const phantomFromOtherTask = !!existing && existing.taskId !== taskId && phantomSafeAttempts(existing.attempts, failures.get(key)?.failure.noLaunchEstablished === true);
|
|
200
|
+
const lineageTaskId = phantomFromOtherTask ? taskId : (existing?.taskId ?? taskId);
|
|
201
|
+
const lineage = recovery.start(lineageTaskId, key, executorKey, randomUUID());
|
|
202
|
+
if (!lineage) return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery' };
|
|
203
|
+
if (userGrant) userGrant.used = true;
|
|
204
|
+
for (const item of cancelled) {
|
|
205
|
+
const failedKey = [...failures].find(([, entry]) => entry === item.entry)?.[0];
|
|
206
|
+
if (failedKey) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key: failedKey, dispatchId: item.entry.failure.dispatchId } satisfies GuardHistory });
|
|
207
|
+
cancellations.delete(item.entry.failure.dispatchId);
|
|
208
|
+
if (failedKey) failures.delete(failedKey);
|
|
209
|
+
}
|
|
210
|
+
if (failures.has(key)) {
|
|
211
|
+
const prior = failures.get(key)!;
|
|
212
|
+
if (EFFECT_FENCE.has(prior.failure.category)) heldFences.set(key, prior);
|
|
213
|
+
else heldFences.delete(key);
|
|
214
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key, dispatchId: prior.failure.dispatchId } satisfies GuardHistory });
|
|
215
|
+
failures.delete(key);
|
|
216
|
+
} else heldFences.delete(key);
|
|
217
|
+
pending.set(key, id);
|
|
218
|
+
pendingExecutors.set(executorKey, id);
|
|
219
|
+
pendingLineages.set(executorKey, lineage);
|
|
220
|
+
return { allowed: true, key, executorKey, scope, generation, id, ...lineage };
|
|
221
|
+
},
|
|
222
|
+
finish(ticket: Ticket, fingerprint: string, failure?: Failure) {
|
|
223
|
+
if (!ticket.allowed || ticket.generation !== generation || pending.get(ticket.key) !== ticket.id || pendingExecutors.get(ticket.executorKey) !== ticket.id) return;
|
|
224
|
+
pending.delete(ticket.key);
|
|
225
|
+
pendingExecutors.delete(ticket.executorKey);
|
|
226
|
+
pendingLineages.delete(ticket.executorKey);
|
|
227
|
+
const held = heldFences.get(ticket.key);
|
|
228
|
+
heldFences.delete(ticket.key);
|
|
229
|
+
if (failure && ticket.operationId && ticket.attemptId) {
|
|
230
|
+
recovery.bindDispatch(ticket.operationId, ticket.attemptId, failure.dispatchId);
|
|
231
|
+
recovery.fail(ticket.operationId, ticket.attemptId, failure.category);
|
|
232
|
+
} else if (!failure && ticket.operationId && ticket.attemptId) recovery.complete(ticket.operationId, ticket.attemptId);
|
|
233
|
+
const attempts = recovery.findContract(ticket.key)?.attempts;
|
|
234
|
+
const fenceIndex = latestEffectFenceIndex(attempts);
|
|
235
|
+
const fence = fenceIndex >= 0 ? attempts![fenceIndex] : undefined;
|
|
236
|
+
const retain = !!failure && NO_EFFECT_CATEGORY.has(failure.category) && !!fence?.category && !laterAttemptLaunched(attempts!, fenceIndex);
|
|
237
|
+
if (retain && fence?.category) {
|
|
238
|
+
const retained = retainedFenceFailure(fence, held?.failure);
|
|
239
|
+
const entry = { fingerprint: held?.fingerprint ?? fingerprint, failure: retained, authorized: false };
|
|
240
|
+
failures.set(ticket.key, entry);
|
|
241
|
+
if (retained.category === "operator_cancelled") cancellations.set(retained.dispatchId, { executorKey: ticket.executorKey, scope: held ? ticket.scope : ticket.scope, entry });
|
|
242
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'failure', key: ticket.key, fingerprint: entry.fingerprint, failure: retained, executorKey: ticket.executorKey, scope: ticket.scope } satisfies GuardHistory });
|
|
243
|
+
return;
|
|
244
|
+
}
|
|
245
|
+
if (failure) {
|
|
246
|
+
const entry = { fingerprint, failure, authorized: false };
|
|
247
|
+
failures.set(ticket.key, entry);
|
|
248
|
+
if (failure.category === "operator_cancelled") cancellations.set(failure.dispatchId, { executorKey: ticket.executorKey, scope: ticket.scope, entry });
|
|
249
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'failure', key: ticket.key, fingerprint, failure, executorKey: ticket.executorKey, scope: ticket.scope } satisfies GuardHistory });
|
|
250
|
+
}
|
|
251
|
+
},
|
|
252
|
+
/** Internal runtime port, not model input. Caller must retain an effects inspection artifact;
|
|
253
|
+
* unchanged conditions still cannot retry or replay observed effects. */
|
|
254
|
+
establishEffects(dispatchId: string, token: object, evidenceRef: string): boolean {
|
|
255
|
+
if (token !== generation || !evidenceRef.trim()) return false;
|
|
256
|
+
for (const entry of failures.values()) {
|
|
257
|
+
if (entry.failure.dispatchId !== dispatchId || entry.failure.category !== "tool_protocol_error") continue;
|
|
258
|
+
entry.failure.effectsEstablished = true;
|
|
259
|
+
entry.failure.evidencePath = evidenceRef;
|
|
260
|
+
return true;
|
|
261
|
+
}
|
|
262
|
+
return false;
|
|
263
|
+
},
|
|
264
|
+
/** Runtime-owned no-launch proof (T8). Frees a phantom preflight entry only with
|
|
265
|
+
* positive evidence of no process/dispatch/effects — never from missing records.
|
|
266
|
+
* Unknown-write/cancel/indeterminate-with-possible-effects are never freed here. */
|
|
267
|
+
establishNoLaunch(dispatchId: string, token: object, evidenceRef: string): boolean {
|
|
268
|
+
if (token !== generation || !evidenceRef.trim()) return false;
|
|
269
|
+
for (const [key, entry] of failures) {
|
|
270
|
+
if (entry.failure.dispatchId !== dispatchId) continue;
|
|
271
|
+
if (entry.failure.category !== "not_started" && entry.failure.category !== "invalid_input") return false;
|
|
272
|
+
entry.failure.noLaunchEstablished = true;
|
|
273
|
+
entry.failure.evidencePath = evidenceRef;
|
|
274
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'no_launch', key, dispatchId, evidenceRef } satisfies GuardHistory });
|
|
275
|
+
return true;
|
|
276
|
+
}
|
|
277
|
+
return false;
|
|
278
|
+
},
|
|
279
|
+
/** Exact invocation availability (T6): missing/invalid/abandoned/unknown-process differ. */
|
|
280
|
+
invocationStatus(operationId: string): InvocationStatus {
|
|
281
|
+
const op = recovery.inspect(operationId);
|
|
282
|
+
if (!op) return { status: 'missing', reason: 'unknown_operation', nextActions: ['inspect the operation id', 're-establish the contract before dispatching'] };
|
|
283
|
+
if (op.abandoned) return { status: 'abandoned', reason: 'operation_abandoned', nextActions: ['abandon closed the operation; parent obligations remain open', 'start a new task for new work; do not replay the abandoned invocation'] };
|
|
284
|
+
const attempt = op.attempts.at(-1);
|
|
285
|
+
if (!attempt?.category) return { status: 'unknown_process', reason: 'pending_or_unknown_process', nextActions: ['settle the live process before recovery', 'independent inspection is allowed; replay is not'] };
|
|
286
|
+
const invocation = invocations.get(operationId);
|
|
287
|
+
if (!invocation) return { status: 'missing', reason: 'missing_original_runtime_invocation', nextActions: ['re-establish the validated contract', 'independent inspection is allowed; replay without a contract is not'] };
|
|
288
|
+
if (!validInvocation(invocation)) return { status: 'invalid', reason: 'invalid_original_invocation', nextActions: ['correct the invocation shape before dispatching'] };
|
|
289
|
+
return { status: 'available', invocation: structuredClone(invocation) };
|
|
290
|
+
},
|
|
291
|
+
establishToolStateChange(previousCatalogVersion: string, nextCatalogVersion: string, evidenceRef: string): number {
|
|
292
|
+
if (!previousCatalogVersion || !nextCatalogVersion || previousCatalogVersion === nextCatalogVersion || !evidenceRef.trim()) return 0;
|
|
293
|
+
let established = 0;
|
|
294
|
+
for (const entry of failures.values()) {
|
|
295
|
+
if (entry.failure.category !== "unknown_tool" || entry.failure.catalogVersion !== previousCatalogVersion) continue;
|
|
296
|
+
entry.failure.toolStateChanged = true;
|
|
297
|
+
entry.failure.evidencePath = evidenceRef;
|
|
298
|
+
established++;
|
|
299
|
+
}
|
|
300
|
+
return established;
|
|
301
|
+
},
|
|
302
|
+
prepareSessionRestore() { /* Keep the previous guard installed until a validated restore can replace it. */ },
|
|
303
|
+
compact(entries: readonly unknown[]) {
|
|
304
|
+
const rows = projectRecoveryRows(entries);
|
|
305
|
+
persist?.(RECOVER_ENTRY, { kind: 'snapshot', rows: structuredClone(rows) });
|
|
306
|
+
},
|
|
307
|
+
restore(entries: readonly unknown[], initialTaskId?: string) {
|
|
308
|
+
const rows = projectRecoveryRows(entries);
|
|
309
|
+
const ledger = rows.filter(row => row?.kind === 'ledger').map(row => row.event as RecoverEvent);
|
|
310
|
+
const validated = createRecoverState(ledger, event => persist?.(RECOVER_ENTRY, { kind: 'ledger', event }));
|
|
311
|
+
const nextFailures = new Map<string, RecordedFailure>();
|
|
312
|
+
const nextCancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
|
|
313
|
+
const nextEvidence = new Map<string, DispatchEvidence>();
|
|
314
|
+
const nextInvocations = new Map<string, NonNullable<GuardHistory['invocation']>>();
|
|
315
|
+
// Legacy pre-model sessions may have process additions but no dispatch,
|
|
316
|
+
// reset, or recovery event yet. Their sole persisted task binding is
|
|
317
|
+
// authoritative only when there is no recovery history to contradict it.
|
|
318
|
+
let nextTaskId = rows.length === 0 && initialTaskId ? initialTaskId : taskId;
|
|
319
|
+
for (const row of rows.filter(row => row?.kind === 'guard')) {
|
|
320
|
+
const event = row.event as GuardHistory;
|
|
321
|
+
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)) {
|
|
322
|
+
const existing = nextFailures.get(event.key);
|
|
323
|
+
const keepFence = existing && EFFECT_FENCE.has(existing.failure.category) && NO_EFFECT_CATEGORY.has(event.failure.category);
|
|
324
|
+
if (!keepFence) {
|
|
325
|
+
const entry = { fingerprint: event.fingerprint, failure: event.failure, authorized: false };
|
|
326
|
+
nextFailures.set(event.key, entry);
|
|
327
|
+
if (event.failure.category === 'operator_cancelled') nextCancellations.set(event.failure.dispatchId, { executorKey: event.executorKey, scope: event.scope ?? [], entry });
|
|
328
|
+
}
|
|
329
|
+
} else if (event.type === 'consume' && event.key && event.dispatchId && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId) {
|
|
330
|
+
nextFailures.delete(event.key);
|
|
331
|
+
for (const [id, item] of nextCancellations) if (item.entry.failure.dispatchId === event.dispatchId) nextCancellations.delete(id);
|
|
332
|
+
} else if (event.type === 'authorize' && event.dispatchId && event.key && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId) {
|
|
333
|
+
nextFailures.get(event.key)!.authorized = true;
|
|
334
|
+
} else if (event.type === 'no_launch' && event.dispatchId && event.key && event.evidenceRef && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId && (nextFailures.get(event.key)!.failure.category === 'not_started' || nextFailures.get(event.key)!.failure.category === 'invalid_input')) {
|
|
335
|
+
nextFailures.get(event.key)!.failure.noLaunchEstablished = true;
|
|
336
|
+
nextFailures.get(event.key)!.failure.evidencePath = event.evidenceRef;
|
|
337
|
+
} else if (event.type === 'task' && event.taskId) {
|
|
338
|
+
nextTaskId = event.taskId;
|
|
339
|
+
} 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)) {
|
|
340
|
+
nextInvocations.set(event.operationId, structuredClone(event.invocation));
|
|
341
|
+
} else if (event.type === 'evidence' && event.evidence && event.evidence.dispatchId && event.evidence.taskId) {
|
|
342
|
+
nextEvidence.set(event.evidence.dispatchId, event.evidence);
|
|
343
|
+
} else throw new Error('Invalid recovery guard history');
|
|
344
|
+
}
|
|
345
|
+
if (!rows.some(row => row?.kind === 'guard' && row.event?.type === 'task')) {
|
|
346
|
+
const latest = [...ledger].reverse().find(event => event.type === 'start');
|
|
347
|
+
if (latest?.type === 'start') nextTaskId = latest.taskId;
|
|
348
|
+
}
|
|
349
|
+
for (const operationId of new Set(validated.events().filter(event => event.type === 'start').map(event => event.operationId))) {
|
|
350
|
+
const op = validated.inspect(operationId);
|
|
351
|
+
const fenceIndex = latestEffectFenceIndex(op?.attempts);
|
|
352
|
+
if (!op || fenceIndex < 0 || laterAttemptLaunched(op.attempts, fenceIndex)) continue;
|
|
353
|
+
const current = nextFailures.get(op.contract);
|
|
354
|
+
if (current && EFFECT_FENCE.has(current.failure.category)) continue;
|
|
355
|
+
const failure = retainedFenceFailure(op.attempts[fenceIndex], current?.failure);
|
|
356
|
+
const entry = { fingerprint: current?.fingerprint ?? '', failure, authorized: false };
|
|
357
|
+
nextFailures.set(op.contract, entry);
|
|
358
|
+
if (failure.category === 'operator_cancelled') nextCancellations.set(failure.dispatchId, { executorKey: op.executor, scope: [], entry });
|
|
359
|
+
}
|
|
360
|
+
recovery = validated; taskId = nextTaskId;
|
|
361
|
+
taskIdentityPersisted = rows.some(row => row?.kind === 'guard' && row.event?.type === 'task' && row.event.taskId === nextTaskId);
|
|
362
|
+
failures.clear(); for (const [key, value] of nextFailures) failures.set(key, value);
|
|
363
|
+
cancellations.clear(); for (const [key, value] of nextCancellations) cancellations.set(key, value);
|
|
364
|
+
dispatchEvidence.clear(); for (const [key, value] of nextEvidence) dispatchEvidence.set(key, value);
|
|
365
|
+
invocations.clear(); for (const [key, value] of nextInvocations) invocations.set(key, value);
|
|
366
|
+
generation = {}; pending.clear(); pendingExecutors.clear(); pendingLineages.clear();
|
|
367
|
+
},
|
|
368
|
+
reviewCoverage(taskId: string) { return [...dispatchEvidence.values()].filter(row => row.taskId === taskId && !row.completed).flatMap(row => row.changedScope); },
|
|
369
|
+
recordDispatchEvidence(evidence: DispatchEvidence) {
|
|
370
|
+
if (!evidence.dispatchId || !evidence.taskId || dispatchEvidence.has(evidence.dispatchId)) return false;
|
|
371
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'evidence', evidence } satisfies GuardHistory });
|
|
372
|
+
dispatchEvidence.set(evidence.dispatchId, structuredClone(evidence)); return true;
|
|
373
|
+
},
|
|
374
|
+
reconcile(operationId: string, attemptId: string, currentRevision: string, roots: { cwd: string; sessionDir: string }) {
|
|
375
|
+
const op = recovery.inspect(operationId), attempt = op?.attempts.find(a => a.attemptId === attemptId);
|
|
376
|
+
const original = attempt && dispatchEvidence.get(attempt.dispatchId);
|
|
377
|
+
if (!op || !attempt || !original || original.taskId !== op.taskId || original.executor !== op.executor) return { cleared: false as const, reason: 'missing_original_runtime_evidence' };
|
|
378
|
+
if (currentRevision === 'unavailable' || worktreeRevision(roots.cwd, []) !== currentRevision) return { cleared: false as const, reason: 'stale_or_unavailable_revision' };
|
|
379
|
+
const currentReadback = readBackDeliverables({ files: original.readback.map(row => ({ input: row.path, path: row.path, before: row.sha256 ?? null })), scopeRoots: [] }, roots);
|
|
380
|
+
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' };
|
|
381
|
+
const verifiedReadback = original.readback.map((row, i) => ({ ...row, path: relative(roots.cwd, row.path).replace(/\\/g, '/'), sha256: currentReadback[i]!.sha256 }));
|
|
382
|
+
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)));
|
|
383
|
+
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 });
|
|
384
|
+
},
|
|
385
|
+
inspect(operationId: string) { return recovery.inspect(operationId); },
|
|
386
|
+
invocation(operationId: string) { const item = invocations.get(operationId); return item ? structuredClone(item) : null; },
|
|
387
|
+
recordInvocation(operationId: string, key: string, invocation: NonNullable<GuardHistory['invocation']>) {
|
|
388
|
+
if (recovery.inspect(operationId)?.contract !== key || invocations.has(operationId) || !validInvocation(invocation)) return false;
|
|
389
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'invocation', operationId, key, invocation: structuredClone(invocation) } satisfies GuardHistory });
|
|
390
|
+
invocations.set(operationId, structuredClone(invocation)); return true;
|
|
391
|
+
},
|
|
392
|
+
byDispatch(dispatchId: string) { return recovery.byDispatch(dispatchId); },
|
|
393
|
+
assess(operationId: string, attemptId: string, revision: string, status: 'open' | 'cleared', evidence: string) { return recovery.assess(operationId, attemptId, revision, status, evidence); },
|
|
394
|
+
abandon(operationId: string, attemptId: string, nonce: string) { return recovery.abandon(operationId, attemptId, nonce); },
|
|
395
|
+
isIdle(executor: string) { return !pendingExecutors.has(executor); },
|
|
396
|
+
/** Only independent runtime process settlement evidence may call this port. */
|
|
397
|
+
settle(operationId: string, attemptId: string, evidence: string) { return recovery.settle(operationId, attemptId, evidence); },
|
|
398
|
+
authorizeIndeterminate(operationId: string, attemptId: string, nonce: string): boolean {
|
|
399
|
+
const op = recovery.inspect(operationId);
|
|
400
|
+
if (!op || op.attempts.at(-1)?.attemptId !== attemptId || !op.attempts.at(-1)?.settled || pendingExecutors.has(op.executor) || op.abandoned || op.indeterminateGrantUsed) return false;
|
|
401
|
+
return recovery.grant(operationId, attemptId, nonce);
|
|
402
|
+
},
|
|
403
|
+
canAuthorize(operationId: string, attemptId: string) {
|
|
404
|
+
const op = recovery.inspect(operationId), attempt = op?.attempts.at(-1);
|
|
405
|
+
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);
|
|
406
|
+
},
|
|
407
|
+
recordUserAnswer(input: { dispatchId: string; question: string; scope: string[]; prose?: string }): boolean {
|
|
408
|
+
const failure = [...failures.values()].find(entry => entry.failure.dispatchId === input.dispatchId && entry.failure.category === "blocked_on_user");
|
|
409
|
+
if (!failure || !input.question.trim() || userGrants.some(grant => grant.dispatchId === input.dispatchId && !grant.used && !grant.cancelled)) return false;
|
|
410
|
+
userGrants.push({ dispatchId: input.dispatchId, question: input.question.trim(), taskId, scope: [...input.scope], used: false, cancelled: false });
|
|
411
|
+
return true;
|
|
412
|
+
},
|
|
413
|
+
cancelUserAnswer(dispatchId: string): boolean {
|
|
414
|
+
const grant = userGrants.find(item => item.dispatchId === dispatchId && !item.used && !item.cancelled);
|
|
415
|
+
if (!grant) return false;
|
|
416
|
+
grant.cancelled = true;
|
|
417
|
+
return true;
|
|
418
|
+
},
|
|
419
|
+
userAnswerCapabilities() { return { filesystem: false, network: false, cloud: false, secrets: false } as const; },
|
|
420
|
+
authorize(dispatchId: string): boolean {
|
|
421
|
+
for (const { entry } of cancellations.values()) {
|
|
422
|
+
if (entry.failure.dispatchId !== dispatchId || entry.authorized || entry.failure.category !== "operator_cancelled") continue;
|
|
423
|
+
const key = [...failures].find(([, value]) => value === entry)?.[0];
|
|
424
|
+
if (!key) return false;
|
|
425
|
+
persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'authorize', key, dispatchId } satisfies GuardHistory });
|
|
426
|
+
entry.authorized = true;
|
|
427
|
+
return true;
|
|
428
|
+
}
|
|
429
|
+
return false;
|
|
430
|
+
},
|
|
431
|
+
adopt(id: string, persistIdentity = true) { /* A live process is never synthesized as completed during reset. */ pendingLineages.clear(); generation = {}; if (persistIdentity) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'task', taskId: id } satisfies GuardHistory }); taskId = id; taskIdentityPersisted = persistIdentity; pending.clear(); pendingExecutors.clear(); /* Preserve failure/fence lineage across task reset. */ },
|
|
432
|
+
reset(persistIdentity = true) { this.adopt(randomUUID(), persistIdentity); },
|
|
433
|
+
};
|
|
434
|
+
}
|
|
435
|
+
export type NoProgressGuard = ReturnType<typeof createNoProgressGuard>;
|
|
436
|
+
|
|
437
|
+
export interface ResearchContract {
|
|
438
|
+
readScope: string[];
|
|
439
|
+
goal?: string;
|
|
440
|
+
expectedResult?: string;
|
|
441
|
+
}
|
|
442
|
+
|
|
443
|
+
export function normalizePaths(paths: readonly string[] | undefined): string[] {
|
|
444
|
+
return [...new Set((paths ?? []).map(path => posix.normalize(String(path).trim().replace(/\\/g, "/")).replace(/\/+$/, "")).filter(Boolean))].sort();
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
export function normalizeResearchContract(params: Pick<SpawnResearchParams, "read_scope" | "goal" | "expected_result">): ResearchContract {
|
|
448
|
+
const text = (value: string | undefined) => value?.trim().replace(/\s+/g, " ") || undefined;
|
|
449
|
+
for (const path of (params.read_scope ?? []).map(value => value.trim().replace(/\\/g, "/"))) if (/^(?:\/|[A-Za-z]:)/.test(path) || path.split("/").includes("..")) throw new Error("read_scope must be repository-relative and cannot escape through ..");
|
|
450
|
+
const readScope = normalizePaths(params.read_scope);
|
|
451
|
+
return { readScope, goal: text(params.goal), expectedResult: text(params.expected_result) };
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
function canonical(value: unknown): string {
|
|
455
|
+
if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
|
|
456
|
+
if (value && typeof value === "object") return `{${Object.entries(value as Record<string, unknown>).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(",")}}`;
|
|
457
|
+
return JSON.stringify(value);
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
/** Wording and scope_mode are intentionally absent: neither can manufacture changed execution conditions.
|
|
461
|
+
* Tier and tool-catalog revision ARE included: a tier correction (small→feature) or catalog
|
|
462
|
+
* change is a material prerequisite change that must unblock a not_started retry (T1). */
|
|
463
|
+
export function withNoProgress<P extends DispatchAgentParams | SpawnResearchParams>(
|
|
464
|
+
d: Pick<DispatchExecutorDeps, "noProgress" | "artifacts"> & Partial<Pick<DispatchExecutorDeps, "budget" | "state" | "getToolCatalogVersion">>,
|
|
465
|
+
kind: "dispatch" | "research",
|
|
466
|
+
execute: ToolExecutor<P>,
|
|
467
|
+
executionConditions: (params: P, ctx: any, result?: any) => Record<string, unknown> = () => ({}),
|
|
468
|
+
): ToolExecutor<P> {
|
|
469
|
+
return async (id, params, signal, onUpdate, ctx) => {
|
|
470
|
+
const cwd = ctx.cwd || process.cwd();
|
|
471
|
+
const invocation = { tool: kind === 'dispatch' ? 'dispatch_agent' : 'spawn_research', params } as NonNullable<GuardHistory['invocation']>;
|
|
472
|
+
const diagnostics = invocationDiagnostics(invocation);
|
|
473
|
+
if (diagnostics.length) return invocationRefusal('invalid_invocation_shape', diagnostics);
|
|
474
|
+
let research: ResearchContract | null;
|
|
475
|
+
try { research = "agent" in params ? null : normalizeResearchContract(params); }
|
|
476
|
+
catch (error) { return { content: [{ type: "text", text: String(error) }], details: { status: "invalid_input", recoveryCategory: "invalid_input", started: false, exitCode: 1 } }; }
|
|
477
|
+
const scope = "agent" in params ? normalizePaths(params.scope) : research!.readScope;
|
|
478
|
+
const actor = "agent" in params ? params.agent.trim().toLowerCase().replace(/[\s_]+/g, "-") : (params.persona ?? "research").trim().toLowerCase().replace(/[\s_]+/g, "-");
|
|
479
|
+
let inputs: { path: string }[];
|
|
480
|
+
try { inputs = d.artifacts.loadInputArtifacts(params.artifacts, ctx); }
|
|
481
|
+
catch { return execute(id, params, signal, onUpdate, ctx); }
|
|
482
|
+
const artifactRevision = () => inputs.map(input => {
|
|
483
|
+
try { return [input.path, createHash("sha256").update(readFileSync(input.path)).digest("hex")]; }
|
|
484
|
+
catch { return [input.path, "unreadable"]; }
|
|
485
|
+
}).sort(([a], [b]) => a.localeCompare(b));
|
|
486
|
+
const contractIdentity = "agent" in params ? normalizePaths(params.deliverables) : scope;
|
|
487
|
+
const key = canonical([kind, resolve(cwd), actor, scope, inputs.map(input => input.path).sort(), contractIdentity]);
|
|
488
|
+
const conditions = executionConditions(params, ctx);
|
|
489
|
+
const fingerprint = () => canonical({
|
|
490
|
+
worktree: worktreeRevision(cwd, scope),
|
|
491
|
+
artifacts: artifactRevision(),
|
|
492
|
+
structuredContract: research ? { readScope: research.readScope, goalDeclared: !!research.goal, expectedResultDeclared: !!research.expectedResult } : { scope, deliverables: contractIdentity },
|
|
493
|
+
conditions,
|
|
494
|
+
// Authoritative prerequisite snapshot: tier/catalog changes unblock not_started.
|
|
495
|
+
// Task identity is deliberately excluded so reset cannot bypass cancel/unknown-write fences.
|
|
496
|
+
tier: (d as any).state?.getTaskTier?.() ?? null,
|
|
497
|
+
catalogVersion: (d as any).getToolCatalogVersion?.() ?? null,
|
|
498
|
+
});
|
|
499
|
+
const executorKey = canonicalExecutor(cwd, actor);
|
|
500
|
+
const userAnswer = "agent" in params ? params.task.match(/^USER_ANSWER:\s*(\S+)\s*::\s*(.+)$/m) : null;
|
|
501
|
+
if (userAnswer) d.noProgress.recordUserAnswer({ dispatchId: userAnswer[1], question: userAnswer[2].trim(), scope, prose: params.task });
|
|
502
|
+
const ticket = d.noProgress.begin(key, fingerprint(), executorKey, scope, worktreeRevision(cwd, []));
|
|
503
|
+
// Persist before executor launch. False and throwing ports are both no-launch
|
|
504
|
+
// failures; release the reservation even when storage itself is unavailable.
|
|
505
|
+
if (ticket.allowed && ticket.operationId) {
|
|
506
|
+
let persisted = false;
|
|
507
|
+
try { persisted = !!d.noProgress.invocation(ticket.operationId) || d.noProgress.recordInvocation(ticket.operationId, key, invocation); }
|
|
508
|
+
catch { /* persistence error bodies may contain private payloads */ }
|
|
509
|
+
if (!persisted) {
|
|
510
|
+
const failure: Failure = { dispatchId: randomUUID(), reason: 'invocation_persistence_failed', category: 'not_started', noLaunchEstablished: true };
|
|
511
|
+
try { d.noProgress.finish(ticket, fingerprint(), failure); } catch { /* finish releases in-memory reservations before appending */ }
|
|
512
|
+
return invocationRefusal('invocation_persistence_failed');
|
|
513
|
+
}
|
|
514
|
+
}
|
|
515
|
+
if (!ticket.allowed) {
|
|
516
|
+
if (ticket.refusal === "busy") {
|
|
517
|
+
const recovery = recoveryDecision("busy", { explicitInvocation: true, relevantConditionsChanged: false, executorIdle: false });
|
|
518
|
+
return { content: [{ type: "text", text: "Busy refusal: the same operation is already in flight. Nothing was queued or retried. Re-invoke explicitly only after the executor is evidenced idle; existing budgets still apply." }], details: { status: "busy", reason: "busy", recoveryCategory: "busy", recovery, exitCode: 1, started: false } };
|
|
519
|
+
}
|
|
520
|
+
// Defensive: a reservation failure without a recorded cause (e.g. concurrent
|
|
521
|
+
// start race) stays fail-closed and never synthesizes execution.
|
|
522
|
+
const failure = ticket.failure ?? { dispatchId: randomUUID(), reason: 'reservation_refused', category: 'indeterminate' as const };
|
|
523
|
+
if (d.budget && d.state) {
|
|
524
|
+
const b = d.budget, s = d.state;
|
|
525
|
+
b.ensureTaskTier();
|
|
526
|
+
// T1/F7: refusals are accounted separately from physical launches.
|
|
527
|
+
// A no-progress refusal never spent a child execution, so it must not
|
|
528
|
+
// consume turn/task launch counters. Anti-loop protection stays in the
|
|
529
|
+
// guard (same fingerprint stays refused); budgets still fail closed.
|
|
530
|
+
s.getTurnReport().refusals++; s.getSessionTotals().refusals++;
|
|
531
|
+
const block = checkTaskBudget(kind, b.taskCounters(), b.currentTaskBudget(), b.taskActiveElapsedMs(), s.getTaskTier())
|
|
532
|
+
?? checkTurnBudget(kind, { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, b.currentBudget(), b.turnBudgetActiveElapsedMs(), s.getTaskTier());
|
|
533
|
+
if (block) return { content: [{ type: "text", text: block.message }], details: { status: "budget_refused", reason: block.reason, started: false, recoveryCategory: failure.category, exitCode: 1 } };
|
|
534
|
+
b.updateModeStatus();
|
|
535
|
+
}
|
|
536
|
+
const recovery = recoveryDecision(failure.category, { explicitInvocation: true });
|
|
537
|
+
const operation = d.noProgress.byDispatch(failure.dispatchId);
|
|
538
|
+
const attempt = operation?.attempts.find(a => a.dispatchId === failure.dispatchId);
|
|
539
|
+
const rendered = operation && attempt && renderRecoverCommands(d.noProgress, operation.operationId, attempt.attemptId);
|
|
540
|
+
// T6: missing/invalid/abandoned/unknown-process each get their own reason.
|
|
541
|
+
const invocationNote = (() => {
|
|
542
|
+
if (!operation) return 'Original validated invocation unavailable: unknown operation; re-establish the contract before dispatching.';
|
|
543
|
+
const status = (d.noProgress as any).invocationStatus?.(operation.operationId);
|
|
544
|
+
if (!status || status.status === 'available') {
|
|
545
|
+
const next = renderNextInvocation(d.noProgress, operation.operationId);
|
|
546
|
+
return next ? `Original-contract invocation after authorization: ${next}.` : 'Original validated invocation unavailable.';
|
|
547
|
+
}
|
|
548
|
+
if (status.status === 'abandoned') return 'Original invocation abandoned: abandon closed the operation and never satisfies parent work; start a new task for new work.';
|
|
549
|
+
if (status.status === 'unknown_process') return 'Original validated invocation unavailable: pending or unknown process; settle before recovery. Independent inspection is allowed.';
|
|
550
|
+
if (status.status === 'invalid') return 'Original invocation invalid: correct the invocation shape before dispatching.';
|
|
551
|
+
return 'Original validated invocation unavailable: missing contract; re-establish the contract before dispatching. Independent inspection is allowed.';
|
|
552
|
+
})();
|
|
553
|
+
const commands = rendered ? `Commands (subject to prerequisites): ${rendered}; legacy: /af-retry ${failure.dispatchId}. ${invocationNote} These commands do not start a dispatch.` : '';
|
|
554
|
+
const authorization = failure.category === "operator_cancelled"
|
|
555
|
+
? `Fresh one-use authorization is required. Scope mode, model, and prose changes are not authorization. ${commands}`
|
|
556
|
+
: `${recovery.reason} ${commands}`;
|
|
557
|
+
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 } };
|
|
558
|
+
}
|
|
559
|
+
let failure: Failure | undefined;
|
|
560
|
+
let result: any;
|
|
561
|
+
try {
|
|
562
|
+
result = await execute(id, params, signal, onUpdate, ctx);
|
|
563
|
+
const details = result.details as any;
|
|
564
|
+
const category = recoveryCategoryFromDetails(details);
|
|
565
|
+
// A busy refusal never started work, so it must not become no-progress history.
|
|
566
|
+
// A runtime-owned not_started refusal DID reach the guard reservation but never
|
|
567
|
+
// launched: record it as not_started (0 launches, 0 indeterminate) so a corrected
|
|
568
|
+
// prerequisite can proceed without reset, grant, or reconcile.
|
|
569
|
+
if (category && category !== "busy") failure = {
|
|
570
|
+
dispatchId: details.dispatchId ?? randomUUID(),
|
|
571
|
+
evidencePath: details.evidencePath ?? details.failurePath ?? details.protocolEvidencePath ?? undefined,
|
|
572
|
+
reason: details.diagnostics?.reason ?? details.reason ?? details.status ?? "execution_failure",
|
|
573
|
+
category,
|
|
574
|
+
catalogVersion: category === "unknown_tool" ? d.getToolCatalogVersion?.() : undefined,
|
|
575
|
+
};
|
|
576
|
+
return result;
|
|
577
|
+
} catch (error) {
|
|
578
|
+
failure = { dispatchId: randomUUID(), reason: "execution_exception", category: "indeterminate" };
|
|
579
|
+
throw error;
|
|
580
|
+
} finally {
|
|
581
|
+
d.noProgress.finish(ticket, fingerprint(), failure);
|
|
582
|
+
// T4: integer exit + dispatchId is not settlement. Missing lifecycle stays unsettled.
|
|
583
|
+
const lifecycle = explicitProcessLifecycle((result?.details as any)?.lifecycle);
|
|
584
|
+
if (failure?.category === 'indeterminate' && ticket.operationId && ticket.attemptId && result?.details?.pending !== true && lifecycle?.launched === true && lifecycle.closeSeen === true) {
|
|
585
|
+
d.noProgress.settle(ticket.operationId, ticket.attemptId, `runtime-lifecycle:${result.details.dispatchId}:launched:${lifecycle.launched}:closeSeen:${lifecycle.closeSeen}`);
|
|
586
|
+
}
|
|
587
|
+
const effectsRef = (result?.details as any)?.protocolEffectsEvidenceRef;
|
|
588
|
+
if (failure?.category === "tool_protocol_error" && typeof effectsRef === "string") {
|
|
589
|
+
d.noProgress.establishEffects(failure.dispatchId, ticket.generation, effectsRef);
|
|
590
|
+
}
|
|
591
|
+
}
|
|
592
|
+
};
|
|
593
|
+
}
|