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