@chankov/agent-fleet 0.0.2 → 0.0.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/.claude/commands/doctor-agent-fleet.md +1 -1
- package/.claude/commands/setup-agent-fleet.md +5 -5
- package/.opencode/commands/af-doctor-agent-fleet.md +2 -0
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/agents/peers.yaml +4 -0
- package/.pi/agents/teams.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +254 -18
- package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.pi/harnesses/agent-hub/delegate.ts +32 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.pi/harnesses/agent-hub/helpers.ts +49 -0
- package/.pi/harnesses/agent-hub/index.ts +1269 -322
- package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.pi/harnesses/agent-hub/package.json +5 -4
- package/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.pi/harnesses/agent-hub/spawn.ts +161 -94
- package/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.pi/harnesses/ask-user-remote/README.md +2 -0
- package/.pi/harnesses/coms/README.md +21 -0
- package/.pi/harnesses/coms/index.ts +2 -0
- package/.pi/harnesses/coms/package.json +5 -4
- package/.pi/harnesses/coms/version.ts +18 -0
- package/.pi/harnesses/damage-control-continue/README.md +32 -31
- package/.pi/harnesses/damage-control-continue/index.ts +23 -9
- package/.pi/harnesses/damage-control-continue/package.json +5 -4
- package/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
- package/.pi/prompts/doctor-agent-fleet.md +1 -1
- package/.pi/prompts/setup-agent-fleet.md +5 -5
- package/.versions/0.0.4/.claude/commands/build.md +44 -0
- package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.4/.claude/commands/plan.md +16 -0
- package/.versions/0.0.4/.claude/commands/prime.md +22 -0
- package/.versions/0.0.4/.claude/commands/review.md +16 -0
- package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.4/.claude/commands/ship.md +72 -0
- package/.versions/0.0.4/.claude/commands/spec.md +15 -0
- package/.versions/0.0.4/.claude/commands/test.md +19 -0
- package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
- package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.4/.pi/extensions/package.json +9 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.4/.pi/prompts/build.md +24 -0
- package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.4/.pi/prompts/review.md +16 -0
- package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.4/.pi/prompts/test.md +19 -0
- package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.4/.version +1 -0
- package/.versions/0.0.4/agents/architect.md +23 -0
- package/.versions/0.0.4/agents/bowser.md +26 -0
- package/.versions/0.0.4/agents/builder.md +53 -0
- package/.versions/0.0.4/agents/code-reviewer.md +205 -0
- package/.versions/0.0.4/agents/deep-researcher.md +31 -0
- package/.versions/0.0.4/agents/documenter.md +18 -0
- package/.versions/0.0.4/agents/orchestrator.md +54 -0
- package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.4/agents/planner.md +69 -0
- package/.versions/0.0.4/agents/releaser.md +24 -0
- package/.versions/0.0.4/agents/researcher.md +28 -0
- package/.versions/0.0.4/agents/security-auditor.md +166 -0
- package/.versions/0.0.4/agents/test-engineer.md +151 -0
- package/.versions/0.0.4/agents/web-debugger.md +42 -0
- package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
- package/.versions/0.0.4/docs/getting-started.md +183 -0
- package/.versions/0.0.4/docs/npm-install.md +337 -0
- package/.versions/0.0.4/docs/opencode-setup.md +248 -0
- package/.versions/0.0.4/docs/pi-extensions.md +288 -0
- package/.versions/0.0.4/docs/pi-setup.md +463 -0
- package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.4/hermes/README.md +228 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.4/hooks/hooks.json +14 -0
- package/.versions/0.0.4/hooks/session-start.sh +74 -0
- package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.4/justfile +256 -0
- package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.4/references/definition-of-done.md +67 -0
- package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.4/references/observability-checklist.md +91 -0
- package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.4/references/performance-checklist.md +153 -0
- package/.versions/0.0.4/references/prompting-patterns.md +380 -0
- package/.versions/0.0.4/references/security-checklist.md +179 -0
- package/.versions/0.0.4/references/testing-patterns.md +236 -0
- package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
- package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
- package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
- package/.versions/0.0.4/scripts/team-up.ts +333 -0
- package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +53 -0
- package/README.md +103 -541
- package/agents/architect.md +1 -1
- package/agents/builder.md +1 -1
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +3 -3
- package/agents/orchestrator.md +20 -11
- package/agents/plan-reviewer.md +3 -3
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +11 -4
- package/bin/lib/validate-overrides.js +19 -0
- package/bin/snapshot-version.js +17 -1
- package/bin/sync-harness-versions.js +94 -0
- package/codex/CONDUCTOR.md +148 -0
- package/docs/ARCHITECTURE.md +210 -0
- package/docs/agent-fleet-setup.md +11 -0
- package/docs/claude-code-coms-bridge.md +10 -0
- package/docs/codex-remote-conductor.md +170 -0
- package/docs/coms-hermes-bridge.md +121 -0
- package/docs/getting-started.md +14 -0
- package/docs/npm-install.md +2 -0
- package/docs/pi-extensions.md +49 -14
- package/docs/pi-setup.md +12 -4
- package/hermes/README.md +228 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/justfile +106 -23
- package/package.json +17 -5
- package/scripts/codex-conductor.ts +41 -0
- package/scripts/codex-remote-control.ts +167 -0
- package/scripts/coms-cli.ts +311 -199
- package/scripts/coms-hermes-bridge.ts +2 -2
- package/scripts/lib/codex-conductor.ts +88 -0
- package/scripts/lib/codex-remote-control.ts +480 -0
- package/scripts/lib/coms-envelope.ts +51 -6
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/herdr-layout.ts +18 -3
- package/scripts/lib/hermes-bridge-core.ts +4 -4
- package/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/scripts/lib/hermes-monitor-model.ts +9 -0
- package/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/scripts/lib/hermes-monitor-store.ts +31 -0
- package/scripts/lib/team-project.ts +85 -1
- package/scripts/team-up.ts +77 -18
- package/skills/designing-agents/SKILL.md +2 -2
- package/skills/designing-agents/pi-harness-authoring.md +26 -13
- package/skills/guided-workspace-setup/SKILL.md +131 -102
- package/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/skills/peer-coms/SKILL.md +9 -0
- package/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import {
|
|
2
|
+
accessDecisionChoices,
|
|
3
|
+
accessRequestCacheKey,
|
|
4
|
+
appendExemptionToFile,
|
|
5
|
+
fileExemptionsFor,
|
|
6
|
+
type AccessDecision,
|
|
7
|
+
type AccessDecisionChoice,
|
|
8
|
+
type AccessRequest,
|
|
9
|
+
} from "../lib/damage-control-shared.ts";
|
|
10
|
+
|
|
11
|
+
type ApprovalContext = {
|
|
12
|
+
hasUI: boolean;
|
|
13
|
+
ui: {
|
|
14
|
+
notify(message: string, level?: string): void;
|
|
15
|
+
select(title: string, options: string[], settings: { timeout: number }): Promise<string | undefined>;
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
type ReplySocket = {
|
|
20
|
+
write(chunk: string): unknown;
|
|
21
|
+
end(): unknown;
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
type AccessApprovalDeps = {
|
|
25
|
+
getContext(): ApprovalContext | null | undefined;
|
|
26
|
+
getExemptionsFile(): string | null | undefined;
|
|
27
|
+
appendLog(entry: Record<string, unknown>): void;
|
|
28
|
+
now(): string;
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
export function createAccessApprovalRouter(deps: AccessApprovalDeps) {
|
|
32
|
+
let askQueue: Promise<unknown> = Promise.resolve();
|
|
33
|
+
let generation = 0;
|
|
34
|
+
const denyCache = new Set<string>();
|
|
35
|
+
const pending = new Map<string, Promise<AccessDecisionChoice>>();
|
|
36
|
+
|
|
37
|
+
const respond = (socket: ReplySocket, msgId: string, decision: AccessDecisionChoice) => {
|
|
38
|
+
const reply: AccessDecision = { type: "access_decision", msg_id: msgId, decision };
|
|
39
|
+
try { socket.write(JSON.stringify(reply) + "\n"); } catch { /* child may have timed out */ }
|
|
40
|
+
try { socket.end(); } catch { /* ignore */ }
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
const validRequest = (request: AccessRequest) =>
|
|
44
|
+
typeof request.pattern === "string" && request.pattern.length > 0 &&
|
|
45
|
+
(request.category === "zero_access" || request.category === "read_only" || request.category === "no_delete");
|
|
46
|
+
|
|
47
|
+
const decide = (request: AccessRequest): Promise<AccessDecisionChoice> => {
|
|
48
|
+
const agent = (typeof request.agent === "string" && request.agent) || request.sender_session || "unknown-agent";
|
|
49
|
+
const pattern = request.pattern;
|
|
50
|
+
const cacheKey = accessRequestCacheKey({ ...request, agent, pattern });
|
|
51
|
+
const exemptionsFile = deps.getExemptionsFile();
|
|
52
|
+
const requestGeneration = generation;
|
|
53
|
+
|
|
54
|
+
if (fileExemptionsFor(exemptionsFile ?? undefined, agent).some((entry) => entry.pattern === pattern)) {
|
|
55
|
+
return Promise.resolve("allow_all");
|
|
56
|
+
}
|
|
57
|
+
if (denyCache.has(cacheKey)) return Promise.resolve("deny");
|
|
58
|
+
const existing = pending.get(cacheKey);
|
|
59
|
+
if (existing) return existing;
|
|
60
|
+
|
|
61
|
+
const ask = askQueue.then(async (): Promise<AccessDecisionChoice> => {
|
|
62
|
+
if (requestGeneration !== generation) return "deny";
|
|
63
|
+
const ctx = deps.getContext();
|
|
64
|
+
if (!ctx?.hasUI) return "deny";
|
|
65
|
+
|
|
66
|
+
const labels = new Map<AccessDecisionChoice, string>([
|
|
67
|
+
["deny", "Deny (keep blocked)"],
|
|
68
|
+
["allow_once", "Allow once"],
|
|
69
|
+
["allow_agent", `Allow for ${agent} (this session)`],
|
|
70
|
+
["allow_all", "Allow for all agents (this session)"],
|
|
71
|
+
]);
|
|
72
|
+
const allowed = accessDecisionChoices(request.category);
|
|
73
|
+
const options = allowed.map((decision) => labels.get(decision)!);
|
|
74
|
+
ctx.ui.notify(
|
|
75
|
+
`🛡️ Access request from ${agent}: ${request.rule}\n tool: ${request.tool}\n attempted: ${String(request.invocation || "").slice(0, 200)}`,
|
|
76
|
+
"warning",
|
|
77
|
+
);
|
|
78
|
+
try {
|
|
79
|
+
const choice = await ctx.ui.select(
|
|
80
|
+
`🛡️ ${agent} requests access: ${pattern}`,
|
|
81
|
+
options,
|
|
82
|
+
{ timeout: 600_000 },
|
|
83
|
+
);
|
|
84
|
+
if (requestGeneration !== generation) return "deny";
|
|
85
|
+
const selected = allowed.find((decision) => labels.get(decision) === choice) ?? "deny";
|
|
86
|
+
if (selected === "deny" && choice === labels.get("deny")) denyCache.add(cacheKey);
|
|
87
|
+
return selected;
|
|
88
|
+
} catch {
|
|
89
|
+
return "deny";
|
|
90
|
+
}
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
askQueue = ask.catch(() => {});
|
|
94
|
+
pending.set(cacheKey, ask);
|
|
95
|
+
void ask.finally(() => pending.delete(cacheKey));
|
|
96
|
+
return ask;
|
|
97
|
+
};
|
|
98
|
+
|
|
99
|
+
return {
|
|
100
|
+
async handle(socket: ReplySocket, request: AccessRequest): Promise<void> {
|
|
101
|
+
if (!validRequest(request)) {
|
|
102
|
+
respond(socket, request.msg_id, "deny");
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
const agent = (typeof request.agent === "string" && request.agent) || request.sender_session || "unknown-agent";
|
|
106
|
+
const decision = await decide(request).catch((): AccessDecisionChoice => "deny");
|
|
107
|
+
const exemptionsFile = deps.getExemptionsFile();
|
|
108
|
+
if ((decision === "allow_agent" || decision === "allow_all") && exemptionsFile) {
|
|
109
|
+
try {
|
|
110
|
+
appendExemptionToFile(exemptionsFile, {
|
|
111
|
+
pattern: request.pattern,
|
|
112
|
+
scope: "session",
|
|
113
|
+
agent: decision === "allow_agent" ? agent : undefined,
|
|
114
|
+
grantedVia: "escalation",
|
|
115
|
+
grantedAt: deps.now(),
|
|
116
|
+
});
|
|
117
|
+
} catch { /* allow-once semantics still hold via the reply */ }
|
|
118
|
+
}
|
|
119
|
+
deps.appendLog({ action: `escalation_${decision}`, agent, pattern: request.pattern, tool: request.tool, rule: request.rule });
|
|
120
|
+
try {
|
|
121
|
+
deps.getContext()?.ui.notify(
|
|
122
|
+
`🛡️ Access ${decision === "deny" ? "denied" : `granted (${decision.replace(/_/g, " ")})`}: ${request.pattern} — ${agent}`,
|
|
123
|
+
decision === "deny" ? "warning" : "info",
|
|
124
|
+
);
|
|
125
|
+
} catch { /* ignore */ }
|
|
126
|
+
respond(socket, request.msg_id, decision);
|
|
127
|
+
},
|
|
128
|
+
reset() {
|
|
129
|
+
generation++;
|
|
130
|
+
askQueue = Promise.resolve();
|
|
131
|
+
denyCache.clear();
|
|
132
|
+
pending.clear();
|
|
133
|
+
},
|
|
134
|
+
};
|
|
135
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { isAbsolute, relative, resolve, sep } from "node:path";
|
|
2
|
+
|
|
3
|
+
export const ARTIFACT_KINDS = ["returns", "plans", "reviews", "inventories", "evidence"];
|
|
4
|
+
|
|
5
|
+
const SESSION_RELATIVE_PREFIXES = new Set(["artifacts", "findings", "delegations"]);
|
|
6
|
+
const PREVIEW_LIMIT = 180;
|
|
7
|
+
|
|
8
|
+
export function resolveArtifactPath(inputPath, options) {
|
|
9
|
+
const raw = String(inputPath || "").trim();
|
|
10
|
+
if (!raw) throw new Error("Artifact path must be a non-empty string");
|
|
11
|
+
if (/\0/.test(raw)) throw new Error(`Invalid artifact path ${JSON.stringify(raw)}`);
|
|
12
|
+
|
|
13
|
+
const repoDir = resolve(options.repoDir);
|
|
14
|
+
const sessionDir = resolve(options.sessionDir);
|
|
15
|
+
const artifactRoot = options.artifactRoot ? resolve(options.artifactRoot) : resolve(sessionDir, "artifacts");
|
|
16
|
+
const normalized = raw.replace(/\\/g, "/").replace(/^\.\//, "");
|
|
17
|
+
|
|
18
|
+
const candidates = [];
|
|
19
|
+
if (isAbsolute(raw)) {
|
|
20
|
+
const absoluteTarget = resolve(raw);
|
|
21
|
+
if (isWithin(artifactRoot, absoluteTarget)) {
|
|
22
|
+
candidates.push({ root: artifactRoot, target: absoluteTarget, displayBase: artifactRoot, prefix: "artifacts" });
|
|
23
|
+
} else if (isWithin(sessionDir, absoluteTarget)) {
|
|
24
|
+
candidates.push({ root: sessionDir, target: absoluteTarget, displayBase: sessionDir, prefix: ".pi/agent-sessions" });
|
|
25
|
+
}
|
|
26
|
+
candidates.push({ root: repoDir, target: absoluteTarget, displayBase: repoDir, prefix: "" });
|
|
27
|
+
} else {
|
|
28
|
+
const first = normalized.split("/")[0];
|
|
29
|
+
if (first === "artifacts") {
|
|
30
|
+
candidates.push({ root: sessionDir, target: safeJoin(sessionDir, normalized), displayBase: artifactRoot, prefix: "artifacts" });
|
|
31
|
+
} else if (ARTIFACT_KINDS.includes(first)) {
|
|
32
|
+
candidates.push({ root: artifactRoot, target: safeJoin(artifactRoot, normalized), displayBase: artifactRoot, prefix: "artifacts" });
|
|
33
|
+
candidates.push({ root: repoDir, target: safeJoin(repoDir, normalized), displayBase: repoDir, prefix: "" });
|
|
34
|
+
} else if (SESSION_RELATIVE_PREFIXES.has(first)) {
|
|
35
|
+
candidates.push({ root: sessionDir, target: safeJoin(sessionDir, normalized), displayBase: sessionDir, prefix: ".pi/agent-sessions" });
|
|
36
|
+
} else {
|
|
37
|
+
candidates.push({ root: repoDir, target: safeJoin(repoDir, normalized), displayBase: repoDir, prefix: "" });
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
const valid = candidates.filter((candidate) => isWithin(candidate.root, candidate.target));
|
|
42
|
+
if (valid.length === 0) {
|
|
43
|
+
throw new Error(`Refusing artifact path outside repo/session: ${raw}`);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
const exists = typeof options.exists === "function" ? options.exists : () => true;
|
|
47
|
+
const picked = valid.find((candidate) => exists(candidate.target)) || valid[0];
|
|
48
|
+
return {
|
|
49
|
+
input: raw,
|
|
50
|
+
path: picked.target,
|
|
51
|
+
displayPath: displayPath(picked.target, picked.displayBase, picked.prefix),
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export function resolveArtifactPaths(paths, options) {
|
|
56
|
+
return (paths || []).map((p) => resolveArtifactPath(p, options));
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export function artifactPreviewFromText(text) {
|
|
60
|
+
const lines = String(text || "").split(/\r?\n/);
|
|
61
|
+
const heading = lines.map((line) => line.trim()).find((line) => /^#{1,6}\s+\S/.test(line));
|
|
62
|
+
if (heading) return truncate(heading.replace(/^#{1,6}\s+/, ""));
|
|
63
|
+
const first = lines.map((line) => line.trim()).find(Boolean);
|
|
64
|
+
return first ? truncate(first) : "(empty file)";
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export function formatInputArtifactsSection(items) {
|
|
68
|
+
if (!items || items.length === 0) return "";
|
|
69
|
+
const lines = items.map((item) => `- ${item.displayPath || item.path} — ${item.preview || "(no preview)"}`);
|
|
70
|
+
return `\n\n## Input artifacts\nRead these files with your own read tool when needed. The dispatcher is passing paths plus a one-line preview only; file bodies are intentionally not inlined.\n${lines.join("\n")}`;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function safeJoin(root, relativePath) {
|
|
74
|
+
const target = resolve(root, relativePath);
|
|
75
|
+
if (!isWithin(root, target)) throw new Error(`Refusing artifact path outside repo/session: ${relativePath}`);
|
|
76
|
+
return target;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function isWithin(root, target) {
|
|
80
|
+
const rel = relative(resolve(root), resolve(target));
|
|
81
|
+
return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel));
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function displayPath(target, base, prefix) {
|
|
85
|
+
const rel = relative(resolve(base), resolve(target)).split(sep).join("/");
|
|
86
|
+
if (!prefix) return rel || ".";
|
|
87
|
+
return rel ? `${prefix}/${rel}` : prefix;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
function truncate(value) {
|
|
91
|
+
return value.length > PREVIEW_LIMIT ? `${value.slice(0, PREVIEW_LIMIT - 1)}…` : value;
|
|
92
|
+
}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
// Dispatch backend policy — pure logic for routing dispatch_agent calls to a
|
|
2
|
+
// native pi subagent or a same-name coms peer (.pi/agents/dispatch-policy.yaml).
|
|
3
|
+
// Parsing + resolution only: no I/O, no pi imports, testable under node --test.
|
|
4
|
+
// The wiring (pool lookup, envelope send, fallback spawn) lives in index.ts.
|
|
5
|
+
|
|
6
|
+
const NAME_RE = /^[A-Za-z0-9_-]+$/;
|
|
7
|
+
const DEFAULT_GRACE_S = 30;
|
|
8
|
+
|
|
9
|
+
export const DEFAULT_POLICY = Object.freeze({
|
|
10
|
+
default: "native",
|
|
11
|
+
grace_s: DEFAULT_GRACE_S,
|
|
12
|
+
substitutions: {},
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
function stripComment(line) {
|
|
16
|
+
// Values in this file never contain '#'; a minimal comment strip is enough.
|
|
17
|
+
const i = line.indexOf("#");
|
|
18
|
+
return i < 0 ? line : line.slice(0, i);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
// Minimal parser for the specific dispatch-policy.yaml shape:
|
|
22
|
+
// default: native | coms
|
|
23
|
+
// grace_s: <seconds>
|
|
24
|
+
// substitutions:
|
|
25
|
+
// <member>:
|
|
26
|
+
// prefer: native | coms
|
|
27
|
+
// fallback: native | none
|
|
28
|
+
// timeout_s: <seconds>
|
|
29
|
+
// Not a general YAML parser; tolerant of comments and blank lines only.
|
|
30
|
+
// Never throws: malformed input degrades to DEFAULT_POLICY pieces, with a
|
|
31
|
+
// warning per dropped construct so the hub can notify once.
|
|
32
|
+
export function parseDispatchPolicy(raw) {
|
|
33
|
+
const policy = { default: "native", grace_s: DEFAULT_GRACE_S, substitutions: {} };
|
|
34
|
+
const warnings = [];
|
|
35
|
+
if (typeof raw !== "string" || raw.trim() === "") return { policy, warnings };
|
|
36
|
+
|
|
37
|
+
let inSubstitutions = false;
|
|
38
|
+
let currentMember = null;
|
|
39
|
+
|
|
40
|
+
for (const rawLine of String(raw).split("\n")) {
|
|
41
|
+
const line = stripComment(rawLine.replace(/\s+$/, ""));
|
|
42
|
+
if (line.trim() === "") continue;
|
|
43
|
+
const indent = line.length - line.trimStart().length;
|
|
44
|
+
const content = line.trim();
|
|
45
|
+
const kv = content.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
|
|
46
|
+
if (!kv) {
|
|
47
|
+
warnings.push(`dispatch-policy: ignored unparseable line: ${content}`);
|
|
48
|
+
// Don't let fields after a broken member header leak into the previous member.
|
|
49
|
+
currentMember = null;
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
const [, key, value] = kv;
|
|
53
|
+
|
|
54
|
+
if (indent === 0) {
|
|
55
|
+
currentMember = null;
|
|
56
|
+
inSubstitutions = false;
|
|
57
|
+
if (key === "substitutions" && value === "") {
|
|
58
|
+
inSubstitutions = true;
|
|
59
|
+
} else if (key === "default") {
|
|
60
|
+
if (value === "native" || value === "coms") policy.default = value;
|
|
61
|
+
else warnings.push(`dispatch-policy: default must be native|coms, got "${value}"`);
|
|
62
|
+
} else if (key === "grace_s") {
|
|
63
|
+
const n = Number(value);
|
|
64
|
+
if (Number.isFinite(n) && n >= 0) policy.grace_s = Math.floor(n);
|
|
65
|
+
else warnings.push(`dispatch-policy: grace_s must be a non-negative number, got "${value}"`);
|
|
66
|
+
} else {
|
|
67
|
+
warnings.push(`dispatch-policy: unknown top-level key "${key}"`);
|
|
68
|
+
}
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
if (!inSubstitutions) continue;
|
|
73
|
+
|
|
74
|
+
// Member header (one indent level, no value).
|
|
75
|
+
if (value === "") {
|
|
76
|
+
if (NAME_RE.test(key)) {
|
|
77
|
+
currentMember = key.toLowerCase();
|
|
78
|
+
policy.substitutions[currentMember] = { prefer: "coms", fallback: "native" };
|
|
79
|
+
} else {
|
|
80
|
+
warnings.push(`dispatch-policy: invalid member name "${key}"`);
|
|
81
|
+
currentMember = null;
|
|
82
|
+
}
|
|
83
|
+
continue;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
// Member field (deeper indent, key: value).
|
|
87
|
+
if (!currentMember) {
|
|
88
|
+
warnings.push(`dispatch-policy: field "${key}" outside a member block`);
|
|
89
|
+
continue;
|
|
90
|
+
}
|
|
91
|
+
const sub = policy.substitutions[currentMember];
|
|
92
|
+
if (key === "prefer") {
|
|
93
|
+
if (value === "native" || value === "coms") sub.prefer = value;
|
|
94
|
+
else warnings.push(`dispatch-policy: ${currentMember}.prefer must be native|coms, got "${value}"`);
|
|
95
|
+
} else if (key === "fallback") {
|
|
96
|
+
if (value === "native" || value === "none") sub.fallback = value;
|
|
97
|
+
else warnings.push(`dispatch-policy: ${currentMember}.fallback must be native|none, got "${value}"`);
|
|
98
|
+
} else if (key === "timeout_s") {
|
|
99
|
+
const n = Number(value);
|
|
100
|
+
if (Number.isFinite(n) && n > 0) sub.timeout_s = Math.floor(n);
|
|
101
|
+
else warnings.push(`dispatch-policy: ${currentMember}.timeout_s must be a positive number, got "${value}"`);
|
|
102
|
+
} else {
|
|
103
|
+
warnings.push(`dispatch-policy: unknown field "${key}" for member ${currentMember}`);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
return { policy, warnings };
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
// Decide the backend for one dispatch. Pure: the caller supplies the CURRENT
|
|
111
|
+
// live pool peer names (peersInScope() at dispatch time — hub and peers boot
|
|
112
|
+
// in parallel, so this must never be cached from team activation).
|
|
113
|
+
//
|
|
114
|
+
// Returns one of:
|
|
115
|
+
// { backend: "native" }
|
|
116
|
+
// { backend: "native", comsMissedNotice: "<member> prefers a coms peer ..." }
|
|
117
|
+
// { backend: "coms", peerName, timeout_s? } — peerName is the pool's exact spelling
|
|
118
|
+
// { backend: "await-coms", grace_s } — coms-required, peer not live yet: poll, then refuse
|
|
119
|
+
export function resolveDispatchBackend({ agentName, policy, livePeerNames }) {
|
|
120
|
+
const p = policy && typeof policy === "object" ? policy : DEFAULT_POLICY;
|
|
121
|
+
const name = String(agentName || "").toLowerCase();
|
|
122
|
+
const sub = (p.substitutions || {})[name];
|
|
123
|
+
const prefer = sub ? sub.prefer : p.default === "coms" ? "coms" : "native";
|
|
124
|
+
if (prefer !== "coms") return { backend: "native" };
|
|
125
|
+
|
|
126
|
+
const live = Array.isArray(livePeerNames) ? livePeerNames : [];
|
|
127
|
+
const match = live.find((n) => String(n).toLowerCase() === name);
|
|
128
|
+
if (match !== undefined) {
|
|
129
|
+
const out = { backend: "coms", peerName: String(match) };
|
|
130
|
+
if (sub && sub.timeout_s) out.timeout_s = sub.timeout_s;
|
|
131
|
+
return out;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
if (sub && sub.fallback === "none") {
|
|
135
|
+
return { backend: "await-coms", grace_s: Number.isFinite(p.grace_s) ? p.grace_s : DEFAULT_GRACE_S };
|
|
136
|
+
}
|
|
137
|
+
return {
|
|
138
|
+
backend: "native",
|
|
139
|
+
comsMissedNotice:
|
|
140
|
+
`${agentName}: prefers a coms peer but none named "${name}" is live in the pool — using the native subagent.`,
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// The refusal returned when a coms-required member's peer never appeared
|
|
145
|
+
// within the grace window.
|
|
146
|
+
export function comsRequiredRefusal(agentName, graceS) {
|
|
147
|
+
return (
|
|
148
|
+
`"${agentName}" is configured as coms-required (fallback: none) but no live peer named ` +
|
|
149
|
+
`"${String(agentName).toLowerCase()}" appeared in the pool within ${graceS}s. ` +
|
|
150
|
+
"Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /coms, " +
|
|
151
|
+
"or set `fallback: native` in .pi/agents/dispatch-policy.yaml."
|
|
152
|
+
);
|
|
153
|
+
}
|