@chankov/agent-fleet 1.0.2 → 1.0.4
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/harnesses/agent-hub/README.md +85 -71
- package/.pi/harnesses/agent-hub/context-window.js +1 -1
- package/.pi/harnesses/agent-hub/delegate.ts +14 -3
- package/.pi/harnesses/agent-hub/drift-watchdog.js +11 -4
- package/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
- package/.pi/harnesses/agent-hub/footer.ts +3 -2
- package/.pi/harnesses/agent-hub/hub-state-audit.js +0 -14
- package/.pi/harnesses/agent-hub/index.ts +562 -300
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
- package/.pi/harnesses/agent-hub/run-budget.js +67 -69
- package/.pi/harnesses/agent-hub/spawn.ts +25 -3
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +2 -2
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
- package/.pi/harnesses/lib/fleet-detail-view.ts +134 -20
- package/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.pi/prompts/af-plan.md +6 -5
- package/.versions/1.0.3/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.3/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.3/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.3/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.3/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.3/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.3/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.3/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.3/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.3/.pi/extensions/package-lock.json +1175 -0
- package/.versions/1.0.3/.pi/extensions/package.json +9 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/README.md +1156 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/footer.ts +36 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/index.ts +9999 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/posture.ts +158 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/spawn.ts +366 -0
- package/.versions/1.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/1.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.3/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.3/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.3/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.3/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/1.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/1.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/1.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/1.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-detail-view.ts +168 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.3/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/1.0.3/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.3/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.3/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.3/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.3/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.3/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.3/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.3/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.3/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.3/.version +1 -0
- package/.versions/1.0.3/agents/architect.md +25 -0
- package/.versions/1.0.3/agents/bowser.md +28 -0
- package/.versions/1.0.3/agents/builder.md +55 -0
- package/.versions/1.0.3/agents/code-reviewer.md +209 -0
- package/.versions/1.0.3/agents/deep-researcher.md +33 -0
- package/.versions/1.0.3/agents/documenter.md +19 -0
- package/.versions/1.0.3/agents/orchestrator.md +21 -0
- package/.versions/1.0.3/agents/plan-reviewer.md +84 -0
- package/.versions/1.0.3/agents/planner.md +71 -0
- package/.versions/1.0.3/agents/releaser.md +25 -0
- package/.versions/1.0.3/agents/researcher.md +29 -0
- package/.versions/1.0.3/agents/security-auditor.md +168 -0
- package/.versions/1.0.3/agents/test-engineer.md +154 -0
- package/.versions/1.0.3/agents/web-debugger.md +44 -0
- package/.versions/1.0.3/agents/web-performance-auditor.md +194 -0
- package/.versions/1.0.3/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.3/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.3/docs/ARCHITECTURE.md +375 -0
- package/.versions/1.0.3/docs/agent-fleet-setup.md +468 -0
- package/.versions/1.0.3/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.3/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.3/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.3/docs/getting-started.md +98 -0
- package/.versions/1.0.3/docs/npm-install.md +292 -0
- package/.versions/1.0.3/docs/pi-extensions.md +441 -0
- package/.versions/1.0.3/docs/pi-setup.md +74 -0
- package/.versions/1.0.3/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.3/hermes/README.md +347 -0
- package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.3/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.3/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.3/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.3/install-manifest.json +2745 -0
- package/.versions/1.0.3/justfile +272 -0
- package/.versions/1.0.3/manifest-meta.json +882 -0
- package/.versions/1.0.3/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.3/references/definition-of-done.md +67 -0
- package/.versions/1.0.3/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.3/references/observability-checklist.md +91 -0
- package/.versions/1.0.3/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.3/references/performance-checklist.md +153 -0
- package/.versions/1.0.3/references/prompting-patterns.md +380 -0
- package/.versions/1.0.3/references/security-checklist.md +179 -0
- package/.versions/1.0.3/references/testing-patterns.md +236 -0
- package/.versions/1.0.3/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.3/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.3/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.3/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.3/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.3/scripts/fleet.ts +185 -0
- package/.versions/1.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.3/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.3/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.3/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.3/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.3/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.3/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.3/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.3/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.3/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.3/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.3/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.3/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.3/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.3/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.3/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.3/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.3/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.3/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.3/scripts/team-up.ts +406 -0
- package/.versions/1.0.3/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.3/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.3/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.3/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.3/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.3/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.3/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.3/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.3/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.3/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.3/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.3/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.3/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.3/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.3/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.3/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.3/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.3/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/1.0.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.4/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.4/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.4/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.4/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/package-lock.json +1175 -0
- package/.versions/1.0.4/.pi/extensions/package.json +9 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/README.md +1170 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/footer.ts +36 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/index.ts +10171 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/posture.ts +158 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/1.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.4/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.4/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.4/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/1.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/1.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.4/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/1.0.4/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.4/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.4/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.4/.pi/prompts/af-plan.md +17 -0
- package/.versions/1.0.4/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.4/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.4/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.4/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.4/.version +1 -0
- package/.versions/1.0.4/agents/architect.md +25 -0
- package/.versions/1.0.4/agents/bowser.md +28 -0
- package/.versions/1.0.4/agents/builder.md +56 -0
- package/.versions/1.0.4/agents/code-reviewer.md +209 -0
- package/.versions/1.0.4/agents/deep-researcher.md +33 -0
- package/.versions/1.0.4/agents/documenter.md +19 -0
- package/.versions/1.0.4/agents/orchestrator.md +21 -0
- package/.versions/1.0.4/agents/plan-reviewer.md +84 -0
- package/.versions/1.0.4/agents/planner.md +71 -0
- package/.versions/1.0.4/agents/releaser.md +25 -0
- package/.versions/1.0.4/agents/researcher.md +29 -0
- package/.versions/1.0.4/agents/security-auditor.md +168 -0
- package/.versions/1.0.4/agents/test-engineer.md +154 -0
- package/.versions/1.0.4/agents/web-debugger.md +44 -0
- package/.versions/1.0.4/agents/web-performance-auditor.md +194 -0
- package/.versions/1.0.4/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.4/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.4/docs/ARCHITECTURE.md +375 -0
- package/.versions/1.0.4/docs/agent-fleet-setup.md +468 -0
- package/.versions/1.0.4/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.4/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.4/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.4/docs/getting-started.md +98 -0
- package/.versions/1.0.4/docs/npm-install.md +292 -0
- package/.versions/1.0.4/docs/pi-extensions.md +441 -0
- package/.versions/1.0.4/docs/pi-setup.md +74 -0
- package/.versions/1.0.4/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.4/hermes/README.md +347 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.4/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.4/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.4/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.4/install-manifest.json +2745 -0
- package/.versions/1.0.4/justfile +272 -0
- package/.versions/1.0.4/manifest-meta.json +882 -0
- package/.versions/1.0.4/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.4/references/definition-of-done.md +67 -0
- package/.versions/1.0.4/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.4/references/observability-checklist.md +91 -0
- package/.versions/1.0.4/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.4/references/performance-checklist.md +153 -0
- package/.versions/1.0.4/references/prompting-patterns.md +380 -0
- package/.versions/1.0.4/references/security-checklist.md +179 -0
- package/.versions/1.0.4/references/testing-patterns.md +236 -0
- package/.versions/1.0.4/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.4/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.4/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.4/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.4/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.4/scripts/fleet.ts +185 -0
- package/.versions/1.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.4/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.4/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.4/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.4/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.4/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.4/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.4/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.4/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.4/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.4/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.4/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.4/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.4/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.4/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.4/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.4/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.4/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.4/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.4/scripts/team-up.ts +406 -0
- package/.versions/1.0.4/skills/_internal/grilling.md +59 -0
- package/.versions/1.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.4/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.4/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.4/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.4/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/1.0.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.4/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.4/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.4/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/1.0.4/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.4/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/1.0.4/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/1.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +13 -0
- package/README.md +5 -4
- package/agents/architect.md +1 -0
- package/agents/bowser.md +1 -0
- package/agents/builder.md +2 -0
- package/agents/code-reviewer.md +1 -0
- package/agents/deep-researcher.md +1 -0
- package/agents/documenter.md +1 -0
- package/agents/orchestrator.md +1 -0
- package/agents/plan-reviewer.md +1 -0
- package/agents/planner.md +2 -1
- package/agents/releaser.md +1 -0
- package/agents/researcher.md +1 -0
- package/agents/security-auditor.md +1 -0
- package/agents/test-engineer.md +1 -0
- package/agents/web-debugger.md +1 -0
- package/agents/web-performance-auditor.md +1 -0
- package/bin/lib/validate-overrides.js +1 -1
- package/docs/ARCHITECTURE.md +25 -19
- package/docs/agent-fleet-setup.md +8 -8
- package/docs/pi-extensions.md +4 -2
- package/install-manifest.json +3 -3
- package/package.json +2 -2
- package/scripts/fleet.ts +1 -1
- package/skills/_internal/grilling.md +53 -5
- package/skills/idea-refine/SKILL.md +2 -2
- package/skills/incremental-implementation/SKILL.md +12 -1
- package/skills/planning-and-task-breakdown/SKILL.md +14 -5
- package/skills/spec-driven-development/SKILL.md +10 -11
- package/skills/using-agent-skills/SKILL.md +13 -15
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
#
|
|
3
|
+
# Install one in-repo Hermes plugin into a Hermes profile.
|
|
4
|
+
#
|
|
5
|
+
# scripts/install-hermes-plugin.sh agent-fleet-herdr [--profile default]
|
|
6
|
+
# [--copy] [--uninstall] [--force] [--dry-run]
|
|
7
|
+
#
|
|
8
|
+
# A plugin has up to two halves, installed into the profile the same way:
|
|
9
|
+
#
|
|
10
|
+
# hermes/plugins/<id>/ -> <profile>/plugins/<id> (backend, FastAPI)
|
|
11
|
+
# hermes/desktop-plugins/<id>/ -> <profile>/desktop-plugins/<id> (Desktop pane, ESM)
|
|
12
|
+
#
|
|
13
|
+
# Symlinked at DIRECTORY level, never file by file: web_server.py requires the
|
|
14
|
+
# api file to resolve inside its own dashboard directory, so linking just
|
|
15
|
+
# `plugin_api.py` into a real directory makes the backend fail `relative_to`
|
|
16
|
+
# and be skipped in silence. `--copy` opts out of symlinks entirely.
|
|
17
|
+
#
|
|
18
|
+
# The script never restarts anything. The two halves have different reload
|
|
19
|
+
# rules — plugin.js is watched and hot-reloads, but routers are only included
|
|
20
|
+
# when the app is constructed — so it prints the exact steps and lets a human
|
|
21
|
+
# decide when the gateway goes down.
|
|
22
|
+
|
|
23
|
+
set -euo pipefail
|
|
24
|
+
|
|
25
|
+
PLUGIN_ID=""
|
|
26
|
+
PROFILE="${HERMES_PROFILE:-default}"
|
|
27
|
+
MODE="install"
|
|
28
|
+
LINK=1
|
|
29
|
+
FORCE=0
|
|
30
|
+
DRY_RUN=0
|
|
31
|
+
|
|
32
|
+
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
|
33
|
+
HERMES_SOURCE="${HERMES_SOURCE:-$HOME/.hermes/hermes-agent}"
|
|
34
|
+
|
|
35
|
+
die() { printf 'error: %s\n' "$1" >&2; exit 1; }
|
|
36
|
+
note() { printf ' %s\n' "$1"; }
|
|
37
|
+
run() { if [ "$DRY_RUN" = 1 ]; then printf ' [dry-run] %s\n' "$*"; else "$@"; fi; }
|
|
38
|
+
|
|
39
|
+
usage() {
|
|
40
|
+
sed -n '3,22p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
|
|
41
|
+
exit "${1:-0}"
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
while [ $# -gt 0 ]; do
|
|
45
|
+
case "$1" in
|
|
46
|
+
--profile) PROFILE="${2:-}"; [ -n "$PROFILE" ] || die "--profile needs a name"; shift 2 ;;
|
|
47
|
+
--profile=*) PROFILE="${1#*=}"; shift ;;
|
|
48
|
+
--copy) LINK=0; shift ;;
|
|
49
|
+
--uninstall) MODE="uninstall"; shift ;;
|
|
50
|
+
--force) FORCE=1; shift ;;
|
|
51
|
+
--dry-run) DRY_RUN=1; shift ;;
|
|
52
|
+
-h|--help) usage 0 ;;
|
|
53
|
+
-*) die "unknown option: $1" ;;
|
|
54
|
+
*) [ -z "$PLUGIN_ID" ] || die "one plugin id at a time (got '$PLUGIN_ID' and '$1')"; PLUGIN_ID="$1"; shift ;;
|
|
55
|
+
esac
|
|
56
|
+
done
|
|
57
|
+
|
|
58
|
+
[ -n "$PLUGIN_ID" ] || usage 1
|
|
59
|
+
# The Desktop loader keys the plugin by its folder name, so an id with a path
|
|
60
|
+
# separator would install a plugin that can never load.
|
|
61
|
+
case "$PLUGIN_ID" in *[!A-Za-z0-9._-]*) die "unsafe plugin id: $PLUGIN_ID" ;; esac
|
|
62
|
+
|
|
63
|
+
command -v hermes >/dev/null 2>&1 || die "hermes CLI not found on PATH"
|
|
64
|
+
|
|
65
|
+
BACKEND_SRC="$REPO_ROOT/hermes/plugins/$PLUGIN_ID"
|
|
66
|
+
DESKTOP_SRC="$REPO_ROOT/hermes/desktop-plugins/$PLUGIN_ID"
|
|
67
|
+
[ -d "$BACKEND_SRC" ] || [ -d "$DESKTOP_SRC" ] || die "no such plugin in this repo: $PLUGIN_ID"
|
|
68
|
+
|
|
69
|
+
# `hermes profile show` is the only authority on where a profile lives; the
|
|
70
|
+
# Desktop loader reads the same path from gateway status as `hermes home`.
|
|
71
|
+
PROFILE_PATH="$(hermes profile show "$PROFILE" 2>/dev/null | sed -n 's/^Path:[[:space:]]*//p' | head -1)"
|
|
72
|
+
[ -n "$PROFILE_PATH" ] || die "cannot resolve Hermes profile '$PROFILE' (try: hermes profile list)"
|
|
73
|
+
[ -d "$PROFILE_PATH" ] || die "profile path does not exist: $PROFILE_PATH"
|
|
74
|
+
|
|
75
|
+
printf 'plugin %s\nprofile %s (%s)\nmode %s%s\n\n' \
|
|
76
|
+
"$PLUGIN_ID" "$PROFILE" "$PROFILE_PATH" "$MODE" "$([ "$LINK" = 1 ] && echo ' via symlink' || echo ' via copy')"
|
|
77
|
+
|
|
78
|
+
backup_config() {
|
|
79
|
+
local config="$PROFILE_PATH/config.yaml"
|
|
80
|
+
[ -f "$config" ] || { note "no config.yaml to back up"; return 0; }
|
|
81
|
+
local backup_dir="$PROFILE_PATH/backups/agent-fleet"
|
|
82
|
+
run mkdir -p "$backup_dir"
|
|
83
|
+
local backup="$backup_dir/config.yaml.$(date +%Y%m%dT%H%M%S)"
|
|
84
|
+
run cp -p "$config" "$backup"
|
|
85
|
+
note "backed up config.yaml -> $backup"
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
# One half of the plugin: repo directory -> profile directory.
|
|
89
|
+
install_half() {
|
|
90
|
+
local src="$1" dest_parent="$2" label="$3"
|
|
91
|
+
[ -d "$src" ] || { note "no $label half in this repo — skipped"; return 0; }
|
|
92
|
+
local dest="$dest_parent/$PLUGIN_ID"
|
|
93
|
+
run mkdir -p "$dest_parent"
|
|
94
|
+
if [ -L "$dest" ]; then
|
|
95
|
+
run rm "$dest"
|
|
96
|
+
elif [ -e "$dest" ]; then
|
|
97
|
+
[ "$FORCE" = 1 ] || die "$dest exists and is not a symlink; re-run with --force to replace it"
|
|
98
|
+
run rm -rf "$dest"
|
|
99
|
+
fi
|
|
100
|
+
if [ "$LINK" = 1 ]; then
|
|
101
|
+
run ln -s "$src" "$dest"
|
|
102
|
+
note "$label: $dest -> $src"
|
|
103
|
+
else
|
|
104
|
+
run cp -R "$src" "$dest"
|
|
105
|
+
note "$label: copied to $dest"
|
|
106
|
+
fi
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
uninstall_half() {
|
|
110
|
+
local dest_parent="$1" label="$2"
|
|
111
|
+
local dest="$dest_parent/$PLUGIN_ID"
|
|
112
|
+
if [ -L "$dest" ]; then
|
|
113
|
+
run rm "$dest"
|
|
114
|
+
note "$label: removed symlink $dest"
|
|
115
|
+
elif [ -d "$dest" ]; then
|
|
116
|
+
[ "$FORCE" = 1 ] || { note "$label: $dest is a real directory — left in place (use --force to delete)"; return 0; }
|
|
117
|
+
run rm -rf "$dest"
|
|
118
|
+
note "$label: removed $dest"
|
|
119
|
+
else
|
|
120
|
+
note "$label: nothing installed"
|
|
121
|
+
fi
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
# The acceptance check from the plan, run WITHOUT touching the live gateway:
|
|
125
|
+
# discovery must see the dashboard half with an api file, and the enable record
|
|
126
|
+
# must exist. Both are required — either one missing yields the same 404.
|
|
127
|
+
verify_backend() {
|
|
128
|
+
local python="$HERMES_SOURCE/venv/bin/python"
|
|
129
|
+
if [ ! -x "$python" ]; then
|
|
130
|
+
note "skipped backend verification: no interpreter at $python (set HERMES_SOURCE)"
|
|
131
|
+
return 0
|
|
132
|
+
fi
|
|
133
|
+
if [ "$DRY_RUN" = 1 ]; then
|
|
134
|
+
note "[dry-run] would verify discovery + enable record"
|
|
135
|
+
return 0
|
|
136
|
+
fi
|
|
137
|
+
HERMES_HOME="$PROFILE_PATH" HERMES_SOURCE="$HERMES_SOURCE" "$python" - "$PLUGIN_ID" <<'PY'
|
|
138
|
+
import os
|
|
139
|
+
import sys
|
|
140
|
+
sys.path.insert(0, os.environ["HERMES_SOURCE"])
|
|
141
|
+
from hermes_cli.plugins_cmd import _get_enabled_set
|
|
142
|
+
from hermes_cli.web_server import _discover_dashboard_plugins
|
|
143
|
+
|
|
144
|
+
name = sys.argv[1]
|
|
145
|
+
found = [p for p in _discover_dashboard_plugins() if p["name"] == name]
|
|
146
|
+
enabled = name in _get_enabled_set()
|
|
147
|
+
has_api = bool(found and found[0].get("has_api"))
|
|
148
|
+
print(f" discovery: {'ok' if has_api else 'MISSING'} (records={len(found)}, has_api={has_api})")
|
|
149
|
+
print(f" enabled: {'ok' if enabled else 'MISSING'}")
|
|
150
|
+
sys.exit(0 if has_api and enabled else 1)
|
|
151
|
+
PY
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
if [ "$MODE" = "install" ]; then
|
|
155
|
+
backup_config
|
|
156
|
+
install_half "$BACKEND_SRC" "$PROFILE_PATH/plugins" "backend"
|
|
157
|
+
install_half "$DESKTOP_SRC" "$PROFILE_PATH/desktop-plugins" "desktop"
|
|
158
|
+
if [ -d "$BACKEND_SRC" ]; then
|
|
159
|
+
# Without this record every request to /api/plugins/<id>/* is refused by
|
|
160
|
+
# middleware before routing — a 404 that looks exactly like "not mounted".
|
|
161
|
+
run hermes --profile "$PROFILE" plugins enable "$PLUGIN_ID" --no-allow-tool-override
|
|
162
|
+
verify_backend || die "backend not ready — see the two lines above"
|
|
163
|
+
fi
|
|
164
|
+
printf '\nNext (not done for you):\n'
|
|
165
|
+
if [ -d "$BACKEND_SRC" ]; then
|
|
166
|
+
# Two gateways: `hermes gateway restart` covers the user service (Telegram,
|
|
167
|
+
# TUI, web dashboard), but the Desktop pane calls the gateway that
|
|
168
|
+
# `hermes desktop` spawns for itself — and routers only mount at boot.
|
|
169
|
+
printf ' restart the Hermes Desktop app # its own gateway serves ctx.rest() for the pane\n'
|
|
170
|
+
printf ' hermes --profile %s gateway restart # only if the web dashboard / TUI needs the routes\n' "$PROFILE"
|
|
171
|
+
fi
|
|
172
|
+
if [ -d "$DESKTOP_SRC" ]; then printf ' plugin.js itself hot-reloads within ~5s — no restart needed for pane edits\n'; fi
|
|
173
|
+
else
|
|
174
|
+
run hermes --profile "$PROFILE" plugins disable "$PLUGIN_ID" || note "plugins disable reported an error — continuing"
|
|
175
|
+
uninstall_half "$PROFILE_PATH/plugins" "backend"
|
|
176
|
+
uninstall_half "$PROFILE_PATH/desktop-plugins" "desktop"
|
|
177
|
+
printf '\nNext (not done for you):\n'
|
|
178
|
+
printf ' restart the Hermes Desktop app # unmounts the routers the pane was using\n'
|
|
179
|
+
printf ' hermes --profile %s gateway restart # unmounts them in the service gateway too\n' "$PROFILE"
|
|
180
|
+
fi
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
// scripts/lib/claude-bridge-core.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for the Claude Code coms bridge (scripts/coms-claude-bridge.ts):
|
|
4
|
+
// prompt formatting, completion sentinels, hook-record parsing, reply
|
|
5
|
+
// extraction from pane text, and the serial prompt queue. No sockets, no fs,
|
|
6
|
+
// no herdr — everything here runs under node --test.
|
|
7
|
+
|
|
8
|
+
export const SENTINEL_PREFIX = "<<COMS_DONE:";
|
|
9
|
+
|
|
10
|
+
// ── reply-timeout and idle-wait policy ──
|
|
11
|
+
//
|
|
12
|
+
// Two field failures live here. First, the bridge only ever read its own
|
|
13
|
+
// --reply-timeout: a caller that asked for 1_800_000ms was still told "no reply
|
|
14
|
+
// within 600000ms", so a review that honestly takes more than ten minutes could
|
|
15
|
+
// not succeed at all. Second, a pane that was mid-turn threw instantly, which
|
|
16
|
+
// turned every busy moment into a hard error — ten of eighteen coms_await calls
|
|
17
|
+
// in one session died that way, the caller hot-retried every few seconds, and
|
|
18
|
+
// then fell back to reading the pane 127 times to watch progress by hand.
|
|
19
|
+
|
|
20
|
+
/** No caller may hold a pane hostage indefinitely. */
|
|
21
|
+
export const REPLY_TIMEOUT_HARD_CAP_MS = 3_600_000;
|
|
22
|
+
|
|
23
|
+
/** Backoff while waiting for a busy pane, in ms; the last step repeats. */
|
|
24
|
+
export const IDLE_WAIT_BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
|
|
25
|
+
|
|
26
|
+
/** Longest we will ever wait for a pane to go idle before giving up. */
|
|
27
|
+
export const IDLE_WAIT_CAP_MS = 120_000;
|
|
28
|
+
|
|
29
|
+
/** A bridge process starts before `claude` in the shared shell recipe. */
|
|
30
|
+
export const CLAUDE_STARTUP_REGISTRATION_SLACK_MS = 5_000;
|
|
31
|
+
export const CLAUDE_STARTUP_TIMEOUT_MS = 40_000;
|
|
32
|
+
export const CLAUDE_STARTUP_POLL_MS = 250;
|
|
33
|
+
|
|
34
|
+
export interface ClaudePaneState {
|
|
35
|
+
agent?: unknown;
|
|
36
|
+
agent_status?: unknown;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Registration is readiness only after Herdr has detected the Claude process. */
|
|
40
|
+
export function isClaudePaneReady(pane: ClaudePaneState): boolean {
|
|
41
|
+
const agent = String(pane.agent ?? "").toLowerCase();
|
|
42
|
+
const status = String(pane.agent_status ?? "unknown").toLowerCase();
|
|
43
|
+
return agent === "claude" && ["idle", "working", "blocked", "done"].includes(status);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export async function waitForClaudePaneReady(
|
|
47
|
+
probe: () => Promise<ClaudePaneState>,
|
|
48
|
+
options: {
|
|
49
|
+
timeoutMs?: number;
|
|
50
|
+
pollMs?: number;
|
|
51
|
+
now?: () => number;
|
|
52
|
+
sleep?: (ms: number) => Promise<void>;
|
|
53
|
+
} = {},
|
|
54
|
+
): Promise<{ ready: boolean; waitedMs: number; last: ClaudePaneState | null }> {
|
|
55
|
+
const timeoutMs = Math.max(0, options.timeoutMs ?? CLAUDE_STARTUP_TIMEOUT_MS);
|
|
56
|
+
const pollMs = Math.max(1, options.pollMs ?? CLAUDE_STARTUP_POLL_MS);
|
|
57
|
+
const now = options.now ?? Date.now;
|
|
58
|
+
const sleep = options.sleep ?? ((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));
|
|
59
|
+
const startedAt = now();
|
|
60
|
+
let last: ClaudePaneState | null = null;
|
|
61
|
+
for (;;) {
|
|
62
|
+
try {
|
|
63
|
+
last = await probe();
|
|
64
|
+
if (isClaudePaneReady(last)) return { ready: true, waitedMs: now() - startedAt, last };
|
|
65
|
+
} catch {
|
|
66
|
+
// Herdr may briefly race pane creation; retry inside the bounded startup window.
|
|
67
|
+
}
|
|
68
|
+
const remaining = timeoutMs - (now() - startedAt);
|
|
69
|
+
if (remaining <= 0) return { ready: false, waitedMs: now() - startedAt, last };
|
|
70
|
+
await sleep(Math.min(pollMs, remaining));
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* The caller's own deadline wins — it knows how long the work takes — falling
|
|
76
|
+
* back to the bridge's configured timeout and always clamped to the hard cap.
|
|
77
|
+
*/
|
|
78
|
+
export function resolveReplyTimeoutMs(requested: unknown, fallbackMs: number, capMs = REPLY_TIMEOUT_HARD_CAP_MS): number {
|
|
79
|
+
const asked = Number(requested);
|
|
80
|
+
const base = Number.isFinite(asked) && asked > 0 ? asked : fallbackMs;
|
|
81
|
+
return Math.max(1, Math.min(base, capMs));
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/** One absolute deadline shared by idle waiting and reply collection. */
|
|
85
|
+
export function replyDeadlineAt(startedAtMs: number, timeoutMs: number): number {
|
|
86
|
+
return Number(startedAtMs) + Math.max(0, Number(timeoutMs) || 0);
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* The pane accepted the prompt but did not finish inside the caller's budget.
|
|
91
|
+
* This is deliberately not a response error: the work may still complete.
|
|
92
|
+
*/
|
|
93
|
+
export class ReplyPendingError extends Error {
|
|
94
|
+
readonly pending = true;
|
|
95
|
+
constructor(message: string) {
|
|
96
|
+
super(message);
|
|
97
|
+
this.name = "ReplyPendingError";
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
export function isReplyPendingError(error: unknown): error is ReplyPendingError {
|
|
102
|
+
return error instanceof ReplyPendingError || Boolean((error as { pending?: unknown } | null)?.pending);
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/** Backoff delay for the nth idle-wait attempt (0-based); the last step repeats. */
|
|
106
|
+
export function idleWaitDelayMs(attempt: number): number {
|
|
107
|
+
const i = Math.max(0, Math.min(Math.floor(attempt), IDLE_WAIT_BACKOFF_MS.length - 1));
|
|
108
|
+
return IDLE_WAIT_BACKOFF_MS[i];
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* How long to wait for a busy pane. Never more than half the caller's reply
|
|
113
|
+
* budget — waiting to start must not consume the time meant for the answer.
|
|
114
|
+
*/
|
|
115
|
+
export function idleWaitBudgetMs(replyTimeoutMs: number, capMs = IDLE_WAIT_CAP_MS): number {
|
|
116
|
+
const half = Math.floor((Number(replyTimeoutMs) || 0) / 2);
|
|
117
|
+
return Math.max(0, Math.min(capMs, half));
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
export function completionSentinel(msgId: string): string {
|
|
121
|
+
return `${SENTINEL_PREFIX}${msgId}>>`;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// The prompt as typed into the Claude Code pane. Mirrors the pi side's
|
|
125
|
+
// "[from name @ cwd]" framing so Claude knows who is asking; in sentinel mode
|
|
126
|
+
// (no Stop hook seen yet) it also asks for the completion marker.
|
|
127
|
+
export function formatPanePrompt(
|
|
128
|
+
env: { prompt: string; sender_name: string; sender_cwd: string; msg_id: string },
|
|
129
|
+
sentinelMode: boolean,
|
|
130
|
+
): string {
|
|
131
|
+
const header = `[coms message from ${env.sender_name} @ ${env.sender_cwd}] `;
|
|
132
|
+
const sentinelNote = sentinelMode
|
|
133
|
+
? `\n\nEnd your reply with this exact line so the bridge can capture it: ${completionSentinel(env.msg_id)}`
|
|
134
|
+
: "";
|
|
135
|
+
return `${header}${env.prompt}${sentinelNote}`;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
// Stop-hook record: the hook writes {text, session_id?, written_at} as JSON.
|
|
139
|
+
export interface HookRecord {
|
|
140
|
+
text: string;
|
|
141
|
+
written_at?: string;
|
|
142
|
+
[key: string]: unknown;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export function parseHookRecord(raw: string): HookRecord | null {
|
|
146
|
+
try {
|
|
147
|
+
const rec = JSON.parse(raw);
|
|
148
|
+
if (rec && typeof rec.text === "string") return rec as HookRecord;
|
|
149
|
+
return null;
|
|
150
|
+
} catch {
|
|
151
|
+
return null;
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// Sentinel-mode fallback: pull the reply out of raw pane text. Takes
|
|
156
|
+
// everything between the last prompt echo (identified by the msg_id-bearing
|
|
157
|
+
// sentinel instruction OR the header line) and the sentinel line, stripped of
|
|
158
|
+
// obvious TUI furniture. Returns null when the sentinel has not appeared.
|
|
159
|
+
export function extractSentinelReply(paneText: string, msgId: string): string | null {
|
|
160
|
+
const sentinel = completionSentinel(msgId);
|
|
161
|
+
const at = paneText.lastIndexOf(sentinel);
|
|
162
|
+
if (at === -1) return null;
|
|
163
|
+
const before = paneText.slice(0, at);
|
|
164
|
+
// Cut at the end of the prompt echo: the sentinel instruction line
|
|
165
|
+
// contains the sentinel too, so use the LAST occurrence before the final
|
|
166
|
+
// one — that's the echo; the reply follows it.
|
|
167
|
+
const echoAt = before.lastIndexOf(sentinel);
|
|
168
|
+
const replyRegion = echoAt !== -1 ? before.slice(echoAt + sentinel.length) : before;
|
|
169
|
+
const lines = replyRegion
|
|
170
|
+
.split("\n")
|
|
171
|
+
.map((l) => l.replace(/^[●❯>\s]+/, "").trimEnd())
|
|
172
|
+
.filter((l) => l.trim() !== "" && !/^[─━┏┗┃│]+/.test(l));
|
|
173
|
+
return lines.join("\n").trim() || null;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
// ━━ Serial prompt queue ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
177
|
+
//
|
|
178
|
+
// One prompt at a time per pane; queue depth is reported in the agent card.
|
|
179
|
+
|
|
180
|
+
export interface QueuedPrompt<T> {
|
|
181
|
+
envelope: T;
|
|
182
|
+
enqueued_at: string;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
export class PromptQueue<T> {
|
|
186
|
+
private items: Array<QueuedPrompt<T>> = [];
|
|
187
|
+
private active = false;
|
|
188
|
+
|
|
189
|
+
get depth(): number {
|
|
190
|
+
return this.items.length + (this.active ? 1 : 0);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
push(envelope: T, now: () => string = () => new Date().toISOString()): void {
|
|
194
|
+
this.items.push({ envelope, enqueued_at: now() });
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
// Take the next prompt if none is being processed. Callers MUST call
|
|
198
|
+
// done() when processing finishes (success or failure).
|
|
199
|
+
take(): QueuedPrompt<T> | null {
|
|
200
|
+
if (this.active) return null;
|
|
201
|
+
const next = this.items.shift();
|
|
202
|
+
if (!next) return null;
|
|
203
|
+
this.active = true;
|
|
204
|
+
return next;
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
done(): void {
|
|
208
|
+
this.active = false;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
// Fail-closed command construction for the experimental external Codex conductor.
|
|
2
|
+
// It deliberately exposes only the two contract-approved coms operations.
|
|
3
|
+
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as path from "node:path";
|
|
6
|
+
|
|
7
|
+
import { validateComsName, validateComsProject } from "./coms-envelope.ts";
|
|
8
|
+
import { conductorWorkspacePath, loadOwnedConfig } from "./codex-remote-control.ts";
|
|
9
|
+
|
|
10
|
+
export interface ConductorContext {
|
|
11
|
+
repoRoot: string;
|
|
12
|
+
project: string;
|
|
13
|
+
name: string;
|
|
14
|
+
timeoutMs: number;
|
|
15
|
+
conductorCwd: string;
|
|
16
|
+
comsDir: string;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export type ConductorOperation =
|
|
20
|
+
| { operation: "list" }
|
|
21
|
+
| { operation: "send"; peer: string; prompt: string };
|
|
22
|
+
|
|
23
|
+
function realDirectory(value: string, label: string): string {
|
|
24
|
+
try {
|
|
25
|
+
const resolved = fs.realpathSync(value);
|
|
26
|
+
if (!fs.statSync(resolved).isDirectory()) throw new Error("not a directory");
|
|
27
|
+
return resolved;
|
|
28
|
+
} catch {
|
|
29
|
+
throw new Error(`${label} must resolve to an existing directory`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** Parse before any config/filesystem/process access. No scope overrides exist. */
|
|
34
|
+
export function parseConductorArgs(argv: string[]): ConductorOperation {
|
|
35
|
+
const flags = new Set<string>();
|
|
36
|
+
for (const arg of argv) {
|
|
37
|
+
if (!arg.startsWith("--")) continue;
|
|
38
|
+
if (flags.has(arg)) throw new Error(`${arg} may only be provided once`);
|
|
39
|
+
flags.add(arg);
|
|
40
|
+
}
|
|
41
|
+
if (flags.size > 0) throw new Error("flags and scope overrides are not allowed; the owned configuration is authoritative");
|
|
42
|
+
if (argv[0] === "list" && argv.length === 1) return { operation: "list" };
|
|
43
|
+
if (argv[0] === "send") {
|
|
44
|
+
if (argv.length !== 3) throw new Error("send requires exactly a peer and prompt");
|
|
45
|
+
return { operation: "send", peer: argv[1], prompt: argv[2] };
|
|
46
|
+
}
|
|
47
|
+
throw new Error("usage: codex-conductor <list|send <listed-peer> <bounded-prompt>>");
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export function loadConductorContext(input: { configPath: string; cwd: string; checkoutRoot: string }): ConductorContext {
|
|
51
|
+
const config = loadOwnedConfig(input.configPath);
|
|
52
|
+
const checkoutRoot = realDirectory(input.checkoutRoot, "checkout root");
|
|
53
|
+
if (config.repoRoot !== checkoutRoot) {
|
|
54
|
+
throw new Error("configured repository does not match this checkout");
|
|
55
|
+
}
|
|
56
|
+
const conductorCwd = conductorWorkspacePath(config.runtimeDir!);
|
|
57
|
+
if (realDirectory(input.cwd, "working directory") !== conductorCwd) {
|
|
58
|
+
throw new Error(`working directory must be ${conductorCwd}`);
|
|
59
|
+
}
|
|
60
|
+
validateComsProject(config.project);
|
|
61
|
+
validateComsName(config.name);
|
|
62
|
+
return {
|
|
63
|
+
repoRoot: config.repoRoot,
|
|
64
|
+
project: config.project,
|
|
65
|
+
name: config.name,
|
|
66
|
+
timeoutMs: config.timeoutMs,
|
|
67
|
+
conductorCwd,
|
|
68
|
+
comsDir: realDirectory(config.comsDir, "coms directory"),
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
export function conductorProcessEnv(
|
|
73
|
+
context: ConductorContext,
|
|
74
|
+
base: NodeJS.ProcessEnv = process.env,
|
|
75
|
+
): NodeJS.ProcessEnv {
|
|
76
|
+
return { ...base, PI_COMS_DIR: context.comsDir };
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function buildConductorCommand(context: ConductorContext, operation: ConductorOperation): string[] {
|
|
80
|
+
if (operation.operation === "list") {
|
|
81
|
+
return ["list", "--project", context.project, "--name", context.name];
|
|
82
|
+
}
|
|
83
|
+
return [
|
|
84
|
+
"send", operation.peer, operation.prompt,
|
|
85
|
+
"--project", context.project, "--name", context.name,
|
|
86
|
+
"--await", "--timeout", String(context.timeoutMs), "--conductor", "codex",
|
|
87
|
+
];
|
|
88
|
+
}
|