@chankov/agent-fleet 1.0.1 → 1.0.2
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/extensions/package-lock.json +77 -45
- package/.pi/harnesses/agent-hub/README.md +109 -18
- package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.pi/harnesses/agent-hub/hub-state-audit.js +18 -0
- package/.pi/harnesses/agent-hub/index.ts +988 -422
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/posture.ts +72 -17
- package/.pi/harnesses/agent-hub/run-budget.js +12 -13
- package/.pi/harnesses/agent-hub/spawn.ts +14 -2
- package/.pi/harnesses/ask-user-remote/index.ts +59 -4
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
- package/.pi/harnesses/package-lock.json +73 -80
- package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
- package/.versions/1.0.2/.pi/extensions/package.json +9 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.2/.version +1 -0
- package/.versions/1.0.2/agents/architect.md +24 -0
- package/.versions/1.0.2/agents/bowser.md +27 -0
- package/.versions/1.0.2/agents/builder.md +54 -0
- package/.versions/1.0.2/agents/code-reviewer.md +208 -0
- package/.versions/1.0.2/agents/deep-researcher.md +32 -0
- package/.versions/1.0.2/agents/documenter.md +18 -0
- package/.versions/1.0.2/agents/orchestrator.md +20 -0
- package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.2/agents/planner.md +70 -0
- package/.versions/1.0.2/agents/releaser.md +24 -0
- package/.versions/1.0.2/agents/researcher.md +28 -0
- package/.versions/1.0.2/agents/security-auditor.md +167 -0
- package/.versions/1.0.2/agents/test-engineer.md +153 -0
- package/.versions/1.0.2/agents/web-debugger.md +43 -0
- package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
- package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
- package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.2/docs/getting-started.md +98 -0
- package/.versions/1.0.2/docs/npm-install.md +292 -0
- package/.versions/1.0.2/docs/pi-extensions.md +439 -0
- package/.versions/1.0.2/docs/pi-setup.md +74 -0
- package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.2/hermes/README.md +347 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.2/install-manifest.json +2745 -0
- package/.versions/1.0.2/justfile +272 -0
- package/.versions/1.0.2/manifest-meta.json +882 -0
- package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.2/references/definition-of-done.md +67 -0
- package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.2/references/observability-checklist.md +91 -0
- package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.2/references/performance-checklist.md +153 -0
- package/.versions/1.0.2/references/prompting-patterns.md +380 -0
- package/.versions/1.0.2/references/security-checklist.md +179 -0
- package/.versions/1.0.2/references/testing-patterns.md +236 -0
- package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.2/scripts/fleet.ts +185 -0
- package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.2/scripts/team-up.ts +406 -0
- package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +9 -0
- package/README.md +4 -2
- package/agents/orchestrator.md +4 -56
- package/docs/ARCHITECTURE.md +48 -16
- package/docs/agent-fleet-setup.md +33 -2
- package/docs/pi-extensions.md +29 -2
- package/install-manifest.json +2 -2
- package/package.json +2 -2
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
// Drift watchdog — the pure policy core behind in-flight specialist
|
|
2
|
+
// observation. Layer 1 is deterministic rules over the child's tool event
|
|
3
|
+
// stream (zero tokens); a firing rule is an ESCALATION SIGNAL, not a verdict —
|
|
4
|
+
// the harness then asks a cheap LLM judge (layer 2) whether the run is still
|
|
5
|
+
// on task, and only a DRIFTING/STUCK verdict terminates it (`drift_stop`).
|
|
6
|
+
// Everything here is data + pure functions so the policy is unit-testable
|
|
7
|
+
// away from the harness.
|
|
8
|
+
|
|
9
|
+
import { checkScope } from "./scope-gate.js";
|
|
10
|
+
|
|
11
|
+
export const WATCHDOG_SETTINGS = ["on", "off", "auto"];
|
|
12
|
+
export const DEFAULT_WATCHDOG_SETTING = "auto";
|
|
13
|
+
|
|
14
|
+
/** "On", " AUTO " → canonical setting, or null when unrecognized. */
|
|
15
|
+
export function normalizeWatchdogSetting(value) {
|
|
16
|
+
const v = String(value ?? "").trim().toLowerCase();
|
|
17
|
+
return WATCHDOG_SETTINGS.includes(v) ? v : null;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Is the watchdog armed for one dispatch? Precedence: the dispatch_agent
|
|
22
|
+
* `watchdog` param (boolean) > the per-agent /af-watchdog override ("on"/"off")
|
|
23
|
+
* > the hub-wide setting ("on"/"auto" arm, "off" disarms).
|
|
24
|
+
*/
|
|
25
|
+
export function resolveWatchdogActive(dispatchParam, agentOverride, hubSetting) {
|
|
26
|
+
if (dispatchParam === true) return true;
|
|
27
|
+
if (dispatchParam === false) return false;
|
|
28
|
+
if (agentOverride === "on") return true;
|
|
29
|
+
if (agentOverride === "off") return false;
|
|
30
|
+
return normalizeWatchdogSetting(hubSetting) !== "off";
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// Conservative thresholds: a false positive kills a productive run, so every
|
|
34
|
+
// rule needs sustained evidence before it fires.
|
|
35
|
+
export const DRIFT_DEFAULTS = {
|
|
36
|
+
writeTools: ["write", "edit"],
|
|
37
|
+
maxRepeats: 4,
|
|
38
|
+
maxConsecutiveFailures: 5,
|
|
39
|
+
maxToolCalls: 200,
|
|
40
|
+
trailLimit: 60,
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
/** Session subtrees the hub itself tells specialists to write into. */
|
|
44
|
+
export const HUB_OWNED_SUBDIRS = ["artifacts", "findings", "delegations"];
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Globs for the paths the deliverable protocol ORDERS the specialist to write
|
|
48
|
+
* (`artifacts/<kind>/<agentKey>-run<N>.md` and friends). A dispatcher's `scope:`
|
|
49
|
+
* never lists them, so checking writes against the declared scope alone made the
|
|
50
|
+
* hub punish obedience: `planner` was killed after 1088s and `documenter` after
|
|
51
|
+
* 120s for writing exactly where they were told to.
|
|
52
|
+
*
|
|
53
|
+
* Pass every form the path can arrive in — the absolute session dir and its
|
|
54
|
+
* repo-relative twin — since the specialist may use either.
|
|
55
|
+
*/
|
|
56
|
+
export function hubOwnedScopeGlobs(...sessionDirs) {
|
|
57
|
+
const globs = [];
|
|
58
|
+
for (const dir of sessionDirs) {
|
|
59
|
+
const base = String(dir || "").trim().replace(/\\/g, "/").replace(/\/+$/, "");
|
|
60
|
+
if (!base) continue;
|
|
61
|
+
for (const sub of HUB_OWNED_SUBDIRS) globs.push(`${base}/${sub}/**`);
|
|
62
|
+
}
|
|
63
|
+
return [...new Set(globs)];
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const pathFromArgs = (argStr) => {
|
|
67
|
+
try {
|
|
68
|
+
const args = JSON.parse(argStr || "{}");
|
|
69
|
+
for (const key of ["path", "file_path", "filePath", "file", "filename"]) {
|
|
70
|
+
if (typeof args[key] === "string" && args[key].trim()) return args[key].trim();
|
|
71
|
+
}
|
|
72
|
+
} catch {}
|
|
73
|
+
return null;
|
|
74
|
+
};
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Per-run monitor fed from the tool event stream. `onToolStart(tool, argStr)`
|
|
78
|
+
* and `onToolEnd(tool, isError)` return `null` while the run looks healthy, or
|
|
79
|
+
* `{ rule, terminal, detail }` when a rule crosses its threshold:
|
|
80
|
+
* scope — a write-capable tool touched a path outside the declared scope
|
|
81
|
+
* loop — the exact same (tool, args) call repeated maxRepeats times
|
|
82
|
+
* failures — maxConsecutiveFailures failed tool calls in a row
|
|
83
|
+
* toolcap — maxToolCalls total tool calls in one run
|
|
84
|
+
* Each rule instance fires once (at the crossing), so the caller escalates —
|
|
85
|
+
* it never gets spammed. `trail(n)` returns the recent tool trail for the judge.
|
|
86
|
+
*
|
|
87
|
+
* `terminal: false` marks a signal that must never end a run on its own: the
|
|
88
|
+
* post-run scope gate is advisory by design ("nothing is auto-reverted"), so the
|
|
89
|
+
* live rule watching the same thing cannot be a death sentence. `scope` reports;
|
|
90
|
+
* only the genuinely stuck rules stop work.
|
|
91
|
+
*/
|
|
92
|
+
export function createDriftMonitor(cfg = {}) {
|
|
93
|
+
const scopeGlobs = (cfg.scopeGlobs || []).filter(Boolean);
|
|
94
|
+
const allowGlobs = (cfg.allowGlobs || []).filter(Boolean);
|
|
95
|
+
// A path in EITHER the declared scope or the hub-owned allowlist is in scope.
|
|
96
|
+
const effectiveScope = [...scopeGlobs, ...allowGlobs];
|
|
97
|
+
const writeTools = new Set(cfg.writeTools || DRIFT_DEFAULTS.writeTools);
|
|
98
|
+
const maxRepeats = cfg.maxRepeats ?? DRIFT_DEFAULTS.maxRepeats;
|
|
99
|
+
const maxConsecutiveFailures = cfg.maxConsecutiveFailures ?? DRIFT_DEFAULTS.maxConsecutiveFailures;
|
|
100
|
+
const maxToolCalls = cfg.maxToolCalls ?? DRIFT_DEFAULTS.maxToolCalls;
|
|
101
|
+
const trailLimit = cfg.trailLimit ?? DRIFT_DEFAULTS.trailLimit;
|
|
102
|
+
|
|
103
|
+
const callCounts = new Map();
|
|
104
|
+
const trailLines = [];
|
|
105
|
+
let totalCalls = 0;
|
|
106
|
+
let consecutiveFailures = 0;
|
|
107
|
+
|
|
108
|
+
const pushTrail = (line) => {
|
|
109
|
+
trailLines.push(line);
|
|
110
|
+
if (trailLines.length > trailLimit) trailLines.shift();
|
|
111
|
+
};
|
|
112
|
+
|
|
113
|
+
return {
|
|
114
|
+
onToolStart(toolName, argStr) {
|
|
115
|
+
totalCalls++;
|
|
116
|
+
pushTrail(`${toolName} ${String(argStr || "").slice(0, 120)}`.trim());
|
|
117
|
+
|
|
118
|
+
if (scopeGlobs.length > 0 && writeTools.has(toolName)) {
|
|
119
|
+
const path = pathFromArgs(argStr);
|
|
120
|
+
if (path && checkScope([path], effectiveScope).outOfScope.length > 0) {
|
|
121
|
+
return {
|
|
122
|
+
rule: "scope",
|
|
123
|
+
terminal: false,
|
|
124
|
+
detail: `${toolName} touched ${path} — outside the declared scope (${scopeGlobs.join(", ")})`,
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
const fingerprint = `${toolName}::${argStr || ""}`;
|
|
130
|
+
const count = (callCounts.get(fingerprint) || 0) + 1;
|
|
131
|
+
callCounts.set(fingerprint, count);
|
|
132
|
+
if (count === maxRepeats) {
|
|
133
|
+
return { rule: "loop", terminal: true, detail: `${toolName} called ${count}× with identical arguments — likely stuck in a loop` };
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
if (totalCalls === maxToolCalls) {
|
|
137
|
+
return { rule: "toolcap", terminal: true, detail: `${totalCalls} tool calls in one run — far beyond a focused task` };
|
|
138
|
+
}
|
|
139
|
+
return null;
|
|
140
|
+
},
|
|
141
|
+
|
|
142
|
+
onToolEnd(_toolName, isError) {
|
|
143
|
+
if (isError === true) {
|
|
144
|
+
consecutiveFailures++;
|
|
145
|
+
pushTrail(" ↳ FAILED");
|
|
146
|
+
if (consecutiveFailures % maxConsecutiveFailures === 0) {
|
|
147
|
+
return { rule: "failures", terminal: true, detail: `${consecutiveFailures} consecutive failed tool calls — no forward progress` };
|
|
148
|
+
}
|
|
149
|
+
} else if (isError === false) {
|
|
150
|
+
consecutiveFailures = 0;
|
|
151
|
+
}
|
|
152
|
+
// isError undefined: the stream carries no error flag — rule stays inert.
|
|
153
|
+
return null;
|
|
154
|
+
},
|
|
155
|
+
|
|
156
|
+
trail(n = 40) {
|
|
157
|
+
return trailLines.slice(-n);
|
|
158
|
+
},
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* The one-shot judge prompt: original task + declared scope + recent trail +
|
|
164
|
+
* the rule that fired. The judge answers with a single machine-parseable line.
|
|
165
|
+
*/
|
|
166
|
+
export function buildJudgePrompt({ agent, task, scopeGlobs = [], hubOwnedGlobs = [], trail = [], violation }) {
|
|
167
|
+
const scopeBlock = scopeGlobs.length > 0
|
|
168
|
+
? `\n## Declared file scope\n${scopeGlobs.map(s => `- ${s}`).join("\n")}\n`
|
|
169
|
+
: "";
|
|
170
|
+
// Without this block the judge reads a protocol-mandated artifact write as
|
|
171
|
+
// rogue behaviour and answers DRIFTING — which is how obedient runs got killed.
|
|
172
|
+
const hubOwnedBlock = hubOwnedGlobs.length > 0
|
|
173
|
+
? `\n## Hub-owned paths (writing here is REQUIRED, never drift)\nThe dispatcher orders every specialist to write its deliverable to these paths. ` +
|
|
174
|
+
`They are outside the declared scope by design — treat writes here as on-task:\n${hubOwnedGlobs.map(s => `- ${s}`).join("\n")}\n`
|
|
175
|
+
: "";
|
|
176
|
+
const advisoryBlock = violation?.terminal === false
|
|
177
|
+
? `\nThis signal is ADVISORY: it cannot stop the run by itself. Answer honestly about the whole trail, ` +
|
|
178
|
+
`not about this one write.\n`
|
|
179
|
+
: "";
|
|
180
|
+
return `You are a drift watchdog judging whether a running coding agent is still on task.
|
|
181
|
+
Do not solve the task. Judge only whether the agent's recent actions serve it.
|
|
182
|
+
|
|
183
|
+
## Agent
|
|
184
|
+
${agent}
|
|
185
|
+
|
|
186
|
+
## Original task (verbatim)
|
|
187
|
+
${task}
|
|
188
|
+
${scopeBlock}${hubOwnedBlock}
|
|
189
|
+
## Escalation signal
|
|
190
|
+
Rule "${violation?.rule || "unknown"}" fired: ${violation?.detail || "(no detail)"}
|
|
191
|
+
${advisoryBlock}
|
|
192
|
+
|
|
193
|
+
## Recent tool trail (oldest first)
|
|
194
|
+
${trail.length > 0 ? trail.join("\n") : "(no tool calls recorded)"}
|
|
195
|
+
|
|
196
|
+
## Your answer
|
|
197
|
+
Reply with EXACTLY one line, nothing else:
|
|
198
|
+
VERDICT: ON_TRACK — <why the actions still serve the task>
|
|
199
|
+
VERDICT: DRIFTING — <what the agent is doing instead of the task>
|
|
200
|
+
VERDICT: STUCK — <the loop or dead end it cannot escape>
|
|
201
|
+
Prefer ON_TRACK unless the trail clearly contradicts the task: false alarms kill
|
|
202
|
+
productive work.`;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** Parse the judge's reply. Returns { verdict, reason } or null when unparseable. */
|
|
206
|
+
export function parseJudgeVerdict(text) {
|
|
207
|
+
const matches = [...String(text ?? "").matchAll(/VERDICT:\s*(ON_TRACK|DRIFTING|STUCK)\s*(?:[—:-]\s*(.*))?/gi)];
|
|
208
|
+
if (matches.length === 0) return null;
|
|
209
|
+
const last = matches[matches.length - 1];
|
|
210
|
+
return { verdict: last[1].toLowerCase(), reason: (last[2] || "").trim() };
|
|
211
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { isAbsolute, relative, resolve } from "node:path";
|
|
2
|
+
|
|
3
|
+
const KNOWN_TAGS = new Set(["test", "runtime-ui", "code-grep", "manual"]);
|
|
4
|
+
|
|
5
|
+
export function validateEvidence(tag, evidence, options = {}) {
|
|
6
|
+
const normalizedTag = String(tag || "").trim().toLowerCase();
|
|
7
|
+
const text = String(evidence || "").trim();
|
|
8
|
+
if (!KNOWN_TAGS.has(normalizedTag)) {
|
|
9
|
+
return { ok: false, reason: `Unknown assertion tag "${tag}"; expected one of test, runtime-ui, code-grep, manual.` };
|
|
10
|
+
}
|
|
11
|
+
if (!text) return { ok: false, reason: "Evidence is required." };
|
|
12
|
+
|
|
13
|
+
if (normalizedTag === "test") return validateTestEvidence(text);
|
|
14
|
+
if (normalizedTag === "runtime-ui") return validateRuntimeUiEvidence(text, options);
|
|
15
|
+
if (normalizedTag === "code-grep") return validateCodeGrepEvidence(text);
|
|
16
|
+
if (normalizedTag === "manual") return validateManualEvidence(text);
|
|
17
|
+
return { ok: false, reason: `Unknown assertion tag "${tag}".` };
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
function validateTestEvidence(text) {
|
|
21
|
+
const hasIdentifier = /(?:\b(?:npm|pnpm|yarn|node|npx|vitest|jest|pytest|playwright|cargo|go test|bun)\b|\btest(?:s| name| file)?\b|`[^`]+`)/i.test(text);
|
|
22
|
+
const hasOutcome = /(?:\bpass(?:ed|es)?\b|\bgreen\b|\bok\b|\bexit\s*0\b|\b0\s+fail(?:ed|ures)?\b|\b\d+\/\d+\b|✓|✔)/i.test(text);
|
|
23
|
+
if (!hasIdentifier && !hasOutcome) return { ok: false, reason: "Test evidence must name the command/test identifier and its outcome." };
|
|
24
|
+
if (!hasIdentifier) return { ok: false, reason: "Test evidence must name the command or test identifier." };
|
|
25
|
+
if (!hasOutcome) return { ok: false, reason: "Test evidence must include the test outcome (pass/fail count, exit status, or equivalent)." };
|
|
26
|
+
return { ok: true };
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function validateRuntimeUiEvidence(text, options) {
|
|
30
|
+
const candidates = extractPathCandidates(text).filter((p) => /(?:^|\/)artifacts\/evidence\//.test(normalizePath(p)));
|
|
31
|
+
if (candidates.length === 0) {
|
|
32
|
+
return { ok: false, reason: "Runtime-ui evidence must reference a session artifact path under artifacts/evidence/." };
|
|
33
|
+
}
|
|
34
|
+
const fileExists = typeof options.fileExists === "function" ? options.fileExists : () => false;
|
|
35
|
+
const evidenceRoot = options.evidenceRoot ? resolve(options.evidenceRoot) : null;
|
|
36
|
+
const resolvedCandidates = candidates.map((p) => resolveSessionEvidenceCandidate(p, evidenceRoot)).filter(Boolean);
|
|
37
|
+
if (resolvedCandidates.length === 0) {
|
|
38
|
+
return { ok: false, reason: "Runtime-ui evidence must reference a session artifact evidence path, not a repo-local ./artifacts path." };
|
|
39
|
+
}
|
|
40
|
+
const existing = resolvedCandidates.find((p) => {
|
|
41
|
+
try { return fileExists(p); } catch { return false; }
|
|
42
|
+
});
|
|
43
|
+
if (!existing) {
|
|
44
|
+
return { ok: false, reason: `Runtime-ui evidence artifact does not exist: ${resolvedCandidates[0]}.` };
|
|
45
|
+
}
|
|
46
|
+
return { ok: true };
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function validateCodeGrepEvidence(text) {
|
|
50
|
+
const hasPattern = /(?:\bpattern\s*:|\bregex\s*:|\bgrep\b|`[^`]+`|\/[^/]+\/)/i.test(text);
|
|
51
|
+
const hasSample = /(?:\bmatch(?:ed|es)?\b|\bno[- ]?match(?:es)?\b|\b0\s+matches\b|\bfound\b|\bnot found\b|[\w./-]+:\d+)/i.test(text);
|
|
52
|
+
if (!hasPattern && !hasSample) return { ok: false, reason: "Code-grep evidence must include the searched pattern and a match/no-match result sample." };
|
|
53
|
+
if (!hasPattern) return { ok: false, reason: "Code-grep evidence must include the searched pattern." };
|
|
54
|
+
if (!hasSample) return { ok: false, reason: "Code-grep evidence must include a match/no-match result sample." };
|
|
55
|
+
return { ok: true };
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function validateManualEvidence(text) {
|
|
59
|
+
const hasConfirmation = /(?:\bask_user\b|\bhuman\s+confirm(?:ed|ation)\b|\buser\s+(?:confirmed|said|approved|chose|answered)\b|\bmanual\s+confirm(?:ed|ation)\b|"[^"]+")/i.test(text);
|
|
60
|
+
if (!hasConfirmation) return { ok: false, reason: "Manual evidence must reference the ask_user answer or explicit user confirmation." };
|
|
61
|
+
return { ok: true };
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function extractPathCandidates(text) {
|
|
65
|
+
const out = [];
|
|
66
|
+
const re = /(?:^|[\s(\[])(["']?)([^"'\s)\]]*(?:\.pi\/agent-sessions\/)?artifacts\/evidence\/[^"'\s)\]]+)\1/g;
|
|
67
|
+
let match;
|
|
68
|
+
while ((match = re.exec(text))) out.push(match[2].replace(/[.,;:]+$/, ""));
|
|
69
|
+
return out;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function resolveSessionEvidenceCandidate(candidate, evidenceRoot) {
|
|
73
|
+
const raw = String(candidate || "").trim();
|
|
74
|
+
const normalized = normalizePath(raw);
|
|
75
|
+
if (normalized.startsWith("./artifacts/evidence/")) return null;
|
|
76
|
+
if (evidenceRoot && normalized.startsWith("artifacts/evidence/")) {
|
|
77
|
+
return resolve(evidenceRoot, normalized.slice("artifacts/evidence/".length));
|
|
78
|
+
}
|
|
79
|
+
if (evidenceRoot && normalized.startsWith(".pi/agent-sessions/artifacts/evidence/")) {
|
|
80
|
+
return resolve(evidenceRoot, normalized.slice(".pi/agent-sessions/artifacts/evidence/".length));
|
|
81
|
+
}
|
|
82
|
+
if (isAbsolute(raw)) {
|
|
83
|
+
const abs = resolve(raw);
|
|
84
|
+
return !evidenceRoot || isWithin(evidenceRoot, abs) ? abs : null;
|
|
85
|
+
}
|
|
86
|
+
return null;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function isWithin(root, target) {
|
|
90
|
+
const rel = relative(resolve(root), resolve(target));
|
|
91
|
+
return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel));
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
function normalizePath(value) {
|
|
95
|
+
return String(value || "").replace(/\\/g, "/");
|
|
96
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
// External-blocker circuit breaker — the pure policy core behind "stop when the
|
|
2
|
+
// thing you need is not yours to get".
|
|
3
|
+
//
|
|
4
|
+
// The observed failure: a runtime-telemetry assertion could not be proven
|
|
5
|
+
// because the correlation destination did not exist outside the fleet. Nothing
|
|
6
|
+
// stopped the line, so the run kept substituting internal work for the missing
|
|
7
|
+
// external fact — building manifests, fixtures, and diagnostic packets — for
|
|
8
|
+
// hours, and the assertion ended UNPROVEN anyway. An external blocker is not a
|
|
9
|
+
// harder version of the task; it is the end of what delegation can buy.
|
|
10
|
+
//
|
|
11
|
+
// Protocol: a specialist that cannot proceed without something outside the
|
|
12
|
+
// fleet's reach emits `EXTERNAL_BLOCKED: <what is missing and who owns it>`.
|
|
13
|
+
// The hub records it and refuses the NEXT dispatch/research until the human has
|
|
14
|
+
// been addressed — the escalation is the deliverable at that point.
|
|
15
|
+
|
|
16
|
+
/** Pull `EXTERNAL_BLOCKED: …` markers out of a specialist's output. */
|
|
17
|
+
export function extractExternalBlockers(output) {
|
|
18
|
+
const blockers = [];
|
|
19
|
+
for (const rawLine of String(output || "").split("\n")) {
|
|
20
|
+
const line = rawLine.trim();
|
|
21
|
+
const match = line.match(/^EXTERNAL_BLOCKED\s*:\s*(.+)$/i);
|
|
22
|
+
if (match) {
|
|
23
|
+
const what = match[1].trim();
|
|
24
|
+
if (what && !blockers.includes(what)) blockers.push(what);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return blockers;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Gate the next dispatcher call while an external blocker is unacknowledged.
|
|
32
|
+
*
|
|
33
|
+
* state: {
|
|
34
|
+
* blockers: [{ agent, what }], // recorded, newest last
|
|
35
|
+
* acknowledged: boolean, // human addressed (ask_user called, or new user turn)
|
|
36
|
+
* askUserAvailable: boolean, // whether this session has the ask_user tool
|
|
37
|
+
* refusedOnce: boolean, // a refusal was already issued for this blocker set
|
|
38
|
+
* }
|
|
39
|
+
*
|
|
40
|
+
* Returns null when allowed, else { reason, message }. Without ask_user the gate
|
|
41
|
+
* fires exactly once: a session that cannot reach the human must still be able
|
|
42
|
+
* to finish and report, and an unbreakable gate there is a deadlock, not a stop.
|
|
43
|
+
*/
|
|
44
|
+
export function checkExternalBlockerGate(state) {
|
|
45
|
+
const blockers = state?.blockers || [];
|
|
46
|
+
if (blockers.length === 0) return null;
|
|
47
|
+
if (state?.acknowledged) return null;
|
|
48
|
+
if (!state?.askUserAvailable && state?.refusedOnce) return null;
|
|
49
|
+
|
|
50
|
+
const list = blockers.map((b) => ` - ${b.what}${b.agent ? ` (reported by ${b.agent})` : ""}`).join("\n");
|
|
51
|
+
const escalation = state?.askUserAvailable
|
|
52
|
+
? "Call `ask_user` with the packet below. The gate opens as soon as you do."
|
|
53
|
+
: "`ask_user` is unavailable in this session: put the packet below in your reply to the human and stop " +
|
|
54
|
+
"this line of work. (This gate fires once; further dispatches are allowed so you can finish and report.)";
|
|
55
|
+
|
|
56
|
+
return {
|
|
57
|
+
reason: "external_blocked",
|
|
58
|
+
message: `⛔ EXTERNAL BLOCKER — dispatch refused and NOT counted against any budget.\n\n` +
|
|
59
|
+
`A specialist reported that it needs something outside the fleet's reach:\n${list}\n\n` +
|
|
60
|
+
`Do NOT route around this. Substituting internal work for a missing external fact — building ` +
|
|
61
|
+
`scripts, manifests, fixtures, or diagnostic packets to approximate it — is how a blocked ` +
|
|
62
|
+
`assertion turns into hours of work that still ends UNPROVEN.\n\n` +
|
|
63
|
+
`${escalation}\n\n` +
|
|
64
|
+
`Owner escalation packet (one message, no dispatches):\n` +
|
|
65
|
+
` 1. WHAT is missing and who owns it.\n` +
|
|
66
|
+
` 2. WHICH assertions/tasks are blocked on it, by id.\n` +
|
|
67
|
+
` 3. WHAT is already proven and where the evidence lives (artifact paths).\n` +
|
|
68
|
+
` 4. The concrete OPTIONS for the human: provide the missing access, waive the assertion as ` +
|
|
69
|
+
`UNPROVEN (a waiver is not a PASS), or drop the item from scope.\n` +
|
|
70
|
+
` 5. What you will do while it is blocked — normally: the unrelated remaining work, or nothing.`,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** The protocol paragraph injected into every specialist's system prompt. */
|
|
75
|
+
export function externalBlockedProtocol() {
|
|
76
|
+
return [
|
|
77
|
+
"- External blocker: if you cannot proceed because something OUTSIDE this repo and outside your",
|
|
78
|
+
" tools is missing — an account, a permission, a deployment credential, a telemetry/monitoring",
|
|
79
|
+
" destination, a third-party service, a human-only console action — do NOT build a substitute for",
|
|
80
|
+
" it and do NOT keep trying alternatives. Emit a line of the form",
|
|
81
|
+
" `EXTERNAL_BLOCKED: <what is missing, who owns it, and what it blocks>`, report what you DID",
|
|
82
|
+
" prove, and stop. The dispatcher escalates it to the human; approximating the missing fact with",
|
|
83
|
+
" extra scripts, fixtures, or manifests is the failure this protocol exists to prevent.",
|
|
84
|
+
].join("\n");
|
|
85
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { formatVersionLabel } from "./version.ts";
|
|
2
|
+
|
|
3
|
+
type FooterTheme = {
|
|
4
|
+
fg(color: string, text: string): string;
|
|
5
|
+
};
|
|
6
|
+
|
|
7
|
+
export function composeHubFooterLeft(
|
|
8
|
+
version: string | null,
|
|
9
|
+
model: string,
|
|
10
|
+
thinkingSuffix: string,
|
|
11
|
+
team: string,
|
|
12
|
+
): string {
|
|
13
|
+
return [version ? formatVersionLabel(version) : "", `${model}${thinkingSuffix}`, team]
|
|
14
|
+
.filter(Boolean)
|
|
15
|
+
.join(" · ");
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export function composeFleetFooterHint(viewMode: "compact" | "off"): string {
|
|
19
|
+
return `Alt+A fleet · Alt+Shift+A widget:${viewMode}`;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export function renderHubFooterLeft(
|
|
23
|
+
theme: FooterTheme,
|
|
24
|
+
version: string | null,
|
|
25
|
+
model: string,
|
|
26
|
+
thinkingSuffix: string,
|
|
27
|
+
team: string,
|
|
28
|
+
): string {
|
|
29
|
+
const metadata = [version ? formatVersionLabel(version) : "", `${model}${thinkingSuffix}`]
|
|
30
|
+
.filter(Boolean)
|
|
31
|
+
.join(" · ");
|
|
32
|
+
const dimMetadata = theme.fg("dim", ` ${metadata}`);
|
|
33
|
+
const separator = metadata && team ? theme.fg("muted", " · ") : "";
|
|
34
|
+
return dimMetadata + separator + (team ? theme.fg("accent", team) : "");
|
|
35
|
+
}
|