@chankov/agent-fleet 1.0.1 → 1.0.2
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/.pi/extensions/package-lock.json +77 -45
- package/.pi/harnesses/agent-hub/README.md +109 -18
- package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.pi/harnesses/agent-hub/hub-state-audit.js +18 -0
- package/.pi/harnesses/agent-hub/index.ts +988 -422
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/posture.ts +72 -17
- package/.pi/harnesses/agent-hub/run-budget.js +12 -13
- package/.pi/harnesses/agent-hub/spawn.ts +14 -2
- package/.pi/harnesses/ask-user-remote/index.ts +59 -4
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
- package/.pi/harnesses/package-lock.json +73 -80
- package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
- package/.versions/1.0.2/.pi/extensions/package.json +9 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.2/.version +1 -0
- package/.versions/1.0.2/agents/architect.md +24 -0
- package/.versions/1.0.2/agents/bowser.md +27 -0
- package/.versions/1.0.2/agents/builder.md +54 -0
- package/.versions/1.0.2/agents/code-reviewer.md +208 -0
- package/.versions/1.0.2/agents/deep-researcher.md +32 -0
- package/.versions/1.0.2/agents/documenter.md +18 -0
- package/.versions/1.0.2/agents/orchestrator.md +20 -0
- package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.2/agents/planner.md +70 -0
- package/.versions/1.0.2/agents/releaser.md +24 -0
- package/.versions/1.0.2/agents/researcher.md +28 -0
- package/.versions/1.0.2/agents/security-auditor.md +167 -0
- package/.versions/1.0.2/agents/test-engineer.md +153 -0
- package/.versions/1.0.2/agents/web-debugger.md +43 -0
- package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
- package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
- package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.2/docs/getting-started.md +98 -0
- package/.versions/1.0.2/docs/npm-install.md +292 -0
- package/.versions/1.0.2/docs/pi-extensions.md +439 -0
- package/.versions/1.0.2/docs/pi-setup.md +74 -0
- package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.2/hermes/README.md +347 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.2/install-manifest.json +2745 -0
- package/.versions/1.0.2/justfile +272 -0
- package/.versions/1.0.2/manifest-meta.json +882 -0
- package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.2/references/definition-of-done.md +67 -0
- package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.2/references/observability-checklist.md +91 -0
- package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.2/references/performance-checklist.md +153 -0
- package/.versions/1.0.2/references/prompting-patterns.md +380 -0
- package/.versions/1.0.2/references/security-checklist.md +179 -0
- package/.versions/1.0.2/references/testing-patterns.md +236 -0
- package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.2/scripts/fleet.ts +185 -0
- package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.2/scripts/team-up.ts +406 -0
- package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +9 -0
- package/README.md +4 -2
- package/agents/orchestrator.md +4 -56
- package/docs/ARCHITECTURE.md +48 -16
- package/docs/agent-fleet-setup.md +33 -2
- package/docs/pi-extensions.md +29 -2
- package/install-manifest.json +2 -2
- package/package.json +2 -2
|
@@ -0,0 +1,474 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Disposable, production-shaped monitor scenario.
|
|
3
|
+
*
|
|
4
|
+
* Every seam here is the real runtime: `MonitorRegistry`, `MonitorSocketServer`,
|
|
5
|
+
* `MonitorEventJournal`, `MonitorInvokeJournal`, the session bridge, the monitor
|
|
6
|
+
* lifecycle, and the production follow-up enqueue seam. There is no hand-stub
|
|
7
|
+
* that can turn an unsupported route into a success.
|
|
8
|
+
*
|
|
9
|
+
* Nothing here proves Gate O, live origin delivery, steering, or surgical
|
|
10
|
+
* runtime use. Recovery mechanics driven through `synthetic-local` commands are
|
|
11
|
+
* a labeled local test boundary, never capability evidence.
|
|
12
|
+
*/
|
|
13
|
+
import { spawn, type ChildProcess } from "node:child_process";
|
|
14
|
+
import * as crypto from "node:crypto";
|
|
15
|
+
import * as fs from "node:fs";
|
|
16
|
+
import * as net from "node:net";
|
|
17
|
+
import * as path from "node:path";
|
|
18
|
+
import { fileURLToPath } from "node:url";
|
|
19
|
+
|
|
20
|
+
import { MonitorRegistry } from "./lib/hermes-monitor-registry.ts";
|
|
21
|
+
import { MonitorSocketServer } from "./lib/hermes-monitor-socket.ts";
|
|
22
|
+
import { FakeHerdrServer } from "./lib/fake-herdr-server.ts";
|
|
23
|
+
import { watchHubMonitor } from "./lib/hermes-monitor-herdr.ts";
|
|
24
|
+
import { createMonitorInvokeAdmission, createWatchdogFollowUpEnqueue } from "../.pi/harnesses/agent-hub/monitor-invoke.ts";
|
|
25
|
+
import { MonitorInvokeJournal } from "../.pi/harnesses/agent-hub/monitor-invoke-journal.ts";
|
|
26
|
+
import { createViewerGatedMonitor } from "../.pi/harnesses/agent-hub/monitor-publisher.ts";
|
|
27
|
+
import { createMonitorSessionBridge } from "../.pi/harnesses/agent-hub/monitor-session-bridge.ts";
|
|
28
|
+
import { MonitorRuntime } from "../.pi/harnesses/agent-hub/monitor-runtime.ts";
|
|
29
|
+
import { MonitorEventJournal } from "../.pi/harnesses/lib/hermes-monitor-events.ts";
|
|
30
|
+
|
|
31
|
+
const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
|
|
32
|
+
const WATCHER_ENTRYPOINT = path.join(repoRoot, "hermes", "skills", "hub-watchdog", "scripts", "watchdog.py");
|
|
33
|
+
|
|
34
|
+
const HUB_INSTANCE_ID = "hub";
|
|
35
|
+
const PROFILE_ID = "scenario";
|
|
36
|
+
const UDS_TIMEOUT_MS = 1_000;
|
|
37
|
+
const DEFAULT_WAIT_TIMEOUT_MS = 5_000;
|
|
38
|
+
// Polling a busy UDS every 5ms can starve the real Python child's 2s long-poll
|
|
39
|
+
// from being scheduled during owner rollover. This is only a test barrier; the
|
|
40
|
+
// watcher's production events() cycle remains 2s.
|
|
41
|
+
const WAIT_POLL_MS = 25;
|
|
42
|
+
|
|
43
|
+
export type WatcherChild = {
|
|
44
|
+
child: ChildProcess;
|
|
45
|
+
stateDir: string;
|
|
46
|
+
auditPath: string;
|
|
47
|
+
stdout: string[];
|
|
48
|
+
stderr: string[];
|
|
49
|
+
exit: Promise<{ code: number | null; signal: NodeJS.Signals | null }>;
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
export type Scenario = {
|
|
53
|
+
root: string;
|
|
54
|
+
tasks: Map<string, any>;
|
|
55
|
+
visible: boolean;
|
|
56
|
+
counters: { polls: number; outputs: number };
|
|
57
|
+
bridge?: any;
|
|
58
|
+
registration?: any;
|
|
59
|
+
server?: any;
|
|
60
|
+
herdr?: any;
|
|
61
|
+
hybrid?: any;
|
|
62
|
+
viewer?: any;
|
|
63
|
+
statuses: any[];
|
|
64
|
+
outputs: any[];
|
|
65
|
+
clock: any;
|
|
66
|
+
disposables: Set<() => any>;
|
|
67
|
+
/** Follow-ups rendered by the production seam, in order. */
|
|
68
|
+
followUps: Array<{ message: any; options: any }>;
|
|
69
|
+
/** Queue depth the invoke admission reads; raise it to force `queue_full`. */
|
|
70
|
+
queueDepth: number;
|
|
71
|
+
queueLimit: number;
|
|
72
|
+
/** Real disposable child processes standing in for native specialists. */
|
|
73
|
+
natives: Map<string, { child: ChildProcess; exit: Promise<number | null> }>;
|
|
74
|
+
cancels: Array<{ taskId: string; generation: number }>;
|
|
75
|
+
watcher?: WatcherChild;
|
|
76
|
+
eventJournal?: MonitorEventJournal;
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
export function createScenario(root: string, options: any = {}): Scenario {
|
|
80
|
+
root = path.resolve(root);
|
|
81
|
+
if (root === path.parse(root).root) throw Error("owned scenario root required");
|
|
82
|
+
fs.mkdirSync(root, { recursive: true, mode: 0o700 });
|
|
83
|
+
fs.chmodSync(root, 0o700);
|
|
84
|
+
return {
|
|
85
|
+
root,
|
|
86
|
+
tasks: new Map(),
|
|
87
|
+
visible: false,
|
|
88
|
+
counters: { polls: 0, outputs: 0 },
|
|
89
|
+
statuses: [],
|
|
90
|
+
outputs: [],
|
|
91
|
+
clock: options.clock ?? { setInterval, clearInterval, setTimeout, clearTimeout, now: Date.now },
|
|
92
|
+
disposables: new Set(),
|
|
93
|
+
followUps: [],
|
|
94
|
+
queueDepth: 0,
|
|
95
|
+
queueLimit: options.queueLimit ?? 1,
|
|
96
|
+
natives: new Map(),
|
|
97
|
+
cancels: [],
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** Register cleanup exactly once; repeated `stop-owned` runs stay idempotent. */
|
|
102
|
+
export function registerDisposable(s: Scenario, dispose: () => any) {
|
|
103
|
+
let done = false;
|
|
104
|
+
s.disposables.add(async () => {
|
|
105
|
+
if (done) return;
|
|
106
|
+
done = true;
|
|
107
|
+
await dispose();
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Poll a condition instead of sleeping. Every scenario barrier goes through
|
|
113
|
+
* this so a loaded machine slows the test down rather than flaking it.
|
|
114
|
+
*/
|
|
115
|
+
export async function waitFor(
|
|
116
|
+
predicate: () => boolean | Promise<boolean>,
|
|
117
|
+
options: { label?: string; timeoutMs?: number } = {},
|
|
118
|
+
): Promise<void> {
|
|
119
|
+
const timeoutMs = options.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
|
|
120
|
+
const deadline = Date.now() + timeoutMs;
|
|
121
|
+
for (;;) {
|
|
122
|
+
if (await predicate()) return;
|
|
123
|
+
if (Date.now() >= deadline) throw Error(`timed out waiting for ${options.label ?? "condition"} after ${timeoutMs}ms`);
|
|
124
|
+
await new Promise(resolve => setTimeout(resolve, WAIT_POLL_MS));
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
function uds(socketPath: string, frame: any): Promise<any> {
|
|
129
|
+
return new Promise((resolve, reject) => {
|
|
130
|
+
let text = "";
|
|
131
|
+
const client = net.createConnection(socketPath);
|
|
132
|
+
client.setTimeout(UDS_TIMEOUT_MS, () => client.destroy(Error("scenario timeout")));
|
|
133
|
+
client.on("connect", () => client.end(JSON.stringify(frame) + "\n"));
|
|
134
|
+
client.on("data", chunk => { text += chunk; });
|
|
135
|
+
client.on("close", () => resolve(text ? JSON.parse(text) : null));
|
|
136
|
+
client.on("error", reject);
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** sha256 of the hub instance id — the namespace directory the watcher reads. */
|
|
141
|
+
export function hubKeyFor(hubInstanceId: string = HUB_INSTANCE_ID): string {
|
|
142
|
+
return crypto.createHash("sha256").update(hubInstanceId).digest("hex");
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
// ── serve ────────────────────────────────────────────────────────────────────
|
|
146
|
+
|
|
147
|
+
function buildRegistration(s: Scenario) {
|
|
148
|
+
const profile = path.join(s.root, "profile");
|
|
149
|
+
fs.mkdirSync(profile, { recursive: true, mode: 0o700 });
|
|
150
|
+
|
|
151
|
+
const journal = new MonitorEventJournal({ file: path.join(s.root, "events.ndjson"), now: () => new Date(s.clock.now()) });
|
|
152
|
+
const bridge = createMonitorSessionBridge({
|
|
153
|
+
now: () => new Date(s.clock.now()),
|
|
154
|
+
events: journal,
|
|
155
|
+
runtime: new MonitorRuntime({ runtimeDir: s.root, profileId: PROFILE_ID, hubInstanceId: HUB_INSTANCE_ID }),
|
|
156
|
+
});
|
|
157
|
+
const registration: any = new MonitorRegistry({ runtimeDir: s.root }).register({
|
|
158
|
+
profilePath: profile,
|
|
159
|
+
profileId: PROFILE_ID,
|
|
160
|
+
hubInstanceId: HUB_INSTANCE_ID,
|
|
161
|
+
snapshot: () => bridge.snapshot(),
|
|
162
|
+
});
|
|
163
|
+
bridge.setEventIdentity({ profileKey: registration.profileKey, hubInstanceId: HUB_INSTANCE_ID });
|
|
164
|
+
bridge.setCurrentOwner({
|
|
165
|
+
ownerSessionId: registration.ownerId,
|
|
166
|
+
ownerLeaseExpiresAt: registration.leaseExpiresAt,
|
|
167
|
+
updateActive: true,
|
|
168
|
+
});
|
|
169
|
+
|
|
170
|
+
const invokeJournal = new MonitorInvokeJournal(path.join(s.root, "invokes.ndjson"));
|
|
171
|
+
registration.output = (request: any) => { s.counters.outputs++; return bridge.readOutput(request); };
|
|
172
|
+
registration.events = (request: any) => journal.replay(request.afterSequence, request.limit, request.waitMs, request.signal);
|
|
173
|
+
registration.cancel = (request: any) => cancelNative(s, request);
|
|
174
|
+
registration.invoke = createMonitorInvokeAdmission({
|
|
175
|
+
journal: invokeJournal,
|
|
176
|
+
task: (id: string, generation: number) => bridge.snapshot().tasks.find((task: any) => task.id === id && task.generation === generation),
|
|
177
|
+
owner: () => registration.ownerId,
|
|
178
|
+
queueDepth: () => s.queueDepth,
|
|
179
|
+
queueLimit: s.queueLimit,
|
|
180
|
+
// The one production seam: the same renderer `index.ts` uses.
|
|
181
|
+
enqueue: createWatchdogFollowUpEnqueue((message, options) => { s.followUps.push({ message, options }); }),
|
|
182
|
+
publish: (kind: any, task: any) => bridge.publishEvent(kind, task),
|
|
183
|
+
});
|
|
184
|
+
|
|
185
|
+
return { bridge, registration, journal };
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
async function serve(s: Scenario) {
|
|
189
|
+
if (s.server) return { socketPath: s.registration.socketPath };
|
|
190
|
+
const { bridge, registration, journal } = buildRegistration(s);
|
|
191
|
+
const server = new MonitorSocketServer(registration);
|
|
192
|
+
await server.listen();
|
|
193
|
+
|
|
194
|
+
s.bridge = bridge;
|
|
195
|
+
s.registration = registration;
|
|
196
|
+
s.server = server;
|
|
197
|
+
s.eventJournal = journal;
|
|
198
|
+
s.herdr = await FakeHerdrServer.start({ paneId: "pane", workspaceId: "workspace", resyncOutput: { sequence: 1, text: "resync" } });
|
|
199
|
+
|
|
200
|
+
const env: any = { HERDR_ENV: "1", HERDR_PANE_ID: "pane", HERDR_SOCKET_PATH: s.herdr.socketPath };
|
|
201
|
+
s.hybrid = watchHubMonitor({
|
|
202
|
+
env,
|
|
203
|
+
reconnectDelayMs: 1,
|
|
204
|
+
onStatus: (value: any) => s.statuses.push(value),
|
|
205
|
+
onOutput: (value: any) => s.outputs.push(value),
|
|
206
|
+
});
|
|
207
|
+
s.viewer = createViewerGatedMonitor({
|
|
208
|
+
pollMetadata: async () => { s.counters.polls++; return []; },
|
|
209
|
+
fetchOutput: async () => ({ sequence: 0 }),
|
|
210
|
+
intervalMs: 1,
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
registerDisposable(s, () => s.hybrid?.close());
|
|
214
|
+
registerDisposable(s, () => s.viewer?.stop());
|
|
215
|
+
registerDisposable(s, () => s.herdr?.close());
|
|
216
|
+
registerDisposable(s, () => stopWatcher(s));
|
|
217
|
+
registerDisposable(s, () => stopNatives(s));
|
|
218
|
+
// Owns whichever registration is current at teardown, so an owner rollover
|
|
219
|
+
// never leaves a second disposable trying to close an already-closed server.
|
|
220
|
+
registerDisposable(s, () => closeCurrentRegistration(s));
|
|
221
|
+
|
|
222
|
+
return { socketPath: registration.socketPath, token: registration.token };
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
async function closeCurrentRegistration(s: Scenario) {
|
|
226
|
+
const server = s.server;
|
|
227
|
+
const registration = s.registration;
|
|
228
|
+
s.server = null;
|
|
229
|
+
s.registration = undefined;
|
|
230
|
+
if (server) await server.close();
|
|
231
|
+
registration?.cleanup?.();
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/** Re-register under a fresh owner so consumers must rediscover token and socket. */
|
|
235
|
+
async function rollOwner(s: Scenario) {
|
|
236
|
+
if (!s.server) throw Error("serve first");
|
|
237
|
+
const previousSocket = s.registration.socketPath;
|
|
238
|
+
await closeCurrentRegistration(s);
|
|
239
|
+
// Explicit release gate: never publish a replacement until the old owned
|
|
240
|
+
// socket has been released, regardless of a loaded watcher's long-poll.
|
|
241
|
+
await waitFor(() => !fs.existsSync(previousSocket), { label: "previous owner socket release" });
|
|
242
|
+
const { bridge, registration, journal } = buildRegistration(s);
|
|
243
|
+
const server = new MonitorSocketServer(registration);
|
|
244
|
+
await server.listen();
|
|
245
|
+
s.bridge = bridge;
|
|
246
|
+
s.registration = registration;
|
|
247
|
+
s.server = server;
|
|
248
|
+
s.eventJournal = journal;
|
|
249
|
+
return { ownerId: registration.ownerId, socketPath: registration.socketPath };
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
// ── real disposable native children ──────────────────────────────────────────
|
|
253
|
+
|
|
254
|
+
/** A real child process that idles until it is signalled — never a stub. */
|
|
255
|
+
function startNative(s: Scenario, id: string, generation: number) {
|
|
256
|
+
const key = `${id}:${generation}`;
|
|
257
|
+
if (s.natives.has(key)) throw Error(`native ${key} already running`);
|
|
258
|
+
const child = spawn(process.execPath, ["-e", "setInterval(() => {}, 1000)"], { stdio: "ignore" });
|
|
259
|
+
const exit = new Promise<number | null>(resolve => child.once("close", code => resolve(code)));
|
|
260
|
+
s.natives.set(key, { child, exit });
|
|
261
|
+
return { pid: child.pid, key };
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
/** Cancel only the exact task/generation the request names. */
|
|
265
|
+
async function cancelNative(s: Scenario, request: { taskId: string; generation: number }) {
|
|
266
|
+
s.cancels.push({ taskId: request.taskId, generation: request.generation });
|
|
267
|
+
const key = `${request.taskId}:${request.generation}`;
|
|
268
|
+
const native = s.natives.get(key);
|
|
269
|
+
if (!native) return { cancelled: false, reason: "unsupported" };
|
|
270
|
+
native.child.kill("SIGTERM");
|
|
271
|
+
await native.exit;
|
|
272
|
+
s.natives.delete(key);
|
|
273
|
+
s.bridge?.finishChild?.(request.taskId, "cancelled");
|
|
274
|
+
return { cancelled: true, state: "cancelled" };
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
async function stopNatives(s: Scenario) {
|
|
278
|
+
for (const [, native] of s.natives) {
|
|
279
|
+
native.child.kill("SIGKILL");
|
|
280
|
+
await native.exit;
|
|
281
|
+
}
|
|
282
|
+
s.natives.clear();
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
// ── real foreground watcher child ────────────────────────────────────────────
|
|
286
|
+
|
|
287
|
+
/**
|
|
288
|
+
* Launch the shipped `watchdog.py watch` process as a real foreground child with
|
|
289
|
+
* a disposable HOME/XDG/profile/runtime environment and Gate O absent. It runs
|
|
290
|
+
* in `observe` mode, so it may only read events and journal them.
|
|
291
|
+
*/
|
|
292
|
+
function startWatcher(s: Scenario, options: { autonomy?: string } = {}): WatcherChild {
|
|
293
|
+
if (s.watcher) throw Error("watcher already running");
|
|
294
|
+
if (!s.registration) throw Error("serve first");
|
|
295
|
+
const home = path.join(s.root, "watcher-home");
|
|
296
|
+
const stateDir = path.join(s.root, "watcher-state");
|
|
297
|
+
const lockDir = path.join(s.root, "watcher-lock");
|
|
298
|
+
for (const directory of [home, stateDir, lockDir]) fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
299
|
+
|
|
300
|
+
const invocation = {
|
|
301
|
+
// Gate O is deliberately absent: no `gateO` key at all.
|
|
302
|
+
autonomy: options.autonomy ?? "observe",
|
|
303
|
+
maximumAutonomy: "observe",
|
|
304
|
+
profileId: PROFILE_ID,
|
|
305
|
+
profileKey: s.registration.profileKey,
|
|
306
|
+
hubKey: hubKeyFor(),
|
|
307
|
+
hubInstanceId: HUB_INSTANCE_ID,
|
|
308
|
+
runtimeDir: s.root,
|
|
309
|
+
stateDir,
|
|
310
|
+
lockDir,
|
|
311
|
+
};
|
|
312
|
+
const child = spawn("python3", [WATCHER_ENTRYPOINT, "watch", "--invocation-json", JSON.stringify(invocation)], {
|
|
313
|
+
cwd: path.dirname(WATCHER_ENTRYPOINT),
|
|
314
|
+
env: {
|
|
315
|
+
PATH: process.env.PATH ?? "",
|
|
316
|
+
HOME: home,
|
|
317
|
+
XDG_STATE_HOME: path.join(home, "state"),
|
|
318
|
+
XDG_RUNTIME_DIR: lockDir,
|
|
319
|
+
PYTHONDONTWRITEBYTECODE: "1",
|
|
320
|
+
},
|
|
321
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
322
|
+
});
|
|
323
|
+
const stdout: string[] = [];
|
|
324
|
+
const stderr: string[] = [];
|
|
325
|
+
child.stdout?.on("data", chunk => stdout.push(String(chunk)));
|
|
326
|
+
child.stderr?.on("data", chunk => stderr.push(String(chunk)));
|
|
327
|
+
const exit = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>(resolve =>
|
|
328
|
+
child.once("close", (code, signal) => resolve({ code, signal })));
|
|
329
|
+
|
|
330
|
+
// The watcher scopes its private state by a hash of the profile id, never the
|
|
331
|
+
// raw name, so the audit path has to be derived the same way.
|
|
332
|
+
const profileRoot = crypto.createHash("sha256").update(PROFILE_ID).digest("hex");
|
|
333
|
+
s.watcher = {
|
|
334
|
+
child,
|
|
335
|
+
stateDir,
|
|
336
|
+
auditPath: path.join(stateDir, "agent-fleet", "hermes-watchdog", profileRoot, "audit.ndjson"),
|
|
337
|
+
stdout,
|
|
338
|
+
stderr,
|
|
339
|
+
exit,
|
|
340
|
+
};
|
|
341
|
+
return s.watcher;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/** Every audit decision the watcher has journaled so far. */
|
|
345
|
+
export function watcherAudit(s: Scenario): any[] {
|
|
346
|
+
const watcher = s.watcher;
|
|
347
|
+
if (!watcher || !fs.existsSync(watcher.auditPath)) return [];
|
|
348
|
+
return fs.readFileSync(watcher.auditPath, "utf8")
|
|
349
|
+
.split("\n")
|
|
350
|
+
.filter(Boolean)
|
|
351
|
+
.map(line => JSON.parse(line));
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
/** SIGINT the watcher and wait for it to release its lock and exit. */
|
|
355
|
+
async function stopWatcher(s: Scenario) {
|
|
356
|
+
const watcher = s.watcher;
|
|
357
|
+
if (!watcher) return { stopped: false };
|
|
358
|
+
if (watcher.child.exitCode === null && watcher.child.signalCode === null) watcher.child.kill("SIGINT");
|
|
359
|
+
const result = await watcher.exit;
|
|
360
|
+
s.watcher = undefined;
|
|
361
|
+
return { stopped: true, ...result };
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
/** Any `watch.lock` still present under the watcher's lock root. */
|
|
365
|
+
export function watcherLocks(s: Scenario, lockDir = path.join(s.root, "watcher-lock")): string[] {
|
|
366
|
+
const root = path.join(lockDir, "agent-fleet-hermes-watchdog");
|
|
367
|
+
if (!fs.existsSync(root)) return [];
|
|
368
|
+
const found: string[] = [];
|
|
369
|
+
const visit = (directory: string) => {
|
|
370
|
+
for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
|
|
371
|
+
const full = path.join(directory, entry.name);
|
|
372
|
+
if (entry.isDirectory()) visit(full);
|
|
373
|
+
else if (entry.name === "watch.lock") found.push(full);
|
|
374
|
+
}
|
|
375
|
+
};
|
|
376
|
+
visit(root);
|
|
377
|
+
return found;
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
// ── apply ────────────────────────────────────────────────────────────────────
|
|
381
|
+
|
|
382
|
+
async function apply(s: Scenario, args: string[]) {
|
|
383
|
+
if (args[0] === "status") { s.herdr.emitStatus(); return true; }
|
|
384
|
+
if (args[0] === "disconnect") { s.herdr.disconnectSubscribers(); return true; }
|
|
385
|
+
if (args[0] === "reconnect") { s.herdr.setWorkspaceId(args[1] ?? "workspace"); s.herdr.emitStatus(); return true; }
|
|
386
|
+
if (!s.bridge) throw Error("serve first");
|
|
387
|
+
|
|
388
|
+
const [action, id, value] = args;
|
|
389
|
+
if (action === "owner") {
|
|
390
|
+
s.bridge.setCurrentOwner({ ownerSessionId: id, ownerLeaseExpiresAt: value, updateActive: true });
|
|
391
|
+
return true;
|
|
392
|
+
}
|
|
393
|
+
if (action === "parent") return s.bridge.startParent({ id, hubInstanceId: HUB_INSTANCE_ID, checkoutId: PROFILE_ID });
|
|
394
|
+
if (action === "child") {
|
|
395
|
+
return s.bridge.startChild({ key: id, id, generation: 1, parentId: value, parentGeneration: 1, specialist: "fake" }, {});
|
|
396
|
+
}
|
|
397
|
+
if (action === "output" || action === "late") return s.bridge.appendOutput(id, value ?? "");
|
|
398
|
+
if (action === "wait-only") return s.bridge.registerWaitOnly(id, async () => {});
|
|
399
|
+
if (action === "cancel-wait") return s.bridge.cancelWaitOnly(id, { kind: "scenario_cancel" });
|
|
400
|
+
if (action === "evidence-loss") return s.bridge.reconcile({ owner: false, socket: false, session: false, herdr: false });
|
|
401
|
+
if (action === "transition") return s.bridge.finishChild(id, value);
|
|
402
|
+
throw Error("unsupported apply");
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
// ── get ──────────────────────────────────────────────────────────────────────
|
|
406
|
+
|
|
407
|
+
function get(s: Scenario, args: string[]) {
|
|
408
|
+
if (!s.registration) throw Error("serve first");
|
|
409
|
+
const [kind = "snapshot", id, generation = "1", after = "0"] = args;
|
|
410
|
+
const { socketPath, token } = s.registration;
|
|
411
|
+
s.counters.polls++;
|
|
412
|
+
if (kind === "output") {
|
|
413
|
+
return uds(socketPath, { type: "output", token, taskId: id, generation: Number(generation), afterSequence: Number(after) });
|
|
414
|
+
}
|
|
415
|
+
if (kind === "events") {
|
|
416
|
+
return uds(socketPath, { type: "events", token, afterSequence: Number(after), limit: 100, waitMs: 0 });
|
|
417
|
+
}
|
|
418
|
+
if (kind === "invoke") return uds(socketPath, { type: "invoke", token, ...JSON.parse(id!) });
|
|
419
|
+
if (kind === "cancel") return uds(socketPath, { type: "cancel", token, taskId: id, generation: Number(generation) });
|
|
420
|
+
return uds(socketPath, { type: "snapshot", token });
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
// ── command dispatch ─────────────────────────────────────────────────────────
|
|
424
|
+
|
|
425
|
+
export async function execute(s: Scenario, argv: string[]): Promise<any> {
|
|
426
|
+
const [command, ...args] = argv;
|
|
427
|
+
if (!command) throw Error("scenario command required");
|
|
428
|
+
|
|
429
|
+
if (command === "serve") return serve(s);
|
|
430
|
+
if (command === "roll-owner") return rollOwner(s);
|
|
431
|
+
if (command === "apply") return apply(s, args);
|
|
432
|
+
if (command === "get") return get(s, args);
|
|
433
|
+
|
|
434
|
+
if (command === "watcher") {
|
|
435
|
+
if (args[0] === "start") return startWatcher(s, { autonomy: args[1] });
|
|
436
|
+
if (args[0] === "audit") return watcherAudit(s);
|
|
437
|
+
if (args[0] === "stop") return stopWatcher(s);
|
|
438
|
+
if (args[0] === "locks") return watcherLocks(s);
|
|
439
|
+
throw Error("unsupported watcher command");
|
|
440
|
+
}
|
|
441
|
+
if (command === "native") {
|
|
442
|
+
if (args[0] === "start") return startNative(s, args[1]!, Number(args[2] ?? 1));
|
|
443
|
+
if (args[0] === "alive") return s.natives.has(`${args[1]}:${args[2] ?? 1}`);
|
|
444
|
+
throw Error("unsupported native command");
|
|
445
|
+
}
|
|
446
|
+
if (command === "queue") { s.queueDepth = Number(args[0]); return { queueDepth: s.queueDepth, queueLimit: s.queueLimit }; }
|
|
447
|
+
if (command === "follow-ups") return s.followUps;
|
|
448
|
+
if (command === "cancels") return s.cancels;
|
|
449
|
+
|
|
450
|
+
if (command === "visibility") {
|
|
451
|
+
s.visible = args[0] === "show";
|
|
452
|
+
s.viewer?.setViewers(s.visible ? 1 : 0);
|
|
453
|
+
return { visible: s.visible };
|
|
454
|
+
}
|
|
455
|
+
if (command === "counters") {
|
|
456
|
+
return { ...s.counters, statuses: s.statuses.length, outputs: s.outputs.length, subscriptions: s.herdr?.subscriptionCount() ?? 0 };
|
|
457
|
+
}
|
|
458
|
+
if (command === "wait") return s.bridge?.snapshot() ?? [];
|
|
459
|
+
if (command === "assert") {
|
|
460
|
+
if (args[0] !== "visible" || String(s.visible) !== args[1]) throw Error("assertion failed");
|
|
461
|
+
return true;
|
|
462
|
+
}
|
|
463
|
+
if (command === "stop-owned") {
|
|
464
|
+
for (const dispose of [...s.disposables]) await dispose();
|
|
465
|
+
s.disposables.clear();
|
|
466
|
+
s.server = null;
|
|
467
|
+
return true;
|
|
468
|
+
}
|
|
469
|
+
if (command === "wait-owned") {
|
|
470
|
+
if (s.disposables.size) throw Error("owned handles remain");
|
|
471
|
+
return { live: false, handles: 0 };
|
|
472
|
+
}
|
|
473
|
+
throw Error("unsupported scenario command");
|
|
474
|
+
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
export interface GateOArtifact {
|
|
2
|
+
api?: { kind?: string; name?: string; argumentShape?: string };
|
|
3
|
+
observations?: Record<string, unknown>;
|
|
4
|
+
evidenceIds?: unknown;
|
|
5
|
+
unsupported?: unknown;
|
|
6
|
+
synthetic?: unknown;
|
|
7
|
+
/** Set only by a disposable live run; schema validation never derives this. */
|
|
8
|
+
originDelivery?: unknown;
|
|
9
|
+
liveRunId?: unknown;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export interface GateOValidation {
|
|
13
|
+
artifactValid: boolean;
|
|
14
|
+
originDelivery: boolean;
|
|
15
|
+
disposition: "origin-delivery-enabled" | "journal-only-no-steering";
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
const SECRET = /(?:token|bearer|secret|password|authorization|api[_-]?key)\s*[=:]/i;
|
|
19
|
+
const safeText = (value: unknown, maximum: number) => typeof value === "string" && value === value.trim() && value.length > 0 && value.length <= maximum && !SECRET.test(value);
|
|
20
|
+
const REQUIRED_OBSERVATIONS = ["opaqueOrigin", "threeIncrementalUpdates", "wakeReconnect", "profileIsolation", "twoChatIsolation", "structuredInvocation"];
|
|
21
|
+
|
|
22
|
+
/** Validates a sanitized *live* artifact. It never probes, sends, or enables a route itself. */
|
|
23
|
+
export function validateGateOArtifact(value: unknown): GateOValidation {
|
|
24
|
+
const artifact = value as GateOArtifact | null;
|
|
25
|
+
const api = artifact?.api;
|
|
26
|
+
const observations = artifact?.observations;
|
|
27
|
+
const evidenceIds = artifact?.evidenceIds;
|
|
28
|
+
const evidenceSafe = Array.isArray(evidenceIds) && evidenceIds.length >= 2 && evidenceIds.every(id => safeText(id, 256));
|
|
29
|
+
const apiSafe = safeText(api?.kind, 64) && safeText(api?.name, 128) && !/\bsend\s+--to\b/i.test(api.name) && safeText(api?.argumentShape, 256);
|
|
30
|
+
const observed = !!observations && REQUIRED_OBSERVATIONS.every(key => observations[key] === true);
|
|
31
|
+
const artifactValid = !!artifact && artifact.unsupported !== true && artifact.synthetic !== true && apiSafe && observed && evidenceSafe;
|
|
32
|
+
// This assertion is recorded by a disposable live run. A valid document alone is never capability proof.
|
|
33
|
+
const originDelivery = artifactValid && artifact?.originDelivery === true && safeText(artifact.liveRunId, 256);
|
|
34
|
+
return { artifactValid, originDelivery, disposition: originDelivery ? "origin-delivery-enabled" : "journal-only-no-steering" };
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
if (process.argv[1] && import.meta.url === new URL(`file://${process.argv[1]}`).href) {
|
|
38
|
+
let input = "";
|
|
39
|
+
process.stdin.setEncoding("utf8");
|
|
40
|
+
process.stdin.on("data", chunk => { input += chunk; });
|
|
41
|
+
process.stdin.on("end", () => {
|
|
42
|
+
try { console.log(JSON.stringify(validateGateOArtifact(JSON.parse(input)))); }
|
|
43
|
+
catch { console.log(JSON.stringify(validateGateOArtifact(undefined))); process.exitCode = 2; }
|
|
44
|
+
});
|
|
45
|
+
}
|