@chankov/agent-fleet 0.0.4 → 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/.opencode/commands/af-set-hermes-telegram.md +15 -0
- 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 +26 -26
- package/.pi/harnesses/agent-hub/index.ts +6 -6
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +3 -3
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +1 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- 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 +5 -5
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +7 -7
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- 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/.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/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 +9 -0
- package/README.md +14 -13
- package/bin/cli.js +83 -1
- package/bin/lib/set-hermes-telegram.js +323 -0
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/agent-fleet-setup.md +1 -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 +30 -25
- package/docs/pi-setup.md +17 -8
- package/hermes/README.md +14 -11
- package/justfile +141 -152
- package/package.json +6 -3
- 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/fleet-command.ts +109 -0
- package/scripts/lib/hermes-bridge-core.ts +5 -2
- package/scripts/lib/hermes-monitor-herdr.ts +2 -28
- package/scripts/lib/hermes-monitor-model.ts +3 -9
- package/scripts/lib/hermes-monitor-registry.ts +2 -6
- package/scripts/lib/hermes-monitor-socket.ts +2 -118
- package/scripts/lib/hermes-monitor-store.ts +2 -31
- package/scripts/lib/team-project.ts +10 -3
- package/scripts/team-snapshot.ts +4 -5
- package/scripts/team-up.ts +24 -6
- package/skills/guided-workspace-setup/SKILL.md +13 -6
- package/skills/guided-workspace-setup/companion-manifest.json +3 -1
- package/skills/peer-coms/SKILL.md +1 -1
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -10
- /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -0
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared exemption + escalation plumbing for damage-control-continue and agent-hub.
|
|
3
|
+
*
|
|
4
|
+
* Exemptions are runtime, session-scoped allowances layered on top of
|
|
5
|
+
* `.pi/damage-control-rules.yaml` — they never edit the rules file and only
|
|
6
|
+
* ever apply to the path categories (zeroAccessPaths / readOnlyPaths /
|
|
7
|
+
* noDeletePaths), never to the destructive bashToolPatterns.
|
|
8
|
+
*
|
|
9
|
+
* Consumers:
|
|
10
|
+
* - damage-control-continue — /allow commands, block-time prompts, and
|
|
11
|
+
* escalation to the agent-hub dispatcher from headless children
|
|
12
|
+
* - agent-hub — computes the shared file path, passes the env plumbing to
|
|
13
|
+
* spawned children, and answers access_request envelopes on its coms socket
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import * as fs from "fs";
|
|
17
|
+
import * as net from "net";
|
|
18
|
+
import * as os from "os";
|
|
19
|
+
import * as path from "path";
|
|
20
|
+
|
|
21
|
+
// Env plumbing agent-hub sets on spawned children. spawnPiAgent spreads
|
|
22
|
+
// process.env, so delegate grandchildren inherit these for free.
|
|
23
|
+
export const ASK_ENDPOINT_ENV = "AGENT_HUB_ASK_ENDPOINT";
|
|
24
|
+
export const EXEMPTIONS_FILE_ENV = "AGENT_HUB_EXEMPTIONS_FILE";
|
|
25
|
+
export const AGENT_ID_ENV = "AGENT_HUB_AGENT_ID";
|
|
26
|
+
|
|
27
|
+
export type ExemptionScope = "turn" | "session";
|
|
28
|
+
export type PathRuleCategory = "zero_access" | "read_only" | "no_delete";
|
|
29
|
+
|
|
30
|
+
export interface Exemption {
|
|
31
|
+
/** The protected pattern being unlocked — same syntax as the rules file entries. */
|
|
32
|
+
pattern: string;
|
|
33
|
+
scope: ExemptionScope;
|
|
34
|
+
/** When set, the exemption applies only to the spawned agent with this id. */
|
|
35
|
+
agent?: string;
|
|
36
|
+
grantedVia: "command" | "prompt" | "escalation";
|
|
37
|
+
grantedAt: string;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// ── shared exemptions file (one per hub session, read by spawned children) ──
|
|
41
|
+
|
|
42
|
+
export function exemptionsFilePath(sessionId: string): string {
|
|
43
|
+
const comsDir = process.env.PI_COMS_DIR || path.join(os.homedir(), ".pi", "coms");
|
|
44
|
+
return path.join(comsDir, "exemptions", `${sessionId}.json`);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export function readExemptionsFile(filePath: string | undefined): Exemption[] {
|
|
48
|
+
if (!filePath) return [];
|
|
49
|
+
try {
|
|
50
|
+
const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
|
|
51
|
+
if (!Array.isArray(parsed)) return [];
|
|
52
|
+
return parsed.filter((e): e is Exemption => !!e && typeof e.pattern === "string" && e.pattern.length > 0);
|
|
53
|
+
} catch {
|
|
54
|
+
return [];
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** Exemptions visible to one process: agent-agnostic entries plus those granted to `agentId`. */
|
|
59
|
+
export function fileExemptionsFor(filePath: string | undefined, agentId: string | undefined): Exemption[] {
|
|
60
|
+
return readExemptionsFile(filePath).filter((e) => !e.agent || e.agent === agentId);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export function appendExemptionToFile(filePath: string, exemption: Exemption): void {
|
|
64
|
+
fs.mkdirSync(path.dirname(filePath), { recursive: true });
|
|
65
|
+
const existing = readExemptionsFile(filePath);
|
|
66
|
+
const dup = existing.some((e) => e.pattern === exemption.pattern && (e.agent ?? "") === (exemption.agent ?? ""));
|
|
67
|
+
if (!dup) existing.push(exemption);
|
|
68
|
+
const tmp = `${filePath}.tmp`;
|
|
69
|
+
fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
|
|
70
|
+
fs.renameSync(tmp, filePath);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** Remove every entry for `pattern` (any agent). Returns true when something was removed. */
|
|
74
|
+
export function removeExemptionFromFile(filePath: string | undefined, pattern: string): boolean {
|
|
75
|
+
if (!filePath) return false;
|
|
76
|
+
const existing = readExemptionsFile(filePath);
|
|
77
|
+
const next = existing.filter((e) => e.pattern !== pattern);
|
|
78
|
+
if (next.length === existing.length) return false;
|
|
79
|
+
try {
|
|
80
|
+
const tmp = `${filePath}.tmp`;
|
|
81
|
+
fs.writeFileSync(tmp, JSON.stringify(next, null, 2));
|
|
82
|
+
fs.renameSync(tmp, filePath);
|
|
83
|
+
return true;
|
|
84
|
+
} catch {
|
|
85
|
+
return false;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
// ── escalation protocol (headless child → hub dispatcher) ──
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Sent by a child's damage-control-continue to the hub's coms socket. Carries
|
|
93
|
+
* the Envelope base fields (sender_session = agent id, sender_endpoint = "")
|
|
94
|
+
* so the hub's isValidEnvelope accepts it.
|
|
95
|
+
*/
|
|
96
|
+
export interface AccessRequest {
|
|
97
|
+
type: "access_request";
|
|
98
|
+
msg_id: string;
|
|
99
|
+
sender_session: string;
|
|
100
|
+
sender_endpoint: string;
|
|
101
|
+
hops: number;
|
|
102
|
+
timestamp: string;
|
|
103
|
+
agent: string;
|
|
104
|
+
tool: string;
|
|
105
|
+
rule: string;
|
|
106
|
+
pattern: string;
|
|
107
|
+
category: PathRuleCategory;
|
|
108
|
+
invocation: string;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
export type AccessDecisionChoice = "deny" | "allow_once" | "allow_agent" | "allow_all";
|
|
112
|
+
|
|
113
|
+
/** Protected deletions are approved per invocation; broader grants stay operator-explicit. */
|
|
114
|
+
export function accessDecisionChoices(category: PathRuleCategory): AccessDecisionChoice[] {
|
|
115
|
+
return category === "no_delete"
|
|
116
|
+
? ["deny", "allow_once"]
|
|
117
|
+
: ["deny", "allow_once", "allow_agent", "allow_all"];
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/** Coalesce identical asks without letting one delete approval cover sibling paths. */
|
|
121
|
+
export function accessRequestCacheKey(
|
|
122
|
+
request: Pick<AccessRequest, "agent" | "pattern" | "category" | "invocation">,
|
|
123
|
+
): string {
|
|
124
|
+
const base = `${request.agent}::${request.pattern}`;
|
|
125
|
+
return request.category === "no_delete" ? `${base}::${request.invocation}` : base;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
export interface AccessDecision {
|
|
129
|
+
type: "access_decision";
|
|
130
|
+
msg_id: string;
|
|
131
|
+
decision: AccessDecisionChoice;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
export const ESCALATION_TIMEOUT_MS = Number(process.env.AGENT_HUB_ASK_TIMEOUT_MS) || 60_000;
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* Ask the hub to approve a blocked call. Synchronous over a single connection:
|
|
138
|
+
* the child has no socket server of its own, so the hub keeps this socket open
|
|
139
|
+
* and writes the decision line whenever the user answers. Resolves "timeout" /
|
|
140
|
+
* "error" instead of rejecting — callers always fail closed.
|
|
141
|
+
*/
|
|
142
|
+
export function requestAccessFromHub(
|
|
143
|
+
endpoint: string,
|
|
144
|
+
request: AccessRequest,
|
|
145
|
+
timeoutMs: number = ESCALATION_TIMEOUT_MS,
|
|
146
|
+
): Promise<AccessDecisionChoice | "timeout" | "error"> {
|
|
147
|
+
return new Promise((resolve) => {
|
|
148
|
+
let settled = false;
|
|
149
|
+
let timer: ReturnType<typeof setTimeout> | undefined;
|
|
150
|
+
let sock: net.Socket;
|
|
151
|
+
const settle = (v: AccessDecisionChoice | "timeout" | "error") => {
|
|
152
|
+
if (settled) return;
|
|
153
|
+
settled = true;
|
|
154
|
+
if (timer) clearTimeout(timer);
|
|
155
|
+
try { sock.destroy(); } catch { /* ignore */ }
|
|
156
|
+
resolve(v);
|
|
157
|
+
};
|
|
158
|
+
try {
|
|
159
|
+
sock = net.createConnection({ path: endpoint });
|
|
160
|
+
} catch {
|
|
161
|
+
resolve("error");
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
timer = setTimeout(() => settle("timeout"), timeoutMs);
|
|
165
|
+
let buf = "";
|
|
166
|
+
sock.on("connect", () => {
|
|
167
|
+
try {
|
|
168
|
+
sock.write(JSON.stringify(request) + "\n");
|
|
169
|
+
} catch {
|
|
170
|
+
settle("error");
|
|
171
|
+
}
|
|
172
|
+
});
|
|
173
|
+
sock.on("data", (chunk: Buffer) => {
|
|
174
|
+
buf += chunk.toString("utf-8");
|
|
175
|
+
const nl = buf.indexOf("\n");
|
|
176
|
+
if (nl < 0) return;
|
|
177
|
+
try {
|
|
178
|
+
const parsed = JSON.parse(buf.slice(0, nl));
|
|
179
|
+
if (
|
|
180
|
+
parsed &&
|
|
181
|
+
parsed.type === "access_decision" &&
|
|
182
|
+
(parsed.decision === "deny" || parsed.decision === "allow_once" ||
|
|
183
|
+
parsed.decision === "allow_agent" || parsed.decision === "allow_all")
|
|
184
|
+
) {
|
|
185
|
+
settle(parsed.decision);
|
|
186
|
+
} else {
|
|
187
|
+
// nack or unknown reply (e.g. an older hub without escalation support)
|
|
188
|
+
settle("error");
|
|
189
|
+
}
|
|
190
|
+
} catch {
|
|
191
|
+
settle("error");
|
|
192
|
+
}
|
|
193
|
+
});
|
|
194
|
+
sock.on("error", () => settle("error"));
|
|
195
|
+
sock.on("close", () => settle("error"));
|
|
196
|
+
});
|
|
197
|
+
}
|
|
@@ -0,0 +1,458 @@
|
|
|
1
|
+
// .pi/harnesses/lib/herdr-client.ts
|
|
2
|
+
//
|
|
3
|
+
// The one shared client for the herdr socket API (https://herdr.dev/docs/socket-api/).
|
|
4
|
+
// Every file in this repo that talks to herdr goes through this module — no other
|
|
5
|
+
// file opens the socket directly.
|
|
6
|
+
//
|
|
7
|
+
// Wire facts this client is built on (validated live against herdr 0.7.1,
|
|
8
|
+
// protocol 14 — see docs/plans/herdr/spike-notes.md):
|
|
9
|
+
// - ndjson over a unix socket; the server closes the connection after each
|
|
10
|
+
// response, so request() opens a fresh connection per call.
|
|
11
|
+
// - events.subscribe is the exception: the connection stays open and streams
|
|
12
|
+
// `{"event":…,"data":…}` lines after a `subscription_started` ack.
|
|
13
|
+
// - Unknown request params are SILENTLY IGNORED by the server (e.g. `pane_id`
|
|
14
|
+
// instead of `target_pane_id` on pane.split retargets the focused pane) —
|
|
15
|
+
// the typed wrappers below exist so callers never hand-write param names.
|
|
16
|
+
// - Parse-level errors come back with an empty id; with one request in flight
|
|
17
|
+
// per connection they are safely attributed to that request.
|
|
18
|
+
//
|
|
19
|
+
// No pi imports; plain Node stdlib; erasable-TS only (runs under node --test).
|
|
20
|
+
|
|
21
|
+
import * as net from "node:net";
|
|
22
|
+
import * as os from "node:os";
|
|
23
|
+
import * as path from "node:path";
|
|
24
|
+
|
|
25
|
+
export interface HerdrErrorShape {
|
|
26
|
+
code: string;
|
|
27
|
+
message: string;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export class HerdrRequestError extends Error {
|
|
31
|
+
code: string;
|
|
32
|
+
constructor(err: HerdrErrorShape) {
|
|
33
|
+
super(`herdr: ${err.code}: ${err.message}`);
|
|
34
|
+
this.name = "HerdrRequestError";
|
|
35
|
+
this.code = err.code;
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export class HerdrUnavailableError extends Error {
|
|
40
|
+
socketPath: string;
|
|
41
|
+
constructor(socketPath: string, cause: string) {
|
|
42
|
+
super(
|
|
43
|
+
`herdr is not running or unreachable (socket: ${socketPath}): ${cause}\n` +
|
|
44
|
+
`Start herdr first (run \`herdr\` in a terminal), or point HERDR_SOCKET_PATH at a running server.`,
|
|
45
|
+
);
|
|
46
|
+
this.name = "HerdrUnavailableError";
|
|
47
|
+
this.socketPath = socketPath;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export interface HerdrClientOptions {
|
|
52
|
+
socketPath?: string;
|
|
53
|
+
timeoutMs?: number;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export interface PongInfo {
|
|
57
|
+
type: "pong";
|
|
58
|
+
version: string;
|
|
59
|
+
protocol: number;
|
|
60
|
+
capabilities?: Record<string, unknown>;
|
|
61
|
+
[key: string]: unknown;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// Minimum server the fleet features are validated against (spike: 0.7.1 / protocol 14).
|
|
65
|
+
export const MIN_PROTOCOL = 14;
|
|
66
|
+
const DEFAULT_TIMEOUT_MS = 5000;
|
|
67
|
+
|
|
68
|
+
// Resolution order: explicit arg → HERDR_SOCKET_PATH (set inside every herdr
|
|
69
|
+
// pane) → the default-session socket. Named sessions always export
|
|
70
|
+
// HERDR_SOCKET_PATH into their panes, so the env var covers them.
|
|
71
|
+
export function resolveSocketPath(explicit?: string): string {
|
|
72
|
+
if (explicit) return explicit;
|
|
73
|
+
if (process.env.HERDR_SOCKET_PATH) return process.env.HERDR_SOCKET_PATH;
|
|
74
|
+
return path.join(os.homedir(), ".config", "herdr", "herdr.sock");
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
interface WireResponse {
|
|
78
|
+
id?: string;
|
|
79
|
+
result?: Record<string, unknown>;
|
|
80
|
+
error?: HerdrErrorShape;
|
|
81
|
+
event?: string;
|
|
82
|
+
data?: unknown;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
let nextId = 0;
|
|
86
|
+
|
|
87
|
+
// One request → one connection → one response line. Resolves with the raw
|
|
88
|
+
// `result` object (unknown fields pass through untouched); rejects with
|
|
89
|
+
// HerdrRequestError on an error envelope, HerdrUnavailableError when the
|
|
90
|
+
// socket cannot be reached, and a plain Error on timeout.
|
|
91
|
+
export function request<T = Record<string, unknown>>(
|
|
92
|
+
method: string,
|
|
93
|
+
params: Record<string, unknown> = {},
|
|
94
|
+
opts: HerdrClientOptions = {},
|
|
95
|
+
): Promise<T> {
|
|
96
|
+
const socketPath = resolveSocketPath(opts.socketPath);
|
|
97
|
+
const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
|
|
98
|
+
const id = `as-${process.pid}-${++nextId}`;
|
|
99
|
+
|
|
100
|
+
return new Promise<T>((resolve, reject) => {
|
|
101
|
+
const sock = net.createConnection(socketPath);
|
|
102
|
+
let buf = "";
|
|
103
|
+
let settled = false;
|
|
104
|
+
const timer = setTimeout(() => {
|
|
105
|
+
finish(() => reject(new Error(`herdr: timeout after ${timeoutMs}ms waiting for ${method}`)));
|
|
106
|
+
}, timeoutMs);
|
|
107
|
+
|
|
108
|
+
function finish(f: () => void): void {
|
|
109
|
+
if (settled) return;
|
|
110
|
+
settled = true;
|
|
111
|
+
clearTimeout(timer);
|
|
112
|
+
sock.destroy();
|
|
113
|
+
f();
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
sock.on("connect", () => {
|
|
117
|
+
sock.write(JSON.stringify({ id, method, params }) + "\n");
|
|
118
|
+
});
|
|
119
|
+
sock.on("data", (chunk) => {
|
|
120
|
+
buf += chunk.toString();
|
|
121
|
+
let nl: number;
|
|
122
|
+
while ((nl = buf.indexOf("\n")) !== -1) {
|
|
123
|
+
const line = buf.slice(0, nl).trim();
|
|
124
|
+
buf = buf.slice(nl + 1);
|
|
125
|
+
if (!line) continue;
|
|
126
|
+
let msg: WireResponse;
|
|
127
|
+
try {
|
|
128
|
+
msg = JSON.parse(line);
|
|
129
|
+
} catch {
|
|
130
|
+
continue; // not ours; keep reading until timeout
|
|
131
|
+
}
|
|
132
|
+
// Parse errors arrive with an empty id — with one in-flight request
|
|
133
|
+
// per connection they belong to us. Ignore lines for other ids.
|
|
134
|
+
if (msg.error && (msg.id === id || msg.id === "" || msg.id === undefined)) {
|
|
135
|
+
finish(() => reject(new HerdrRequestError(msg.error as HerdrErrorShape)));
|
|
136
|
+
return;
|
|
137
|
+
}
|
|
138
|
+
if (msg.id === id && msg.result !== undefined) {
|
|
139
|
+
finish(() => resolve(msg.result as T));
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
});
|
|
144
|
+
sock.on("error", (err) => {
|
|
145
|
+
finish(() => reject(new HerdrUnavailableError(socketPath, err.message)));
|
|
146
|
+
});
|
|
147
|
+
sock.on("close", () => {
|
|
148
|
+
finish(() => reject(new Error(`herdr: connection closed before a response to ${method}`)));
|
|
149
|
+
});
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
// Ping and return server info, or null when herdr is not reachable/answering.
|
|
154
|
+
export async function herdrAvailable(opts: HerdrClientOptions = {}): Promise<PongInfo | null> {
|
|
155
|
+
try {
|
|
156
|
+
const pong = await request<PongInfo>("ping", {}, { timeoutMs: 2000, ...opts });
|
|
157
|
+
return pong && pong.type === "pong" ? pong : null;
|
|
158
|
+
} catch {
|
|
159
|
+
return null;
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
// Fail-fast helper used by every fleet entrypoint: resolves with the pong,
|
|
164
|
+
// throws HerdrUnavailableError with an actionable message otherwise.
|
|
165
|
+
export async function requireHerdr(opts: HerdrClientOptions = {}): Promise<PongInfo> {
|
|
166
|
+
const socketPath = resolveSocketPath(opts.socketPath);
|
|
167
|
+
const pong = await herdrAvailable(opts);
|
|
168
|
+
if (!pong) throw new HerdrUnavailableError(socketPath, "no server answered ping");
|
|
169
|
+
if (typeof pong.protocol === "number" && pong.protocol < MIN_PROTOCOL) {
|
|
170
|
+
throw new HerdrUnavailableError(
|
|
171
|
+
socketPath,
|
|
172
|
+
`server protocol ${pong.protocol} is older than the minimum tested protocol ${MIN_PROTOCOL} — update herdr`,
|
|
173
|
+
);
|
|
174
|
+
}
|
|
175
|
+
return pong;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// ---------------------------------------------------------------- events
|
|
179
|
+
|
|
180
|
+
// Global topics subscribe as {type}; pane.agent_status_changed and
|
|
181
|
+
// pane.output_matched additionally REQUIRE a concrete pane_id (no wildcard).
|
|
182
|
+
export type Subscription = { type: string; [key: string]: unknown };
|
|
183
|
+
|
|
184
|
+
export interface HerdrEvent {
|
|
185
|
+
event: string;
|
|
186
|
+
data: Record<string, unknown>;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
export interface SubscribeHandle {
|
|
190
|
+
close(): void;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
export interface SubscribeOptions extends HerdrClientOptions {
|
|
194
|
+
// Called when the stream (re)establishes — subscriptions are re-sent
|
|
195
|
+
// automatically; use this to reconcile state missed while disconnected.
|
|
196
|
+
onConnect?: () => void;
|
|
197
|
+
onError?: (err: Error) => void;
|
|
198
|
+
reconnectDelayMs?: number;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
// Long-lived event stream with auto-reconnect. The returned handle's close()
|
|
202
|
+
// stops both the stream and any pending reconnect.
|
|
203
|
+
export function subscribe(
|
|
204
|
+
subscriptions: Subscription[],
|
|
205
|
+
onEvent: (ev: HerdrEvent) => void,
|
|
206
|
+
opts: SubscribeOptions = {},
|
|
207
|
+
): SubscribeHandle {
|
|
208
|
+
const socketPath = resolveSocketPath(opts.socketPath);
|
|
209
|
+
const reconnectDelayMs = opts.reconnectDelayMs ?? 1000;
|
|
210
|
+
let sock: net.Socket | null = null;
|
|
211
|
+
let closed = false;
|
|
212
|
+
let retryTimer: ReturnType<typeof setTimeout> | null = null;
|
|
213
|
+
|
|
214
|
+
function connect(): void {
|
|
215
|
+
if (closed) return;
|
|
216
|
+
let buf = "";
|
|
217
|
+
let acked = false;
|
|
218
|
+
sock = net.createConnection(socketPath);
|
|
219
|
+
sock.on("connect", () => {
|
|
220
|
+
sock?.write(
|
|
221
|
+
JSON.stringify({ id: "sub", method: "events.subscribe", params: { subscriptions } }) + "\n",
|
|
222
|
+
);
|
|
223
|
+
});
|
|
224
|
+
sock.on("data", (chunk) => {
|
|
225
|
+
buf += chunk.toString();
|
|
226
|
+
let nl: number;
|
|
227
|
+
while ((nl = buf.indexOf("\n")) !== -1) {
|
|
228
|
+
const line = buf.slice(0, nl).trim();
|
|
229
|
+
buf = buf.slice(nl + 1);
|
|
230
|
+
if (!line) continue;
|
|
231
|
+
let msg: WireResponse;
|
|
232
|
+
try {
|
|
233
|
+
msg = JSON.parse(line);
|
|
234
|
+
} catch {
|
|
235
|
+
continue;
|
|
236
|
+
}
|
|
237
|
+
if (!acked && msg.result && (msg.result as { type?: string }).type === "subscription_started") {
|
|
238
|
+
acked = true;
|
|
239
|
+
opts.onConnect?.();
|
|
240
|
+
continue;
|
|
241
|
+
}
|
|
242
|
+
if (!acked && msg.error) {
|
|
243
|
+
opts.onError?.(new HerdrRequestError(msg.error));
|
|
244
|
+
// A rejected subscription will not fix itself by retrying.
|
|
245
|
+
closed = true;
|
|
246
|
+
sock?.destroy();
|
|
247
|
+
return;
|
|
248
|
+
}
|
|
249
|
+
if (msg.event) {
|
|
250
|
+
onEvent({ event: msg.event, data: (msg.data ?? {}) as Record<string, unknown> });
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
});
|
|
254
|
+
const scheduleReconnect = () => {
|
|
255
|
+
if (closed || retryTimer) return;
|
|
256
|
+
retryTimer = setTimeout(() => {
|
|
257
|
+
retryTimer = null;
|
|
258
|
+
connect();
|
|
259
|
+
}, reconnectDelayMs);
|
|
260
|
+
};
|
|
261
|
+
sock.on("error", (err) => {
|
|
262
|
+
opts.onError?.(err);
|
|
263
|
+
sock?.destroy();
|
|
264
|
+
scheduleReconnect();
|
|
265
|
+
});
|
|
266
|
+
sock.on("close", scheduleReconnect);
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
connect();
|
|
270
|
+
return {
|
|
271
|
+
close() {
|
|
272
|
+
closed = true;
|
|
273
|
+
if (retryTimer) clearTimeout(retryTimer);
|
|
274
|
+
retryTimer = null;
|
|
275
|
+
sock?.destroy();
|
|
276
|
+
sock = null;
|
|
277
|
+
},
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
// ---------------------------------------------------------------- typed wrappers
|
|
282
|
+
//
|
|
283
|
+
// Thin, param-name-exact wrappers for the methods this repo uses. Response
|
|
284
|
+
// types capture the fields we rely on; everything else passes through.
|
|
285
|
+
|
|
286
|
+
export interface WorkspaceInfo {
|
|
287
|
+
workspace_id: string;
|
|
288
|
+
number?: number;
|
|
289
|
+
label?: string;
|
|
290
|
+
focused?: boolean;
|
|
291
|
+
pane_count?: number;
|
|
292
|
+
tab_count?: number;
|
|
293
|
+
active_tab_id?: string;
|
|
294
|
+
agent_status?: string;
|
|
295
|
+
[key: string]: unknown;
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
export interface PaneInfo {
|
|
299
|
+
pane_id: string;
|
|
300
|
+
terminal_id?: string;
|
|
301
|
+
workspace_id?: string;
|
|
302
|
+
tab_id?: string;
|
|
303
|
+
focused?: boolean;
|
|
304
|
+
cwd?: string;
|
|
305
|
+
label?: string;
|
|
306
|
+
agent?: string;
|
|
307
|
+
agent_status?: string;
|
|
308
|
+
agent_session?: { source?: string; agent?: string; kind?: string; value?: string };
|
|
309
|
+
[key: string]: unknown;
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
// Layout tree nodes for layout.apply: `command` is an ARGV ARRAY (a string is
|
|
313
|
+
// rejected by the server); layout.apply creates a NEW tab in the workspace.
|
|
314
|
+
export type LayoutNode =
|
|
315
|
+
| {
|
|
316
|
+
type: "pane";
|
|
317
|
+
command?: string[];
|
|
318
|
+
cwd?: string;
|
|
319
|
+
label?: string;
|
|
320
|
+
env?: Record<string, string>;
|
|
321
|
+
pane_id?: string;
|
|
322
|
+
}
|
|
323
|
+
| {
|
|
324
|
+
type: "split";
|
|
325
|
+
direction: "right" | "down";
|
|
326
|
+
ratio?: number;
|
|
327
|
+
first: LayoutNode;
|
|
328
|
+
second: LayoutNode;
|
|
329
|
+
};
|
|
330
|
+
|
|
331
|
+
export const herdr = {
|
|
332
|
+
ping: (opts?: HerdrClientOptions) => request<PongInfo>("ping", {}, opts),
|
|
333
|
+
|
|
334
|
+
workspaceCreate: (
|
|
335
|
+
params: { label?: string; cwd?: string; env?: Record<string, string>; focus?: boolean },
|
|
336
|
+
opts?: HerdrClientOptions,
|
|
337
|
+
) =>
|
|
338
|
+
request<{ workspace: WorkspaceInfo; tab: Record<string, unknown>; root_pane: PaneInfo }>(
|
|
339
|
+
"workspace.create",
|
|
340
|
+
params,
|
|
341
|
+
opts,
|
|
342
|
+
),
|
|
343
|
+
workspaceList: (opts?: HerdrClientOptions) =>
|
|
344
|
+
request<{ workspaces: WorkspaceInfo[] }>("workspace.list", {}, opts),
|
|
345
|
+
workspaceFocus: (workspace_id: string, opts?: HerdrClientOptions) =>
|
|
346
|
+
request("workspace.focus", { workspace_id }, opts),
|
|
347
|
+
workspaceRename: (workspace_id: string, label: string, opts?: HerdrClientOptions) =>
|
|
348
|
+
request("workspace.rename", { workspace_id, label }, opts),
|
|
349
|
+
workspaceClose: (workspace_id: string, opts?: HerdrClientOptions) =>
|
|
350
|
+
request("workspace.close", { workspace_id }, opts),
|
|
351
|
+
|
|
352
|
+
// NOTE: the target field is `target_pane_id` — `pane_id` would be silently
|
|
353
|
+
// ignored and the FOCUSED pane split instead (spike finding).
|
|
354
|
+
paneSplit: (
|
|
355
|
+
params: {
|
|
356
|
+
target_pane_id: string;
|
|
357
|
+
direction: "right" | "down";
|
|
358
|
+
ratio?: number;
|
|
359
|
+
cwd?: string;
|
|
360
|
+
env?: Record<string, string>;
|
|
361
|
+
focus?: boolean;
|
|
362
|
+
command?: string[];
|
|
363
|
+
},
|
|
364
|
+
opts?: HerdrClientOptions,
|
|
365
|
+
) => request<{ pane: PaneInfo }>("pane.split", params, opts),
|
|
366
|
+
paneRename: (pane_id: string, label: string, opts?: HerdrClientOptions) =>
|
|
367
|
+
request<{ pane: PaneInfo }>("pane.rename", { pane_id, label }, opts),
|
|
368
|
+
paneSendText: (pane_id: string, text: string, opts?: HerdrClientOptions) =>
|
|
369
|
+
request("pane.send_text", { pane_id, text }, opts),
|
|
370
|
+
paneSendKeys: (pane_id: string, keys: string[], opts?: HerdrClientOptions) =>
|
|
371
|
+
request("pane.send_keys", { pane_id, keys }, opts),
|
|
372
|
+
paneRead: (
|
|
373
|
+
params: {
|
|
374
|
+
pane_id: string;
|
|
375
|
+
source?: "visible" | "recent" | "recent_unwrapped" | "detection";
|
|
376
|
+
lines?: number;
|
|
377
|
+
format?: "text" | "ansi";
|
|
378
|
+
strip_ansi?: boolean;
|
|
379
|
+
},
|
|
380
|
+
opts?: HerdrClientOptions,
|
|
381
|
+
) =>
|
|
382
|
+
request<{ read: { pane_id: string; text: string; truncated?: boolean; [key: string]: unknown } }>(
|
|
383
|
+
"pane.read",
|
|
384
|
+
{ source: "recent", format: "text", strip_ansi: true, ...params },
|
|
385
|
+
opts,
|
|
386
|
+
),
|
|
387
|
+
paneGet: (pane_id: string, opts?: HerdrClientOptions) =>
|
|
388
|
+
request<{ pane: PaneInfo }>("pane.get", { pane_id }, opts),
|
|
389
|
+
paneList: (params: { workspace_id?: string } = {}, opts?: HerdrClientOptions) =>
|
|
390
|
+
request<{ panes: PaneInfo[] }>("pane.list", params, opts),
|
|
391
|
+
paneClose: (pane_id: string, opts?: HerdrClientOptions) =>
|
|
392
|
+
request("pane.close", { pane_id }, opts),
|
|
393
|
+
// `source` is REQUIRED (client identity herdr uses to arbitrate authority).
|
|
394
|
+
paneReportAgent: (
|
|
395
|
+
params: {
|
|
396
|
+
pane_id: string;
|
|
397
|
+
source: string;
|
|
398
|
+
agent: string;
|
|
399
|
+
state: "idle" | "working" | "blocked" | "unknown";
|
|
400
|
+
message?: string;
|
|
401
|
+
custom_status?: string;
|
|
402
|
+
seq?: number;
|
|
403
|
+
agent_session_id?: string;
|
|
404
|
+
agent_session_path?: string;
|
|
405
|
+
},
|
|
406
|
+
opts?: HerdrClientOptions,
|
|
407
|
+
) => request("pane.report_agent", params, opts),
|
|
408
|
+
paneReleaseAgent: (
|
|
409
|
+
params: { pane_id: string; source: string; agent: string; seq?: number },
|
|
410
|
+
opts?: HerdrClientOptions,
|
|
411
|
+
) => request("pane.release_agent", params, opts),
|
|
412
|
+
// Metadata annotations for a pane whose agent authority is held by herdr's
|
|
413
|
+
// built-in detection (report_agent is silently ignored there — spike
|
|
414
|
+
// finding). custom_status set here shows in the sidebar; ttl_ms lets stale
|
|
415
|
+
// annotations expire if the reporter dies.
|
|
416
|
+
paneReportMetadata: (
|
|
417
|
+
params: {
|
|
418
|
+
pane_id: string;
|
|
419
|
+
source: string;
|
|
420
|
+
agent?: string;
|
|
421
|
+
custom_status?: string;
|
|
422
|
+
title?: string;
|
|
423
|
+
display_agent?: string;
|
|
424
|
+
ttl_ms?: number;
|
|
425
|
+
seq?: number;
|
|
426
|
+
},
|
|
427
|
+
opts?: HerdrClientOptions,
|
|
428
|
+
) => request("pane.report_metadata", params, opts),
|
|
429
|
+
|
|
430
|
+
tabClose: (tab_id: string, opts?: HerdrClientOptions) =>
|
|
431
|
+
request("tab.close", { tab_id }, opts),
|
|
432
|
+
|
|
433
|
+
agentList: (opts?: HerdrClientOptions) =>
|
|
434
|
+
request<{ agents: Array<Record<string, unknown>> }>("agent.list", {}, opts),
|
|
435
|
+
agentRead: (
|
|
436
|
+
params: { target: string; source?: string; lines?: number },
|
|
437
|
+
opts?: HerdrClientOptions,
|
|
438
|
+
) => request("agent.read", params, opts),
|
|
439
|
+
|
|
440
|
+
layoutApply: (
|
|
441
|
+
params: { workspace_id?: string; root: LayoutNode },
|
|
442
|
+
opts?: HerdrClientOptions,
|
|
443
|
+
) =>
|
|
444
|
+
request<{ layout: { workspace_id: string; tab_id: string; root: unknown } }>(
|
|
445
|
+
"layout.apply",
|
|
446
|
+
params,
|
|
447
|
+
opts,
|
|
448
|
+
),
|
|
449
|
+
layoutExport: (params: Record<string, unknown> = {}, opts?: HerdrClientOptions) =>
|
|
450
|
+
request<{ layout: Record<string, unknown> }>("layout.export", params, opts),
|
|
451
|
+
|
|
452
|
+
notificationShow: (
|
|
453
|
+
params: { title?: string; body?: string; [key: string]: unknown },
|
|
454
|
+
opts?: HerdrClientOptions,
|
|
455
|
+
) => request("notification.show", params, opts),
|
|
456
|
+
|
|
457
|
+
subscribe,
|
|
458
|
+
};
|