@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,9 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import { safeAgentKey } from "./helpers.ts";
|
|
3
|
+
|
|
4
|
+
export function monitorKeyForAgent(name:string,runCount:number){return`${safeAgentKey(name)}:${runCount}`;}
|
|
5
|
+
export function cancelLocalOwnedProcess(input:any){try{void Promise.resolve(input.monitorBridge?.markCancelling(input.monitorKey)).catch(()=>{});}catch{}input.treeKill(input.process);}
|
|
6
|
+
export async function cancelLocalWaitOnly(input:any){input.abort?.();try{await input.monitorBridge?.cancelWaitOnly(input.monitorKey,input.event);}catch{}}
|
|
7
|
+
export function linuxProcessIdentity(proc:any){try{if(!Number.isInteger(proc?.pid)||proc.pid<=0)return null;const stat=fs.readFileSync(`/proc/${proc.pid}/stat`,"utf8");const close=stat.lastIndexOf(")");const fields=stat.slice(close+2).trim().split(/\s+/);const starttime=fields[19];return starttime?{pid:proc.pid,starttime}:null;}catch{return null;}}
|
|
8
|
+
export function createOwnedHandleRegistry(deps:any={}) { const handles=new Map<string,any>(); const treeKill=deps.treeKill??((proc:any,signal:string)=>deps.signal?.(proc.pid,signal)), wait=deps.wait??(async()=>false), identity=deps.identity??linuxProcessIdentity; const graceMs=deps.graceMs??5000,setTimer=deps.setTimeout??setTimeout,clearTimer=deps.clearTimeout??clearTimeout;const observe=(p:any,exit:any)=>new Promise<boolean>(resolve=>{let done=false;let timer:any;const finish=(value:boolean)=>{if(done)return;done=true;if(timer!==undefined)clearTimer(timer);resolve(value);};timer=setTimer(()=>finish(false),graceMs);Promise.resolve(wait(p,exit)).then(value=>finish(!!value)).catch(()=>finish(false));});const same=(p:any,expected:any)=>{const current=identity(p);return !!current&¤t.pid===expected.pid&¤t.starttime===expected.starttime;}; return {register(v:any){const processIdentity=identity(v.process);const handle=`${v.profileKey}:${v.taskId}:${v.generation}`;handles.set(handle,{...v,processIdentity,cancelPromise:null});return handle},cancel(r:any){const v=handles.get(r.handle);if(!v)return Promise.resolve({cancelled:false,reason:"unauthorized"});if(v.profileKey!==r.profileKey||v.token!==r.token||v.taskId!==r.taskId)return Promise.resolve({cancelled:false,reason:"unauthorized"});if(v.generation!==r.generation)return Promise.resolve({cancelled:false,reason:"stale_generation"});if(v.cancelPromise)return v.cancelPromise;v.cancelPromise=(async()=>{const proc=v.process;if(!v.processIdentity||!same(proc,v.processIdentity))return{cancelled:false,reason:"stale_identity"};treeKill(proc,"SIGTERM");if(await observe(proc,v.exitPromise)){handles.delete(r.handle);return{cancelled:true,state:"cancelled"};}if(!same(proc,v.processIdentity))return{cancelled:false,reason:"stale_identity"};treeKill(proc,"SIGKILL");if(!(await observe(proc,v.exitPromise)))return{cancelled:false,reason:"exit_not_observed"};handles.delete(r.handle);return{cancelled:true,state:"cancelled"};})();return v.cancelPromise;}} }
|
|
9
|
+
export function recordWaitOnlyCancellation(r:any){return{state:"cancelled",history:r.lateEvent?[r.lateEvent]:[]}}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
import * as crypto from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
|
|
5
|
+
const RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
|
|
6
|
+
const RETENTION_MAX = 1000;
|
|
7
|
+
|
|
8
|
+
type InvokeStatus = "pending" | "accepted" | "rejected";
|
|
9
|
+
function canonicalJson(value: unknown): string {
|
|
10
|
+
if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") return JSON.stringify(value);
|
|
11
|
+
if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
|
|
12
|
+
if (typeof value === "object") {
|
|
13
|
+
const record = value as Record<string, unknown>;
|
|
14
|
+
return `{${Object.keys(record).sort().map(key => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
|
|
15
|
+
}
|
|
16
|
+
throw new Error("invoke intent is not canonical JSON");
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
type InvokeRow = {
|
|
20
|
+
requestId: string;
|
|
21
|
+
hash: string;
|
|
22
|
+
intent: { taskId: string; generation: number; action: string };
|
|
23
|
+
status: InvokeStatus;
|
|
24
|
+
at: string;
|
|
25
|
+
orphaned?: boolean;
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
function safeIntent(intent: unknown): InvokeRow["intent"] {
|
|
29
|
+
const value = intent as Record<string, unknown>;
|
|
30
|
+
if (
|
|
31
|
+
!value ||
|
|
32
|
+
typeof value.taskId !== "string" ||
|
|
33
|
+
!Number.isInteger(value.generation) ||
|
|
34
|
+
typeof value.action !== "string"
|
|
35
|
+
) throw new Error("invalid invoke intent");
|
|
36
|
+
return { taskId: value.taskId, generation: value.generation as number, action: value.action };
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Durable, bounded idempotency records. It never serializes request parameters or credentials. */
|
|
40
|
+
export class MonitorInvokeJournal {
|
|
41
|
+
private readonly rows = new Map<string, InvokeRow>();
|
|
42
|
+
private readonly file: string;
|
|
43
|
+
|
|
44
|
+
constructor(file: string) {
|
|
45
|
+
this.file = file;
|
|
46
|
+
if (!path.isAbsolute(file)) throw new Error("invoke journal path must be absolute");
|
|
47
|
+
fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
|
|
48
|
+
fs.chmodSync(path.dirname(file), 0o700);
|
|
49
|
+
if (!fs.existsSync(file)) return;
|
|
50
|
+
const stat = fs.lstatSync(file);
|
|
51
|
+
if (stat.isSymbolicLink() || !stat.isFile() || (fs.statSync(file).mode & 0o777) !== 0o600) throw new Error("invoke journal unsafe");
|
|
52
|
+
for (const line of fs.readFileSync(file, "utf8").split("\n").filter(Boolean)) {
|
|
53
|
+
let row: InvokeRow;
|
|
54
|
+
try {
|
|
55
|
+
row = JSON.parse(line);
|
|
56
|
+
if (!row.requestId || !row.hash || !row.status || !safeIntent(row.intent)) throw new Error();
|
|
57
|
+
} catch {
|
|
58
|
+
throw new Error("invoke journal torn");
|
|
59
|
+
}
|
|
60
|
+
this.rows.set(row.requestId, row.status === "pending" ? { ...row, orphaned: true } : row);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
static hash(intent: unknown): string {
|
|
65
|
+
return crypto.createHash("sha256").update(canonicalJson(intent), "utf8").digest("hex");
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
admit(requestId: string, intent: unknown): { duplicate: boolean; row?: InvokeRow; error?: string } {
|
|
69
|
+
const hash = MonitorInvokeJournal.hash(intent);
|
|
70
|
+
const prior = this.rows.get(requestId);
|
|
71
|
+
if (prior) {
|
|
72
|
+
if (prior.hash !== hash) return { duplicate: false, error: "idempotency_conflict" };
|
|
73
|
+
if (!prior.orphaned) return { duplicate: true, row: prior };
|
|
74
|
+
const row = { ...prior, orphaned: false, at: new Date().toISOString() };
|
|
75
|
+
this.rows.set(requestId, row);
|
|
76
|
+
this.persist(row);
|
|
77
|
+
return { duplicate: false, row };
|
|
78
|
+
}
|
|
79
|
+
const row: InvokeRow = { requestId, hash, intent: safeIntent(intent), status: "pending", at: new Date().toISOString() };
|
|
80
|
+
this.rows.set(requestId, row);
|
|
81
|
+
this.persist(row);
|
|
82
|
+
return { duplicate: false, row };
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
result(requestId: string, status: Exclude<InvokeStatus, "pending">): InvokeRow {
|
|
86
|
+
const row = this.rows.get(requestId);
|
|
87
|
+
if (!row) throw new Error("unknown request");
|
|
88
|
+
const next = { ...row, status, orphaned: false, at: new Date().toISOString() };
|
|
89
|
+
this.rows.set(requestId, next);
|
|
90
|
+
this.persist(next);
|
|
91
|
+
return next;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
private persist(row: InvokeRow): void {
|
|
95
|
+
// Field-level allowlisting keeps identifiers such as "route-planner" valid.
|
|
96
|
+
const clean: InvokeRow = {
|
|
97
|
+
requestId: row.requestId,
|
|
98
|
+
hash: row.hash,
|
|
99
|
+
intent: safeIntent(row.intent),
|
|
100
|
+
status: row.status,
|
|
101
|
+
at: row.at,
|
|
102
|
+
...(row.orphaned ? { orphaned: true } : {}),
|
|
103
|
+
};
|
|
104
|
+
fs.appendFileSync(this.file, `${JSON.stringify(clean)}\n`, { mode: 0o600 });
|
|
105
|
+
fs.chmodSync(this.file, 0o600);
|
|
106
|
+
this.compact();
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
private compact(): void {
|
|
110
|
+
const cutoff = Date.now() - RETENTION_MS;
|
|
111
|
+
const pending = [...this.rows.values()].filter(row => row.status === "pending");
|
|
112
|
+
const completed = [...this.rows.values()]
|
|
113
|
+
.filter(row => row.status !== "pending" && Date.parse(row.at) >= cutoff)
|
|
114
|
+
.sort((a, b) => Date.parse(a.at) - Date.parse(b.at))
|
|
115
|
+
.slice(-RETENTION_MAX);
|
|
116
|
+
const retained = [...pending, ...completed];
|
|
117
|
+
this.rows.clear();
|
|
118
|
+
for (const row of retained) this.rows.set(row.requestId, row);
|
|
119
|
+
const temporary = `${this.file}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;
|
|
120
|
+
const fd = fs.openSync(temporary, "wx", 0o600);
|
|
121
|
+
try {
|
|
122
|
+
fs.writeSync(fd, retained.map(row => JSON.stringify(row)).join("\n") + (retained.length ? "\n" : ""));
|
|
123
|
+
fs.fsyncSync(fd);
|
|
124
|
+
} finally {
|
|
125
|
+
fs.closeSync(fd);
|
|
126
|
+
}
|
|
127
|
+
fs.renameSync(temporary, this.file);
|
|
128
|
+
const directory = fs.openSync(path.dirname(this.file), "r");
|
|
129
|
+
try { fs.fsyncSync(directory); } finally { fs.closeSync(directory); }
|
|
130
|
+
}
|
|
131
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { TERMINAL_TASK_STATES, validateMonitorInvoke } from "../lib/hermes-monitor-model.ts";
|
|
2
|
+
import { MonitorInvokeJournal } from "./monitor-invoke-journal.ts";
|
|
3
|
+
|
|
4
|
+
/** Longest evidence list rendered inline before the rest is summarized as a count. */
|
|
5
|
+
const RENDERED_EVIDENCE_IDS = 8;
|
|
6
|
+
const FOLLOW_UP_CUSTOM_TYPE = "hermes-watchdog-invoke";
|
|
7
|
+
|
|
8
|
+
export type WatchdogFollowUp = {
|
|
9
|
+
message: { customType: string; content: string; display: true; details: { requestId: string; action: string } };
|
|
10
|
+
options: { deliverAs: "followUp"; triggerTurn: true };
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* The exact follow-up an accepted watchdog request becomes.
|
|
15
|
+
*
|
|
16
|
+
* This is the single production seam: `index.ts`, the unit tests, and the
|
|
17
|
+
* disposable scenario all render through it, so "exactly one follow-up" is a
|
|
18
|
+
* behavioral fact rather than a source match. It carries no dispatcher tool,
|
|
19
|
+
* shell, Herdr, coms free text, or slash-command authority, and it describes a
|
|
20
|
+
* queued request — it never claims the work was executed.
|
|
21
|
+
*/
|
|
22
|
+
export function renderWatchdogFollowUp(request: any): WatchdogFollowUp {
|
|
23
|
+
const evidence: string[] = Array.isArray(request?.parameters?.evidenceEventIds) ? request.parameters.evidenceEventIds : [];
|
|
24
|
+
const shown = evidence.slice(0, RENDERED_EVIDENCE_IDS).join(", ");
|
|
25
|
+
const omitted = evidence.length - Math.min(evidence.length, RENDERED_EVIDENCE_IDS);
|
|
26
|
+
const evidenceLine = omitted > 0 ? `${shown} (+${omitted} more)` : shown;
|
|
27
|
+
return {
|
|
28
|
+
message: {
|
|
29
|
+
customType: FOLLOW_UP_CUSTOM_TYPE,
|
|
30
|
+
content: [
|
|
31
|
+
"[Hermes watchdog request]",
|
|
32
|
+
`Task ${request.taskId} generation ${request.generation}: ${request.action}.`,
|
|
33
|
+
`Evidence: ${evidenceLine}`,
|
|
34
|
+
].join("\n"),
|
|
35
|
+
display: true,
|
|
36
|
+
details: { requestId: request.requestId, action: request.action },
|
|
37
|
+
},
|
|
38
|
+
options: { deliverAs: "followUp", triggerTurn: true },
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** Bind the renderer to a `pi.sendMessage`-shaped transport. */
|
|
43
|
+
export function createWatchdogFollowUpEnqueue(
|
|
44
|
+
sendMessage: (message: WatchdogFollowUp["message"], options: WatchdogFollowUp["options"]) => Promise<void> | void,
|
|
45
|
+
) {
|
|
46
|
+
return (request: any) => {
|
|
47
|
+
const { message, options } = renderWatchdogFollowUp(request);
|
|
48
|
+
return sendMessage(message, options);
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** Hub-only typed admission. It deliberately has no tool, shell, Herdr, or free-text surface. */
|
|
53
|
+
export function createMonitorInvokeAdmission(deps: {
|
|
54
|
+
journal: MonitorInvokeJournal;
|
|
55
|
+
task: (id: string, generation: number) => any;
|
|
56
|
+
owner: () => string | undefined;
|
|
57
|
+
queueDepth: () => number;
|
|
58
|
+
queueLimit: number;
|
|
59
|
+
enqueue?: (request: any) => Promise<void> | void;
|
|
60
|
+
publish?: (kind: "action.requested" | "action.accepted" | "action.rejected" | "action.completed" | "hub.queue_depth_changed", task: any, extra?: any) => void;
|
|
61
|
+
}) {
|
|
62
|
+
return async (request: unknown) => {
|
|
63
|
+
const valid = validateMonitorInvoke(request);
|
|
64
|
+
if (!valid) return { status: "unsupported" };
|
|
65
|
+
const task = deps.task(valid.taskId, valid.generation);
|
|
66
|
+
if (!task) return { status: "stale_generation" };
|
|
67
|
+
const owner = deps.owner();
|
|
68
|
+
if (!owner || task.ownerSessionId !== owner) return { status: "owner_changed" };
|
|
69
|
+
if (TERMINAL_TASK_STATES.has(task.state)) return { status: "already_terminal" };
|
|
70
|
+
if (deps.queueDepth() >= deps.queueLimit) return { status: "queue_full" };
|
|
71
|
+
|
|
72
|
+
const admitted = deps.journal.admit(valid.requestId, valid);
|
|
73
|
+
if ("error" in admitted) return { status: "idempotency_conflict" };
|
|
74
|
+
if (admitted.duplicate) return { status: "duplicate" };
|
|
75
|
+
|
|
76
|
+
deps.publish?.("action.requested", task);
|
|
77
|
+
try {
|
|
78
|
+
await deps.enqueue?.(valid);
|
|
79
|
+
deps.journal.result(valid.requestId, "accepted");
|
|
80
|
+
deps.publish?.("action.accepted", task);
|
|
81
|
+
// sendMessage settling is the only completion this boundary owns: it never claims dispatch/tool completion.
|
|
82
|
+
deps.publish?.("action.completed", task);
|
|
83
|
+
deps.publish?.("hub.queue_depth_changed", task, { queueDepth: deps.queueDepth() });
|
|
84
|
+
return { status: "accepted" };
|
|
85
|
+
} catch {
|
|
86
|
+
deps.journal.result(valid.requestId, "rejected");
|
|
87
|
+
deps.publish?.("action.rejected", task);
|
|
88
|
+
deps.publish?.("hub.queue_depth_changed", task, { queueDepth: deps.queueDepth() });
|
|
89
|
+
return { status: "rejected" };
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import * as path from "node:path";
|
|
2
|
+
import { MonitorSocketServer } from "../lib/hermes-monitor-socket.ts";
|
|
3
|
+
import { createOwnedHandleRegistry, recordWaitOnlyCancellation } from "./monitor-control.ts";
|
|
4
|
+
export interface MonitorLifecycleConfig { runtimeDir:string; profileId:string; profilePath:string; }
|
|
5
|
+
export function monitorLifecycleConfig(env:NodeJS.ProcessEnv):MonitorLifecycleConfig|null{const profileId=env.AGENT_FLEET_PROFILE_ID,runtimeDir=env.AGENT_FLEET_MONITOR_RUNTIME_DIR;if(!profileId||!runtimeDir||!path.isAbsolute(runtimeDir)||!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(profileId)||profileId.includes(".."))return null;return{runtimeDir,profileId,profilePath:path.join(runtimeDir,"profiles",profileId)};}
|
|
6
|
+
export function createMonitorLifecycle(deps:any){const control=createOwnedHandleRegistry(deps),handles=new Map<string,string>(),completedCancels=new Map<string,any>(),setTimer=deps.setInterval??setInterval,clearTimer=deps.clearInterval??clearInterval;let socket:MonitorSocketServer|null=null,registration:any=null,renewTimer:any=null,reconcileTimer:any=null,retryTimer:any=null,unavailable=false,bridgeRef:any=null,bridgeInput:any=null,epoch=0;const clearRenew=()=>{if(renewTimer!==null){clearTimer(renewTimer);renewTimer=null;}if(reconcileTimer!==null){clearTimer(reconcileTimer);reconcileTimer=null;}if(retryTimer!==null){(deps.clearTimeout??clearTimeout)(retryTimer);retryTimer=null;}};const cleanup=()=>{clearRenew();registration?.cleanup?.();registration=null;};const api:any={
|
|
7
|
+
async startBridge(bridge:any,input:any){const startEpoch=epoch;bridgeRef=bridge;bridgeInput=input;const value=await api.start({...input,snapshot:()=>{bridge.prune();return bridge.snapshot();},output:(request:any)=>bridge.readOutput(request),events:input.events,invoke:input.invoke});if(!value||startEpoch!==epoch||bridgeRef!==bridge){if(value){try{await socket?.close();}catch{}value.cleanup?.();}return null;}bridge.setEventIdentity?.({profileKey:value.profileKey,hubInstanceId:input.hubInstanceId});bridge.setCurrentOwner?.({ownerSessionId:value.ownerId,ownerLeaseExpiresAt:value.leaseExpiresAt,updateActive:true});bridge.publishHubEvent?.("hub.capability_changed",{capabilities:{events:!!input.events,invoke:!!input.invoke}});reconcileTimer=setTimer(()=>{const probeEpoch=epoch;const reconcile=(task:any,e:any)=>{if(probeEpoch!==epoch||bridgeRef!==bridge)return;bridge.reconcile({...e,taskId:`${task.id}:${task.generation}`});};try{for(const task of bridge.snapshot?.().tasks??[]){if(probeEpoch!==epoch||bridgeRef!==bridge)break;Promise.resolve(deps.getRecoveryEvidence?.(task)??deps.reconcileEvidence?.()??{}).then(e=>reconcile(task,e)).catch(()=>reconcile(task,{transient:true}));}}catch{if(probeEpoch===epoch&&bridgeRef===bridge)bridge.reconcile({transient:true});}},30_000);value.cancel=(request:any)=>bridge.cancelTask(request);return value;},
|
|
8
|
+
lowLevelCancelOwnedGeneration(request:any){return api.cancelOwnedGeneration(request);},
|
|
9
|
+
async start(input:any){const startEpoch=epoch;try{registration=deps.registry.register(input);registration.output=input.output;registration.events=input.events;registration.invoke=input.invoke;registration.cancel=(request:any)=>api.cancelOwnedGeneration(request);socket=(deps.createSocketServer??((r:any)=>new MonitorSocketServer(r)))(registration);await socket.listen();if(startEpoch!==epoch){try{await socket.close();}catch{}registration?.cleanup?.();registration=null;socket=null;return null;}if(registration.renew&®istration.leaseMs){renewTimer=setTimer(()=>{try{Promise.resolve(registration?.renew()).then((renewed:any)=>{if(renewed?.leaseExpiresAt){registration.leaseExpiresAt=renewed.leaseExpiresAt;bridgeRef?.setCurrentOwner?.({ownerSessionId:registration.ownerId,ownerLeaseExpiresAt:renewed.leaseExpiresAt,updateActive:true});}}).catch(()=>api.disable());}catch{void api.disable();}},Math.max(1,Math.floor(registration.leaseMs/2)));}return registration;}catch(error:any){try{await socket?.close();}catch{}socket=null;cleanup();if(error?.leaseExpiresAt){const delay=Math.max(0,new Date(error.leaseExpiresAt).getTime()-(deps.now?.()??Date.now()));const retryEpoch=epoch;retryTimer=(deps.setTimeout??setTimeout)(()=>{retryTimer=null;if(retryEpoch!==epoch)return;void (bridgeRef?api.startBridge(bridgeRef,bridgeInput):api.start(input)).catch(()=>{});},delay);return null;}throw error;}},
|
|
10
|
+
cancelOwnedGeneration(request:any){const key=`${request.taskId}:${request.generation}`;if(completedCancels.has(key))return Promise.resolve(completedCancels.get(key));const handle=handles.get(key);if(!handle)return Promise.resolve({cancelled:false,reason:"unsupported"});return control.cancel({...request,profileKey:registration?.profileKey,token:registration?.token,handle}).then((result:any)=>{completedCancels.set(key,result);return result;});},
|
|
11
|
+
registerOwnedGeneration(value:any){const proc:any=value.process;const exitPromise=value.exitPromise??(proc?.exitCode!==null&&proc?.exitCode!==undefined?Promise.resolve(true):new Promise(resolve=>proc?.once?.("close",()=>resolve(true))));const owned={...value,exitPromise,profileKey:registration?.profileKey??value.profileKey,token:registration?.token??value.token};const handle=control.register(owned);handles.set(`${owned.taskId}:${owned.generation}`,handle);return handle;},async disable(){unavailable=true;await api.stop();},isUnavailable(){return unavailable;},isAlive(){return !!socket&&!unavailable;},recordWaitOnlyCancellation,
|
|
12
|
+
async stop(){epoch++;bridgeRef=null;bridgeInput=null;clearRenew();try{await socket?.close();}finally{socket=null;registration?.cleanup?.();registration=null;}}
|
|
13
|
+
};return api;}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type CreateChildTaskInput,
|
|
3
|
+
type CreateParentTaskInput,
|
|
4
|
+
type MonitorTask,
|
|
5
|
+
} from "../lib/hermes-monitor-model.ts";
|
|
6
|
+
import { MonitorStore, type MonitorOutput } from "../lib/hermes-monitor-store.ts";
|
|
7
|
+
import { correlateHubPane } from "../lib/hermes-monitor-herdr.ts";
|
|
8
|
+
|
|
9
|
+
export interface ViewerGatedMonitor {
|
|
10
|
+
setViewers(count: number): void;
|
|
11
|
+
stop(): void;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export function createViewerGatedMonitor(options: {
|
|
15
|
+
pollMetadata: () => Promise<Array<{ id: string; generation: number; outputSequence: number }>>;
|
|
16
|
+
fetchOutput: (id: string, generation: number, afterSequence: number) => Promise<{ sequence: number }>;
|
|
17
|
+
intervalMs?: number;
|
|
18
|
+
}): ViewerGatedMonitor {
|
|
19
|
+
const cursors = new Map<string, number>();
|
|
20
|
+
let viewers = 0;
|
|
21
|
+
let timer: ReturnType<typeof setInterval> | null = null;
|
|
22
|
+
const poll = async () => {
|
|
23
|
+
if (viewers === 0) return;
|
|
24
|
+
for (const row of await options.pollMetadata()) {
|
|
25
|
+
const key = `${row.id}:${row.generation}`;
|
|
26
|
+
const cursor = cursors.get(key) ?? 0;
|
|
27
|
+
if (row.outputSequence > cursor) cursors.set(key, (await options.fetchOutput(row.id, row.generation, cursor)).sequence);
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
return { setViewers(count) { viewers = Math.max(0, count); if (viewers > 0 && !timer) timer = setInterval(() => void poll(), options.intervalMs ?? 1000); if (viewers === 0 && timer) { clearInterval(timer); timer = null; } }, stop() { viewers = 0; if (timer) clearInterval(timer); timer = null; } };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// Agent Fleet-owned publishing seam. Hub lifecycle wiring is added in later slices.
|
|
34
|
+
export class MonitorPublisher {
|
|
35
|
+
private readonly store: MonitorStore;
|
|
36
|
+
|
|
37
|
+
constructor(store: MonitorStore) {
|
|
38
|
+
this.store = store;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
publishParent(input: CreateParentTaskInput): MonitorTask {
|
|
42
|
+
return this.store.createParent(input);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
publishChild(input: CreateChildTaskInput): MonitorTask {
|
|
46
|
+
return this.store.createChild(input);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
async publishChildForHub(input: CreateChildTaskInput, env: NodeJS.ProcessEnv = process.env): Promise<MonitorTask> {
|
|
50
|
+
const correlation = await correlateHubPane(env);
|
|
51
|
+
return this.publishChild({ ...input, workspaceId: correlation.workspaceId ?? input.workspaceId, hubPaneId: correlation.hubPaneId ?? input.hubPaneId });
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
transition(id: string, generation: number, state: any): MonitorTask { return this.store.transition(id, generation, state); }
|
|
55
|
+
|
|
56
|
+
publishPublicOutput(id: string, generation: number, text: string): MonitorOutput {
|
|
57
|
+
return this.store.appendPublicOutput(id, generation, text);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import * as crypto from "node:crypto";
|
|
2
|
+
export function stableMonitorHubId(input:{profileId:string;checkout:string;workspaceId?:string;paneId?:string}){if(!input.workspaceId||!input.paneId)throw new Error("monitor recovery requires Herdr workspace and pane identity");return crypto.createHash("sha256").update(`${input.profileId}\0${input.checkout}\0${input.workspaceId}\0${input.paneId}`).digest("hex");}
|
|
3
|
+
export async function monitorReconcileEvidence(input:any){try{const owner=input.owner??!!input.registry?.owns?.(input.hubId);const socket=input.socket??!!input.socketServer?.alive?.();const session=input.session??input.currentHubId===input.hubId;const pane=await input.herdr?.pane?.get?.(input.paneId);const workspace=await input.herdr?.workspace?.get?.(input.workspaceId);return{owner:!!owner,socket:!!socket,session:!!session,herdr:!!pane&&!!workspace};}catch{return{owner:!!input.owner,socket:!!input.socket,session:!!input.session,herdr:true,transient:true};}}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import * as crypto from "node:crypto";import * as fs from "node:fs";import * as path from "node:path";
|
|
2
|
+
const key=(v:string)=>crypto.createHash("sha256").update(v).digest("hex");const ownedDir=(p:string)=>{const s=fs.lstatSync(p);if(s.isSymbolicLink()||!s.isDirectory()||(s.mode&0o777)!==0o700)throw Error("unsafe monitor runtime");};const safe=(v:string)=>/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(v)&&!v.includes("..");
|
|
3
|
+
export class MonitorRuntime {path:string;private now:()=>Date;constructor(o:any){if(!path.isAbsolute(o.runtimeDir)||!safe(o.profileId)||!safe(o.hubInstanceId))throw Error("unsafe monitor runtime");this.now=o.now??(()=>new Date());fs.mkdirSync(o.runtimeDir,{recursive:true,mode:0o700});ownedDir(o.runtimeDir);const journal=path.join(o.runtimeDir,"journal");fs.mkdirSync(journal,{recursive:true,mode:0o700});ownedDir(journal);const dir=path.join(journal,key(o.profileId));fs.mkdirSync(dir,{recursive:true,mode:0o700});ownedDir(dir);this.path=path.join(dir,`${key(o.hubInstanceId)}.json`);}save(state:any){const clean={tasks:(state.tasks??[]).map((t:any)=>({...t,output:String(t.output??"").slice(-8192),lateHistory:(t.lateHistory??[]).slice(-200)}))};const dir=path.dirname(this.path);ownedDir(dir);const tmp=path.join(dir,`.${path.basename(this.path)}.${crypto.randomUUID()}.tmp`);let fd:number|undefined;try{fd=fs.openSync(tmp,fs.constants.O_WRONLY|fs.constants.O_CREAT|fs.constants.O_EXCL|fs.constants.O_NOFOLLOW,0o600);fs.writeFileSync(fd,JSON.stringify(clean));fs.fsyncSync(fd);fs.closeSync(fd);fd=undefined;fs.renameSync(tmp,this.path);try{const dfd=fs.openSync(dir,fs.constants.O_RDONLY);fs.fsyncSync(dfd);fs.closeSync(dfd);}catch{}}finally{if(fd!==undefined)try{fs.closeSync(fd)}catch{};try{fs.unlinkSync(tmp)}catch{}}}load(){if(!fs.existsSync(this.path))return{tasks:[]};const st=fs.lstatSync(this.path);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error("unsafe monitor journal");try{const v=JSON.parse(fs.readFileSync(this.path,"utf8"));if(!Array.isArray(v.tasks))throw Error();return v;}catch{throw Error("unsafe monitor journal");}}reconcile(state:any,e:any){return{...state,tasks:(state.tasks??[]).map((t:any)=>{const lease=Date.parse(t.ownerLeaseExpiresAt??"");const expiry=Number.isFinite(lease)?lease:Date.parse(t.updatedAt??"")+30_000;const expired=this.now().getTime()>=expiry;return expired&&["starting","running","cancelling"].includes(t.state)&&!e.owner&&!e.socket&&!e.session&&!e.herdr?{...t,state:"orphaned"}:t;})};}}
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
import { MonitorStore } from "../lib/hermes-monitor-store.ts";
|
|
2
|
+
import { MonitorPublisher } from "./monitor-publisher.ts";
|
|
3
|
+
|
|
4
|
+
const terminal = (state: any) => ["completed", "blocked", "failed", "cancelled", "orphaned", "done"].includes(state);
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Translates Hub lifecycle mutations into durable monitor facts. Publication failures
|
|
8
|
+
* are isolated from Hub work: task state remains authoritative in MonitorStore.
|
|
9
|
+
*/
|
|
10
|
+
export function createMonitorSessionBridge(deps: any = {}) {
|
|
11
|
+
const store = deps.store ?? new MonitorStore({ now: deps.now });
|
|
12
|
+
const pub = deps.publisher ?? new MonitorPublisher(store);
|
|
13
|
+
const keys = new Map<string, { id: string; generation: number }>();
|
|
14
|
+
const ready = new Map<string, Promise<any>>();
|
|
15
|
+
const late = new Map<string, any[]>();
|
|
16
|
+
const finalized = new Map<string, Promise<any>>();
|
|
17
|
+
const cancellable = new Set<string>();
|
|
18
|
+
const waitAborts = new Map<string, () => unknown>();
|
|
19
|
+
const recovering = new Map<string, string>();
|
|
20
|
+
const monitorKeyByTask = new Map<string, string>();
|
|
21
|
+
const lateByGeneration = new Map<string, any[]>();
|
|
22
|
+
let eventSequence = deps.events?.latestSequence?.() ?? 0;
|
|
23
|
+
let currentOwner: any = deps.currentOwner ?? {};
|
|
24
|
+
let eventIdentity: { profileKey?: string; hubInstanceId?: string } = {
|
|
25
|
+
profileKey: deps.profileKey,
|
|
26
|
+
hubInstanceId: deps.hubInstanceId,
|
|
27
|
+
};
|
|
28
|
+
const runtime = deps.runtime;
|
|
29
|
+
|
|
30
|
+
const records = () => store.snapshot().tasks as any[];
|
|
31
|
+
const taskKey = (task: any) => `${task.id}:${task.generation}`;
|
|
32
|
+
const eventTask = (task: any, fromState?: string) => ({
|
|
33
|
+
id: task.id,
|
|
34
|
+
generation: task.generation,
|
|
35
|
+
parentId: task.parentId,
|
|
36
|
+
specialist: task.specialist,
|
|
37
|
+
...(fromState ? { fromState } : {}),
|
|
38
|
+
toState: task.state,
|
|
39
|
+
outputSequence: task.outputSequence ?? 0,
|
|
40
|
+
});
|
|
41
|
+
const publishEvent = (kind: string, task?: any, extra: any = {}) => {
|
|
42
|
+
if (!deps.events) return undefined;
|
|
43
|
+
const profileKey = eventIdentity.profileKey;
|
|
44
|
+
const hubInstanceId = task?.hubInstanceId ?? eventIdentity.hubInstanceId;
|
|
45
|
+
const ownerId = currentOwner.ownerSessionId;
|
|
46
|
+
if (!profileKey || !hubInstanceId || !ownerId) {
|
|
47
|
+
deps.onEventJournalError?.(new Error("monitor event identity is unavailable"));
|
|
48
|
+
return undefined;
|
|
49
|
+
}
|
|
50
|
+
const next = eventSequence + 1;
|
|
51
|
+
const event = {
|
|
52
|
+
schema: "agent-fleet.monitor-event",
|
|
53
|
+
schemaVersion: 1,
|
|
54
|
+
eventId: `${hubInstanceId}:${next}`,
|
|
55
|
+
eventSequence: next,
|
|
56
|
+
profileKey,
|
|
57
|
+
hubInstanceId,
|
|
58
|
+
ownerId,
|
|
59
|
+
occurredAt: (deps.now?.() ?? new Date()).toISOString(),
|
|
60
|
+
kind,
|
|
61
|
+
...(task ? { task: eventTask(task, extra.fromState) } : {}),
|
|
62
|
+
materialKey: task ? `${kind}:${task.id}:${task.generation}:${task.state}` : `${kind}:${ownerId}`,
|
|
63
|
+
...extra,
|
|
64
|
+
};
|
|
65
|
+
try {
|
|
66
|
+
deps.events.append(event);
|
|
67
|
+
eventSequence = next;
|
|
68
|
+
return event;
|
|
69
|
+
} catch (error) {
|
|
70
|
+
deps.onEventJournalError?.(error);
|
|
71
|
+
return undefined;
|
|
72
|
+
}
|
|
73
|
+
};
|
|
74
|
+
const transition = (id: string, generation: number, state: any) => {
|
|
75
|
+
const before = store.get(id, generation)?.state;
|
|
76
|
+
const task = pub.transition(id, generation, state);
|
|
77
|
+
publishEvent("task.state_changed", task, { fromState: before });
|
|
78
|
+
return task;
|
|
79
|
+
};
|
|
80
|
+
|
|
81
|
+
try {
|
|
82
|
+
if (runtime) {
|
|
83
|
+
for (const task of runtime.load().tasks ?? []) {
|
|
84
|
+
store.restore([task]);
|
|
85
|
+
if (!task.monitorKey) continue;
|
|
86
|
+
const id = taskKey(task);
|
|
87
|
+
monitorKeyByTask.set(id, task.monitorKey);
|
|
88
|
+
if (task.lateHistory) lateByGeneration.set(`${task.monitorKey}:${task.generation}`, task.lateHistory);
|
|
89
|
+
const prior = keys.get(task.monitorKey);
|
|
90
|
+
if (!prior || prior.generation < task.generation) {
|
|
91
|
+
keys.set(task.monitorKey, { id: task.id, generation: task.generation });
|
|
92
|
+
ready.set(task.monitorKey, Promise.resolve(task));
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
} catch (error) {
|
|
97
|
+
throw error;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
const persist = () => runtime?.save({
|
|
101
|
+
tasks: (store.durableSnapshot?.().tasks ?? records()).map((task: any) => ({
|
|
102
|
+
...task,
|
|
103
|
+
monitorKey: monitorKeyByTask.get(taskKey(task)),
|
|
104
|
+
lateHistory: lateByGeneration.get(`${monitorKeyByTask.get(taskKey(task))}:${task.generation}`) ?? [],
|
|
105
|
+
})),
|
|
106
|
+
});
|
|
107
|
+
const lateEvent = (key: string, event: any, generation?: number) => {
|
|
108
|
+
generation ??= keys.get(key)?.generation;
|
|
109
|
+
const lateKey = generation === undefined ? key : `${key}:${generation}`;
|
|
110
|
+
const history = lateByGeneration.get(lateKey) ?? [];
|
|
111
|
+
history.push(event);
|
|
112
|
+
if (history.length > 200) history.splice(0, history.length - 200);
|
|
113
|
+
lateByGeneration.set(lateKey, history);
|
|
114
|
+
late.set(key, history);
|
|
115
|
+
const task = generation === undefined ? undefined : store.get(keys.get(key)?.id ?? "", generation);
|
|
116
|
+
if (task) publishEvent("task.late_event", task);
|
|
117
|
+
persist();
|
|
118
|
+
return { state: "cancelled", history };
|
|
119
|
+
};
|
|
120
|
+
const after = (key: string, work: (value: any) => any) => {
|
|
121
|
+
const pending = ready.get(key);
|
|
122
|
+
if (!pending) return Promise.reject(new Error(`child ${key} is not registered`));
|
|
123
|
+
const chained = pending.then(() => work(keys.get(key))).then(value => { persist(); return value; });
|
|
124
|
+
ready.set(key, chained.catch(() => undefined));
|
|
125
|
+
return chained;
|
|
126
|
+
};
|
|
127
|
+
const output = (task: any, text: string) => {
|
|
128
|
+
const result = pub.publishPublicOutput(task.id, task.generation, text);
|
|
129
|
+
publishEvent("task.output_advanced", store.get(task.id, task.generation));
|
|
130
|
+
return result;
|
|
131
|
+
};
|
|
132
|
+
|
|
133
|
+
return {
|
|
134
|
+
setEventIdentity(identity: { profileKey: string; hubInstanceId: string }) { eventIdentity = { ...identity }; },
|
|
135
|
+
setCurrentOwner(owner: any) {
|
|
136
|
+
const changed = currentOwner.ownerSessionId !== owner.ownerSessionId || currentOwner.ownerLeaseExpiresAt !== owner.ownerLeaseExpiresAt;
|
|
137
|
+
currentOwner = { ...owner };
|
|
138
|
+
if (changed && owner.ownerSessionId && owner.ownerLeaseExpiresAt) publishEvent("owner.lease_changed", undefined, { ownerLeaseExpiresAt: owner.ownerLeaseExpiresAt });
|
|
139
|
+
if (owner.updateActive) for (const task of records()) if (!terminal(task.state)) {
|
|
140
|
+
if (!task.ownerSessionId || task.ownerSessionId === owner.ownerSessionId) store.patch(task.id, task.generation, {
|
|
141
|
+
ownerSessionId: owner.ownerSessionId,
|
|
142
|
+
ownerLeaseExpiresAt: owner.ownerLeaseExpiresAt,
|
|
143
|
+
});
|
|
144
|
+
}
|
|
145
|
+
persist();
|
|
146
|
+
},
|
|
147
|
+
publishEvent(kind: string, task: any, extra?: any) { return publishEvent(kind, task, extra); },
|
|
148
|
+
publishHubEvent(kind: string, extra?: any) { return publishEvent(kind, undefined, extra); },
|
|
149
|
+
startParent(value: any) {
|
|
150
|
+
const task = pub.publishParent({ ...value, ...currentOwner, generation: value.generation ?? 1 });
|
|
151
|
+
keys.set(`parent:${task.id}`, { id: task.id, generation: task.generation });
|
|
152
|
+
monitorKeyByTask.set(taskKey(task), `parent:${task.id}`);
|
|
153
|
+
publishEvent("hub.turn_started", task);
|
|
154
|
+
persist();
|
|
155
|
+
return task;
|
|
156
|
+
},
|
|
157
|
+
finishParent(id: string, state: any = "completed") {
|
|
158
|
+
const value = keys.get(`parent:${id}`);
|
|
159
|
+
if (!value) return undefined;
|
|
160
|
+
const task = store.get(value.id, value.generation);
|
|
161
|
+
if (!task || terminal(task.state)) return task;
|
|
162
|
+
const done = transition(value.id, value.generation, state);
|
|
163
|
+
publishEvent("hub.turn_completed", done);
|
|
164
|
+
persist();
|
|
165
|
+
return done;
|
|
166
|
+
},
|
|
167
|
+
startChild(value: any, env: any) {
|
|
168
|
+
const existing = ready.get(value.key);
|
|
169
|
+
if (existing) {
|
|
170
|
+
const prior = keys.get(value.key);
|
|
171
|
+
const task = prior && store.get(prior.id, prior.generation);
|
|
172
|
+
if (!task || !terminal(task.state)) return existing;
|
|
173
|
+
publishEvent("task.generation_superseded", task);
|
|
174
|
+
value = { ...value, generation: prior.generation + 1 };
|
|
175
|
+
ready.delete(value.key);
|
|
176
|
+
}
|
|
177
|
+
const pending = Promise.resolve().then(() => pub.publishChildForHub({ ...value, ...currentOwner, parentGeneration: value.parentGeneration ?? 1 }, env)).then((task: any) => {
|
|
178
|
+
keys.set(value.key, { id: task.id, generation: task.generation });
|
|
179
|
+
monitorKeyByTask.set(taskKey(task), value.key);
|
|
180
|
+
publishEvent("task.started", task);
|
|
181
|
+
persist();
|
|
182
|
+
return { ...task, monitorKey: value.key };
|
|
183
|
+
});
|
|
184
|
+
ready.set(value.key, pending);
|
|
185
|
+
pending.catch(() => ready.delete(value.key));
|
|
186
|
+
return pending;
|
|
187
|
+
},
|
|
188
|
+
appendOutputFor(value: any, text: string) {
|
|
189
|
+
const task = store.get(value.id, value.generation);
|
|
190
|
+
if (!task || terminal(task.state)) return lateEvent(monitorKeyByTask.get(taskKey(value)) ?? value.monitorKey, { kind: "late_output", text }, value.generation);
|
|
191
|
+
const result = output(task, text); persist(); return result;
|
|
192
|
+
},
|
|
193
|
+
finalizeChildFor(value: any, text: string, state: any) {
|
|
194
|
+
const id = taskKey(value); const prior = finalized.get(id); if (prior) return prior;
|
|
195
|
+
const task = store.get(value.id, value.generation); const key = monitorKeyByTask.get(id) ?? value.monitorKey;
|
|
196
|
+
if (!task || terminal(task.state)) return lateEvent(key, { kind: "late_final", text, state }, value.generation);
|
|
197
|
+
const result = Promise.resolve().then(() => { if (text) output(task, text); return transition(value.id, value.generation, state); }).then(done => { persist(); return done; });
|
|
198
|
+
finalized.set(id, result); return result;
|
|
199
|
+
},
|
|
200
|
+
registerOwnedProcessFor(value: any, process: unknown) { const key = value.monitorKey ?? monitorKeyByTask.get(taskKey(value)); cancellable.add(key); return deps.registerOwnedProcess?.(key, process, value); },
|
|
201
|
+
cancelFor(value: any) { return this.cancelTask({ taskId: value.id, generation: value.generation }); },
|
|
202
|
+
registerOwnedProcess(key: string, process: unknown) { return after(key, (value: any) => { cancellable.add(key); return deps.registerOwnedProcess?.(key, process, value); }); },
|
|
203
|
+
registerWaitOnly(key: string, abort?: () => unknown) { return after(key, () => { cancellable.add(key); if (abort) waitAborts.set(key, abort); }); },
|
|
204
|
+
appendOutput(key: string, text: string) { return after(key, (value: any) => { const task = store.get(value.id, value.generation); return terminal(task?.state) ? lateEvent(key, { kind: "late_output", text }) : output(task, text); }); },
|
|
205
|
+
finishChild(key: string, state: any) { return after(key, (value: any) => { const task = store.get(value.id, value.generation); if (terminal(task?.state)) return task?.state === "cancelled" || task?.state === "orphaned" ? lateEvent(key, { kind: "late_finish", state }) : task; return transition(value.id, value.generation, state); }); },
|
|
206
|
+
finalizeChild(key: string, text: string, state: any) { const prior = finalized.get(key); if (prior) return prior; const result = after(key, (value: any) => { const task = store.get(value.id, value.generation); if (terminal(task?.state)) return task?.state === "cancelled" || task?.state === "orphaned" ? lateEvent(key, { kind: "late_final", text, state }) : task; if (text) output(task, text); return transition(value.id, value.generation, state); }); finalized.set(key, result); return result; },
|
|
207
|
+
recordComsFinal(key: string, text: string) { return this.appendOutput(key, text); },
|
|
208
|
+
markCancelling(key: string) { return after(key, (value: any) => terminal(store.get(value.id, value.generation)?.state) ? store.get(value.id, value.generation) : transition(value.id, value.generation, "cancelling")); },
|
|
209
|
+
markCancelled(key: string) { return after(key, (value: any) => store.get(value.id, value.generation)?.state === "cancelled" ? store.get(value.id, value.generation) : transition(value.id, value.generation, "cancelled")); },
|
|
210
|
+
async cancelOwnedProcess(key: string) { return after(key, async (value: any) => { const task = store.get(value.id, value.generation); if (task?.state === "cancelled") return { cancelled: true, state: "cancelled" }; if (!terminal(task?.state)) transition(value.id, value.generation, "cancelling"); const result = await deps.cancelOwnedProcess?.({ taskId: value.id, generation: value.generation }); if (result?.cancelled && !terminal(store.get(value.id, value.generation)?.state)) transition(value.id, value.generation, "cancelled"); if (result?.cancelled) cancellable.delete(key); return result ?? { cancelled: false, reason: "unsupported" }; }); },
|
|
211
|
+
cancelAllWaitOnly() { return Promise.all([...waitAborts.keys()].map(key => this.cancelWaitOnly(key, { kind: "session_reset" }))); },
|
|
212
|
+
cancelWaitOnly(key: string, event: unknown) { return after(key, async (value: any) => { await waitAborts.get(key)?.(); const task = store.get(value.id, value.generation); if (!terminal(task?.state)) transition(value.id, value.generation, "cancelled"); cancellable.delete(key); waitAborts.delete(key); return lateEvent(key, event); }); },
|
|
213
|
+
cancelTask(request: any) { const entry = [...keys.entries()].find(([, value]) => value.id === request.taskId && value.generation === request.generation); if (!entry) return Promise.resolve({ cancelled: false, reason: "unsupported" }); const [key] = entry; return waitAborts.has(key) ? this.cancelWaitOnly(key, { kind: "operator_cancel" }).then(() => ({ cancelled: true, state: "cancelled" })) : this.cancelOwnedProcess(key); },
|
|
214
|
+
recordComsLateEvent(key: string, event: unknown) { return lateEvent(key, event); },
|
|
215
|
+
readOutput(request: any) { return store.readOutput(request.taskId, request.generation, request.afterSequence); },
|
|
216
|
+
prune() { const value = store.prune(); persist(); return value; },
|
|
217
|
+
reconcile(e: any) {
|
|
218
|
+
for (const task of records()) {
|
|
219
|
+
// Grouped explicitly: a task-scoped probe skips other tasks, and a
|
|
220
|
+
// terminal task is never reconciled regardless of the filter.
|
|
221
|
+
const filteredOut = Boolean(e?.taskId) && taskKey(task) !== e.taskId;
|
|
222
|
+
if (filteredOut || terminal(task.state)) continue;
|
|
223
|
+
|
|
224
|
+
const old = task.ownerSessionId && task.ownerSessionId !== currentOwner.ownerSessionId;
|
|
225
|
+
const leaseExpiresAt = Date.parse(task.ownerLeaseExpiresAt ?? "");
|
|
226
|
+
const expired = !Number.isFinite(leaseExpiresAt) || (deps.now?.().getTime?.() ?? Date.now()) >= leaseExpiresAt;
|
|
227
|
+
// Evidence for the previous owner's registration versus the current one.
|
|
228
|
+
const oldEvidenceGone = e?.oldOwner === false && e?.oldSocket === false && e?.oldSession === false && e?.oldHerdr === false;
|
|
229
|
+
const currentEvidenceGone = !e?.owner && !e?.socket && !e?.session && !e?.herdr;
|
|
230
|
+
const currentEvidencePresent = Boolean(e?.owner && e?.socket && e?.session && e?.herdr);
|
|
231
|
+
|
|
232
|
+
const orphaned = !e?.transient && ((old && expired && oldEvidenceGone) || (!old && expired && currentEvidenceGone));
|
|
233
|
+
if (orphaned) {
|
|
234
|
+
const done = transition(task.id, task.generation, "orphaned");
|
|
235
|
+
publishEvent("owner.orphaned", done);
|
|
236
|
+
continue;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
const lostContact = old || e?.transient || currentEvidenceGone;
|
|
240
|
+
if (lostContact && task.state !== "recovering") {
|
|
241
|
+
recovering.set(taskKey(task), task.state);
|
|
242
|
+
const next = transition(task.id, task.generation, "recovering");
|
|
243
|
+
publishEvent("owner.recovering", next);
|
|
244
|
+
continue;
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
if (task.state === "recovering" && currentEvidencePresent) {
|
|
248
|
+
transition(task.id, task.generation, recovering.get(taskKey(task)) ?? "running");
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
persist(); return this.snapshot();
|
|
252
|
+
},
|
|
253
|
+
snapshot() { persist(); return { tasks: records().map((task: any) => { const key = monitorKeyByTask.get(taskKey(task)); return { id: task.id, generation: task.generation, kind: task.kind, parentId: task.parentId, parentGeneration: task.parentGeneration, specialist: task.specialist, state: task.state, workspaceId: task.workspaceId, hubPaneId: task.hubPaneId, hubInstanceId: task.hubInstanceId, ownerSessionId: task.ownerSessionId, ownerLeaseExpiresAt: task.ownerLeaseExpiresAt, outputSequence: task.outputSequence, firstSequence: task.firstSequence, truncated: task.truncated, canCancel: !!key && cancellable.has(key) && !terminal(task.state) }; }) }; },
|
|
254
|
+
reset() { keys.clear(); ready.clear(); late.clear(); finalized.clear(); cancellable.clear(); monitorKeyByTask.clear(); lateByGeneration.clear(); persist(); },
|
|
255
|
+
stop() { keys.clear(); ready.clear(); late.clear(); finalized.clear(); cancellable.clear(); monitorKeyByTask.clear(); lateByGeneration.clear(); },
|
|
256
|
+
};
|
|
257
|
+
}
|