@chankov/agent-fleet 0.0.3 → 0.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/setup-agent-fleet.md +1 -1
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/harnesses/agent-hub/README.md +199 -16
- package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.pi/harnesses/agent-hub/delegate.ts +32 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.pi/harnesses/agent-hub/helpers.ts +49 -0
- package/.pi/harnesses/agent-hub/index.ts +1033 -242
- package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.pi/harnesses/agent-hub/package.json +5 -4
- package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.pi/harnesses/agent-hub/spawn.ts +161 -94
- package/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.pi/harnesses/coms/README.md +10 -0
- package/.pi/harnesses/coms/index.ts +2 -0
- package/.pi/harnesses/coms/package.json +5 -4
- package/.pi/harnesses/coms/version.ts +18 -0
- package/.pi/harnesses/damage-control-continue/README.md +32 -31
- package/.pi/harnesses/damage-control-continue/index.ts +23 -9
- package/.pi/harnesses/damage-control-continue/package.json +5 -4
- package/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
- package/.pi/prompts/setup-agent-fleet.md +1 -1
- package/.versions/0.0.4/.claude/commands/build.md +44 -0
- package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.4/.claude/commands/plan.md +16 -0
- package/.versions/0.0.4/.claude/commands/prime.md +22 -0
- package/.versions/0.0.4/.claude/commands/review.md +16 -0
- package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.4/.claude/commands/ship.md +72 -0
- package/.versions/0.0.4/.claude/commands/spec.md +15 -0
- package/.versions/0.0.4/.claude/commands/test.md +19 -0
- package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
- package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.4/.pi/extensions/package.json +9 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.4/.pi/prompts/build.md +24 -0
- package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.4/.pi/prompts/review.md +16 -0
- package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.4/.pi/prompts/test.md +19 -0
- package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.4/.version +1 -0
- package/.versions/0.0.4/agents/architect.md +23 -0
- package/.versions/0.0.4/agents/bowser.md +26 -0
- package/.versions/0.0.4/agents/builder.md +53 -0
- package/.versions/0.0.4/agents/code-reviewer.md +205 -0
- package/.versions/0.0.4/agents/deep-researcher.md +31 -0
- package/.versions/0.0.4/agents/documenter.md +18 -0
- package/.versions/0.0.4/agents/orchestrator.md +54 -0
- package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.4/agents/planner.md +69 -0
- package/.versions/0.0.4/agents/releaser.md +24 -0
- package/.versions/0.0.4/agents/researcher.md +28 -0
- package/.versions/0.0.4/agents/security-auditor.md +166 -0
- package/.versions/0.0.4/agents/test-engineer.md +151 -0
- package/.versions/0.0.4/agents/web-debugger.md +42 -0
- package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
- package/.versions/0.0.4/docs/getting-started.md +183 -0
- package/.versions/0.0.4/docs/npm-install.md +337 -0
- package/.versions/0.0.4/docs/opencode-setup.md +248 -0
- package/.versions/0.0.4/docs/pi-extensions.md +288 -0
- package/.versions/0.0.4/docs/pi-setup.md +463 -0
- package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.4/hermes/README.md +228 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.4/hooks/hooks.json +14 -0
- package/.versions/0.0.4/hooks/session-start.sh +74 -0
- package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.4/justfile +256 -0
- package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.4/references/definition-of-done.md +67 -0
- package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.4/references/observability-checklist.md +91 -0
- package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.4/references/performance-checklist.md +153 -0
- package/.versions/0.0.4/references/prompting-patterns.md +380 -0
- package/.versions/0.0.4/references/security-checklist.md +179 -0
- package/.versions/0.0.4/references/testing-patterns.md +236 -0
- package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
- package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
- package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
- package/.versions/0.0.4/scripts/team-up.ts +333 -0
- package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +53 -0
- package/README.md +3 -3
- package/agents/builder.md +1 -1
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +3 -3
- package/agents/orchestrator.md +20 -11
- package/agents/plan-reviewer.md +3 -3
- package/agents/test-engineer.md +11 -4
- package/bin/lib/validate-overrides.js +19 -0
- package/bin/sync-harness-versions.js +94 -0
- package/docs/ARCHITECTURE.md +46 -1
- package/docs/agent-fleet-setup.md +10 -0
- package/docs/pi-extensions.md +49 -14
- package/docs/pi-setup.md +10 -4
- package/hermes/README.md +180 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/justfile +6 -10
- package/package.json +9 -4
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/scripts/lib/hermes-monitor-model.ts +9 -0
- package/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/scripts/lib/hermes-monitor-store.ts +31 -0
- package/skills/designing-agents/SKILL.md +2 -2
- package/skills/designing-agents/pi-harness-authoring.md +26 -13
- package/skills/guided-workspace-setup/SKILL.md +11 -8
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
"""Agent Fleet-owned, local-only monitor transport boundary.
|
|
2
|
+
|
|
3
|
+
Hermes supplies the FastAPI router; this adapter speaks only the source-owned
|
|
4
|
+
monitor UDS protocol and never controls Hermes, Pi, or Herdr lifecycle.
|
|
5
|
+
"""
|
|
6
|
+
import hashlib
|
|
7
|
+
import json
|
|
8
|
+
import os
|
|
9
|
+
import re
|
|
10
|
+
import socket
|
|
11
|
+
import stat
|
|
12
|
+
from datetime import datetime, timezone
|
|
13
|
+
from pathlib import Path
|
|
14
|
+
|
|
15
|
+
MAX_SNAPSHOT_RESPONSE_BYTES = 256 * 1024
|
|
16
|
+
MAX_CANCEL_RESPONSE_BYTES = 16 * 1024
|
|
17
|
+
MAX_OUTPUT_RESPONSE_BYTES = 2 * 1024 * 1024
|
|
18
|
+
|
|
19
|
+
class MonitorUnavailable(RuntimeError): pass
|
|
20
|
+
|
|
21
|
+
class MonitorAdapter:
|
|
22
|
+
def __init__(self, socket_path: str, token: str) -> None:
|
|
23
|
+
if not socket_path or not token or not os.path.isabs(socket_path):
|
|
24
|
+
raise MonitorUnavailable("local monitor configuration is unavailable")
|
|
25
|
+
self._socket_path, self._token = socket_path, token
|
|
26
|
+
|
|
27
|
+
@classmethod
|
|
28
|
+
def from_environment(cls, env: dict[str, str] | None = None) -> "MonitorAdapter":
|
|
29
|
+
values = os.environ if env is None else env
|
|
30
|
+
return cls(values.get("AGENT_FLEET_MONITOR_SOCKET", ""), values.get("AGENT_FLEET_MONITOR_TOKEN", ""))
|
|
31
|
+
|
|
32
|
+
@staticmethod
|
|
33
|
+
def canonical_profile_id(profile_id: str) -> str:
|
|
34
|
+
# Matches Node's conservative human profile-ID validation and namespace hash.
|
|
35
|
+
if not isinstance(profile_id, str) or not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]{0,127}", profile_id) or ".." in profile_id:
|
|
36
|
+
raise MonitorUnavailable("monitor profile discovery is unavailable")
|
|
37
|
+
return hashlib.sha256(profile_id.encode()).hexdigest()
|
|
38
|
+
|
|
39
|
+
@classmethod
|
|
40
|
+
def from_profile_environment(cls, env: dict[str, str] | None = None) -> "MonitorAdapter":
|
|
41
|
+
values = os.environ if env is None else env
|
|
42
|
+
profile_id, runtime = values.get("AGENT_FLEET_PROFILE_ID", ""), values.get("AGENT_FLEET_MONITOR_RUNTIME_DIR", "")
|
|
43
|
+
if not os.path.isabs(runtime):
|
|
44
|
+
raise MonitorUnavailable("monitor profile discovery is unavailable")
|
|
45
|
+
profile_id = cls.canonical_profile_id(profile_id)
|
|
46
|
+
try:
|
|
47
|
+
root = Path(runtime)
|
|
48
|
+
if root.is_symlink() or not root.is_dir() or stat.S_IMODE(root.stat().st_mode) != 0o700: raise ValueError()
|
|
49
|
+
candidates = []
|
|
50
|
+
for candidate in (root / profile_id).glob("*/discovery-*.json"):
|
|
51
|
+
try:
|
|
52
|
+
candidate_stat = candidate.lstat()
|
|
53
|
+
if candidate.is_symlink() or not stat.S_ISREG(candidate_stat.st_mode) or stat.S_IMODE(candidate_stat.st_mode) != 0o600: raise ValueError()
|
|
54
|
+
item = json.loads(candidate.read_text())
|
|
55
|
+
lease = item["lease"]
|
|
56
|
+
if not isinstance(lease, dict) or not isinstance(item.get("owner"), str) or not re.fullmatch(r"[0-9a-f-]{36}", item["owner"], re.I) or not isinstance(item.get("token"), str) or not re.fullmatch(r"token-[0-9a-f-]{36}", item["token"], re.I) or not isinstance(item.get("socket"), str) or not re.fullmatch(r"@runtime/s/[0-9a-f]+/s", item["socket"]) or not isinstance(lease.get("hub"), str) or not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]{0,127}", lease["hub"]) or type(lease.get("pid")) is not int or lease["pid"] < 1 or not isinstance(lease.get("startedAt"), str) or not isinstance(lease.get("expiresAt"), str): raise ValueError()
|
|
57
|
+
expected_token = f"token-{item['owner']}"
|
|
58
|
+
hub_hash = hashlib.sha256(lease['hub'].encode()).hexdigest()
|
|
59
|
+
expected_socket = "@runtime/s/" + hashlib.sha256(f"{profile_id}:{hub_hash}:{item['owner']}".encode()).hexdigest()[:32] + "/s"
|
|
60
|
+
if item['token'] != expected_token or item['socket'] != expected_socket: raise ValueError()
|
|
61
|
+
if datetime.fromisoformat(lease["expiresAt"].replace("Z", "+00:00")) <= datetime.now(timezone.utc):
|
|
62
|
+
token = item.get("token", "")
|
|
63
|
+
if isinstance(token, str) and token.startswith("token-") and "/" not in token: (candidate.parent / token).unlink(missing_ok=True)
|
|
64
|
+
candidate.unlink(missing_ok=True)
|
|
65
|
+
continue
|
|
66
|
+
candidates.append(candidate)
|
|
67
|
+
except (OSError, ValueError, KeyError, TypeError, json.JSONDecodeError) as error:
|
|
68
|
+
raise ValueError("monitor discovery metadata is malformed") from error
|
|
69
|
+
if not candidates: raise ValueError()
|
|
70
|
+
adapters = []
|
|
71
|
+
for discovery_path in candidates:
|
|
72
|
+
discovery = json.loads(discovery_path.read_text())
|
|
73
|
+
lease = discovery["lease"]
|
|
74
|
+
socket_ref, token_ref = discovery["socket"], discovery["token"]
|
|
75
|
+
if not isinstance(socket_ref, str) or not socket_ref.startswith("@runtime/") or ".." in Path(socket_ref).parts: raise ValueError()
|
|
76
|
+
if not isinstance(token_ref, str) or not token_ref.startswith("token-") or "/" in token_ref or ".." in token_ref: raise ValueError()
|
|
77
|
+
token_path = discovery_path.parent / token_ref
|
|
78
|
+
if token_path.is_symlink() or stat.S_IMODE(token_path.stat().st_mode) != 0o600: raise ValueError()
|
|
79
|
+
adapters.append((lease["hub"], cls(str(root / socket_ref.removeprefix("@runtime/")), token_path.read_text().strip())))
|
|
80
|
+
return FleetMonitorAdapter(adapters)
|
|
81
|
+
discovery_path = candidates[0]
|
|
82
|
+
if discovery_path.is_symlink() or stat.S_IMODE(discovery_path.stat().st_mode) != 0o600: raise ValueError()
|
|
83
|
+
discovery = json.loads(discovery_path.read_text())
|
|
84
|
+
lease = discovery["lease"]
|
|
85
|
+
if not isinstance(lease, dict) or datetime.fromisoformat(lease["expiresAt"].replace("Z", "+00:00")) <= datetime.now(timezone.utc): raise ValueError()
|
|
86
|
+
socket_ref, token_ref = discovery["socket"], discovery["token"]
|
|
87
|
+
if not isinstance(socket_ref, str) or not socket_ref.startswith("@runtime/") or ".." in Path(socket_ref).parts: raise ValueError()
|
|
88
|
+
if not isinstance(token_ref, str) or not token_ref.startswith("token-") or "/" in token_ref or ".." in token_ref: raise ValueError()
|
|
89
|
+
socket_path = root / socket_ref.removeprefix("@runtime/")
|
|
90
|
+
token_path = discovery_path.parent / token_ref
|
|
91
|
+
if token_path.is_symlink() or stat.S_IMODE(token_path.stat().st_mode) != 0o600: raise ValueError()
|
|
92
|
+
return cls(str(socket_path), token_path.read_text().strip())
|
|
93
|
+
except (OSError, ValueError, KeyError, TypeError, json.JSONDecodeError) as error:
|
|
94
|
+
raise MonitorUnavailable("monitor profile discovery is unavailable") from error
|
|
95
|
+
|
|
96
|
+
def _request(self, request: dict, max_response_bytes: int = MAX_SNAPSHOT_RESPONSE_BYTES) -> dict:
|
|
97
|
+
try:
|
|
98
|
+
with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as client:
|
|
99
|
+
client.settimeout(2); client.connect(self._socket_path)
|
|
100
|
+
client.sendall((json.dumps({**request, "token": self._token})+"\n").encode())
|
|
101
|
+
data = b""
|
|
102
|
+
while b"\n" not in data:
|
|
103
|
+
chunk = client.recv(min(8192, max_response_bytes + 1 - len(data)))
|
|
104
|
+
if not chunk: raise MonitorUnavailable("local monitor closed the response")
|
|
105
|
+
data += chunk
|
|
106
|
+
if len(data) > max_response_bytes + 1: raise MonitorUnavailable("local monitor response is too large")
|
|
107
|
+
frame = data.split(b"\n", 1)[0]
|
|
108
|
+
if len(frame) > max_response_bytes: raise MonitorUnavailable("local monitor response is too large")
|
|
109
|
+
response = json.loads(frame)
|
|
110
|
+
if not isinstance(response, dict): raise MonitorUnavailable("local monitor response is invalid")
|
|
111
|
+
return response
|
|
112
|
+
except (OSError, ValueError) as error:
|
|
113
|
+
raise MonitorUnavailable("local monitor is unavailable") from error
|
|
114
|
+
|
|
115
|
+
def snapshot(self) -> dict:
|
|
116
|
+
response = self._request({"type": "snapshot"})
|
|
117
|
+
if response.get("ok") is not True or not isinstance(response.get("snapshot"), dict):
|
|
118
|
+
raise MonitorUnavailable("local monitor rejected the snapshot request")
|
|
119
|
+
return response["snapshot"]
|
|
120
|
+
|
|
121
|
+
def output(self, task_id: str, generation: int, after_sequence: int) -> dict:
|
|
122
|
+
response = self._request({"type": "output", "taskId": task_id, "generation": generation, "afterSequence": after_sequence}, MAX_OUTPUT_RESPONSE_BYTES)
|
|
123
|
+
if response.get("ok") is not True or not isinstance(response.get("output"), dict): raise MonitorUnavailable("local monitor rejected output")
|
|
124
|
+
return response["output"]
|
|
125
|
+
|
|
126
|
+
def cancel(self, task_id: str, generation: int) -> dict:
|
|
127
|
+
if not task_id or not isinstance(generation, int):
|
|
128
|
+
raise MonitorUnavailable("local monitor cancellation is invalid")
|
|
129
|
+
response = self._request({"type": "cancel", "taskId": task_id, "generation": generation}, MAX_CANCEL_RESPONSE_BYTES)
|
|
130
|
+
if response.get("ok") is not True or not isinstance(response.get("result"), dict):
|
|
131
|
+
raise MonitorUnavailable("local monitor rejected cancellation")
|
|
132
|
+
return response["result"]
|
|
133
|
+
|
|
134
|
+
class FleetMonitorAdapter:
|
|
135
|
+
def __init__(self, hubs):
|
|
136
|
+
self._hubs = dict(hubs)
|
|
137
|
+
if len(self._hubs) == 1:
|
|
138
|
+
only = next(iter(self._hubs.values()))
|
|
139
|
+
self._socket_path, self._token = only._socket_path, only._token
|
|
140
|
+
def snapshot(self):
|
|
141
|
+
tasks, errors = [], []
|
|
142
|
+
for hub_id, adapter in self._hubs.items():
|
|
143
|
+
try:
|
|
144
|
+
for task in adapter.snapshot().get("tasks", []): tasks.append({**task, "hubInstanceId": hub_id})
|
|
145
|
+
except MonitorUnavailable: errors.append({"hubInstanceId": hub_id, "state": "orphaned", "error": "unavailable"})
|
|
146
|
+
return {"tasks": tasks, "hubs": errors}
|
|
147
|
+
def _hub(self, hub_instance_id):
|
|
148
|
+
if not isinstance(hub_instance_id, str) or hub_instance_id not in self._hubs: raise MonitorUnavailable("local monitor hub is unavailable")
|
|
149
|
+
return self._hubs[hub_instance_id]
|
|
150
|
+
def output(self, task_id, generation, after_sequence, hub_instance_id): return self._hub(hub_instance_id).output(task_id, generation, after_sequence)
|
|
151
|
+
def cancel(self, task_id, generation, hub_instance_id): return self._hub(hub_instance_id).cancel(task_id, generation)
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import json
|
|
2
|
+
import socket
|
|
3
|
+
import tempfile
|
|
4
|
+
import threading
|
|
5
|
+
import unittest
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
|
|
8
|
+
from adapter import MonitorAdapter, MonitorUnavailable
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
class AdapterTest(unittest.TestCase):
|
|
12
|
+
def test_hex_looking_profile_id_is_still_hashed(self):
|
|
13
|
+
value = "a" * 64
|
|
14
|
+
self.assertNotEqual(MonitorAdapter.canonical_profile_id(value), value)
|
|
15
|
+
def test_reads_only_authenticated_snapshot_from_unix_socket(self):
|
|
16
|
+
with tempfile.TemporaryDirectory() as directory:
|
|
17
|
+
socket_path = str(Path(directory) / "monitor.sock")
|
|
18
|
+
server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
|
|
19
|
+
server.bind(socket_path)
|
|
20
|
+
server.listen(1)
|
|
21
|
+
def serve():
|
|
22
|
+
client, _ = server.accept()
|
|
23
|
+
request = json.loads(client.recv(4096).decode())
|
|
24
|
+
self.assertEqual(request, {"type": "snapshot", "token": "secret"})
|
|
25
|
+
client.sendall(b'{"ok":true,"snapshot":{"tasks":[]}}\n')
|
|
26
|
+
client.close()
|
|
27
|
+
server.close()
|
|
28
|
+
thread = threading.Thread(target=serve)
|
|
29
|
+
thread.start()
|
|
30
|
+
self.assertEqual(MonitorAdapter(socket_path, "secret").snapshot(), {"tasks": []})
|
|
31
|
+
thread.join()
|
|
32
|
+
|
|
33
|
+
def test_refuses_missing_local_configuration(self):
|
|
34
|
+
with self.assertRaises(MonitorUnavailable):
|
|
35
|
+
MonitorAdapter.from_environment({})
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
if __name__ == "__main__":
|
|
39
|
+
unittest.main()
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
(function () {
|
|
2
|
+
"use strict";
|
|
3
|
+
window.__HERMES_PLUGINS__.register("agent-fleet-monitor", function AgentFleetMonitorBridge() {
|
|
4
|
+
const root = document.createElement("section");
|
|
5
|
+
root.setAttribute("role", "status");
|
|
6
|
+
root.setAttribute("aria-label", "Agent Fleet Monitor capability");
|
|
7
|
+
root.textContent = "Agent Fleet Monitor backend registered. The Desktop pane is provided separately; this hidden bundle does not create a duplicate pane under the current SDK.";
|
|
8
|
+
return root;
|
|
9
|
+
});
|
|
10
|
+
})();
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import unittest
|
|
2
|
+
from fastapi import HTTPException
|
|
3
|
+
from plugin_api import validate_task_request
|
|
4
|
+
|
|
5
|
+
class PluginApiValidationTest(unittest.TestCase):
|
|
6
|
+
def test_accepts_identical_bounded_task_contract(self):
|
|
7
|
+
validate_task_request("task-1:gen.2", 1, 0)
|
|
8
|
+
validate_task_request("x" * 128, 2, 1_000_000_000)
|
|
9
|
+
def test_rejects_invalid_task_generation_and_cursor(self):
|
|
10
|
+
for args in [("",1,0),("bad/path",1,0),("x"*129,1,0),("task",0,0),("task",True,0),("task",1,True),("task",1,-1),("task",1,1_000_000_001)]:
|
|
11
|
+
with self.assertRaises(HTTPException): validate_task_request(*args)
|
|
12
|
+
if __name__ == "__main__": unittest.main()
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
"""Manifest-mounted, fail-closed local Agent Fleet monitor boundary."""
|
|
2
|
+
|
|
3
|
+
from fastapi import APIRouter, HTTPException
|
|
4
|
+
|
|
5
|
+
from adapter import MonitorAdapter, MonitorUnavailable
|
|
6
|
+
|
|
7
|
+
router = APIRouter()
|
|
8
|
+
MAX_TASK_ID_LENGTH = 128
|
|
9
|
+
MAX_AFTER_SEQUENCE = 1_000_000_000
|
|
10
|
+
|
|
11
|
+
def validate_task_request(task_id: str, generation: int, after_sequence: int | None = None) -> None:
|
|
12
|
+
if not isinstance(task_id, str) or not 1 <= len(task_id) <= MAX_TASK_ID_LENGTH or not __import__("re").fullmatch(r"[A-Za-z0-9][A-Za-z0-9._:-]*", task_id):
|
|
13
|
+
raise HTTPException(status_code=422, detail="invalid task_id")
|
|
14
|
+
if type(generation) is not int or generation < 1:
|
|
15
|
+
raise HTTPException(status_code=422, detail="invalid generation")
|
|
16
|
+
if after_sequence is not None and (type(after_sequence) is not int or not 0 <= after_sequence <= MAX_AFTER_SEQUENCE):
|
|
17
|
+
raise HTTPException(status_code=422, detail="invalid after_sequence")
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
@router.get("/capabilities")
|
|
21
|
+
def capabilities() -> dict[str, bool]:
|
|
22
|
+
return {"monitor_adapter": True}
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
@router.get("/snapshot")
|
|
26
|
+
def snapshot() -> dict:
|
|
27
|
+
try:
|
|
28
|
+
return MonitorAdapter.from_profile_environment().snapshot()
|
|
29
|
+
except MonitorUnavailable as error:
|
|
30
|
+
raise HTTPException(status_code=503, detail="local Agent Fleet monitor unavailable") from error
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
@router.get("/output")
|
|
34
|
+
def output(task_id: str, generation: int, after_sequence: int, hub_instance_id: str) -> dict:
|
|
35
|
+
validate_task_request(task_id, generation, after_sequence)
|
|
36
|
+
if not isinstance(hub_instance_id, str) or not hub_instance_id: raise HTTPException(status_code=422, detail="invalid hub_instance_id")
|
|
37
|
+
try:
|
|
38
|
+
return MonitorAdapter.from_profile_environment().output(task_id, generation, after_sequence, hub_instance_id)
|
|
39
|
+
except MonitorUnavailable as error:
|
|
40
|
+
raise HTTPException(status_code=503, detail="local Agent Fleet monitor unavailable") from error
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
@router.post("/cancel")
|
|
44
|
+
def cancel(task_id: str, generation: int, hub_instance_id: str) -> dict:
|
|
45
|
+
validate_task_request(task_id, generation)
|
|
46
|
+
if not isinstance(hub_instance_id, str) or not hub_instance_id: raise HTTPException(status_code=422, detail="invalid hub_instance_id")
|
|
47
|
+
try:
|
|
48
|
+
return MonitorAdapter.from_profile_environment().cancel(task_id, generation, hub_instance_id)
|
|
49
|
+
except MonitorUnavailable as error:
|
|
50
|
+
raise HTTPException(status_code=503, detail="local Agent Fleet monitor unavailable") from error
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import pathlib
|
|
2
|
+
import unittest
|
|
3
|
+
from adapter import MonitorAdapter, MonitorUnavailable
|
|
4
|
+
|
|
5
|
+
ROOT = pathlib.Path(__file__).resolve().parents[4]
|
|
6
|
+
|
|
7
|
+
class ReviewLiveWiringRedTest(unittest.TestCase):
|
|
8
|
+
def test_explicit_human_profile_id_has_the_shared_canonical_namespace_contract(self):
|
|
9
|
+
# lifecycle accepts this documented human id; adapter must canonicalize it identically.
|
|
10
|
+
self.assertEqual(MonitorAdapter.canonical_profile_id("profile-a"), "104c4491498717b382d124bbe81ae4e87648fbab08ecba7e24135ead5fc97554")
|
|
11
|
+
|
|
12
|
+
def test_plugin_uses_fastapi_query_parameter_names_end_to_end(self):
|
|
13
|
+
source=(ROOT/"hermes/desktop-plugins/agent-fleet-monitor/plugin.js").read_text()
|
|
14
|
+
self.assertIn("task_id", source)
|
|
15
|
+
self.assertIn("after_sequence", source)
|
|
16
|
+
self.assertNotIn("afterSequence", source)
|
|
17
|
+
|
|
18
|
+
def test_cancel_response_has_an_explicit_bounded_wire_contract(self):
|
|
19
|
+
source=(ROOT/"scripts/lib/hermes-monitor-socket.ts").read_text()
|
|
20
|
+
self.assertRegex(source, r"MAX_CANCEL_RESPONSE_BYTES|cap.*cancel|cancel.*MAX_", "cancel response must be capped")
|
|
21
|
+
|
|
22
|
+
if __name__ == "__main__": unittest.main()
|
package/justfile
CHANGED
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
# under .pi/extensions/, so anything placed there loads on every plain `pi` run.
|
|
9
9
|
# Most harnesses are mutually exclusive — they live in .pi/harnesses/ (which pi
|
|
10
10
|
# does NOT auto-discover) and are loaded via `pi -e` below. The supported stack
|
|
11
|
-
#
|
|
12
|
-
#
|
|
11
|
+
# loads damage-control-continue before agent-hub, so hub sessions and all native
|
|
12
|
+
# children run with guardrails by default.
|
|
13
13
|
#
|
|
14
14
|
# Everything between the two `agent-fleet:harnesses` sentinels below is a
|
|
15
15
|
# MANAGED REGION: guided-workspace-setup regenerates it from the installed
|
|
@@ -45,12 +45,8 @@ pi:
|
|
|
45
45
|
|
|
46
46
|
# ---------------------------------------------------------------- safety
|
|
47
47
|
|
|
48
|
-
# Damage-control:
|
|
49
|
-
|
|
50
|
-
pi -e .pi/harnesses/damage-control/index.ts
|
|
51
|
-
|
|
52
|
-
# Damage-control (continue): same rules, but blocks deliver feedback so the agent adapts
|
|
53
|
-
# and keeps working instead of aborting the turn. Default guardrail for the hub main agent.
|
|
48
|
+
# Damage-control: blocks deliver feedback so the agent adapts and keeps working
|
|
49
|
+
# instead of aborting the turn. Default guardrail for the hub and native children.
|
|
54
50
|
ext-damage-control-continue:
|
|
55
51
|
pi -e .pi/harnesses/damage-control-continue/index.ts
|
|
56
52
|
|
|
@@ -62,8 +58,8 @@ ext-damage-control-continue:
|
|
|
62
58
|
# agents/orchestrator.md is installed, so the hub still launches when it is absent. Override
|
|
63
59
|
# with your own --system-prompt <persona>.md passed after `just hub`.
|
|
64
60
|
# Guarded agent hub: damage-control-continue + remote-capable ask_user + dispatcher grid + research helpers + embedded coms + orchestrator.
|
|
65
|
-
# The main session
|
|
66
|
-
#
|
|
61
|
+
# The main session and every native child use the continue guardrail; blocked calls
|
|
62
|
+
# feed back so the agent can report or safely adapt without aborting its turn.
|
|
67
63
|
hub *args:
|
|
68
64
|
persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts $persona {{args}}
|
|
69
65
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chankov/agent-fleet",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.4",
|
|
4
4
|
"description": "Multi-agent fleet orchestration for coding agents. Pi as the primary runtime, Herdr as the workspace control plane, coms as the peer data plane, and Hermes for remote control — plus skills, personas, harnesses, and a guided setup CLI.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -58,6 +58,10 @@
|
|
|
58
58
|
".pi/agents/",
|
|
59
59
|
".pi/damage-control-rules.yaml",
|
|
60
60
|
"scripts/*.ts",
|
|
61
|
+
"!scripts/hermes-monitor-capability-runner.ts",
|
|
62
|
+
"!scripts/hermes-monitor-capability-runner.test.ts",
|
|
63
|
+
"!scripts/hermes-monitor-scenario.ts",
|
|
64
|
+
"!scripts/hermes-monitor-scenario.test.ts",
|
|
61
65
|
"scripts/lib/*.ts",
|
|
62
66
|
"codex/",
|
|
63
67
|
"hermes/",
|
|
@@ -94,10 +98,10 @@
|
|
|
94
98
|
"access": "public"
|
|
95
99
|
},
|
|
96
100
|
"scripts": {
|
|
97
|
-
"test": "node bin/cli.js --version && node bin/cli.js --help && node bin/cli.js transform-persona --list --agent claude-code && node --test \"bin/test/*.test.js\"
|
|
101
|
+
"test": "node bin/cli.js --version && node bin/cli.js --help && node bin/cli.js transform-persona --list --agent claude-code && node --test \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts scripts/coms-cli.test.ts scripts/lib/codex-conductor.test.ts scripts/lib/codex-remote-control.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/index.test.ts .pi/extensions/btw/state.test.js .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research-retention.test.js .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts",
|
|
98
102
|
"pack:dry": "npm pack --dry-run",
|
|
99
103
|
"changeset": "changeset",
|
|
100
|
-
"version:changeset": "node bin/force-patch-changesets.js && changeset version && npm install --package-lock-only --ignore-scripts --no-audit --no-fund && node bin/snapshot-version.js",
|
|
104
|
+
"version:changeset": "node bin/force-patch-changesets.js && changeset version && node bin/sync-harness-versions.js && npm install --package-lock-only --ignore-scripts --no-audit --no-fund && node bin/snapshot-version.js",
|
|
101
105
|
"release": "changeset publish"
|
|
102
106
|
},
|
|
103
107
|
"devDependencies": {
|
|
@@ -105,7 +109,8 @@
|
|
|
105
109
|
},
|
|
106
110
|
"dependencies": {
|
|
107
111
|
"@sinclair/typebox": "^0.34.49",
|
|
108
|
-
"pi-ask-user": "^0.11.1"
|
|
112
|
+
"pi-ask-user": "^0.11.1",
|
|
113
|
+
"yaml": "^2.9.0"
|
|
109
114
|
},
|
|
110
115
|
"bundledDependencies": [
|
|
111
116
|
"pi-ask-user"
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as net from "node:net";
|
|
3
|
+
import { mkdtempSync } from "node:fs";
|
|
4
|
+
import { tmpdir } from "node:os";
|
|
5
|
+
import { join } from "node:path";
|
|
6
|
+
|
|
7
|
+
export interface FakeHerdrRequest {
|
|
8
|
+
id: string;
|
|
9
|
+
method: string;
|
|
10
|
+
params: Record<string, unknown>;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export class FakeHerdrServer {
|
|
14
|
+
public readonly requests: FakeHerdrRequest[] = [];
|
|
15
|
+
public readonly socketPath: string;
|
|
16
|
+
private readonly subscribers = new Set<net.Socket>();
|
|
17
|
+
private readonly server: net.Server;
|
|
18
|
+
private readonly root: string;
|
|
19
|
+
private workspaceId: string;
|
|
20
|
+
private readonly paneId: string;
|
|
21
|
+
private readonly resyncOutput: { sequence: number; text: string };
|
|
22
|
+
|
|
23
|
+
private constructor(socketPath: string, server: net.Server, root: string, paneId: string, workspaceId: string, resyncOutput: { sequence: number; text: string }) {
|
|
24
|
+
this.socketPath = socketPath;
|
|
25
|
+
this.server = server;
|
|
26
|
+
this.root = root;
|
|
27
|
+
this.paneId = paneId;
|
|
28
|
+
this.workspaceId = workspaceId;
|
|
29
|
+
this.resyncOutput = resyncOutput;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
static async start(values: { paneId: string; workspaceId: string; resyncOutput?: { sequence: number; text: string } }): Promise<FakeHerdrServer> {
|
|
33
|
+
const root = mkdtempSync(join(tmpdir(), "fake-herdr-"));
|
|
34
|
+
const socketPath = join(root, "s");
|
|
35
|
+
let fake: FakeHerdrServer;
|
|
36
|
+
const server = net.createServer((socket) => {
|
|
37
|
+
let buffer = "";
|
|
38
|
+
socket.on("data", (chunk) => {
|
|
39
|
+
buffer += chunk.toString("utf8");
|
|
40
|
+
let newline: number;
|
|
41
|
+
while ((newline = buffer.indexOf("\n")) >= 0) {
|
|
42
|
+
const line = buffer.slice(0, newline);
|
|
43
|
+
buffer = buffer.slice(newline + 1);
|
|
44
|
+
if (!line) continue;
|
|
45
|
+
const request = JSON.parse(line) as FakeHerdrRequest;
|
|
46
|
+
fake.requests.push(request);
|
|
47
|
+
if (request.method === "events.subscribe") {
|
|
48
|
+
fake.subscribers.add(socket);
|
|
49
|
+
socket.write(JSON.stringify({ id: request.id, result: { type: "subscription_started" } }) + "\n");
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
const result = request.method === "pane.get"
|
|
53
|
+
? { pane: { pane_id: fake.paneId, workspace_id: fake.workspaceId, monitor_resync_output: fake.resyncOutput } }
|
|
54
|
+
: request.method === "ping"
|
|
55
|
+
? { type: "pong", version: "fake", protocol: 14 }
|
|
56
|
+
: {};
|
|
57
|
+
socket.end(JSON.stringify({ id: request.id, result }) + "\n");
|
|
58
|
+
}
|
|
59
|
+
});
|
|
60
|
+
socket.on("close", () => fake.subscribers.delete(socket));
|
|
61
|
+
});
|
|
62
|
+
fake = new FakeHerdrServer(socketPath, server, root, values.paneId, values.workspaceId, values.resyncOutput ?? { sequence: 0, text: "" });
|
|
63
|
+
await new Promise<void>((resolve, reject) => server.listen(socketPath, resolve).once("error", reject));
|
|
64
|
+
return fake;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
setWorkspaceId(workspaceId: string): void {
|
|
68
|
+
this.workspaceId = workspaceId;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
emitStatus(): void {
|
|
72
|
+
for (const socket of this.subscribers) socket.write(JSON.stringify({ event: "pane.agent_status_changed", data: { pane_id: this.paneId } }) + "\n");
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
disconnectSubscribers(): void {
|
|
76
|
+
for (const socket of this.subscribers) socket.destroy();
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
subscriptionCount(): number {
|
|
80
|
+
return this.requests.filter((request) => request.method === "events.subscribe").length;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
async close(): Promise<void> {
|
|
84
|
+
this.disconnectSubscribers();
|
|
85
|
+
await new Promise<void>((resolve) => this.server.close(() => resolve()));
|
|
86
|
+
fs.rmSync(this.root, { recursive: true, force: true });
|
|
87
|
+
}
|
|
88
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { herdr, subscribe, type HerdrClientOptions, type SubscribeHandle } from "../../.pi/harnesses/lib/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};}}}
|