@chankov/agent-fleet 2.0.10 → 2.0.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agent-fleet/scripts/flow.ts +26 -8
- package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
- package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
- package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
- package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
- package/.pi/harnesses/agent-hub/README.md +53 -18
- package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
- package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
- package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
- package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
- package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
- package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
- package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
- package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
- package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
- package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
- package/.pi/harnesses/agent-hub/delegate.ts +19 -2
- package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
- package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.pi/harnesses/agent-hub/helpers.ts +5 -1
- package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
- package/.pi/harnesses/agent-hub/index.ts +145 -14
- package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
- package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
- package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
- package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
- package/.pi/harnesses/agent-hub/spawn.ts +61 -7
- package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
- package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +176 -26
- package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
- package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
- package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
- package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
- package/.pi/harnesses/agent-hub/types.ts +2 -0
- package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
- package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/index.ts +9 -0
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.11/.pi/extensions/package.json +9 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.11/.version +1 -0
- package/.versions/2.0.11/agents/architect.md +25 -0
- package/.versions/2.0.11/agents/bowser.md +28 -0
- package/.versions/2.0.11/agents/builder.md +56 -0
- package/.versions/2.0.11/agents/code-reviewer.md +210 -0
- package/.versions/2.0.11/agents/deep-researcher.md +33 -0
- package/.versions/2.0.11/agents/documenter.md +23 -0
- package/.versions/2.0.11/agents/orchestrator.md +23 -0
- package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.11/agents/planner.md +106 -0
- package/.versions/2.0.11/agents/releaser.md +25 -0
- package/.versions/2.0.11/agents/researcher.md +31 -0
- package/.versions/2.0.11/agents/security-auditor.md +168 -0
- package/.versions/2.0.11/agents/test-engineer.md +154 -0
- package/.versions/2.0.11/agents/web-debugger.md +44 -0
- package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
- package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
- package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
- package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.11/docs/getting-started.md +126 -0
- package/.versions/2.0.11/docs/npm-install.md +383 -0
- package/.versions/2.0.11/docs/pi-extensions.md +449 -0
- package/.versions/2.0.11/docs/pi-setup.md +92 -0
- package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.11/install-manifest.json +3020 -0
- package/.versions/2.0.11/justfile +247 -0
- package/.versions/2.0.11/manifest-meta.json +970 -0
- package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.11/references/communication-contract.md +26 -0
- package/.versions/2.0.11/references/definition-of-done.md +67 -0
- package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.11/references/observability-checklist.md +92 -0
- package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.11/references/performance-checklist.md +236 -0
- package/.versions/2.0.11/references/prompting-patterns.md +380 -0
- package/.versions/2.0.11/references/security-checklist.md +245 -0
- package/.versions/2.0.11/references/testing-patterns.md +235 -0
- package/.versions/2.0.11/references/workflow-authoring.md +304 -0
- package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +8 -0
- package/README.md +1 -0
- package/bin/catalog/harness-runtime-closure.json +29 -0
- package/bin/cli.js +15 -4
- package/bin/lib/doctor.js +83 -1
- package/docs/ARCHITECTURE.md +181 -2
- package/docs/workflows.md +8 -2
- package/install-manifest.json +31 -2
- package/package.json +2 -2
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import { closeSync, existsSync, fsyncSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
|
|
2
|
+
import { basename, dirname, join } from "node:path";
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
4
|
+
|
|
5
|
+
export const COMPLETION_SERIES_BUDGET_SCHEMA = "agent-fleet.completion-series-budget/v2" as const;
|
|
6
|
+
export const COMPLETION_SERIES_BUDGET_V1_SCHEMA = "agent-fleet.completion-series-budget/v1" as const;
|
|
7
|
+
export const COMPLETION_SERIES_LOCK_SCHEMA = "agent-fleet.completion-series-lock/v1" as const;
|
|
8
|
+
export type CompletionSeriesStage = "diagnostic" | "benchmark";
|
|
9
|
+
|
|
10
|
+
export interface CompletionSeriesLimits {
|
|
11
|
+
seriesRequestLimit: 60;
|
|
12
|
+
stageRequestLimits: { diagnostic: 12; benchmark: 48 };
|
|
13
|
+
inputTokensPerRequest: 16384;
|
|
14
|
+
outputTokensPerRequest: 2048;
|
|
15
|
+
requestTimeoutMs: 180000;
|
|
16
|
+
maxActiveRequests: 1;
|
|
17
|
+
maxRequestsPerUnit: { diagnostic: 2; benchmark: 4 };
|
|
18
|
+
autoRetry: false;
|
|
19
|
+
fallback: false;
|
|
20
|
+
}
|
|
21
|
+
export interface CompletionReservation {
|
|
22
|
+
sequence: number; stage: CompletionSeriesStage; startedAt: string;
|
|
23
|
+
}
|
|
24
|
+
export interface CompletionSeriesState {
|
|
25
|
+
schema: typeof COMPLETION_SERIES_BUDGET_SCHEMA;
|
|
26
|
+
seriesId: string;
|
|
27
|
+
seriesRequestsStarted: number;
|
|
28
|
+
stages: { diagnostic: { requestsStarted: number }; benchmark: { requestsStarted: number } };
|
|
29
|
+
reservationHistory: CompletionReservation[];
|
|
30
|
+
cancelled: boolean;
|
|
31
|
+
limits: CompletionSeriesLimits;
|
|
32
|
+
}
|
|
33
|
+
export interface CompletionSeriesLock {
|
|
34
|
+
schema: typeof COMPLETION_SERIES_LOCK_SCHEMA; ownerId: string; pid: number; acquiredAt: string;
|
|
35
|
+
}
|
|
36
|
+
export interface CountingProvenance {
|
|
37
|
+
method: "serialized-provider-payload-utf8-bytes-times-2-plus-1024/v1";
|
|
38
|
+
count: number; serializedBytes: number; multiplier: 2; reservedTokens: 1024;
|
|
39
|
+
unit: "conservative-token-upper-bound"; cap: number; textOnly: true;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export class CompletionBudgetRefusal extends Error {
|
|
43
|
+
readonly reason: "cancelled" | "series-exhausted" | "stage-exhausted" | "probe-exhausted" | "lock-not-owned";
|
|
44
|
+
constructor(reason: CompletionBudgetRefusal["reason"], message: string) { super(message); this.name = "CompletionBudgetRefusal"; this.reason = reason; }
|
|
45
|
+
}
|
|
46
|
+
export class CompletionSeriesBusyError extends Error { constructor(message = "completion series is busy in another process") { super(message); this.name = "CompletionSeriesBusyError"; } }
|
|
47
|
+
|
|
48
|
+
export const T12_SERIES_LIMITS: CompletionSeriesLimits = Object.freeze({
|
|
49
|
+
seriesRequestLimit: 60,
|
|
50
|
+
stageRequestLimits: Object.freeze({ diagnostic: 12, benchmark: 48 }),
|
|
51
|
+
inputTokensPerRequest: 16384,
|
|
52
|
+
outputTokensPerRequest: 2048,
|
|
53
|
+
requestTimeoutMs: 180_000,
|
|
54
|
+
maxActiveRequests: 1,
|
|
55
|
+
maxRequestsPerUnit: Object.freeze({ diagnostic: 2, benchmark: 4 }),
|
|
56
|
+
autoRetry: false,
|
|
57
|
+
fallback: false,
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
export function sharedCompletionSeriesBudgetPath(sessionDir: string, seriesId: string): string {
|
|
61
|
+
if (!/^[A-Za-z0-9._-]{1,80}$/.test(seriesId)) throw new Error("invalid completion series identity");
|
|
62
|
+
const sessionsDir = dirname(sessionDir);
|
|
63
|
+
if (basename(sessionsDir) !== "sessions") throw new Error("managed session path is not under the runtime sessions directory");
|
|
64
|
+
return join(dirname(sessionsDir), "series", `${seriesId}-budget.json`);
|
|
65
|
+
}
|
|
66
|
+
export function completionSeriesLockPath(budgetPath: string): string { return `${budgetPath}.lock`; }
|
|
67
|
+
export function createCompletionSeriesState(seriesId: string, limits: CompletionSeriesLimits = T12_SERIES_LIMITS): CompletionSeriesState {
|
|
68
|
+
if (!seriesId.trim()) throw new Error("seriesId is required");
|
|
69
|
+
return { schema: COMPLETION_SERIES_BUDGET_SCHEMA, seriesId, seriesRequestsStarted: 0, stages: { diagnostic: { requestsStarted: 0 }, benchmark: { requestsStarted: 0 } }, reservationHistory: [], cancelled: false, limits: structuredClone(limits) };
|
|
70
|
+
}
|
|
71
|
+
function isStage(value: unknown): value is CompletionSeriesStage { return value === "diagnostic" || value === "benchmark"; }
|
|
72
|
+
function safeCount(value: unknown): value is number { return Number.isSafeInteger(value) && Number(value) >= 0; }
|
|
73
|
+
function validateV2(value: any): CompletionSeriesState {
|
|
74
|
+
if (value?.schema !== COMPLETION_SERIES_BUDGET_SCHEMA || typeof value.seriesId !== "string" || !safeCount(value.seriesRequestsStarted)
|
|
75
|
+
|| !safeCount(value?.stages?.diagnostic?.requestsStarted) || !safeCount(value?.stages?.benchmark?.requestsStarted)
|
|
76
|
+
|| !Array.isArray(value.reservationHistory) || typeof value.cancelled !== "boolean") throw new Error("invalid completion-series budget state");
|
|
77
|
+
if (value.stages.diagnostic.requestsStarted + value.stages.benchmark.requestsStarted !== value.seriesRequestsStarted) throw new Error("completion-series counters do not reconcile");
|
|
78
|
+
if (value.reservationHistory.length !== value.seriesRequestsStarted || value.reservationHistory.some((entry: any, index: number) => entry?.sequence !== index + 1 || !isStage(entry?.stage) || typeof entry?.startedAt !== "string")) throw new Error("completion-series reservation history does not reconcile");
|
|
79
|
+
return value;
|
|
80
|
+
}
|
|
81
|
+
export function readCompletionSeriesState(path: string): CompletionSeriesState {
|
|
82
|
+
return validateV2(JSON.parse(readFileSync(path, "utf8")));
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Migrate only when every consumed request has explicit stage provenance.
|
|
87
|
+
* Old zero-use ledgers are unambiguous; nonzero aggregate-only v1 ledgers fail closed.
|
|
88
|
+
*/
|
|
89
|
+
export function migrateCompletionSeriesBudget(path: string): CompletionSeriesState {
|
|
90
|
+
const raw = JSON.parse(readFileSync(path, "utf8"));
|
|
91
|
+
if (raw?.schema === COMPLETION_SERIES_BUDGET_SCHEMA) return validateV2(raw);
|
|
92
|
+
if (raw?.schema !== COMPLETION_SERIES_BUDGET_V1_SCHEMA || typeof raw.seriesId !== "string" || !safeCount(raw.seriesRequestsStarted) || !safeCount(raw.stageRequestsStarted)) throw new Error("invalid completion-series budget state");
|
|
93
|
+
const history = Array.isArray(raw.reservationHistory) ? raw.reservationHistory : [];
|
|
94
|
+
if (raw.seriesRequestsStarted !== raw.stageRequestsStarted) throw new Error("ambiguous v1 completion-series allocation; refusing migration");
|
|
95
|
+
if (raw.seriesRequestsStarted > 0 && (history.length !== raw.seriesRequestsStarted || history.some((entry: any) => !isStage(entry?.stage) || typeof entry?.startedAt !== "string"))) throw new Error("ambiguous v1 completion-series allocation; refusing migration");
|
|
96
|
+
const migrated = createCompletionSeriesState(raw.seriesId);
|
|
97
|
+
migrated.cancelled = raw.cancelled === true;
|
|
98
|
+
for (const [index, entry] of history.entries()) {
|
|
99
|
+
const stage = entry.stage as CompletionSeriesStage;
|
|
100
|
+
migrated.seriesRequestsStarted++;
|
|
101
|
+
migrated.stages[stage].requestsStarted++;
|
|
102
|
+
migrated.reservationHistory.push({ sequence: index + 1, stage, startedAt: entry.startedAt });
|
|
103
|
+
}
|
|
104
|
+
writeCompletionSeriesState(path, migrated);
|
|
105
|
+
return migrated;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** Crash-safe replacement: a provider request is sent only after this durable rename completes. */
|
|
109
|
+
export function writeCompletionSeriesState(path: string, state: CompletionSeriesState): void {
|
|
110
|
+
const validated = validateV2(state);
|
|
111
|
+
const temporary = `${path}.tmp-${process.pid}-${randomUUID()}`;
|
|
112
|
+
let fd: number | undefined;
|
|
113
|
+
try {
|
|
114
|
+
fd = openSync(temporary, "wx", 0o600);
|
|
115
|
+
writeSync(fd, JSON.stringify(validated, null, 2)); fsyncSync(fd); closeSync(fd); fd = undefined;
|
|
116
|
+
renameSync(temporary, path);
|
|
117
|
+
try { const dirFd = openSync(dirname(path), "r"); try { fsyncSync(dirFd); } finally { closeSync(dirFd); } } catch {}
|
|
118
|
+
} finally { if (fd !== undefined) closeSync(fd); try { unlinkSync(temporary); } catch {} }
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export function acquireCompletionSeriesLock(lockPath: string, ownerId = randomUUID()): CompletionSeriesLock {
|
|
122
|
+
const lock: CompletionSeriesLock = { schema: COMPLETION_SERIES_LOCK_SCHEMA, ownerId, pid: process.pid, acquiredAt: new Date().toISOString() };
|
|
123
|
+
let fd: number;
|
|
124
|
+
try { fd = openSync(lockPath, "wx", 0o600); }
|
|
125
|
+
catch (error: any) { if (error?.code === "EEXIST") throw new CompletionSeriesBusyError(); throw error; }
|
|
126
|
+
try { writeSync(fd, JSON.stringify(lock)); fsyncSync(fd); } catch (error) { try { unlinkSync(lockPath); } catch {} throw error; } finally { closeSync(fd); }
|
|
127
|
+
return lock;
|
|
128
|
+
}
|
|
129
|
+
export function readCompletionSeriesLock(lockPath: string): CompletionSeriesLock | null {
|
|
130
|
+
try { const value = JSON.parse(readFileSync(lockPath, "utf8")); return value?.schema === COMPLETION_SERIES_LOCK_SCHEMA && typeof value.ownerId === "string" && Number.isSafeInteger(value.pid) ? value : null; }
|
|
131
|
+
catch { return null; }
|
|
132
|
+
}
|
|
133
|
+
export function releaseOwnedCompletionSeriesLock(lockPath: string, ownerId: string): void {
|
|
134
|
+
const lock = readCompletionSeriesLock(lockPath);
|
|
135
|
+
if (!lock || lock.ownerId !== ownerId) throw new Error("completion-series lock ownership changed; refusing release");
|
|
136
|
+
unlinkSync(lockPath);
|
|
137
|
+
}
|
|
138
|
+
function processAlive(pid: number): boolean { try { process.kill(pid, 0); return true; } catch (error: any) { return error?.code !== "ESRCH"; } }
|
|
139
|
+
/** Human-only crash recovery. Never expires automatically and never releases a live owner. */
|
|
140
|
+
export function releaseCrashedCompletionSeriesLock(lockPath: string): "released" | "absent" {
|
|
141
|
+
if (!existsSync(lockPath)) return "absent";
|
|
142
|
+
const lock = readCompletionSeriesLock(lockPath);
|
|
143
|
+
if (lock && processAlive(lock.pid)) throw new CompletionSeriesBusyError(`completion series is owned by live pid ${lock.pid}`);
|
|
144
|
+
unlinkSync(lockPath); return "released";
|
|
145
|
+
}
|
|
146
|
+
function assertLockOwner(lockPath: string, ownerId: string): void {
|
|
147
|
+
const lock = readCompletionSeriesLock(lockPath);
|
|
148
|
+
if (!lock || lock.ownerId !== ownerId) throw new CompletionBudgetRefusal("lock-not-owned", "completion-series lock is not owned by this run");
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/** Reserve durably immediately before provider transport. Failed started completions remain charged. */
|
|
152
|
+
export function reserveCompletionRequest(path: string, unitRequestsStarted: number, lockPath: string, ownerId: string, stage: CompletionSeriesStage): CompletionSeriesState {
|
|
153
|
+
assertLockOwner(lockPath, ownerId);
|
|
154
|
+
const state = readCompletionSeriesState(path);
|
|
155
|
+
if (state.cancelled) throw new CompletionBudgetRefusal("cancelled", "completion series is fenced after cancellation");
|
|
156
|
+
if (state.seriesRequestsStarted >= state.limits.seriesRequestLimit) throw new CompletionBudgetRefusal("series-exhausted", "whole-series provider request budget exhausted");
|
|
157
|
+
if (state.stages[stage].requestsStarted >= state.limits.stageRequestLimits[stage]) throw new CompletionBudgetRefusal("stage-exhausted", `${stage}-stage provider request budget exhausted`);
|
|
158
|
+
if (unitRequestsStarted >= state.limits.maxRequestsPerUnit[stage]) throw new CompletionBudgetRefusal("probe-exhausted", `${stage} unit provider request budget exhausted`);
|
|
159
|
+
const next = structuredClone(state);
|
|
160
|
+
next.seriesRequestsStarted++;
|
|
161
|
+
next.stages[stage].requestsStarted++;
|
|
162
|
+
next.reservationHistory.push({ sequence: next.seriesRequestsStarted, stage, startedAt: new Date().toISOString() });
|
|
163
|
+
writeCompletionSeriesState(path, next); return next;
|
|
164
|
+
}
|
|
165
|
+
export function fenceCompletionSeries(path: string, lockPath: string, ownerId: string): CompletionSeriesState {
|
|
166
|
+
assertLockOwner(lockPath, ownerId);
|
|
167
|
+
const state = readCompletionSeriesState(path), next = { ...state, cancelled: true };
|
|
168
|
+
writeCompletionSeriesState(path, next); return next;
|
|
169
|
+
}
|
|
170
|
+
export function conservativeTextInputPreflight(payload: unknown, cap: number): CountingProvenance {
|
|
171
|
+
const serialized = JSON.stringify(payload);
|
|
172
|
+
if (serialized === undefined) throw new Error("provider payload cannot be serialized for input preflight");
|
|
173
|
+
const serializedBytes = Buffer.byteLength(serialized, "utf8");
|
|
174
|
+
const count = serializedBytes * 2 + 1024;
|
|
175
|
+
const provenance: CountingProvenance = { method: "serialized-provider-payload-utf8-bytes-times-2-plus-1024/v1", count, serializedBytes, multiplier: 2, reservedTokens: 1024, unit: "conservative-token-upper-bound", cap, textOnly: true };
|
|
176
|
+
if (count > cap) throw new Error(`provider payload conservative upper bound ${count} exceeds ${cap} input-token cap`);
|
|
177
|
+
return provenance;
|
|
178
|
+
}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import type { NativeDispatchResult, NativeExecutionDiagnostics, NativeSpawnOutcome, PreparedNativeRun } from "./dispatch-native-types.ts";
|
|
2
|
+
import { boundOutput } from "./deterministic-fs.ts";
|
|
3
|
+
import { safePathWithin } from "./helpers.ts";
|
|
2
4
|
|
|
3
5
|
export async function completeNativeRun(run: PreparedNativeRun, outcome: NativeSpawnOutcome): Promise<NativeDispatchResult> {
|
|
4
6
|
const { deps, state, ctx, histEntry, monitorStart, startTime, key, agentKey } = run;
|
|
@@ -12,14 +14,20 @@ export async function completeNativeRun(run: PreparedNativeRun, outcome: NativeS
|
|
|
12
14
|
reason: res.spawnError ? "spawn_error" : res.termination?.reason ?? (state.killedByOperator ? "operator_cancelled" : res.assistantError ? "assistant_error" : res.exitCode !== 0 ? "exit_code" : null),
|
|
13
15
|
processExitCode: res.exitCode,
|
|
14
16
|
assistantError: res.assistantError ?? null, stderr: res.stderr, spawnError: res.spawnError ?? null,
|
|
15
|
-
modelUsed: res.modelUsed ?? null,
|
|
17
|
+
modelUsed: res.modelUsed ?? null,
|
|
18
|
+
effectiveTools: run.effectiveTools.split(",").map(tool => tool.trim()).filter(Boolean),
|
|
19
|
+
toolCallsStarted: res.toolCallsStarted ?? null,
|
|
16
20
|
termination: res.termination ?? null, modelFallback: res.modelFallback ?? null,
|
|
17
21
|
};
|
|
18
22
|
const diagnosticText = diagnostics.reason ? formatDiagnostics(diagnostics) : "";
|
|
19
|
-
const finish = (result: NativeDispatchResult): NativeDispatchResult =>
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
+
const finish = (result: NativeDispatchResult): NativeDispatchResult => {
|
|
24
|
+
const combined = result.output + diagnosticText;
|
|
25
|
+
const parent = res.boundedOutput ? boundOutput({ content: combined, retentionDir: safePathWithin(run.evidenceDir, "bounded-output", "parent"), label: "parent-summary" }) : null;
|
|
26
|
+
return {
|
|
27
|
+
...result, runtimeTests: res.runtimeTests, toolEvents: res.toolEvents, writeIsolation: res.writeIsolation, dispatchId: run.dispatchId, transcriptPath: run.transcriptPath, diagnostics, sessionReset,
|
|
28
|
+
output: parent?.reply ?? combined,
|
|
29
|
+
};
|
|
30
|
+
};
|
|
23
31
|
if (diagnosticText) deps.appendTimelineText(state, "text", diagnosticText);
|
|
24
32
|
deps.flushTimelineStore(state);
|
|
25
33
|
|
|
@@ -110,6 +118,7 @@ export async function completeNativeRun(run: PreparedNativeRun, outcome: NativeS
|
|
|
110
118
|
state.status = code === 0 ? "done" : "error";
|
|
111
119
|
if (code === 0) {
|
|
112
120
|
state.sessionFile = run.agentSessionFile;
|
|
121
|
+
state.resumeContract = run.resumeContract;
|
|
113
122
|
state.runsSinceFresh++;
|
|
114
123
|
}
|
|
115
124
|
state.lastWork = (full || res.assistantError || res.stderr).split("\n").filter(line => line.trim()).pop() || "";
|
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { fileURLToPath } from "node:url";
|
|
2
|
+
import { profileFallback, profileChild, PROFILE_ENV } from './policy/profile-runtime.ts';
|
|
3
|
+
import { BOUNDED_OUTPUT_DIR_ENV } from './bounded-output.ts';
|
|
4
|
+
import { FILESYSTEM_SESSION_DIR_ENV } from './filesystem-tool.ts';
|
|
2
5
|
import { chmodSync, mkdirSync, existsSync, copyFileSync, unlinkSync } from "node:fs";
|
|
3
6
|
import { applyModelOverride, clampDelegateDepth, DELEGATE_TREE_SPAWN_BUDGET, fallbackModelFor, MAX_DELEGATE_DEPTH, safePathWithin } from "./helpers.ts";
|
|
4
7
|
import { contextOverflowDiagnostic, shouldRecycleSession } from "./run-budget.js";
|
|
@@ -8,8 +11,10 @@ import { requireSafetyHarness } from "./safety-routing.ts";
|
|
|
8
11
|
import { buildSpecialistContextManifest, nativeSpecialistSystemPrompt } from "../lib/context-budget-child-prompt.ts";
|
|
9
12
|
import { extractAssertionIds } from "./return-contract.js";
|
|
10
13
|
import type { NativeDispatchResult, NativeRunBase, PreparedNativeRun } from "./dispatch-native-types.ts";
|
|
14
|
+
import { bindResume, type TaskResumeInput } from "./task-resume-contract.ts";
|
|
15
|
+
import { confineNativeChild, type WriteIsolationRequest } from "./write-isolation.ts";
|
|
11
16
|
|
|
12
|
-
export async function prepareNativeRun(base: NativeRunBase,
|
|
17
|
+
export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: boolean, requestedContract?: Omit<TaskResumeInput, "previous">): Promise<PreparedNativeRun | NativeDispatchResult> {
|
|
13
18
|
const { deps, state, ctx, task, inputArtifacts, scopeGlobs, personaKey, agentKey, runNumber } = base;
|
|
14
19
|
const model = deps.resolvedModel(state.def)
|
|
15
20
|
?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
|
|
@@ -17,7 +22,25 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
17
22
|
const originalModelFallback = fallbackCandidate === model ? undefined : fallbackCandidate;
|
|
18
23
|
const agentWindow = resolveContextWindow(model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
|
|
19
24
|
const agentSessionFile = safePathWithin(base.evidenceDir, "session.json");
|
|
20
|
-
|
|
25
|
+
const resumeContract = bindResume({
|
|
26
|
+
taskId: requestedContract?.taskId ?? task,
|
|
27
|
+
instructions: requestedContract?.instructions ?? task,
|
|
28
|
+
scope: requestedContract?.scope ?? scopeGlobs,
|
|
29
|
+
deliverables: requestedContract?.deliverables,
|
|
30
|
+
artifacts: requestedContract?.artifacts ?? inputArtifacts.map(artifact => artifact.path),
|
|
31
|
+
model: requestedContract?.model ?? model,
|
|
32
|
+
permissions: requestedContract?.permissions ?? state.def.tools,
|
|
33
|
+
previous: state.resumeContract,
|
|
34
|
+
});
|
|
35
|
+
let resumeAllowed = resumeContract.resumeAllowed && !!state.sessionFile && existsSync(state.sessionFile);
|
|
36
|
+
if (resumeAllowed) copyFileSync(state.sessionFile!, agentSessionFile);
|
|
37
|
+
else if (state.sessionFile) {
|
|
38
|
+
state.sessionFile = null;
|
|
39
|
+
state.specialistManifest = undefined;
|
|
40
|
+
state.runsSinceFresh = 0;
|
|
41
|
+
state.contextPct = 0;
|
|
42
|
+
state.contextTokens = 0;
|
|
43
|
+
}
|
|
21
44
|
const turnBudget = deps.currentBudget();
|
|
22
45
|
let sessionRecycled = false;
|
|
23
46
|
|
|
@@ -28,6 +51,7 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
28
51
|
state.contextPct = 0;
|
|
29
52
|
state.contextTokens = 0;
|
|
30
53
|
sessionRecycled = true;
|
|
54
|
+
resumeAllowed = false;
|
|
31
55
|
deps.bumpRecycle();
|
|
32
56
|
ctx.ui.notify(`${deps.displayName(state.def.name)}: session recycled (stale context) — starting fresh`, "info");
|
|
33
57
|
} else {
|
|
@@ -46,6 +70,7 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
46
70
|
state.runsSinceFresh = 0;
|
|
47
71
|
state.contextPct = 0;
|
|
48
72
|
state.contextTokens = 0;
|
|
73
|
+
resumeAllowed = false;
|
|
49
74
|
ctx.ui.notify(`${deps.displayName(state.def.name)}: unusable session file quarantined (${health.reason}) — starting fresh`, "warning");
|
|
50
75
|
}
|
|
51
76
|
|
|
@@ -65,7 +90,14 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
65
90
|
const safety = requireSafetyHarness(safetyHarnessPath);
|
|
66
91
|
if (!safety.ok) return base.finishRun(safety.error, 1);
|
|
67
92
|
const extensions = [...safety.extensions];
|
|
68
|
-
|
|
93
|
+
const assist = base.assistSnapshot;
|
|
94
|
+
const boundedOutput = assist['bounded-output'];
|
|
95
|
+
const declaredTools = state.def.tools.split(",").map(tool => tool.trim()).filter(Boolean);
|
|
96
|
+
const deterministicTools = assist['deterministic-tools'] && (state.def.toolsExplicit !== true || declaredTools.includes("filesystem"));
|
|
97
|
+
if (boundedOutput) extensions.push(fileURLToPath(new URL("./bounded-output.ts", import.meta.url)));
|
|
98
|
+
if (deterministicTools) extensions.push(fileURLToPath(new URL("./filesystem-tool.ts", import.meta.url)));
|
|
99
|
+
if (declaredTools.includes("bash")) extensions.push(fileURLToPath(new URL("./runtime-test-check.ts", import.meta.url)));
|
|
100
|
+
let effectiveTools = deterministicTools && !declaredTools.includes("filesystem") ? `${state.def.tools},filesystem` : state.def.tools;
|
|
69
101
|
let delegateEnv: Record<string, string> | undefined;
|
|
70
102
|
if (delegationActive) {
|
|
71
103
|
const delegationDir = safePathWithin(base.evidenceDir, "delegations");
|
|
@@ -81,20 +113,24 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
81
113
|
depth: clampDelegateDepth(state.def.delegateDepth ?? MAX_DELEGATE_DEPTH),
|
|
82
114
|
callBudget: DELEGATE_TREE_SPAWN_BUDGET,
|
|
83
115
|
remainingSpawns: DELEGATE_TREE_SPAWN_BUDGET,
|
|
84
|
-
parentTools:
|
|
116
|
+
parentTools: effectiveTools,
|
|
85
117
|
personaPrompt: state.def.systemPrompt,
|
|
86
118
|
eventDir: delegationDir,
|
|
87
119
|
damageControl: safetyHarnessPath || undefined,
|
|
88
120
|
delegateExt: delegateExtPath,
|
|
89
121
|
reconSearchTimeoutMs: deps.getReconSearchTimeoutMs(),
|
|
90
122
|
turnDeadlineMs: turnBudget.agentTurnMs,
|
|
123
|
+
boundedOutput,
|
|
124
|
+
boundedOutputDir: safePathWithin(base.evidenceDir, "delegations", "bounded-output"),
|
|
125
|
+
deterministicTools,
|
|
126
|
+
filesystemSessionDir: base.sessionDir,
|
|
91
127
|
cwd: ctx.cwd || process.cwd(),
|
|
92
128
|
}),
|
|
93
129
|
};
|
|
94
130
|
deps.startDelegationWatch(state, delegationDir);
|
|
95
131
|
}
|
|
96
132
|
|
|
97
|
-
const manifest =
|
|
133
|
+
const manifest = resumeAllowed && state.specialistManifest
|
|
98
134
|
? state.specialistManifest
|
|
99
135
|
: buildSpecialistContextManifest({
|
|
100
136
|
personaName: state.def.name,
|
|
@@ -113,6 +149,28 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
113
149
|
const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
|
|
114
150
|
const wantThinking = thinkingLevel !== "off";
|
|
115
151
|
const runPrompt = deps.appendDeclaredScope(deps.appendInputArtifacts(task, inputArtifacts), scopeGlobs);
|
|
152
|
+
let writeIsolation: WriteIsolationRequest | undefined;
|
|
153
|
+
let writeIsolationPolicy;
|
|
154
|
+
if (assist['write-isolation']) {
|
|
155
|
+
const artifactRoot = safePathWithin(base.sessionDir, "artifacts");
|
|
156
|
+
const tempRoot = safePathWithin(base.evidenceDir, "runtime-tmp");
|
|
157
|
+
mkdirSync(artifactRoot, { recursive: true, mode: 0o700 });
|
|
158
|
+
mkdirSync(tempRoot, { recursive: true, mode: 0o700 });
|
|
159
|
+
writeIsolation = {
|
|
160
|
+
enabled: true,
|
|
161
|
+
cwd: ctx.cwd || process.cwd(),
|
|
162
|
+
allowlist: [...scopeGlobs],
|
|
163
|
+
runtimePaths: [base.evidenceDir],
|
|
164
|
+
artifactPaths: [artifactRoot],
|
|
165
|
+
tempPaths: [tempRoot],
|
|
166
|
+
};
|
|
167
|
+
writeIsolationPolicy = confineNativeChild(writeIsolation);
|
|
168
|
+
if (!writeIsolationPolicy.applied) return base.finishRun(`Write isolation refused: ${writeIsolationPolicy.reason ?? "native backend unavailable"}. No unsandboxed child was started.`, 1);
|
|
169
|
+
writeIsolation.backend = writeIsolationPolicy.mechanism;
|
|
170
|
+
writeIsolation.backendPath = writeIsolationPolicy.command;
|
|
171
|
+
delegateEnv = { ...delegateEnv, TMPDIR: tempRoot, TMP: tempRoot, TEMP: tempRoot };
|
|
172
|
+
}
|
|
173
|
+
if (base.activeProfileSnapshot) delegateEnv = { ...delegateEnv, [PROFILE_ENV]: JSON.stringify(base.activeProfileSnapshot) };
|
|
116
174
|
|
|
117
175
|
if (state.sessionFile && !sessionRecycled) {
|
|
118
176
|
const overflow = shouldRecycleBeforeSpawn({
|
|
@@ -127,6 +185,7 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
127
185
|
state.contextPct = 0;
|
|
128
186
|
state.contextTokens = 0;
|
|
129
187
|
sessionRecycled = true;
|
|
188
|
+
resumeAllowed = false;
|
|
130
189
|
deps.bumpRecycle();
|
|
131
190
|
ctx.ui.notify(
|
|
132
191
|
`${deps.displayName(state.def.name)}: session recycled before spawn — ${overflow.message}. ` +
|
|
@@ -147,9 +206,17 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
|
|
|
147
206
|
sessionReset,
|
|
148
207
|
effectiveTools,
|
|
149
208
|
extensions,
|
|
150
|
-
delegateEnv
|
|
209
|
+
delegateEnv: {
|
|
210
|
+
...delegateEnv,
|
|
211
|
+
...(boundedOutput ? { [BOUNDED_OUTPUT_DIR_ENV]: safePathWithin(base.evidenceDir, "bounded-output") } : {}),
|
|
212
|
+
...(deterministicTools ? { [FILESYSTEM_SESSION_DIR_ENV]: base.sessionDir } : {}),
|
|
213
|
+
},
|
|
214
|
+
writeIsolation,
|
|
215
|
+
writeIsolationPolicy,
|
|
151
216
|
thinkingLevel,
|
|
152
217
|
wantThinking,
|
|
218
|
+
resumeContract,
|
|
219
|
+
resumeAllowed,
|
|
153
220
|
replacementSystemPrompt,
|
|
154
221
|
runPrompt,
|
|
155
222
|
};
|
|
@@ -138,18 +138,22 @@ function createSpawnCallbacks(run: PreparedNativeRun, drift: DriftRuntime, usage
|
|
|
138
138
|
export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeSpawnOutcome> {
|
|
139
139
|
const { deps, state, ctx, model, effectiveTools, thinkingLevel, replacementSystemPrompt, agentSessionFile, runPrompt, extensions, delegateEnv, turnBudget, personaKey, originalModelFallback } = run;
|
|
140
140
|
const spawnOptions: SpawnPiAgentOptions = {
|
|
141
|
+
runtimeTestObserver: extensions.some(path => path.endsWith("/runtime-test-check.ts")),
|
|
141
142
|
model,
|
|
143
|
+
activeProfileSnapshot: run.activeProfileSnapshot,
|
|
144
|
+
writeIsolation: run.writeIsolation,
|
|
142
145
|
tools: effectiveTools,
|
|
143
146
|
thinking: thinkingLevel,
|
|
144
147
|
systemPrompt: replacementSystemPrompt,
|
|
145
148
|
noSkills: true,
|
|
146
149
|
noContextFiles: true,
|
|
147
150
|
sessionFile: agentSessionFile,
|
|
148
|
-
resume:
|
|
151
|
+
resume: run.resumeAllowed,
|
|
149
152
|
prompt: runPrompt,
|
|
150
153
|
cwd: ctx.cwd || process.cwd(),
|
|
151
154
|
extensions,
|
|
152
155
|
env: { ...deps.guardrailEnv(run.agentKey), ...(delegateEnv || {}) },
|
|
156
|
+
...(delegateEnv?.AGENT_FLEET_BOUNDED_OUTPUT_DIR ? { boundedOutputDir: delegateEnv.AGENT_FLEET_BOUNDED_OUTPUT_DIR } : {}),
|
|
153
157
|
detached: true,
|
|
154
158
|
...(RESEARCHER_PERSONAS.has(personaKey) ? { toolWatchdog: { timeoutMs: deps.getReconSearchTimeoutMs() } } : {}),
|
|
155
159
|
turnDeadlineMs: turnBudget.agentTurnMs,
|
|
@@ -8,6 +8,10 @@ import type { TimelineEntry } from "./ui/zoom.ts";
|
|
|
8
8
|
import type { DelegationChild, DelegationObservableState } from "./dispatch-observability.ts";
|
|
9
9
|
import type { ComsDispatchResult, DispatchInputArtifactPreview } from "./dispatch-coms.ts";
|
|
10
10
|
import type { PiRunControl, SpawnPiAgentCallbacks, SpawnPiAgentOptions, SpawnPiAgentResult } from "./spawn.ts";
|
|
11
|
+
import type { TaskResumeContract } from "./task-resume-contract.ts";
|
|
12
|
+
import type { ResolvedAssistFlags } from "./assist-profile.ts";
|
|
13
|
+
import type { ActiveModelProfile } from "./policy/profile-runtime.ts";
|
|
14
|
+
import type { WriteIsolationRequest, WriteIsolationResult } from "./write-isolation.ts";
|
|
11
15
|
|
|
12
16
|
export type NativeBackend = "auto" | "native" | "coms";
|
|
13
17
|
|
|
@@ -53,6 +57,7 @@ export interface NativeDispatchState extends NativeTimelineTarget, DelegationObs
|
|
|
53
57
|
contextTokens: number;
|
|
54
58
|
sessionFile: string | null;
|
|
55
59
|
specialistManifest?: SpecialistContextManifest;
|
|
60
|
+
resumeContract?: TaskResumeContract;
|
|
56
61
|
runCount: number;
|
|
57
62
|
runsSinceFresh: number;
|
|
58
63
|
timer?: ReturnType<typeof setInterval>;
|
|
@@ -74,12 +79,16 @@ export interface NativeExecutionDiagnostics {
|
|
|
74
79
|
stderr: string;
|
|
75
80
|
spawnError: string | null;
|
|
76
81
|
modelUsed: string | null;
|
|
82
|
+
effectiveTools: string[];
|
|
77
83
|
toolCallsStarted: number | null;
|
|
78
84
|
termination: SpawnPiAgentResult["termination"] | null;
|
|
79
85
|
modelFallback: SpawnPiAgentResult["modelFallback"] | null;
|
|
80
86
|
}
|
|
81
87
|
|
|
82
88
|
export interface NativeDispatchResult {
|
|
89
|
+
runtimeTests?: import("./runtime-test-check.ts").RuntimeTestRecord[];
|
|
90
|
+
writeIsolation?: Pick<WriteIsolationResult, "applied" | "failClosed" | "mechanism" | "permissionExpansion" | "rollsBackUserEdits" | "protectsConcurrentUserWrites">;
|
|
91
|
+
toolEvents?: import("./tool-protocol.ts").ToolExecutionEvent[];
|
|
83
92
|
evidencePath?: string;
|
|
84
93
|
sessionPath?: string;
|
|
85
94
|
dispatchId?: string;
|
|
@@ -197,6 +206,8 @@ export interface NativeRunBase {
|
|
|
197
206
|
monitorKey: string;
|
|
198
207
|
monitorStart?: Promise<any>;
|
|
199
208
|
startTime: number;
|
|
209
|
+
assistSnapshot: ResolvedAssistFlags;
|
|
210
|
+
activeProfileSnapshot?: ActiveModelProfile;
|
|
200
211
|
finishRun(output: string, exitCode: number, options?: { idle?: boolean; pending?: boolean; notice?: string }): Promise<NativeDispatchResult>;
|
|
201
212
|
}
|
|
202
213
|
|
|
@@ -211,8 +222,12 @@ export interface PreparedNativeRun extends NativeRunBase {
|
|
|
211
222
|
effectiveTools: string;
|
|
212
223
|
extensions: string[];
|
|
213
224
|
delegateEnv?: Record<string, string>;
|
|
225
|
+
writeIsolation?: WriteIsolationRequest;
|
|
226
|
+
writeIsolationPolicy?: WriteIsolationResult;
|
|
214
227
|
thinkingLevel: string;
|
|
215
228
|
wantThinking: boolean;
|
|
229
|
+
resumeContract: TaskResumeContract;
|
|
230
|
+
resumeAllowed: boolean;
|
|
216
231
|
replacementSystemPrompt: string;
|
|
217
232
|
runPrompt: string;
|
|
218
233
|
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { profileForcesNativePeers, profilePeerGate } from './policy/profile-runtime.ts';
|
|
1
|
+
import { profileForcesNativePeers, profilePeerGate, readActiveProfile, type ActiveModelProfile } from './policy/profile-runtime.ts';
|
|
2
|
+
import { resolveAssist, type ResolvedAssistFlags } from "./assist-profile.ts";
|
|
2
3
|
import { randomUUID } from "node:crypto";
|
|
3
4
|
import { beginExecutionEvidence, finishExecutionEvidence } from "./execution-evidence.ts";
|
|
4
5
|
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
@@ -9,6 +10,7 @@ import { normalizeAgentInput, safeAgentKey, safePathWithin } from "./helpers.ts"
|
|
|
9
10
|
import { prepareNativeRun } from "./dispatch-native-prepare.ts";
|
|
10
11
|
import { runPreparedNative } from "./dispatch-native-spawn.ts";
|
|
11
12
|
import { completeNativeRun } from "./dispatch-native-complete.ts";
|
|
13
|
+
import type { TaskResumeInput } from "./task-resume-contract.ts";
|
|
12
14
|
import type {
|
|
13
15
|
DispatchInputArtifactPreview,
|
|
14
16
|
NativeBackend,
|
|
@@ -26,7 +28,10 @@ interface NativeDispatchArgs {
|
|
|
26
28
|
scopeGlobs: string[];
|
|
27
29
|
watchdogParam?: boolean;
|
|
28
30
|
requestedBackend: NativeBackend;
|
|
29
|
-
|
|
31
|
+
resumeRequested: boolean;
|
|
32
|
+
resumeContract?: Omit<TaskResumeInput, "previous">;
|
|
33
|
+
assistSnapshot: ResolvedAssistFlags;
|
|
34
|
+
activeProfileSnapshot?: ActiveModelProfile;
|
|
30
35
|
}
|
|
31
36
|
|
|
32
37
|
function missingOrRunning(deps: NativeDispatchDeps, agentName: string): NativeDispatchResult | NativeDispatchState {
|
|
@@ -40,7 +45,7 @@ function missingOrRunning(deps: NativeDispatchDeps, agentName: string): NativeDi
|
|
|
40
45
|
}
|
|
41
46
|
if (state.status === "running") {
|
|
42
47
|
return {
|
|
43
|
-
output: `
|
|
48
|
+
output: `Busy refusal: agent "${deps.displayName(state.def.name)}" is already running. Nothing was started, queued, retried, or charged; re-invoke explicitly after it is idle.`,
|
|
44
49
|
exitCode: 1,
|
|
45
50
|
elapsed: 0,
|
|
46
51
|
};
|
|
@@ -116,14 +121,19 @@ function beginNativeRun(deps: NativeDispatchDeps, state: NativeDispatchState, ar
|
|
|
116
121
|
dispatchId, transcriptPath, sessionDir, evidenceDir, deps, state, ctx, task, inputArtifacts, scopeGlobs, watchdogParam,
|
|
117
122
|
key: normalizeAgentInput(args.agentName),
|
|
118
123
|
personaKey: state.def.name.toLowerCase(),
|
|
119
|
-
agentKey, runNumber, histEntry, monitorKey, monitorStart, startTime,
|
|
124
|
+
agentKey, runNumber, histEntry, monitorKey, monitorStart, startTime,
|
|
125
|
+
assistSnapshot: args.assistSnapshot,
|
|
126
|
+
activeProfileSnapshot: args.activeProfileSnapshot,
|
|
127
|
+
finishRun,
|
|
120
128
|
};
|
|
121
129
|
}
|
|
122
130
|
|
|
123
131
|
async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend): Promise<NativeDispatchResult | null> {
|
|
124
132
|
const { deps, state, task, ctx, inputArtifacts, scopeGlobs, personaKey, monitorKey, startTime, histEntry } = run;
|
|
125
133
|
const livePeerNames = () => deps.isComsReady() && deps.getIdentity() ? deps.peersInScope().map(entry => entry.name) : [];
|
|
126
|
-
const
|
|
134
|
+
const isolationRequired = run.assistSnapshot['write-isolation'];
|
|
135
|
+
const forceNative = isolationRequired || (run.activeProfileSnapshot ? profileForcesNativePeers(run.activeProfileSnapshot) : false);
|
|
136
|
+
if (isolationRequired && requestedBackend === "coms") return run.finishRun("Write isolation is native-only; coms dispatch refused because remote isolation cannot be claimed.", 1);
|
|
127
137
|
if (forceNative && requestedBackend === 'coms') return run.finishRun('Active model profile requires native execution; coms dispatch refused.', 1);
|
|
128
138
|
const dispatchPolicy = forceNative ? { default: 'native', grace_s: 0, substitutions: {} } : deps.getDispatchPolicy();
|
|
129
139
|
let route: any = resolveDispatchBackend({ agentName: state.def.name, policy: dispatchPolicy, livePeerNames: livePeerNames(), requestedBackend });
|
|
@@ -146,7 +156,7 @@ async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend
|
|
|
146
156
|
}
|
|
147
157
|
if (route.backend === "coms") {
|
|
148
158
|
const peer = deps.peersInScope().find(entry => entry.name.toLowerCase() === String(route.peerName).toLowerCase());
|
|
149
|
-
const profileRefusal = profilePeerGate({ peerModel: peer?.model, targetResolved: !!peer });
|
|
159
|
+
const profileRefusal = run.activeProfileSnapshot ? profilePeerGate({ peerModel: peer?.model, targetResolved: !!peer }, run.activeProfileSnapshot) : null;
|
|
150
160
|
if (profileRefusal) {
|
|
151
161
|
const allowNativeFallback = !route.explicit && (dispatchPolicy.substitutions[personaKey]?.fallback ?? "native") !== "none";
|
|
152
162
|
if (!allowNativeFallback) return run.finishRun(profileRefusal.content[0].text, 1);
|
|
@@ -178,14 +188,16 @@ async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend
|
|
|
178
188
|
return null;
|
|
179
189
|
}
|
|
180
190
|
|
|
181
|
-
async function dispatchNative(deps: NativeDispatchDeps, args: NativeDispatchArgs): Promise<NativeDispatchResult> {
|
|
191
|
+
async function dispatchNative(deps: NativeDispatchDeps, args: Omit<NativeDispatchArgs, "assistSnapshot" | "activeProfileSnapshot">): Promise<NativeDispatchResult> {
|
|
192
|
+
const activeProfileSnapshot = readActiveProfile();
|
|
193
|
+
const effectiveArgs: NativeDispatchArgs = { ...args, activeProfileSnapshot, assistSnapshot: resolveAssist(activeProfileSnapshot?.profile.assist) };
|
|
182
194
|
const found = missingOrRunning(deps, args.agentName);
|
|
183
195
|
if (!("def" in found)) return found;
|
|
184
|
-
const run = beginNativeRun(deps, found,
|
|
196
|
+
const run = beginNativeRun(deps, found, effectiveArgs);
|
|
185
197
|
const execute = async () => {
|
|
186
198
|
const routed = await routeDispatch(run, args.requestedBackend);
|
|
187
199
|
if (routed) return routed;
|
|
188
|
-
const prepared = await prepareNativeRun(run, args.
|
|
200
|
+
const prepared = await prepareNativeRun(run, args.resumeRequested, args.resumeContract);
|
|
189
201
|
if ("output" in prepared) return prepared;
|
|
190
202
|
const outcome = await runPreparedNative(prepared);
|
|
191
203
|
return { ...await completeNativeRun(prepared, outcome), sessionPath: prepared.agentSessionFile };
|
|
@@ -207,7 +219,8 @@ export function createDispatchNative(deps: NativeDispatchDeps) {
|
|
|
207
219
|
scopeGlobs: string[] = [],
|
|
208
220
|
watchdogParam?: boolean,
|
|
209
221
|
requestedBackend: NativeBackend = "auto",
|
|
210
|
-
|
|
211
|
-
|
|
222
|
+
resumeRequested = false,
|
|
223
|
+
resumeContract?: Omit<TaskResumeInput, "previous">,
|
|
224
|
+
) => dispatchNative(deps, { agentName, task, ctx, inputArtifacts, scopeGlobs, watchdogParam, requestedBackend, resumeRequested, resumeContract }),
|
|
212
225
|
};
|
|
213
226
|
}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
import { Type } from "@sinclair/typebox";
|
|
3
|
+
import { existsSync, lstatSync, realpathSync } from "node:fs";
|
|
4
|
+
import { isAbsolute, relative, resolve } from "node:path";
|
|
5
|
+
import { excerpt, inventory, PathOutsideAllowedRootError, readback, snapshotSource } from "./deterministic-fs.ts";
|
|
6
|
+
import { readActiveProfile } from "./policy/profile-runtime.ts";
|
|
7
|
+
import { resolveAssist } from "./assist-profile.ts";
|
|
8
|
+
|
|
9
|
+
export const FILESYSTEM_SESSION_DIR_ENV = "AGENT_FLEET_FILESYSTEM_SESSION_DIR";
|
|
10
|
+
|
|
11
|
+
export interface FilesystemToolPorts { enabled(): boolean; sessionDir(): string }
|
|
12
|
+
|
|
13
|
+
function workspacePath(path: string, cwd: string): string {
|
|
14
|
+
const target=resolve(cwd,path), rel=relative(cwd,target);
|
|
15
|
+
if (rel.startsWith("..") || isAbsolute(rel)) throw new Error(`Path outside current workspace: ${path}`);
|
|
16
|
+
if (existsSync(target)) {
|
|
17
|
+
const realRel=relative(realpathSync(cwd),realpathSync(target));
|
|
18
|
+
if (realRel.startsWith("..") || isAbsolute(realRel)) throw new Error(`Symlink escape outside current workspace: ${path}`);
|
|
19
|
+
}
|
|
20
|
+
return target;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
function result(value: any) {
|
|
24
|
+
const normalized = value?.content && Buffer.isBuffer(value.content)
|
|
25
|
+
? { ...value, content: value.content.toString("utf8"), contentEncoding: "utf8", exactBytesOnDisk: value.path }
|
|
26
|
+
: value;
|
|
27
|
+
return { content: [{ type: "text" as const, text: JSON.stringify(normalized) }], details: { result: normalized } };
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function registerFilesystemTool(pi: ExtensionAPI, ports: FilesystemToolPorts): void {
|
|
31
|
+
pi.registerTool({
|
|
32
|
+
name: "filesystem",
|
|
33
|
+
label: "Deterministic Filesystem",
|
|
34
|
+
description: "Deterministically inventory or excerpt repository files, read back an opaque handle, or snapshot a local source into this session's managed untrusted artifacts. No network or model delegation.",
|
|
35
|
+
parameters: Type.Object({
|
|
36
|
+
operation: Type.Union([Type.Literal("inventory"),Type.Literal("excerpt"),Type.Literal("readback"),Type.Literal("snapshot")]),
|
|
37
|
+
path: Type.Optional(Type.String({description:"Local path inside the current workspace; required except for readback."})),
|
|
38
|
+
handle: Type.Optional(Type.String({description:"Opaque handle returned by inventory, excerpt, snapshot, or prior readback."})),
|
|
39
|
+
origin: Type.Optional(Type.Literal("file",{description:"Snapshots accept local file sources only."})),
|
|
40
|
+
page_size: Type.Optional(Type.Integer({minimum:1})),
|
|
41
|
+
max_bytes: Type.Optional(Type.Integer({minimum:1})),
|
|
42
|
+
}, { additionalProperties: false }),
|
|
43
|
+
async execute(_id, raw, _signal, _update, ctx) {
|
|
44
|
+
if (!ports.enabled()) throw new Error("filesystem is disabled by the effective profile; set assist.deterministic-tools=true");
|
|
45
|
+
const params=raw as any, cwd=resolve(ctx.cwd || process.cwd()), sessionValue=ports.sessionDir();
|
|
46
|
+
if (!sessionValue) throw new Error("filesystem requires a current managed session artifact root");
|
|
47
|
+
const session=resolve(sessionValue);
|
|
48
|
+
if (existsSync(session) && lstatSync(session).isSymbolicLink()) throw new Error("filesystem refuses a symlinked managed session root");
|
|
49
|
+
if (params.destination !== undefined) throw new Error("filesystem snapshot destination is managed and cannot be supplied");
|
|
50
|
+
switch(params.operation) {
|
|
51
|
+
case "inventory": if(!params.path) throw new Error("inventory requires path"); return result(inventory({root:workspacePath(params.path,cwd),handle:params.handle,pageSize:params.page_size,boundedOutput:true}));
|
|
52
|
+
case "excerpt": if(!params.path) throw new Error("excerpt requires path"); return result(excerpt({path:workspacePath(params.path,cwd),allowedRoot:cwd,handle:params.handle,maxBytes:params.max_bytes,boundedOutput:true}));
|
|
53
|
+
case "readback": {
|
|
54
|
+
if(!params.handle) throw new Error("readback requires handle");
|
|
55
|
+
try { return result(readback({handle:params.handle,allowedRoot:cwd,maxBytes:params.max_bytes,boundedOutput:true})); }
|
|
56
|
+
catch (error) {
|
|
57
|
+
if (!(error instanceof PathOutsideAllowedRootError)) throw error;
|
|
58
|
+
return result(readback({handle:params.handle,allowedRoot:session,maxBytes:params.max_bytes,boundedOutput:true}));
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
case "snapshot": if(params.origin!=="file" || !params.path) throw new Error("snapshot accepts a local file origin and path only"); return result(snapshotSource({origin:"file",path:workspacePath(params.path,cwd),allowedRoot:cwd,sessionDir:session}));
|
|
62
|
+
default: throw new Error("Unsupported filesystem operation");
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export default function deterministicFilesystemExtension(pi: ExtensionAPI): void {
|
|
69
|
+
registerFilesystemTool(pi, {
|
|
70
|
+
enabled: () => resolveAssist(readActiveProfile()?.profile.assist)['deterministic-tools'],
|
|
71
|
+
sessionDir: () => process.env[FILESYSTEM_SESSION_DIR_ENV] || "",
|
|
72
|
+
});
|
|
73
|
+
}
|