@chankov/agent-fleet 0.0.4 → 0.0.6
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/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +3 -3
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +84 -84
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/delegate.ts +3 -3
- package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
- package/.pi/harnesses/agent-hub/index.ts +254 -254
- 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/agent-hub/run-budget.js +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 +7 -7
- package/.pi/harnesses/coms/index.ts +13 -13
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +16 -16
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- 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/af-doctor-agent-fleet.md +15 -0
- package/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.pi/prompts/af-setup-agent-fleet.md +27 -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/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/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/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +15 -0
- package/README.md +38 -36
- package/agents/documenter.md +1 -1
- package/agents/releaser.md +1 -1
- package/bin/cli.js +103 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/set-hermes-telegram.js +323 -0
- package/docs/ARCHITECTURE.md +8 -8
- package/docs/agent-fleet-setup.md +12 -12
- 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/npm-install.md +21 -21
- package/docs/opencode-setup.md +1 -0
- package/docs/pi-extensions.md +36 -31
- package/docs/pi-setup.md +66 -53
- package/hermes/README.md +14 -11
- package/justfile +141 -152
- package/package.json +6 -3
- package/references/fleet-coordination-patterns.md +3 -3
- 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/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +27 -18
- 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/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
- /package/{.pi → .versions/0.0.5/.pi}/prompts/doctor-agent-fleet.md +0 -0
- /package/{.pi → .versions/0.0.5/.pi}/prompts/setup-agent-fleet.md +0 -0
- /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,231 @@
|
|
|
1
|
+
# Hermes artifacts
|
|
2
|
+
|
|
3
|
+
This directory contains in-repository Hermes skills for the coms Hermes bridge plan. They are source artifacts only; this pass does not modify `~/.hermes`.
|
|
4
|
+
|
|
5
|
+
## Skills
|
|
6
|
+
|
|
7
|
+
- `skills/hub-liaison/` — gateway-side Telegram liaison. It writes `~/.pi/coms/hermes-bridge/questions/<qid>.answer.json` answer files for `[HUB-Q:<qid>]` questions consumed by `scripts/coms-hermes-bridge.ts`.
|
|
8
|
+
- `skills/hub-conductor/` — dev-profile conductor. It uses `scripts/coms-cli.ts list` and `scripts/coms-cli.ts send --await --timeout` to delegate to live pi hub-team peers, while preserving the no-herdr damage-control boundary.
|
|
9
|
+
|
|
10
|
+
## Install
|
|
11
|
+
|
|
12
|
+
For `hub-liaison`, use Agent Fleet's deterministic profile-aware installer rather than a raw copy:
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
agent-fleet set-hermes-telegram status --profile default
|
|
16
|
+
agent-fleet set-hermes-telegram install --profile default
|
|
17
|
+
# Only when status reports a differing local tree:
|
|
18
|
+
agent-fleet set-hermes-telegram install --profile default --force
|
|
19
|
+
# Restart a currently running gateway only by explicit request:
|
|
20
|
+
agent-fleet set-hermes-telegram install --profile default --force --restart
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Pi and OpenCode use `/af-set-hermes-telegram`; Claude Code uses `/set-hermes-telegram`. The installer resolves the real profile path via `hermes profile show`, refuses drift without `--force`, backs up forced replacements, copies atomically, and verifies skill/tool/gateway readiness. It never sends a test Telegram message and never starts a stopped gateway. See [the bridge runbook](../docs/coms-hermes-bridge.md#set-hermes-telegram-bridge-control).
|
|
24
|
+
|
|
25
|
+
The current `hermes skills install` CLI documents registry identifiers and direct HTTP(S) `SKILL.md` URLs, not local directories, so `hermes skills install hermes/skills/hub-liaison` is not the supported local installation path.
|
|
26
|
+
|
|
27
|
+
`hub-conductor` remains a source artifact for the human's dev/conductor profile. Install it by a reviewed local copy into the path reported by `hermes profile show <profile>`, or publish/install it through a pinned Hermes skill source; it is intentionally not managed by the Telegram bridge command.
|
|
28
|
+
|
|
29
|
+
Use `hub-liaison` in the gateway-owning Telegram profile and `hub-conductor` in the human's dev/conductor profile. Verify availability with `hermes --profile <profile> skills list --enabled-only` before relying on them.
|
|
30
|
+
|
|
31
|
+
## Local agent-hub monitor integration
|
|
32
|
+
|
|
33
|
+
Agent Fleet exposes an optional **local monitor transport** for Hermes-facing tools. This is
|
|
34
|
+
separate from the Telegram/coms bridge:
|
|
35
|
+
|
|
36
|
+
- `hub-liaison` and `hub-conductor` handle human questions and delegation through coms.
|
|
37
|
+
- The monitor transport exposes dispatcher and specialist state through owner-only discovery,
|
|
38
|
+
a token file, and a Unix domain socket (UDS).
|
|
39
|
+
|
|
40
|
+
The repository does **not** ship or install a Hermes backend or Desktop plugin. A Hermes UI,
|
|
41
|
+
operator tool, or other local client may consume the transport contract described below, but it
|
|
42
|
+
owns its own presentation and lifecycle. The hub remains the source of truth for task state,
|
|
43
|
+
output cursors, leases, and generation-safe cancellation.
|
|
44
|
+
|
|
45
|
+
### Integration in action
|
|
46
|
+
|
|
47
|
+
The hub can surface an `ask_user` decision in Hermes Desktop while the specialist workflow keeps
|
|
48
|
+
running. The prompt preserves the question and its choices instead of flattening them into an
|
|
49
|
+
unstructured message:
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
The side-by-side view shows the same live question in the Pi hub and Hermes Desktop. This is the
|
|
54
|
+
question-piping path used for remote human input; task monitoring remains the separate local
|
|
55
|
+
transport described below.
|
|
56
|
+
|
|
57
|
+

|
|
58
|
+
|
|
59
|
+
### Start a monitored hub
|
|
60
|
+
|
|
61
|
+
Choose a stable Hermes profile ID and an absolute, owner-only runtime directory. A Herdr-backed
|
|
62
|
+
hub is required because the stable hub identity includes `HERDR_WORKSPACE_ID` and
|
|
63
|
+
`HERDR_PANE_ID`; the normal `hub-team` recipe supplies the Herdr environment.
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
monitor_runtime="${XDG_RUNTIME_DIR:?XDG_RUNTIME_DIR must be set}/agent-fleet-monitor"
|
|
67
|
+
install -d -m 700 "$monitor_runtime"
|
|
68
|
+
|
|
69
|
+
export AGENT_FLEET_PROFILE_ID="dev"
|
|
70
|
+
export AGENT_FLEET_MONITOR_RUNTIME_DIR="$monitor_runtime"
|
|
71
|
+
|
|
72
|
+
just fleet team default
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
If either monitor variable is missing or invalid, or if the hub lacks stable Herdr identity, the
|
|
76
|
+
monitor stays disabled while normal agent-hub orchestration continues. The profile ID must start
|
|
77
|
+
with an alphanumeric character and may contain only alphanumerics, `.`, `_`, or `-`; `..` is
|
|
78
|
+
rejected.
|
|
79
|
+
|
|
80
|
+
### Discover the local endpoint
|
|
81
|
+
|
|
82
|
+
The hub creates mode `0700` namespaces under the runtime root. Each active registration contains
|
|
83
|
+
one mode `0600` discovery file and token file, plus a mode `0600` socket:
|
|
84
|
+
|
|
85
|
+
```text
|
|
86
|
+
<runtime>/<profile-sha256>/<hub-sha256>/discovery-<owner-id>.json
|
|
87
|
+
<runtime>/<profile-sha256>/<hub-sha256>/token-<owner-id>
|
|
88
|
+
<runtime>/s/<registration-sha256>/s
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
You can list discovery paths without reading or printing their tokens:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
find "$AGENT_FLEET_MONITOR_RUNTIME_DIR" -type f -name 'discovery-*.json' -print
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
A discovery record has this shape:
|
|
98
|
+
|
|
99
|
+
```json
|
|
100
|
+
{
|
|
101
|
+
"owner": "9db4478e-ef6e-4d5d-930b-6d637f5de4d1",
|
|
102
|
+
"socket": "@runtime/s/0123456789abcdef0123456789abcdef/s",
|
|
103
|
+
"token": "token-9db4478e-ef6e-4d5d-930b-6d637f5de4d1",
|
|
104
|
+
"lease": {
|
|
105
|
+
"hub": "<stable-hub-id>",
|
|
106
|
+
"pid": 12345,
|
|
107
|
+
"startedAt": "2026-07-21T09:00:00.000Z",
|
|
108
|
+
"expiresAt": "2026-07-21T09:00:30.000Z"
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
A consumer must reject expired or malformed discovery, paths outside the configured runtime root,
|
|
114
|
+
symlinks, unsafe modes, and socket/token names that do not match the discovery schema. It should
|
|
115
|
+
re-discover after reconnect instead of caching a token or absolute socket path. Never put the token
|
|
116
|
+
in a URL, log, Desktop storage, or command-line argument.
|
|
117
|
+
|
|
118
|
+
### Request snapshot, output, and cancellation
|
|
119
|
+
|
|
120
|
+
The UDS protocol is newline-delimited JSON with one request per connection. Read the token from the
|
|
121
|
+
discovery record's sibling token file, use it only in memory, and terminate every request with
|
|
122
|
+
`\n`.
|
|
123
|
+
|
|
124
|
+
```js
|
|
125
|
+
import net from "node:net";
|
|
126
|
+
|
|
127
|
+
export function monitorRequest(socketPath, request) {
|
|
128
|
+
return new Promise((resolve, reject) => {
|
|
129
|
+
const client = net.createConnection(socketPath);
|
|
130
|
+
let body = "";
|
|
131
|
+
client.setTimeout(1_000, () => client.destroy(new Error("monitor timeout")));
|
|
132
|
+
client.on("connect", () => client.end(`${JSON.stringify(request)}\n`));
|
|
133
|
+
client.on("data", chunk => { body += chunk; });
|
|
134
|
+
client.on("error", reject);
|
|
135
|
+
client.on("close", () => resolve(body ? JSON.parse(body) : null));
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
// `token` and `socketPath` were resolved and validated from live discovery.
|
|
140
|
+
const current = await monitorRequest(socketPath, { type: "snapshot", token });
|
|
141
|
+
const delta = await monitorRequest(socketPath, {
|
|
142
|
+
type: "output",
|
|
143
|
+
token,
|
|
144
|
+
taskId: "builder:1",
|
|
145
|
+
generation: 1,
|
|
146
|
+
afterSequence: 0
|
|
147
|
+
});
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Example snapshot response:
|
|
151
|
+
|
|
152
|
+
```json
|
|
153
|
+
{
|
|
154
|
+
"ok": true,
|
|
155
|
+
"snapshot": {
|
|
156
|
+
"tasks": [
|
|
157
|
+
{
|
|
158
|
+
"id": "builder:1",
|
|
159
|
+
"generation": 1,
|
|
160
|
+
"kind": "child",
|
|
161
|
+
"state": "running",
|
|
162
|
+
"outputLatestSequence": 4
|
|
163
|
+
}
|
|
164
|
+
]
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
Continue incremental output from the returned sequence to avoid duplicates:
|
|
170
|
+
|
|
171
|
+
```js
|
|
172
|
+
const next = await monitorRequest(socketPath, {
|
|
173
|
+
type: "output",
|
|
174
|
+
token,
|
|
175
|
+
taskId: "builder:1",
|
|
176
|
+
generation: 1,
|
|
177
|
+
afterSequence: delta.output.sequence
|
|
178
|
+
});
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Cancellation is an explicit operator action and must use the exact displayed task ID and
|
|
182
|
+
generation:
|
|
183
|
+
|
|
184
|
+
```js
|
|
185
|
+
const cancelled = await monitorRequest(socketPath, {
|
|
186
|
+
type: "cancel",
|
|
187
|
+
token,
|
|
188
|
+
taskId: "builder:1",
|
|
189
|
+
generation: 1
|
|
190
|
+
});
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
A native specialist cancellation targets only the hub-owned process generation and validates its
|
|
194
|
+
process identity before signalling it. Cancelling a coms-backed run abandons the hub's local wait;
|
|
195
|
+
the remote peer may continue. Neither operation creates, focuses, closes, or otherwise controls a
|
|
196
|
+
Herdr pane or workspace.
|
|
197
|
+
|
|
198
|
+
### Failure and reconnect behavior
|
|
199
|
+
|
|
200
|
+
- `{"ok":false,"error":"unauthorized"}` means the token does not match current ownership.
|
|
201
|
+
- `monitor_unavailable` means the hub-side snapshot/output/cancel handler failed closed.
|
|
202
|
+
- `response_too_large` means the consumer must fall back to a fresh bounded snapshot or cursor.
|
|
203
|
+
- An empty response indicates malformed or out-of-contract input; do not retry it unchanged.
|
|
204
|
+
- When the lease expires, the socket closes, or ownership changes, discard the token and repeat
|
|
205
|
+
discovery. Never fall back to public TCP, a gateway endpoint, or Herdr pane control.
|
|
206
|
+
|
|
207
|
+
Stopping the hub removes its owned discovery, token, and socket. Historical monitor journals under
|
|
208
|
+
the configured runtime root are separate from this live registration and should be removed only by
|
|
209
|
+
an operator who has identified the exact profile/runtime scope.
|
|
210
|
+
|
|
211
|
+
## Usage notes
|
|
212
|
+
|
|
213
|
+
For `hub-liaison`, ensure the Telegram-capable profile has terminal/file-write tools enabled so it can create exactly `~/.pi/coms/hermes-bridge/questions/<qid>.answer.json` and nothing outside that questions directory.
|
|
214
|
+
|
|
215
|
+
For `hub-conductor`, either start the pi team/pool outside Hermes first, or use the repo recipe to create a visible conductor workspace:
|
|
216
|
+
|
|
217
|
+
```bash
|
|
218
|
+
just conductor docs # conductor pane (`hermes -p dev`) + docs team panes
|
|
219
|
+
just fleet conductor hermes docs --dry-run # preview, no Herdr calls
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Inside Hermes, discover and delegate only through coms:
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
node --experimental-strip-types /home/nchankov/repos/agent-fleet/scripts/coms-cli.ts list
|
|
226
|
+
node --experimental-strip-types /home/nchankov/repos/agent-fleet/scripts/coms-cli.ts send <peer> "<task>" --await --timeout 300000
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
Hermes must not drive herdr panes or workspaces; the `just conductor` recipe creates the pane before Hermes starts. The no-herdr boundary is documented in `docs/coms-hermes-bridge.md` and governed by `.pi/damage-control-rules.yaml`.
|
|
230
|
+
|
|
231
|
+
Hermes/Telegram remains the inbound `ask_user` path beside the experimental Codex remote-control conductor. Codex is outbound-initiated, approval-gated, and serialized through the validated wrapper; both Hermes and Codex contracts remain advisory outside Pi damage-control, and neither external process has an OS command allowlist. See the [Codex operator runbook](../docs/codex-remote-conductor.md).
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import React, { useEffect, useState } from 'react';
|
|
2
|
+
// Self-contained dashboard bundle: Hermes loads this file without relative-module resolution.
|
|
3
|
+
const present=value=>{if(value?.error)return{kind:'error',message:value.error};if(value?.loading)return{kind:'loading'};return value?.tasks?.length?{kind:'tasks',tasks:value.tasks}:{kind:'empty'};};
|
|
4
|
+
|
|
5
|
+
const bounded=(text='')=>String(text).slice(-8192);
|
|
6
|
+
function hierarchy(tasks){const roots=[], parents=new Map();for(const task of tasks){if(task.kind==='parent'){const row={...task,children:[]};parents.set(`${task.hubInstanceId}:${task.id}:${task.generation}`,row);roots.push(row)}}for(const task of tasks.filter(t=>t.kind!=='parent')){const parent=parents.get(`${task.hubInstanceId}:${task.parentId}:${task.parentGeneration}`);if(parent)parent.children.push(task);else roots.push({...task,children:[]})}return roots}
|
|
7
|
+
function Pane({ctx}) {
|
|
8
|
+
const [value,setValue]=useState({loading:true});
|
|
9
|
+
useEffect(()=>{const documentRef=globalThis.document;let live=true, visible=!!documentRef&&documentRef.visibilityState!=='hidden', timer=null, inFlight=false, epoch=0;const cursors=new Map();
|
|
10
|
+
const output=async(row,cursor,pollEpoch)=>{const result=await ctx.rest(`/output?task_id=${encodeURIComponent(row.id)}&generation=${encodeURIComponent(row.generation)}&after_sequence=${encodeURIComponent(cursor)}${row.hubInstanceId?`&hub_instance_id=${encodeURIComponent(row.hubInstanceId)}`:''}`);if(!live||!visible||pollEpoch!==epoch)return; cursors.set(`${row.hubInstanceId}:${row.id}:${row.generation}`,result.sequence??cursor);setValue(old=>({tasks:(old.tasks??[]).map(t=>t.hubInstanceId===row.hubInstanceId&&t.id===row.id&&t.generation===row.generation?{...t,output:bounded(`${t.output??''}${result.text??''}`),outputSequence:result.sequence??t.outputSequence,outputFirstSequence:result.firstSequence,truncated:!!result.truncated}:t)}));};
|
|
11
|
+
const poll=async()=>{if(!visible||inFlight)return;inFlight=true;const pollEpoch=++epoch;try{const snapshot=await ctx.rest('/snapshot');if(!live||!visible||pollEpoch!==epoch)return;const tasks=snapshot.tasks??[];setValue(old=>{const cached=new Map((old.tasks??[]).map(t=>[`${t.hubInstanceId}:${t.id}:${t.generation}`,t]));return{tasks:tasks.map(t=>{const prior=cached.get(`${t.hubInstanceId}:${t.id}:${t.generation}`);return prior&&prior.outputSequence===t.outputSequence?{...t,output:prior.output,outputFirstSequence:prior.outputFirstSequence}:t;})}});for(const row of tasks){const key=`${row.id}:${row.generation}`,cursor=cursors.get(`${row.hubInstanceId}:${key}`)??0;if((row.outputSequence??0)>cursor)await output(row,cursor,pollEpoch)}}catch(error){live&&visible&&setValue({error:String(error)})}finally{inFlight=false}};
|
|
12
|
+
const start=()=>{if(!timer)timer=setInterval(()=>void poll(),1000)}; const change=()=>{visible=documentRef?.visibilityState==='visible';epoch++;if(visible)start();else if(timer){clearInterval(timer);timer=null}};if(visible)start();void poll();documentRef?.addEventListener('visibilitychange',change);return()=>{live=false;if(timer)clearInterval(timer);documentRef?.removeEventListener('visibilitychange',change)};
|
|
13
|
+
},[ctx]);
|
|
14
|
+
const view=present(value);if(view.kind!=='tasks')return React.createElement('div',{role:view.kind==='error'?'alert':'status'},view.message??view.kind);
|
|
15
|
+
const cancel=(task)=>ctx.rest(`/cancel?task_id=${encodeURIComponent(task.id)}&generation=${encodeURIComponent(task.generation)}${task.hubInstanceId?`&hub_instance_id=${encodeURIComponent(task.hubInstanceId)}`:''}`,{method:'POST'});
|
|
16
|
+
const row=(task)=>React.createElement('li',{role:'treeitem',key:`${task.hubInstanceId}:${task.id}:${task.generation}`},`${task.id} · ${task.generation??''} · ${task.state}${task.state==='recovering'?' · Recovering connection':task.state==='orphaned'?' · Task orphaned':''} ${task.output??''}${task.truncated?' [output truncated]':''}`,task.canCancel&&task.state!=='orphaned'?React.createElement('button',{'aria-label':`Cancel ${task.id} generation ${task.generation}`,onClick:()=>cancel(task),onKeyDown:e=>{if(e.key==='Enter'||e.key===' '){e.preventDefault();cancel(task)}}},'Cancel'):null,task.children?.length?React.createElement('ul',{role:'group'},...task.children.map(row)):null);
|
|
17
|
+
return React.createElement('ul',{role:'tree','aria-label':'Agent Fleet tasks'},...hierarchy(view.tasks).map(row));
|
|
18
|
+
}
|
|
19
|
+
export default {id:'agent-fleet-monitor',register(ctx){ctx.register({id:'pane',area:'panes',title:'Agent Fleet Monitor',render:()=>React.createElement(Pane,{ctx})})}};
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export function present(value) { if (value.error) return { kind: 'error', message: value.error }; if (value.loading) return { kind: 'loading' }; if (!value.tasks?.length) return { kind: 'empty' }; return { kind: 'tasks', tasks: value.tasks }; }
|
|
2
|
+
|
|
3
|
+
// The controller owns the cursor map: output is requested only for bytes newer
|
|
4
|
+
// than the cursor advertised by the same snapshot task generation.
|
|
5
|
+
export function createActiveViewController({ pollMetadata, fetchOutput, onOutput = () => {} }) {
|
|
6
|
+
const cursors=new Map(); let timer=null, visible=false, inFlight=null, epoch=0;
|
|
7
|
+
const poll=()=>{if(!visible||inFlight)return inFlight;const requestEpoch=epoch;const request=(async()=>{const result=await pollMetadata();if(!visible||requestEpoch!==epoch)return;const rows=Array.isArray(result)?result:(result.tasks??[]);for(const row of rows){const key=`${row.hubInstanceId}:${row.id}:${row.generation}`,cursor=cursors.get(key)??0;if((row.outputSequence??0)>cursor){const output=await fetchOutput(row.hubInstanceId,row.id,row.generation,cursor);if(!visible||requestEpoch!==epoch)return;cursors.set(key,output.sequence??cursor);onOutput(row,output);}}})().finally(()=>{if(inFlight===request)inFlight=null;});inFlight=request;return request;};
|
|
8
|
+
return { poll, setVisible(next){if(!next){visible=false;epoch++;if(timer){clearInterval(timer);timer=null}return;}visible=true;if(!timer)timer=setInterval(()=>void poll(),1000);}, dispose(){visible=false;epoch++;if(timer)clearInterval(timer);timer=null} };
|
|
9
|
+
}
|
|
10
|
+
export function aggregateTaskHierarchy(tasks){const parents=tasks.filter(t=>t.kind==='parent').map(parent=>({id:parent.id,state:parent.state,children:[]}));const byId=new Map(tasks.filter(t=>t.kind==='parent').map((parent,i)=>[`${parent.hubInstanceId}:${parent.id}:${parent.generation}`,parents[i]]));for(const child of tasks.filter(t=>t.kind!=='parent')){const item={id:child.id,generation:child.generation,state:child.state};const parent=byId.get(`${child.hubInstanceId}:${child.parentId}:${child.parentGeneration}`);if(parent)parent.children.push(item);else parents.push({...item,children:[]});}return parents;}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import json,socket,tempfile,threading,unittest
|
|
2
|
+
from pathlib import Path
|
|
3
|
+
from adapter import MonitorAdapter,MonitorUnavailable,MAX_SNAPSHOT_RESPONSE_BYTES
|
|
4
|
+
class CapTest(unittest.TestCase):
|
|
5
|
+
def request(self, frame):
|
|
6
|
+
with tempfile.TemporaryDirectory() as d:
|
|
7
|
+
p=str(Path(d)/'s');s=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);s.bind(p);s.listen(1)
|
|
8
|
+
def serve(): c,_=s.accept();c.recv(4096);c.sendall(frame);c.close();s.close()
|
|
9
|
+
t=threading.Thread(target=serve);t.start()
|
|
10
|
+
try:return MonitorAdapter(p,'t')._request({'type':'snapshot'})
|
|
11
|
+
finally:t.join()
|
|
12
|
+
def test_cap_excludes_one_ndjson_delimiter(self):
|
|
13
|
+
base=json.dumps({'x':''},separators=(',',':')).encode();frame=json.dumps({'x':'a'*(MAX_SNAPSHOT_RESPONSE_BYTES-len(base))},separators=(',',':')).encode();self.assertEqual(len(frame),MAX_SNAPSHOT_RESPONSE_BYTES);self.assertIsInstance(self.request(frame+b'\n'),dict)
|
|
14
|
+
with self.assertRaises(MonitorUnavailable):self.request(frame+b'a\n')
|
|
15
|
+
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import json
|
|
2
|
+
import os
|
|
3
|
+
import tempfile
|
|
4
|
+
import unittest
|
|
5
|
+
from datetime import datetime, timedelta, timezone
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
from adapter import MonitorAdapter
|
|
8
|
+
|
|
9
|
+
class AdapterDiscoveryTest(unittest.TestCase):
|
|
10
|
+
def test_discovers_local_socket_and_token_from_explicit_profile_runtime_environment(self):
|
|
11
|
+
with tempfile.TemporaryDirectory() as directory:
|
|
12
|
+
root=Path(directory)/"runtime"; root.mkdir(mode=0o700)
|
|
13
|
+
profile="a"*64; namespace=root/MonitorAdapter.canonical_profile_id(profile)/("b"*64); namespace.mkdir(parents=True, mode=0o700)
|
|
14
|
+
owner="00000000-0000-0000-0000-000000000000"; socket_id=__import__('hashlib').sha256(f"{MonitorAdapter.canonical_profile_id(profile)}:{__import__('hashlib').sha256(b'hub').hexdigest()}:{owner}".encode()).hexdigest()[:32]; token=namespace/f"token-{owner}"; token.write_text("secret"); os.chmod(token,0o600)
|
|
15
|
+
discovery=namespace/f"discovery-{owner}.json"; discovery.write_text(json.dumps({"owner":owner,"socket":f"@runtime/s/{socket_id}/s","token":f"token-{owner}","lease":{"hub":"hub","pid":1,"startedAt":"2020-01-01T00:00:00Z","expiresAt":(datetime.now(timezone.utc)+timedelta(minutes=1)).isoformat()}})); os.chmod(discovery,0o600)
|
|
16
|
+
adapter=MonitorAdapter.from_profile_environment({"AGENT_FLEET_PROFILE_ID":profile,"AGENT_FLEET_MONITOR_RUNTIME_DIR":str(root)})
|
|
17
|
+
self.assertEqual(adapter._socket_path,str(root/f"s/{socket_id}/s")); self.assertEqual(adapter._token,"secret")
|
|
18
|
+
|
|
19
|
+
if __name__ == "__main__": unittest.main()
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import socket,tempfile,threading,unittest
|
|
2
|
+
from pathlib import Path
|
|
3
|
+
from adapter import MonitorAdapter,MonitorUnavailable
|
|
4
|
+
class EnvelopeTest(unittest.TestCase):
|
|
5
|
+
def test_rejects_non_object_json_envelope(self):
|
|
6
|
+
with tempfile.TemporaryDirectory() as d:
|
|
7
|
+
p=str(Path(d)/'s'); server=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);server.bind(p);server.listen(1)
|
|
8
|
+
def serve():
|
|
9
|
+
c,_=server.accept();c.recv(4096);c.sendall(b'[]\n');c.close();server.close()
|
|
10
|
+
t=threading.Thread(target=serve);t.start()
|
|
11
|
+
with self.assertRaises(MonitorUnavailable): MonitorAdapter(p,'secret').snapshot()
|
|
12
|
+
t.join()
|
|
13
|
+
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import json,os,tempfile,unittest
|
|
2
|
+
from datetime import datetime,timedelta,timezone
|
|
3
|
+
from pathlib import Path
|
|
4
|
+
from adapter import MonitorAdapter,MonitorUnavailable
|
|
5
|
+
class ForgedOwnerTest(unittest.TestCase):
|
|
6
|
+
def test_forged_cross_owner_expired_record_is_not_cleaned(self):
|
|
7
|
+
with tempfile.TemporaryDirectory() as d:
|
|
8
|
+
root=Path(d)/'r';root.mkdir(mode=0o700);p='p';ns=root/MonitorAdapter.canonical_profile_id(p)/('a'*64);ns.mkdir(parents=True,mode=0o700);owner='00000000-0000-0000-0000-000000000000';f=ns/f'discovery-{owner}.json';f.write_text(json.dumps({'owner':owner,'token':'token-11111111-1111-1111-1111-111111111111','socket':'@runtime/s/'+'a'*32+'/s','lease':{'hub':'hub','pid':1,'startedAt':'2020-01-01T00:00:00Z','expiresAt':'2020-01-01T00:00:01Z'}}));os.chmod(f,0o600)
|
|
9
|
+
with self.assertRaises(MonitorUnavailable):MonitorAdapter.from_profile_environment({'AGENT_FLEET_PROFILE_ID':p,'AGENT_FLEET_MONITOR_RUNTIME_DIR':str(root)})
|
|
10
|
+
self.assertTrue(f.exists())
|
|
11
|
+
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import json,os,tempfile,unittest
|
|
2
|
+
from pathlib import Path
|
|
3
|
+
from adapter import MonitorAdapter,MonitorUnavailable
|
|
4
|
+
class LeaseListTest(unittest.TestCase):
|
|
5
|
+
def test_lease_list_is_unavailable(self):
|
|
6
|
+
with tempfile.TemporaryDirectory() as d:
|
|
7
|
+
root=Path(d)/'r';root.mkdir(mode=0o700); profile='p';ns=root/MonitorAdapter.canonical_profile_id(profile)/('a'*64);ns.mkdir(parents=True,mode=0o700);p=ns/'discovery-00000000-0000-0000-0000-000000000000.json';p.write_text(json.dumps({'lease':[]}));os.chmod(p,0o600)
|
|
8
|
+
with self.assertRaises(MonitorUnavailable):MonitorAdapter.from_profile_environment({'AGENT_FLEET_PROFILE_ID':profile,'AGENT_FLEET_MONITOR_RUNTIME_DIR':str(root)})
|
|
9
|
+
if __name__=='__main__':unittest.main()
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import unittest
|
|
2
|
+
from adapter import FleetMonitorAdapter, MonitorUnavailable
|
|
3
|
+
class Hub:
|
|
4
|
+
def __init__(self,name,fail=False): self.name=name;self.fail=fail;self.calls=[]
|
|
5
|
+
def snapshot(self):
|
|
6
|
+
if self.fail: raise MonitorUnavailable('down')
|
|
7
|
+
return {'tasks':[{'id':'same','generation':1}]}
|
|
8
|
+
def output(self,*v): self.calls.append(('output',v));return {'text':self.name}
|
|
9
|
+
def cancel(self,*v): self.calls.append(('cancel',v));return {'cancelled':True}
|
|
10
|
+
class MultiHubTest(unittest.TestCase):
|
|
11
|
+
def test_colliding_ids_are_annotated_and_route_to_owner(self):
|
|
12
|
+
a,b=Hub('a'),Hub('b'); f=FleetMonitorAdapter([('a',a),('b',b)])
|
|
13
|
+
self.assertEqual({x['hubInstanceId'] for x in f.snapshot()['tasks']},{'a','b'})
|
|
14
|
+
self.assertEqual(f.output('same',1,0,'b'),{'text':'b'}); self.assertEqual(b.calls,[('output',('same',1,0))]);self.assertEqual(a.calls,[])
|
|
15
|
+
def test_failed_hub_does_not_drop_healthy_tasks(self):
|
|
16
|
+
result=FleetMonitorAdapter([('a',Hub('a')),('b',Hub('b',True))]).snapshot();self.assertEqual(len(result['tasks']),1);self.assertEqual(result['hubs'][0]['hubInstanceId'],'b')
|
|
17
|
+
if __name__=='__main__': unittest.main()
|
|
@@ -0,0 +1,34 @@
|
|
|
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
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
class AdapterOutputTest(unittest.TestCase):
|
|
12
|
+
def test_maps_typed_output_route_to_authenticated_uds_cursor_request(self):
|
|
13
|
+
with tempfile.TemporaryDirectory() as directory:
|
|
14
|
+
socket_path = str(Path(directory) / "monitor.sock")
|
|
15
|
+
server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
|
|
16
|
+
server.bind(socket_path)
|
|
17
|
+
server.listen(1)
|
|
18
|
+
|
|
19
|
+
def serve():
|
|
20
|
+
client, _ = server.accept()
|
|
21
|
+
request = json.loads(client.recv(4096).decode())
|
|
22
|
+
self.assertEqual(request, {"type": "output", "token": "secret", "taskId": "task", "generation": 2, "afterSequence": 7})
|
|
23
|
+
client.sendall(b'{"ok":true,"output":{"text":"new","sequence":8,"firstSequence":8,"truncated":false}}\n')
|
|
24
|
+
client.close()
|
|
25
|
+
server.close()
|
|
26
|
+
|
|
27
|
+
thread = threading.Thread(target=serve)
|
|
28
|
+
thread.start()
|
|
29
|
+
self.assertEqual(MonitorAdapter(socket_path, "secret").output("task", 2, 7), {"text": "new", "sequence": 8, "firstSequence": 8, "truncated": False})
|
|
30
|
+
thread.join()
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
if __name__ == "__main__":
|
|
34
|
+
unittest.main()
|
|
@@ -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()
|
package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py
ADDED
|
@@ -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()
|