@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,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
|
|
3
|
+
argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
|
|
7
|
+
|
|
8
|
+
```text
|
|
9
|
+
set-hermes-telegram install [--profile NAME] [--force] [--restart]
|
|
10
|
+
set-hermes-telegram status [--profile NAME]
|
|
11
|
+
set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
|
|
12
|
+
set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
|
|
3
|
+
argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
|
|
7
|
+
|
|
8
|
+
```text
|
|
9
|
+
set-hermes-telegram install [--profile NAME] [--force] [--restart]
|
|
10
|
+
set-hermes-telegram status [--profile NAME]
|
|
11
|
+
set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
|
|
12
|
+
set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
|
|
2
2
|
# DISPATCH time, never at team activation — the hub and its peers boot in
|
|
3
|
-
# parallel (`just
|
|
3
|
+
# parallel (`just fleet team <team>`), so a member's coms peer may register
|
|
4
4
|
# after the session starts.
|
|
5
5
|
#
|
|
6
6
|
# default: native | coms — coms substitutes ANY active-team member that has
|
package/.pi/agents/peers.yaml
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Reusable coms peers, grouped into named teams (parallels teams.yaml).
|
|
2
2
|
#
|
|
3
|
-
# `just team
|
|
3
|
+
# `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
|
|
4
4
|
# (requires a running herdr server — https://herdr.dev),
|
|
5
|
-
# using the hidden `_peer` helper (
|
|
5
|
+
# using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
|
|
6
6
|
#
|
|
7
7
|
# Each peer entry:
|
|
8
8
|
# name — coms identity (the addressable peer name); overrides persona frontmatter
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
# runner: claude-code
|
|
27
27
|
# model: opus
|
|
28
28
|
|
|
29
|
-
# Hub-only workspace: `just
|
|
29
|
+
# Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
|
|
30
30
|
# workspace containing only the guarded hub, with no reusable coms peer panes.
|
|
31
31
|
base:
|
|
32
32
|
|
|
@@ -56,7 +56,7 @@ docs:
|
|
|
56
56
|
persona: researcher
|
|
57
57
|
model: openai-codex/gpt-5.6-luna
|
|
58
58
|
|
|
59
|
-
# Mirrored from .pi/agents/teams.yaml for `just team
|
|
59
|
+
# Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
|
|
60
60
|
default:
|
|
61
61
|
- name: planner
|
|
62
62
|
persona: planner
|
|
@@ -39,7 +39,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/mcp-bridge .pi/extensions/mcp
|
|
|
39
39
|
ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chrome-devtools-mcp
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
-
`mcp-bridge` is a sibling library; `chrome-devtools-mcp` imports it via the relative path. Runtime dependencies
|
|
42
|
+
`mcp-bridge` is a sibling library; `chrome-devtools-mcp` imports it via the relative path. Runtime dependencies live in `.pi/extensions/package.json` for cloned/copy installs and are also root production dependencies of the published package so npm-package symlink installs resolve them from the real package path. Run `npm ci` in `.pi/extensions/` once after cloning `agent-fleet` (see [docs/pi-setup.md](../../../docs/pi-setup.md#optional-pi-extensions)); a normal `@chankov/agent-fleet` package install needs no nested install.
|
|
43
43
|
|
|
44
44
|
## Verify
|
|
45
45
|
|
|
@@ -43,4 +43,4 @@ pi does not yet have first-class MCP support. This bridge is a **stopgap**: it l
|
|
|
43
43
|
|
|
44
44
|
## Dependencies
|
|
45
45
|
|
|
46
|
-
Runtime dependencies (`@modelcontextprotocol/sdk`, `typebox`) are declared
|
|
46
|
+
Runtime dependencies (`@modelcontextprotocol/sdk`, `typebox`) are declared at `.pi/extensions/package.json` for cloned/copy installs and duplicated in the root package's production `dependencies` for published-package symlink installs. The duplication is intentional: Node resolves a symlinked extension from its real path inside `@chankov/agent-fleet`, while npm does not install dependencies from a nested `.pi/extensions/package.json`. Run `npm ci` in `.pi/extensions/` for a clone or copied install; a normal `@chankov/agent-fleet` package install supplies the same dependencies at package root. No per-wrapper install is required. `@mariozechner/pi-coding-agent` is supplied by the pi runtime that loads the extension.
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
# agent-hub
|
|
2
2
|
|
|
3
3
|
A multi-agent dispatcher with [`coms`](../coms/README.md) **embedded** — so the dispatcher is
|
|
4
|
-
*also* a peer-to-peer node. The
|
|
5
|
-
[`damage-control-continue`](../damage-control-continue/README.md)
|
|
6
|
-
[`ask-user-remote`](../ask-user-remote/README.md),
|
|
7
|
-
|
|
4
|
+
*also* a peer-to-peer node. The recommended `just fleet hub` mode loads Fleet Core
|
|
5
|
+
first: [`damage-control-continue`](../damage-control-continue/README.md),
|
|
6
|
+
[`ask-user-remote`](../ask-user-remote/README.md), STT, Compact & Continue, BTW, and the
|
|
7
|
+
update checker. The dispatcher therefore has guardrails and an `ask_user` handoff tool
|
|
8
|
+
before `agent-hub` starts. It combines local specialist
|
|
8
9
|
orchestration (fixed specialist grid, read-only research helpers, `/zoom`, kill/restart, per-agent
|
|
9
10
|
model, dispatcher persona gate) with peer-to-peer collaboration: it can **hand a session off to
|
|
10
11
|
another main agent** and **use a coms peer as a subagent**.
|
|
@@ -15,7 +16,7 @@ another main agent** and **use a coms peer as a subagent**.
|
|
|
15
16
|
> [extension catalog](../../../docs/pi-extensions.md) and the
|
|
16
17
|
> [design plan](../../../docs/plans/agent-hub/).
|
|
17
18
|
|
|
18
|
-
**Optional phone control:** `just
|
|
19
|
+
**Optional phone control:** `just fleet team <team> --project <name>` can supply the live peers for the experimental [Codex Android conductor](../../../docs/codex-remote-conductor.md). Configure Codex for the same project; do not also launch `just fleet conductor codex <team>` for the same peers. Hermes remains the inbound `ask_user` route, while Codex performs only human-confirmed, approval-gated outbound delegation.
|
|
19
20
|
|
|
20
21
|
## What it does
|
|
21
22
|
|
|
@@ -207,7 +208,7 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
207
208
|
test writing is never delegated.
|
|
208
209
|
- **Dispatcher persona gate** — optional `persona-gate: on` can require an orchestrator persona at
|
|
209
210
|
session start; by default the dispatcher starts without the gate.
|
|
210
|
-
- **Default damage-control guardrails** — `just hub` and `just hub
|
|
211
|
+
- **Default damage-control guardrails** — `just fleet hub` and `just fleet hub --solo` load the
|
|
211
212
|
`damage-control-continue` harness before `agent-hub`, so dispatcher tool calls are checked against
|
|
212
213
|
`.pi/damage-control-rules.yaml` and a blocked call feeds back instead of aborting the turn. A
|
|
213
214
|
guardrail is also re-loaded into every native specialist, research helper, and nested delegate
|
|
@@ -583,7 +584,7 @@ onward, hops accumulating up to `MAX_HOPS` (5).
|
|
|
583
584
|
|
|
584
585
|
### Coms-backed dispatch (dispatch-policy.yaml)
|
|
585
586
|
|
|
586
|
-
`just
|
|
587
|
+
`just fleet team <team>` boots the Hub next to standing peers from `.pi/agents/peers.yaml` — and some
|
|
587
588
|
of them (e.g. `code-reviewer`, `plan-reviewer` with `runner: claude-code`) intentionally share a name
|
|
588
589
|
with a team member. `.pi/agents/dispatch-policy.yaml` tells the dispatcher to serve such members
|
|
589
590
|
**through the peer** instead of spawning a native subagent:
|
|
@@ -695,7 +696,7 @@ export AGENT_FLEET_MONITOR_RUNTIME_DIR="/absolute/owner-only/runtime-root"
|
|
|
695
696
|
Both are required for monitor startup; the runtime root must be absolute and owner-only, and the
|
|
696
697
|
profile ID must be a safe identifier. The monitor also starts only for a Herdr-backed hub with
|
|
697
698
|
`HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`; retain those values and `HERDR_SOCKET_PATH` in the
|
|
698
|
-
standard `just
|
|
699
|
+
standard `just fleet team <team>` flow. Workspace labels are display metadata, not monitor identity.
|
|
699
700
|
|
|
700
701
|
The live contract exposes three authenticated newline-delimited JSON requests: `snapshot`, cursor-
|
|
701
702
|
based `output`, and exact-generation `cancel`. The monitor is local-only and fails closed when its
|
|
@@ -710,7 +711,7 @@ monitor_runtime="${XDG_RUNTIME_DIR:?}/agent-fleet-monitor"
|
|
|
710
711
|
install -d -m 700 "$monitor_runtime"
|
|
711
712
|
AGENT_FLEET_PROFILE_ID=dev \
|
|
712
713
|
AGENT_FLEET_MONITOR_RUNTIME_DIR="$monitor_runtime" \
|
|
713
|
-
just
|
|
714
|
+
just fleet team default
|
|
714
715
|
```
|
|
715
716
|
|
|
716
717
|
No Desktop/backend plugin installation is required or provided. Consumers must re-discover after
|
|
@@ -720,16 +721,16 @@ lease or socket loss and must never persist or log the token.
|
|
|
720
721
|
|
|
721
722
|
- `.pi/agents/teams.yaml` for fixed specialist teams, the referenced persona `.md` files, and
|
|
722
723
|
(strongly recommended) [`pi-ask-user`](https://github.com/edlsh/pi-ask-user).
|
|
723
|
-
- `.pi/damage-control-rules.yaml` for
|
|
724
|
+
- `.pi/damage-control-rules.yaml` for every guarded `just fleet` Pi mode.
|
|
724
725
|
- Nothing extra in-repo for coms — the peer registry lives at `~/.pi/coms/` and is created at
|
|
725
726
|
runtime.
|
|
726
727
|
|
|
727
728
|
## Usage
|
|
728
729
|
|
|
729
730
|
```bash
|
|
730
|
-
#
|
|
731
|
-
just hub
|
|
732
|
-
just hub --name architect --purpose "owns the migration design" --project myrepo
|
|
731
|
+
# Unified Fleet interface (Fleet Core is loaded first)
|
|
732
|
+
just fleet hub
|
|
733
|
+
just fleet hub --name architect --purpose "owns the migration design" --project myrepo
|
|
733
734
|
|
|
734
735
|
# equivalent direct guarded launch
|
|
735
736
|
pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts
|
|
@@ -743,7 +744,7 @@ Identity flags: `--name`, `--purpose`, `--project`, `--color`, `--explicit`.
|
|
|
743
744
|
|
|
744
745
|
### Safety scope
|
|
745
746
|
|
|
746
|
-
`just hub` and `just hub
|
|
747
|
+
`just fleet hub` and `just fleet hub --solo` load Fleet Core before `agent-hub`, so guardrails and `ask_user` apply
|
|
747
748
|
to hub/dispatcher tool calls in that parent pi process — and because it is the *continue* variant, a
|
|
748
749
|
blocked dispatcher call feeds back and the turn keeps going rather than aborting. Specialist and
|
|
749
750
|
research agents are spawned as separate pi subprocesses with `--no-extensions` — but `agent-hub`
|
|
@@ -761,21 +762,20 @@ additionally read-only by construction. Guided setup enforces `agent-hub` ⇒
|
|
|
761
762
|
### Related recipes
|
|
762
763
|
|
|
763
764
|
```bash
|
|
764
|
-
#
|
|
765
|
-
just hub
|
|
765
|
+
# Hub without coms (fixed specialists + research only)
|
|
766
|
+
just fleet hub --solo
|
|
766
767
|
|
|
767
|
-
#
|
|
768
|
-
|
|
769
|
-
just team
|
|
770
|
-
just team-up-dry full # print the resolved layout + peer-launch commands without herdr
|
|
768
|
+
# Guarded peers only in a tiled Herdr workspace
|
|
769
|
+
just fleet team full --no-hub
|
|
770
|
+
just fleet team full --no-hub --dry-run
|
|
771
771
|
|
|
772
|
-
#
|
|
773
|
-
just
|
|
772
|
+
# Guarded Hub + peers in one workspace
|
|
773
|
+
just fleet team docs
|
|
774
774
|
|
|
775
|
-
#
|
|
776
|
-
just
|
|
777
|
-
just
|
|
778
|
-
just
|
|
775
|
+
# Snapshot refs / close cleanly / restore conversations
|
|
776
|
+
just fleet snapshot docs
|
|
777
|
+
just fleet down docs
|
|
778
|
+
just fleet resume docs
|
|
779
779
|
```
|
|
780
780
|
|
|
781
781
|
`peers.yaml` groups reusable peers into named teams; each entry is `name` / `persona`
|
|
@@ -58,7 +58,7 @@
|
|
|
58
58
|
*
|
|
59
59
|
* Identity flags (coms): --name --purpose --project --color --explicit
|
|
60
60
|
*
|
|
61
|
-
* Usage: just hub
|
|
61
|
+
* Usage: just fleet hub
|
|
62
62
|
* Direct guarded launch: pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/index.ts
|
|
63
63
|
*/
|
|
64
64
|
|
|
@@ -76,8 +76,8 @@ import { renderHubFooterLeft } from "./footer.ts";
|
|
|
76
76
|
import { HARNESS_VERSION, registerVersionStatus } from "./version.ts";
|
|
77
77
|
import { cancelLocalOwnedProcess, cancelLocalWaitOnly, monitorKeyForAgent } from "./monitor-control.ts";
|
|
78
78
|
import { createMonitorLifecycle, monitorLifecycleConfig } from "./monitor-lifecycle.ts";
|
|
79
|
-
import { MonitorRegistry } from "
|
|
80
|
-
import { MonitorStore } from "
|
|
79
|
+
import { MonitorRegistry } from "../lib/hermes-monitor-registry.ts";
|
|
80
|
+
import { MonitorStore } from "../lib/hermes-monitor-store.ts";
|
|
81
81
|
import { createMonitorSessionBridge } from "./monitor-session-bridge.ts";
|
|
82
82
|
import { MonitorRuntime } from "./monitor-runtime.ts";
|
|
83
83
|
import { monitorReconcileEvidence, stableMonitorHubId } from "./monitor-recovery.ts";
|
|
@@ -1755,7 +1755,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
1755
1755
|
pi.registerFlag("project", { description: "Coms: project namespace for peer discovery", type: "string", default: "default" });
|
|
1756
1756
|
pi.registerFlag("color", { description: "Coms: hex color #RRGGBB (else frontmatter or palette fallback)", type: "string", default: undefined });
|
|
1757
1757
|
pi.registerFlag("explicit", { description: "Coms: hide from auto-discovery; addressable only by exact name", type: "boolean", default: false });
|
|
1758
|
-
pi.registerFlag("solo", { description: "Run without the coms layer (fixed specialists + research only — `just hub
|
|
1758
|
+
pi.registerFlag("solo", { description: "Run without the coms layer (fixed specialists + research only — `just fleet hub --solo`)", type: "boolean", default: false });
|
|
1759
1759
|
|
|
1760
1760
|
// ── Embedded coms: peer state ──
|
|
1761
1761
|
let identity: {
|
|
@@ -3220,7 +3220,7 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
|
|
|
3220
3220
|
|
|
3221
3221
|
// ── Backend routing (dispatch-policy.yaml) ──
|
|
3222
3222
|
// Decided per dispatch, never at team activation: the hub and its peers
|
|
3223
|
-
// boot in parallel (`just
|
|
3223
|
+
// boot in parallel (`just fleet team`), so a member's coms peer may register
|
|
3224
3224
|
// at any point. A coms-preferring member with a live same-name pool peer
|
|
3225
3225
|
// is served by that peer; everything downstream (return contract, ASK_USER,
|
|
3226
3226
|
// research pipe, history) consumes the same result shape either way.
|
|
@@ -7544,7 +7544,7 @@ ${researchCatalog}`;
|
|
|
7544
7544
|
// pi's built-in `--name` (session display name) shadows the `--name` flag
|
|
7545
7545
|
// the embedded coms layer registers, so `flags.name` (getFlag) stays empty
|
|
7546
7546
|
// when a user passes `--name`. Recover it via getSessionName() — it ranks
|
|
7547
|
-
// like the CLI flag (above frontmatter), so `just hub --name foo` is honored.
|
|
7547
|
+
// like the CLI flag (above frontmatter), so `just fleet hub --name foo` is honored.
|
|
7548
7548
|
const sessionName = typeof pi.getSessionName === "function" ? (pi.getSessionName() || undefined) : undefined;
|
|
7549
7549
|
const desiredName = flags.name || sessionName || fm.name || defaultName;
|
|
7550
7550
|
const name = resolveUniqueName(project, desiredName);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import * as path from "node:path";
|
|
2
|
-
import { MonitorSocketServer } from "
|
|
2
|
+
import { MonitorSocketServer } from "../lib/hermes-monitor-socket.ts";
|
|
3
3
|
import { createOwnedHandleRegistry, recordWaitOnlyCancellation } from "./monitor-control.ts";
|
|
4
4
|
export interface MonitorLifecycleConfig { runtimeDir:string; profileId:string; profilePath:string; }
|
|
5
5
|
export function monitorLifecycleConfig(env:NodeJS.ProcessEnv):MonitorLifecycleConfig|null{const profileId=env.AGENT_FLEET_PROFILE_ID,runtimeDir=env.AGENT_FLEET_MONITOR_RUNTIME_DIR;if(!profileId||!runtimeDir||!path.isAbsolute(runtimeDir)||!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(profileId)||profileId.includes(".."))return null;return{runtimeDir,profileId,profilePath:path.join(runtimeDir,"profiles",profileId)};}
|
|
@@ -2,9 +2,9 @@ import {
|
|
|
2
2
|
type CreateChildTaskInput,
|
|
3
3
|
type CreateParentTaskInput,
|
|
4
4
|
type MonitorTask,
|
|
5
|
-
} from "
|
|
6
|
-
import { MonitorStore, type MonitorOutput } from "
|
|
7
|
-
import { correlateHubPane } from "
|
|
5
|
+
} from "../lib/hermes-monitor-model.ts";
|
|
6
|
+
import { MonitorStore, type MonitorOutput } from "../lib/hermes-monitor-store.ts";
|
|
7
|
+
import { correlateHubPane } from "../lib/hermes-monitor-herdr.ts";
|
|
8
8
|
|
|
9
9
|
export interface ViewerGatedMonitor {
|
|
10
10
|
setViewers(count: number): void;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { MonitorStore } from '
|
|
1
|
+
import { MonitorStore } from '../lib/hermes-monitor-store.ts'; import { MonitorPublisher } from './monitor-publisher.ts';
|
|
2
2
|
const terminal=(state:any)=>["completed","blocked","failed","cancelled","orphaned","done"].includes(state);
|
|
3
3
|
export function createMonitorSessionBridge(deps:any={}){const store=deps.store??new MonitorStore({now:deps.now}),pub=deps.publisher??new MonitorPublisher(store),keys=new Map(),ready=new Map(),late=new Map(),finalized=new Map(),cancellable=new Set(),waitAborts=new Map(),recovering=new Map(),monitorKeyByTask=new Map(),lateByGeneration=new Map();let currentOwner:any=deps.currentOwner??{};const runtime=deps.runtime;try{if(runtime){const restored=runtime.load().tasks??[];store.restore(restored);for(const task of restored){if(task.monitorKey){const id=`${task.id}:${task.generation}`;monitorKeyByTask.set(id,task.monitorKey);if(task.lateHistory)lateByGeneration.set(`${task.monitorKey}:${task.generation}`,task.lateHistory);const prior=keys.get(task.monitorKey);if(!prior||prior.generation<task.generation){keys.set(task.monitorKey,{id:task.id,generation:task.generation});ready.set(task.monitorKey,Promise.resolve(task));}}}}}catch(error){throw error}const persist=()=>runtime?.save({tasks:(store.durableSnapshot?.().tasks??records()).map((task:any)=>({...task,monitorKey:monitorKeyByTask.get(`${task.id}:${task.generation}`),lateHistory:lateByGeneration.get(`${monitorKeyByTask.get(`${task.id}:${task.generation}`)}:${task.generation}`)??[]}))});const records=()=>store.snapshot().tasks as any[];const lateEvent=(key:string,event:any,generation?:number)=>{generation??=keys.get(key)?.generation;const lateKey=generation===undefined?key:`${key}:${generation}`;const h=lateByGeneration.get(lateKey)??[];h.push(event);if(h.length>200)h.splice(0,h.length-200);lateByGeneration.set(lateKey,h);late.set(key,h);persist();return{state:'cancelled',history:h};};const after=(key:string,work:(v:any)=>any)=>{const pending=ready.get(key);if(!pending)return Promise.reject(new Error(`child ${key} is not registered`));const chained=pending.then(()=>{const v:any=keys.get(key);return work(v);}).then(value=>{persist();return value;});ready.set(key,chained.catch(()=>undefined));return chained;};return{
|
|
4
4
|
setCurrentOwner(owner:any){currentOwner={...owner};if(owner.updateActive){for(const task of records())if(!terminal(task.state)){if(!task.ownerSessionId)store.patch(task.id,task.generation,{ownerSessionId:owner.ownerSessionId,ownerLeaseExpiresAt:owner.ownerLeaseExpiresAt});else if(task.ownerSessionId===owner.ownerSessionId)store.patch(task.id,task.generation,{ownerLeaseExpiresAt:owner.ownerLeaseExpiresAt});}persist();}}, startParent(v:any){const task=pub.publishParent({...v,...currentOwner,generation:v.generation??1});keys.set(`parent:${task.id}`,{id:task.id,generation:task.generation});monitorKeyByTask.set(`${task.id}:${task.generation}`,`parent:${task.id}`);persist();return task},
|
|
@@ -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
|
|
|
@@ -80,11 +80,11 @@ Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at r
|
|
|
80
80
|
pi -e .pi/harnesses/coms/index.ts
|
|
81
81
|
```
|
|
82
82
|
|
|
83
|
-
For a guarded coms node
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
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.
|
|
88
88
|
|
|
89
89
|
## Upstream changes
|
|
90
90
|
|
|
@@ -69,9 +69,9 @@ outcomes) is logged to the `damage-control-log` session entries.
|
|
|
69
69
|
|
|
70
70
|
## When it's used (this repo)
|
|
71
71
|
|
|
72
|
-
`just
|
|
73
|
-
|
|
74
|
-
helper, and nested delegate**. If the harness cannot be resolved, Agent Hub
|
|
72
|
+
Every `just fleet` Pi mode loads this harness: the default interactive session,
|
|
73
|
+
standalone peers, Hub, and Herdr Pi peers. Agent Hub additionally re-loads it into
|
|
74
|
+
every native **specialist, research helper, and nested delegate**. If the harness cannot be resolved, Agent Hub
|
|
75
75
|
refuses guarded child dispatch rather than launching an unprotected process.
|
|
76
76
|
|
|
77
77
|
## Commands & tools
|
|
@@ -94,12 +94,12 @@ Blocking itself runs passively on the `tool_call` event.
|
|
|
94
94
|
|
|
95
95
|
```bash
|
|
96
96
|
# standalone continue-mode guardrail session
|
|
97
|
-
just
|
|
97
|
+
just fleet
|
|
98
98
|
pi -e .pi/harnesses/damage-control-continue/index.ts
|
|
99
99
|
|
|
100
|
-
#
|
|
101
|
-
just hub
|
|
102
|
-
just hub
|
|
100
|
+
# Hub variants
|
|
101
|
+
just fleet hub
|
|
102
|
+
just fleet hub --solo
|
|
103
103
|
|
|
104
104
|
# direct continue-guarded hub launch
|
|
105
105
|
pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/index.ts
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { herdr, subscribe, type HerdrClientOptions, type SubscribeHandle } from "./herdr-client.ts";
|
|
2
|
+
|
|
3
|
+
export interface HubCorrelation { workspaceId?: string; hubPaneId?: string; status: "correlated" | "uncorrelated" | "reconnecting"; }
|
|
4
|
+
|
|
5
|
+
export async function correlateHubPane(env: NodeJS.ProcessEnv = process.env, opts: HerdrClientOptions = {}): Promise<HubCorrelation> {
|
|
6
|
+
const hubPaneId = env.HERDR_PANE_ID;
|
|
7
|
+
if (env.HERDR_ENV !== "1" || !hubPaneId) return { status: "uncorrelated" };
|
|
8
|
+
try { const { pane } = await herdr.paneGet(hubPaneId, { socketPath: env.HERDR_SOCKET_PATH, ...opts }); return { workspaceId: pane.workspace_id, hubPaneId, status: "correlated" }; }
|
|
9
|
+
catch { return { hubPaneId, status: "reconnecting" }; }
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export function watchHubMonitor(options: { env?: NodeJS.ProcessEnv; onStatus: (value: HubCorrelation) => void; onOutput?: (output: { sequence: number; text: string }) => void; initialCursor?: number; reconnectDelayMs?: number }): SubscribeHandle | null {
|
|
13
|
+
const env = options.env ?? process.env;
|
|
14
|
+
const paneId = env.HERDR_PANE_ID;
|
|
15
|
+
if (env.HERDR_ENV !== "1" || !paneId) { options.onStatus({ status: "uncorrelated" }); return null; }
|
|
16
|
+
let cursor = options.initialCursor ?? 0;
|
|
17
|
+
const refresh = async () => {
|
|
18
|
+
try {
|
|
19
|
+
const { pane } = await herdr.paneGet(paneId, { socketPath: env.HERDR_SOCKET_PATH });
|
|
20
|
+
options.onStatus({ workspaceId: pane.workspace_id, hubPaneId: paneId, status: "correlated" });
|
|
21
|
+
const output = (pane as { monitor_resync_output?: { sequence?: number; text?: string } }).monitor_resync_output;
|
|
22
|
+
if (output && typeof output.sequence === "number" && output.sequence > cursor && typeof output.text === "string") { cursor = output.sequence; options.onOutput?.({ sequence: output.sequence, text: output.text }); }
|
|
23
|
+
} catch { options.onStatus({ hubPaneId: paneId, status: "reconnecting" }); }
|
|
24
|
+
};
|
|
25
|
+
void refresh();
|
|
26
|
+
let connected = false;
|
|
27
|
+
return subscribe([{ type: "pane.agent_status_changed", pane_id: paneId }], () => void refresh(), { socketPath: env.HERDR_SOCKET_PATH, reconnectDelayMs: options.reconnectDelayMs, onConnect: () => { if (connected) options.onStatus({ hubPaneId: paneId, status: "reconnecting" }); connected = true; void refresh(); }, onError: () => options.onStatus({ hubPaneId: paneId, status: "reconnecting" }) });
|
|
28
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export type MonitorTaskState = "starting" | "running" | "cancelling" | "completed" | "blocked" | "failed" | "cancelled" | "orphaned" | "recovering";
|
|
2
|
+
export const TERMINAL_TASK_STATES = new Set<MonitorTaskState>(["completed","blocked","failed","cancelled","orphaned"]);export type MonitorTaskKind="parent"|"child";
|
|
3
|
+
export interface MonitorTask{id:string;generation:number;kind:MonitorTaskKind;state:MonitorTaskState;parentId?:string;parentGeneration?:number;hubInstanceId?:string;checkoutId?:string;specialist?:string;workspaceId?:string;hubPaneId?:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
|
|
4
|
+
export interface CreateParentTaskInput{id:string;generation:number;hubInstanceId:string;checkoutId:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
|
|
5
|
+
export interface CreateChildTaskInput{id:string;generation:number;parentId:string;parentGeneration:number;specialist:string;workspaceId?:string;hubPaneId?:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
|
|
6
|
+
function requireStableIdentity(id:string,generation:number){if(!id)throw Error("task id is required");if(!Number.isInteger(generation)||generation<1)throw Error("task generation must be a positive integer");}const owner=(i:any)=>({...((i.ownerSessionId)?{ownerSessionId:i.ownerSessionId}:{}),...((i.ownerLeaseExpiresAt)?{ownerLeaseExpiresAt:i.ownerLeaseExpiresAt}:{})});
|
|
7
|
+
export function createParentTask(input:CreateParentTaskInput):MonitorTask{requireStableIdentity(input.id,input.generation);if(!input.hubInstanceId||!input.checkoutId)throw Error("parent correlation is required");return{id:input.id,generation:input.generation,kind:"parent",state:"starting",hubInstanceId:input.hubInstanceId,checkoutId:input.checkoutId,...owner(input)};}
|
|
8
|
+
export function createChildTask(input:CreateChildTaskInput):MonitorTask{requireStableIdentity(input.id,input.generation);if(!input.parentId||!Number.isInteger(input.parentGeneration)||input.parentGeneration<1||!input.specialist)throw Error("child hierarchy is required");return{id:input.id,generation:input.generation,kind:"child",state:"starting",parentId:input.parentId,parentGeneration:input.parentGeneration,specialist:input.specialist,...(input.workspaceId?{workspaceId:input.workspaceId}:{}),...(input.hubPaneId?{hubPaneId:input.hubPaneId}:{}),...owner(input)};}
|
|
9
|
+
export function transitionTask(task:MonitorTask,state:MonitorTaskState):MonitorTask{if(TERMINAL_TASK_STATES.has(task.state))throw Error(`terminal task ${task.id} cannot mutate`);if(state==="starting")throw Error("tasks cannot transition back to starting");return{...task,state};}export function continueTask(task:MonitorTask):MonitorTask{if(task.state!=="blocked")throw Error(`only blocked task ${task.id} can continue`);return{...task,generation:task.generation+1,state:"starting"};}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import * as crypto from "node:crypto"; import * as fs from "node:fs"; import * as path from "node:path";
|
|
2
|
+
export interface MonitorRegistration {profileKey:string;namespacePath:string;socketPath:string;socketDir:string;token:string;namespaceMode:number;tokenMode:number;discoveryPath:string;snapshot():unknown;cancel?(r:{taskId:string;generation:number}):unknown|Promise<unknown>;output?(r:{taskId:string;generation:number;afterSequence:number}):unknown|Promise<unknown>;cleanup():void;renew():void;leaseMs:number;ownerId?:string;leaseExpiresAt?:string;}
|
|
3
|
+
export interface MonitorRegistryOptions {runtimeDir:string;now?:()=>Date;pid?:number;leaseMs?:number;beforeRenewPublish?:()=>void;} export interface RegisterMonitorInput {profilePath:string;profileId?:string;hubInstanceId:string;snapshot:()=>unknown;}
|
|
4
|
+
const D=0o700,F=0o600;const validDiscovery=(d:any)=>typeof d?.owner==="string"&&/^[0-9a-f-]{36}$/i.test(d.owner)&&typeof d.token==="string"&&/^token-[0-9a-f-]{36}$/i.test(d.token)&&typeof d.socket==="string"&&/^@runtime\/s\/[a-f0-9]+\/s$/.test(d.socket)&&typeof d.lease?.hub==="string"&&/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(d.lease.hub)&&Number.isInteger(d.lease?.pid)&&d.lease.pid>0&&typeof d.lease?.startedAt==="string"&&!Number.isNaN(Date.parse(d.lease.startedAt))&&typeof d.lease?.expiresAt==="string"&&!Number.isNaN(Date.parse(d.lease.expiresAt));const mode=(p:string)=>fs.statSync(p).mode&0o777;function dir(p:string){if(!path.isAbsolute(p))throw Error("monitor runtime directory must be absolute");fs.mkdirSync(p,{recursive:true,mode:D});if(fs.lstatSync(p).isSymbolicLink())throw Error("monitor runtime directory must not be a symlink");fs.chmodSync(p,D);}export function canonicalMonitorProfileId(id:string){if(!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id)||id.includes(".."))throw Error("monitor profile id is unsafe");return crypto.createHash("sha256").update(id).digest("hex");}function profile(p:string,id?:string){if(id)return canonicalMonitorProfileId(id);const real=fs.realpathSync(p);if(!fs.statSync(real).isDirectory())throw Error("monitor profile path must be a directory");return crypto.createHash("sha256").update(real).digest("hex");}function hub(id:string){if(!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id)||id.includes(".."))throw Error("hub instance id is unsafe");return crypto.createHash("sha256").update(id).digest("hex");}function atomic(p:string,s:string){const t=`${p}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;fs.writeFileSync(t,s,{mode:F,flag:"wx"});fs.chmodSync(t,F);fs.renameSync(t,p);}
|
|
5
|
+
export class MonitorRegistry {private runtimeDir:string;private now:()=>Date;private pid:number;private leaseMs:number;private beforeRenewPublish?:()=>void;constructor(o:MonitorRegistryOptions){this.runtimeDir=o.runtimeDir;this.now=o.now??(()=>new Date());this.pid=o.pid??process.pid;this.leaseMs=o.leaseMs??30_000;this.beforeRenewPublish=o.beforeRenewPublish;dir(this.runtimeDir);}register(input:RegisterMonitorInput):MonitorRegistration{const key=profile(input.profilePath,input.profileId),h=hub(input.hubInstanceId),ns=path.join(this.runtimeDir,key,h);dir(path.join(this.runtimeDir,key));dir(ns);for(const file of fs.readdirSync(ns).filter(x=>x.startsWith("discovery-"))){const discoveryPath=path.join(ns,file);try{const d=JSON.parse(fs.readFileSync(discoveryPath,"utf8"));if(!validDiscovery(d)||d.token!==`token-${d.owner}`||d.socket!==`@runtime/s/${crypto.createHash("sha256").update(`${key}:${h}:${d.owner}`).digest("hex").slice(0,32)}/s`)throw new Error("monitor discovery metadata is malformed");if(new Date(d.lease?.expiresAt).getTime()>this.now().getTime()){const error:any=Error("monitor namespace is owned by an active lease");error.leaseExpiresAt=d.lease.expiresAt;throw error;}const tokenName=d.token;if(typeof tokenName==="string"&&/^token-[0-9a-f-]+$/.test(tokenName))try{fs.unlinkSync(path.join(ns,tokenName))}catch(e:any){if(e?.code!=="ENOENT")throw e;}fs.unlinkSync(discoveryPath);const socket=typeof d.socket==="string"?d.socket:"";if(socket.startsWith("@runtime/s/")&&socket.endsWith("/s")){const socketDir=path.join(this.runtimeDir,socket.slice("@runtime/".length,-2));if(socketDir.startsWith(path.join(this.runtimeDir,"s")+path.sep))try{fs.rmSync(socketDir,{recursive:true,force:true})}catch{}}}catch(e:any){if(/active lease|malformed/.test(String(e)))throw e;if(e instanceof SyntaxError||e instanceof TypeError||e instanceof RangeError)throw new Error("monitor discovery metadata is malformed");}}
|
|
6
|
+
const owner=crypto.randomUUID(),socketDir=path.join(this.runtimeDir,"s",crypto.createHash("sha256").update(`${key}:${h}:${owner}`).digest("hex").slice(0,32));dir(socketDir);const tokenPath=path.join(ns,`token-${owner}`),discoveryPath=path.join(ns,`discovery-${owner}.json`),socketPath=path.join(socketDir,"s"),token=crypto.randomBytes(32).toString("hex"),started=this.now();atomic(tokenPath,token);const tokenFd=fs.openSync(tokenPath,"r");const write=(issued:Date)=>atomic(discoveryPath,JSON.stringify({owner,socket:`@runtime/s/${path.basename(socketDir)}/s`,token:path.basename(tokenPath),lease:{hub:input.hubInstanceId,pid:this.pid,startedAt:started.toISOString(),expiresAt:new Date(issued.getTime()+this.leaseMs).toISOString()}}));write(started);const owns=()=>{try{return fs.fstatSync(tokenFd).nlink===1&&fs.readFileSync(tokenPath,"utf8")===token&&JSON.parse(fs.readFileSync(discoveryPath,"utf8")).owner===owner;}catch{return false;}};const cleanup=()=>{if(!owns())return;for(const p of [tokenPath,discoveryPath])try{fs.unlinkSync(p)}catch(e:any){if(e?.code!=="ENOENT")throw e;}finally{try{fs.closeSync(tokenFd)}catch{}}};return{profileKey:key,ownerId:owner,leaseExpiresAt:new Date(started.getTime()+this.leaseMs).toISOString(),namespacePath:ns,socketPath,socketDir,token,namespaceMode:mode(ns),tokenMode:mode(tokenPath),discoveryPath,snapshot:input.snapshot,cleanup,renew:()=>{if(!owns())throw Error("monitor ownership lost");this.beforeRenewPublish?.();if(!owns())throw Error("monitor ownership lost");const renewedAt=this.now();write(renewedAt);if(!owns()){try{if(JSON.parse(fs.readFileSync(discoveryPath,"utf8")).owner===owner)fs.unlinkSync(discoveryPath)}catch{}throw Error("monitor ownership lost");}return{leaseExpiresAt:new Date(renewedAt.getTime()+this.leaseMs).toISOString()};},leaseMs:this.leaseMs};} evidenceForOwner(ownerId:string,hubInstanceId:string){try{if(!/^[0-9a-f-]{36}$/i.test(ownerId))throw Error("malformed");const h=hub(hubInstanceId);for(const profileKey of fs.readdirSync(this.runtimeDir)){const p=path.join(this.runtimeDir,profileKey,h,`discovery-${ownerId}.json`);if(!fs.existsSync(p))continue;const d=JSON.parse(fs.readFileSync(p,"utf8"));if(!validDiscovery(d)||d.owner!==ownerId||d.token!==`token-${ownerId}`)throw Error("malformed");const token=path.join(path.dirname(p),d.token),socket=path.join(this.runtimeDir,d.socket.slice("@runtime/".length));return{owner:fs.existsSync(token),socket:fs.existsSync(socket),session:fs.existsSync(token),expired:new Date(d.lease.expiresAt).getTime()<=this.now().getTime()};}return{owner:false,socket:false,session:false,expired:true};}catch(error){return{transient:true,error};}}}
|