@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,413 @@
|
|
|
1
|
+
// scripts/coms-hermes-bridge.ts
|
|
2
|
+
//
|
|
3
|
+
// Hermes/Telegram user-remote bridge daemon. Registers a coms peer, turns
|
|
4
|
+
// prompt envelopes into `hermes send` messages, watches the private answer-file
|
|
5
|
+
// wire, and replies to the sender with the mapped answer/error envelope.
|
|
6
|
+
|
|
7
|
+
import { spawn } from "node:child_process";
|
|
8
|
+
import * as fs from "node:fs";
|
|
9
|
+
import * as path from "node:path";
|
|
10
|
+
import { fileURLToPath } from "node:url";
|
|
11
|
+
|
|
12
|
+
import {
|
|
13
|
+
bindEndpoint,
|
|
14
|
+
ensureComsDirs,
|
|
15
|
+
isCancelEnvelope,
|
|
16
|
+
isPromptEnvelope,
|
|
17
|
+
makeConnHandler,
|
|
18
|
+
makeEndpoint,
|
|
19
|
+
makeResponseEnvelope,
|
|
20
|
+
nowIso,
|
|
21
|
+
removeRegistryEntry,
|
|
22
|
+
resolveUniqueName,
|
|
23
|
+
sendEnvelope,
|
|
24
|
+
ulid,
|
|
25
|
+
writeAck,
|
|
26
|
+
writeNack,
|
|
27
|
+
writeRegistryAtomic,
|
|
28
|
+
type AgentCard,
|
|
29
|
+
type PromptEnvelope,
|
|
30
|
+
type RegistryEntry,
|
|
31
|
+
type SenderIdentity,
|
|
32
|
+
} from "./lib/coms-envelope.ts";
|
|
33
|
+
import {
|
|
34
|
+
formatTelegramQuestion,
|
|
35
|
+
isValidQid,
|
|
36
|
+
logPath as defaultLogPath,
|
|
37
|
+
makeLogRecord,
|
|
38
|
+
mapAnswerToAskResponse,
|
|
39
|
+
qidFromPromptEnvelope,
|
|
40
|
+
questionsDir as defaultQuestionsDir,
|
|
41
|
+
renderLogRecord,
|
|
42
|
+
timeoutMsFromEnv,
|
|
43
|
+
timeoutOutcome,
|
|
44
|
+
validateAnswerFile,
|
|
45
|
+
type BridgeEventName,
|
|
46
|
+
type QuestionOption,
|
|
47
|
+
type QuestionState,
|
|
48
|
+
} from "./lib/hermes-bridge-core.ts";
|
|
49
|
+
|
|
50
|
+
const KEEPALIVE_MS = 30_000;
|
|
51
|
+
const DEFAULT_POLL_MS = 1_000;
|
|
52
|
+
const COLOR = "#38BDF8";
|
|
53
|
+
const DEFAULT_NAME = "user-remote";
|
|
54
|
+
const DEFAULT_PURPOSE = "Remote human via Hermes/Telegram";
|
|
55
|
+
const HERMES_PROFILE_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
|
|
56
|
+
|
|
57
|
+
interface PendingQuestion {
|
|
58
|
+
env: PromptEnvelope;
|
|
59
|
+
state: QuestionState;
|
|
60
|
+
options: QuestionOption[];
|
|
61
|
+
timer: NodeJS.Timeout;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
interface ParsedPrompt {
|
|
65
|
+
question: string;
|
|
66
|
+
context?: string;
|
|
67
|
+
options: QuestionOption[];
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
function flagValue(argv: string[], flag: string): string | null {
|
|
71
|
+
const positions = argv.flatMap((arg, index) => arg === flag ? [index] : []);
|
|
72
|
+
if (positions.length > 1) die(`${flag} may only be specified once`);
|
|
73
|
+
const i = positions[0] ?? -1;
|
|
74
|
+
return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function die(msg: string): never {
|
|
78
|
+
console.error(`coms-hermes-bridge: ${msg}`);
|
|
79
|
+
process.exit(1);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function parsePrompt(env: PromptEnvelope): ParsedPrompt {
|
|
83
|
+
try {
|
|
84
|
+
const parsed = JSON.parse(env.prompt) as { question?: unknown; context?: unknown; options?: unknown };
|
|
85
|
+
if (parsed && typeof parsed === "object" && typeof parsed.question === "string") {
|
|
86
|
+
const rawOptions = Array.isArray(parsed.options) ? parsed.options : [];
|
|
87
|
+
const options = rawOptions
|
|
88
|
+
.map((option): QuestionOption | null => {
|
|
89
|
+
if (typeof option === "string") return { title: option };
|
|
90
|
+
if (option && typeof option === "object" && typeof (option as { title?: unknown }).title === "string") {
|
|
91
|
+
const desc = (option as { description?: unknown }).description;
|
|
92
|
+
return typeof desc === "string"
|
|
93
|
+
? { title: (option as { title: string }).title, description: desc }
|
|
94
|
+
: { title: (option as { title: string }).title };
|
|
95
|
+
}
|
|
96
|
+
return null;
|
|
97
|
+
})
|
|
98
|
+
.filter((option): option is QuestionOption => option !== null);
|
|
99
|
+
const context = typeof parsed.context === "string" && parsed.context.trim() ? parsed.context : undefined;
|
|
100
|
+
return { question: parsed.question, context, options };
|
|
101
|
+
}
|
|
102
|
+
} catch {
|
|
103
|
+
// Plain coms-cli prompts are expected; fall through.
|
|
104
|
+
}
|
|
105
|
+
return {
|
|
106
|
+
question: env.prompt,
|
|
107
|
+
context: `From ${env.sender_name} @ ${env.sender_cwd}`,
|
|
108
|
+
options: [],
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
function appendLogFile(logFile: string, qid: string, event: BridgeEventName, detail?: unknown): void {
|
|
113
|
+
fs.mkdirSync(path.dirname(logFile), { recursive: true });
|
|
114
|
+
fs.appendFileSync(logFile, renderLogRecord(makeLogRecord(qid, event, detail)));
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function appendAnswerRejectLog(logFile: string, qid: string, detail: unknown): void {
|
|
118
|
+
fs.mkdirSync(path.dirname(logFile), { recursive: true });
|
|
119
|
+
fs.appendFileSync(logFile, JSON.stringify({ at: nowIso(), qid, event: "answer_rejected", detail }) + "\n");
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
function hermesSend(to: string, text: string, profile: string | null): Promise<void> {
|
|
123
|
+
return new Promise((resolve, reject) => {
|
|
124
|
+
const args = [...(profile ? ["--profile", profile] : []), "send", "--to", to, text];
|
|
125
|
+
const child = spawn("hermes", args, { stdio: ["ignore", "pipe", "pipe"] });
|
|
126
|
+
let stderr = "";
|
|
127
|
+
let stdout = "";
|
|
128
|
+
child.stdout?.on("data", (chunk) => { stdout += chunk.toString("utf-8"); });
|
|
129
|
+
child.stderr?.on("data", (chunk) => { stderr += chunk.toString("utf-8"); });
|
|
130
|
+
child.once("error", (err) => reject(err));
|
|
131
|
+
child.once("close", (code) => {
|
|
132
|
+
if (code === 0) {
|
|
133
|
+
resolve();
|
|
134
|
+
return;
|
|
135
|
+
}
|
|
136
|
+
const detail = (stderr || stdout).trim();
|
|
137
|
+
reject(new Error(`hermes send failed${code === null ? "" : ` (${code})`}${detail ? `: ${detail}` : ""}`));
|
|
138
|
+
});
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
async function main(): Promise<void> {
|
|
143
|
+
const argv = process.argv.slice(2);
|
|
144
|
+
const requestedName = flagValue(argv, "--name") ?? DEFAULT_NAME;
|
|
145
|
+
const project = flagValue(argv, "--project") ?? "default";
|
|
146
|
+
const to = flagValue(argv, "--to") ?? "telegram";
|
|
147
|
+
const hermesProfile = flagValue(argv, "--hermes-profile");
|
|
148
|
+
const timeoutMs = Number(flagValue(argv, "--timeout") ?? timeoutMsFromEnv());
|
|
149
|
+
const pollMs = Number(flagValue(argv, "--poll-ms") ?? DEFAULT_POLL_MS);
|
|
150
|
+
const qDir = flagValue(argv, "--questions-dir") ?? defaultQuestionsDir();
|
|
151
|
+
const logFile = path.join(path.dirname(qDir), path.basename(defaultLogPath()));
|
|
152
|
+
|
|
153
|
+
if (hermesProfile && (!HERMES_PROFILE_RE.test(hermesProfile) || hermesProfile === "." || hermesProfile.includes(".."))) die("--hermes-profile must be a safe profile name");
|
|
154
|
+
if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) die("--timeout must be a positive number");
|
|
155
|
+
if (!Number.isFinite(pollMs) || pollMs <= 0) die("--poll-ms must be a positive number");
|
|
156
|
+
|
|
157
|
+
ensureComsDirs(project);
|
|
158
|
+
fs.mkdirSync(qDir, { recursive: true });
|
|
159
|
+
fs.mkdirSync(path.dirname(logFile), { recursive: true });
|
|
160
|
+
|
|
161
|
+
const sessionId = ulid();
|
|
162
|
+
const uniqueName = resolveUniqueName(project, requestedName);
|
|
163
|
+
const id: SenderIdentity = {
|
|
164
|
+
session_id: sessionId,
|
|
165
|
+
name: uniqueName,
|
|
166
|
+
endpoint: makeEndpoint(sessionId),
|
|
167
|
+
cwd: process.cwd(),
|
|
168
|
+
};
|
|
169
|
+
const pending = new Map<string, PendingQuestion>();
|
|
170
|
+
const closed = new Map<string, QuestionState>();
|
|
171
|
+
// Answer files the liaison may still be mid-write: an invalid_json file is
|
|
172
|
+
// kept for a short grace window (first-seen timestamps below) instead of
|
|
173
|
+
// being eaten while the write is still in flight.
|
|
174
|
+
const invalidJsonSeen = new Map<string, number>();
|
|
175
|
+
const invalidJsonGraceMs = Math.max(2 * pollMs, 1_000);
|
|
176
|
+
const CLOSED_CAP = 1_000;
|
|
177
|
+
|
|
178
|
+
function markClosed(qid: string, state: QuestionState): void {
|
|
179
|
+
closed.set(qid, state);
|
|
180
|
+
if (closed.size > CLOSED_CAP) {
|
|
181
|
+
const oldest = closed.keys().next().value;
|
|
182
|
+
if (oldest !== undefined) closed.delete(oldest);
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
function queueDepth(): number {
|
|
187
|
+
return pending.size;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
function registryEntry(): RegistryEntry {
|
|
191
|
+
return {
|
|
192
|
+
session_id: sessionId,
|
|
193
|
+
name: uniqueName,
|
|
194
|
+
purpose: DEFAULT_PURPOSE,
|
|
195
|
+
model: "hermes-bridge",
|
|
196
|
+
color: COLOR,
|
|
197
|
+
pid: process.pid,
|
|
198
|
+
endpoint: id.endpoint,
|
|
199
|
+
cwd: id.cwd,
|
|
200
|
+
started_at: nowIso(),
|
|
201
|
+
explicit: false,
|
|
202
|
+
version: 1,
|
|
203
|
+
context_used_pct: 0,
|
|
204
|
+
queue_depth: queueDepth(),
|
|
205
|
+
heartbeat_at: nowIso(),
|
|
206
|
+
};
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
async function sendResponse(env: PromptEnvelope, response: unknown, error: string | null = null): Promise<void> {
|
|
210
|
+
await sendEnvelope(env.sender_endpoint, makeResponseEnvelope(id, env.msg_id, response, error));
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
async function handleTimeout(qid: string): Promise<void> {
|
|
214
|
+
const item = pending.get(qid);
|
|
215
|
+
if (!item) return;
|
|
216
|
+
pending.delete(qid);
|
|
217
|
+
markClosed(qid, "timeout");
|
|
218
|
+
appendLogFile(logFile, qid, "timeout", { timeout_ms: timeoutMs });
|
|
219
|
+
const outcome = timeoutOutcome(qid, timeoutMs);
|
|
220
|
+
await hermesSend(to, outcome.telegramNote, hermesProfile).catch((err) => {
|
|
221
|
+
appendLogFile(logFile, qid, "delivery_error", { phase: "timeout_note", error: err instanceof Error ? err.message : String(err) });
|
|
222
|
+
});
|
|
223
|
+
await sendResponse(item.env, outcome.response, outcome.error).catch((err) => {
|
|
224
|
+
console.error(`coms-hermes-bridge: could not deliver timeout for ${qid}: ${err instanceof Error ? err.message : String(err)}`);
|
|
225
|
+
});
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
async function handlePrompt(env: PromptEnvelope): Promise<void> {
|
|
229
|
+
let qid: string;
|
|
230
|
+
try {
|
|
231
|
+
qid = qidFromPromptEnvelope(env);
|
|
232
|
+
} catch (err) {
|
|
233
|
+
await sendResponse(env, null, err instanceof Error ? err.message : String(err)).catch(() => {});
|
|
234
|
+
return;
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
const parsed = parsePrompt(env);
|
|
238
|
+
const duplicate = pending.get(qid);
|
|
239
|
+
if (duplicate) clearTimeout(duplicate.timer);
|
|
240
|
+
appendLogFile(logFile, qid, "question_received", { from: env.sender_name });
|
|
241
|
+
const timer = setTimeout(() => { void handleTimeout(qid); }, timeoutMs);
|
|
242
|
+
timer.unref?.();
|
|
243
|
+
pending.set(qid, { env, state: "pending", options: parsed.options, timer });
|
|
244
|
+
|
|
245
|
+
try {
|
|
246
|
+
await hermesSend(to, formatTelegramQuestion({
|
|
247
|
+
qid,
|
|
248
|
+
project,
|
|
249
|
+
question: parsed.question,
|
|
250
|
+
context: parsed.context,
|
|
251
|
+
options: parsed.options,
|
|
252
|
+
}), hermesProfile);
|
|
253
|
+
const item = pending.get(qid);
|
|
254
|
+
if (!item) return;
|
|
255
|
+
item.state = "delivered";
|
|
256
|
+
appendLogFile(logFile, qid, "delivered", { to });
|
|
257
|
+
} catch (err) {
|
|
258
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
259
|
+
const item = pending.get(qid);
|
|
260
|
+
if (item) {
|
|
261
|
+
clearTimeout(item.timer);
|
|
262
|
+
pending.delete(qid);
|
|
263
|
+
}
|
|
264
|
+
appendLogFile(logFile, qid, "delivery_error", { error: message });
|
|
265
|
+
await sendResponse(env, null, message).catch((sendErr) => {
|
|
266
|
+
console.error(`coms-hermes-bridge: could not deliver error for ${qid}: ${sendErr instanceof Error ? sendErr.message : String(sendErr)}`);
|
|
267
|
+
});
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
async function handleCancel(refMsgId: string): Promise<void> {
|
|
272
|
+
if (!isValidQid(refMsgId)) return;
|
|
273
|
+
const item = pending.get(refMsgId);
|
|
274
|
+
if (!item) return;
|
|
275
|
+
clearTimeout(item.timer);
|
|
276
|
+
pending.delete(refMsgId);
|
|
277
|
+
markClosed(refMsgId, "cancelled");
|
|
278
|
+
appendLogFile(logFile, refMsgId, "cancelled", { reason: "cancel envelope" });
|
|
279
|
+
await hermesSend(to, `✖ [HUB-Q:${refMsgId}] The question was cancelled — it was answered from the console.`, hermesProfile).catch((err) => {
|
|
280
|
+
appendLogFile(logFile, refMsgId, "delivery_error", { phase: "cancel_note", error: err instanceof Error ? err.message : String(err) });
|
|
281
|
+
});
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
async function handleLateAnswer(qid: string): Promise<void> {
|
|
285
|
+
appendLogFile(logFile, qid, "late_answer", { state: closed.get(qid) ?? "unknown" });
|
|
286
|
+
await hermesSend(to, `ℹ [HUB-Q:${qid}] This question is already closed; the late answer was ignored.`, hermesProfile).catch((err) => {
|
|
287
|
+
appendLogFile(logFile, qid, "delivery_error", { phase: "late_note", error: err instanceof Error ? err.message : String(err) });
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
async function consumeAnswerFile(file: string): Promise<void> {
|
|
292
|
+
const full = path.join(qDir, file);
|
|
293
|
+
let raw: string;
|
|
294
|
+
try {
|
|
295
|
+
raw = fs.readFileSync(full, "utf-8");
|
|
296
|
+
} catch {
|
|
297
|
+
return;
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
const qidFromName = file.endsWith(".answer.json") ? file.slice(0, -".answer.json".length) : file;
|
|
301
|
+
if (isValidQid(qidFromName) && closed.has(qidFromName)) {
|
|
302
|
+
invalidJsonSeen.delete(file);
|
|
303
|
+
try { fs.unlinkSync(full); } catch { /* ignore */ }
|
|
304
|
+
await handleLateAnswer(qidFromName);
|
|
305
|
+
return;
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
const validation = validateAnswerFile(raw, full, pending.keys());
|
|
309
|
+
if (!validation.ok) {
|
|
310
|
+
if (validation.reason === "invalid_json") {
|
|
311
|
+
// Possibly a partial write from the liaison; retry until the grace expires.
|
|
312
|
+
const firstSeen = invalidJsonSeen.get(file);
|
|
313
|
+
if (firstSeen === undefined) {
|
|
314
|
+
invalidJsonSeen.set(file, Date.now());
|
|
315
|
+
return;
|
|
316
|
+
}
|
|
317
|
+
if (Date.now() - firstSeen < invalidJsonGraceMs) return;
|
|
318
|
+
}
|
|
319
|
+
invalidJsonSeen.delete(file);
|
|
320
|
+
const logQid = validation.qid && isValidQid(validation.qid) ? validation.qid : (isValidQid(qidFromName) ? qidFromName : "00000000000000000000000000");
|
|
321
|
+
// Remove the rejected file before publishing the event. Consumers use the
|
|
322
|
+
// log as the completion signal and may immediately write a corrected file
|
|
323
|
+
// at the same path; logging first lets this scan delete that replacement.
|
|
324
|
+
try { fs.unlinkSync(full); } catch { /* ignore */ }
|
|
325
|
+
appendAnswerRejectLog(logFile, logQid, { reason: validation.reason, file });
|
|
326
|
+
return;
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
invalidJsonSeen.delete(file);
|
|
330
|
+
const item = pending.get(validation.qid);
|
|
331
|
+
if (!item) return;
|
|
332
|
+
clearTimeout(item.timer);
|
|
333
|
+
pending.delete(validation.qid);
|
|
334
|
+
markClosed(validation.qid, "answered");
|
|
335
|
+
try { fs.unlinkSync(full); } catch { /* ignore */ }
|
|
336
|
+
appendLogFile(logFile, validation.qid, "answered", { answered_by: validation.answer.answered_by });
|
|
337
|
+
const response = mapAnswerToAskResponse(validation.answer.answer, item.options);
|
|
338
|
+
await sendResponse(item.env, response).catch((err) => {
|
|
339
|
+
console.error(`coms-hermes-bridge: could not deliver answer for ${validation.qid}: ${err instanceof Error ? err.message : String(err)}`);
|
|
340
|
+
});
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
async function scanAnswers(): Promise<void> {
|
|
344
|
+
let files: string[];
|
|
345
|
+
try {
|
|
346
|
+
files = fs.readdirSync(qDir);
|
|
347
|
+
} catch {
|
|
348
|
+
return;
|
|
349
|
+
}
|
|
350
|
+
for (const file of files) {
|
|
351
|
+
await consumeAnswerFile(file);
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
const server = await bindEndpoint(
|
|
356
|
+
id.endpoint,
|
|
357
|
+
makeConnHandler((env, socket) => {
|
|
358
|
+
if (isPromptEnvelope(env)) {
|
|
359
|
+
writeAck(socket, env.msg_id);
|
|
360
|
+
void handlePrompt(env);
|
|
361
|
+
} else if (isCancelEnvelope(env)) {
|
|
362
|
+
writeAck(socket, env.msg_id);
|
|
363
|
+
void handleCancel(env.ref_msg_id);
|
|
364
|
+
} else if ((env as { type?: string }).type === "ping") {
|
|
365
|
+
const card: AgentCard = {
|
|
366
|
+
name: uniqueName,
|
|
367
|
+
purpose: DEFAULT_PURPOSE,
|
|
368
|
+
model: "hermes-bridge",
|
|
369
|
+
color: COLOR,
|
|
370
|
+
context_used_pct: 0,
|
|
371
|
+
queue_depth: queueDepth(),
|
|
372
|
+
};
|
|
373
|
+
try {
|
|
374
|
+
socket.write(JSON.stringify({ type: "pong", msg_id: (env as { msg_id?: string }).msg_id ?? "", agent_card: card }) + "\n");
|
|
375
|
+
} catch { /* ignore */ }
|
|
376
|
+
try { socket.end(); } catch { /* ignore */ }
|
|
377
|
+
} else {
|
|
378
|
+
writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "bridge accepts prompts, cancels, and pings");
|
|
379
|
+
}
|
|
380
|
+
}),
|
|
381
|
+
);
|
|
382
|
+
|
|
383
|
+
const keepalive = setInterval(() => {
|
|
384
|
+
try { writeRegistryAtomic(registryEntry(), project); } catch { /* best-effort */ }
|
|
385
|
+
}, KEEPALIVE_MS);
|
|
386
|
+
keepalive.unref?.();
|
|
387
|
+
const watcher = setInterval(() => { void scanAnswers(); }, pollMs);
|
|
388
|
+
watcher.unref?.();
|
|
389
|
+
|
|
390
|
+
let shuttingDown = false;
|
|
391
|
+
function shutdown(): void {
|
|
392
|
+
if (shuttingDown) return;
|
|
393
|
+
shuttingDown = true;
|
|
394
|
+
clearInterval(keepalive);
|
|
395
|
+
clearInterval(watcher);
|
|
396
|
+
for (const item of pending.values()) clearTimeout(item.timer);
|
|
397
|
+
try { server.close(); } catch { /* ignore */ }
|
|
398
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
399
|
+
removeRegistryEntry(project, uniqueName);
|
|
400
|
+
process.exit(0);
|
|
401
|
+
}
|
|
402
|
+
process.on("SIGTERM", shutdown);
|
|
403
|
+
process.on("SIGINT", shutdown);
|
|
404
|
+
|
|
405
|
+
// Publish readiness only after shutdown handlers are installed. A caller may
|
|
406
|
+
// terminate the bridge as soon as its registry entry appears; publishing
|
|
407
|
+
// earlier can bypass cleanup and leave both the entry and socket behind.
|
|
408
|
+
writeRegistryAtomic(registryEntry(), project);
|
|
409
|
+
console.error(`coms-hermes-bridge: ${uniqueName}@${project} listening (${to})`);
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
413
|
+
if (isEntry) void main();
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
// Unified `just fleet` command dispatcher. Parsing is kept pure and tested in
|
|
2
|
+
// scripts/lib/fleet-command.test.ts; this entrypoint only hands the resolved
|
|
3
|
+
// recipe back to Just so existing compatibility recipes remain one source of truth.
|
|
4
|
+
|
|
5
|
+
import { spawnSync } from "node:child_process";
|
|
6
|
+
import { parseFleetCommand } from "./lib/fleet-command.ts";
|
|
7
|
+
import { resolveMonitorEnv } from "./lib/monitor-env.ts";
|
|
8
|
+
|
|
9
|
+
const HELP = `Agent Fleet — one guarded Hub runtime, two postures, independent topology
|
|
10
|
+
|
|
11
|
+
SET UP A NEW REPOSITORY
|
|
12
|
+
npx @chankov/agent-fleet@latest setup
|
|
13
|
+
Run this from the target repository. A repository without Agent Fleet has
|
|
14
|
+
no justfile yet — setup writes it — so the first install cannot use just.
|
|
15
|
+
Select Default/Full and optional features, inspect the exact plan, then
|
|
16
|
+
confirm once to apply it. Follow with just fleet deps, then just fleet doctor.
|
|
17
|
+
Source checkout development: node bin/cli.js setup.
|
|
18
|
+
Once installed, just fleet setup wraps the same command for this repository.
|
|
19
|
+
|
|
20
|
+
QUICK START
|
|
21
|
+
just fleet # Hub/operator, empty native roster
|
|
22
|
+
just fleet --agents frontend # Hub/orchestrator with native specialists
|
|
23
|
+
just fleet --herdr --project af
|
|
24
|
+
# Hub/operator in a one-pane Herdr workspace
|
|
25
|
+
just fleet --agents frontend --peers frontend --project af
|
|
26
|
+
# matching native roster + standing peers
|
|
27
|
+
|
|
28
|
+
FLEET CORE — loaded in every Pi mode
|
|
29
|
+
Damage Control Continue · local/remote ask_user · Compact & Continue
|
|
30
|
+
BTW side sessions · update checker (voice is opt-in with --voice)
|
|
31
|
+
|
|
32
|
+
UNIFIED HUB
|
|
33
|
+
just fleet [--posture operator|orchestrator] [--agents <roster>]
|
|
34
|
+
[--herdr] [--peers <preset>] [--no-coms] [PI_ARGS...]
|
|
35
|
+
Bare Fleet always loads Agent Hub in operator posture. Operator keeps
|
|
36
|
+
read/bash/edit/write plus orchestration; the initial native roster is empty.
|
|
37
|
+
--agents selects .pi/agents/teams.yaml and implies orchestrator unless an
|
|
38
|
+
explicit --posture operator is supplied. --no-coms leaves direct/native work
|
|
39
|
+
available while coms, peer dispatch, and handoff refuse actionably.
|
|
40
|
+
|
|
41
|
+
POSTURE AND ROSTER
|
|
42
|
+
/af-posture # report posture and capability state
|
|
43
|
+
/af-agents-add code-reviewer # add a native Pi specialist at runtime
|
|
44
|
+
/af-posture orchestrator # remove direct coding tools; keep orchestration
|
|
45
|
+
/af-posture operator # restore the approved direct tool surface
|
|
46
|
+
|
|
47
|
+
Posture is independent from /af-hub-mode, the native roster, and peer topology.
|
|
48
|
+
All Hub slash commands, including /af-handoff, stay registered in both postures;
|
|
49
|
+
actions whose coms/Herdr capability is unavailable return remediation guidance.
|
|
50
|
+
|
|
51
|
+
Explicit dispatch backend examples (inside the Hub):
|
|
52
|
+
dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "native" })
|
|
53
|
+
dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "coms" })
|
|
54
|
+
backend "auto" follows .pi/agents/dispatch-policy.yaml; native always starts
|
|
55
|
+
the local Pi specialist, while coms requires a live same-name peer and never
|
|
56
|
+
falls back to native.
|
|
57
|
+
|
|
58
|
+
HERDR TOPOLOGY — requires a running Herdr server (https://herdr.dev)
|
|
59
|
+
just fleet --herdr [--project <name>]
|
|
60
|
+
Hub-only workspace using the empty base peer preset.
|
|
61
|
+
|
|
62
|
+
just fleet --peers <preset> [--agents <roster>] [--project <name>]
|
|
63
|
+
Add standing Pi/Claude peers from .pi/agents/peers.yaml. Hub and every peer
|
|
64
|
+
receive the same project. Add --dry-run to print the redacted layout only.
|
|
65
|
+
|
|
66
|
+
Dynamic Claude reviewer from a Hub already running inside Herdr:
|
|
67
|
+
herdr_spawn_peer({ name: "code-reviewer" })
|
|
68
|
+
coms_send({ target: "code-reviewer", prompt: "Review the current diff" })
|
|
69
|
+
coms_await({ msg_id: "<returned-id>" })
|
|
70
|
+
/af-handoff code-reviewer
|
|
71
|
+
The declared runner may be Claude Code. Spawn requires Herdr; messaging and
|
|
72
|
+
handoff require coms readiness and a target visible in this Hub's project pool.
|
|
73
|
+
Every spawned peer gets a sibling pane and is locked to the Hub's project.
|
|
74
|
+
|
|
75
|
+
ONE STANDALONE PEER
|
|
76
|
+
just fleet peer <name> [--runner pi|claude-code] [--persona <p>|--no-persona]
|
|
77
|
+
[--model <m>] [--project <p>] [--extensions a,b]
|
|
78
|
+
[--browser] [--all-extensions] [--direction right|down]
|
|
79
|
+
[--here] [--dry-run] [-- PI_ARGS...]
|
|
80
|
+
A single addressable peer. Inside Herdr it splits the current pane; outside
|
|
81
|
+
it creates a one-pane workspace; --here uses this terminal. A peers.yaml
|
|
82
|
+
declaration controls runner/model/extensions/env_file. A matching persona
|
|
83
|
+
starts guarded Pi; --runner claude-code starts Claude Code plus its bridge.
|
|
84
|
+
|
|
85
|
+
TEAM LIFECYCLE
|
|
86
|
+
just fleet snapshot <preset> [--project <name>]
|
|
87
|
+
just fleet down <preset> [--project <name>]
|
|
88
|
+
just fleet resume <preset> [--project <name>]
|
|
89
|
+
Save session refs, close cleanly, and rebuild available Pi/Claude sessions.
|
|
90
|
+
|
|
91
|
+
HERMES CONDUCTOR
|
|
92
|
+
just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
|
|
93
|
+
Start Hermes with a peer team, or preview the layout with --dry-run.
|
|
94
|
+
|
|
95
|
+
CODEX REMOTE-CONTROL CONDUCTOR
|
|
96
|
+
just fleet conductor codex <setup|reconfigure> [preset] [ARGS...]
|
|
97
|
+
just fleet conductor codex <pair|start|status|stop|recover|uninstall>
|
|
98
|
+
just fleet conductor codex [preset] [--dry-run] [TEAM_ARGS...]
|
|
99
|
+
|
|
100
|
+
CAPABILITY FLAGS
|
|
101
|
+
--browser Add Chrome DevTools MCP tools to the Hub/main Pi process.
|
|
102
|
+
--voice Load pi-voice-stt after selecting the voice setup feature.
|
|
103
|
+
--all-extensions Also auto-load project/global extensions outside Fleet Core.
|
|
104
|
+
--no-coms Disable only the Hub's embedded coms layer.
|
|
105
|
+
|
|
106
|
+
COMPATIBILITY ALIASES — accepted with migration warnings
|
|
107
|
+
just fleet hub [--solo] ... -> just fleet [--no-coms] ...
|
|
108
|
+
just fleet team <preset> ... -> just fleet --agents <roster> --peers <preset> ...
|
|
109
|
+
just fleet team <preset> --no-hub -> legacy peers-only topology
|
|
110
|
+
Legacy peer-only presets full/web/docs retain the default native roster.
|
|
111
|
+
|
|
112
|
+
LIFECYCLE
|
|
113
|
+
just fleet setup [--dry-run] [--preset default|full --features none --yes]
|
|
114
|
+
Reconcile desired state with the newest published package. Preset and
|
|
115
|
+
features are remembered in .ai/agent-fleet.json, so a plain setup needs no
|
|
116
|
+
flags; flags apply to one run unless --save-desired persists them.
|
|
117
|
+
just fleet deps
|
|
118
|
+
Install only .pi/extensions and .pi/harnesses Node dependencies.
|
|
119
|
+
Does not launch Pi, configure STT, install ffmpeg/Herdr, or pair Codex.
|
|
120
|
+
just fleet doctor [--fix]
|
|
121
|
+
just fleet uninstall --all --yes
|
|
122
|
+
Reinstall after self-uninstall with npx @chankov/agent-fleet@latest setup.
|
|
123
|
+
|
|
124
|
+
UPDATE NOTE
|
|
125
|
+
Update with: just fleet setup --dry-run, then just fleet setup, then deps+doctor.
|
|
126
|
+
setup reconciles TOWARD the package: an artifact you edited in place is
|
|
127
|
+
refreshed and your edit overwritten. --dry-run shows that before it happens;
|
|
128
|
+
.ai/agent-fleet-overrides.md is the customization no lifecycle command touches.
|
|
129
|
+
If you and the new version changed the same file, setup exits 3 having written
|
|
130
|
+
nothing — re-run with --on-conflict theirs or --on-conflict ours.
|
|
131
|
+
pi update --extensions updates pi extensions only; it does not update this npm
|
|
132
|
+
installer. just fleet install was removed; use setup or deps.
|
|
133
|
+
|
|
134
|
+
HELP
|
|
135
|
+
just Show this complete command guide.
|
|
136
|
+
just fleet help Show this complete command guide.
|
|
137
|
+
just --list Show the intentionally small public recipe surface.
|
|
138
|
+
|
|
139
|
+
Configuration:
|
|
140
|
+
Native rosters: .pi/agents/teams.yaml
|
|
141
|
+
Peer presets: .pi/agents/peers.yaml
|
|
142
|
+
Routing: .pi/agents/dispatch-policy.yaml
|
|
143
|
+
Overrides: .ai/agent-fleet-overrides.md
|
|
144
|
+
Safety: .pi/damage-control-rules.yaml
|
|
145
|
+
Full docs: docs/pi-extensions.md and docs/pi-setup.md
|
|
146
|
+
`;
|
|
147
|
+
|
|
148
|
+
function main(): void {
|
|
149
|
+
const argv = process.argv.slice(2);
|
|
150
|
+
if (argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
|
|
151
|
+
process.stdout.write(HELP);
|
|
152
|
+
return;
|
|
153
|
+
}
|
|
154
|
+
let invocation;
|
|
155
|
+
try {
|
|
156
|
+
invocation = parseFleetCommand(argv);
|
|
157
|
+
} catch (err) {
|
|
158
|
+
console.error(`fleet: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
159
|
+
process.stderr.write(HELP);
|
|
160
|
+
process.exitCode = 2;
|
|
161
|
+
return;
|
|
162
|
+
}
|
|
163
|
+
for (const warning of invocation.warnings ?? []) {
|
|
164
|
+
console.error(`fleet: warning: ${warning}`);
|
|
165
|
+
}
|
|
166
|
+
// Every mode gets the monitor variables, not just `hub`: a plain `just fleet`
|
|
167
|
+
// or a `peer` loads no agent-hub and so reads them never, while `hub` and
|
|
168
|
+
// `team` both reach the hub through a Just recipe that inherits this
|
|
169
|
+
// environment. Deciding here rather than per recipe keeps it one line of
|
|
170
|
+
// truth; a null answer (opted out, or no directory we can make private)
|
|
171
|
+
// leaves the environment untouched and the hub unmonitored, exactly as
|
|
172
|
+
// before this existed.
|
|
173
|
+
const result = spawnSync("just", [invocation.recipe, ...invocation.args], {
|
|
174
|
+
stdio: "inherit",
|
|
175
|
+
env: { ...process.env, ...(resolveMonitorEnv() ?? {}) },
|
|
176
|
+
});
|
|
177
|
+
if (result.error) {
|
|
178
|
+
console.error(`fleet: could not run just: ${result.error.message}`);
|
|
179
|
+
process.exitCode = 1;
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
process.exitCode = result.status ?? 1;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
main();
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import * as fs from 'node:fs';import * as path from 'node:path';import * as crypto from 'node:crypto';import {fileURLToPath} from 'node:url';import {spawn as realSpawn} from 'node:child_process';
|
|
2
|
+
export function parseRunnerArgs(argv:string[]){if(argv[0]!=='verify')throw Error('unsupported command');const out:any={};for(let i=1;i<argv.length;i+=2){const k=argv[i],v=argv[i+1];if(!['--root','--artifact'].includes(k)||!v||out[k])throw Error('invalid arguments');out[k]=v;}if(!out['--root']||!out['--artifact'])throw Error('missing arguments');return{root:out['--root'],artifact:out['--artifact']};}
|
|
3
|
+
export function verifyGateArtifact(root:string,artifactPath:string){root=validateOwnedRoot(root);const st=fs.lstatSync(artifactPath);if(st.isSymbolicLink()||!st.isFile())throw Error('unsafe gate artifact');const a=JSON.parse(fs.readFileSync(artifactPath,'utf8'));const bad=()=>{throw Error('gate artifact failed closed')};if(a.schema!=='agent-fleet.hermes-gate-c-capabilities'||a.schemaVersion!==1||a.gate!=='C'||a.status!=='passed'||a.runtimeVerified!==true)bad();const argv=a.argv??{};for(const k of ['pluginEnableArgv','backendStartArgv','backendStopArgv','desktopStartArgv','desktopStopArgv'])if(!Array.isArray(argv[k])||!argv[k].length||argv[k].some((x:any)=>typeof x!=='string'||!x))bad();if(!a.capabilities?.desktopDebugAttachment?.url||!a.capabilities?.desktopDebugAttachment?.probeExpression)bad();const proof=a.pluginLoadProof;if(proof?.backendPluginId!=='agent-fleet-monitor'||proof?.desktopPluginId!=='agent-fleet-monitor')bad();if(a.validation?.status!=='passed'||a.gateDecision?.status!=='pass'||a.gateDecision?.implementationMayProceed!==true)bad();const raw=JSON.stringify(a);if(/(api[_-]?key|token|password|\/home\/|\.pi\/agent)/i.test(raw))bad();return{sha256:crypto.createHash('sha256').update(raw).digest('hex'),argv:{enable:argv.pluginEnableArgv,backend:argv.backendStartArgv,desktop:argv.desktopStartArgv},debug:a.capabilities.desktopDebugAttachment,proof};}
|
|
4
|
+
export type Owned={root:string;pid?:number;argv:string[];executable:string;start?:string;reservation:string};
|
|
5
|
+
export function ownedIndexPath(root:string,file:string){root=validateOwnedRoot(root);const target=path.resolve(root,file);if(path.dirname(target)!==root||path.basename(target)!==file)throw Error('owned index must be direct child');return target;}
|
|
6
|
+
export function writeOwnedIndex(root:string,file:string,value:any){const target=ownedIndexPath(root,file);if(!value||value.schema!==1||value.root!==validateOwnedRoot(root)||typeof value.owner!=='string'||typeof value.artifactSha256!=='string'||typeof value.components!=='object')throw Error('invalid owned index');for(const [component,item] of Object.entries(value.components)){componentName(component);const x:any=item;if(!x||x.registry!==`registry-${component}.json`||typeof x.owner!=='string')throw Error('invalid owned index component');}const tmp=path.join(root,`.${path.basename(file)}.${process.pid}.tmp`);fs.writeFileSync(tmp,JSON.stringify(value),{mode:0o600});fs.renameSync(tmp,target);return value;}
|
|
7
|
+
export function readOwnedIndex(root:string,file:string){const target=ownedIndexPath(root,file),st=fs.lstatSync(target);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error('unsafe owned index');return JSON.parse(fs.readFileSync(target,'utf8'));}
|
|
8
|
+
const SENTINEL='.agent-fleet-hermes-monitor-smoke',REGISTRY='owned-registry.json';const componentName=(v:string)=>{if(!/^[A-Za-z0-9._-]+$/.test(v)||v.includes('..'))throw Error('invalid component');return v};
|
|
9
|
+
export async function terminateExactChild(child:any,deps:any={}){if(!child||typeof child.kill!=='function')throw Error('child handle required');if(child.exitCode!==null&&child.exitCode!==undefined)return{exited:true};const set=deps.setTimeout??setTimeout,clear=deps.clearTimeout??clearTimeout,waitMs=deps.waitMs??5000;let resolve:any;const exited=new Promise(r=>resolve=r);child.once?.('exit',()=>resolve(true));const wait=()=>new Promise(r=>{timer=set(r,waitMs)});try{child.kill('SIGTERM')}catch(e:any){if(e?.code==='ESRCH')return{exited:true};throw e}let timer:any;try{const first=await Promise.race([exited,wait()]);if(first)return{exited:true};try{child.kill('SIGKILL')}catch(e:any){if(e?.code==='ESRCH')return{exited:true};throw e}const second=await Promise.race([exited,wait()]);return{exited:!!second};}finally{if(timer!==undefined)clear(timer);}}
|
|
10
|
+
const finalizedLaunchErrors=new Set<string>();export async function finalizeDurableLaunchError(root:string,component:string,owner:string,reservation:string,child:any,deps:any={}){const key=`${root}:${component}:${owner}`;if(finalizedLaunchErrors.has(key))return;finalizedLaunchErrors.add(key);try{if(child?.exitCode===null||child?.exitCode===undefined)await terminateExactChild(child,deps);}catch{}try{const record=readOwnedRegistry(root,component);if(record.owner!==owner||record.state==='exited')return;writeOwnedRegistry(root,{...record,state:'failed'},component);const value=JSON.parse(fs.readFileSync(reservation,'utf8'));if(value.owner===owner)fs.unlinkSync(reservation);}catch{}}
|
|
11
|
+
export function safeRoot(root:string){const r=path.resolve(root);if(r===path.parse(r).root)throw Error('owned root required');return r;}
|
|
12
|
+
export function validateOwnedRoot(root:string){root=safeRoot(root);const st=fs.lstatSync(root);if(st.isSymbolicLink()||!st.isDirectory()||(st.mode&0o777)!==0o700)throw Error('unsafe owned root');const sentinel=path.join(root,SENTINEL),ss=fs.lstatSync(sentinel);if(ss.isSymbolicLink()||!ss.isFile()||(ss.mode&0o777)!==0o600)throw Error('unsafe owned sentinel');const value=JSON.parse(fs.readFileSync(sentinel,'utf8'));if(value?.schema!==1||value?.owner!=='agent-fleet'||value?.root!==fs.realpathSync(root))throw Error('invalid owned sentinel');return fs.realpathSync(root);}
|
|
13
|
+
export function buildOwnedEnv(root:string,env:any={}){root=validateOwnedRoot(root);const child=(n:string)=>path.join(root,n);for(const n of ['home','config','state','runtime','cache','hermes','sockets']){const p=child(n);fs.mkdirSync(p,{recursive:true,mode:0o700});const st=fs.lstatSync(p);if(st.isSymbolicLink()||!st.isDirectory()||(st.mode&0o777)!==0o700)throw Error('unsafe owned env path');}return{...env,HOME:child('home'),XDG_CONFIG_HOME:child('config'),XDG_STATE_HOME:child('state'),XDG_RUNTIME_DIR:child('runtime'),XDG_CACHE_HOME:child('cache'),HERMES_HOME:child('hermes'),HERDR_SOCKET_PATH:path.join(child('sockets'),'herdr.sock')};}
|
|
14
|
+
export function writeOwnedRegistry(root:string,value:any,component?:string){root=validateOwnedRoot(root);if(component)componentName(component);if(!Array.isArray(value.argv)||!value.argv.length||value.argv.some((x:any)=>typeof x!=='string'||!x))throw Error('invalid owned argv');const clean={schema:1,root,component:(typeof value.component==='string'&&/^[A-Za-z0-9._-]+$/.test(value.component)?value.component:(()=>{throw Error('invalid component')})()),executable:fs.realpathSync(value.executable),argv:[...(value.argv??[])].map(String),pid:Number(value.pid),start:String(value.start),state:String(value.state??'running'),owner:typeof value.owner==='string'?value.owner:undefined,createdAt:value.createdAt??new Date().toISOString(),updatedAt:new Date().toISOString()};const name=component?`registry-${component}.json`:REGISTRY,file=path.join(root,name),tmp=path.join(root,`.${name}.${process.pid}.tmp`);fs.writeFileSync(tmp,JSON.stringify(clean),{mode:0o600});fs.renameSync(tmp,file);return clean;}
|
|
15
|
+
export function readOwnedRegistry(root:string,component?:string){root=validateOwnedRoot(root);if(component)componentName(component);const file=path.join(root,component?`registry-${component}.json`:REGISTRY),st=fs.lstatSync(file);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error('unsafe owned registry');const v=JSON.parse(fs.readFileSync(file,'utf8'));if(v?.schema!==1||v.root!==root||!Array.isArray(v.argv)||!v.argv.length||v.argv.some((x:any)=>typeof x!=='string'||!x)||typeof v.component!=='string'||typeof v.pid!=='number'||v.pid<=0||typeof v.start!=='string'||!v.start||typeof v.owner!=='string'||!v.owner||!['starting','running','stopping','exited','failed'].includes(v.state))throw Error('invalid owned registry');return v;}
|
|
16
|
+
export async function launchOwnedDurable(root:string,component:string,argv:string[],deps:any={}){root=validateOwnedRoot(root);if(!/^[A-Za-z0-9._-]+$/.test(component)||!Array.isArray(argv)||!argv.length||argv.some(x=>typeof x!=='string'||!x))throw Error('invalid durable launch');const f=deps.fs??fs,spawn=deps.spawn??realSpawn,owner=deps.uuid?.()??crypto.randomUUID(),reservation=path.join(root,`.reservation-${component}`);try{f.writeFileSync(reservation,JSON.stringify({owner,component}),{flag:'wx',mode:0o600});}catch{throw Error('component reservation exists')}let child:any=null;const fail=(state:string)=>{try{writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:0,start:'',state,owner},component)}catch{}try{const value=JSON.parse(f.readFileSync(reservation,'utf8'));if(value.owner===owner)f.unlinkSync(reservation)}catch{}};try{writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:0,start:'pending',state:'starting',owner},component);child=spawn(argv[0],argv.slice(1),{cwd:root,env:buildOwnedEnv(root),shell:false,stdio:'ignore'});child.once?.('error',()=>{void finalizeDurableLaunchError(root,component,owner,reservation,child,deps).catch(()=>{})});const start=(deps.startOf??startOf)(child.pid);const record=writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:child.pid,start,state:'running',owner},component);child.once?.('exit',()=>{try{const current=readOwnedRegistry(root,component);if(current.component===component&¤t.pid===child.pid&¤t.start===start)writeOwnedRegistry(root,{...current,state:'exited'},component);}catch{}});return{child,record,reservation};}catch(error){if(child){await finalizeDurableLaunchError(root,component,owner,reservation,child,deps);fail('failed')}else fail('failed');throw error;}}
|
|
17
|
+
export async function waitOwnedFromRegistry(root:string,component:string,deps:any={}){const now=deps.now??Date.now,sleep=deps.sleep??((ms:number)=>new Promise(r=>setTimeout(r,ms))),start=deps.startOf??startOf,timeout=deps.timeout??10_000;const record=readOwnedRegistry(root,component);if(record.component!==component||!['running','stopping'].includes(record.state))return record;if(start(record.pid)!==record.start)throw Error('owned process identity changed');const began=now();while(now()-began<timeout){try{if(start(record.pid)!==record.start){const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);return exited;}}catch{return writeOwnedRegistry(root,{...record,state:'exited'},component)}await sleep(10);}throw Error('owned wait timeout');}
|
|
18
|
+
export async function stopOwnedFromRegistry(root:string,component:string,deps:any={}){const signal=deps.signal??((pid:number,s:string)=>process.kill(pid,s)),start=deps.startOf??startOf,sleep=deps.sleep??((ms:number)=>new Promise(r=>setTimeout(r,ms)));let record=readOwnedRegistry(root,component);if(record.component!==component||record.state!=='running')throw Error('component not running');const markExited=()=>{const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);try{const p=path.join(root,`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===record.owner)fs.unlinkSync(p)}catch{}return exited};const same=()=>{try{const value=start(record.pid);if(value===undefined||value===null)return null;return value===record.start}catch(e:any){if(e?.code==='ESRCH')return null;throw e}};const initial=same();if(initial===null)return markExited();if(!initial)throw Error('owned process identity changed');record=writeOwnedRegistry(root,{...record,state:'stopping'},component);try{signal(record.pid,'SIGTERM')}catch(e:any){if(e?.code==='ESRCH'){const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);try{const p=path.join(root,`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===record.owner)fs.unlinkSync(p)}catch{}return exited;}throw e}try{await waitOwnedFromRegistry(root,component,{...deps,timeout:5000});}catch{const beforeKill=same();if(beforeKill===null)return markExited();if(!beforeKill)throw Error('owned process identity changed');try{signal(record.pid,'SIGKILL')}catch(e:any){if(e?.code==='ESRCH')return writeOwnedRegistry(root,{...record,state:'exited'},component);throw e}try{await waitOwnedFromRegistry(root,component,{...deps,timeout:5000});}catch{writeOwnedRegistry(root,{...record,state:'failed'},component);throw Error('owned stop timeout');}}const final=readOwnedRegistry(root,component);try{const p=path.join(validateOwnedRoot(root),`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===final.owner)fs.unlinkSync(p)}catch{}return final;}
|
|
19
|
+
export async function launchOwnedIndexed(root:string,component:string,argv:string[],ownedFile:string,artifactSha:string,deps:any={}){root=validateOwnedRoot(root);const lock=path.join(root,'.owned-index.lock');let fd,acquired=false;let launched:any,index:any,prior:any;try{fd=fs.openSync(lock,'wx',0o600);acquired=true;try{index=readOwnedIndex(root,ownedFile)}catch{index={schema:1,root,owner:crypto.randomUUID(),artifactSha256:artifactSha,components:{}}}if(index.artifactSha256!==artifactSha)throw Error('artifact mismatch');prior=index.components[component];launched=await launchOwnedDurable(root,component,argv,deps);const record=readOwnedRegistry(root,component);index.components[component]={registry:`registry-${component}.json`,owner:record.owner};writeOwnedIndex(root,ownedFile,index);return launched;}catch(error){if(launched){try{const record=readOwnedRegistry(root,component);if(record.owner===launched.record.owner&&record.pid===launched.record.pid&&record.start===launched.record.start)await stopOwnedFromRegistry(root,component,deps);}catch{}try{if(index){if(prior)index.components[component]=prior;else delete index.components[component];writeOwnedIndex(root,ownedFile,index);}}catch{}}throw error;}finally{if(acquired){try{fs.closeSync(fd)}catch{};try{fs.unlinkSync(lock)}catch{}}}}
|
|
20
|
+
export async function waitOwnedIndexed(root:string,component:string,ownedFile:string,artifactSha:string,deps:any={}){const index=readOwnedIndex(root,ownedFile),entry=index.components?.[component],record=readOwnedRegistry(root,component);if(index.artifactSha256!==artifactSha||!entry||entry.registry!==`registry-${component}.json`||entry.owner!==record.owner)throw Error('owned index mismatch');return waitOwnedFromRegistry(root,component,deps);}
|
|
21
|
+
export async function stopOwnedIndexed(root:string,component:string,ownedFile:string,artifactSha:string,deps:any={}){const index=readOwnedIndex(root,ownedFile),record=readOwnedRegistry(root,component),entry=index.components?.[component];if(!entry||entry.owner!==record.owner||index.artifactSha256!==artifactSha)throw Error('owned index mismatch');const result=await stopOwnedFromRegistry(root,component,deps);if(['exited','failed'].includes(result.state)&&index.components[component]?.owner===record.owner){delete index.components[component];writeOwnedIndex(root,ownedFile,index);}return result;}
|
|
22
|
+
if(process.argv[1]===fileURLToPath(import.meta.url)){try{const a=parseRunnerArgs(process.argv.slice(2)),v=verifyGateArtifact(a.root,a.artifact);process.stdout.write(JSON.stringify({ok:true,sha256:v.sha256})+'\n');}catch{process.stdout.write(JSON.stringify({ok:false,error:'verification_failed'})+'\n');process.exitCode=2;}}
|
|
23
|
+
export function writeGateArtifact(root:string,value:unknown){root=validateOwnedRoot(root);fs.mkdirSync(root,{recursive:true,mode:0o700});const file=path.join(root,'gate-c.json'),tmp=`${file}.${process.pid}.${Math.random()}.tmp`;fs.writeFileSync(tmp,JSON.stringify(value),{mode:0o600});fs.renameSync(tmp,file);return file;}
|
|
24
|
+
const startOf=(pid:number,read=(p:string)=>fs.readFileSync(p,'utf8'))=>{const stat=read(`/proc/${pid}/stat`),tail=stat.slice(stat.lastIndexOf(')')+2).split(' ');return tail[19];};
|
|
25
|
+
export async function runOwned(argv:string[],root:string,deps:any={}){if(!Array.isArray(argv)||!argv.length||argv.some(x=>typeof x!=='string'))throw Error('argv required');root=validateOwnedRoot(root);const f=deps.fs??fs,spawn=deps.spawn??realSpawn,set=deps.setTimeout??setTimeout,clear=deps.clearTimeout??clearTimeout,signals=deps.signals??process;f.mkdirSync(root,{recursive:true,mode:0o700});const reservation=path.join(root,'.reservation');let fd;try{fd=f.openSync(reservation,'wx',0o600);}catch{throw Error('owned reservation exists')}const owned:Owned={root,argv:[...argv],executable:argv[0],reservation};let child:any,exitResolve:any;const exited=new Promise(r=>exitResolve=r);let released=false,timer:any;const release=()=>{if(released)return;released=true;try{f.unlinkSync(reservation)}catch{};try{f.unlinkSync(path.join(root,'gate-c.json'))}catch{}};try{writeGateArtifact(root,{root,argv,executable:argv[0]});child=spawn(argv[0],argv.slice(1),{cwd:root,env:{...process.env,HOME:path.join(root,'home')},shell:false,stdio:'ignore'});owned.pid=child.pid;owned.start=(deps.startOf??startOf)(child.pid);child.once('exit',(code:any)=>{if(timer!==undefined)clear(timer);exitResolve(code);release();});}catch(e){release();throw e}const valid=()=>!!owned.pid&&(deps.startOf??startOf)(owned.pid)===owned.start;const stop=async()=>{if(released)return;if(!valid())throw Error('owned process identity changed');child.kill('SIGTERM');timer=set(()=>{if(valid())child.kill('SIGKILL')},5000);await exited;};const wait=()=>exited;const onSignal=()=>void stop();signals.once('SIGINT',onSignal);signals.once('SIGTERM',onSignal);return{child,owned,wait,stop,dispose:()=>{signals.removeListener('SIGINT',onSignal);signals.removeListener('SIGTERM',onSignal);release()}};}
|