@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,54 @@
|
|
|
1
|
+
import { worktreeRevision } from "./scope-gate.js";
|
|
2
|
+
|
|
3
|
+
export interface RuntimeTestRecord {
|
|
4
|
+
producer: "agent-fleet.runtime-test/v1";
|
|
5
|
+
command: string;
|
|
6
|
+
exitCode: number | null;
|
|
7
|
+
beforeRevision: string;
|
|
8
|
+
afterRevision: string;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
/** Observe the existing bash operation, never execute a second command or parse output. */
|
|
12
|
+
export function instrumentBash(createTool: any, operations: any, cwd: string, revision = () => worktreeRevision(cwd, []), options: any = {}) {
|
|
13
|
+
return async (id: string, params: any, signal: any, update: any, ctx?: any) => {
|
|
14
|
+
let record: RuntimeTestRecord | undefined;
|
|
15
|
+
const tool = createTool(cwd, { ...options, operations: { ...operations, exec: async (...args: any[]) => {
|
|
16
|
+
const beforeRevision = revision();
|
|
17
|
+
const result = await operations.exec(...args);
|
|
18
|
+
if (typeof args[0] === "string" && args[0] === (options.commandPrefix ? `${options.commandPrefix}\n${params.command}` : params.command)) record = { producer: "agent-fleet.runtime-test/v1", command: params.command, exitCode: result.exitCode, beforeRevision, afterRevision: revision() };
|
|
19
|
+
return result;
|
|
20
|
+
} } });
|
|
21
|
+
try {
|
|
22
|
+
const result = await tool.execute(id, params, signal, update, ctx);
|
|
23
|
+
return { ...result, details: { ...result.details, runtimeTest: record } };
|
|
24
|
+
} catch (error) {
|
|
25
|
+
if (!record) throw error;
|
|
26
|
+
return { content: [{ type: "text", text: String(error) }], isError: true, details: { runtimeTest: record } };
|
|
27
|
+
}
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Use Pi's tool_result hook: agent-core ignores isError on resolved execute values. */
|
|
32
|
+
export function registerObservedBash(pi: any, api: any, cwd: string, options: any) {
|
|
33
|
+
const tool = api.createBashToolDefinition(cwd, options);
|
|
34
|
+
pi.registerTool({ ...tool, execute: instrumentBash(api.createBashToolDefinition, api.createLocalBashOperations({ shellPath: options.shellPath }), cwd, undefined, options) });
|
|
35
|
+
pi.on("tool_result", (event: any) => {
|
|
36
|
+
if (event.toolName === "bash" && event.details?.runtimeTest?.producer === "agent-fleet.runtime-test/v1" && event.details.runtimeTest.exitCode !== 0)
|
|
37
|
+
return { isError: true };
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** Same tool name/schema retains damage-control approval and built-in rendering. */
|
|
42
|
+
export default async function runtimeTestCheck(pi: any) {
|
|
43
|
+
const api = await import("@mariozechner/pi-coding-agent");
|
|
44
|
+
const cwd = process.cwd();
|
|
45
|
+
const settings = api.SettingsManager.create(cwd);
|
|
46
|
+
registerObservedBash(pi, api, cwd, { shellPath: settings.getShellPath(), commandPrefix: settings.getShellCommandPrefix() });
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Accept observer events only on the explicitly enabled native transport and a matching tool start. */
|
|
50
|
+
export function runtimeTestFromResult(enabled: boolean | undefined, startedCommand: string | undefined, toolName: string, result: any): RuntimeTestRecord | null {
|
|
51
|
+
const record = result?.details?.runtimeTest;
|
|
52
|
+
if (!enabled || toolName !== "bash" || record?.producer !== "agent-fleet.runtime-test/v1" || typeof record.command !== "string" || !record.command || startedCommand !== record.command || !Number.isInteger(record.exitCode) || !record.beforeRevision || !record.afterRevision || typeof record.beforeRevision !== "string" || typeof record.afterRevision !== "string") return null;
|
|
53
|
+
return { producer: "agent-fleet.runtime-test/v1", command: record.command, exitCode: record.exitCode, beforeRevision: record.beforeRevision, afterRevision: record.afterRevision };
|
|
54
|
+
}
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
import { existsSync, readFileSync, readdirSync } from "node:fs";
|
|
2
|
+
import { basename, join } from "node:path";
|
|
3
|
+
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
4
|
+
import { redactSecrets } from "../lib/fleet-transcript-store.ts";
|
|
5
|
+
import { RECOVERY_CATEGORIES, type RecoveryCategory } from "./recovery-contract.ts";
|
|
6
|
+
|
|
7
|
+
const RESULT_SCHEMA = "agent-fleet.runtime-result/v1";
|
|
8
|
+
const PROTOCOL_SCHEMA = "agent-fleet.tool-protocol-diagnostic/v1";
|
|
9
|
+
const AUDIT_STATUSES = new Set(["accepted", "not_accepted", "authorized", "authorized_once", "budget_authorized", "retry_authorized_once", "passed", "failed", "missing", "stale", "unsupported", "busy", "invalid_input", "resource_exhausted", "operator_cancelled", "verification_failed", "tool_protocol_error", "unknown_tool", "indeterminate", "completed_unverified", "unavailable"]);
|
|
10
|
+
type Availability = "available" | "unavailable";
|
|
11
|
+
type AuditKind = "refusal" | "verification" | "tool_protocol" | "budget_permission" | "retry_permission" | "human_intervention" | "process_obligation";
|
|
12
|
+
|
|
13
|
+
export interface SessionAuditEvent {
|
|
14
|
+
kind: AuditKind;
|
|
15
|
+
rootSessionId: string | null;
|
|
16
|
+
childDispatchId: string | null;
|
|
17
|
+
childSessionId: string | null;
|
|
18
|
+
snapshotId: string | null;
|
|
19
|
+
repeatCount: number;
|
|
20
|
+
category?: RecoveryCategory;
|
|
21
|
+
status: string;
|
|
22
|
+
taskId?: string | null;
|
|
23
|
+
requestId?: string | null;
|
|
24
|
+
operation?: string | null;
|
|
25
|
+
evidence: Availability;
|
|
26
|
+
risk?: "unknown" | "low" | "high";
|
|
27
|
+
scope?: "unknown" | "read-only" | "small" | "wide";
|
|
28
|
+
budgetTier?: string | null;
|
|
29
|
+
obligations?: Record<string, "satisfied" | "open" | "unsupported">;
|
|
30
|
+
appliedRuleIds?: string[];
|
|
31
|
+
currentStage?: string;
|
|
32
|
+
admissibleNextAction?: string;
|
|
33
|
+
auditScope?: string[];
|
|
34
|
+
explanation?: string;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export interface SessionAuditSummary {
|
|
38
|
+
schema: "agent-fleet.session-audit/v1";
|
|
39
|
+
readOnly: true;
|
|
40
|
+
identity: {
|
|
41
|
+
rootSessionId: string | null;
|
|
42
|
+
children: Array<{ dispatchId: string; sessionId: string | null }>;
|
|
43
|
+
snapshots: Array<{ snapshotId: string }>;
|
|
44
|
+
};
|
|
45
|
+
events: SessionAuditEvent[];
|
|
46
|
+
unavailable: string[];
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const text = (value: unknown, max = 256): string | null => typeof value === "string" && value.trim() ? value.trim().slice(0, max) : null;
|
|
50
|
+
const runtimeId = (value: unknown): string | null => { const normalized = text(value); return normalized && redactSecrets(normalized) === normalized && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/.test(normalized) ? normalized : null; };
|
|
51
|
+
const status = (value: unknown): string => { const normalized = text(value, 64); return normalized && AUDIT_STATUSES.has(normalized) ? normalized : "unavailable"; };
|
|
52
|
+
const operation = (value: unknown): string | null => { const normalized = text(value, 16); return normalized && ["dispatch", "research", "retry"].includes(normalized) ? normalized : null; };
|
|
53
|
+
const object = (value: unknown): Record<string, any> | null => value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, any> : null;
|
|
54
|
+
function readJson(path: string): Record<string, any> | null { try { return object(JSON.parse(readFileSync(path, "utf8"))); } catch { return null; } }
|
|
55
|
+
function recovery(value: unknown): RecoveryCategory | undefined { return RECOVERY_CATEGORIES.includes(value as RecoveryCategory) ? value as RecoveryCategory : undefined; }
|
|
56
|
+
function entryData(entry: unknown): { type: string | null; id: string | null; data: Record<string, any> | null; details: Record<string, any> | null } {
|
|
57
|
+
const row = object(entry), message = object(row?.message);
|
|
58
|
+
return {
|
|
59
|
+
type: text(row?.customType) ?? text(row?.type),
|
|
60
|
+
id: runtimeId(row?.id) ?? runtimeId(message?.id) ?? runtimeId(message?.toolCallId),
|
|
61
|
+
data: object(row?.data),
|
|
62
|
+
details: object(message?.details) ?? object(row?.details),
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
function runtimeResult(details: Record<string, any> | null): Record<string, any> | null {
|
|
66
|
+
const value = object(details?.runtimeResult) ?? (details?.schema === RESULT_SCHEMA ? details : null);
|
|
67
|
+
return value?.schema === RESULT_SCHEMA ? value : null;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** Build an allowlisted audit from runtime-owned records. Prompt, output, payload, paths and environment values are never copied. */
|
|
71
|
+
export function buildSessionAudit(input: { entries: readonly unknown[]; sessionDir: string }): SessionAuditSummary {
|
|
72
|
+
const unavailable = new Set<string>(), meta = readJson(join(input.sessionDir, "session.json"));
|
|
73
|
+
const rootSessionId = runtimeId(meta?.sessionId) ?? runtimeId(basename(input.sessionDir));
|
|
74
|
+
if (!meta) unavailable.add("root_session_metadata");
|
|
75
|
+
const children = new Map<string, string | null>(), snapshots = new Set<string>();
|
|
76
|
+
const rawEvents: Omit<SessionAuditEvent, "repeatCount">[] = [];
|
|
77
|
+
const add = (event: Omit<SessionAuditEvent, "repeatCount">) => rawEvents.push(event);
|
|
78
|
+
const dispatchRoot = join(input.sessionDir, "dispatches");
|
|
79
|
+
if (existsSync(dispatchRoot)) {
|
|
80
|
+
for (const dispatchPathId of readdirSync(dispatchRoot).sort()) {
|
|
81
|
+
const dispatchId = runtimeId(dispatchPathId);
|
|
82
|
+
if (!dispatchId) { unavailable.add("child_identity"); continue; }
|
|
83
|
+
const result = readJson(join(dispatchRoot, dispatchPathId, "result.json"));
|
|
84
|
+
if (!result) { unavailable.add(`child_result:${dispatchId}`); children.set(dispatchId, null); continue; }
|
|
85
|
+
const childSessionId = text(result.sessionPath) ? runtimeId(basename(String(result.sessionPath)).replace(/\.jsonl?$/i, "")) : null;
|
|
86
|
+
children.set(dispatchId, childSessionId);
|
|
87
|
+
const category = recovery(result.recoveryCategory);
|
|
88
|
+
if (category) add({ kind: "refusal", rootSessionId, childDispatchId: dispatchId, childSessionId, snapshotId: null, category, status: status(result.status), evidence: "available" });
|
|
89
|
+
if (object(result.protocolDiagnostic)?.schema === PROTOCOL_SCHEMA) add({ kind: "tool_protocol", rootSessionId, childDispatchId: dispatchId, childSessionId, snapshotId: null, category: "tool_protocol_error", status: "tool_protocol_error", evidence: "available" });
|
|
90
|
+
}
|
|
91
|
+
} else unavailable.add("child_execution_records");
|
|
92
|
+
|
|
93
|
+
for (const entry of input.entries) {
|
|
94
|
+
const record = entryData(entry), snapshotId = record.type === "compaction" || record.type === "session_compact" ? record.id : null;
|
|
95
|
+
if (snapshotId) { snapshots.add(snapshotId); continue; }
|
|
96
|
+
if (record.type === "agent-hub-process-state") {
|
|
97
|
+
const data = record.data, risk = ["unknown", "low", "high"].includes(data?.risk) ? data!.risk as "unknown" | "low" | "high" : "unknown";
|
|
98
|
+
const budgetTier = ["trivial", "small", "feature", "project"].includes(data?.budgetTier) ? data!.budgetTier : null;
|
|
99
|
+
const scope = ["unknown", "read-only", "small", "wide"].includes(data?.scope) ? data!.scope : "unknown";
|
|
100
|
+
const appliedRuleIds = Array.isArray(data?.appliedRuleIds) ? data.appliedRuleIds.filter((v: unknown) => typeof v === "string").slice(0, 8) : [];
|
|
101
|
+
const currentStage = text(data?.currentStage, 64) ?? "unavailable", admissibleNextAction = text(data?.admissibleNextAction, 160) ?? "unavailable";
|
|
102
|
+
const auditScope = Array.isArray(data?.auditScope) ? data.auditScope.filter((v: unknown) => typeof v === "string").slice(0, 64) : [];
|
|
103
|
+
const raw = object(data?.obligations), obligations: Record<string, "satisfied" | "open" | "unsupported"> = {};
|
|
104
|
+
for (const name of ["risk", "acceptance", "review", "plan"]) {
|
|
105
|
+
const item = object(raw?.[name]), value = item?.status;
|
|
106
|
+
obligations[name] = ["satisfied", "open", "unsupported"].includes(value) ? value : "unsupported";
|
|
107
|
+
}
|
|
108
|
+
add({ kind: "process_obligation", rootSessionId, childDispatchId: null, childSessionId: null, snapshotId: null,
|
|
109
|
+
status: Object.values(obligations).some(value => value !== "satisfied") ? "not_accepted" : "accepted", risk, scope, budgetTier,
|
|
110
|
+
obligations, appliedRuleIds, currentStage, admissibleNextAction, auditScope, explanation: `Risk ${risk}; scope ${scope}; budget tier ${budgetTier ?? "unavailable"} limits spend only. Open obligations: ${Object.entries(obligations).filter(([, value]) => value !== "satisfied").map(([name]) => name).join(", ") || "none"}.`, evidence: "available" });
|
|
111
|
+
continue;
|
|
112
|
+
}
|
|
113
|
+
if (record.type === "agent-hub-budget-continuation") {
|
|
114
|
+
const correlation = object(record.data?.correlation), evidence = correlation ? "available" as const : "unavailable" as const;
|
|
115
|
+
const base = { rootSessionId, childDispatchId: null, childSessionId: null, snapshotId: null, taskId: runtimeId(correlation?.task_id), requestId: runtimeId(correlation?.request_id), operation: operation(correlation?.operation), evidence };
|
|
116
|
+
add({ ...base, kind: "budget_permission", status: "authorized" });
|
|
117
|
+
add({ ...base, kind: "human_intervention", status: "budget_authorized" });
|
|
118
|
+
continue;
|
|
119
|
+
}
|
|
120
|
+
if (record.type === "agent-hub-retry-authorized") {
|
|
121
|
+
const correlation = object(record.data?.correlation), dispatchId = runtimeId(record.data?.dispatchId), evidence = correlation ? "available" as const : "unavailable" as const;
|
|
122
|
+
const base = { rootSessionId, childDispatchId: dispatchId, childSessionId: dispatchId ? children.get(dispatchId) ?? null : null, snapshotId: null, taskId: runtimeId(correlation?.taskId), requestId: runtimeId(correlation?.requestId), operation: operation(correlation?.operation), evidence };
|
|
123
|
+
add({ ...base, kind: "retry_permission", status: "authorized_once" });
|
|
124
|
+
add({ ...base, kind: "human_intervention", status: "retry_authorized_once" });
|
|
125
|
+
continue;
|
|
126
|
+
}
|
|
127
|
+
const details = record.details, result = runtimeResult(details);
|
|
128
|
+
if (!result) {
|
|
129
|
+
const category = recovery(details?.recoveryCategory);
|
|
130
|
+
if (category) {
|
|
131
|
+
const dispatchId = runtimeId(details?.dispatchId) ?? runtimeId(details?.previousDispatchId);
|
|
132
|
+
add({ kind: category === "tool_protocol_error" ? "tool_protocol" : "refusal", rootSessionId, childDispatchId: dispatchId, childSessionId: dispatchId ? children.get(dispatchId) ?? null : null, snapshotId: null, category, status: status(details?.status ?? category), evidence: "available" });
|
|
133
|
+
}
|
|
134
|
+
continue;
|
|
135
|
+
}
|
|
136
|
+
const execution = object(result.execution), verification = object(result.verification), acceptance = object(result.acceptance), task = object(result.task);
|
|
137
|
+
const dispatchId = runtimeId(execution?.dispatchId), childSessionId = dispatchId ? children.get(dispatchId) ?? null : null;
|
|
138
|
+
if (verification?.status !== "passed") add({ kind: "verification", rootSessionId, childDispatchId: dispatchId, childSessionId, snapshotId: null, status: status(verification?.status), taskId: runtimeId(task?.id), evidence: verification?.status ? "available" : "unavailable" });
|
|
139
|
+
const category = recovery(details?.recoveryCategory);
|
|
140
|
+
if (category) add({ kind: category === "tool_protocol_error" ? "tool_protocol" : "refusal", rootSessionId, childDispatchId: dispatchId, childSessionId, snapshotId: null, category, status: status(details?.status ?? acceptance?.status), taskId: runtimeId(task?.id), evidence: "available" });
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
const deduped = new Map<string, SessionAuditEvent>();
|
|
144
|
+
for (const event of rawEvents) {
|
|
145
|
+
const key = JSON.stringify([event.kind, event.rootSessionId, event.childDispatchId, event.childSessionId, event.snapshotId, event.category ?? null, event.status, event.taskId ?? null, event.requestId ?? null, event.operation ?? null, event.risk ?? null, event.scope ?? null, event.budgetTier ?? null, event.obligations ?? null, event.appliedRuleIds ?? null, event.currentStage ?? null, event.admissibleNextAction ?? null, event.auditScope ?? null]);
|
|
146
|
+
const prior = deduped.get(key);
|
|
147
|
+
if (prior) prior.repeatCount++;
|
|
148
|
+
else deduped.set(key, { ...event, repeatCount: 1 });
|
|
149
|
+
}
|
|
150
|
+
return {
|
|
151
|
+
schema: "agent-fleet.session-audit/v1", readOnly: true,
|
|
152
|
+
identity: { rootSessionId, children: [...children].map(([dispatchId, sessionId]) => ({ dispatchId, sessionId })), snapshots: [...snapshots].map(snapshotId => ({ snapshotId })) },
|
|
153
|
+
events: [...deduped.values()], unavailable: [...unavailable].sort(),
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
export function formatSessionAudit(summary: SessionAuditSummary): string { return JSON.stringify(summary, null, 2); }
|
|
158
|
+
|
|
159
|
+
export async function showSessionAudit(ctx: ExtensionContext, sessionDir: string): Promise<void> {
|
|
160
|
+
ctx.ui.notify(formatSessionAudit(buildSessionAudit({ entries: ctx.sessionManager.getEntries(), sessionDir })), "info");
|
|
161
|
+
}
|
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { runtimeTestFromResult, type RuntimeTestRecord } from "./runtime-test-check.ts";
|
|
2
|
+
import { createToolEventRecorder, type ToolExecutionEvent } from "./tool-protocol.ts";
|
|
3
|
+
import { readActiveProfile, assertProfileModel, profileFallback, withProfileWork, PROFILE_ENV, type ActiveModelProfile } from './policy/profile-runtime.ts';
|
|
4
|
+
import { confineNativeChild, type WriteIsolationRequest, type WriteIsolationResult } from "./write-isolation.ts";
|
|
2
5
|
/**
|
|
3
6
|
* spawnPiAgent — the ONE place agent-hub code spawns a headless `pi` child and
|
|
4
7
|
* parses its JSON event stream. Research helpers and read-only delegate children
|
|
@@ -7,6 +10,7 @@ import { readActiveProfile, assertProfileModel, profileFallback, withProfileWork
|
|
|
7
10
|
|
|
8
11
|
import { spawn, type ChildProcess } from "child_process";
|
|
9
12
|
import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
|
|
13
|
+
import { boundOutput } from "./deterministic-fs.ts";
|
|
10
14
|
|
|
11
15
|
export interface PiUsage {
|
|
12
16
|
input?: number;
|
|
@@ -47,6 +51,12 @@ export interface ToolWatchdogOptions {
|
|
|
47
51
|
}
|
|
48
52
|
|
|
49
53
|
export interface SpawnPiAgentOptions {
|
|
54
|
+
/** Enabled only by native preparation with the runtime observer extension. */
|
|
55
|
+
runtimeTestObserver?: boolean;
|
|
56
|
+
/** Snapshotted at dispatch start; presence prevents a mid-run profile switch changing this launch. */
|
|
57
|
+
activeProfileSnapshot?: ActiveModelProfile;
|
|
58
|
+
/** Native-only whole-process write boundary. Omission preserves the legacy launch. */
|
|
59
|
+
writeIsolation?: WriteIsolationRequest;
|
|
50
60
|
model: string;
|
|
51
61
|
tools: string;
|
|
52
62
|
thinking: string;
|
|
@@ -76,6 +86,8 @@ export interface SpawnPiAgentOptions {
|
|
|
76
86
|
* this bounds the ENTIRE run, thinking and non-watched tools included.
|
|
77
87
|
*/
|
|
78
88
|
turnDeadlineMs?: number | null;
|
|
89
|
+
/** Opt-in T5 transport bound; complete original output is retained under this directory. */
|
|
90
|
+
boundedOutputDir?: string;
|
|
79
91
|
}
|
|
80
92
|
|
|
81
93
|
export interface ModelFallbackNotice {
|
|
@@ -98,6 +110,8 @@ export interface SpawnPiAgentCallbacks {
|
|
|
98
110
|
}
|
|
99
111
|
|
|
100
112
|
export interface SpawnPiAgentResult {
|
|
113
|
+
runtimeTests?: RuntimeTestRecord[];
|
|
114
|
+
toolEvents?: ToolExecutionEvent[];
|
|
101
115
|
output: string;
|
|
102
116
|
exitCode: number | null;
|
|
103
117
|
stderr: string;
|
|
@@ -109,12 +123,20 @@ export interface SpawnPiAgentResult {
|
|
|
109
123
|
modelFallback?: ModelFallbackNotice;
|
|
110
124
|
/** Present only when parent-side bounded termination was requested. */
|
|
111
125
|
termination?: Termination;
|
|
126
|
+
boundedOutput?: { truncated: boolean; totalBytes: number; handle: string; contentPath: string; sha256: string };
|
|
127
|
+
writeIsolation?: Pick<WriteIsolationResult, "applied" | "failClosed" | "mechanism" | "permissionExpansion" | "rollsBackUserEdits" | "protectsConcurrentUserWrites">;
|
|
112
128
|
}
|
|
113
129
|
|
|
114
130
|
const DEFAULT_TERM_GRACE_MS = 1_000;
|
|
115
131
|
const DEFAULT_SETTLE_GRACE_MS = 1_000;
|
|
116
132
|
const WATCHED_TOOLS = new Set(["read", "grep", "find", "ls"]);
|
|
117
133
|
|
|
134
|
+
/** Sandboxed children must not inherit writable descriptors outside the mount policy. */
|
|
135
|
+
export function assertSafeSandboxStdio(stdio: readonly unknown[]): void {
|
|
136
|
+
if (stdio.length !== 3) throw new Error("write isolation refuses extra inherited file descriptors");
|
|
137
|
+
if (stdio.some(value => value !== "pipe")) throw new Error("write isolation requires safe stdio pipes");
|
|
138
|
+
}
|
|
139
|
+
|
|
118
140
|
/** Signal an explicitly owned process group, falling back only for legacy callers. */
|
|
119
141
|
export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM"): void {
|
|
120
142
|
const pid = proc.pid;
|
|
@@ -129,7 +151,9 @@ export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM
|
|
|
129
151
|
export function spawnPiAgent(opts: SpawnPiAgentOptions, cbs: SpawnPiAgentCallbacks = {}): Promise<SpawnPiAgentResult> {
|
|
130
152
|
return withProfileWork(async () => {
|
|
131
153
|
try {
|
|
132
|
-
const active=
|
|
154
|
+
const active = Object.prototype.hasOwnProperty.call(opts, "activeProfileSnapshot")
|
|
155
|
+
? opts.activeProfileSnapshot
|
|
156
|
+
: (readActiveProfile() ?? readActiveProfile(opts.env));
|
|
133
157
|
assertProfileModel(opts.model,active);
|
|
134
158
|
if(active) opts={...opts,env:{...opts.env,[PROFILE_ENV]:JSON.stringify(active)}};
|
|
135
159
|
return await spawnPiAgentUnchecked(opts,cbs);
|
|
@@ -156,6 +180,16 @@ function spawnPiAgentUnchecked(
|
|
|
156
180
|
];
|
|
157
181
|
if (opts.resume) args.push("-c");
|
|
158
182
|
|
|
183
|
+
const isolation = opts.writeIsolation ? confineNativeChild({ ...opts.writeIsolation, command: "pi", args, env: opts.env }) : undefined;
|
|
184
|
+
if (isolation && !isolation.applied) {
|
|
185
|
+
return Promise.resolve({
|
|
186
|
+
output: "", stderr: isolation.reason ?? "write isolation unavailable", exitCode: 1,
|
|
187
|
+
spawnError: isolation.reason ?? "write isolation unavailable; unsandboxed execution refused",
|
|
188
|
+
modelUsed: opts.model, toolCallsStarted: 0, writeIsolation: isolation,
|
|
189
|
+
});
|
|
190
|
+
}
|
|
191
|
+
const launchCommand = isolation?.command ?? "pi";
|
|
192
|
+
const launchArgs = isolation?.args ?? args;
|
|
159
193
|
const watchdog = opts.toolWatchdog;
|
|
160
194
|
const turnDeadlineMs = opts.turnDeadlineMs ?? null;
|
|
161
195
|
// A watchdog or deadline must own its group: group signalling remains valid even
|
|
@@ -169,8 +203,10 @@ function spawnPiAgentUnchecked(
|
|
|
169
203
|
const textChunks: string[] = [];
|
|
170
204
|
const stderrChunks: string[] = [];
|
|
171
205
|
return new Promise((resolve) => {
|
|
172
|
-
const
|
|
173
|
-
|
|
206
|
+
const stdio = ["pipe", "pipe", "pipe"];
|
|
207
|
+
if (isolation) assertSafeSandboxStdio(stdio);
|
|
208
|
+
const proc = spawn(launchCommand, launchArgs, {
|
|
209
|
+
stdio,
|
|
174
210
|
env: { ...process.env, ...(opts.env || {}) },
|
|
175
211
|
...(opts.cwd ? { cwd: opts.cwd } : {}),
|
|
176
212
|
...(ownsGroup ? { detached: true } : {}),
|
|
@@ -201,6 +237,10 @@ function spawnPiAgentUnchecked(
|
|
|
201
237
|
};
|
|
202
238
|
let assistantError: string | undefined;
|
|
203
239
|
let toolCallsStarted = 0;
|
|
240
|
+
const runtimeTests: RuntimeTestRecord[] = [];
|
|
241
|
+
const runtimeTestStarts = new Map<string, string>();
|
|
242
|
+
const toolEventRecorder = createToolEventRecorder();
|
|
243
|
+
const toolEvents: ToolExecutionEvent[] = toolEventRecorder.events;
|
|
204
244
|
const settle = (code: number | null, spawnError?: string) => {
|
|
205
245
|
if (settled) return;
|
|
206
246
|
settled = true;
|
|
@@ -210,18 +250,22 @@ function spawnPiAgentUnchecked(
|
|
|
210
250
|
try { proc.stdin?.destroy(); } catch {}
|
|
211
251
|
try { proc.stdout?.destroy(); } catch {}
|
|
212
252
|
try { proc.stderr?.destroy(); } catch {}
|
|
253
|
+
const rawOutput = textChunks.join("");
|
|
254
|
+
const bounded = opts.boundedOutputDir ? boundOutput({ content: rawOutput, retentionDir: opts.boundedOutputDir, label: "assistant-reply" }) : null;
|
|
213
255
|
resolve({
|
|
214
|
-
output:
|
|
256
|
+
output: bounded?.reply ?? rawOutput,
|
|
215
257
|
// Pi's headless process can exit 0 while the assistant message itself
|
|
216
258
|
// reports stopReason:error. Normalize that to a failed run so callers
|
|
217
259
|
// never mark a provider/model error as successful.
|
|
218
260
|
exitCode: assistantError && code === 0 ? 1 : code,
|
|
219
261
|
stderr: stderrChunks.join(""),
|
|
220
|
-
toolCallsStarted,
|
|
262
|
+
toolCallsStarted, runtimeTests, toolEvents,
|
|
221
263
|
modelUsed: opts.model,
|
|
222
264
|
...(spawnError ? { spawnError } : {}),
|
|
223
265
|
...(assistantError ? { assistantError } : {}),
|
|
224
266
|
...(termination ? { termination } : {}),
|
|
267
|
+
...(isolation ? { writeIsolation: isolation } : {}),
|
|
268
|
+
...(bounded ? { boundedOutput: { truncated: bounded.truncated, totalBytes: bounded.totalBytes, handle: bounded.handle, contentPath: bounded.contentPath, sha256: bounded.hash } } : {}),
|
|
225
269
|
});
|
|
226
270
|
};
|
|
227
271
|
const terminate = (reason: Termination["reason"], tool?: ToolTimeout) => {
|
|
@@ -273,7 +317,12 @@ function spawnPiAgentUnchecked(
|
|
|
273
317
|
const id = toolId(event);
|
|
274
318
|
const name = event.toolName || "tool";
|
|
275
319
|
if (id && !toolStarts.has(id)) toolStarts.set(id, Date.now());
|
|
276
|
-
|
|
320
|
+
const protocolArgs = event.args && typeof event.args === "object"
|
|
321
|
+
? JSON.stringify(Object.fromEntries(["path", "file", "filePath"].filter(key => typeof event.args[key] === "string").map(key => [key, event.args[key]])))
|
|
322
|
+
: "{}";
|
|
323
|
+
toolEventRecorder.start(name, protocolArgs, id || undefined);
|
|
324
|
+
if (opts.runtimeTestObserver && event.toolName === "bash" && typeof event.args?.command === "string" && toolId(event)) runtimeTestStarts.set(toolId(event), event.args.command);
|
|
325
|
+
cbs.onToolStart?.(name, argStr, id || undefined);
|
|
277
326
|
if (timeoutMs != null && id && watchedTools.has(name) && !calls.has(id)) {
|
|
278
327
|
const startedAt = Date.now();
|
|
279
328
|
const call: ToolTimeout = { toolCallId: id, toolName: name, args: argStr, startedAt, deadlineAt: startedAt + timeoutMs };
|
|
@@ -286,6 +335,11 @@ function spawnPiAgentUnchecked(
|
|
|
286
335
|
if (call) { clearTimeout(call.timer); calls.delete(id); }
|
|
287
336
|
}
|
|
288
337
|
const rawIsError = event.isError ?? event.is_error ?? event.result?.isError ?? event.result?.is_error;
|
|
338
|
+
toolEventRecorder.end(id || undefined, typeof rawIsError === "boolean" ? rawIsError : undefined);
|
|
339
|
+
const startedCommand = id ? runtimeTestStarts.get(id) : undefined;
|
|
340
|
+
if (id) runtimeTestStarts.delete(id);
|
|
341
|
+
const check = runtimeTestFromResult(opts.runtimeTestObserver, startedCommand, event.toolName, event.result);
|
|
342
|
+
if (check) runtimeTests.push(check);
|
|
289
343
|
const startedAt = id ? toolStarts.get(id) : undefined;
|
|
290
344
|
if (id) toolStarts.delete(id);
|
|
291
345
|
cbs.onToolEnd?.(
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { posix } from "node:path";
|
|
2
|
+
|
|
3
|
+
export interface TaskResumeInput {
|
|
4
|
+
taskId: string;
|
|
5
|
+
instructions: string;
|
|
6
|
+
scope?: readonly string[];
|
|
7
|
+
deliverables?: readonly string[];
|
|
8
|
+
artifacts?: readonly string[];
|
|
9
|
+
model?: string | null;
|
|
10
|
+
permissions?: readonly string[] | string;
|
|
11
|
+
previous?: TaskResumeContract | null;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface TaskResumeContract {
|
|
15
|
+
taskId: string;
|
|
16
|
+
instructions: string;
|
|
17
|
+
scope: string[];
|
|
18
|
+
deliverables: string[];
|
|
19
|
+
artifacts: string[];
|
|
20
|
+
model: string | null;
|
|
21
|
+
permissions: string[];
|
|
22
|
+
resumeAllowed: boolean;
|
|
23
|
+
inheritedUnfinishedInstructions: boolean;
|
|
24
|
+
identity: string;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function normalizeText(value: unknown): string {
|
|
28
|
+
return String(value ?? "").trim().replace(/\s+/g, " ");
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function normalizeList(values: readonly string[] | undefined): string[] {
|
|
32
|
+
return [...new Set((values ?? []).map(value => posix.normalize(String(value).trim().replace(/\\/g, "/")).replace(/^\.\//, "").replace(/\/$/, "")).filter(Boolean))].sort();
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function normalizePermissions(value: readonly string[] | string | undefined): string[] {
|
|
36
|
+
return normalizeList(typeof value === "string" ? value.split(",") : value);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function identityOf(contract: Omit<TaskResumeContract, "resumeAllowed" | "inheritedUnfinishedInstructions" | "identity">): string {
|
|
40
|
+
return JSON.stringify([
|
|
41
|
+
contract.taskId,
|
|
42
|
+
contract.instructions,
|
|
43
|
+
contract.scope,
|
|
44
|
+
contract.deliverables,
|
|
45
|
+
contract.artifacts,
|
|
46
|
+
contract.model,
|
|
47
|
+
contract.permissions,
|
|
48
|
+
]);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** Bind Pi session reuse to the exact current task and capability contract. */
|
|
52
|
+
export function bindResume(input: TaskResumeInput): TaskResumeContract {
|
|
53
|
+
const current = {
|
|
54
|
+
taskId: normalizeText(input.taskId),
|
|
55
|
+
instructions: normalizeText(input.instructions),
|
|
56
|
+
scope: normalizeList(input.scope),
|
|
57
|
+
deliverables: normalizeList(input.deliverables),
|
|
58
|
+
artifacts: normalizeList(input.artifacts),
|
|
59
|
+
model: normalizeText(input.model) || null,
|
|
60
|
+
permissions: normalizePermissions(input.permissions),
|
|
61
|
+
};
|
|
62
|
+
const identity = identityOf(current);
|
|
63
|
+
const resumeAllowed = !!input.previous && input.previous.identity === identity;
|
|
64
|
+
return {
|
|
65
|
+
...current,
|
|
66
|
+
resumeAllowed,
|
|
67
|
+
inheritedUnfinishedInstructions: resumeAllowed,
|
|
68
|
+
identity,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import type { WorkMode } from './work-mode.ts';
|
|
2
|
+
import {
|
|
3
|
+
TOOL_CATALOG_ENTRY_TYPE,
|
|
4
|
+
catalogSnapshot,
|
|
5
|
+
emitToolCatalogDelta,
|
|
6
|
+
restoreToolCatalogAfterCompaction,
|
|
7
|
+
type ToolCatalogDelta,
|
|
8
|
+
type ToolCatalogSnapshot,
|
|
9
|
+
} from './tool-catalog-state.ts';
|
|
10
|
+
import { UNKNOWN_TOOL_COUNTER_ENTRY_TYPE, type UnknownToolCounterSnapshot } from './unknown-tool-counter.ts';
|
|
11
|
+
|
|
12
|
+
export interface ToolCatalogReconcileInput {
|
|
13
|
+
fromMode: WorkMode;
|
|
14
|
+
toMode: WorkMode;
|
|
15
|
+
previous: readonly string[];
|
|
16
|
+
next: readonly string[];
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export interface ToolCatalogCompactionInput {
|
|
20
|
+
mode: WorkMode;
|
|
21
|
+
getEffectiveTools(): readonly string[];
|
|
22
|
+
persist(type: string, data: unknown): void;
|
|
23
|
+
counterSnapshot(): UnknownToolCounterSnapshot;
|
|
24
|
+
retainCounter(): void;
|
|
25
|
+
establishToolStateChange(previousCatalogVersion: string, nextCatalogVersion: string, evidenceRef: string): number;
|
|
26
|
+
settle(): void;
|
|
27
|
+
onError?(error: unknown): void;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Runtime-owned catalog state. The active turn is latched before model input. */
|
|
31
|
+
export function createToolCatalogRuntime(initial: ToolCatalogSnapshot) {
|
|
32
|
+
let currentCatalog = restoreToolCatalogAfterCompaction(initial);
|
|
33
|
+
let activeTurnCatalog: ToolCatalogSnapshot | null = null;
|
|
34
|
+
|
|
35
|
+
function reconcile(input: ToolCatalogReconcileInput): { snapshot: ToolCatalogSnapshot; delta: ToolCatalogDelta } {
|
|
36
|
+
const delta = emitToolCatalogDelta({ ...input, previousCatalogVersion: currentCatalog.catalogVersion });
|
|
37
|
+
currentCatalog = catalogSnapshot(input.toMode, delta.available);
|
|
38
|
+
return { snapshot: currentCatalog, delta };
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
return {
|
|
42
|
+
current: () => currentCatalog,
|
|
43
|
+
restore(snapshot: ToolCatalogSnapshot) { currentCatalog = restoreToolCatalogAfterCompaction(snapshot); return currentCatalog; },
|
|
44
|
+
reconcile,
|
|
45
|
+
beginTurn() { activeTurnCatalog = currentCatalog; return activeTurnCatalog; },
|
|
46
|
+
endTurn() { activeTurnCatalog = null; },
|
|
47
|
+
catalogForMessage() { return activeTurnCatalog ?? currentCatalog; },
|
|
48
|
+
compact(input: ToolCatalogCompactionInput): { snapshot: ToolCatalogSnapshot; delta: ToolCatalogDelta } | null {
|
|
49
|
+
try {
|
|
50
|
+
const restored = restoreToolCatalogAfterCompaction(currentCatalog);
|
|
51
|
+
const result = reconcile({ fromMode: restored.mode, toMode: input.mode, previous: restored.tools, next: input.getEffectiveTools() });
|
|
52
|
+
const evidenceRef = `session-entry:${TOOL_CATALOG_ENTRY_TYPE}:${result.delta.catalogVersion}`;
|
|
53
|
+
input.persist(TOOL_CATALOG_ENTRY_TYPE, { snapshot: result.snapshot, delta: result.delta, reason: 'compaction_restore' });
|
|
54
|
+
input.persist(UNKNOWN_TOOL_COUNTER_ENTRY_TYPE, { snapshot: input.counterSnapshot(), reason: 'compaction_restore' });
|
|
55
|
+
if (result.delta.evidence.changed) input.establishToolStateChange(result.delta.evidence.previousCatalogVersion, result.delta.evidence.catalogVersion, evidenceRef);
|
|
56
|
+
return result;
|
|
57
|
+
} catch (error) {
|
|
58
|
+
input.onError?.(error);
|
|
59
|
+
return null;
|
|
60
|
+
} finally {
|
|
61
|
+
input.retainCounter();
|
|
62
|
+
input.settle();
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export type ToolCatalogRuntime = ReturnType<typeof createToolCatalogRuntime>;
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import type { WorkMode } from "./work-mode.ts";
|
|
3
|
+
|
|
4
|
+
export const TOOL_CATALOG_STATE_SCHEMA = "agent-fleet.tool-catalog-state/v1" as const;
|
|
5
|
+
export const TOOL_CATALOG_ENTRY_TYPE = "agent-hub-tool-catalog-state";
|
|
6
|
+
|
|
7
|
+
export interface ToolCatalogSnapshot {
|
|
8
|
+
schema?: typeof TOOL_CATALOG_STATE_SCHEMA;
|
|
9
|
+
catalogVersion: string;
|
|
10
|
+
tools: string[];
|
|
11
|
+
mode: WorkMode;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface ToolCatalogDelta {
|
|
15
|
+
schema: "agent-fleet.tool-catalog-delta/v1";
|
|
16
|
+
fromMode: WorkMode;
|
|
17
|
+
toMode: WorkMode;
|
|
18
|
+
removed: string[];
|
|
19
|
+
added: string[];
|
|
20
|
+
available: string[];
|
|
21
|
+
substitutes: Record<string, string>;
|
|
22
|
+
substituteLimits: Record<string, string>;
|
|
23
|
+
permissionExpansion: false;
|
|
24
|
+
catalogVersion: string;
|
|
25
|
+
evidence: {
|
|
26
|
+
producer: "runtime-active-tool-catalog";
|
|
27
|
+
previousCatalogVersion: string;
|
|
28
|
+
catalogVersion: string;
|
|
29
|
+
changed: boolean;
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
const normalizedTools = (tools: readonly string[]): string[] => [...new Set(tools.map(tool => String(tool).trim()).filter(Boolean))].sort();
|
|
34
|
+
|
|
35
|
+
export function toolCatalogVersion(tools: readonly string[]): string {
|
|
36
|
+
return `catalog-sha256:${createHash("sha256").update(JSON.stringify(normalizedTools(tools))).digest("hex")}`;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function substituteForUnavailableTool(tool: string, availableTools: readonly string[]): { tool: string; limitation: string } | null {
|
|
40
|
+
const available = normalizedTools(availableTools);
|
|
41
|
+
const has = (candidate: string) => available.includes(candidate);
|
|
42
|
+
if (["write", "edit", "bash"].includes(tool) && has("dispatch_agent")) {
|
|
43
|
+
return { tool: "dispatch_agent", limitation: "delegate the requested effect; the orchestrator gains no direct filesystem or shell permission" };
|
|
44
|
+
}
|
|
45
|
+
if (["read", "grep", "find", "ls"].includes(tool) && has("spawn_research")) {
|
|
46
|
+
return { tool: "spawn_research", limitation: "delegate read-only inspection; no direct tool permission is restored" };
|
|
47
|
+
}
|
|
48
|
+
for (const candidate of ["read", "grep", "find", "spawn_research", "dispatch_agent"]) {
|
|
49
|
+
if (has(candidate)) return { tool: candidate, limitation: "available safe path only; it does not reproduce unavailable permissions" };
|
|
50
|
+
}
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export function emitToolCatalogDelta(input: {
|
|
55
|
+
fromMode: WorkMode;
|
|
56
|
+
toMode: WorkMode;
|
|
57
|
+
previous: readonly string[];
|
|
58
|
+
next: readonly string[];
|
|
59
|
+
previousCatalogVersion?: string;
|
|
60
|
+
}): ToolCatalogDelta {
|
|
61
|
+
const previous = normalizedTools(input.previous);
|
|
62
|
+
const available = normalizedTools(input.next);
|
|
63
|
+
const previousSet = new Set(previous);
|
|
64
|
+
const nextSet = new Set(available);
|
|
65
|
+
const removed = previous.filter(tool => !nextSet.has(tool));
|
|
66
|
+
const added = available.filter(tool => !previousSet.has(tool));
|
|
67
|
+
const substitutes: Record<string, string> = {};
|
|
68
|
+
const substituteLimits: Record<string, string> = {};
|
|
69
|
+
for (const removedTool of removed) {
|
|
70
|
+
const substitute = substituteForUnavailableTool(removedTool, available);
|
|
71
|
+
if (!substitute) continue;
|
|
72
|
+
substitutes[removedTool] = substitute.tool;
|
|
73
|
+
substituteLimits[removedTool] = substitute.limitation;
|
|
74
|
+
}
|
|
75
|
+
const previousCatalogVersion = input.previousCatalogVersion ?? toolCatalogVersion(previous);
|
|
76
|
+
const catalogVersion = toolCatalogVersion(available);
|
|
77
|
+
return {
|
|
78
|
+
schema: "agent-fleet.tool-catalog-delta/v1",
|
|
79
|
+
fromMode: input.fromMode,
|
|
80
|
+
toMode: input.toMode,
|
|
81
|
+
removed,
|
|
82
|
+
added,
|
|
83
|
+
available,
|
|
84
|
+
substitutes,
|
|
85
|
+
substituteLimits,
|
|
86
|
+
permissionExpansion: false,
|
|
87
|
+
catalogVersion,
|
|
88
|
+
evidence: {
|
|
89
|
+
producer: "runtime-active-tool-catalog",
|
|
90
|
+
previousCatalogVersion,
|
|
91
|
+
catalogVersion,
|
|
92
|
+
changed: removed.length > 0 || added.length > 0,
|
|
93
|
+
},
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export function restoreToolCatalogAfterCompaction(snapshot: ToolCatalogSnapshot): ToolCatalogSnapshot {
|
|
98
|
+
if (!snapshot || typeof snapshot.catalogVersion !== "string" || !snapshot.catalogVersion.trim()) throw new Error("tool catalog snapshot requires catalogVersion");
|
|
99
|
+
if (snapshot.mode !== "operator" && snapshot.mode !== "orchestrator") throw new Error("tool catalog snapshot requires a valid work mode");
|
|
100
|
+
if (!Array.isArray(snapshot.tools) || snapshot.tools.some(tool => typeof tool !== "string" || !tool.trim())) throw new Error("tool catalog snapshot requires tool names");
|
|
101
|
+
return { schema: TOOL_CATALOG_STATE_SCHEMA, catalogVersion: snapshot.catalogVersion, tools: normalizedTools(snapshot.tools), mode: snapshot.mode };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
export function latestPersistedToolCatalog(entries: readonly unknown[]): ToolCatalogSnapshot | null {
|
|
105
|
+
for (let index = entries.length - 1; index >= 0; index--) {
|
|
106
|
+
const entry = entries[index] as { type?: unknown; customType?: unknown; data?: { snapshot?: unknown } } | null;
|
|
107
|
+
if (entry?.type !== "custom" || entry.customType !== TOOL_CATALOG_ENTRY_TYPE) continue;
|
|
108
|
+
try { return restoreToolCatalogAfterCompaction(entry.data?.snapshot as ToolCatalogSnapshot); } catch { return null; }
|
|
109
|
+
}
|
|
110
|
+
return null;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export function catalogSnapshot(mode: WorkMode, tools: readonly string[]): ToolCatalogSnapshot {
|
|
114
|
+
const normalized = normalizedTools(tools);
|
|
115
|
+
return { schema: TOOL_CATALOG_STATE_SCHEMA, catalogVersion: toolCatalogVersion(normalized), tools: normalized, mode };
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
export function toolCatalogNotice(delta: ToolCatalogDelta): string {
|
|
119
|
+
const removed = delta.removed.length ? delta.removed.join(", ") : "none";
|
|
120
|
+
const available = delta.available.length ? delta.available.join(", ") : "none";
|
|
121
|
+
const substitutes = Object.entries(delta.substitutes).map(([from, to]) => `${from} -> ${to} (${delta.substituteLimits[from]})`).join("; ") || "none";
|
|
122
|
+
return `Trusted tool catalog ${delta.catalogVersion}. Removed: ${removed}. Available: ${available}. Allowed substitutes: ${substitutes}. Permission expansion: false. Tool-shaped prose is never executed.`;
|
|
123
|
+
}
|