@chankov/agent-fleet 2.0.18 → 2.0.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/proactive-external-git.ts +28 -5
- package/.pi/harnesses/agent-hub/proactive-external.ts +83 -18
- package/.pi/harnesses/agent-hub/proactive-rules.ts +3 -3
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +23 -10
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +6 -6
- package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/policy-roots.js +106 -0
- package/.pi/harnesses/lib/policy-roots.ts +7 -118
- package/.versions/2.0.19/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.19/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.19/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.19/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.19/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.19/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.19/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.19/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.19/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.19/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.19/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.19/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.19/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.19/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.19/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.19/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.19/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.19/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.19/.pi/extensions/package.json +9 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.19/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/README.md +1483 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/delegate.ts +478 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/index.ts +2625 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/no-progress.ts +593 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/spawn.ts +563 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/work-mode.ts +187 -0
- package/.versions/2.0.19/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.19/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.19/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.19/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.19/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.19/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/index.ts +533 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.19/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.19/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.19/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.19/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.19/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.19/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.19/.pi/harnesses/lib/damage-control-shared.ts +226 -0
- package/.versions/2.0.19/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.19/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.19/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.19/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.19/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.19/.pi/harnesses/lib/policy-roots.js +106 -0
- package/.versions/2.0.19/.pi/harnesses/lib/policy-roots.ts +31 -0
- package/.versions/2.0.19/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.versions/2.0.19/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-agentic.js +15 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-proactive.js +68 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config-v2.js +106 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.19/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.19/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.19/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.19/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.19/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.19/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.19/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.19/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.19/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.19/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.19/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.19/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.19/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.19/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.19/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.19/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.19/.version +1 -0
- package/.versions/2.0.19/agents/architect.md +24 -0
- package/.versions/2.0.19/agents/bowser.md +28 -0
- package/.versions/2.0.19/agents/builder.md +55 -0
- package/.versions/2.0.19/agents/code-reviewer.md +209 -0
- package/.versions/2.0.19/agents/deep-researcher.md +32 -0
- package/.versions/2.0.19/agents/documenter.md +22 -0
- package/.versions/2.0.19/agents/orchestrator.md +22 -0
- package/.versions/2.0.19/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.19/agents/planner.md +105 -0
- package/.versions/2.0.19/agents/releaser.md +24 -0
- package/.versions/2.0.19/agents/researcher.md +30 -0
- package/.versions/2.0.19/agents/security-auditor.md +167 -0
- package/.versions/2.0.19/agents/test-engineer.md +153 -0
- package/.versions/2.0.19/agents/web-debugger.md +44 -0
- package/.versions/2.0.19/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.19/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.19/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.19/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.19/docs/ARCHITECTURE.md +874 -0
- package/.versions/2.0.19/docs/agent-fleet-setup.md +1101 -0
- package/.versions/2.0.19/docs/claude-code-coms-bridge.md +147 -0
- package/.versions/2.0.19/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.19/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.19/docs/getting-started.md +126 -0
- package/.versions/2.0.19/docs/npm-install.md +535 -0
- package/.versions/2.0.19/docs/pi-extensions.md +454 -0
- package/.versions/2.0.19/docs/pi-setup.md +92 -0
- package/.versions/2.0.19/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.19/install-manifest.json +3197 -0
- package/.versions/2.0.19/justfile +247 -0
- package/.versions/2.0.19/manifest-meta.json +1075 -0
- package/.versions/2.0.19/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.19/references/communication-contract.md +26 -0
- package/.versions/2.0.19/references/definition-of-done.md +67 -0
- package/.versions/2.0.19/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.19/references/observability-checklist.md +92 -0
- package/.versions/2.0.19/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.19/references/performance-checklist.md +236 -0
- package/.versions/2.0.19/references/prompting-patterns.md +380 -0
- package/.versions/2.0.19/references/security-checklist.md +245 -0
- package/.versions/2.0.19/references/testing-patterns.md +235 -0
- package/.versions/2.0.19/references/workflow-authoring.md +304 -0
- package/.versions/2.0.19/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.19/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.19/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.19/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.19/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.19/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.19/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.19/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.19/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.19/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.19/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.19/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.19/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.19/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.19/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.19/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.19/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.19/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.19/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.19/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.19/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.19/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.19/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.19/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.19/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.19/skills/repository-ai-setup/SKILL.md +135 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.19/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.19/skills/repository-ai-setup.zip +0 -0
- package/.versions/2.0.19/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.19/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.19/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.19/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +6 -0
- package/bin/cli.js +1 -1
- package/bin/lib/doctor.js +8 -2
- package/bin/lib/system1-migration.js +17 -8
- package/bin/lib/system1-policy-context.js +57 -0
- package/bin/lib/transaction.js +1 -1
- package/docs/agent-fleet-setup.md +1 -1
- package/docs/external-project-ai-content.md +17 -1
- package/install-manifest.json +5 -1
- package/manifest-meta.json +4 -0
- package/package.json +1 -1
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { CapabilityResolution } from "../capability-packs.ts";
|
|
2
|
+
import type { HubPromptState } from "./context.ts";
|
|
3
|
+
|
|
4
|
+
export function askUserFragment(askUserAvailable: boolean, userLanguage: string): string {
|
|
5
|
+
return askUserAvailable
|
|
6
|
+
? `## When to call \`ask_user\` (non-negotiable triggers)
|
|
7
|
+
Ask for ambiguous/incomplete/contradictory requirements; preference-dependent choices (architecture, library, naming, scope); every specialist ASK_USER; conflicting specialist outputs or conflicts with requirements; costly-to-undo dispatches (destructive edits, migrations, mass renames, production changes, secrets/credentials); or unspecified path/version/flag/threshold values.
|
|
8
|
+
Read the tool's current schema. Pass question and helpful 1–3 line context. Offer 2–6 choices when enumerable. Ask exactly one focused question per call; never bundle unrelated questions.`
|
|
9
|
+
: `## ask_user is NOT available in this session
|
|
10
|
+
The \`pi-ask-user\` package is not installed, so you have no interactive way to
|
|
11
|
+
ask the human. You MUST instead:
|
|
12
|
+
- State every assumption explicitly in ${userLanguage} before dispatching.
|
|
13
|
+
- Phrase it as: "Assuming X (because Y) — say STOP/correct if wrong, otherwise I'll proceed."
|
|
14
|
+
- Wait for the user's next message before continuing on anything destructive.
|
|
15
|
+
- For \`ASK_USER:\` markers raised by specialists, relay the question verbatim to
|
|
16
|
+
the user in ${userLanguage} and wait for their reply in the next turn.`;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export function dispatchFragment(fleetActive: boolean, askUserAvailable: boolean, userLanguage: string): string {
|
|
20
|
+
if (!fleetActive) return "";
|
|
21
|
+
const questions = askUserAvailable
|
|
22
|
+
? `Ask \`ask_user\` in ${userLanguage} for preferences, contradictions, costly/destructive scope or user-only values. For every returned ASK_USER/details.questions item, ask the human, then re-dispatch with \`USER_ANSWER: <dispatchId> :: <question>\`; prose alone cannot authorize resume.`
|
|
23
|
+
: `For unresolved preferences, contradictions, costly choices or user-only values, state assumptions in ${userLanguage} and wait for correction. Relay every ASK_USER/details.questions item verbatim in ${userLanguage}; wait for the reply before re-dispatch.`;
|
|
24
|
+
return `- Missing repository facts are not ambiguities: use \`spawn_research\` or listed \`filesystem\` stat/inventory/excerpt/readback. Stat first. Above 64 KiB/file or 64 KiB read this turn, do not self-read a too_large refusal: request a research summary or dispatch the path only. Never invent constraints. ${questions}
|
|
25
|
+
- Trivial/small refuses planner, architect, security-auditor and deep-researcher without charging. Use the working specialist, or raise tier with an honest reason first. planner_required needs a tier increase before retry. Never repeat an unchanged refusal.
|
|
26
|
+
- Only use an assertion ledger/proven status when \`set_assertions\` is active; its absence means the tier has not opened verification, not acceptance.
|
|
27
|
+
- Use \`dispatch_agent\` for one focused task; clarification/research and file-deliverable protocols are added automatically. Pass optional \`artifacts\` paths, never full plan/review/inventory bodies.
|
|
28
|
+
- Returns: parsed \`details.structuredReturn\`/\`details.contractNotices\`, raw \`details.returnPath\`/\`details.fullOutput\`. Read via a helper only if digest/path is insufficient. Check every return for questions.`;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function ambiguityFragment(askUserAvailable: boolean, userLanguage: string): string {
|
|
32
|
+
return askUserAvailable
|
|
33
|
+
? `- NEVER proceed past an ambiguity by guessing. A fact about the repository is not an ambiguity: inspect it with \`filesystem\` or \`spawn_research\`. Stat before excerpt; above 64 KiB, do not self-read — spawn_research or dispatch the path. Call \`ask_user\` for a preference, contradiction, or costly choice; otherwise state the assumption explicitly in ${userLanguage} and say you'll proceed unless corrected.`
|
|
34
|
+
: `- NEVER proceed past an ambiguity by guessing. A fact about the repository is not an ambiguity: inspect it with \`filesystem\` or \`spawn_research\`. Stat before excerpt; above 64 KiB, do not self-read — spawn_research or dispatch the path. State every remaining assumption explicitly in ${userLanguage} and wait for the user to confirm or correct.`;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export function languageFragment(askUserAvailable: boolean, userLanguage: string): string {
|
|
38
|
+
const englishNoOp = userLanguage.toLowerCase() === "english" ? " (If user-language is English this is a no-op.)" : "";
|
|
39
|
+
return askUserAvailable
|
|
40
|
+
? `- All user-facing messages, \`ask_user\` questions/context: **${userLanguage}**.
|
|
41
|
+
- \`dispatch_agent\` tasks/personas remain **English**, never translated.
|
|
42
|
+
- Translate specialists' English \`ASK_USER:\` to ${userLanguage} before \`ask_user\`.${englishNoOp}`
|
|
43
|
+
: `- ALWAYS communicate with the human user in **${userLanguage}**. Every message you
|
|
44
|
+
write to the user is ${userLanguage}.
|
|
45
|
+
- Task strings you send via \`dispatch_agent\` stay in **English**. The specialist
|
|
46
|
+
personas are written in English; do not translate task descriptions for them.
|
|
47
|
+
- When a specialist emits an \`ASK_USER:\` line in English, translate it to
|
|
48
|
+
${userLanguage} before relaying to the user.${englishNoOp}`;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export function stateCapsuleFragment(state: HubPromptState, resolution: CapabilityResolution): string {
|
|
52
|
+
const cap = (n: number | null) => (n == null ? "unlimited" : String(n));
|
|
53
|
+
const capMin = (ms: number | null) => (ms == null ? "unlimited" : `${Math.round(ms / 60_000)} min`);
|
|
54
|
+
const capabilityState = [...resolution.active].map(pack => `${pack}:${resolution.reasons[pack]}`).join(", ");
|
|
55
|
+
const provisionalState = resolution.provisional.map(pack => `${pack}:${resolution.reasons[pack]}`).join(", ");
|
|
56
|
+
return `## Current task state
|
|
57
|
+
- tier: ${state.taskTier}${state.taskTierAssumed ? "?" : ""} (spend only); turn dispatches: ${state.turnDispatchCount}; research: ${state.turnResearchCount}
|
|
58
|
+
- process: risk ${state.processRisk ?? "unknown"}; scope ${state.processScope ?? "unknown"}; open obligations: ${state.processOpen?.join(", ") || "none"}. These correctness obligations are independent of tier.
|
|
59
|
+
- task dispatches: ${state.taskDispatchCount}; research: ${state.taskResearchCount}; review rounds: ${state.taskReviewRounds}
|
|
60
|
+
- packs active: ${capabilityState}; provisional: ${provisionalState || "none"}
|
|
61
|
+
- provisional confirmation: ${state.provisionalConfirmations.map(item => `${item.pack} (${item.reason}) → call ask_user exactly once with ${JSON.stringify(item.question)}`).join("; ") || "none"}
|
|
62
|
+
- budgets: dispatch ${cap(state.turnBudget.maxDispatches)}, research ${cap(state.turnBudget.maxResearch)}, task wall ${capMin(state.taskBudget.wallMs)}.`;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export const TASK_TRIAGE_FRAGMENT = `## Task triage (before dispatch)
|
|
66
|
+
Call \`set_task_tier\` honestly: trivial/small uses minimal ceremony; feature/project requires assertions and review. Plans specify work, not consent for unrequested phases. Batch related work with narrow scopes. Budget refusal means stop/ask human; runtime enforcement is authoritative.`;
|
|
67
|
+
|
|
68
|
+
export function verificationFragment(maxOpenAssertions: number): string {
|
|
69
|
+
return `## Verification Contract
|
|
70
|
+
For non-trivial work, record at most ${maxOpenAssertions} narrow, sourced assertions before building and pass them verbatim to specialists. Advance only on named evidence; unproven/failed is not done. Runtime-UI claims require runtime observation. Use \`skills/orchestration-verification/SKILL.md\` for formats, parity inventories, and regression resets. After compaction, read the ledger before continuing.
|
|
71
|
+
In set_assertions, text is one pass condition, source its requirement origin, reference the exact source location, and critical_conditions the semantic constraints that must survive handoff. For test or code-grep assertions declare test_command: the exact approved bash command whose exit 0 checks that condition (a grep check must assert the intended presence/absence). Tell the specialist to run it after edits. Declaration does not execute it. Runtime proves execution, task/revision and state, NOT semantic test adequacy; specialist-authored tests are allowed but require separate code review. manual and runtime-ui requirements are explicitly unsupported by this producer, never silently accepted; missing checkable commands remain unverified. needs_verification does not mean nearly done.
|
|
72
|
+
In spawn_research, task describes the investigation, goal its question, expected_result the desired findings format, and read_scope the advisory relative paths, not isolation.`;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function comsFragment(peerActive: boolean, comsReady: boolean, identity: { name: string; project: string } | null): string {
|
|
76
|
+
return peerActive && comsReady && identity ? `
|
|
77
|
+
## Peer agents (coms)
|
|
78
|
+
You are peer "${identity.name}" in project "${identity.project}". Use \`coms_list\` for the human-scoped pool and status; the Hub cannot widen it. Send one self-contained prompt, then await/get the returned msg_id without resending. Match send/await deadlines. Prefer team dispatch unless the task needs a standing peer, and never duplicate a dispatch to its same-name peer.
|
|
79
|
+
` : "";
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
export const COMPACTION_FRAGMENT = `
|
|
83
|
+
## Context recovery
|
|
84
|
+
- Context pressure is approaching or above the automatic recovery threshold. Keep tool output concise; redirect full test/package logs to files and inspect summaries or tails.
|
|
85
|
+
- \`request_compaction\` is available for explicit recovery. Automatic recovery preserves task state and continues from the compaction summary.
|
|
86
|
+
`;
|
|
87
|
+
export const FILE_DISCOVERY_FRAGMENT = `## File discovery advice
|
|
88
|
+
Inventory/find/ls/grep is auto-ranked at all tiers; use typed discovery, not bash output. Keep original matches/lines and all scored/unscored candidates. Follow filesystem pages; after the self-read ceiling, continue next turn. ask_system1_files accepts paths/patterns/custom questions. Ranking never replaces required reads, permissions, tests or review. Refusals retain ordinary discovery; never retry unchanged failures.`;
|
|
89
|
+
export const ASK_SYSTEM1_RECOMMENDED_FRAGMENT = `## Recommended System 1 usage
|
|
90
|
+
Call \`ask_system1\` first in both modes/all tiers, including trivial and small tasks, before reasoning/research; never rubber-stamp.
|
|
91
|
+
Select permitted paths/ranges, not whole-file relevance reads. Check approved agenticAsk.include scope: prefixes cover descendants; git:tracked covers only paths in this repo's current Git index. All source/access guards apply. Pass repo-relative paths, not selectors. Use minimal state; ordinary tools for missing facts, deterministic lookup for exact facts.
|
|
92
|
+
System 1 is free and fast for routing decisions (not measured); no arbitrary per-task quota or financial rationing. Batch/reuse; byte/time/call limits apply.
|
|
93
|
+
On refusal/unavailability, stale/inconclusive advice, missing evidence or exhausted budget, use ordinary reading, research or independent reasoning. source_denied is a local source/input guard refusal, not a model judgment; empty sourceSummary does not identify its guard. Never bypass export denial by copying denied source/output into state or questions, relocating it or widening include. Never retry unchanged calls/refusals. Ask required decisions via \`ask_user\`.
|
|
94
|
+
Advice never grants authority or replaces required reading before editing, tests, independent review, permissions or gates. Never expand consent/include/output settings for a call. Triage/review retain their workflows.
|
|
95
|
+
`;
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import type { ExtensionContext, Theme } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
|
|
3
|
+
export const SESSION_START_COMMANDS = [
|
|
4
|
+
"/af-work-mode [mode] Operator | Orchestrator (Alt+M)",
|
|
5
|
+
"/af-agents-team Select a team",
|
|
6
|
+
"/af-agents-list Open Fleet Dashboard",
|
|
7
|
+
"/af-agents-history Timeline of agent runs — durations, parallel markers, grand total",
|
|
8
|
+
"/af-context Read-only full-screen context budget diagnostic",
|
|
9
|
+
"/af-agent-model <persona>[.<role>] Switch a persona's or sub-role's model",
|
|
10
|
+
"/af-agent-model-thinking <persona> Switch a persona's thinking level",
|
|
11
|
+
"/af-models [profile] Apply a named model profile to the team",
|
|
12
|
+
"/af-agent-models-substitute [src tgt] Pick/save a session-wide source → target model substitution",
|
|
13
|
+
"/af-dispatch-policy Show which members route to coms peers (dispatch-policy.yaml)",
|
|
14
|
+
"/af-agents-kill <name|rN|all> Kill a frozen specialist or remove research helper(s)",
|
|
15
|
+
"/af-agents-restart <name> Kill + re-run a specialist's last task fresh",
|
|
16
|
+
"/af-zoom <name|rN|child> Scrollable view of an agent / research / delegate-child stream",
|
|
17
|
+
"/af-coms [--all|--project N] Refresh the coms peer pool",
|
|
18
|
+
"/af-handoff <peer> Hand the session off to a coms peer",
|
|
19
|
+
"/af-compound [focus] Capture session lessons into the project rules/docs",
|
|
20
|
+
"/af-poll [--panel NAME] Ask every voice in a model panel the same question",
|
|
21
|
+
"/af-debate [--panel NAME] Cross-examine every voice in a model panel",
|
|
22
|
+
] as const;
|
|
23
|
+
|
|
24
|
+
export interface SessionStartNoticeData {
|
|
25
|
+
workMode: string;
|
|
26
|
+
activeTeamName: string;
|
|
27
|
+
agentCount: number;
|
|
28
|
+
members: string;
|
|
29
|
+
dispatchLabel: string;
|
|
30
|
+
userLanguage: string;
|
|
31
|
+
askUserLabel: string;
|
|
32
|
+
comsLabel: string;
|
|
33
|
+
fleetLabel: string;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export function buildSessionStartNotice(data: SessionStartNoticeData): string {
|
|
37
|
+
return [
|
|
38
|
+
`Work Mode: ${data.workMode} (${data.workMode === "operator" ? "direct tools enabled" : "delegate-only"})`,
|
|
39
|
+
`Native roster: ${data.activeTeamName || "(none)"} (${data.agentCount}${data.members ? `: ${data.members}` : ""})`,
|
|
40
|
+
"Native roster sets loaded from: .pi/agents/teams.yaml",
|
|
41
|
+
`Dispatch backends: ${data.dispatchLabel}`,
|
|
42
|
+
`User-facing language: ${data.userLanguage} (override in .ai/agent-fleet-overrides.md)`,
|
|
43
|
+
`ask_user: ${data.askUserLabel}; specialists bubble up via ASK_USER:`,
|
|
44
|
+
`Coms: ${data.comsLabel}`,
|
|
45
|
+
`Fleet: ${data.fleetLabel}`,
|
|
46
|
+
"",
|
|
47
|
+
...SESSION_START_COMMANDS,
|
|
48
|
+
].join("\n");
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export interface SessionFooterDependencies {
|
|
52
|
+
ctx: ExtensionContext;
|
|
53
|
+
version: string;
|
|
54
|
+
getModel(): string;
|
|
55
|
+
getThinkingLevel(): string | undefined;
|
|
56
|
+
thinkingSuffix(value: string | undefined): string;
|
|
57
|
+
getHint(): string;
|
|
58
|
+
renderLeft(theme: Theme, version: string, model: string, thinking: string): string;
|
|
59
|
+
truncateToWidth(value: string, width: number): string;
|
|
60
|
+
visibleWidth(value: string): number;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export function createSessionFooter(deps: SessionFooterDependencies) {
|
|
64
|
+
return (_tui: unknown, theme: Theme, footerData: { getExtensionStatuses?(): ReadonlyMap<string, string> } | undefined) => ({
|
|
65
|
+
dispose: () => {},
|
|
66
|
+
invalidate() {},
|
|
67
|
+
render(width: number): string[] {
|
|
68
|
+
const model = deps.getModel();
|
|
69
|
+
const think = deps.thinkingSuffix(deps.getThinkingLevel());
|
|
70
|
+
const usage = deps.ctx.getContextUsage();
|
|
71
|
+
const pct = usage?.percent ?? 0;
|
|
72
|
+
const filled = Math.round(pct / 10);
|
|
73
|
+
const bar = "#".repeat(filled) + "-".repeat(10 - filled);
|
|
74
|
+
const left = deps.renderLeft(theme, deps.version, model, think);
|
|
75
|
+
const hint = theme.fg("dim", deps.getHint());
|
|
76
|
+
const btwHint = (globalThis as { __btwActivated?: boolean }).__btwActivated
|
|
77
|
+
? theme.fg("muted", " · Alt+' ") + theme.fg("dim", "btw")
|
|
78
|
+
: "";
|
|
79
|
+
const right = hint + btwHint + theme.fg("muted", " · ") + theme.fg("dim", `[${bar}] ${Math.round(pct)}% `);
|
|
80
|
+
const pad = " ".repeat(Math.max(1, width - deps.visibleWidth(left) - deps.visibleWidth(right)));
|
|
81
|
+
const lines = [deps.truncateToWidth(left + pad + right, width)];
|
|
82
|
+
const stt = footerData?.getExtensionStatuses?.().get("voice-stt");
|
|
83
|
+
if (stt && stt.trim()) {
|
|
84
|
+
const color = /REC/.test(stt) ? "accent" : "muted";
|
|
85
|
+
lines.push(deps.truncateToWidth(theme.fg(color, ` ${stt}`), width));
|
|
86
|
+
}
|
|
87
|
+
return lines;
|
|
88
|
+
},
|
|
89
|
+
});
|
|
90
|
+
}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { MAX_OPEN_ASSERTIONS } from "../assertion-ledger.js";
|
|
2
|
+
import { CAPABILITY_PACKS, type CapabilityPack } from "../capability-packs.ts";
|
|
3
|
+
import { workModePrompt } from "../work-mode.ts";
|
|
4
|
+
import { component, type ContextBudgetComponent } from "../../lib/context-budget.ts";
|
|
5
|
+
import { assembleHubSystemPrompt, HUB_HERDR_SECTION, namedHubLedgerParts, recordHubLedger } from "../../lib/context-budget-hub-prompt.ts";
|
|
6
|
+
import type { HubPromptContext } from "./context.ts";
|
|
7
|
+
import {
|
|
8
|
+
ASK_SYSTEM1_RECOMMENDED_FRAGMENT,
|
|
9
|
+
FILE_DISCOVERY_FRAGMENT,
|
|
10
|
+
ambiguityFragment,
|
|
11
|
+
askUserFragment,
|
|
12
|
+
COMPACTION_FRAGMENT,
|
|
13
|
+
comsFragment,
|
|
14
|
+
dispatchFragment,
|
|
15
|
+
languageFragment,
|
|
16
|
+
stateCapsuleFragment,
|
|
17
|
+
TASK_TRIAGE_FRAGMENT,
|
|
18
|
+
verificationFragment,
|
|
19
|
+
} from "./fragments.ts";
|
|
20
|
+
|
|
21
|
+
export interface BuiltHubSystemPrompt {
|
|
22
|
+
systemPrompt: string;
|
|
23
|
+
ledger: ContextBudgetComponent[];
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function capabilityStatus(pack: CapabilityPack, ctx: HubPromptContext, active: readonly CapabilityPack[], provisional: readonly CapabilityPack[]): string {
|
|
27
|
+
if (active.includes(pack)) return "active";
|
|
28
|
+
if (provisional.includes(pack)) return "provisional";
|
|
29
|
+
if ((pack === "peer" && ctx.isComsReady()) || (pack === "workspace" && ctx.isHerdrFleetReady())) return "ready-inactive";
|
|
30
|
+
return pack === "peer" || pack === "workspace" ? "unavailable" : "inactive";
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** Pure text and ledger assembly. Turn lifecycle resets are owned by index.ts. */
|
|
34
|
+
export function buildHubSystemPrompt(ctx: HubPromptContext): BuiltHubSystemPrompt {
|
|
35
|
+
const resolution = ctx.getCapabilityResolution();
|
|
36
|
+
const modelPacks = new Set<CapabilityPack>([...resolution.active, ...resolution.provisional]);
|
|
37
|
+
const fleetActive = modelPacks.has("fleet");
|
|
38
|
+
const verificationActive = modelPacks.has("verification");
|
|
39
|
+
const peerActive = modelPacks.has("peer");
|
|
40
|
+
const workspaceActive = modelPacks.has("workspace");
|
|
41
|
+
const compactionActive = modelPacks.has("compaction");
|
|
42
|
+
const agents = fleetActive ? ctx.getAgents() : [];
|
|
43
|
+
const agentCards = agents.map(agent => ({
|
|
44
|
+
id: agent.name,
|
|
45
|
+
text: `### ${agent.displayName}\n**Dispatch as:** \`${agent.name}\`\n${agent.description}\n**Tools:** ${agent.tools}`,
|
|
46
|
+
}));
|
|
47
|
+
const agentCatalog = agentCards.map(card => card.text).join("\n\n");
|
|
48
|
+
const teamMembers = agents.map(agent => agent.displayName).join(", ");
|
|
49
|
+
const researchPersonas = fleetActive ? ctx.getResearchPersonas() : [];
|
|
50
|
+
const researchCards = researchPersonas.map(persona => ({
|
|
51
|
+
id: persona.name,
|
|
52
|
+
text: `### ${persona.displayName}\n**Spawn as:** \`spawn_research(persona: "${persona.name}")\`\n**Model:** ${persona.model || "(dispatcher’s default)"} · **Thinking:** ${persona.thinking}\n${persona.description}`,
|
|
53
|
+
}));
|
|
54
|
+
const researchCatalog = !fleetActive ? "" : researchCards.length > 0
|
|
55
|
+
? researchCards.map(card => card.text).join("\n\n")
|
|
56
|
+
: "(No research personas defined. Call `spawn_research` without `persona` for an ad-hoc read-only helper.)";
|
|
57
|
+
const askUserAvailable = ctx.isAskUserAvailable();
|
|
58
|
+
const userLanguage = ctx.getUserLanguage();
|
|
59
|
+
const askUserBlock = askUserFragment(askUserAvailable, userLanguage);
|
|
60
|
+
const triageBeforeDispatch = fleetActive && ctx.getWorkMode() === "orchestrator" && ctx.getActiveTools().includes("dispatch_triage") && ctx.getTriageBeforeDispatch?.() === true;
|
|
61
|
+
const dispatchSection = dispatchFragment(fleetActive, askUserAvailable, userLanguage) + (triageBeforeDispatch ? `
|
|
62
|
+
|
|
63
|
+
## Enabled System 1 pre-dispatch advice
|
|
64
|
+
After resolving requirements, task classification and the active roster, call \`dispatch_triage\` once for each focused task you intend to delegate, before choosing its \`dispatch_agent\` persona. Send only minimal non-secret context, relative scope, and the actual language/domain. Do not read files or credentials merely to populate triage.
|
|
65
|
+
Then independently decide whether and whom to dispatch. An \`uncalibrated\` result contains experimental observations, NOT an approved recommendation; never invent a calibration profile. Do not ask the human solely because calibration is absent. All existing ambiguity, risk, permission, budget and acceptance rules still apply. Low predicted risk never means safe.
|
|
66
|
+
If triage abstains, fails, is unavailable, stale, or reaches its budget, use ordinary independent judgment without automatic retries or forcing a specialist. Do not delegate operator/research-only work just to exercise triage. When dispatching after an applicable result, include its \`triage_id\` and a truthful \`triage_reason\` (\`independent_judgment\` for uncalibrated observations). A triage result is never authorization to execute.
|
|
67
|
+
` : "");
|
|
68
|
+
const ambiguityRule = ambiguityFragment(askUserAvailable, userLanguage);
|
|
69
|
+
const languageLines = languageFragment(askUserAvailable, userLanguage);
|
|
70
|
+
const stateCapsule = stateCapsuleFragment(ctx.getPromptState(), resolution);
|
|
71
|
+
const agenticRecommended = ctx.getActiveTools().includes("ask_system1") && ctx.getAgenticAskMode?.() === "recommended";
|
|
72
|
+
const stableModeSection = [fleetActive ? TASK_TRIAGE_FRAGMENT : "", agenticRecommended ? ASK_SYSTEM1_RECOMMENDED_FRAGMENT : "", ctx.getActiveTools().includes('ask_system1_files') ? FILE_DISCOVERY_FRAGMENT : ""].filter(Boolean).join("\n\n");
|
|
73
|
+
const artifactRoot = ctx.getArtifactRoot?.();
|
|
74
|
+
const verificationSection = (verificationActive ? verificationFragment(MAX_OPEN_ASSERTIONS) : "") +
|
|
75
|
+
(artifactRoot && (verificationActive || fleetActive) ? `\n\nSession artifact root: ${artifactRoot}. Use this absolute root for read/write tools. Handoff paths artifacts/<kind>/... are relative to this root, not the repository. Legacy shared .pi/agent-sessions/artifacts paths belong to other sessions; do not overwrite them.` : "");
|
|
76
|
+
const projectPolicySection = ctx.getRulesProtocol() + ctx.getDocsProtocol();
|
|
77
|
+
const comsSection = comsFragment(peerActive, ctx.isComsReady(), ctx.getIdentity());
|
|
78
|
+
const workModeText = workModePrompt(ctx.getWorkMode());
|
|
79
|
+
const herdrSection = workspaceActive && ctx.isHerdrFleetReady() ? HUB_HERDR_SECTION : "";
|
|
80
|
+
const compactionSection = compactionActive ? COMPACTION_FRAGMENT : "";
|
|
81
|
+
const systemPrompt = assembleHubSystemPrompt({
|
|
82
|
+
intro: workModeText.intro,
|
|
83
|
+
toolList: `these active packs: ${[...modelPacks].join(", ")}. Tools: ${ctx.getActiveTools().map(name => `\`${name}\``).join(", ") || "(none)"}${ctx.getToolCatalogNotice?.() ? `\n${ctx.getToolCatalogNotice()}` : ""}`,
|
|
84
|
+
languageLines,
|
|
85
|
+
activeTeamName: ctx.getActiveTeamName(),
|
|
86
|
+
teamMembers,
|
|
87
|
+
dispatchSection,
|
|
88
|
+
userLanguage,
|
|
89
|
+
askUserBlock,
|
|
90
|
+
modeSection: stableModeSection,
|
|
91
|
+
verificationSection,
|
|
92
|
+
projectPolicySection,
|
|
93
|
+
stateCapsule,
|
|
94
|
+
comsSection,
|
|
95
|
+
herdrSection,
|
|
96
|
+
compactionSection,
|
|
97
|
+
hardRules: workModeText.hardRules,
|
|
98
|
+
ambiguityRule,
|
|
99
|
+
agentCatalog,
|
|
100
|
+
researchCatalog,
|
|
101
|
+
});
|
|
102
|
+
const ledger = recordHubLedger(systemPrompt, namedHubLedgerParts({
|
|
103
|
+
intro: workModeText.intro,
|
|
104
|
+
languageLines,
|
|
105
|
+
teamMembers,
|
|
106
|
+
agentCards,
|
|
107
|
+
dispatchSection,
|
|
108
|
+
modeSection: stableModeSection,
|
|
109
|
+
verificationSection,
|
|
110
|
+
projectPolicySection,
|
|
111
|
+
stateCapsule,
|
|
112
|
+
researchCards,
|
|
113
|
+
researchCatalog,
|
|
114
|
+
comsSection,
|
|
115
|
+
herdrSection,
|
|
116
|
+
compactionSection,
|
|
117
|
+
})).concat(CAPABILITY_PACKS.map(pack => {
|
|
118
|
+
const status = capabilityStatus(pack, ctx, resolution.active, resolution.provisional);
|
|
119
|
+
return component({
|
|
120
|
+
id: `hub/capability/${pack}`, plane: "hub", category: "system", label: `Capability ${pack}: ${status}`,
|
|
121
|
+
source: resolution.reasons[pack], persistence: "turn", visibility: "ui-only", confidence: "exact-chars", chars: 0,
|
|
122
|
+
});
|
|
123
|
+
}));
|
|
124
|
+
return { systemPrompt, ledger };
|
|
125
|
+
}
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
// Per-provider in-flight semaphore.
|
|
2
|
+
//
|
|
3
|
+
// A dispatch may fan out to four delegate children at once, concurrent children
|
|
4
|
+
// are explicitly allowed, and several specialists can be mid-run — with nothing
|
|
5
|
+
// bounding how many requests land on ONE provider. That is survivable against a
|
|
6
|
+
// hosted endpoint and not against a local one: `custom/*` is a single machine,
|
|
7
|
+
// and the observed symptom was mid-run OOM on exactly the children that exist to
|
|
8
|
+
// protect the parent's context.
|
|
9
|
+
//
|
|
10
|
+
// Scope, stated plainly: this bounds the direct children spawned by ONE process.
|
|
11
|
+
// A nested delegate runs in its own pi process with its own semaphore, so the
|
|
12
|
+
// cap is per level of the tree, not global across the fleet. That is deliberate
|
|
13
|
+
// — a cross-process lock would have to survive crashed holders, and the level
|
|
14
|
+
// cap already removes the burst that caused the failures. Within one process the
|
|
15
|
+
// leaf holds the permit and a parent hands its own permit down (`parent`), so a
|
|
16
|
+
// nested spawn can never wait on its ancestor.
|
|
17
|
+
|
|
18
|
+
/** Only the local endpoint is capped by default; hosted providers scale on their side. */
|
|
19
|
+
export const DEFAULT_PROVIDER_LIMITS = Object.freeze({ custom: 2, omlx: 2 });
|
|
20
|
+
|
|
21
|
+
/** "custom/Qwen3.8-27B-Uncensored-MLX-4bit" → "custom"; the part before the first slash. */
|
|
22
|
+
export function providerKey(model) {
|
|
23
|
+
const spec = String(model ?? "").trim().toLowerCase();
|
|
24
|
+
const slash = spec.indexOf("/");
|
|
25
|
+
return slash < 0 ? spec : spec.slice(0, slash);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** Concurrency cap for a model spec, or null when the provider is unlimited. */
|
|
29
|
+
export function providerLimit(model, limits = DEFAULT_PROVIDER_LIMITS) {
|
|
30
|
+
const limit = (limits || {})[providerKey(model)];
|
|
31
|
+
return Number.isFinite(limit) && limit > 0 ? limit : null;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Parse an override list: "custom=3,ollama=1". A value of 0 or "off" means
|
|
36
|
+
* unlimited (recorded as null so it overrides a default cap). Junk is dropped —
|
|
37
|
+
* a malformed env var must never make the hub refuse to start.
|
|
38
|
+
*/
|
|
39
|
+
export function parseProviderLimits(raw) {
|
|
40
|
+
const out = {};
|
|
41
|
+
for (const part of String(raw ?? "").split(",")) {
|
|
42
|
+
const [rawKey, rawValue] = part.split("=");
|
|
43
|
+
if (rawValue === undefined) continue;
|
|
44
|
+
const key = String(rawKey).trim().toLowerCase();
|
|
45
|
+
const value = String(rawValue).trim().toLowerCase();
|
|
46
|
+
if (!key) continue;
|
|
47
|
+
if (value === "off" || value === "none" || value === "unlimited") { out[key] = null; continue; }
|
|
48
|
+
const n = Number(value);
|
|
49
|
+
if (!Number.isFinite(n)) continue;
|
|
50
|
+
out[key] = n > 0 ? Math.floor(n) : null;
|
|
51
|
+
}
|
|
52
|
+
return out;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* FIFO semaphore keyed by provider prefix.
|
|
57
|
+
*
|
|
58
|
+
* - `acquire(model)` → Promise<release>. `release()` is idempotent.
|
|
59
|
+
* - `run(model, fn, { parent })` → runs `fn(permit)` under a permit and releases
|
|
60
|
+
* it however `fn` settles. Pass the permit you were given as `parent` when
|
|
61
|
+
* spawning on the same provider from inside `fn`: the call reuses it instead
|
|
62
|
+
* of taking a second one.
|
|
63
|
+
*
|
|
64
|
+
* Admission is synchronous when a permit is free, and a release hands off
|
|
65
|
+
* directly to the head of the queue, so ordering is exactly request order.
|
|
66
|
+
*/
|
|
67
|
+
export function createProviderSemaphore(limits = DEFAULT_PROVIDER_LIMITS) {
|
|
68
|
+
/** @type {Map<string, { live: number, queue: Array<(release: () => void) => void> }>} */
|
|
69
|
+
const lanes = new Map();
|
|
70
|
+
|
|
71
|
+
const lane = (key) => {
|
|
72
|
+
let l = lanes.get(key);
|
|
73
|
+
if (!l) { l = { live: 0, queue: [] }; lanes.set(key, l); }
|
|
74
|
+
return l;
|
|
75
|
+
};
|
|
76
|
+
|
|
77
|
+
const makeRelease = (key) => {
|
|
78
|
+
let released = false;
|
|
79
|
+
const release = () => {
|
|
80
|
+
if (released) return;
|
|
81
|
+
released = true;
|
|
82
|
+
const l = lane(key);
|
|
83
|
+
const next = l.queue.shift();
|
|
84
|
+
// Hand the permit straight to the next waiter: `live` never dips, so a
|
|
85
|
+
// third caller arriving in between cannot jump the queue.
|
|
86
|
+
if (next) next(makeRelease(key));
|
|
87
|
+
else l.live--;
|
|
88
|
+
};
|
|
89
|
+
release.provider = key;
|
|
90
|
+
return release;
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
/** A free permit now, or null when the lane is full. */
|
|
94
|
+
const tryAcquire = (key, limit) => {
|
|
95
|
+
const l = lane(key);
|
|
96
|
+
if (limit != null && l.live >= limit) return null;
|
|
97
|
+
l.live++;
|
|
98
|
+
return makeRelease(key);
|
|
99
|
+
};
|
|
100
|
+
|
|
101
|
+
function acquire(model) {
|
|
102
|
+
const key = providerKey(model);
|
|
103
|
+
const limit = providerLimit(model, limits);
|
|
104
|
+
const permit = tryAcquire(key, limit);
|
|
105
|
+
if (permit) return Promise.resolve(permit);
|
|
106
|
+
return new Promise((resolve) => lane(key).queue.push(resolve));
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
function run(model, fn, { parent } = {}) {
|
|
110
|
+
const key = providerKey(model);
|
|
111
|
+
// Reentrancy: a parent holding this provider's permit lends it to its own
|
|
112
|
+
// nested spawn rather than queueing behind itself.
|
|
113
|
+
if (typeof parent === "function" && parent.provider === key) {
|
|
114
|
+
try { return Promise.resolve(fn(parent)); } catch (error) { return Promise.reject(error); }
|
|
115
|
+
}
|
|
116
|
+
const invoke = (permit) => {
|
|
117
|
+
let result;
|
|
118
|
+
try { result = fn(permit); } catch (error) { permit(); return Promise.reject(error); }
|
|
119
|
+
return Promise.resolve(result).then(
|
|
120
|
+
(value) => { permit(); return value; },
|
|
121
|
+
(error) => { permit(); throw error; },
|
|
122
|
+
);
|
|
123
|
+
};
|
|
124
|
+
const permit = tryAcquire(key, providerLimit(model, limits));
|
|
125
|
+
if (permit) return invoke(permit);
|
|
126
|
+
return new Promise((resolve, reject) => {
|
|
127
|
+
lane(key).queue.push((granted) => invoke(granted).then(resolve, reject));
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
return {
|
|
132
|
+
acquire,
|
|
133
|
+
run,
|
|
134
|
+
inFlight: (model) => lane(providerKey(model)).live,
|
|
135
|
+
queued: (model) => lane(providerKey(model)).queue.length,
|
|
136
|
+
limitFor: (model) => providerLimit(model, limits),
|
|
137
|
+
};
|
|
138
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { RecoverState } from './recover-state.ts';
|
|
2
|
+
import type { DeliverableReadback } from './acceptance.ts';
|
|
3
|
+
|
|
4
|
+
/** Technical attribution is independent of parent T2/T11 acceptance. No model text is a check. */
|
|
5
|
+
export interface TechnicalEvidence {
|
|
6
|
+
taskId: string; operationId: string; attemptId: string; currentRevision: string; observedRevision: string;
|
|
7
|
+
originalExecutor: string; changedScope: string[]; readback: DeliverableReadback[];
|
|
8
|
+
concurrentWriters: boolean; effectsRef?: string;
|
|
9
|
+
reviewer?: { taskId: string; executor: string; revision: string; completed: boolean; blockingFindings: number; coveredScope: string[]; edited: boolean; evidenceRef: string };
|
|
10
|
+
openRequirements: string[];
|
|
11
|
+
}
|
|
12
|
+
export function reconcileTechnical(state: RecoverState, input: TechnicalEvidence) {
|
|
13
|
+
const op = state.inspect(input.operationId);
|
|
14
|
+
const attempt = op?.attempts.find(a => a.attemptId === input.attemptId);
|
|
15
|
+
const refuse = (reason: string) => ({ cleared: false as const, reason, acceptance: 'not_accepted' as const });
|
|
16
|
+
if (!op || !attempt?.category || op.abandoned || op.taskId !== input.taskId || op.executor !== input.originalExecutor || op.attempts.at(-1) !== attempt) return refuse('stale_or_unknown_attempt');
|
|
17
|
+
if (!input.currentRevision || input.observedRevision !== input.currentRevision || input.concurrentWriters) return refuse('stale_or_ambiguous_revision');
|
|
18
|
+
if (attempt.category === 'tool_protocol_error' && !input.effectsRef) return refuse('trusted_T3_effects_required');
|
|
19
|
+
const readback = input.readback.filter(file => file.status === 'read' && file.changed === true && !!file.retainedPath && input.changedScope.includes(file.path));
|
|
20
|
+
if (!readback.length || !input.changedScope.length) return refuse('attributable_changed_readback_required');
|
|
21
|
+
const review = input.reviewer;
|
|
22
|
+
if (!review || !review.completed || review.taskId !== op.taskId || review.executor === op.executor || review.revision !== input.currentRevision || review.edited || review.blockingFindings !== 0 || !review.evidenceRef || input.changedScope.some(path => !review.coveredScope.includes(path))) return refuse('independent_current_revision_review_required');
|
|
23
|
+
const evidence = JSON.stringify({ review: review.evidenceRef, readback: readback.map(file => file.retainedPath), effects: input.effectsRef ?? null });
|
|
24
|
+
if (!state.assess(op.operationId, attempt.attemptId, input.currentRevision, 'cleared', evidence)) return refuse('technical_assessment_conflict');
|
|
25
|
+
return { cleared: true as const, technical_block: 'cleared' as const, acceptance: 'not_accepted' as const, execution: 'failed' as const, provenScope: readback.map(file => file.path), openRequirements: [...input.openRequirements], evidence };
|
|
26
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { recoveryDecision, type RecoveryCategory, type RecoveryConditions } from './recovery-contract.ts';
|
|
2
|
+
import type { RecoverState } from './recover-state.ts';
|
|
3
|
+
import type { NoProgressGuard } from './no-progress.ts';
|
|
4
|
+
|
|
5
|
+
/** Policy assessment is inert: it cannot grant, dispatch, renew budgets or launch a process. */
|
|
6
|
+
export function assessRecovery(category: RecoveryCategory, conditions: RecoveryConditions) {
|
|
7
|
+
return recoveryDecision(category, conditions);
|
|
8
|
+
}
|
|
9
|
+
const ID = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/;
|
|
10
|
+
/** Render only code-owned command grammar from validated IDs, never model-supplied prose. */
|
|
11
|
+
export function renderRecoveryInvocation(state: RecoverState, operationId: string, attemptId: string, command: 'inspect' | 'retry' | 'reconcile' | 'abandon' = 'retry'): string | null {
|
|
12
|
+
if (!ID.test(operationId) || !ID.test(attemptId)) return null;
|
|
13
|
+
const operation = state.inspect(operationId);
|
|
14
|
+
if (!operation || !operation.attempts.some(attempt => attempt.attemptId === attemptId)) return null;
|
|
15
|
+
return command === 'inspect' ? `/af-recover inspect ${operationId}` : `/af-recover ${command} ${operationId} ${attemptId}`;
|
|
16
|
+
}
|
|
17
|
+
/** Human-facing invocation; the tool call is a template, never executed here.
|
|
18
|
+
* T6: abandoned operations never render a replay template; missing/invalid contracts
|
|
19
|
+
* return null so callers can emit their distinct reason (see invocationStatus). */
|
|
20
|
+
export function renderNextInvocation(guard: NoProgressGuard, operationId: string): string | null {
|
|
21
|
+
const operation = guard.inspect(operationId), invocation = guard.invocation(operationId);
|
|
22
|
+
if (!operation || !invocation || operation.abandoned || !ID.test(operationId)) return null;
|
|
23
|
+
const status = (guard as any).invocationStatus?.(operationId);
|
|
24
|
+
if (status && status.status !== 'available') return null;
|
|
25
|
+
return `${invocation.tool}(${JSON.stringify(invocation.params)})`;
|
|
26
|
+
}
|
|
27
|
+
/** T6: distinct invocation-availability reason for exact recovery responses. */
|
|
28
|
+
export function describeInvocationAvailability(guard: NoProgressGuard, operationId: string): string {
|
|
29
|
+
const status = (guard as any).invocationStatus?.(operationId);
|
|
30
|
+
if (!status) {
|
|
31
|
+
const operation = guard.inspect(operationId);
|
|
32
|
+
if (!operation) return 'missing_original_runtime_invocation: unknown operation';
|
|
33
|
+
if (operation.abandoned) return 'abandoned_operation: abandon closed the operation; parent obligations remain open';
|
|
34
|
+
if (!guard.invocation(operationId)) return 'missing_original_runtime_invocation: no validated contract was persisted';
|
|
35
|
+
return 'unknown_process: pending or unsettled process';
|
|
36
|
+
}
|
|
37
|
+
if (status.status === 'available') return 'available';
|
|
38
|
+
return `${status.reason}: ${(status.nextActions ?? []).join('; ')}`;
|
|
39
|
+
}
|
|
40
|
+
export function renderRecoverCommands(guard: NoProgressGuard, operationId: string, attemptId: string): string | null {
|
|
41
|
+
const op = guard.inspect(operationId);
|
|
42
|
+
if (!op || !ID.test(operationId) || !ID.test(attemptId) || !op.attempts.some(a => a.attemptId === attemptId)) return null;
|
|
43
|
+
return [`/af-recover inspect ${operationId}`, `/af-recover retry ${operationId} ${attemptId}`, `/af-recover reconcile ${operationId} ${attemptId}`, `/af-recover abandon ${operationId} ${attemptId}`].join('; ');
|
|
44
|
+
}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import type { RecoveryCategory } from './recovery-contract.ts';
|
|
3
|
+
|
|
4
|
+
export type RecoverEvent =
|
|
5
|
+
| { type: 'start'; operationId: string; attemptId: string; taskId: string; contract: string; executor: string; dispatchId: string }
|
|
6
|
+
| { type: 'complete'; operationId: string; attemptId: string }
|
|
7
|
+
| { type: 'failure'; operationId: string; attemptId: string; category: RecoveryCategory }
|
|
8
|
+
| { type: 'settled'; operationId: string; attemptId: string; evidence: string }
|
|
9
|
+
| { type: 'dispatch'; operationId: string; attemptId: string; dispatchId: string }
|
|
10
|
+
| { type: 'abandon'; operationId: string; attemptId: string; nonce: string }
|
|
11
|
+
| { type: 'grant'; operationId: string; attemptId: string; nonce: string }
|
|
12
|
+
| { type: 'technical'; operationId: string; attemptId: string; revision: string; status: 'open' | 'cleared'; evidence: string };
|
|
13
|
+
type Attempt = { attemptId: string; dispatchId: string; category?: RecoveryCategory; completed?: boolean; settled?: string };
|
|
14
|
+
type Operation = { operationId: string; taskId: string; contract: string; executor: string; attempts: Attempt[]; indeterminateGrantUsed: boolean; grantedAttemptId?: string; abandoned?: boolean; technical?: { status: 'open' | 'cleared'; revision: string; evidence: string } };
|
|
15
|
+
|
|
16
|
+
/** Pure replay plus a validated append seam. The caller owns durable session-entry storage. */
|
|
17
|
+
export function createRecoverState(history: readonly RecoverEvent[] = [], append?: (event: RecoverEvent) => void) {
|
|
18
|
+
const operations = new Map<string, Operation>();
|
|
19
|
+
const byContract = new Map<string, string>();
|
|
20
|
+
const active = new Map<string, string>();
|
|
21
|
+
const usedIds = new Set<string>();
|
|
22
|
+
const usedNonces = new Set<string>();
|
|
23
|
+
const key = (taskId: string, contract: string) => JSON.stringify([taskId, contract]);
|
|
24
|
+
const nonempty = (value: unknown) => typeof value === 'string' && value.trim().length > 0;
|
|
25
|
+
function apply(event: RecoverEvent) {
|
|
26
|
+
if (!event || !nonempty(event.operationId) || !nonempty(event.attemptId)) throw new Error('Invalid recovery history');
|
|
27
|
+
if (event.type === 'start') {
|
|
28
|
+
if (![event.taskId, event.contract, event.executor, event.dispatchId].every(nonempty) || usedIds.has(event.attemptId) || usedIds.has(event.dispatchId)) throw new Error('Invalid recovery history');
|
|
29
|
+
const k = key(event.taskId, event.contract), existing = byContract.get(k);
|
|
30
|
+
if (existing && existing !== event.operationId || active.has(event.executor) || (operations.has(event.operationId) && existing !== event.operationId)) throw new Error('Invalid recovery history');
|
|
31
|
+
if (!existing) {
|
|
32
|
+
if (usedIds.has(event.operationId)) throw new Error('Invalid recovery history');
|
|
33
|
+
operations.set(event.operationId, { operationId: event.operationId, taskId: event.taskId, contract: event.contract, executor: event.executor, attempts: [], indeterminateGrantUsed: false });
|
|
34
|
+
byContract.set(k, event.operationId); usedIds.add(event.operationId);
|
|
35
|
+
}
|
|
36
|
+
const op = operations.get(event.operationId)!;
|
|
37
|
+
if (op.executor !== event.executor || op.abandoned || (op.attempts.length && !op.attempts.at(-1)?.category && !op.attempts.at(-1)?.completed)) throw new Error('Invalid recovery history');
|
|
38
|
+
op.attempts.push({ attemptId: event.attemptId, dispatchId: event.dispatchId });
|
|
39
|
+
usedIds.add(event.attemptId); usedIds.add(event.dispatchId); active.set(event.executor, event.attemptId);
|
|
40
|
+
return;
|
|
41
|
+
}
|
|
42
|
+
const op = operations.get(event.operationId), attempt = op?.attempts.find(a => a.attemptId === event.attemptId);
|
|
43
|
+
if (!op || !attempt) throw new Error('Invalid recovery history');
|
|
44
|
+
switch (event.type) {
|
|
45
|
+
case 'dispatch':
|
|
46
|
+
if (!nonempty(event.dispatchId) || usedIds.has(event.dispatchId) || attempt.category || attempt.completed || active.get(op.executor) !== attempt.attemptId) throw new Error('Invalid recovery history');
|
|
47
|
+
attempt.dispatchId = event.dispatchId; usedIds.add(event.dispatchId); return;
|
|
48
|
+
case 'abandon':
|
|
49
|
+
if (!attempt.category || op.abandoned || op.attempts.at(-1) !== attempt || !nonempty(event.nonce) || usedNonces.has(event.nonce)) throw new Error('Invalid recovery history');
|
|
50
|
+
usedNonces.add(event.nonce); op.abandoned = true; return;
|
|
51
|
+
case 'complete':
|
|
52
|
+
if (attempt.category || attempt.completed || active.get(op.executor) !== attempt.attemptId) throw new Error('Invalid recovery history');
|
|
53
|
+
attempt.completed = true; active.delete(op.executor); return;
|
|
54
|
+
case 'failure':
|
|
55
|
+
if (attempt.category || active.get(op.executor) !== attempt.attemptId || !['not_started','invalid_input','resource_exhausted','operator_cancelled','verification_failed','blocked_on_user','tool_protocol_error','unknown_tool','indeterminate'].includes(event.category)) throw new Error('Invalid recovery history');
|
|
56
|
+
attempt.category = event.category; active.delete(op.executor); return;
|
|
57
|
+
case 'settled':
|
|
58
|
+
if (!attempt.category || attempt.settled || !nonempty(event.evidence)) throw new Error('Invalid recovery history');
|
|
59
|
+
attempt.settled = event.evidence; return;
|
|
60
|
+
case 'grant':
|
|
61
|
+
if (attempt.category !== 'indeterminate' || !attempt.settled || active.has(op.executor) || op.indeterminateGrantUsed || op.attempts.at(-1) !== attempt || !nonempty(event.nonce) || usedNonces.has(event.nonce)) throw new Error('Invalid recovery history');
|
|
62
|
+
usedNonces.add(event.nonce); op.indeterminateGrantUsed = true; op.grantedAttemptId = attempt.attemptId; return;
|
|
63
|
+
case 'technical':
|
|
64
|
+
if (!attempt.category || !nonempty(event.revision) || !nonempty(event.evidence) || !['open','cleared'].includes(event.status) || (op.technical?.status === 'cleared' && event.status === 'cleared' && op.technical.revision === event.revision)) throw new Error('Invalid recovery history');
|
|
65
|
+
op.technical = { status: event.status, revision: event.revision, evidence: event.evidence }; return;
|
|
66
|
+
default: throw new Error('Invalid recovery history');
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
for (const event of history) apply(event);
|
|
70
|
+
let uncertainAppend = false;
|
|
71
|
+
function record(event: RecoverEvent): boolean {
|
|
72
|
+
// An append that throws may already have committed. Refuse every further mutation
|
|
73
|
+
// until the owner reloads durable history into a replacement state.
|
|
74
|
+
if (uncertainAppend) return false;
|
|
75
|
+
try { createRecoverState([...historySnapshot(), event]); } catch { return false; }
|
|
76
|
+
try { append?.(event); } catch { uncertainAppend = true; return false; }
|
|
77
|
+
apply(event); journal.push(event); return true;
|
|
78
|
+
}
|
|
79
|
+
const journal: RecoverEvent[] = [...history];
|
|
80
|
+
const historySnapshot = () => journal;
|
|
81
|
+
return {
|
|
82
|
+
start(taskId: string, contract: string, executor: string, dispatchId: string) {
|
|
83
|
+
if (![taskId, contract, executor, dispatchId].every(nonempty) || active.has(executor)) return null;
|
|
84
|
+
const operationId = byContract.get(key(taskId, contract)) ?? randomUUID(), attemptId = randomUUID();
|
|
85
|
+
return record({ type: 'start', taskId, contract, executor, dispatchId, operationId, attemptId }) ? { operationId, attemptId } : null;
|
|
86
|
+
},
|
|
87
|
+
bindDispatch(operationId: string, attemptId: string, dispatchId: string) { return record({ type: 'dispatch', operationId, attemptId, dispatchId }); },
|
|
88
|
+
abandon(operationId: string, attemptId: string, nonce: string) { return record({ type: 'abandon', operationId, attemptId, nonce }); },
|
|
89
|
+
byDispatch(dispatchId: string) { for (const op of operations.values()) if (op.attempts.some(a => a.dispatchId === dispatchId)) return this.inspect(op.operationId); return null; },
|
|
90
|
+
complete(operationId: string, attemptId: string) { return record({ type: 'complete', operationId, attemptId }); },
|
|
91
|
+
fail(operationId: string, attemptId: string, category: RecoveryCategory) { return record({ type: 'failure', operationId, attemptId, category }); },
|
|
92
|
+
settle(operationId: string, attemptId: string, evidence: string) { return record({ type: 'settled', operationId, attemptId, evidence }); },
|
|
93
|
+
grant(operationId: string, attemptId: string, nonce: string) { return record({ type: 'grant', operationId, attemptId, nonce }); },
|
|
94
|
+
assess(operationId: string, attemptId: string, revision: string, status: 'open' | 'cleared', evidence: string) { return record({ type: 'technical', operationId, attemptId, revision, status, evidence }); },
|
|
95
|
+
events(): RecoverEvent[] { return structuredClone(journal); },
|
|
96
|
+
inspect(operationId: string): Readonly<Operation> | null {
|
|
97
|
+
const op = operations.get(operationId);
|
|
98
|
+
return op ? structuredClone(op) : null;
|
|
99
|
+
},
|
|
100
|
+
findContract(contract: string) { for (const op of operations.values()) if (op.contract === contract) return this.inspect(op.operationId); return null; },
|
|
101
|
+
find(taskId: string, contract: string) { const id = byContract.get(key(taskId, contract)); return id ? this.inspect(id) : null; },
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
export type RecoverState = ReturnType<typeof createRecoverState>;
|