@chankov/agent-fleet 0.0.6 → 0.0.8
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-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/harnesses/agent-hub/README.md +75 -16
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +58 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +723 -159
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +29 -3
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +4 -3
- package/.pi/harnesses/coms/index.ts +80 -58
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.8/.claude/commands/build.md +44 -0
- package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.8/.claude/commands/plan.md +16 -0
- package/.versions/0.0.8/.claude/commands/prime.md +22 -0
- package/.versions/0.0.8/.claude/commands/review.md +16 -0
- package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.8/.claude/commands/ship.md +72 -0
- package/.versions/0.0.8/.claude/commands/spec.md +15 -0
- package/.versions/0.0.8/.claude/commands/test.md +19 -0
- package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.8/.pi/extensions/package.json +9 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.8/.version +1 -0
- package/.versions/0.0.8/agents/architect.md +23 -0
- package/.versions/0.0.8/agents/bowser.md +26 -0
- package/.versions/0.0.8/agents/builder.md +53 -0
- package/.versions/0.0.8/agents/code-reviewer.md +205 -0
- package/.versions/0.0.8/agents/deep-researcher.md +31 -0
- package/.versions/0.0.8/agents/documenter.md +18 -0
- package/.versions/0.0.8/agents/orchestrator.md +65 -0
- package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.8/agents/planner.md +69 -0
- package/.versions/0.0.8/agents/releaser.md +24 -0
- package/.versions/0.0.8/agents/researcher.md +28 -0
- package/.versions/0.0.8/agents/security-auditor.md +166 -0
- package/.versions/0.0.8/agents/test-engineer.md +151 -0
- package/.versions/0.0.8/agents/web-debugger.md +42 -0
- package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.8/docs/getting-started.md +231 -0
- package/.versions/0.0.8/docs/npm-install.md +337 -0
- package/.versions/0.0.8/docs/opencode-setup.md +249 -0
- package/.versions/0.0.8/docs/pi-extensions.md +293 -0
- package/.versions/0.0.8/docs/pi-setup.md +476 -0
- package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.8/hermes/README.md +347 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.8/hooks/hooks.json +14 -0
- package/.versions/0.0.8/hooks/session-start.sh +74 -0
- package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.8/justfile +245 -0
- package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.8/references/definition-of-done.md +67 -0
- package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.8/references/observability-checklist.md +91 -0
- package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.8/references/performance-checklist.md +153 -0
- package/.versions/0.0.8/references/prompting-patterns.md +380 -0
- package/.versions/0.0.8/references/security-checklist.md +179 -0
- package/.versions/0.0.8/references/testing-patterns.md +236 -0
- package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.8/scripts/fleet.ts +149 -0
- package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.8/scripts/team-up.ts +360 -0
- package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
- package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +175 -18
- package/agents/code-reviewer.md +2 -2
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +40 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +64 -12
- package/docs/agent-fleet-setup.md +2 -2
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +10 -0
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -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-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -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.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/guided-workspace-setup/companion-manifest.json +1 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Manifest-only plugin: it ships no agent tools and no hooks, and exists so
|
|
2
|
+
# `hermes plugins enable agent-fleet-herdr` has a name to accept. That enable
|
|
3
|
+
# record in config.yaml is what opens the `/api/plugins/agent-fleet-herdr/*`
|
|
4
|
+
# gate in hermes_cli/web_server.py:576 — without it every request 404s with
|
|
5
|
+
# {"detail": "Plugin not found"} before routing is even reached.
|
|
6
|
+
name: agent-fleet-herdr
|
|
7
|
+
version: "0.1.0"
|
|
8
|
+
description: Read-only view of live Agent Fleet sessions in Hermes Desktop
|
|
@@ -0,0 +1,139 @@
|
|
|
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
|
+
except (OSError, ValueError, KeyError, TypeError, json.JSONDecodeError) as error:
|
|
82
|
+
raise MonitorUnavailable("monitor profile discovery is unavailable") from error
|
|
83
|
+
|
|
84
|
+
def _request(self, request: dict, max_response_bytes: int = MAX_SNAPSHOT_RESPONSE_BYTES) -> dict:
|
|
85
|
+
try:
|
|
86
|
+
with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as client:
|
|
87
|
+
client.settimeout(2); client.connect(self._socket_path)
|
|
88
|
+
client.sendall((json.dumps({**request, "token": self._token})+"\n").encode())
|
|
89
|
+
data = b""
|
|
90
|
+
while b"\n" not in data:
|
|
91
|
+
chunk = client.recv(min(8192, max_response_bytes + 1 - len(data)))
|
|
92
|
+
if not chunk: raise MonitorUnavailable("local monitor closed the response")
|
|
93
|
+
data += chunk
|
|
94
|
+
if len(data) > max_response_bytes + 1: raise MonitorUnavailable("local monitor response is too large")
|
|
95
|
+
frame = data.split(b"\n", 1)[0]
|
|
96
|
+
if len(frame) > max_response_bytes: raise MonitorUnavailable("local monitor response is too large")
|
|
97
|
+
response = json.loads(frame)
|
|
98
|
+
if not isinstance(response, dict): raise MonitorUnavailable("local monitor response is invalid")
|
|
99
|
+
return response
|
|
100
|
+
except (OSError, ValueError) as error:
|
|
101
|
+
raise MonitorUnavailable("local monitor is unavailable") from error
|
|
102
|
+
|
|
103
|
+
def snapshot(self) -> dict:
|
|
104
|
+
response = self._request({"type": "snapshot"})
|
|
105
|
+
if response.get("ok") is not True or not isinstance(response.get("snapshot"), dict):
|
|
106
|
+
raise MonitorUnavailable("local monitor rejected the snapshot request")
|
|
107
|
+
return response["snapshot"]
|
|
108
|
+
|
|
109
|
+
def output(self, task_id: str, generation: int, after_sequence: int) -> dict:
|
|
110
|
+
response = self._request({"type": "output", "taskId": task_id, "generation": generation, "afterSequence": after_sequence}, MAX_OUTPUT_RESPONSE_BYTES)
|
|
111
|
+
if response.get("ok") is not True or not isinstance(response.get("output"), dict): raise MonitorUnavailable("local monitor rejected output")
|
|
112
|
+
return response["output"]
|
|
113
|
+
|
|
114
|
+
def cancel(self, task_id: str, generation: int) -> dict:
|
|
115
|
+
if not task_id or not isinstance(generation, int):
|
|
116
|
+
raise MonitorUnavailable("local monitor cancellation is invalid")
|
|
117
|
+
response = self._request({"type": "cancel", "taskId": task_id, "generation": generation}, MAX_CANCEL_RESPONSE_BYTES)
|
|
118
|
+
if response.get("ok") is not True or not isinstance(response.get("result"), dict):
|
|
119
|
+
raise MonitorUnavailable("local monitor rejected cancellation")
|
|
120
|
+
return response["result"]
|
|
121
|
+
|
|
122
|
+
class FleetMonitorAdapter:
|
|
123
|
+
def __init__(self, hubs):
|
|
124
|
+
self._hubs = dict(hubs)
|
|
125
|
+
if len(self._hubs) == 1:
|
|
126
|
+
only = next(iter(self._hubs.values()))
|
|
127
|
+
self._socket_path, self._token = only._socket_path, only._token
|
|
128
|
+
def snapshot(self):
|
|
129
|
+
tasks, errors = [], []
|
|
130
|
+
for hub_id, adapter in self._hubs.items():
|
|
131
|
+
try:
|
|
132
|
+
for task in adapter.snapshot().get("tasks", []): tasks.append({**task, "hubInstanceId": hub_id})
|
|
133
|
+
except MonitorUnavailable: errors.append({"hubInstanceId": hub_id, "state": "orphaned", "error": "unavailable"})
|
|
134
|
+
return {"tasks": tasks, "hubs": errors}
|
|
135
|
+
def _hub(self, hub_instance_id):
|
|
136
|
+
if not isinstance(hub_instance_id, str) or hub_instance_id not in self._hubs: raise MonitorUnavailable("local monitor hub is unavailable")
|
|
137
|
+
return self._hubs[hub_instance_id]
|
|
138
|
+
def output(self, task_id, generation, after_sequence, hub_instance_id): return self._hub(hub_instance_id).output(task_id, generation, after_sequence)
|
|
139
|
+
def cancel(self, task_id, generation, hub_instance_id): return self._hub(hub_instance_id).cancel(task_id, generation)
|
|
@@ -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,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,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hub-watchdog
|
|
3
|
+
description: Foreground, fail-closed local Agent Hub watchdog. Use only for explicit operator observation of a profile-scoped Hub through its authenticated monitor socket.
|
|
4
|
+
---
|
|
5
|
+
# Hub Watchdog
|
|
6
|
+
|
|
7
|
+
`hub-watchdog` is a packaged source skill, not a service or an enabled Hermes integration. Run it only as an explicit foreground operator action:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
python3 scripts/watchdog.py status --invocation-json '<json>'
|
|
11
|
+
python3 scripts/watchdog.py validate-config --invocation-json '<json>'
|
|
12
|
+
python3 scripts/watchdog.py watch --invocation-json '<json>'
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
`status` and `validate-config` report the resolved autonomy tier and delivery disposition without connecting to anything. Run them before `watch` and stop if either reports something you did not intend.
|
|
16
|
+
|
|
17
|
+
Default and maximum autonomy are `observe`. Send `SIGINT` to stop the foreground process; it releases its per-profile `watch.lock`, closes its socket clients and any long-poll waiter, and leaves the local journal in place. Do not create a daemon, schedule it, wake/reopen a Hermes session, or use a last-chat/default-route fallback. A second watcher for the same profile fails closed with `watcher_locked` rather than sharing state.
|
|
18
|
+
|
|
19
|
+
## Discovery is profile-scoped
|
|
20
|
+
|
|
21
|
+
Read exactly one discovery record from the namespace the invocation names — the validated profile key and hub key under the configured runtime directory. Never scan a runtime root, walk sibling profiles, or fall back to another namespace when a lease is expired, a token is missing, or a socket is gone. An unsafe runtime mode, a symlink, a world-readable token, an expired lease, or more than one discovery entry is a refusal.
|
|
22
|
+
|
|
23
|
+
Identity is bound on every request: the configured profile key, hub instance, and owner must all equal what live discovery reports. A mismatch is a refusal, not a fallback. After an owner rollover, rediscover from scratch; never reuse the previous owner's token or socket, and never re-drive a request that was already accepted.
|
|
24
|
+
|
|
25
|
+
## Gate O: currently closed
|
|
26
|
+
|
|
27
|
+
There is no checked-in genuine live proof of a Hermes originating-chat identity, incremental-update, wake/reconnect, or session API. `hermes send --to` is an explicit destination only; it is not origin evidence. A validator, fixture, fake adapter, or local UDS test cannot close Gate O.
|
|
28
|
+
|
|
29
|
+
Until a sanitized, human-reviewed disposable live artifact names the real API and proves the required behavior, operate journal-only:
|
|
30
|
+
|
|
31
|
+
- do not send chat updates, including out-of-turn status messages;
|
|
32
|
+
- do not steer, cancel, or recover work;
|
|
33
|
+
- do not claim live delivery, A6, or higher-tier autonomy; and
|
|
34
|
+
- do not redirect when a route is unavailable.
|
|
35
|
+
|
|
36
|
+
The entrypoint lowers requested `steer`/`surgical` autonomy to `observe` when Gate O is invalid. That safeguard does not authorize higher tiers when an artifact merely looks valid.
|
|
37
|
+
|
|
38
|
+
## Evidence and judgment stay bounded
|
|
39
|
+
|
|
40
|
+
Base every decision on the events the Hub actually returned. Cite them by event id, keep the cited set small, and record the deviation you believe they show. A judgment adapter is optional; when present it may only select one action from the closed set, and any malformed verdict resolves to `none`. Never infer a task's identity, completion, route, or delivery outcome beyond what the Hub explicitly returned, and never treat your own journal as Hub history.
|
|
41
|
+
|
|
42
|
+
If a cursor falls outside the retained window, reconcile from a fresh snapshot and resume — do not guess at the events you missed.
|
|
43
|
+
|
|
44
|
+
## Durability precedes transport
|
|
45
|
+
|
|
46
|
+
Before the first transport call for any action, persist the canonical request digest and the proposed decision. If that write fails, refuse — do not send. An ambiguous transport failure is never retried: one bounded attempt, then refuse and let an operator decide.
|
|
47
|
+
|
|
48
|
+
## Recovery is exact-generation only
|
|
49
|
+
|
|
50
|
+
Recovery is available only at `surgical` autonomy with Gate O open, only for an allow-listed native task, and only through the narrow monitor adapter. The sequence is fixed: persist the proposal, re-read a fresh snapshot, cancel exactly generation N, observe N reach a terminal state, re-read a fresh snapshot again, then enqueue at most one recovery request. A newer generation observed at any point freezes the transaction as `superseded`. A missing owner, profile, or hub identity is a refusal, not a wildcard. A completed step is never repeated after a restart, and a timeout, a refused cancel, a rejected enqueue, or an unobserved exit never retargets or retries.
|
|
51
|
+
|
|
52
|
+
Coms runs have no recovery path at all. Cancelling one abandons only the local wait; the remote peer may continue.
|
|
53
|
+
|
|
54
|
+
## Boundaries
|
|
55
|
+
|
|
56
|
+
The watcher reads owner-only monitor discovery and UDS responses, writes a local decision journal, and may render bounded local summaries. Hub state remains authoritative. A journal, event cursor, discovery field, or local test is not independent proof of task identity, ownership, route identity, completion, or delivery.
|
|
57
|
+
|
|
58
|
+
Never shell out, search PIDs, use `pkill`, control Herdr, manage a gateway/service, invoke Pi tools directly, or delegate through coms. Do not turn a coms wait cancellation into peer cancellation or automatic recovery. Keep tokens in memory only: never write one to a journal, log, argument, or summary.
|
|
59
|
+
|
|
60
|
+
On malformed or unavailable monitor data, ownership/profile uncertainty, reconciliation uncertainty, journal trouble, or Gate O failure, fail closed: keep or return to local journal-only operation and ask an operator to inspect the issue.
|
|
61
|
+
|
|
62
|
+
## Summaries for a human
|
|
63
|
+
|
|
64
|
+
A summary is for the operator reading it, so write it in their language — Bulgarian when that is what they use — and keep the identifiers untranslated: task ids, generations, event ids, and states stay verbatim so they can be matched against the Hub. Say what was observed and what was journaled. Never describe a queued request as work that ran, and never present local runtime evidence as proof of live delivery.
|
|
65
|
+
|
|
66
|
+
## Install lifecycle
|
|
67
|
+
|
|
68
|
+
Use `agent-fleet set-hermes-watchdog status|install|update|uninstall --profile <id> [--force] [--dry-run]` or the matching guided command. `status` is read-only. Install/update are profile-artifact operations; drift is refused unless an operator explicitly selects backed-up `--force`. An identical unmanaged tree is adopted by writing only a receipt, and only when a fresh symlink-free fingerprint exactly equals the packaged source. Uninstall preserves configuration and journals and reports, rather than kills, an active lock.
|
|
69
|
+
|
|
70
|
+
None of these lifecycle actions starts, stops, restarts, or kills Hermes or the watcher; changes Hermes tools/permissions; sends a test message; or manages Herdr. Packaging the skill does not install or enable it.
|
|
71
|
+
|
|
72
|
+
## Rollback
|
|
73
|
+
|
|
74
|
+
To stand down: set the profile configuration back to `observe` (or leave the default), `SIGINT` the foreground watcher, and confirm `watch.lock` is gone. That leaves the journal intact, cancels nothing, and withdraws no queued follow-up. Run `uninstall` only after reviewing its status and backup behavior. Never delete a journal, lock, runtime directory, or profile tree to force recovery — preserve suspect files for inspection.
|
|
75
|
+
|
|
76
|
+
See `docs/hermes-watchdog-supervisor.md` for the configuration example, the `events`/`invoke` responses, the migration path, and the evidence boundary.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"schemaVersion":1,"name":"hub-watchdog","defaultAutonomy":"observe","maximumAutonomy":"observe","originDelivery":"required","foregroundOnly":true}
|
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Foreground fail-closed watchdog entrypoint; no daemon/service lifecycle."""
|
|
3
|
+
import argparse
|
|
4
|
+
import hashlib
|
|
5
|
+
import json
|
|
6
|
+
import os
|
|
7
|
+
import selectors
|
|
8
|
+
import signal
|
|
9
|
+
import sys
|
|
10
|
+
import time
|
|
11
|
+
from pathlib import Path
|
|
12
|
+
|
|
13
|
+
from watchdog_actions import MAXIMUM_ACTION, admit
|
|
14
|
+
from watchdog_contract import gate_o_valid
|
|
15
|
+
from watchdog_delivery import deliver, delivery_state
|
|
16
|
+
from watchdog_engine import bulgarian_summary, due_deviations, reduce_event
|
|
17
|
+
from watchdog_judgment import request as judgment_request, response as judgment_response
|
|
18
|
+
from watchdog_recovery import recover
|
|
19
|
+
from watchdog_state import atomic_json, audit, load_json, profile_root
|
|
20
|
+
from watchdog_transport import MonitorTransport, TransportError, discover, reconcile
|
|
21
|
+
|
|
22
|
+
LEVELS = ('observe', 'shadow', 'steer', 'surgical')
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
def request_id(record, profile_key, owner_session_id, hub_instance_id):
|
|
26
|
+
"""Canonical owner/profile/generation identity for a single Hub invoke."""
|
|
27
|
+
ref = record['taskRef']
|
|
28
|
+
payload = json.dumps({'deviation': record.get('candidateDeviation'), 'taskId': ref['taskId'],
|
|
29
|
+
'generation': ref['generation'], 'profileKey': profile_key,
|
|
30
|
+
'ownerSessionId': owner_session_id, 'hubInstanceId': hub_instance_id},
|
|
31
|
+
sort_keys=True, separators=(',', ':')).encode()
|
|
32
|
+
return 'watchdog:' + hashlib.sha256(payload).hexdigest()
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def safe_invocation(raw):
|
|
36
|
+
try:
|
|
37
|
+
value = json.loads(raw or '{}')
|
|
38
|
+
except json.JSONDecodeError as error:
|
|
39
|
+
raise ValueError('invalid_invocation') from error
|
|
40
|
+
if not isinstance(value, dict):
|
|
41
|
+
raise ValueError('invalid_invocation')
|
|
42
|
+
requested = value.get('autonomy', 'observe')
|
|
43
|
+
maximum = value.get('maximumAutonomy', 'observe')
|
|
44
|
+
if requested not in LEVELS or maximum not in LEVELS:
|
|
45
|
+
raise ValueError('invalid_autonomy')
|
|
46
|
+
level = LEVELS[min(LEVELS.index(requested), LEVELS.index(maximum))]
|
|
47
|
+
if not delivery_state(value.get('gateO'))['originDelivery'] and level in ('steer', 'surgical'):
|
|
48
|
+
level = 'observe'
|
|
49
|
+
return value, level
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def _lock(invocation):
|
|
53
|
+
root = Path(invocation.get('lockDir') or os.environ.get('XDG_RUNTIME_DIR', '/tmp'))
|
|
54
|
+
# is_symlink() uses lstat: reject even a dangling link before any operation
|
|
55
|
+
# that could follow it (exists, mkdir, chmod, or stat).
|
|
56
|
+
if root.is_symlink():
|
|
57
|
+
raise ValueError('unsafe_lock')
|
|
58
|
+
root.mkdir(mode=0o700, parents=True, exist_ok=True)
|
|
59
|
+
if not root.is_dir() or root.stat().st_mode & 0o077:
|
|
60
|
+
raise ValueError('unsafe_lock')
|
|
61
|
+
root = root.resolve(strict=True)
|
|
62
|
+
path = root / 'agent-fleet-hermes-watchdog' / profile_root('', invocation.get('profileId', 'default')).name / 'watch.lock'
|
|
63
|
+
# Refuse a pre-existing symlink before mkdir/chmod can follow it.
|
|
64
|
+
for parent in (path.parent.parent, path.parent):
|
|
65
|
+
if parent.is_symlink() or (parent.exists() and (not parent.is_dir() or root not in (parent.resolve(), *parent.resolve().parents))):
|
|
66
|
+
raise ValueError('unsafe_lock')
|
|
67
|
+
parent.mkdir(mode=0o700, exist_ok=True)
|
|
68
|
+
if parent.is_symlink() or not parent.is_dir() or root not in (parent.resolve(), *parent.resolve().parents):
|
|
69
|
+
raise ValueError('unsafe_lock')
|
|
70
|
+
os.chmod(parent, 0o700)
|
|
71
|
+
if parent.stat().st_mode & 0o077:
|
|
72
|
+
raise ValueError('unsafe_lock')
|
|
73
|
+
try:
|
|
74
|
+
descriptor = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY | os.O_NOFOLLOW, 0o600)
|
|
75
|
+
except FileExistsError:
|
|
76
|
+
try:
|
|
77
|
+
contents = path.read_text(encoding='ascii').strip()
|
|
78
|
+
if path.is_symlink() or not contents.isdecimal() or int(contents) <= 0:
|
|
79
|
+
raise ValueError('unsafe_lock')
|
|
80
|
+
os.kill(int(contents), 0)
|
|
81
|
+
except ProcessLookupError:
|
|
82
|
+
path.unlink()
|
|
83
|
+
return _lock(invocation)
|
|
84
|
+
except (OSError, UnicodeError, ValueError) as error:
|
|
85
|
+
raise ValueError('watcher_locked') from error
|
|
86
|
+
raise ValueError('watcher_locked')
|
|
87
|
+
os.write(descriptor, str(os.getpid()).encode())
|
|
88
|
+
return path, descriptor
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
def _audit_path(invocation):
|
|
92
|
+
base = invocation.get('stateDir') or os.environ.get('XDG_STATE_HOME') or str(Path.home() / '.local/state')
|
|
93
|
+
return profile_root(Path(base) / 'agent-fleet/hermes-watchdog', invocation.get('profileId', 'default')) / 'audit.ndjson'
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def _recovery_path(invocation):
|
|
97
|
+
return _audit_path(invocation).with_name('recovery.json')
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def _recovery_key(task_ref):
|
|
101
|
+
return json.dumps([task_ref['taskId'], task_ref['generation']], separators=(',', ':'))
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
def _load_recovery(invocation):
|
|
105
|
+
path = _recovery_path(invocation)
|
|
106
|
+
try:
|
|
107
|
+
value = load_json(path) if path.exists() else {}
|
|
108
|
+
return value if isinstance(value, dict) and all(isinstance(tx, dict) for tx in value.values()) else {}
|
|
109
|
+
except (OSError, ValueError, json.JSONDecodeError):
|
|
110
|
+
return {}
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
def _save_recovery(invocation, transaction):
|
|
114
|
+
try:
|
|
115
|
+
atomic_json(_recovery_path(invocation), transaction)
|
|
116
|
+
return True
|
|
117
|
+
except (OSError, ValueError):
|
|
118
|
+
return False
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
def _safe_audit(path, record):
|
|
122
|
+
"""Offline/corrupt local audit is fail-closed but must not crash the watcher."""
|
|
123
|
+
try:
|
|
124
|
+
audit(path, record)
|
|
125
|
+
return True
|
|
126
|
+
except (OSError, ValueError):
|
|
127
|
+
return False
|
|
128
|
+
|
|
129
|
+
|
|
130
|
+
def _action_for(record, invocation):
|
|
131
|
+
"""Only a validated judgment may confirm an invoke; it can never escalate the table action."""
|
|
132
|
+
deviation = record.get('candidateDeviation')
|
|
133
|
+
maximum = MAXIMUM_ACTION.get(deviation, 'none')
|
|
134
|
+
adapter = invocation.get('judgmentAdapter')
|
|
135
|
+
if maximum == 'none' or not adapter:
|
|
136
|
+
return 'none', None
|
|
137
|
+
try:
|
|
138
|
+
verdict = judgment_response(adapter(judgment_request(
|
|
139
|
+
deviation, [record['eventId']], task_ref=record['taskRef'])), deviation, [record['eventId']])
|
|
140
|
+
recommended = verdict['recommendedAction']
|
|
141
|
+
return (recommended, verdict['verdict']) if recommended == maximum and verdict['verdict'] == 'confirmed' else ('none', None)
|
|
142
|
+
except (ValueError, TypeError, KeyError):
|
|
143
|
+
return 'none', None
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
def run_watch(invocation, level, *, once=False, transport_factory=None):
|
|
147
|
+
"""Run the foreground polling/event loop. Dependencies are injectable only for tests."""
|
|
148
|
+
lock_path, lock_fd = _lock(invocation)
|
|
149
|
+
state, cursor, stopped = {}, 0, False
|
|
150
|
+
recovery_transactions = _load_recovery(invocation)
|
|
151
|
+
selector = selectors.DefaultSelector()
|
|
152
|
+
read_fd, write_fd = os.pipe()
|
|
153
|
+
os.set_blocking(read_fd, False)
|
|
154
|
+
selector.register(read_fd, selectors.EVENT_READ)
|
|
155
|
+
old_handler = signal.getsignal(signal.SIGINT)
|
|
156
|
+
|
|
157
|
+
def stop(*_):
|
|
158
|
+
nonlocal stopped
|
|
159
|
+
stopped = True
|
|
160
|
+
try: os.write(write_fd, b'x')
|
|
161
|
+
except OSError: pass
|
|
162
|
+
|
|
163
|
+
audit_path = _audit_path(invocation)
|
|
164
|
+
try:
|
|
165
|
+
signal.signal(signal.SIGINT, stop)
|
|
166
|
+
while not stopped:
|
|
167
|
+
try:
|
|
168
|
+
factory = transport_factory or (lambda: MonitorTransport(discover(
|
|
169
|
+
invocation['runtimeDir'], invocation['profileKey'], invocation['hubKey'],
|
|
170
|
+
invocation.get('now') or time.strftime('%Y-%m-%dT%H:%M:%SZ', time.gmtime()))))
|
|
171
|
+
transport = factory()
|
|
172
|
+
batch = reconcile(transport, cursor)
|
|
173
|
+
if batch.get('snapshot'):
|
|
174
|
+
cursor = 0
|
|
175
|
+
_safe_audit(audit_path, {'decision': 'snapshot_reconciled', 'hubInstanceId': invocation.get('hubInstanceId')})
|
|
176
|
+
events = batch.get('items', batch.get('events', []))
|
|
177
|
+
for event in events:
|
|
178
|
+
state, records = reduce_event(state, event, time.monotonic(), online=True)
|
|
179
|
+
cursor = max(cursor, event.get('eventSequence', cursor))
|
|
180
|
+
for record in records:
|
|
181
|
+
_safe_audit(audit_path, {'decision': 'material_event', 'hubInstanceId': invocation.get('hubInstanceId'),
|
|
182
|
+
'taskRef': record['taskRef'], 'eventIds': [record['eventId']],
|
|
183
|
+
'deviation': record.get('candidateDeviation'), 'tier': level})
|
|
184
|
+
action, judgment = _action_for(record, invocation)
|
|
185
|
+
# Gate O is the hard boundary: otherwise journal-only and no invoke/cancel.
|
|
186
|
+
if level in ('steer', 'surgical') and action != 'none' and judgment == 'confirmed':
|
|
187
|
+
request = {'requestId': request_id(record, invocation.get('profileKey'), transport.owner, invocation.get('hubInstanceId')), 'action': action,
|
|
188
|
+
'taskId': record['taskRef']['taskId'], 'generation': record['taskRef']['generation'],
|
|
189
|
+
'profileKey': invocation.get('profileKey'), 'ownerSessionId': transport.owner,
|
|
190
|
+
'hubInstanceId': invocation.get('hubInstanceId'),
|
|
191
|
+
'parameters': {'assertionIds': [], 'evidenceEventIds': [record['eventId']],
|
|
192
|
+
'instruction': 'Изпълни ограничената проверка и докладвай доказателства.'},
|
|
193
|
+
'basis': {'deviation': record['candidateDeviation'], 'judgment': judgment}}
|
|
194
|
+
admit({**invocation, 'autonomy': level, 'ownerSessionId': transport.owner}, request, transport,
|
|
195
|
+
persist=lambda row: _safe_audit(audit_path, row))
|
|
196
|
+
if delivery_state(invocation.get('gateO'))['originDelivery'] and invocation.get('origin'):
|
|
197
|
+
try:
|
|
198
|
+
deliver(invocation['gateO'], invocation['origin'], bulgarian_summary(record), invocation.get('deliveryAdapter'))
|
|
199
|
+
except RuntimeError:
|
|
200
|
+
_safe_audit(audit_path, {'decision': 'delivery_refused', 'hubInstanceId': invocation.get('hubInstanceId'),
|
|
201
|
+
'taskRef': record['taskRef'], 'tier': level})
|
|
202
|
+
for record in due_deviations(state, time.monotonic()):
|
|
203
|
+
_safe_audit(audit_path, {'decision': 'due_deviation', 'hubInstanceId': invocation.get('hubInstanceId'),
|
|
204
|
+
'taskRef': record['taskRef'], 'deviation': record['candidateDeviation'], 'tier': level})
|
|
205
|
+
# Due deviations use the same exact table and recovery gate as event candidates.
|
|
206
|
+
if level == 'surgical' and gate_o_valid(invocation.get('gateO')) and record['candidateDeviation'] == 'stalled_progress':
|
|
207
|
+
key = _recovery_key(record['taskRef'])
|
|
208
|
+
transaction = recovery_transactions.get(key, {'taskId': record['taskRef']['taskId'], 'generation': record['taskRef']['generation'],
|
|
209
|
+
'kind': 'native', 'ownerSessionId': transport.owner, 'profileKey': invocation.get('profileKey'),
|
|
210
|
+
'hubInstanceId': invocation.get('hubInstanceId'), 'state': 'proposed'})
|
|
211
|
+
recovery = recover(transaction, transport, invocation.get('surgicalAllowlist', []), True,
|
|
212
|
+
persist=lambda row: _safe_audit(audit_path, row))
|
|
213
|
+
recovery_transactions[key] = recovery
|
|
214
|
+
_save_recovery(invocation, recovery_transactions)
|
|
215
|
+
_safe_audit(audit_path, {'decision': 'recovery_checked', 'hubInstanceId': invocation.get('hubInstanceId'),
|
|
216
|
+
'taskRef': {'taskId': recovery['taskId'], 'generation': recovery['generation']}, 'recoveryState': recovery['state'], 'tier': level})
|
|
217
|
+
except (KeyError, TransportError, ValueError, OSError) as error:
|
|
218
|
+
_safe_audit(audit_path, {'decision': 'offline', 'hubInstanceId': invocation.get('hubInstanceId'),
|
|
219
|
+
'deviation': 'route_unavailable'})
|
|
220
|
+
if once:
|
|
221
|
+
return {'foreground': True, 'offline': True, 'autonomy': level}
|
|
222
|
+
selector.select(timeout=.25)
|
|
223
|
+
if once:
|
|
224
|
+
return {'foreground': True, 'offline': False, 'autonomy': level, 'cursor': cursor}
|
|
225
|
+
return {'foreground': True, 'stopped': True, 'autonomy': level}
|
|
226
|
+
finally:
|
|
227
|
+
signal.signal(signal.SIGINT, old_handler)
|
|
228
|
+
selector.close(); os.close(read_fd); os.close(write_fd); os.close(lock_fd)
|
|
229
|
+
try: lock_path.unlink()
|
|
230
|
+
except FileNotFoundError: pass
|
|
231
|
+
|
|
232
|
+
|
|
233
|
+
def main(argv=None):
|
|
234
|
+
parser = argparse.ArgumentParser()
|
|
235
|
+
parser.add_argument('command', choices=['status', 'validate-config', 'watch'])
|
|
236
|
+
parser.add_argument('--invocation-json')
|
|
237
|
+
parser.add_argument('--once', action='store_true', help=argparse.SUPPRESS)
|
|
238
|
+
args = parser.parse_args(argv)
|
|
239
|
+
try:
|
|
240
|
+
invocation, level = safe_invocation(args.invocation_json)
|
|
241
|
+
result = {'ok': True, 'autonomy': level, **delivery_state(invocation.get('gateO'))}
|
|
242
|
+
if args.command == 'watch':
|
|
243
|
+
result.update(run_watch(invocation, level, once=args.once))
|
|
244
|
+
except ValueError as error:
|
|
245
|
+
print(json.dumps({'ok': False, 'error': str(error)}, sort_keys=True)); return 2
|
|
246
|
+
print(json.dumps(result, sort_keys=True)); return 0
|
|
247
|
+
|
|
248
|
+
if __name__ == '__main__':
|
|
249
|
+
raise SystemExit(main())
|