@chankov/agent-fleet 1.0.0 → 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/agents/model-profiles.yaml +2 -2
- package/.pi/extensions/package-lock.json +77 -45
- package/.pi/harnesses/agent-hub/README.md +116 -16
- 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 +73 -0
- package/.pi/harnesses/agent-hub/index.ts +1095 -465
- 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 +73 -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-dashboard-ops.ts +37 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
- package/.pi/harnesses/package-lock.json +73 -80
- package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.1/.pi/extensions/package.json +9 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.1/.version +1 -0
- package/.versions/1.0.1/agents/architect.md +24 -0
- package/.versions/1.0.1/agents/bowser.md +27 -0
- package/.versions/1.0.1/agents/builder.md +54 -0
- package/.versions/1.0.1/agents/code-reviewer.md +208 -0
- package/.versions/1.0.1/agents/deep-researcher.md +32 -0
- package/.versions/1.0.1/agents/documenter.md +18 -0
- package/.versions/1.0.1/agents/orchestrator.md +72 -0
- package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.1/agents/planner.md +70 -0
- package/.versions/1.0.1/agents/releaser.md +24 -0
- package/.versions/1.0.1/agents/researcher.md +28 -0
- package/.versions/1.0.1/agents/security-auditor.md +167 -0
- package/.versions/1.0.1/agents/test-engineer.md +153 -0
- package/.versions/1.0.1/agents/web-debugger.md +43 -0
- package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.1/docs/getting-started.md +98 -0
- package/.versions/1.0.1/docs/npm-install.md +292 -0
- package/.versions/1.0.1/docs/pi-extensions.md +412 -0
- package/.versions/1.0.1/docs/pi-setup.md +74 -0
- package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.1/hermes/README.md +347 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.1/install-manifest.json +2745 -0
- package/.versions/1.0.1/justfile +272 -0
- package/.versions/1.0.1/manifest-meta.json +882 -0
- package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.1/references/definition-of-done.md +67 -0
- package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.1/references/observability-checklist.md +91 -0
- package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.1/references/performance-checklist.md +153 -0
- package/.versions/1.0.1/references/prompting-patterns.md +380 -0
- package/.versions/1.0.1/references/security-checklist.md +179 -0
- package/.versions/1.0.1/references/testing-patterns.md +236 -0
- package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.1/scripts/fleet.ts +185 -0
- package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.1/scripts/team-up.ts +406 -0
- package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- 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 +15 -0
- package/README.md +4 -2
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +1 -1
- package/agents/orchestrator.md +4 -56
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +1 -1
- 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,484 @@
|
|
|
1
|
+
// scripts/coms-cli.ts
|
|
2
|
+
//
|
|
3
|
+
// Envelope-protocol CLI for non-pi participants in a coms pool. Registry and
|
|
4
|
+
// spool paths are always scoped by a validated project and caller name.
|
|
5
|
+
//
|
|
6
|
+
// usage: coms-cli <list|send|await|reply> [args] --project <p> --name <me>
|
|
7
|
+
|
|
8
|
+
import { spawn } from "node:child_process";
|
|
9
|
+
import * as fs from "node:fs";
|
|
10
|
+
import * as path from "node:path";
|
|
11
|
+
import { fileURLToPath } from "node:url";
|
|
12
|
+
|
|
13
|
+
import {
|
|
14
|
+
bindEndpoint,
|
|
15
|
+
COMS_DIR,
|
|
16
|
+
ensureComsDirs,
|
|
17
|
+
isPromptEnvelope,
|
|
18
|
+
isResponseEnvelope,
|
|
19
|
+
makeConnHandler,
|
|
20
|
+
makeEndpoint,
|
|
21
|
+
makePromptEnvelope,
|
|
22
|
+
makeResponseEnvelope,
|
|
23
|
+
nowIso,
|
|
24
|
+
pruneDeadEntries,
|
|
25
|
+
removeRegistryEntry,
|
|
26
|
+
sendEnvelope,
|
|
27
|
+
ulid,
|
|
28
|
+
validateComsName,
|
|
29
|
+
validateComsProject,
|
|
30
|
+
writeAck,
|
|
31
|
+
writeNack,
|
|
32
|
+
writeRegistryAtomic,
|
|
33
|
+
type RegistryEntry,
|
|
34
|
+
type SenderIdentity,
|
|
35
|
+
} from "./lib/coms-envelope.ts";
|
|
36
|
+
|
|
37
|
+
const DEFAULT_NAME = "claude-cli";
|
|
38
|
+
const DEFAULT_PROJECT = "default";
|
|
39
|
+
const DEFAULT_AWAIT_MS = 300_000;
|
|
40
|
+
const MAX_TIMEOUT_MS = 0x7fffffff;
|
|
41
|
+
const COMS_ID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
|
|
42
|
+
|
|
43
|
+
type FlagName = "project" | "name" | "await" | "timeout" | "all" | "conductor" | "session" | "ttl";
|
|
44
|
+
|
|
45
|
+
interface ParsedArgs {
|
|
46
|
+
positionals: string[];
|
|
47
|
+
flags: Map<FlagName, string | true>;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
interface Scope {
|
|
51
|
+
project: string;
|
|
52
|
+
name: string;
|
|
53
|
+
includeExplicit: boolean;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
interface CodexLock {
|
|
57
|
+
release(): void;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
function fail(message: string): never {
|
|
61
|
+
throw new Error(message);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function parseArgs(argv: string[], allowed: readonly FlagName[]): ParsedArgs {
|
|
65
|
+
const allowedFlags = new Set<FlagName>(allowed);
|
|
66
|
+
const flags = new Map<FlagName, string | true>();
|
|
67
|
+
const positionals: string[] = [];
|
|
68
|
+
for (let i = 0; i < argv.length; i++) {
|
|
69
|
+
const arg = argv[i];
|
|
70
|
+
if (!arg.startsWith("--")) {
|
|
71
|
+
positionals.push(arg);
|
|
72
|
+
continue;
|
|
73
|
+
}
|
|
74
|
+
const flag = arg.slice(2) as FlagName;
|
|
75
|
+
if (!allowedFlags.has(flag)) fail(`unknown flag: ${arg}`);
|
|
76
|
+
if (flags.has(flag)) fail(`--${flag} may only be provided once`);
|
|
77
|
+
if (flag === "await" || flag === "all") {
|
|
78
|
+
flags.set(flag, true);
|
|
79
|
+
continue;
|
|
80
|
+
}
|
|
81
|
+
const value = argv[i + 1];
|
|
82
|
+
if (!value || value.startsWith("--")) fail(`--${flag} requires a value`);
|
|
83
|
+
flags.set(flag, value);
|
|
84
|
+
i++;
|
|
85
|
+
}
|
|
86
|
+
return { positionals, flags };
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function flagValue(parsed: ParsedArgs, flag: FlagName): string | undefined {
|
|
90
|
+
const value = parsed.flags.get(flag);
|
|
91
|
+
return typeof value === "string" ? value : undefined;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
function scopeFrom(parsed: ParsedArgs): Scope {
|
|
95
|
+
const project = validateComsProject(flagValue(parsed, "project") ?? process.env.COMS_CLI_PROJECT ?? DEFAULT_PROJECT);
|
|
96
|
+
const name = validateComsName(flagValue(parsed, "name") ?? process.env.COMS_CLI_NAME ?? DEFAULT_NAME);
|
|
97
|
+
return { project, name, includeExplicit: parsed.flags.get("all") === true };
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function timeoutFrom(parsed: ParsedArgs, flag: "timeout" | "ttl" = "timeout"): number {
|
|
101
|
+
const raw = flagValue(parsed, flag) ?? process.env.PI_COMS_TIMEOUT_MS ?? String(DEFAULT_AWAIT_MS);
|
|
102
|
+
if (!/^\d+$/.test(raw)) fail(`Invalid timeout: ${JSON.stringify(raw)} (use a positive integer no greater than ${MAX_TIMEOUT_MS})`);
|
|
103
|
+
const timeoutMs = Number(raw);
|
|
104
|
+
if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > MAX_TIMEOUT_MS) {
|
|
105
|
+
fail(`Invalid timeout: ${JSON.stringify(raw)} (use a positive integer no greater than ${MAX_TIMEOUT_MS})`);
|
|
106
|
+
}
|
|
107
|
+
return timeoutMs;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function validateComsId(value: string, label: "msg_id" | "listen session"): string {
|
|
111
|
+
if (!COMS_ID_RE.test(value)) fail(`Invalid ${label}: ${JSON.stringify(value)} (expected a 26-character Crockford ULID)`);
|
|
112
|
+
return value;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function spoolDir(project: string, name: string): string {
|
|
116
|
+
return path.join(COMS_DIR, "cli", "projects", validateComsProject(project), validateComsName(name));
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
function legacySpoolDir(name: string): string {
|
|
120
|
+
return path.join(COMS_DIR, "cli", validateComsName(name));
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
function ensureSpool(project: string, name: string): { pending: string; responses: string; inbound: string } {
|
|
124
|
+
const base = spoolDir(project, name);
|
|
125
|
+
const legacy = legacySpoolDir(name);
|
|
126
|
+
// A legacy name-only queue cannot be assigned to a project safely. Refuse
|
|
127
|
+
// rather than consuming it under whichever project happens to run first.
|
|
128
|
+
if (fs.existsSync(legacy)) {
|
|
129
|
+
fail(`Legacy name-only coms spool exists at ${legacy}; stop that identity, inspect the queue, and move the complete directory under cli/projects/<project>/<name> after confirming its project. Do not delete ambiguous pending data.`);
|
|
130
|
+
}
|
|
131
|
+
const dirs = {
|
|
132
|
+
pending: path.join(base, "pending"),
|
|
133
|
+
responses: path.join(base, "responses"),
|
|
134
|
+
inbound: path.join(base, "inbound"),
|
|
135
|
+
};
|
|
136
|
+
for (const dir of Object.values(dirs)) fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
137
|
+
return dirs;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
function peersInScope(scope: Scope): RegistryEntry[] {
|
|
141
|
+
return pruneDeadEntries(scope.project).filter(
|
|
142
|
+
(entry) => entry.name !== scope.name && (scope.includeExplicit || !entry.explicit),
|
|
143
|
+
);
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
function makeIdentity(name: string, sessionId: string): SenderIdentity {
|
|
147
|
+
return { session_id: sessionId, name, endpoint: makeEndpoint(sessionId), cwd: process.cwd() };
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
function registerCliEntry(id: SenderIdentity, project: string, purpose: string): void {
|
|
151
|
+
const entry: RegistryEntry = {
|
|
152
|
+
session_id: id.session_id,
|
|
153
|
+
name: id.name,
|
|
154
|
+
purpose,
|
|
155
|
+
model: "cli",
|
|
156
|
+
color: "#FEDE5D",
|
|
157
|
+
pid: process.pid,
|
|
158
|
+
endpoint: id.endpoint,
|
|
159
|
+
cwd: id.cwd,
|
|
160
|
+
started_at: nowIso(),
|
|
161
|
+
explicit: true,
|
|
162
|
+
version: 1,
|
|
163
|
+
};
|
|
164
|
+
writeRegistryAtomic(entry, project);
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
function acquireCodexLock(scope: Scope): CodexLock {
|
|
168
|
+
const lockDir = path.join(COMS_DIR, "locks");
|
|
169
|
+
const lockPath = path.join(lockDir, "codex-send.lock");
|
|
170
|
+
fs.mkdirSync(lockDir, { recursive: true, mode: 0o700 });
|
|
171
|
+
try { fs.chmodSync(lockDir, 0o700); } catch { /* best effort */ }
|
|
172
|
+
let fd: number;
|
|
173
|
+
try {
|
|
174
|
+
fd = fs.openSync(lockPath, "wx", 0o600);
|
|
175
|
+
} catch (err) {
|
|
176
|
+
if ((err as NodeJS.ErrnoException).code === "EEXIST") {
|
|
177
|
+
fail(`Codex send lock is held (or stale) at ${lockPath}; inspect its metadata and remove it manually only after confirming the owner is gone.`);
|
|
178
|
+
}
|
|
179
|
+
throw err;
|
|
180
|
+
}
|
|
181
|
+
try {
|
|
182
|
+
fs.writeFileSync(fd, `${JSON.stringify({ pid: process.pid, started_at: nowIso(), project: scope.project, name: scope.name })}\n`);
|
|
183
|
+
} finally {
|
|
184
|
+
fs.closeSync(fd);
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
let released = false;
|
|
188
|
+
const release = () => {
|
|
189
|
+
if (released) return;
|
|
190
|
+
released = true;
|
|
191
|
+
process.removeListener("SIGTERM", onSigterm);
|
|
192
|
+
process.removeListener("SIGINT", onSigint);
|
|
193
|
+
try { fs.unlinkSync(lockPath); } catch { /* best effort */ }
|
|
194
|
+
};
|
|
195
|
+
const exitForSignal = (signal: NodeJS.Signals) => {
|
|
196
|
+
release();
|
|
197
|
+
process.exit(signal === "SIGINT" ? 130 : 143);
|
|
198
|
+
};
|
|
199
|
+
const onSigterm = () => exitForSignal("SIGTERM");
|
|
200
|
+
const onSigint = () => exitForSignal("SIGINT");
|
|
201
|
+
process.once("SIGTERM", onSigterm);
|
|
202
|
+
process.once("SIGINT", onSigint);
|
|
203
|
+
return { release };
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
// ━━ list ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
207
|
+
|
|
208
|
+
function cmdList(argv: string[]): void {
|
|
209
|
+
const parsed = parseArgs(argv, ["project", "name", "all"]);
|
|
210
|
+
if (parsed.positionals.length > 0) fail("list does not accept positional arguments");
|
|
211
|
+
const scope = scopeFrom(parsed);
|
|
212
|
+
const peers = peersInScope(scope);
|
|
213
|
+
if (peers.length === 0) {
|
|
214
|
+
console.log(`(no live peers in project "${scope.project}")`);
|
|
215
|
+
return;
|
|
216
|
+
}
|
|
217
|
+
for (const peer of peers) console.log(`${peer.name}\t${peer.model}\t${peer.purpose}`);
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
// ━━ send ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
221
|
+
|
|
222
|
+
function validateCodexMode(parsed: ParsedArgs): boolean {
|
|
223
|
+
const conductor = flagValue(parsed, "conductor");
|
|
224
|
+
if (conductor === undefined) return false;
|
|
225
|
+
if (conductor !== "codex") fail(`Unsupported conductor: ${JSON.stringify(conductor)}`);
|
|
226
|
+
if (!parsed.flags.has("project") || !parsed.flags.has("name") || !parsed.flags.has("timeout") || parsed.flags.get("await") !== true) {
|
|
227
|
+
fail("Codex mode requires explicit --project, --name, --await, and --timeout options.");
|
|
228
|
+
}
|
|
229
|
+
if (parsed.flags.get("all") === true) fail("Codex mode does not allow --all.");
|
|
230
|
+
return true;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
async function cmdSend(argv: string[]): Promise<void> {
|
|
234
|
+
const parsed = parseArgs(argv, ["project", "name", "await", "timeout", "all", "conductor"]);
|
|
235
|
+
const [rawTarget, ...promptParts] = parsed.positionals;
|
|
236
|
+
const prompt = promptParts.join(" ");
|
|
237
|
+
if (!rawTarget || !prompt) fail("usage: coms-cli send <peer> <prompt…> --project <project> --name <name> [--await] [--timeout <ms>]");
|
|
238
|
+
const target = validateComsName(rawTarget);
|
|
239
|
+
const scope = scopeFrom(parsed);
|
|
240
|
+
const timeoutMs = timeoutFrom(parsed);
|
|
241
|
+
const codexMode = validateCodexMode(parsed);
|
|
242
|
+
const lock = codexMode ? acquireCodexLock(scope) : null;
|
|
243
|
+
try {
|
|
244
|
+
// This fresh scoped list is both the only target source and, for Codex,
|
|
245
|
+
// intentionally happens after lock acquisition.
|
|
246
|
+
const peers = peersInScope(scope);
|
|
247
|
+
const peer = peers.find((entry) => entry.name === target);
|
|
248
|
+
if (!peer) {
|
|
249
|
+
const names = peers.map((entry) => entry.name).join(", ") || "(none)";
|
|
250
|
+
fail(`Peer "${target}" not found in project "${scope.project}". Live peers: ${names}`);
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
ensureComsDirs(scope.project);
|
|
254
|
+
const spool = ensureSpool(scope.project, scope.name);
|
|
255
|
+
const doAwait = parsed.flags.get("await") === true;
|
|
256
|
+
if (doAwait) {
|
|
257
|
+
const id = makeIdentity(scope.name, ulid());
|
|
258
|
+
let resolveReply!: (value: { response: unknown; error?: string | null }) => void;
|
|
259
|
+
const reply = new Promise<{ response: unknown; error?: string | null }>((resolve) => { resolveReply = resolve; });
|
|
260
|
+
const server = await bindEndpoint(
|
|
261
|
+
id.endpoint,
|
|
262
|
+
makeConnHandler((env, socket) => {
|
|
263
|
+
if (isResponseEnvelope(env)) {
|
|
264
|
+
writeAck(socket, env.msg_id);
|
|
265
|
+
resolveReply({ response: env.response, error: env.error ?? null });
|
|
266
|
+
} else if ((env as { type?: string }).type === "ping") {
|
|
267
|
+
writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
|
|
268
|
+
} else {
|
|
269
|
+
writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "cli awaits responses only");
|
|
270
|
+
}
|
|
271
|
+
}),
|
|
272
|
+
);
|
|
273
|
+
registerCliEntry(id, scope.project, `coms-cli (one-shot ask from ${scope.name})`);
|
|
274
|
+
const cleanup = () => {
|
|
275
|
+
try { server.close(); } catch { /* ignore */ }
|
|
276
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
277
|
+
removeRegistryEntry(scope.project, id.name);
|
|
278
|
+
};
|
|
279
|
+
try {
|
|
280
|
+
const env = makePromptEnvelope(id, prompt);
|
|
281
|
+
await sendEnvelope(peer.endpoint, env);
|
|
282
|
+
console.error(`sent ${env.msg_id} → ${peer.name} (awaiting reply, timeout ${timeoutMs}ms)`);
|
|
283
|
+
let timeoutTimer!: NodeJS.Timeout;
|
|
284
|
+
const timeout = new Promise<never>((_resolve, reject) => {
|
|
285
|
+
timeoutTimer = setTimeout(() => reject(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs);
|
|
286
|
+
});
|
|
287
|
+
const result = await Promise.race([reply, timeout]).finally(() => clearTimeout(timeoutTimer));
|
|
288
|
+
if (result.error) fail(`peer error: ${result.error}`);
|
|
289
|
+
console.log(typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2));
|
|
290
|
+
} finally {
|
|
291
|
+
cleanup();
|
|
292
|
+
}
|
|
293
|
+
return;
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
const sessionId = ulid();
|
|
297
|
+
const endpoint = makeEndpoint(sessionId);
|
|
298
|
+
const child = spawn(
|
|
299
|
+
process.execPath,
|
|
300
|
+
[
|
|
301
|
+
fileURLToPath(import.meta.url),
|
|
302
|
+
"_listen",
|
|
303
|
+
"--name", scope.name,
|
|
304
|
+
"--project", scope.project,
|
|
305
|
+
"--session", sessionId,
|
|
306
|
+
"--ttl", String(timeoutMs),
|
|
307
|
+
],
|
|
308
|
+
{ detached: true, stdio: ["ignore", "pipe", "ignore"] },
|
|
309
|
+
);
|
|
310
|
+
await new Promise<void>((resolve, reject) => {
|
|
311
|
+
let settled = false;
|
|
312
|
+
const finish = (fn: () => void) => {
|
|
313
|
+
if (settled) return;
|
|
314
|
+
settled = true;
|
|
315
|
+
clearTimeout(timer);
|
|
316
|
+
fn();
|
|
317
|
+
};
|
|
318
|
+
const timer = setTimeout(() => finish(() => reject(new Error("waiter did not become ready"))), 5_000);
|
|
319
|
+
child.stdout!.on("data", (data) => {
|
|
320
|
+
if (data.toString().includes("READY")) finish(resolve);
|
|
321
|
+
});
|
|
322
|
+
child.once("exit", () => finish(() => reject(new Error("waiter exited early"))));
|
|
323
|
+
});
|
|
324
|
+
child.unref();
|
|
325
|
+
child.stdout!.destroy();
|
|
326
|
+
|
|
327
|
+
const id: SenderIdentity = { session_id: sessionId, name: scope.name, endpoint, cwd: process.cwd() };
|
|
328
|
+
const env = makePromptEnvelope(id, prompt);
|
|
329
|
+
const pendingFile = path.join(spool.pending, `${env.msg_id}.json`);
|
|
330
|
+
fs.writeFileSync(pendingFile, JSON.stringify({ msg_id: env.msg_id, target: peer.name, sent_at: nowIso() }));
|
|
331
|
+
try {
|
|
332
|
+
await sendEnvelope(peer.endpoint, env);
|
|
333
|
+
} catch (err) {
|
|
334
|
+
try { fs.unlinkSync(pendingFile); } catch { /* ignore */ }
|
|
335
|
+
try { if (child.pid) process.kill(-child.pid, "SIGTERM"); } catch { /* ignore */ }
|
|
336
|
+
fail(`send failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
337
|
+
}
|
|
338
|
+
console.log(env.msg_id);
|
|
339
|
+
} finally {
|
|
340
|
+
lock?.release();
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
// ━━ _listen (internal detached waiter) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
345
|
+
|
|
346
|
+
async function cmdListen(argv: string[]): Promise<void> {
|
|
347
|
+
const parsed = parseArgs(argv, ["project", "name", "session", "ttl"]);
|
|
348
|
+
if (parsed.positionals.length > 0) fail("_listen does not accept positional arguments");
|
|
349
|
+
const scope = scopeFrom(parsed);
|
|
350
|
+
const sessionId = validateComsId(flagValue(parsed, "session") ?? ulid(), "listen session");
|
|
351
|
+
const ttl = timeoutFrom(parsed, "ttl");
|
|
352
|
+
ensureComsDirs(scope.project);
|
|
353
|
+
const spool = ensureSpool(scope.project, scope.name);
|
|
354
|
+
const id = makeIdentity(scope.name, sessionId);
|
|
355
|
+
|
|
356
|
+
const server = await bindEndpoint(
|
|
357
|
+
id.endpoint,
|
|
358
|
+
makeConnHandler((env, socket) => {
|
|
359
|
+
if (isResponseEnvelope(env) && typeof env.msg_id === "string" && COMS_ID_RE.test(env.msg_id)) {
|
|
360
|
+
writeAck(socket, env.msg_id);
|
|
361
|
+
fs.writeFileSync(
|
|
362
|
+
path.join(spool.responses, `${env.msg_id}.json`),
|
|
363
|
+
JSON.stringify({ response: env.response, error: env.error ?? null, received_at: nowIso() }),
|
|
364
|
+
);
|
|
365
|
+
try { fs.unlinkSync(path.join(spool.pending, `${env.msg_id}.json`)); } catch { /* ignore */ }
|
|
366
|
+
maybeExit();
|
|
367
|
+
} else if (isPromptEnvelope(env) && typeof env.msg_id === "string" && COMS_ID_RE.test(env.msg_id)) {
|
|
368
|
+
writeAck(socket, env.msg_id);
|
|
369
|
+
fs.writeFileSync(
|
|
370
|
+
path.join(spool.inbound, `${env.msg_id}.json`),
|
|
371
|
+
JSON.stringify({
|
|
372
|
+
msg_id: env.msg_id,
|
|
373
|
+
prompt: env.prompt,
|
|
374
|
+
sender_name: env.sender_name,
|
|
375
|
+
sender_endpoint: env.sender_endpoint,
|
|
376
|
+
sender_session: env.sender_session,
|
|
377
|
+
hops: env.hops,
|
|
378
|
+
received_at: nowIso(),
|
|
379
|
+
}),
|
|
380
|
+
);
|
|
381
|
+
} else if ((env as { type?: string }).type === "ping") {
|
|
382
|
+
writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
|
|
383
|
+
} else {
|
|
384
|
+
writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "unsupported envelope or msg_id");
|
|
385
|
+
}
|
|
386
|
+
}),
|
|
387
|
+
);
|
|
388
|
+
registerCliEntry(id, scope.project, "coms-cli reply waiter");
|
|
389
|
+
console.log("READY");
|
|
390
|
+
|
|
391
|
+
const cleanup = () => {
|
|
392
|
+
try { server.close(); } catch { /* ignore */ }
|
|
393
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
394
|
+
removeRegistryEntry(scope.project, id.name);
|
|
395
|
+
process.exit(0);
|
|
396
|
+
};
|
|
397
|
+
const startedAt = Date.now();
|
|
398
|
+
function maybeExit(): void {
|
|
399
|
+
try {
|
|
400
|
+
const pendingLeft = fs.readdirSync(spool.pending).length;
|
|
401
|
+
if (pendingLeft === 0 && Date.now() - startedAt > 3_000) cleanup();
|
|
402
|
+
} catch {
|
|
403
|
+
// Best-effort cleanup only; the TTL remains authoritative.
|
|
404
|
+
}
|
|
405
|
+
}
|
|
406
|
+
setInterval(maybeExit, 5_000);
|
|
407
|
+
setTimeout(cleanup, ttl);
|
|
408
|
+
process.on("SIGTERM", cleanup);
|
|
409
|
+
process.on("SIGINT", cleanup);
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
// ━━ await ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
413
|
+
|
|
414
|
+
async function cmdAwait(argv: string[]): Promise<void> {
|
|
415
|
+
const parsed = parseArgs(argv, ["project", "name", "timeout"]);
|
|
416
|
+
if (parsed.positionals.length !== 1) fail("usage: coms-cli await <msg_id> --project <project> --name <name> [--timeout <ms>]");
|
|
417
|
+
const msgId = validateComsId(parsed.positionals[0], "msg_id");
|
|
418
|
+
const scope = scopeFrom(parsed);
|
|
419
|
+
const timeoutMs = timeoutFrom(parsed);
|
|
420
|
+
const spool = ensureSpool(scope.project, scope.name);
|
|
421
|
+
const file = path.join(spool.responses, `${msgId}.json`);
|
|
422
|
+
const deadline = Date.now() + timeoutMs;
|
|
423
|
+
while (Date.now() < deadline) {
|
|
424
|
+
if (fs.existsSync(file)) {
|
|
425
|
+
const record = JSON.parse(fs.readFileSync(file, "utf-8"));
|
|
426
|
+
if (record.error) fail(`peer error: ${record.error}`);
|
|
427
|
+
console.log(typeof record.response === "string" ? record.response : JSON.stringify(record.response, null, 2));
|
|
428
|
+
return;
|
|
429
|
+
}
|
|
430
|
+
await new Promise((resolve) => setTimeout(resolve, 500));
|
|
431
|
+
}
|
|
432
|
+
fail(`timeout: no reply for ${msgId} after ${timeoutMs}ms`);
|
|
433
|
+
}
|
|
434
|
+
|
|
435
|
+
// ━━ reply ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
436
|
+
|
|
437
|
+
async function cmdReply(argv: string[]): Promise<void> {
|
|
438
|
+
const parsed = parseArgs(argv, ["project", "name"]);
|
|
439
|
+
const [rawMsgId, ...textParts] = parsed.positionals;
|
|
440
|
+
const msgId = rawMsgId ? validateComsId(rawMsgId, "msg_id") : undefined;
|
|
441
|
+
const scope = scopeFrom(parsed);
|
|
442
|
+
let text = textParts.join(" ");
|
|
443
|
+
if (!text && !process.stdin.isTTY) text = fs.readFileSync(0, "utf-8").trim();
|
|
444
|
+
if (!msgId || !text) fail("usage: coms-cli reply <msg_id> <text…> --project <project> --name <name> (or pipe the text on stdin)");
|
|
445
|
+
const spool = ensureSpool(scope.project, scope.name);
|
|
446
|
+
const recordFile = path.join(spool.inbound, `${msgId}.json`);
|
|
447
|
+
if (!fs.existsSync(recordFile)) fail(`No inbound prompt ${msgId} in ${spool.inbound}`);
|
|
448
|
+
const record = JSON.parse(fs.readFileSync(recordFile, "utf-8"));
|
|
449
|
+
const id = makeIdentity(scope.name, ulid());
|
|
450
|
+
await sendEnvelope(record.sender_endpoint, makeResponseEnvelope(id, msgId, text));
|
|
451
|
+
fs.unlinkSync(recordFile);
|
|
452
|
+
console.log(`replied to ${record.sender_name ?? record.sender_session} (${msgId})`);
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
async function main(): Promise<void> {
|
|
456
|
+
const [command, ...rest] = process.argv.slice(2);
|
|
457
|
+
switch (command) {
|
|
458
|
+
case "list":
|
|
459
|
+
cmdList(rest);
|
|
460
|
+
return;
|
|
461
|
+
case "send":
|
|
462
|
+
await cmdSend(rest);
|
|
463
|
+
return;
|
|
464
|
+
case "await":
|
|
465
|
+
await cmdAwait(rest);
|
|
466
|
+
return;
|
|
467
|
+
case "reply":
|
|
468
|
+
await cmdReply(rest);
|
|
469
|
+
return;
|
|
470
|
+
case "_listen":
|
|
471
|
+
await cmdListen(rest);
|
|
472
|
+
return;
|
|
473
|
+
default:
|
|
474
|
+
fail("usage: coms-cli <list|send|await|reply> …");
|
|
475
|
+
}
|
|
476
|
+
}
|
|
477
|
+
|
|
478
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
479
|
+
if (isEntry) {
|
|
480
|
+
void main().catch((err) => {
|
|
481
|
+
console.error(err instanceof Error ? err.message : String(err));
|
|
482
|
+
process.exitCode = 1;
|
|
483
|
+
});
|
|
484
|
+
}
|