@chankov/agent-fleet 0.0.10 → 0.0.11
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/btw/README.md +3 -2
- package/.pi/extensions/pi-voice-stt/README.md +3 -0
- package/.pi/harnesses/agent-hub/README.md +3 -0
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.versions/0.0.11/.claude/commands/build.md +44 -0
- package/.versions/0.0.11/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.11/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +22 -0
- package/.versions/0.0.11/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.11/.claude/commands/plan.md +16 -0
- package/.versions/0.0.11/.claude/commands/prime.md +22 -0
- package/.versions/0.0.11/.claude/commands/review.md +16 -0
- package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +17 -0
- package/.versions/0.0.11/.claude/commands/ship.md +72 -0
- package/.versions/0.0.11/.claude/commands/spec.md +15 -0
- package/.versions/0.0.11/.claude/commands/test.md +19 -0
- package/.versions/0.0.11/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.11/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.11/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.11/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.11/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +17 -0
- package/.versions/0.0.11/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.11/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.11/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.11/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.11/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.11/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.11/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/btw/README.md +119 -0
- package/.versions/0.0.11/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.11/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.11/.pi/extensions/package.json +9 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +204 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/README.md +1004 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/index.ts +9111 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.11/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.11/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.11/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.11/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.11/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.11/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.11/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.11/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.11/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +19 -0
- package/.versions/0.0.11/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.11/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.11/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.11/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.11/.version +1 -0
- package/.versions/0.0.11/agents/architect.md +24 -0
- package/.versions/0.0.11/agents/bowser.md +27 -0
- package/.versions/0.0.11/agents/builder.md +54 -0
- package/.versions/0.0.11/agents/code-reviewer.md +208 -0
- package/.versions/0.0.11/agents/deep-researcher.md +32 -0
- package/.versions/0.0.11/agents/documenter.md +18 -0
- package/.versions/0.0.11/agents/orchestrator.md +72 -0
- package/.versions/0.0.11/agents/plan-reviewer.md +83 -0
- package/.versions/0.0.11/agents/planner.md +70 -0
- package/.versions/0.0.11/agents/releaser.md +24 -0
- package/.versions/0.0.11/agents/researcher.md +28 -0
- package/.versions/0.0.11/agents/security-auditor.md +167 -0
- package/.versions/0.0.11/agents/test-engineer.md +153 -0
- package/.versions/0.0.11/agents/web-debugger.md +43 -0
- package/.versions/0.0.11/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.11/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.11/docs/ARCHITECTURE.md +303 -0
- package/.versions/0.0.11/docs/agent-fleet-setup.md +377 -0
- package/.versions/0.0.11/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.11/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.11/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.11/docs/getting-started.md +254 -0
- package/.versions/0.0.11/docs/npm-install.md +514 -0
- package/.versions/0.0.11/docs/opencode-setup.md +281 -0
- package/.versions/0.0.11/docs/pi-extensions.md +368 -0
- package/.versions/0.0.11/docs/pi-setup.md +571 -0
- package/.versions/0.0.11/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.11/hermes/README.md +347 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.11/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.11/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.11/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.11/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.11/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.11/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.11/hooks/hooks.json +14 -0
- package/.versions/0.0.11/hooks/session-start.sh +74 -0
- package/.versions/0.0.11/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.11/install-manifest.json +3615 -0
- package/.versions/0.0.11/justfile +254 -0
- package/.versions/0.0.11/manifest-meta.json +472 -0
- package/.versions/0.0.11/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.11/references/definition-of-done.md +67 -0
- package/.versions/0.0.11/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.11/references/observability-checklist.md +91 -0
- package/.versions/0.0.11/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.11/references/performance-checklist.md +153 -0
- package/.versions/0.0.11/references/prompting-patterns.md +380 -0
- package/.versions/0.0.11/references/security-checklist.md +179 -0
- package/.versions/0.0.11/references/testing-patterns.md +236 -0
- package/.versions/0.0.11/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.11/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.11/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.11/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.11/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.11/scripts/fleet.ts +168 -0
- package/.versions/0.0.11/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.11/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.11/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.11/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.11/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.11/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.11/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.11/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.11/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.11/scripts/lib/fleet-command.ts +111 -0
- package/.versions/0.0.11/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.11/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.11/scripts/lib/monitor-env.ts +134 -0
- package/.versions/0.0.11/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.11/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.11/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.11/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.11/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.11/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.11/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.11/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.11/scripts/team-up.ts +360 -0
- package/.versions/0.0.11/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/0.0.11/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.11/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.11/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.11/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.11/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +226 -0
- package/.versions/0.0.11/skills/guided-workspace-setup/companion-manifest.json +38 -0
- package/.versions/0.0.11/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.11/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.11/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.11/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.11/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.11/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.11/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.11/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.11/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.11/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/0.0.11/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.11/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/0.0.11/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.11/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/docs/pi-extensions.md +5 -0
- package/install-manifest.json +1 -1
- package/package.json +1 -1
- package/scripts/lib/monitor-env.ts +15 -1
|
@@ -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,168 @@
|
|
|
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 — unified Pi runtime
|
|
10
|
+
|
|
11
|
+
QUICK START
|
|
12
|
+
just fleet
|
|
13
|
+
Start the default guarded Pi session with Fleet Core.
|
|
14
|
+
|
|
15
|
+
just fleet hub --project af
|
|
16
|
+
Start Agent Hub with specialists, research, Verification Contract, and coms.
|
|
17
|
+
|
|
18
|
+
just fleet team frontend --project af
|
|
19
|
+
Start a guarded Hub plus the frontend peer team in one Herdr workspace.
|
|
20
|
+
|
|
21
|
+
FLEET CORE — loaded in every Pi mode
|
|
22
|
+
Damage Control Continue · local/remote ask_user · Speech-to-Text (Alt+S)
|
|
23
|
+
Compact & Continue · BTW side sessions · update checker
|
|
24
|
+
|
|
25
|
+
SESSION MODES
|
|
26
|
+
just fleet [PI_ARGS...]
|
|
27
|
+
Safe interactive Pi without Hub or a coms identity.
|
|
28
|
+
Example: just fleet --model openai-codex/gpt-5.6-terra
|
|
29
|
+
|
|
30
|
+
just fleet peer <name> [--runner pi|claude-code] [--persona <p>|--no-persona]
|
|
31
|
+
[--model <m>] [--project <p>] [--extensions a,b]
|
|
32
|
+
[--browser] [--all-extensions] [--direction right|down]
|
|
33
|
+
[--here] [--dry-run] [-- PI_ARGS...]
|
|
34
|
+
ONE addressable coms peer, in a herdr pane of its own. Inside herdr it
|
|
35
|
+
splits the current pane; outside it creates a single-pane workspace;
|
|
36
|
+
--here runs it in this terminal instead.
|
|
37
|
+
The NAME decides the shape: a name declared in .pi/agents/peers.yaml keeps
|
|
38
|
+
its runner/model/extensions/env_file, a name matching agents/<name>.md
|
|
39
|
+
becomes that persona peer, and anything else is a plain Fleet Core peer
|
|
40
|
+
under that identity. --runner claude-code needs no manifest at all, and
|
|
41
|
+
--no-persona forces the plain shape for a name that matches a persona.
|
|
42
|
+
Raw pi arguments go after a "--" separator and need the plain shape.
|
|
43
|
+
Examples:
|
|
44
|
+
just fleet peer code-reviewer --project af
|
|
45
|
+
just fleet peer scratch-reviewer --runner claude-code --model opus --project af
|
|
46
|
+
just fleet peer web-debugger --browser --project af
|
|
47
|
+
just fleet peer nick --here --project af
|
|
48
|
+
just fleet peer architect --no-persona --here -- --session /path/to/session.json
|
|
49
|
+
|
|
50
|
+
just fleet hub [--solo] [PI_ARGS...]
|
|
51
|
+
Agent Hub dispatcher. Embedded coms is on unless --solo is supplied.
|
|
52
|
+
Examples:
|
|
53
|
+
just fleet hub --project af
|
|
54
|
+
just fleet hub --solo
|
|
55
|
+
|
|
56
|
+
TEAM MODES — presets: base, full, web, docs, default, debug, frontend,
|
|
57
|
+
security, hotfix, release, info, review, plan
|
|
58
|
+
just fleet team <preset> [TEAM_ARGS...]
|
|
59
|
+
Guarded Hub plus guarded reusable peers in one Herdr workspace.
|
|
60
|
+
Example: just fleet team security --project af
|
|
61
|
+
|
|
62
|
+
just fleet team <preset> --no-hub [TEAM_ARGS...]
|
|
63
|
+
Guarded reusable peers only; no Hub pane.
|
|
64
|
+
Example: just fleet team docs --no-hub --project af
|
|
65
|
+
|
|
66
|
+
just fleet team <preset> [--no-hub] --dry-run [TEAM_ARGS...]
|
|
67
|
+
Print the resolved workspace, panes, and commands without changing Herdr.
|
|
68
|
+
Example: just fleet team frontend --dry-run --project af
|
|
69
|
+
|
|
70
|
+
TEAM LIFECYCLE
|
|
71
|
+
just fleet snapshot <preset> [--project <name>]
|
|
72
|
+
Save session references while the workspace keeps running.
|
|
73
|
+
|
|
74
|
+
just fleet down <preset> [--project <name>]
|
|
75
|
+
Snapshot and cleanly close the workspace.
|
|
76
|
+
|
|
77
|
+
just fleet resume <preset> [--project <name>]
|
|
78
|
+
Rebuild the workspace and resume available Pi/Claude sessions.
|
|
79
|
+
|
|
80
|
+
Examples:
|
|
81
|
+
just fleet snapshot docs --project af
|
|
82
|
+
just fleet down docs --project af
|
|
83
|
+
just fleet resume docs --project af
|
|
84
|
+
|
|
85
|
+
HERMES CONDUCTOR
|
|
86
|
+
just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
|
|
87
|
+
Start Hermes with a peer team, or preview the layout with --dry-run.
|
|
88
|
+
Example: just fleet conductor hermes docs --project af
|
|
89
|
+
|
|
90
|
+
CODEX REMOTE-CONTROL CONDUCTOR
|
|
91
|
+
just fleet conductor codex <setup|reconfigure> [preset] [ARGS...]
|
|
92
|
+
just fleet conductor codex <pair|start|status|stop|recover|uninstall>
|
|
93
|
+
just fleet conductor codex [preset] [--dry-run] [TEAM_ARGS...]
|
|
94
|
+
|
|
95
|
+
Typical flow:
|
|
96
|
+
just fleet conductor codex setup docs --project af
|
|
97
|
+
just fleet conductor codex pair
|
|
98
|
+
just fleet conductor codex start
|
|
99
|
+
just fleet conductor codex docs --project af
|
|
100
|
+
just fleet conductor codex status
|
|
101
|
+
just fleet conductor codex stop
|
|
102
|
+
|
|
103
|
+
CAPABILITY FLAGS
|
|
104
|
+
--browser
|
|
105
|
+
Add interactive Chrome DevTools MCP tools to the main Pi/Hub process.
|
|
106
|
+
On a persona peer it adds the chrome-devtools-mcp extension instead.
|
|
107
|
+
Example: just fleet hub --browser --project af
|
|
108
|
+
|
|
109
|
+
--all-extensions
|
|
110
|
+
Also auto-load arbitrary project/global extensions outside Fleet Core.
|
|
111
|
+
Not available to persona peers: reusable peers load a deterministic set,
|
|
112
|
+
declared per peer via extensions: in .pi/agents/peers.yaml.
|
|
113
|
+
Example: just fleet peer debugger --all-extensions --project af
|
|
114
|
+
|
|
115
|
+
SETUP
|
|
116
|
+
just fleet install
|
|
117
|
+
Install only .pi/extensions and .pi/harnesses Node dependencies.
|
|
118
|
+
Does not launch Pi, configure STT, install ffmpeg/Herdr, or pair Codex.
|
|
119
|
+
|
|
120
|
+
HELP
|
|
121
|
+
just Show this complete command guide.
|
|
122
|
+
just fleet help Show this complete command guide.
|
|
123
|
+
just --list Show the intentionally small public recipe surface.
|
|
124
|
+
|
|
125
|
+
Configuration:
|
|
126
|
+
Teams: .pi/agents/peers.yaml
|
|
127
|
+
Hub teams: .pi/agents/teams.yaml
|
|
128
|
+
Overrides: .ai/agent-fleet-overrides.md
|
|
129
|
+
STT: .ai/stt.json or ~/.pi/agent/stt.json
|
|
130
|
+
Safety: .pi/damage-control-rules.yaml
|
|
131
|
+
Full docs: docs/pi-extensions.md and docs/pi-setup.md
|
|
132
|
+
`;
|
|
133
|
+
|
|
134
|
+
function main(): void {
|
|
135
|
+
const argv = process.argv.slice(2);
|
|
136
|
+
if (argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
|
|
137
|
+
process.stdout.write(HELP);
|
|
138
|
+
return;
|
|
139
|
+
}
|
|
140
|
+
let invocation;
|
|
141
|
+
try {
|
|
142
|
+
invocation = parseFleetCommand(argv);
|
|
143
|
+
} catch (err) {
|
|
144
|
+
console.error(`fleet: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
145
|
+
process.stderr.write(HELP);
|
|
146
|
+
process.exitCode = 2;
|
|
147
|
+
return;
|
|
148
|
+
}
|
|
149
|
+
// Every mode gets the monitor variables, not just `hub`: a plain `just fleet`
|
|
150
|
+
// or a `peer` loads no agent-hub and so reads them never, while `hub` and
|
|
151
|
+
// `team` both reach the hub through a Just recipe that inherits this
|
|
152
|
+
// environment. Deciding here rather than per recipe keeps it one line of
|
|
153
|
+
// truth; a null answer (opted out, or no directory we can make private)
|
|
154
|
+
// leaves the environment untouched and the hub unmonitored, exactly as
|
|
155
|
+
// before this existed.
|
|
156
|
+
const result = spawnSync("just", [invocation.recipe, ...invocation.args], {
|
|
157
|
+
stdio: "inherit",
|
|
158
|
+
env: { ...process.env, ...(resolveMonitorEnv() ?? {}) },
|
|
159
|
+
});
|
|
160
|
+
if (result.error) {
|
|
161
|
+
console.error(`fleet: could not run just: ${result.error.message}`);
|
|
162
|
+
process.exitCode = 1;
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
process.exitCode = result.status ?? 1;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
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()}};}
|