@chankov/agent-fleet 0.0.3 → 0.0.5
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/set-hermes-telegram.md +15 -0
- package/.claude/commands/setup-agent-fleet.md +1 -1
- package/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/agents/dispatch-policy.yaml +1 -1
- package/.pi/agents/peers.yaml +4 -4
- package/.pi/extensions/chrome-devtools-mcp/README.md +1 -1
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- package/.pi/harnesses/agent-hub/README.md +223 -40
- 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 +1037 -246
- 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-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 +1 -0
- package/.pi/harnesses/ask-user-remote/index.ts +36 -8
- package/.pi/harnesses/coms/README.md +15 -5
- 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 +36 -35
- 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/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.pi/prompts/set-hermes-telegram.md +15 -0
- package/.pi/prompts/setup-agent-fleet.md +1 -1
- 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/.versions/0.0.5/.claude/commands/build.md +44 -0
- package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.5/.claude/commands/plan.md +16 -0
- package/.versions/0.0.5/.claude/commands/prime.md +22 -0
- package/.versions/0.0.5/.claude/commands/review.md +16 -0
- package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.5/.claude/commands/ship.md +72 -0
- package/.versions/0.0.5/.claude/commands/spec.md +15 -0
- package/.versions/0.0.5/.claude/commands/test.md +19 -0
- package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.5/.pi/extensions/package.json +9 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.5/.pi/prompts/build.md +24 -0
- package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.5/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.5/.pi/prompts/review.md +16 -0
- package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.5/.pi/prompts/test.md +19 -0
- package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.5/.version +1 -0
- package/.versions/0.0.5/agents/architect.md +23 -0
- package/.versions/0.0.5/agents/bowser.md +26 -0
- package/.versions/0.0.5/agents/builder.md +53 -0
- package/.versions/0.0.5/agents/code-reviewer.md +205 -0
- package/.versions/0.0.5/agents/deep-researcher.md +31 -0
- package/.versions/0.0.5/agents/documenter.md +18 -0
- package/.versions/0.0.5/agents/orchestrator.md +54 -0
- package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.5/agents/planner.md +69 -0
- package/.versions/0.0.5/agents/releaser.md +24 -0
- package/.versions/0.0.5/agents/researcher.md +28 -0
- package/.versions/0.0.5/agents/security-auditor.md +166 -0
- package/.versions/0.0.5/agents/test-engineer.md +151 -0
- package/.versions/0.0.5/agents/web-debugger.md +42 -0
- package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.5/docs/getting-started.md +183 -0
- package/.versions/0.0.5/docs/npm-install.md +337 -0
- package/.versions/0.0.5/docs/opencode-setup.md +249 -0
- package/.versions/0.0.5/docs/pi-extensions.md +293 -0
- package/.versions/0.0.5/docs/pi-setup.md +472 -0
- package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.5/hermes/README.md +231 -0
- package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.5/hooks/hooks.json +14 -0
- package/.versions/0.0.5/hooks/session-start.sh +74 -0
- package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.5/justfile +245 -0
- package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.5/references/definition-of-done.md +67 -0
- package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.5/references/observability-checklist.md +91 -0
- package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.5/references/performance-checklist.md +153 -0
- package/.versions/0.0.5/references/prompting-patterns.md +380 -0
- package/.versions/0.0.5/references/security-checklist.md +179 -0
- package/.versions/0.0.5/references/testing-patterns.md +236 -0
- package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.5/scripts/fleet.ts +141 -0
- package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.5/scripts/team-up.ts +351 -0
- package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +62 -0
- package/README.md +17 -16
- 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/test-engineer.md +11 -4
- package/bin/cli.js +83 -1
- package/bin/lib/set-hermes-telegram.js +323 -0
- package/bin/lib/validate-overrides.js +19 -0
- package/bin/sync-harness-versions.js +94 -0
- package/docs/ARCHITECTURE.md +49 -4
- package/docs/agent-fleet-setup.md +11 -1
- package/docs/claude-code-coms-bridge.md +4 -4
- package/docs/codex-remote-conductor.md +12 -12
- package/docs/coms-hermes-bridge.md +62 -4
- package/docs/getting-started.md +4 -4
- package/docs/opencode-setup.md +1 -0
- package/docs/pi-extensions.md +73 -33
- package/docs/pi-setup.md +23 -8
- package/hermes/README.md +191 -8
- package/justfile +143 -158
- package/package.json +13 -5
- package/references/fleet-coordination-patterns.md +1 -1
- package/scripts/coms-hermes-bridge.ts +18 -8
- package/scripts/fleet.ts +141 -0
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/fleet-command.ts +109 -0
- package/scripts/lib/hermes-bridge-core.ts +5 -2
- package/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/scripts/lib/hermes-monitor-model.ts +3 -0
- package/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/scripts/lib/hermes-monitor-store.ts +2 -0
- package/scripts/lib/team-project.ts +10 -3
- package/scripts/team-snapshot.ts +4 -5
- package/scripts/team-up.ts +24 -6
- 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 +22 -12
- package/skills/guided-workspace-setup/companion-manifest.json +3 -1
- package/skills/peer-coms/SKILL.md +1 -1
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
|
@@ -1,16 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* spawnPiAgent — the ONE place agent-hub code spawns a headless `pi` child and
|
|
3
|
-
* parses its JSON event stream.
|
|
4
|
-
*
|
|
5
|
-
* (delegate.ts), so the spawn args and stream parsing never exist in two
|
|
6
|
-
* copies.
|
|
7
|
-
*
|
|
8
|
-
* The child is always `pi --mode json -p --no-extensions` with explicit `-e`
|
|
9
|
-
* extensions (damage-control first, delegate when the persona declares
|
|
10
|
-
* subagents), a model, a tool allowlist, and a session file. NOTE: pi's
|
|
11
|
-
* `--tools` allowlist applies to extension-registered tools too, so a tool a
|
|
12
|
-
* `-e` extension provides (e.g. `delegate`) must be NAMED in `tools` or the
|
|
13
|
-
* child model never sees it (validated 2026-06-11).
|
|
3
|
+
* parses its JSON event stream. Research helpers and read-only delegate children
|
|
4
|
+
* opt into the per-tool watchdog here, rather than trusting an agent-side timer.
|
|
14
5
|
*/
|
|
15
6
|
|
|
16
7
|
import { spawn, type ChildProcess } from "child_process";
|
|
@@ -21,49 +12,97 @@ export interface PiUsage {
|
|
|
21
12
|
[k: string]: any;
|
|
22
13
|
}
|
|
23
14
|
|
|
15
|
+
export interface ToolTimeout {
|
|
16
|
+
toolCallId: string;
|
|
17
|
+
toolName: string;
|
|
18
|
+
args: string;
|
|
19
|
+
startedAt: number;
|
|
20
|
+
deadlineAt: number;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export interface Termination {
|
|
24
|
+
reason: "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled";
|
|
25
|
+
confirmed: boolean;
|
|
26
|
+
escalated: boolean;
|
|
27
|
+
tool?: ToolTimeout;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** External run control handed to the caller via onControl (drift watchdog). */
|
|
31
|
+
export interface PiRunControl {
|
|
32
|
+
/** Terminate the child group with the given classification (default "drift_stop"). */
|
|
33
|
+
terminate(reason?: "drift_stop" | "cancelled"): void;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export interface ToolWatchdogOptions {
|
|
37
|
+
/** Per read-only tool call deadline. null disables the watchdog. */
|
|
38
|
+
timeoutMs: number | null;
|
|
39
|
+
/** Grace after SIGTERM, followed by SIGKILL. Kept injectable for focused tests. */
|
|
40
|
+
termGraceMs?: number;
|
|
41
|
+
/** Bound on final settlement; never wait forever for close or inherited pipes. */
|
|
42
|
+
settleGraceMs?: number;
|
|
43
|
+
/** Only these tool names are watched (research/delegate read-only surface). */
|
|
44
|
+
tools?: readonly string[];
|
|
45
|
+
}
|
|
46
|
+
|
|
24
47
|
export interface SpawnPiAgentOptions {
|
|
25
48
|
model: string;
|
|
26
49
|
tools: string;
|
|
27
50
|
thinking: string;
|
|
28
51
|
appendSystemPrompt: string;
|
|
29
52
|
sessionFile: string;
|
|
30
|
-
/** Pass `-c` so the child resumes sessionFile instead of starting fresh. */
|
|
31
53
|
resume?: boolean;
|
|
32
54
|
prompt: string;
|
|
33
|
-
/** `-e` extension paths, in order (damage-control first). */
|
|
34
55
|
extensions?: string[];
|
|
35
|
-
/** Extra env on top of process.env (e.g. AGENT_HUB_DELEGATE_CONFIG). */
|
|
36
56
|
env?: Record<string, string>;
|
|
37
|
-
/**
|
|
38
|
-
* Spawn the child as its own process group leader (setsid). The kill
|
|
39
|
-
* cascade relies on this: delegate children spawned INSIDE the child
|
|
40
|
-
* inherit its group, so signalling the negative PID kills the whole tree.
|
|
41
|
-
*/
|
|
57
|
+
/** Own a process group. Required for a watchdog/cancellation kill cascade. */
|
|
42
58
|
detached?: boolean;
|
|
43
59
|
cwd?: string;
|
|
60
|
+
/** Parent tool cancellation; classified separately from a tool timeout. */
|
|
61
|
+
signal?: AbortSignal;
|
|
62
|
+
toolWatchdog?: ToolWatchdogOptions;
|
|
63
|
+
/**
|
|
64
|
+
* Whole-run deadline: one timer from spawn start; on expiry the child group is
|
|
65
|
+
* terminated with reason "turn_timeout" (same SIGTERM→SIGKILL→settle cascade as
|
|
66
|
+
* the per-tool watchdog). null/undefined disables it. Unlike the tool watchdog
|
|
67
|
+
* this bounds the ENTIRE run, thinking and non-watched tools included.
|
|
68
|
+
*/
|
|
69
|
+
turnDeadlineMs?: number | null;
|
|
44
70
|
}
|
|
45
71
|
|
|
46
72
|
export interface SpawnPiAgentCallbacks {
|
|
47
|
-
/** Fires immediately after spawn so the caller can store the proc for kill. */
|
|
48
73
|
onProcess?(proc: ChildProcess): void;
|
|
74
|
+
/** Receives a terminate handle for parent-side classified stops (drift watchdog). */
|
|
75
|
+
onControl?(control: PiRunControl): void;
|
|
49
76
|
onTextDelta?(delta: string): void;
|
|
50
77
|
onThinkingDelta?(delta: string): void;
|
|
51
|
-
onToolStart?(toolName: string, argStr: string): void;
|
|
52
|
-
/**
|
|
53
|
-
|
|
54
|
-
* the end with the final assistant message (`agent_end`).
|
|
55
|
-
*/
|
|
78
|
+
onToolStart?(toolName: string, argStr: string, toolCallId?: string): void;
|
|
79
|
+
/** isError is present only when the event stream carries an error flag. */
|
|
80
|
+
onToolEnd?(toolName: string, toolCallId?: string, isError?: boolean): void;
|
|
56
81
|
onUsage?(usage: PiUsage, source: "message_end" | "agent_end"): void;
|
|
57
82
|
}
|
|
58
83
|
|
|
59
84
|
export interface SpawnPiAgentResult {
|
|
60
|
-
/** Concatenated assistant text deltas. */
|
|
61
85
|
output: string;
|
|
62
|
-
/** Process exit code; null when the child died from a signal (e.g. SIGTERM). */
|
|
63
86
|
exitCode: number | null;
|
|
64
87
|
stderr: string;
|
|
65
|
-
/** Set when the process could not be spawned at all (proc `error` event). */
|
|
66
88
|
spawnError?: string;
|
|
89
|
+
/** Present only when parent-side bounded termination was requested. */
|
|
90
|
+
termination?: Termination;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const DEFAULT_TERM_GRACE_MS = 1_000;
|
|
94
|
+
const DEFAULT_SETTLE_GRACE_MS = 1_000;
|
|
95
|
+
const WATCHED_TOOLS = new Set(["read", "grep", "find", "ls"]);
|
|
96
|
+
|
|
97
|
+
/** Signal an explicitly owned process group, falling back only for legacy callers. */
|
|
98
|
+
export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM"): void {
|
|
99
|
+
const pid = proc.pid;
|
|
100
|
+
if (pid == null) return;
|
|
101
|
+
try {
|
|
102
|
+
process.kill(-pid, signal);
|
|
103
|
+
} catch {
|
|
104
|
+
try { proc.kill(signal); } catch {}
|
|
105
|
+
}
|
|
67
106
|
}
|
|
68
107
|
|
|
69
108
|
export function spawnPiAgent(
|
|
@@ -71,54 +110,119 @@ export function spawnPiAgent(
|
|
|
71
110
|
cbs: SpawnPiAgentCallbacks = {},
|
|
72
111
|
): Promise<SpawnPiAgentResult> {
|
|
73
112
|
const args = [
|
|
74
|
-
"--mode", "json",
|
|
75
|
-
"-p",
|
|
76
|
-
"--no-extensions",
|
|
113
|
+
"--mode", "json", "-p", "--no-extensions",
|
|
77
114
|
...(opts.extensions || []).flatMap(e => ["-e", e]),
|
|
78
|
-
"--model", opts.model,
|
|
79
|
-
"--
|
|
80
|
-
"--thinking", opts.thinking,
|
|
81
|
-
"--append-system-prompt", opts.appendSystemPrompt,
|
|
82
|
-
"--session", opts.sessionFile,
|
|
115
|
+
"--model", opts.model, "--tools", opts.tools, "--thinking", opts.thinking,
|
|
116
|
+
"--append-system-prompt", opts.appendSystemPrompt, "--session", opts.sessionFile,
|
|
83
117
|
];
|
|
84
118
|
if (opts.resume) args.push("-c");
|
|
85
119
|
|
|
120
|
+
const watchdog = opts.toolWatchdog;
|
|
121
|
+
const turnDeadlineMs = opts.turnDeadlineMs ?? null;
|
|
122
|
+
// A watchdog or deadline must own its group: group signalling remains valid even
|
|
123
|
+
// after the pi leader exits while an inherited-stdio descendant is still alive.
|
|
124
|
+
const ownsGroup = opts.detached === true || watchdog !== undefined || opts.signal !== undefined || turnDeadlineMs != null || cbs.onControl !== undefined;
|
|
125
|
+
const watchedTools = new Set(watchdog?.tools ?? WATCHED_TOOLS);
|
|
126
|
+
const timeoutMs = watchdog?.timeoutMs ?? null;
|
|
127
|
+
const termGraceMs = watchdog?.termGraceMs ?? DEFAULT_TERM_GRACE_MS;
|
|
128
|
+
const settleGraceMs = watchdog?.settleGraceMs ?? DEFAULT_SETTLE_GRACE_MS;
|
|
129
|
+
|
|
86
130
|
const textChunks: string[] = [];
|
|
87
131
|
const stderrChunks: string[] = [];
|
|
88
|
-
|
|
89
132
|
return new Promise((resolve) => {
|
|
90
133
|
const proc = spawn("pi", args, {
|
|
91
|
-
// pi's CLI does not accept a standalone `--` option separator, so pass
|
|
92
|
-
// the prompt through stdin. Print mode documents stdin as prompt input,
|
|
93
|
-
// and this keeps prompts that start with `-` from being parsed as flags.
|
|
94
134
|
stdio: ["pipe", "pipe", "pipe"],
|
|
95
135
|
env: { ...process.env, ...(opts.env || {}) },
|
|
96
136
|
...(opts.cwd ? { cwd: opts.cwd } : {}),
|
|
97
|
-
...(
|
|
137
|
+
...(ownsGroup ? { detached: true } : {}),
|
|
98
138
|
});
|
|
99
139
|
cbs.onProcess?.(proc);
|
|
100
140
|
proc.stdin?.on("error", () => {});
|
|
101
141
|
proc.stdin?.end(opts.prompt);
|
|
102
142
|
|
|
103
143
|
let buffer = "";
|
|
144
|
+
let settled = false;
|
|
145
|
+
let closeSeen = false;
|
|
146
|
+
let termination: Termination | undefined;
|
|
147
|
+
let termTimer: ReturnType<typeof setTimeout> | undefined;
|
|
148
|
+
let settleTimer: ReturnType<typeof setTimeout> | undefined;
|
|
149
|
+
let deadlineTimer: ReturnType<typeof setTimeout> | undefined;
|
|
150
|
+
const calls = new Map<string, ToolTimeout & { timer: ReturnType<typeof setTimeout> }>();
|
|
151
|
+
|
|
152
|
+
const clearCalls = () => {
|
|
153
|
+
for (const call of calls.values()) clearTimeout(call.timer);
|
|
154
|
+
calls.clear();
|
|
155
|
+
};
|
|
156
|
+
const cleanup = () => {
|
|
157
|
+
clearCalls();
|
|
158
|
+
if (termTimer) clearTimeout(termTimer);
|
|
159
|
+
if (settleTimer) clearTimeout(settleTimer);
|
|
160
|
+
if (deadlineTimer) clearTimeout(deadlineTimer);
|
|
161
|
+
opts.signal?.removeEventListener("abort", onAbort);
|
|
162
|
+
};
|
|
163
|
+
const settle = (code: number | null, spawnError?: string) => {
|
|
164
|
+
if (settled) return;
|
|
165
|
+
settled = true;
|
|
166
|
+
cleanup();
|
|
167
|
+
if (termination) termination.confirmed = closeSeen;
|
|
168
|
+
// A pipe held by a descendant must not hold the caller forever.
|
|
169
|
+
try { proc.stdin?.destroy(); } catch {}
|
|
170
|
+
try { proc.stdout?.destroy(); } catch {}
|
|
171
|
+
try { proc.stderr?.destroy(); } catch {}
|
|
172
|
+
resolve({ output: textChunks.join(""), exitCode: code, stderr: stderrChunks.join(""), ...(spawnError ? { spawnError } : {}), ...(termination ? { termination } : {}) });
|
|
173
|
+
};
|
|
174
|
+
const terminate = (reason: Termination["reason"], tool?: ToolTimeout) => {
|
|
175
|
+
// The first classification wins; later cancellation/exit events keep it.
|
|
176
|
+
if (termination) return;
|
|
177
|
+
termination = { reason, confirmed: false, escalated: false, ...(tool ? { tool } : {}) };
|
|
178
|
+
clearCalls();
|
|
179
|
+
killPiTree(proc, "SIGTERM");
|
|
180
|
+
termTimer = setTimeout(() => {
|
|
181
|
+
if (settled) return;
|
|
182
|
+
termination!.escalated = true;
|
|
183
|
+
killPiTree(proc, "SIGKILL");
|
|
184
|
+
}, termGraceMs);
|
|
185
|
+
settleTimer = setTimeout(() => settle(null), termGraceMs + settleGraceMs);
|
|
186
|
+
};
|
|
187
|
+
const onAbort = () => terminate("cancelled");
|
|
188
|
+
if (opts.signal?.aborted) onAbort();
|
|
189
|
+
else opts.signal?.addEventListener("abort", onAbort, { once: true });
|
|
190
|
+
// External classified stop (drift watchdog): same first-classification-wins
|
|
191
|
+
// cascade as every other termination path; harmless after settle.
|
|
192
|
+
cbs.onControl?.({ terminate: (reason = "drift_stop") => { if (!settled) terminate(reason); } });
|
|
193
|
+
if (turnDeadlineMs != null) {
|
|
194
|
+
deadlineTimer = setTimeout(() => terminate("turn_timeout"), turnDeadlineMs);
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
const toolId = (event: any) => String(event.toolCallId ?? event.tool_call_id ?? event.id ?? "");
|
|
104
198
|
const handleEvent = (event: any) => {
|
|
105
199
|
if (event.type === "message_update") {
|
|
106
200
|
const delta = event.assistantMessageEvent;
|
|
107
|
-
if (delta?.type === "text_delta") {
|
|
108
|
-
|
|
109
|
-
cbs.onTextDelta?.(delta.delta || "");
|
|
110
|
-
} else if (delta?.type === "thinking_delta") {
|
|
111
|
-
cbs.onThinkingDelta?.(delta.delta || "");
|
|
112
|
-
}
|
|
201
|
+
if (delta?.type === "text_delta") { textChunks.push(delta.delta || ""); cbs.onTextDelta?.(delta.delta || ""); }
|
|
202
|
+
else if (delta?.type === "thinking_delta") cbs.onThinkingDelta?.(delta.delta || "");
|
|
113
203
|
} else if (event.type === "tool_execution_start") {
|
|
114
204
|
let argStr = "";
|
|
115
|
-
try { argStr = event.args != null ? JSON.stringify(event.args) : ""; } catch {
|
|
116
|
-
|
|
205
|
+
try { argStr = event.args != null ? JSON.stringify(event.args) : ""; } catch {}
|
|
206
|
+
const id = toolId(event);
|
|
207
|
+
const name = event.toolName || "tool";
|
|
208
|
+
cbs.onToolStart?.(name, argStr, id || undefined);
|
|
209
|
+
if (timeoutMs != null && id && watchedTools.has(name) && !calls.has(id)) {
|
|
210
|
+
const startedAt = Date.now();
|
|
211
|
+
const call: ToolTimeout = { toolCallId: id, toolName: name, args: argStr, startedAt, deadlineAt: startedAt + timeoutMs };
|
|
212
|
+
calls.set(id, { ...call, timer: setTimeout(() => terminate("tool_timeout", call), timeoutMs) });
|
|
213
|
+
}
|
|
214
|
+
} else if (event.type === "tool_execution_end") {
|
|
215
|
+
const id = toolId(event);
|
|
216
|
+
if (id) {
|
|
217
|
+
const call = calls.get(id);
|
|
218
|
+
if (call) { clearTimeout(call.timer); calls.delete(id); }
|
|
219
|
+
}
|
|
220
|
+
const rawIsError = event.isError ?? event.is_error ?? event.result?.isError ?? event.result?.is_error;
|
|
221
|
+
cbs.onToolEnd?.(event.toolName || "tool", id || undefined, typeof rawIsError === "boolean" ? rawIsError : undefined);
|
|
117
222
|
} else if (event.type === "message_end") {
|
|
118
223
|
if (event.message?.usage) cbs.onUsage?.(event.message.usage, "message_end");
|
|
119
224
|
} else if (event.type === "agent_end") {
|
|
120
|
-
const
|
|
121
|
-
const last = [...msgs].reverse().find((m: any) => m.role === "assistant");
|
|
225
|
+
const last = [...(event.messages || [])].reverse().find((m: any) => m.role === "assistant");
|
|
122
226
|
if (last?.usage) cbs.onUsage?.(last.usage, "agent_end");
|
|
123
227
|
}
|
|
124
228
|
};
|
|
@@ -128,52 +232,15 @@ export function spawnPiAgent(
|
|
|
128
232
|
buffer += chunk;
|
|
129
233
|
const lines = buffer.split("\n");
|
|
130
234
|
buffer = lines.pop() || "";
|
|
131
|
-
for (const line of lines) {
|
|
132
|
-
if (!line.trim()) continue;
|
|
133
|
-
try { handleEvent(JSON.parse(line)); } catch {}
|
|
134
|
-
}
|
|
235
|
+
for (const line of lines) { if (line.trim()) try { handleEvent(JSON.parse(line)); } catch {} }
|
|
135
236
|
});
|
|
136
|
-
|
|
137
237
|
proc.stderr!.setEncoding("utf-8");
|
|
138
|
-
proc.stderr!.on("data", (chunk: string) =>
|
|
139
|
-
stderrChunks.push(chunk);
|
|
140
|
-
});
|
|
141
|
-
|
|
238
|
+
proc.stderr!.on("data", (chunk: string) => stderrChunks.push(chunk));
|
|
142
239
|
proc.on("close", (code) => {
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
resolve({
|
|
147
|
-
output: textChunks.join(""),
|
|
148
|
-
exitCode: code,
|
|
149
|
-
stderr: stderrChunks.join(""),
|
|
150
|
-
});
|
|
151
|
-
});
|
|
152
|
-
|
|
153
|
-
proc.on("error", (err) => {
|
|
154
|
-
resolve({
|
|
155
|
-
output: "",
|
|
156
|
-
exitCode: 1,
|
|
157
|
-
stderr: stderrChunks.join(""),
|
|
158
|
-
spawnError: err.message,
|
|
159
|
-
});
|
|
240
|
+
closeSeen = true;
|
|
241
|
+
if (buffer.trim()) try { handleEvent(JSON.parse(buffer)); } catch {}
|
|
242
|
+
settle(code);
|
|
160
243
|
});
|
|
244
|
+
proc.on("error", (err) => settle(1, err.message));
|
|
161
245
|
});
|
|
162
246
|
}
|
|
163
|
-
|
|
164
|
-
/**
|
|
165
|
-
* Kill a spawned pi child and — when it was spawned `detached` — its whole
|
|
166
|
-
* process group, so delegate children and grandchildren die with their parent.
|
|
167
|
-
* For a non-detached child the group kill fails with ESRCH (its pgid is the
|
|
168
|
-
* hub's, not its own pid) and we fall back to a single-process SIGTERM, which
|
|
169
|
-
* matches the pre-cascade behavior.
|
|
170
|
-
*/
|
|
171
|
-
export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM"): void {
|
|
172
|
-
const pid = proc.pid;
|
|
173
|
-
if (pid == null) return;
|
|
174
|
-
try {
|
|
175
|
-
process.kill(-pid, signal);
|
|
176
|
-
} catch {
|
|
177
|
-
try { proc.kill(signal); } catch {}
|
|
178
|
-
}
|
|
179
|
-
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
|
|
3
|
+
export const VERSION_STATUS_KEY = "00-agent-fleet-version";
|
|
4
|
+
|
|
5
|
+
function readAdjacentVersion(): string | null {
|
|
6
|
+
try {
|
|
7
|
+
const manifest = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
|
|
8
|
+
return typeof manifest.version === "string" && manifest.version.length > 0 ? manifest.version : null;
|
|
9
|
+
} catch {
|
|
10
|
+
return null;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export const HARNESS_VERSION = readAdjacentVersion();
|
|
15
|
+
|
|
16
|
+
export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
|
|
17
|
+
if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
|
|
18
|
+
}
|
|
@@ -6,6 +6,7 @@ The experimental Codex Remote-Control conductor is **not** an inbound `ask_user`
|
|
|
6
6
|
|
|
7
7
|
- The stock `pi-ask-user` extension is loaded through a capture proxy; its `ask_user` tool is not registered directly.
|
|
8
8
|
- If no live `user-remote` peer is present at call time, the wrapper calls stock `execute` with the original arguments and signal unchanged.
|
|
9
|
+
- Remote lookup follows the explicit Pi `--project <name>` flag at tool-execution time (then `pi.getFlag`, `PI_COMS_PROJECT`, and finally `default`), so a hub and bridge in the same non-default pool can race correctly even though Pi finishes CLI parsing after extension factories load.
|
|
9
10
|
- If `user-remote` is present, the wrapper races local stock UI against the remote coms request using `race-core.js`; first answer wins and local-first emits one best-effort cancel.
|
|
10
11
|
- If another extension already registered `ask_user`, registration failure is caught and logged as a warning instead of crashing the session.
|
|
11
12
|
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
import * as fs from "node:fs";
|
|
9
9
|
import * as os from "node:os";
|
|
10
10
|
import * as path from "node:path";
|
|
11
|
+
import { fileURLToPath, pathToFileURL } from "node:url";
|
|
11
12
|
|
|
12
13
|
import { raceAskUser } from "./race-core.js";
|
|
13
14
|
|
|
@@ -29,6 +30,7 @@ interface InstallOptions {
|
|
|
29
30
|
warn?: (message: string) => void;
|
|
30
31
|
createAbortController?: () => AbortController;
|
|
31
32
|
settingsPaths?: string[];
|
|
33
|
+
remoteProject?: string | (() => string);
|
|
32
34
|
}
|
|
33
35
|
|
|
34
36
|
// A stock `pi-ask-user` package listed in pi settings is loaded by pi core
|
|
@@ -99,6 +101,20 @@ function warn(pi: ExtensionLike, options: InstallOptions, message: string): void
|
|
|
99
101
|
console.warn(message);
|
|
100
102
|
}
|
|
101
103
|
|
|
104
|
+
export function resolveRemoteProject(pi: ExtensionLike, argv: string[] = process.argv): string {
|
|
105
|
+
for (let i = argv.length - 2; i >= 0; i--) {
|
|
106
|
+
if (argv[i] === "--project" && typeof argv[i + 1] === "string" && argv[i + 1].trim()) {
|
|
107
|
+
return argv[i + 1].trim();
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
const inlineProject = [...argv].reverse().find((arg) => arg.startsWith("--project="))?.slice("--project=".length).trim();
|
|
111
|
+
if (inlineProject) return inlineProject;
|
|
112
|
+
const cliProject = typeof pi.getFlag === "function" ? pi.getFlag("project") : undefined;
|
|
113
|
+
if (typeof cliProject === "string" && cliProject.trim()) return cliProject.trim();
|
|
114
|
+
const envProject = process.env.PI_COMS_PROJECT;
|
|
115
|
+
return envProject?.trim() || "default";
|
|
116
|
+
}
|
|
117
|
+
|
|
102
118
|
function linkAbortSignal(parent: AbortSignal | undefined, child: AbortController): void {
|
|
103
119
|
if (!parent) return;
|
|
104
120
|
if (parent.aborted) {
|
|
@@ -151,9 +167,8 @@ export function activeRemoteCount(): number {
|
|
|
151
167
|
return activeRemote.size;
|
|
152
168
|
}
|
|
153
169
|
|
|
154
|
-
async function defaultStartRemote(params: any): Promise<{ qid: string; result: Promise<any> } | null> {
|
|
170
|
+
async function defaultStartRemote(params: any, project: string): Promise<{ qid: string; result: Promise<any> } | null> {
|
|
155
171
|
const coms = await import("../../../scripts/lib/coms-envelope.ts");
|
|
156
|
-
const project = process.env.PI_COMS_PROJECT || "default";
|
|
157
172
|
const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
|
|
158
173
|
const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
|
|
159
174
|
if (!peer) return null;
|
|
@@ -209,10 +224,9 @@ async function defaultStartRemote(params: any): Promise<{ qid: string; result: P
|
|
|
209
224
|
return { qid: env.msg_id, result };
|
|
210
225
|
}
|
|
211
226
|
|
|
212
|
-
async function defaultCancelRemote(qid: string, reason: string): Promise<void> {
|
|
227
|
+
async function defaultCancelRemote(qid: string, reason: string, project: string): Promise<void> {
|
|
213
228
|
try {
|
|
214
229
|
const coms = await import("../../../scripts/lib/coms-envelope.ts");
|
|
215
|
-
const project = process.env.PI_COMS_PROJECT || "default";
|
|
216
230
|
const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
|
|
217
231
|
const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
|
|
218
232
|
if (peer) {
|
|
@@ -233,7 +247,9 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
|
|
|
233
247
|
return {
|
|
234
248
|
...stockTool,
|
|
235
249
|
async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
|
|
236
|
-
const
|
|
250
|
+
const configuredProject = typeof options.remoteProject === "function" ? options.remoteProject() : options.remoteProject;
|
|
251
|
+
const remoteProject = configuredProject ?? process.env.PI_COMS_PROJECT?.trim() ?? "default";
|
|
252
|
+
const startRemote = options.startRemote ?? ((remoteParams: any) => defaultStartRemote(remoteParams, remoteProject));
|
|
237
253
|
let remoteStart: { qid: string; result: Promise<any> } | null = null;
|
|
238
254
|
try {
|
|
239
255
|
remoteStart = await startRemote(params, ctx);
|
|
@@ -248,7 +264,7 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
|
|
|
248
264
|
return await raceAskUser({
|
|
249
265
|
runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, params, localSignal, onUpdate, ctx),
|
|
250
266
|
startRemote: () => remoteStart,
|
|
251
|
-
cancelRemote: options.cancelRemote ?? defaultCancelRemote,
|
|
267
|
+
cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
|
|
252
268
|
createAbortController: () => {
|
|
253
269
|
const controller = options.createAbortController?.() ?? new AbortController();
|
|
254
270
|
linkAbortSignal(signal, controller);
|
|
@@ -270,7 +286,10 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
|
|
|
270
286
|
}
|
|
271
287
|
if (!options.stockFactory) throw new Error("ask-user-remote: stockFactory is required for synchronous install");
|
|
272
288
|
const stockTool = captureAskUserTool(options.stockFactory, pi);
|
|
273
|
-
const wrapped = wrapAskUserTool(stockTool,
|
|
289
|
+
const wrapped = wrapAskUserTool(stockTool, {
|
|
290
|
+
...options,
|
|
291
|
+
remoteProject: options.remoteProject ?? (() => resolveRemoteProject(pi)),
|
|
292
|
+
});
|
|
274
293
|
try {
|
|
275
294
|
pi.registerTool(wrapped);
|
|
276
295
|
return { registered: true, tool: wrapped };
|
|
@@ -281,8 +300,17 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
|
|
|
281
300
|
}
|
|
282
301
|
}
|
|
283
302
|
|
|
303
|
+
export function resolveStockAskUserModule(moduleUrl: string = import.meta.url): string {
|
|
304
|
+
// Pi's jiti loader preserves the workspace-facing path of a symlinked
|
|
305
|
+
// harness. Canonicalize this module first so the bundled dependency is
|
|
306
|
+
// resolved beside the actual Agent Fleet package, not at workspace root.
|
|
307
|
+
const realModulePath = fs.realpathSync(fileURLToPath(moduleUrl));
|
|
308
|
+
const stockModulePath = path.resolve(path.dirname(realModulePath), "../../../node_modules/pi-ask-user/index.ts");
|
|
309
|
+
return pathToFileURL(stockModulePath).href;
|
|
310
|
+
}
|
|
311
|
+
|
|
284
312
|
async function loadStockFactory(): Promise<(pi: ExtensionLike) => void> {
|
|
285
|
-
const mod = await import(
|
|
313
|
+
const mod = await import(resolveStockAskUserModule());
|
|
286
314
|
return mod.default as (pi: ExtensionLike) => void;
|
|
287
315
|
}
|
|
288
316
|
|
|
@@ -13,6 +13,16 @@ peers through per-project registry files under `~/.pi/coms/projects/<project>/ag
|
|
|
13
13
|
Surfaces a live "pool" widget of connected peers, with ping and keepalive cycles and a
|
|
14
14
|
clean shutdown lifecycle.
|
|
15
15
|
|
|
16
|
+
## Version footer and provenance
|
|
17
|
+
|
|
18
|
+
This persistent-UI harness shows `v<version>` below the prompt. It shares one common-key
|
|
19
|
+
status with `agent-hub` and `damage-control-continue`, so a stack renders the
|
|
20
|
+
version once. The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes
|
|
21
|
+
its value into this adjacent manifest. The local `version.ts` reader is retained so a copied or
|
|
22
|
+
symlinked harness resolves its own adjacent stamp, not the launch directory. That provenance
|
|
23
|
+
pair does not carry dependencies: copy/symlink targets still require the existing full
|
|
24
|
+
`.pi/harnesses/` dependency installation.
|
|
25
|
+
|
|
16
26
|
## Presence backends: herdr vs files
|
|
17
27
|
|
|
18
28
|
Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
|
|
@@ -70,11 +80,11 @@ Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at r
|
|
|
70
80
|
pi -e .pi/harnesses/coms/index.ts
|
|
71
81
|
```
|
|
72
82
|
|
|
73
|
-
For a guarded coms node
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
83
|
+
For a guarded coms node, use `just fleet peer <name>`. It loads Fleet Core plus `coms`
|
|
84
|
+
with deterministic extension discovery. Add `--browser` for Chrome DevTools or
|
|
85
|
+
`--all-extensions` when the peer intentionally needs arbitrary project/global extensions;
|
|
86
|
+
those tools stay scoped to that process and never leak into Agent Hub's
|
|
87
|
+
`--no-extensions` specialists.
|
|
78
88
|
|
|
79
89
|
## Upstream changes
|
|
80
90
|
|
|
@@ -23,6 +23,7 @@ import * as fs from "node:fs";
|
|
|
23
23
|
import * as path from "node:path";
|
|
24
24
|
import * as os from "node:os";
|
|
25
25
|
import * as crypto from "node:crypto";
|
|
26
|
+
import { registerVersionStatus } from "./version.ts";
|
|
26
27
|
|
|
27
28
|
import {
|
|
28
29
|
formatPeerStatus,
|
|
@@ -783,6 +784,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
783
784
|
|
|
784
785
|
// ━━ session_start ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
785
786
|
pi.on("session_start", async (_event, ctx) => {
|
|
787
|
+
registerVersionStatus(ctx);
|
|
786
788
|
currentCtx = ctx;
|
|
787
789
|
|
|
788
790
|
// 1. Resolve identity from CLI flags > frontmatter > defaults.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
|
|
3
|
+
export const VERSION_STATUS_KEY = "00-agent-fleet-version";
|
|
4
|
+
|
|
5
|
+
function readAdjacentVersion(): string | null {
|
|
6
|
+
try {
|
|
7
|
+
const manifest = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
|
|
8
|
+
return typeof manifest.version === "string" && manifest.version.length > 0 ? manifest.version : null;
|
|
9
|
+
} catch {
|
|
10
|
+
return null;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export const HARNESS_VERSION = readAdjacentVersion();
|
|
15
|
+
|
|
16
|
+
export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
|
|
17
|
+
if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
|
|
18
|
+
}
|