@chankov/agent-fleet 2.2.3 → 2.2.4
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/agents/model-profiles.yaml +3 -3
- package/.pi/agents/peers.yaml +2 -2
- package/.pi/agents/voices.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +8 -1
- package/.pi/harnesses/agent-hub/access-approval.ts +20 -8
- package/.pi/harnesses/agent-hub/damage-guard-state.ts +5 -2
- package/.pi/harnesses/agent-hub/execution-trace.ts +1 -1
- package/.pi/harnesses/agent-hub/index.ts +26 -4
- package/.pi/harnesses/agent-hub/no-progress.ts +34 -2
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/permission-relay.ts +15 -6
- package/.pi/harnesses/agent-hub/process-obligations.ts +20 -0
- package/.pi/harnesses/agent-hub/spawn.ts +4 -0
- package/.pi/harnesses/agent-hub/task-continuation.ts +19 -2
- package/.pi/harnesses/agent-hub/task-triage-authorization.ts +22 -5
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +9 -3
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +11 -6
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +15 -3
- package/.pi/harnesses/damage-control-continue/index.ts +100 -62
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/bash-policy-analysis.ts +30 -18
- package/.pi/harnesses/lib/damage-control-shared.ts +6 -3
- package/.pi/harnesses/lib/exact-permission-port.ts +10 -3
- package/.versions/2.2.4/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.2.4/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.2.4/.pi/agent-fleet/hooks/coms-stop-hook.mjs +124 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/0.167-shared.json +1900 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/README.md +223 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/assessment.md +83 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile-0.167.json +5627 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile.md +43 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap.md +45 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture-profile.ts +53 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture.ts +102 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/catalog.md +91 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/channel.md +21 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurement.md +133 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurements.json +74 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/notification-profile-0.167.json +2679 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/observer.md +101 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/opaque-response.md +57 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/open-sent.md +68 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/probe-reader.md +51 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/profile.md +71 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/projection.md +147 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/reconnect.md +40 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/response-unions.md +74 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/semver.md +124 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/surface.md +73 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/response-fixture.ts +23 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +63 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/fleet.ts +244 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/flow.ts +166 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-bootstrap-files.ts +46 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-bootstrap-probe.ts +52 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-bootstrap-producer.ts +131 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-connection-history.ts +51 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-daemon-observer.ts +137 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-desktop-discovery.ts +84 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-desktop-preflight.ts +130 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +113 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-measurement.ts +218 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-native-presence.ts +61 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-probe-transcript.ts +135 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-send-lineage.ts +72 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +101 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +453 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-bootstrap.ts +207 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +76 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +132 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +175 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +435 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +44 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-command.ts +264 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +239 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/team-project.ts +176 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/package-lock.json +57 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/package.json +10 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/pi-session.ts +9 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/git.ts +108 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/quality.ts +78 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.2.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.2.4/.pi/agents/model-profiles.yaml +132 -0
- package/.versions/2.2.4/.pi/agents/peers.yaml +147 -0
- package/.versions/2.2.4/.pi/agents/teams.yaml +41 -0
- package/.versions/2.2.4/.pi/agents/voices.yaml +13 -0
- package/.versions/2.2.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.2.4/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.2.4/.pi/extensions/btw/index.ts +916 -0
- package/.versions/2.2.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.2.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.2.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.2.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.2.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.2.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.2.4/.pi/extensions/compact-and-continue/index.ts +136 -0
- package/.versions/2.2.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.2.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.2.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.2.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.2.4/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.2.4/.pi/extensions/package.json +9 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/config.ts +199 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.2.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/README.md +1664 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/acceptance.ts +204 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/access-approval.ts +278 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/budget-recovery.ts +151 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/capability-packs.ts +187 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/codex-bootstrap.ts +117 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/config.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/recover.ts +81 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/config/agents.ts +183 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/config/model-profiles.ts +240 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context/assertion-journal.ts +133 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +234 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-compat.ts +45 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-state.ts +46 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/delegate.ts +478 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +318 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +264 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +297 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native.ts +242 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-watchdog.js +344 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/external-blocker.js +92 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +69 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/helpers.ts +269 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/history-projection.ts +116 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/index.ts +2827 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/input/shortcuts.ts +16 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/no-progress.ts +773 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/operator-current-state.ts +102 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/permission-relay.ts +93 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/roster.ts +103 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/work-mode.ts +104 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/poll-command.ts +184 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/presentation.ts +54 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-snapshot.ts +287 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/process-obligations.ts +230 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/context.ts +72 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/fragments.ts +94 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/session-start.ts +89 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +142 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/provider-semaphore.js +143 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/recover-state.ts +144 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/recovery-continuation.ts +134 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/return-contract.js +371 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/review-continuity.ts +76 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/review-findings.js +96 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/review-reuse.ts +48 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/run-budget.js +362 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/scope-gate.js +271 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/scope-overlap.ts +46 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/session-audit.ts +331 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/spawn.ts +706 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-brief.ts +98 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-continuation.ts +21 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-authorization.ts +187 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-runtime.ts +132 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +83 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tool-catalog-state.ts +125 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/action-executors.ts +243 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/context.ts +151 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +93 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +976 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +23 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/poll-panel-core.ts +30 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/poll-panel.ts +33 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/recover-task.ts +16 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/run-flow.ts +177 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +173 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/verification-diagnostics.ts +23 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/work-mode.ts +185 -0
- package/.versions/2.2.4/.pi/harnesses/agent-hub/write-isolation.ts +232 -0
- package/.versions/2.2.4/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.2.4/.pi/harnesses/ask-user-remote/index.ts +571 -0
- package/.versions/2.2.4/.pi/harnesses/ask-user-remote/questions.ts +206 -0
- package/.versions/2.2.4/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.2.4/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
- package/.versions/2.2.4/.pi/harnesses/coms/README.md +105 -0
- package/.versions/2.2.4/.pi/harnesses/coms/index.ts +308 -0
- package/.versions/2.2.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.2.4/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/README.md +173 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/index.ts +699 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
- package/.versions/2.2.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.2.4/.pi/harnesses/lib/approval-wait.ts +17 -0
- package/.versions/2.2.4/.pi/harnesses/lib/bash-policy-analysis.ts +205 -0
- package/.versions/2.2.4/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.2.4/.pi/harnesses/lib/clarification-policy.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/lib/codex-compat.ts +97 -0
- package/.versions/2.2.4/.pi/harnesses/lib/codex-contract.ts +259 -0
- package/.versions/2.2.4/.pi/harnesses/lib/codex-notification-profile.ts +75 -0
- package/.versions/2.2.4/.pi/harnesses/lib/coms-core-io.ts +422 -0
- package/.versions/2.2.4/.pi/harnesses/lib/coms-core.ts +738 -0
- package/.versions/2.2.4/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
- package/.versions/2.2.4/.pi/harnesses/lib/coms-observation.ts +74 -0
- package/.versions/2.2.4/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
- package/.versions/2.2.4/.pi/harnesses/lib/coms-response-read.ts +107 -0
- package/.versions/2.2.4/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
- package/.versions/2.2.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +124 -0
- package/.versions/2.2.4/.pi/harnesses/lib/context-budget-view.ts +112 -0
- package/.versions/2.2.4/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.2.4/.pi/harnesses/lib/context-compaction-policy.js +35 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-action-hash.ts +28 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-control-shared.ts +279 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-guard-port.ts +25 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-policy.ts +35 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
- package/.versions/2.2.4/.pi/harnesses/lib/damage-result-view.ts +16 -0
- package/.versions/2.2.4/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
- package/.versions/2.2.4/.pi/harnesses/lib/exact-permission-port.ts +47 -0
- package/.versions/2.2.4/.pi/harnesses/lib/execution-trace.ts +45 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-bootstrap-channel.ts +148 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-catalog.ts +30 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-chat-view.ts +55 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-namespace.ts +2 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-policy-snapshot.ts +10 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/view.ts +338 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-connection-control.ts +94 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-connection-diagnostics.ts +7 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-event-source.ts +21 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-notification-admission.ts +32 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-notification-bootstrap.ts +172 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-notification-validation.ts +122 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-target-identity.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.2.4/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.2.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.2.4/.pi/harnesses/lib/identical-dialog.ts +27 -0
- package/.versions/2.2.4/.pi/harnesses/lib/installation-state.js +62 -0
- package/.versions/2.2.4/.pi/harnesses/lib/peer-target.ts +24 -0
- package/.versions/2.2.4/.pi/harnesses/lib/policy-roots.js +117 -0
- package/.versions/2.2.4/.pi/harnesses/lib/policy-roots.ts +32 -0
- package/.versions/2.2.4/.pi/harnesses/lib/process-shared.ts +9 -0
- package/.versions/2.2.4/.pi/harnesses/lib/resource-closure.js +26 -0
- package/.versions/2.2.4/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.versions/2.2.4/.pi/harnesses/lib/semantic-approval.ts +80 -0
- package/.versions/2.2.4/.pi/harnesses/lib/session-target.ts +62 -0
- package/.versions/2.2.4/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-agentic.js +15 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-loader.js +53 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-proactive.js +68 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config-v2.js +112 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
- package/.versions/2.2.4/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
- package/.versions/2.2.4/.pi/harnesses/lib/target-capabilities.js +7 -0
- package/.versions/2.2.4/.pi/harnesses/lib/update-check.ts +227 -0
- package/.versions/2.2.4/.pi/harnesses/lib/workspace-context.js +115 -0
- package/.versions/2.2.4/.pi/harnesses/lib/workspace-context.ts +22 -0
- package/.versions/2.2.4/.pi/harnesses/package-lock.json +2121 -0
- package/.versions/2.2.4/.pi/harnesses/package.json +13 -0
- package/.versions/2.2.4/.pi/prompts/af-build.md +27 -0
- package/.versions/2.2.4/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.2.4/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.2.4/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.2.4/.pi/prompts/af-review.md +16 -0
- package/.versions/2.2.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.2.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.2.4/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.2.4/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.2.4/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.2.4/.pi/prompts/af-test.md +19 -0
- package/.versions/2.2.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.2.4/.version +1 -0
- package/.versions/2.2.4/agents/architect.md +24 -0
- package/.versions/2.2.4/agents/bowser.md +28 -0
- package/.versions/2.2.4/agents/builder.md +55 -0
- package/.versions/2.2.4/agents/code-reviewer.md +209 -0
- package/.versions/2.2.4/agents/deep-researcher.md +32 -0
- package/.versions/2.2.4/agents/documenter.md +22 -0
- package/.versions/2.2.4/agents/plan-reviewer.md +83 -0
- package/.versions/2.2.4/agents/planner.md +107 -0
- package/.versions/2.2.4/agents/releaser.md +24 -0
- package/.versions/2.2.4/agents/researcher.md +30 -0
- package/.versions/2.2.4/agents/security-auditor.md +167 -0
- package/.versions/2.2.4/agents/test-engineer.md +153 -0
- package/.versions/2.2.4/agents/web-debugger.md +44 -0
- package/.versions/2.2.4/agents/web-performance-auditor.md +194 -0
- package/.versions/2.2.4/bin/catalog/harness-runtime-closure.json +85 -0
- package/.versions/2.2.4/docs/ARCHITECTURE.md +1291 -0
- package/.versions/2.2.4/docs/agent-fleet-setup.md +1161 -0
- package/.versions/2.2.4/docs/claude-code-coms-bridge.md +147 -0
- package/.versions/2.2.4/docs/codex-local-mcp.md +528 -0
- package/.versions/2.2.4/docs/codex-session-bridge.md +44 -0
- package/.versions/2.2.4/docs/codex-setup.md +183 -0
- package/.versions/2.2.4/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.2.4/docs/fleet-native-voice.md +151 -0
- package/.versions/2.2.4/docs/getting-started.md +126 -0
- package/.versions/2.2.4/docs/npm-install.md +535 -0
- package/.versions/2.2.4/docs/pi-extensions.md +450 -0
- package/.versions/2.2.4/docs/pi-setup.md +92 -0
- package/.versions/2.2.4/docs/skill-anatomy.md +150 -0
- package/.versions/2.2.4/install-manifest.json +3227 -0
- package/.versions/2.2.4/justfile +246 -0
- package/.versions/2.2.4/manifest-meta.json +1099 -0
- package/.versions/2.2.4/references/accessibility-checklist.md +160 -0
- package/.versions/2.2.4/references/communication-contract.md +26 -0
- package/.versions/2.2.4/references/definition-of-done.md +67 -0
- package/.versions/2.2.4/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.2.4/references/observability-checklist.md +92 -0
- package/.versions/2.2.4/references/orchestration-patterns.md +370 -0
- package/.versions/2.2.4/references/performance-checklist.md +236 -0
- package/.versions/2.2.4/references/prompting-patterns.md +380 -0
- package/.versions/2.2.4/references/security-checklist.md +245 -0
- package/.versions/2.2.4/references/testing-patterns.md +235 -0
- package/.versions/2.2.4/references/workflow-authoring.md +304 -0
- package/.versions/2.2.4/skills/_internal/grilling.md +59 -0
- package/.versions/2.2.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.2.4/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.2.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.2.4/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.2.4/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.2.4/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.2.4/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.2.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.2.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.2.4/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.2.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.2.4/skills/fleet-connect/SKILL.md +29 -0
- package/.versions/2.2.4/skills/fleet-connect.zip +0 -0
- package/.versions/2.2.4/skills/fleet-native-voice/SKILL.md +103 -0
- package/.versions/2.2.4/skills/fleet-native-voice/agents/openai.yaml +4 -0
- package/.versions/2.2.4/skills/fleet-native-voice.zip +0 -0
- package/.versions/2.2.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.2.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.2.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.2.4/skills/idea-refine/examples.md +238 -0
- package/.versions/2.2.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.2.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.2.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.2.4/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.2.4/skills/incremental-implementation.zip +0 -0
- package/.versions/2.2.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.2.4/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.2.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.2.4/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.2.4/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.2.4/skills/planning-and-task-breakdown.zip +0 -0
- package/.versions/2.2.4/skills/repository-ai-setup/SKILL.md +135 -0
- package/.versions/2.2.4/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.2.4/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.2.4/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.2.4/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.2.4/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.2.4/skills/repository-ai-setup.zip +0 -0
- package/.versions/2.2.4/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.2.4/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.2.4/skills/spec-driven-development.zip +0 -0
- package/.versions/2.2.4/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.2.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +25 -0
- package/README.md +3 -3
- package/agents/architect.md +2 -2
- package/agents/bowser.md +1 -1
- package/agents/builder.md +2 -2
- package/agents/code-reviewer.md +2 -2
- package/agents/deep-researcher.md +1 -1
- package/agents/documenter.md +1 -1
- package/agents/plan-reviewer.md +2 -2
- package/agents/planner.md +5 -5
- package/agents/releaser.md +1 -1
- package/agents/researcher.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +2 -2
- package/agents/web-debugger.md +2 -2
- package/agents/web-performance-auditor.md +2 -2
- package/bin/force-patch-changesets.js +2 -3
- package/bin/snapshot-version.js +1 -1
- package/docs/agent-fleet-setup.md +3 -3
- package/docs/codex-local-mcp.md +13 -5
- package/install-manifest.json +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared exemption + escalation plumbing for damage-control-continue and agent-hub.
|
|
3
|
+
*
|
|
4
|
+
* Exemptions are runtime, session-scoped allowances layered on top of
|
|
5
|
+
* `.pi/damage-control-rules.yaml` — they never edit the rules file and only
|
|
6
|
+
* ever apply to the path categories (zeroAccessPaths / readOnlyPaths /
|
|
7
|
+
* noDeletePaths), never to the destructive bashToolPatterns.
|
|
8
|
+
*
|
|
9
|
+
* Consumers:
|
|
10
|
+
* - damage-control-continue — /allow commands, block-time prompts, and
|
|
11
|
+
* escalation to the agent-hub dispatcher from headless children
|
|
12
|
+
* - agent-hub — computes the shared file path, passes the env plumbing to
|
|
13
|
+
* spawned children, and answers access_request envelopes on its coms socket
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import * as fs from "fs";
|
|
17
|
+
import * as net from "net";
|
|
18
|
+
import * as os from "os";
|
|
19
|
+
import * as path from "path";
|
|
20
|
+
import { parse as parseYaml } from 'yaml';
|
|
21
|
+
import { safeSourceRead } from './safe-source-read.js';
|
|
22
|
+
import { readDamagePolicy } from './damage-policy.ts';
|
|
23
|
+
import { sessionRootsFromEnv } from './workspace-context.ts';
|
|
24
|
+
|
|
25
|
+
/** Explicit file-access check for consumers outside the named tool hook. Invalid policy fails closed. */
|
|
26
|
+
export function currentFileAccessAllowed(root: string, target: string): boolean {
|
|
27
|
+
try {
|
|
28
|
+
const roots=sessionRootsFromEnv();
|
|
29
|
+
if(roots?.mode==='targeted') {
|
|
30
|
+
if(fs.realpathSync(root)!==roots.executionRoot)return false;
|
|
31
|
+
const policy=readDamagePolicy(root)!;
|
|
32
|
+
return !policy.rules.zeroAccessPaths.some(p=>damageControlPathMatches(path.resolve(root,target),p,roots.executionRoot));
|
|
33
|
+
}
|
|
34
|
+
} catch { return false; }
|
|
35
|
+
const project = path.join(root, '.pi/damage-control-rules.yaml');
|
|
36
|
+
const global = path.join(os.homedir(), '.pi/damage-control-rules.yaml');
|
|
37
|
+
try {
|
|
38
|
+
const selected = fs.existsSync(project) ? project : fs.existsSync(global) ? global : null;
|
|
39
|
+
if (!selected) return true;
|
|
40
|
+
const policy = parseYaml(safeSourceRead(selected === project ? root : os.homedir(), selected, 65536).toString('utf8'));
|
|
41
|
+
if (!policy || typeof policy !== 'object' || Array.isArray(policy) || (policy.zeroAccessPaths !== undefined && (!Array.isArray(policy.zeroAccessPaths) || policy.zeroAccessPaths.some((p: unknown) => typeof p !== 'string')))) return false;
|
|
42
|
+
return !(policy.zeroAccessPaths ?? []).some((p: string) => damageControlPathMatches(path.resolve(root, target), p, root));
|
|
43
|
+
} catch { return false; }
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// Env plumbing agent-hub sets on spawned children. spawnPiAgent spreads
|
|
47
|
+
// process.env, so delegate grandchildren inherit these for free.
|
|
48
|
+
export const ASK_ENDPOINT_ENV = "AGENT_HUB_ASK_ENDPOINT";
|
|
49
|
+
export const EXEMPTIONS_FILE_ENV = "AGENT_HUB_EXEMPTIONS_FILE";
|
|
50
|
+
export const AGENT_ID_ENV = "AGENT_HUB_AGENT_ID";
|
|
51
|
+
|
|
52
|
+
export type ExemptionScope = "turn" | "session";
|
|
53
|
+
export type PathRuleCategory = "zero_access" | "read_only" | "no_delete";
|
|
54
|
+
/** What a child may escalate: a protected path category, or a destructive
|
|
55
|
+
* `bashToolPatterns` rule marked `ask: true` (one-call approval only, never an exemption). */
|
|
56
|
+
export type AccessCategory = PathRuleCategory | "bash_pattern";
|
|
57
|
+
|
|
58
|
+
export interface Exemption {
|
|
59
|
+
/** The protected pattern being unlocked — same syntax as the rules file entries. */
|
|
60
|
+
pattern: string;
|
|
61
|
+
scope: ExemptionScope;
|
|
62
|
+
/** When set, the exemption applies only to the spawned agent with this id. */
|
|
63
|
+
agent?: string;
|
|
64
|
+
grantedVia: "command" | "prompt" | "escalation";
|
|
65
|
+
grantedAt: string;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// ── shared exemptions file (one per hub session, read by spawned children) ──
|
|
69
|
+
|
|
70
|
+
export function exemptionsFilePath(sessionId: string): string {
|
|
71
|
+
const comsDir = process.env.PI_COMS_DIR || path.join(os.homedir(), ".pi", "coms");
|
|
72
|
+
return path.join(comsDir, "exemptions", `${sessionId}.json`);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function readExemptionsFile(filePath: string | undefined): Exemption[] {
|
|
76
|
+
if (!filePath) return [];
|
|
77
|
+
try {
|
|
78
|
+
const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
|
|
79
|
+
if (!Array.isArray(parsed)) return [];
|
|
80
|
+
return parsed.filter((e): e is Exemption => !!e && typeof e.pattern === "string" && e.pattern.length > 0);
|
|
81
|
+
} catch {
|
|
82
|
+
return [];
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Exemptions visible to one process: agent-agnostic entries plus those granted to `agentId`. */
|
|
87
|
+
export function fileExemptionsFor(filePath: string | undefined, agentId: string | undefined): Exemption[] {
|
|
88
|
+
return readExemptionsFile(filePath).filter((e) => !e.agent || e.agent === agentId);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export function appendExemptionToFile(filePath: string, exemption: Exemption): void {
|
|
92
|
+
fs.mkdirSync(path.dirname(filePath), { recursive: true });
|
|
93
|
+
const existing = readExemptionsFile(filePath);
|
|
94
|
+
const dup = existing.some((e) => e.pattern === exemption.pattern && (e.agent ?? "") === (exemption.agent ?? ""));
|
|
95
|
+
if (!dup) existing.push(exemption);
|
|
96
|
+
const tmp = `${filePath}.tmp`;
|
|
97
|
+
fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
|
|
98
|
+
fs.renameSync(tmp, filePath);
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** Remove every entry for `pattern` (any agent). Returns true when something was removed. */
|
|
102
|
+
export function removeExemptionFromFile(filePath: string | undefined, pattern: string): boolean {
|
|
103
|
+
if (!filePath) return false;
|
|
104
|
+
const existing = readExemptionsFile(filePath);
|
|
105
|
+
const next = existing.filter((e) => e.pattern !== pattern);
|
|
106
|
+
if (next.length === existing.length) return false;
|
|
107
|
+
try {
|
|
108
|
+
const tmp = `${filePath}.tmp`;
|
|
109
|
+
fs.writeFileSync(tmp, JSON.stringify(next, null, 2));
|
|
110
|
+
fs.renameSync(tmp, filePath);
|
|
111
|
+
return true;
|
|
112
|
+
} catch {
|
|
113
|
+
return false;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// ── escalation protocol (headless child → hub dispatcher) ──
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Sent by a child's damage-control-continue to the hub's coms socket. Carries
|
|
121
|
+
* the Envelope base fields (sender_session = agent id, sender_endpoint = "")
|
|
122
|
+
* so the hub's isValidEnvelope accepts it.
|
|
123
|
+
*/
|
|
124
|
+
export interface AccessRequest {
|
|
125
|
+
/** Diagnostic correlation only; these fields never authorize access. */
|
|
126
|
+
toolCallId?: string;
|
|
127
|
+
traceOwner?: string;
|
|
128
|
+
type: "access_request";
|
|
129
|
+
msg_id: string;
|
|
130
|
+
sender_session: string;
|
|
131
|
+
sender_endpoint: string;
|
|
132
|
+
hops: number;
|
|
133
|
+
timestamp: string;
|
|
134
|
+
agent: string;
|
|
135
|
+
tool: string;
|
|
136
|
+
rule: string;
|
|
137
|
+
pattern: string;
|
|
138
|
+
category: AccessCategory;
|
|
139
|
+
/** Bounded display text only; never use a truncated preview as action identity. */
|
|
140
|
+
invocation: string;
|
|
141
|
+
/** SHA-256 of complete tool/cwd/input/category/pattern identity; optional for legacy callers. */
|
|
142
|
+
actionDigest?: string;
|
|
143
|
+
/** Absolute Unix epoch milliseconds; legacy callers are bounded at receipt. */
|
|
144
|
+
deadline?: number;
|
|
145
|
+
/** Per-spawn cooperative epoch; old children cannot inherit a new task's approval. */
|
|
146
|
+
accessEpoch?: string;
|
|
147
|
+
exactAction?: {tool:string;cwd:string;input:unknown;category:string;pattern:string};
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
export type AccessDecisionChoice = "deny" | "allow_once" | "allow_agent" | "allow_all";
|
|
151
|
+
|
|
152
|
+
/** Protected deletions are approved per invocation; broader grants stay operator-explicit. */
|
|
153
|
+
export function accessDecisionChoices(category: AccessCategory): AccessDecisionChoice[] {
|
|
154
|
+
return category === "no_delete" || category === "bash_pattern"
|
|
155
|
+
? ["deny", "allow_once"]
|
|
156
|
+
: ["deny", "allow_once", "allow_agent", "allow_all"];
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** Coalesce identical asks without letting one delete approval cover sibling paths. */
|
|
160
|
+
export function accessRequestCacheKey(
|
|
161
|
+
request: Pick<AccessRequest, "agent" | "pattern" | "category" | "invocation" | "actionDigest">,
|
|
162
|
+
): string {
|
|
163
|
+
// Structured tuples avoid delimiter collisions and category confusion.
|
|
164
|
+
return JSON.stringify([request.agent, request.pattern, request.category,
|
|
165
|
+
request.category === 'no_delete' ? request.actionDigest ?? request.invocation : null]);
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
export interface AccessDecision {
|
|
169
|
+
type: "access_decision";
|
|
170
|
+
msg_id: string;
|
|
171
|
+
decision: AccessDecisionChoice;
|
|
172
|
+
decisionSource?: 'codex_machine' | 'local_human';
|
|
173
|
+
outcome?: 'expired' | 'cancelled' | 'stale' | 'unsupported' | 'audit_failed';
|
|
174
|
+
actionDigest?: string;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
export const ESCALATION_TIMEOUT_MS = Number(process.env.AGENT_HUB_ASK_TIMEOUT_MS) || 60_000;
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* Ask the hub to approve a blocked call. Synchronous over a single connection:
|
|
181
|
+
* the child has no socket server of its own, so the hub keeps this socket open
|
|
182
|
+
* and writes the decision line whenever the user answers. Resolves "timeout" /
|
|
183
|
+
* "error" instead of rejecting — callers always fail closed.
|
|
184
|
+
*/
|
|
185
|
+
export interface AccessReceipt {
|
|
186
|
+
status:'decided'|'expired'|'cancelled'|'stale'|'unsupported'|'invalid_reply'|'disconnected'|'transport_error'|'audit_failed';
|
|
187
|
+
msg_id:string; actionDigest?:string; decision?:AccessDecisionChoice; decisionSource?:'codex_machine'|'local_human'|'legacy_unattested';
|
|
188
|
+
}
|
|
189
|
+
export async function requestAccessFromHub(endpoint:string,request:AccessRequest,timeoutMs:number=ESCALATION_TIMEOUT_MS):Promise<AccessDecisionChoice|'machine_deny'|'timeout'|'error'>{
|
|
190
|
+
const r=await requestAccessReceiptFromHub(endpoint,request,timeoutMs);
|
|
191
|
+
return r.status==='decided'?(r.decision==='deny'&&r.decisionSource==='codex_machine'?'machine_deny':r.decision!):r.status==='expired'?'timeout':'error';
|
|
192
|
+
}
|
|
193
|
+
export function requestAccessReceiptFromHub(
|
|
194
|
+
endpoint: string,
|
|
195
|
+
request: AccessRequest,
|
|
196
|
+
timeoutMs: number = ESCALATION_TIMEOUT_MS,
|
|
197
|
+
): Promise<AccessReceipt> {
|
|
198
|
+
return new Promise((resolve) => {
|
|
199
|
+
const failure=(status:AccessReceipt['status']):AccessReceipt=>({status,msg_id:request.msg_id,actionDigest:request.actionDigest});
|
|
200
|
+
if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 ||
|
|
201
|
+
(request.deadline !== undefined && !Number.isSafeInteger(request.deadline))) { resolve(failure('invalid_reply')); return; }
|
|
202
|
+
const deadline = Math.min(request.deadline ?? Infinity, Date.now() + timeoutMs);
|
|
203
|
+
if (deadline <= Date.now()) { resolve(failure('expired')); return; }
|
|
204
|
+
let settled = false;
|
|
205
|
+
let timer: ReturnType<typeof setTimeout> | undefined;
|
|
206
|
+
let sock: net.Socket;
|
|
207
|
+
const settle = (v:AccessDecisionChoice|'machine_deny'|'timeout'|'error'|AccessReceipt['status'],source?:AccessReceipt['decisionSource']) => {
|
|
208
|
+
if (settled) return;
|
|
209
|
+
settled = true;
|
|
210
|
+
if (timer) clearTimeout(timer);
|
|
211
|
+
try { sock.destroy(); } catch { /* ignore */ }
|
|
212
|
+
resolve(['deny','allow_once','allow_agent','allow_all','machine_deny'].includes(v)?{...failure('decided'),decision:v==='machine_deny'?'deny':v as AccessDecisionChoice,decisionSource:v==='machine_deny'?'codex_machine':source??'legacy_unattested'}:failure(v==='timeout'?'expired':v==='error'?'invalid_reply':v as AccessReceipt['status']));
|
|
213
|
+
};
|
|
214
|
+
try {
|
|
215
|
+
sock = net.createConnection({ path: endpoint });
|
|
216
|
+
} catch {
|
|
217
|
+
resolve(failure('transport_error'));
|
|
218
|
+
return;
|
|
219
|
+
}
|
|
220
|
+
timer = setTimeout(() => settle("timeout"), Math.max(1, deadline - Date.now()));
|
|
221
|
+
let buf = "";
|
|
222
|
+
sock.on("connect", () => {
|
|
223
|
+
try {
|
|
224
|
+
if (Date.now() >= deadline) { settle('timeout'); return; }
|
|
225
|
+
sock.write(JSON.stringify({ ...request, deadline }) + "\n");
|
|
226
|
+
} catch {
|
|
227
|
+
settle("error");
|
|
228
|
+
}
|
|
229
|
+
});
|
|
230
|
+
sock.on("data", (chunk: Buffer) => {
|
|
231
|
+
buf += chunk.toString("utf-8");
|
|
232
|
+
if(Buffer.byteLength(buf)>32768){settle('error');return;}
|
|
233
|
+
const nl = buf.indexOf("\n");
|
|
234
|
+
if (nl < 0) return;
|
|
235
|
+
try {
|
|
236
|
+
if (Date.now() >= deadline) { settle('timeout'); return; }
|
|
237
|
+
const parsed = JSON.parse(buf.slice(0, nl));
|
|
238
|
+
if(parsed?.type==='access_decision'&&parsed.msg_id===request.msg_id&&parsed.outcome!==undefined){settle(['expired','cancelled','stale','unsupported','audit_failed'].includes(parsed.outcome)?parsed.outcome:'invalid_reply');return;}
|
|
239
|
+
if (
|
|
240
|
+
parsed &&
|
|
241
|
+
parsed.type === "access_decision" && parsed.msg_id === request.msg_id &&
|
|
242
|
+
(parsed.actionDigest === undefined || parsed.actionDigest === request.actionDigest) &&
|
|
243
|
+
(parsed.decisionSource !== 'codex_machine' || typeof request.actionDigest==='string' && parsed.actionDigest === request.actionDigest && ['allow_once','deny'].includes(parsed.decision)) &&
|
|
244
|
+
(parsed.decision === "deny" || parsed.decision === "allow_once" ||
|
|
245
|
+
parsed.decision === "allow_agent" || parsed.decision === "allow_all")
|
|
246
|
+
) {
|
|
247
|
+
settle(parsed.decision==='deny'&&parsed.decisionSource==='codex_machine'?'machine_deny':parsed.decision,parsed.decisionSource==='local_human'?'local_human':parsed.decisionSource==='codex_machine'?'codex_machine':undefined);
|
|
248
|
+
} else {
|
|
249
|
+
// nack or unknown reply (e.g. an older hub without escalation support)
|
|
250
|
+
settle("error");
|
|
251
|
+
}
|
|
252
|
+
} catch {
|
|
253
|
+
settle("error");
|
|
254
|
+
}
|
|
255
|
+
});
|
|
256
|
+
sock.on("error", () => settle("transport_error"));
|
|
257
|
+
sock.on("close", () => settle("disconnected"));
|
|
258
|
+
});
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
export function damageControlPathMatches(targetPath: string, pattern: string, cwd: string): boolean {
|
|
262
|
+
const resolvedPattern = pattern.startsWith("~") ? path.join(os.homedir(), pattern.slice(1)) : pattern;
|
|
263
|
+
if (resolvedPattern.endsWith("/")) {
|
|
264
|
+
const absolutePattern = path.isAbsolute(resolvedPattern) ? resolvedPattern : path.resolve(cwd, resolvedPattern);
|
|
265
|
+
return targetPath.startsWith(absolutePattern);
|
|
266
|
+
}
|
|
267
|
+
const regexPattern = resolvedPattern
|
|
268
|
+
.replace(/[.+^${}()|[\]\\]/g, "\\$&")
|
|
269
|
+
.replace(/\*/g, ".*");
|
|
270
|
+
const regex = new RegExp(`^${regexPattern}$|^${regexPattern}/|/${regexPattern}$|/${regexPattern}/`);
|
|
271
|
+
const relativePath = path.relative(cwd, targetPath);
|
|
272
|
+
// Relative policy patterns describe paths inside the execution root, not
|
|
273
|
+
// ancestors of that root (e.g. macOS /private/var must not match private/**
|
|
274
|
+
// for every public project file). Keep absolute/home patterns and paths
|
|
275
|
+
// outside cwd on the existing full-path matching contract.
|
|
276
|
+
const withinCwd = relativePath === "" || (!path.isAbsolute(relativePath) && relativePath !== ".." && !relativePath.startsWith(`..${path.sep}`));
|
|
277
|
+
const candidates = !path.isAbsolute(resolvedPattern) && path.isAbsolute(targetPath) && withinCwd ? [relativePath] : [targetPath, relativePath];
|
|
278
|
+
return candidates.some(candidate => regex.test(candidate) || candidate.includes(resolvedPattern));
|
|
279
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import {processShared} from './process-shared.ts';
|
|
2
|
+
export interface DamageCallEvent {toolName:string;toolCallId:string;input:unknown;}
|
|
3
|
+
export interface DamageCallContext {cwd:string;revalidateBaseline?():boolean;}
|
|
4
|
+
export interface DamageGuardPort {call(event:DamageCallEvent,ctx:DamageCallContext):Promise<{block:boolean;reason?:string}>;}
|
|
5
|
+
// The Hub registers in its module instance while Damage-Control assesses in another.
|
|
6
|
+
const state=processShared<{port?:DamageGuardPort;spawned?:{assignment:unknown}}>('agent-fleet.damage-guard-port.v1',()=>({}));
|
|
7
|
+
/** Process-owned adapter only. Missing registration preserves standalone baseline, not a second provider. */
|
|
8
|
+
export function registerDamageGuard(next:DamageGuardPort){state.port=next;return ()=>{if(state.port===next)state.port=undefined;};}
|
|
9
|
+
export function assessDamageCall(event:DamageCallEvent,ctx:DamageCallContext){return state.port?state.port.call(event,ctx):Promise.resolve({block:false});}
|
|
10
|
+
export const DAMAGE_ASSIGNMENT_ENV='AF_D6_ASSIGNMENT';
|
|
11
|
+
const parsed=(raw:string):unknown=>{try{return JSON.parse(raw);}catch{return null;}};
|
|
12
|
+
/** Pi calls an extension factory without dependencies, so a native child's fresh assignment
|
|
13
|
+
* arrives through the trusted spawn environment. Damage-Control takes it before any tool runs:
|
|
14
|
+
* Bash subprocesses (tests, nested pi) never inherit the capability. Malformed transport stays
|
|
15
|
+
* assigned, so the child fails closed instead of silently losing D6. */
|
|
16
|
+
export function takeSpawnedDamageAssignment():unknown {
|
|
17
|
+
const raw=process.env[DAMAGE_ASSIGNMENT_ENV];
|
|
18
|
+
if(raw!==undefined){delete process.env[DAMAGE_ASSIGNMENT_ENV];state.spawned={assignment:parsed(raw)};}
|
|
19
|
+
return state.spawned?.assignment;
|
|
20
|
+
}
|
|
21
|
+
/** Descendant registration: a present transport wins, otherwise the copy Damage-Control took. */
|
|
22
|
+
export function spawnedDamageAssignment():unknown {
|
|
23
|
+
const raw=process.env[DAMAGE_ASSIGNMENT_ENV];
|
|
24
|
+
return raw!==undefined?parsed(raw):state.spawned?.assignment;
|
|
25
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { existsSync } from 'node:fs';
|
|
3
|
+
import { homedir } from 'node:os';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import {createRequire} from 'node:module';
|
|
6
|
+
// Legacy/native adapters can load without optional policy dependencies. Targeted
|
|
7
|
+
// policy evaluation still requires the workspace's installed YAML parser.
|
|
8
|
+
const require=createRequire(import.meta.url);
|
|
9
|
+
import { safeSourceRead } from './safe-source-read.js';
|
|
10
|
+
import { sessionRootsFromEnv } from './workspace-context.ts';
|
|
11
|
+
export interface DamagePolicy {
|
|
12
|
+
bashToolPatterns: {pattern:string;reason:string;ask?:boolean}[];
|
|
13
|
+
zeroAccessPaths:string[];readOnlyPaths:string[];noDeletePaths:string[];
|
|
14
|
+
}
|
|
15
|
+
/** The policy source is workspace-owned; path matching remains execution-relative. */
|
|
16
|
+
export function readDamagePolicy(execution:string,roots=sessionRootsFromEnv()): {path:string;rules:DamagePolicy;digest:string} | undefined {
|
|
17
|
+
const strict=roots?.mode==='targeted';
|
|
18
|
+
const base=roots?.workspaceRoot??execution;
|
|
19
|
+
const project=join(base,'.pi/damage-control-rules.yaml'), global=join(homedir(),'.pi/damage-control-rules.yaml');
|
|
20
|
+
const selected=existsSync(project)?project:!strict&&existsSync(global)?global:undefined;
|
|
21
|
+
if(!selected){if(strict)throw new Error('missing_workspace_damage_policy');return undefined;}
|
|
22
|
+
const bytes=safeSourceRead(selected===project?base:homedir(),selected,1024*1024);
|
|
23
|
+
let value:any;try{value=require('yaml').parse(bytes.toString('utf8'));}catch{throw new Error('invalid_damage_policy:yaml');}
|
|
24
|
+
if(!value||typeof value!=='object'||Array.isArray(value))throw new Error('invalid_damage_policy');
|
|
25
|
+
for(const key of ['bashToolPatterns','zeroAccessPaths','readOnlyPaths','noDeletePaths']) {
|
|
26
|
+
if(value[key]===undefined&&!strict)value[key]=[];
|
|
27
|
+
if(!Array.isArray(value[key]))throw new Error(`invalid_damage_policy:${key}`);
|
|
28
|
+
}
|
|
29
|
+
for(const key of ['zeroAccessPaths','readOnlyPaths','noDeletePaths'])if(value[key].some((p:unknown)=>typeof p!=='string'||!p))throw new Error(`invalid_damage_policy:${key}`);
|
|
30
|
+
for(const rule of value.bashToolPatterns){
|
|
31
|
+
if(!rule||typeof rule.pattern!=='string'||!rule.pattern||typeof rule.reason!=='string'||(rule.ask!==undefined&&typeof rule.ask!=='boolean'))throw new Error('invalid_damage_policy:bashToolPatterns');
|
|
32
|
+
try{new RegExp(rule.pattern);}catch{throw new Error('invalid_damage_policy:pattern');}
|
|
33
|
+
}
|
|
34
|
+
return {path:selected,rules:value as DamagePolicy,digest:createHash('sha256').update(bytes).digest('hex')};
|
|
35
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import {processShared} from './process-shared.ts';
|
|
2
|
+
/** Emission-local original evidence. Pi 1.1.0 passes the same event to each result hook,
|
|
3
|
+
* but loads each extension with its own module instance, so the capture is process-shared. */
|
|
4
|
+
interface EvidenceState {originals:WeakMap<object,unknown>;unavailable:WeakSet<object>;}
|
|
5
|
+
const {originals,unavailable}=processShared<EvidenceState>('agent-fleet.damage-result-evidence.v1',()=>({originals:new WeakMap(),unavailable:new WeakSet()}));
|
|
6
|
+
function freeze(value:any,seen=new Set<object>()){
|
|
7
|
+
if(!value||typeof value!=='object'||seen.has(value))return;
|
|
8
|
+
if(!Array.isArray(value)&&![Object.prototype,null].includes(Object.getPrototypeOf(value)))throw Error('unsupported_evidence');
|
|
9
|
+
seen.add(value);for(const child of Object.values(value))freeze(child,seen);Object.freeze(value);
|
|
10
|
+
}
|
|
11
|
+
export type DamageCaptureState='uncaptured'|'captured'|'failed';
|
|
12
|
+
/** Consumers requiring independent provenance must require the captured state. */
|
|
13
|
+
export function damageCaptureState(event:object):DamageCaptureState{
|
|
14
|
+
return unavailable.has(event)?'failed':originals.has(event)?'captured':'uncaptured';
|
|
15
|
+
}
|
|
16
|
+
/** Legacy parent compatibility: uncaptured is not a known capture failure. */
|
|
17
|
+
export function damageCaptureAvailable(event:object){return damageCaptureState(event)!=='failed';}
|
|
18
|
+
export function captureDamageResult<T extends {content:readonly unknown[]}>(event:T):T {
|
|
19
|
+
if(!originals.has(event)&&!unavailable.has(event)){
|
|
20
|
+
try{JSON.stringify(event);const snapshot=structuredClone(event);freeze(snapshot);originals.set(event,snapshot);}catch{unavailable.add(event);}
|
|
21
|
+
}
|
|
22
|
+
return (originals.get(event) as T|undefined)??event;
|
|
23
|
+
}
|
|
24
|
+
/** Failed capture is an explicit gap, never a mutable alias advertised as original. */
|
|
25
|
+
export function originalDamageResult<T extends object>(event:T):T|undefined{return unavailable.has(event)?undefined:(originals.get(event) as T|undefined)??event;}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Visible programmatic views carry the advisory as well as untouched original evidence. */
|
|
2
|
+
export function damageResultView<T extends {content:readonly any[];structuredContent?:unknown}>(event:T,text:string,metadata:unknown,key:'damageGuard'|'fileDiscovery'='damageGuard'):T{
|
|
3
|
+
const original=event.structuredContent;
|
|
4
|
+
const advisory={metadata,text};
|
|
5
|
+
let structuredContent:unknown=original;
|
|
6
|
+
if(typeof original==='string')structuredContent=original+'\n'+text;
|
|
7
|
+
else if(original!==undefined){
|
|
8
|
+
const plain=!!original&&typeof original==='object'&&!Array.isArray(original)&&Object.getPrototypeOf(original)===Object.prototype;
|
|
9
|
+
// D8 composes onto the D6 view without replacing its warning or original slot.
|
|
10
|
+
if(key==='fileDiscovery'&&plain&&!Object.hasOwn(original as object,key))structuredContent={...original as object,[key]:advisory};
|
|
11
|
+
else structuredContent=plain&&!Object.hasOwn(original as object,key)&&!Object.hasOwn(original as object,'originalStructuredContent')?{...original as object,originalStructuredContent:original,[key]:advisory}:{originalStructuredContent:original,[key]:advisory};
|
|
12
|
+
}
|
|
13
|
+
// Strings retain their declared native output type; the emission-local evidence
|
|
14
|
+
// snapshot and untouched original text block retain the exact original string.
|
|
15
|
+
return {...event,content:[...event.content,{type:'text',text}],structuredContent} as T;
|
|
16
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export type DeterministicFilesystemHandle = {
|
|
2
|
+
v: 1;
|
|
3
|
+
kind: "file" | "inventory";
|
|
4
|
+
path: string;
|
|
5
|
+
hash: string;
|
|
6
|
+
offset: number;
|
|
7
|
+
rootId?: string;
|
|
8
|
+
};
|
|
9
|
+
|
|
10
|
+
export function decodeDeterministicHandle(value: string): DeterministicFilesystemHandle {
|
|
11
|
+
try {
|
|
12
|
+
if (!value.startsWith("t5:")) throw new Error();
|
|
13
|
+
const parsed = JSON.parse(Buffer.from(value.slice(3), "base64url").toString("utf8"));
|
|
14
|
+
if (parsed?.v !== 1 || !["file", "inventory"].includes(parsed.kind) || typeof parsed.path !== "string" || typeof parsed.hash !== "string" || !Number.isSafeInteger(parsed.offset) || parsed.offset < 0) throw new Error();
|
|
15
|
+
if (parsed.rootId !== undefined && (typeof parsed.rootId !== "string" || !parsed.rootId)) throw new Error();
|
|
16
|
+
return parsed;
|
|
17
|
+
} catch {
|
|
18
|
+
throw new Error("Invalid deterministic filesystem handle");
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** Resolve a handle's bound path without reading source bytes; used by policy hooks before execution. */
|
|
23
|
+
export function deterministicHandlePath(value: string): string {
|
|
24
|
+
return decodeDeterministicHandle(value).path;
|
|
25
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import {createHash} from 'node:crypto';
|
|
2
|
+
import type {PermissionRelay} from '../agent-hub/permission-relay.ts';
|
|
3
|
+
import type {PermissionOutcome} from '../agent-hub/permission-channel.ts';
|
|
4
|
+
import type {DamageAction} from '../agent-hub/damage-guard-state.ts';
|
|
5
|
+
export function permissionAuditOutcome(outcome:PermissionOutcome){
|
|
6
|
+
const {reason,...metadata}=outcome as PermissionOutcome&{reason?:string};
|
|
7
|
+
return {...metadata,...(reason?{reasonDigest:createHash('sha256').update(reason).digest('hex'),reasonBytes:Buffer.byteLength(reason)}:{})};
|
|
8
|
+
}
|
|
9
|
+
const relayKey=Symbol.for('fleet.permission-relays.v1');
|
|
10
|
+
const relays:WeakMap<object,PermissionRelay>=(globalThis as any)[relayKey]??((globalThis as any)[relayKey]=new WeakMap());
|
|
11
|
+
/** Tools whose exact action can be presented through, and decided by, the permission relay. */
|
|
12
|
+
export const RELAY_OPERATIONS=['bash','write','edit','read','grep','find','ls','filesystem','submit_result'] as const;
|
|
13
|
+
export type DamageOperation=typeof RELAY_OPERATIONS[number];
|
|
14
|
+
export const isRelayOperation=(tool:unknown):tool is DamageOperation=>typeof tool==='string'&&(RELAY_OPERATIONS as readonly string[]).includes(tool);
|
|
15
|
+
export type PermissionFailure = 'expired'|'cancelled'|'stale'|'unavailable'|'audit_failed';
|
|
16
|
+
/** Shared baseline/triage one-winner path. Local UI produces values, never side effects
|
|
17
|
+
* before winner selection. Machine answers never enter identical-dialog/semantic memory. */
|
|
18
|
+
/** `onFailure` receives the relay's refusal reason when no request could be opened
|
|
19
|
+
* (`unavailable`); the local dialog has not been shown in that case. */
|
|
20
|
+
export async function raceExactPermission<T>(relay:PermissionRelay,action:DamageAction,input:unknown,current:()=>boolean,expiresAt:number,local:(signal:AbortSignal)=>Promise<{decision:'allow_once'|'deny';value:T}|null>,audit:(record:unknown)=>void,onFailure?:(reason:PermissionFailure,detail?:string)=>void){
|
|
21
|
+
const fail=(reason:PermissionFailure,detail?:string)=>{try{onFailure?.(reason,detail);}catch{}return null;};
|
|
22
|
+
let refusal:string|undefined;
|
|
23
|
+
const request=relay.open(action,input,current,expiresAt,reason=>{refusal=reason;});if(!request)return fail('unavailable',refusal);
|
|
24
|
+
const controller=new AbortController();let localValue:T|undefined;
|
|
25
|
+
void local(controller.signal).then(answer=>{if(answer){if(request.human(answer.decision,'local-ui'))localValue=answer.value;}else request.cancel();},()=>request.cancel());
|
|
26
|
+
const outcome=await request.result;controller.abort();
|
|
27
|
+
if(outcome.status!=='decided')return fail(outcome.status);
|
|
28
|
+
try{audit({schema:'permission-surface-decision/v1',permissionId:request.id,actionDigest:request.actionDigest,taskId:action.taskId,inputRevision:action.inputRevision,...permissionAuditOutcome(outcome)});}catch{request.applied(false);return fail('audit_failed');}
|
|
29
|
+
let used=false;
|
|
30
|
+
return {decision:outcome.decision,source:outcome.source,localValue:outcome.source==='local_human'?localValue:undefined,consume(){
|
|
31
|
+
if(used)return false;used=true;let valid=false;try{valid=outcome.decision==='allow_once'&&request.valid()&¤t();}catch{}request.applied(valid);return valid;
|
|
32
|
+
}};
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export function registerPermissionRelay(key:object|undefined|null,relay:PermissionRelay){
|
|
36
|
+
if(!key||typeof key!=='object')return ()=>{};
|
|
37
|
+
relays.set(key,relay);const events=key as {emit?:unknown;on?:(channel:string,listener:(data:any)=>void)=>()=>void};
|
|
38
|
+
const off=typeof events.emit==='function'?events.on?.('fleet:permission-relay:resolve',data=>{if(typeof data?.reply==='function')data.reply(relay);}):undefined;
|
|
39
|
+
return ()=>{off?.();if(relays.get(key)===relay)relays.delete(key);};
|
|
40
|
+
}
|
|
41
|
+
export function permissionRelayFor(key:object|undefined|null){
|
|
42
|
+
if(!key||typeof key!=='object')return undefined;
|
|
43
|
+
const direct=relays.get(key);if(direct)return direct;
|
|
44
|
+
// Pi extensions have different facades over the same in-process event bus.
|
|
45
|
+
const found=new Set<PermissionRelay>();(key as {emit?:(channel:string,data:unknown)=>void}).emit?.('fleet:permission-relay:resolve',{reply:(relay:PermissionRelay)=>found.add(relay)});
|
|
46
|
+
return found.size===1?[...found][0]:undefined;
|
|
47
|
+
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/** Metadata-only observations. These messages never carry permission or evidence authority. */
|
|
2
|
+
export const EXECUTION_TRACE_CHANNEL = "agent-fleet:execution-trace";
|
|
3
|
+
export const TRACE_OWNER_ENV = "AGENT_FLEET_TRACE_OWNER";
|
|
4
|
+
export type TraceKind = "input" | "turn" | "model" | "tool" | "policy" | "approval" | "queue" | "child";
|
|
5
|
+
export type TraceSource = "runtime" | "native" | "process" | "task-triage" | "damage-control" | "damage-guard" | "access-escalation";
|
|
6
|
+
export type TraceStatus = "pending" | "completed" | "failed" | "allowed" | "denied" | "blocked" | "cancelled" | "interrupted" | "unavailable" | "reused" | "not_started" | "busy";
|
|
7
|
+
export interface TraceStart {
|
|
8
|
+
kind: TraceKind; id: string; owner?: string; parentId?: string; parentKind?: TraceKind;
|
|
9
|
+
source?: TraceSource; tool?: string; rule?: string; reason?: string; fingerprint?: string; actor?: string;
|
|
10
|
+
}
|
|
11
|
+
export interface TraceEnd { status: TraceStatus; durationMs?: number; childId?: string; rule?: string; reason?: string; analysis?: "static_operands" | "conservative_text"; decision?: "selected_first" | "selected_second" | "freeform" | "multiple" | "none"; }
|
|
12
|
+
export interface TraceBus { emit(channel: string, value: unknown): void; }
|
|
13
|
+
export interface TraceEnvelope { start: TraceStart; end?: TraceEnd; token?: object; finish?: (end: TraceEnd) => void; }
|
|
14
|
+
|
|
15
|
+
/** The collector supplies a session-fenced completion callback synchronously. */
|
|
16
|
+
export function beginRuntimeTrace(bus: TraceBus | undefined, start: TraceStart): (end: TraceEnd) => void {
|
|
17
|
+
const envelope: TraceEnvelope = { start };
|
|
18
|
+
try { bus?.emit(EXECUTION_TRACE_CHANNEL, envelope); } catch { /* Diagnostic only. */ }
|
|
19
|
+
return end => { try { envelope.finish?.(end); } catch { /* Diagnostic only. */ } };
|
|
20
|
+
}
|
|
21
|
+
export function emitRuntimeTrace(bus: TraceBus | undefined, signal: TraceStart & {status: TraceStatus}): void {
|
|
22
|
+
beginRuntimeTrace(bus, signal)({ status: signal.status });
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Record answer shape, never answer text or inferred permission semantics. */
|
|
26
|
+
export function traceAskResult(result: unknown, options: readonly unknown[]): TraceEnd {
|
|
27
|
+
const value = result as { isError?: boolean; details?: { cancelled?: boolean; response?: { kind?: string; selections?: unknown[] } } } | null;
|
|
28
|
+
if (value?.isError) return { status: "failed" };
|
|
29
|
+
if (value?.details?.cancelled) return { status: "cancelled", decision: "none" };
|
|
30
|
+
const response = value?.details?.response;
|
|
31
|
+
const selections = response?.selections ?? [];
|
|
32
|
+
const label = (option: unknown) => typeof option === "string" ? option : (option as {title?:unknown})?.title;
|
|
33
|
+
const index = selections.length === 1 ? options.findIndex(option => label(option) === selections[0]) : -1;
|
|
34
|
+
return { status: "completed",
|
|
35
|
+
decision: response?.kind === "freeform" ? "freeform" : selections.length > 1 ? "multiple" : index === 0 ? "selected_first" : index === 1 ? "selected_second" : "none" };
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function policyTraceReason(text:string):string {
|
|
39
|
+
if(/zero.access|Glob matches|Find pattern matches/i.test(text))return 'zero_access';
|
|
40
|
+
if(/read.only/i.test(text))return 'read_only';
|
|
41
|
+
if(/delete\/move protected|no.delete/i.test(text))return 'no_delete';
|
|
42
|
+
if(/authority changed|revoked/i.test(text))return 'authority_changed';
|
|
43
|
+
if(/user denied|keep blocked/i.test(text))return 'human_denial';
|
|
44
|
+
return 'policy_rule';
|
|
45
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
[
|
|
2
|
+
{"name":"greeting","plane":"hub","prompt":"stable core policy","tools":["ask_user"]},
|
|
3
|
+
{"name":"direct-coding","plane":"hub","prompt":"stable direct coding policy","tools":["read","edit","write","bash"]},
|
|
4
|
+
{"name":"fleet","plane":"hub","prompt":"stable fleet policy","tools":["dispatch_agent","spawn_research","set_task_tier"]},
|
|
5
|
+
{"name":"verification","plane":"hub","prompt":"stable verification policy","tools":["set_assertions","update_assertion","get_assertions"]},
|
|
6
|
+
{"name":"peer","plane":"hub","prompt":"stable peer policy","tools":["coms_list","coms_send","coms_await"]},
|
|
7
|
+
{"name":"workspace","plane":"hub","prompt":"stable workspace policy","tools":["herdr_spawn_peer","herdr_read_pane","herdr_close_pane"]},
|
|
8
|
+
{"name":"compaction-full-fleet","plane":"hub","prompt":"stable full fleet policy","tools":["dispatch_agent","spawn_research","request_compaction","coms_send","herdr_spawn_pane"]},
|
|
9
|
+
{"name":"research-helper","plane":"research","prompt":"read-only research policy","tools":["read","grep","find","ls"]},
|
|
10
|
+
{"name":"specialist","plane":"specialist","prompt":"specialist policy","tools":["read","edit","write","bash"]}
|
|
11
|
+
]
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
You are the Fleet operator. You may work on the codebase directly and may also coordinate specialist agents when delegation adds value. You have these tools: `dispatch_agent`, `spawn_research`.
|
|
2
|
+
|
|
3
|
+
## Language
|
|
4
|
+
- ALWAYS communicate with the human user in **English**.
|
|
5
|
+
|
|
6
|
+
## Native Roster: default
|
|
7
|
+
Members: Builder, Reviewer
|
|
8
|
+
You can ONLY dispatch to agents listed below. Do not attempt to dispatch to agents
|
|
9
|
+
outside this team. The roster CAN change mid-session: the human via /af-agents-add,
|
|
10
|
+
/af-agents-drop, /af-agents-team — or you via `team_adjust` (add/drop with a reason)
|
|
11
|
+
when the current roster genuinely cannot serve the task. Use it sparingly; more
|
|
12
|
+
personas is usually the wrong answer.
|
|
13
|
+
|
|
14
|
+
## How to Work
|
|
15
|
+
- Analyze the user's request and break it into clear sub-tasks.
|
|
16
|
+
- Choose the right agent(s) for each sub-task.
|
|
17
|
+
- Dispatch tasks via `dispatch_agent`.
|
|
18
|
+
- Choose `backend: native` when the user explicitly requests a local Pi specialist, `backend: coms` when they explicitly request a live same-name peer, and `backend: auto` otherwise. Never substitute one explicit backend for another.
|
|
19
|
+
- Review results and dispatch follow-up agents if needed.
|
|
20
|
+
- If a task fails, try a different agent or adjust the task description.
|
|
21
|
+
- Summarize the outcome for the user in English.
|
|
22
|
+
|
|
23
|
+
## ask_user is NOT available in this session
|
|
24
|
+
|
|
25
|
+
## Task triage (before dispatch)
|
|
26
|
+
## Verification Contract
|
|
27
|
+
|
|
28
|
+
## Research helpers (read-only)
|
|
29
|
+
- `spawn_research` runs a READ-ONLY helper (read/grep/find/ls — no bash, no writes)
|
|
30
|
+
and returns its findings to you inline. Use it for reconnaissance, code search, and
|
|
31
|
+
reading docs/code BEFORE you dispatch a builder — or to fan out background research.
|
|
32
|
+
- Two flavours: pass `persona` to spawn one of the research personas listed below (it
|
|
33
|
+
brings its own role/model); omit `persona` for an ad-hoc helper (optional `model`).
|
|
34
|
+
- Match the helper to the job: use a lighter/faster persona for simple reads and a
|
|
35
|
+
higher-capability one for ambiguous, cross-cutting, or high-stakes research. Compare
|
|
36
|
+
the **Model** / **Thinking** shown for each persona below and pick deliberately.
|
|
37
|
+
- Specialists you dispatch are sandboxed and CANNOT spawn their own helpers. When a
|
|
38
|
+
specialist needs research help, YOU run `spawn_research`, collect the findings, and
|
|
39
|
+
fold them into the specialist's task — do not ask the specialist to do it itself.
|
|
40
|
+
- Research helpers are ephemeral and read-only, so they are always safe to run.
|
|
41
|
+
|
|
42
|
+
## Hard Rules
|
|
43
|
+
- You MAY read, execute, edit, and write directly in operator work mode.
|
|
44
|
+
- Use direct tools for focused work when they are the simplest path; delegate when specialization, parallelism, or independent verification adds value.
|
|
45
|
+
- Give concurrent writable agents explicit non-overlapping scopes and inspect overlap warnings before proceeding.
|
|
46
|
+
- NEVER proceed past an ambiguity by guessing.
|
|
47
|
+
- You can chain agents: spawn_research to gather context, builder to implement.
|
|
48
|
+
- You can dispatch the same agent multiple times with different tasks.
|
|
49
|
+
- Keep tasks focused — one clear objective per dispatch.
|
|
50
|
+
|
|
51
|
+
## Agents
|
|
52
|
+
|
|
53
|
+
### Builder
|
|
54
|
+
**Dispatch as:** `builder`
|
|
55
|
+
Implements slices.
|
|
56
|
+
**Tools:** read,write
|
|
57
|
+
|
|
58
|
+
### Reviewer
|
|
59
|
+
**Dispatch as:** `reviewer`
|
|
60
|
+
Reviews code.
|
|
61
|
+
**Tools:** read
|
|
62
|
+
|
|
63
|
+
## Research personas
|
|
64
|
+
|
|
65
|
+
### Deep Researcher
|
|
66
|
+
**Spawn as:** `spawn_research(persona: "deep-researcher")`
|
|
67
|
+
**Model:** local · **Thinking:** off
|
|
68
|
+
Cross-cutting recon.
|
|
69
|
+
|
|
70
|
+
### Coverage Scout
|
|
71
|
+
**Spawn as:** `spawn_research(persona: "coverage-scout")`
|
|
72
|
+
**Model:** local · **Thinking:** off
|
|
73
|
+
Test inventory.
|