@chankov/agent-fleet 2.0.0 → 2.0.1
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/package.json +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.1/.pi/extensions/package.json +9 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.1/.version +1 -0
- package/.versions/2.0.1/agents/architect.md +25 -0
- package/.versions/2.0.1/agents/bowser.md +28 -0
- package/.versions/2.0.1/agents/builder.md +56 -0
- package/.versions/2.0.1/agents/code-reviewer.md +210 -0
- package/.versions/2.0.1/agents/deep-researcher.md +33 -0
- package/.versions/2.0.1/agents/documenter.md +22 -0
- package/.versions/2.0.1/agents/orchestrator.md +23 -0
- package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.1/agents/planner.md +73 -0
- package/.versions/2.0.1/agents/releaser.md +25 -0
- package/.versions/2.0.1/agents/researcher.md +31 -0
- package/.versions/2.0.1/agents/security-auditor.md +168 -0
- package/.versions/2.0.1/agents/test-engineer.md +154 -0
- package/.versions/2.0.1/agents/web-debugger.md +44 -0
- package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
- package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.1/docs/getting-started.md +119 -0
- package/.versions/2.0.1/docs/npm-install.md +292 -0
- package/.versions/2.0.1/docs/pi-extensions.md +439 -0
- package/.versions/2.0.1/docs/pi-setup.md +74 -0
- package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.1/hermes/README.md +347 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.1/install-manifest.json +2830 -0
- package/.versions/2.0.1/justfile +286 -0
- package/.versions/2.0.1/manifest-meta.json +913 -0
- package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.1/references/definition-of-done.md +67 -0
- package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/2.0.1/references/observability-checklist.md +91 -0
- package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.1/references/performance-checklist.md +153 -0
- package/.versions/2.0.1/references/prompting-patterns.md +380 -0
- package/.versions/2.0.1/references/security-checklist.md +179 -0
- package/.versions/2.0.1/references/testing-patterns.md +236 -0
- package/.versions/2.0.1/references/workflow-authoring.md +304 -0
- package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.1/scripts/fleet.ts +198 -0
- package/.versions/2.0.1/scripts/flow.ts +121 -0
- package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
- package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.1/scripts/team-up.ts +406 -0
- package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
- package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
- package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
- package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
- package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/README.md +21 -0
- package/agents/code-reviewer.md +1 -0
- package/agents/documenter.md +3 -0
- package/agents/planner.md +2 -0
- package/agents/researcher.md +2 -0
- package/docs/ARCHITECTURE.md +3 -0
- package/docs/getting-started.md +21 -0
- package/docs/workflows.md +136 -0
- package/install-manifest.json +86 -1
- package/justfile +14 -0
- package/manifest-meta.json +32 -1
- package/package.json +10 -3
- package/references/workflow-authoring.md +304 -0
- package/scripts/fleet.ts +13 -0
- package/scripts/flow.ts +121 -0
- package/scripts/lib/flow-command.ts +77 -0
- package/scripts/lib/flow-maintenance.ts +230 -0
- package/scripts/workflows/lib/agent-phase.ts +118 -0
- package/scripts/workflows/lib/changes.ts +61 -0
- package/scripts/workflows/lib/env.ts +34 -0
- package/scripts/workflows/lib/envelopes.ts +141 -0
- package/scripts/workflows/lib/gates.ts +81 -0
- package/scripts/workflows/lib/git.ts +96 -0
- package/scripts/workflows/lib/permissions.ts +130 -0
- package/scripts/workflows/lib/personas.ts +44 -0
- package/scripts/workflows/lib/quality.ts +64 -0
- package/scripts/workflows/lib/run.ts +106 -0
- package/scripts/workflows/lib/trace.ts +34 -0
- package/scripts/workflows/tsconfig.json +22 -0
- package/scripts/workflows/wf-build-test.ts +61 -0
- package/scripts/workflows/wf-document.ts +50 -0
- package/scripts/workflows/wf-quality.ts +20 -0
- package/scripts/workflows/wf-scout.ts +38 -0
- package/skills/drafting-workflows/SKILL.md +143 -0
- package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
// scripts/lib/herdr-layout.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for the herdr fleet recipes: peers.yaml parsing, peer→command
|
|
4
|
+
// construction, and peers.yaml team → herdr declarative layout tree (BSP
|
|
5
|
+
// splits, one pane per peer). No pi imports, no sockets, no process.exit —
|
|
6
|
+
// everything throws plain Errors so callers decide how to die. Testable
|
|
7
|
+
// under node --test; the wiring (requireHerdr, workspace.create,
|
|
8
|
+
// layout.apply) lives in scripts/team-up.ts.
|
|
9
|
+
|
|
10
|
+
import { resolve as resolvePath } from "node:path";
|
|
11
|
+
|
|
12
|
+
import type { LayoutNode } from "../../.pi/harnesses/lib/herdr-client.ts";
|
|
13
|
+
import { STAGGER_ENV_VAR } from "./spawn-stagger.ts";
|
|
14
|
+
import { DEFAULT_PROJECT, validateProject } from "./team-project.ts";
|
|
15
|
+
|
|
16
|
+
export type { LayoutNode };
|
|
17
|
+
|
|
18
|
+
// Safe charset for any value spliced into a command line or layout — the
|
|
19
|
+
// peers.yaml file is user-edited, so every manifest value is validated.
|
|
20
|
+
export const SAFE = /^[A-Za-z0-9._/,-]+$/;
|
|
21
|
+
|
|
22
|
+
export interface Peer {
|
|
23
|
+
name?: string;
|
|
24
|
+
persona?: string;
|
|
25
|
+
model?: string;
|
|
26
|
+
// Optional comma-separated extension names under .pi/extensions/ to load into
|
|
27
|
+
// this peer (routes it through `just _peer-plus` instead of `just _peer`).
|
|
28
|
+
extensions?: string;
|
|
29
|
+
// Optional repo-relative KEY=VALUE file injected as the pane's env at spawn
|
|
30
|
+
// (herdr injects it before the command runs — no shell `source`).
|
|
31
|
+
env_file?: string;
|
|
32
|
+
// Optional runner. Default (absent) is a pi peer via `_peer`/`_peer-plus`;
|
|
33
|
+
// "claude-code" spawns an interactive Claude Code plus its coms bridge in
|
|
34
|
+
// the pane via `_claude-peer` (model → `claude --model`).
|
|
35
|
+
runner?: string;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function stripQuotes(v: string): string {
|
|
39
|
+
if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
|
|
40
|
+
return v.slice(1, -1);
|
|
41
|
+
}
|
|
42
|
+
return v;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// Minimal parser for the specific peers.yaml shape (team → list of {name,persona,model}).
|
|
46
|
+
// Not a general YAML parser; tolerant of comments and blank lines only.
|
|
47
|
+
export function parsePeersYaml(raw: string): Record<string, Peer[]> {
|
|
48
|
+
const teams: Record<string, Peer[]> = {};
|
|
49
|
+
let currentTeam: string | null = null;
|
|
50
|
+
let currentPeer: Peer | null = null;
|
|
51
|
+
|
|
52
|
+
for (const rawLine of raw.split("\n")) {
|
|
53
|
+
const line = rawLine.replace(/\s+$/, "");
|
|
54
|
+
if (line.trim() === "" || /^\s*#/.test(line)) continue;
|
|
55
|
+
const indent = line.length - line.trimStart().length;
|
|
56
|
+
const content = line.trim();
|
|
57
|
+
|
|
58
|
+
if (indent === 0) {
|
|
59
|
+
const m = content.match(/^([A-Za-z0-9_-]+):\s*$/);
|
|
60
|
+
if (m) {
|
|
61
|
+
currentTeam = m[1];
|
|
62
|
+
teams[currentTeam] = [];
|
|
63
|
+
currentPeer = null;
|
|
64
|
+
}
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
if (!currentTeam) continue;
|
|
68
|
+
|
|
69
|
+
const itemM = content.match(/^-\s*([A-Za-z0-9_]+):\s*(.+)$/);
|
|
70
|
+
if (itemM) {
|
|
71
|
+
currentPeer = {};
|
|
72
|
+
teams[currentTeam].push(currentPeer);
|
|
73
|
+
(currentPeer as Record<string, string>)[itemM[1]] = stripQuotes(itemM[2]);
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
const fieldM = content.match(/^([A-Za-z0-9_]+):\s*(.+)$/);
|
|
77
|
+
if (fieldM && currentPeer) {
|
|
78
|
+
(currentPeer as Record<string, string>)[fieldM[1]] = stripQuotes(fieldM[2]);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
return teams;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* The peers.yaml declaration for a peer name, searched across every team
|
|
86
|
+
* (first match wins; the same name in two teams is the same peer). Used by
|
|
87
|
+
* one-off spawns that are handed only a name — without this they would ignore
|
|
88
|
+
* `runner:`/`extensions:`/`env_file:` and launch a bare pi peer under a name
|
|
89
|
+
* the fleet defines as something else (e.g. a `runner: claude-code` reviewer).
|
|
90
|
+
*/
|
|
91
|
+
export function findPeerByName(teams: Record<string, Peer[]>, name: string): Peer | undefined {
|
|
92
|
+
const wanted = String(name ?? "").toLowerCase();
|
|
93
|
+
if (!wanted) return undefined;
|
|
94
|
+
for (const peers of Object.values(teams)) {
|
|
95
|
+
for (const peer of peers) {
|
|
96
|
+
if (String(peer.name ?? "").toLowerCase() === wanted) return peer;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
return undefined;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
// Validate a peer's fields and build its launch argv. `just` recipe params are
|
|
103
|
+
// POSITIONAL (persona name model session) — bare positional args, never
|
|
104
|
+
// key=value. A peer with `extensions:` routes through `_peer-plus
|
|
105
|
+
// <extensions> <persona> <name> [<model>] [<session>]`; otherwise plain
|
|
106
|
+
// `_peer <persona> <name> [<model>] [<session>]`. `resumeRef` (a pi session
|
|
107
|
+
// path for `pi --session`) fills the trailing session positional — when the
|
|
108
|
+
// peer has no model, an empty-string placeholder keeps the positions aligned.
|
|
109
|
+
export function peerCommand(p: Peer, team: string, resumeRef?: string, project = DEFAULT_PROJECT): string[] {
|
|
110
|
+
validateProject(project);
|
|
111
|
+
if (p.runner !== undefined && p.runner !== "claude-code") {
|
|
112
|
+
throw new Error(`Unknown runner "${p.runner}" for peer "${p.name}" in team "${team}" (supported: claude-code).`);
|
|
113
|
+
}
|
|
114
|
+
if (!p.persona && p.runner !== "claude-code") {
|
|
115
|
+
throw new Error(`Peer "${p.name ?? "(unnamed)"}" in team "${team}" is missing a persona.`);
|
|
116
|
+
}
|
|
117
|
+
if (!p.name) {
|
|
118
|
+
throw new Error(`Peer with persona "${p.persona}" in team "${team}" is missing a name.`);
|
|
119
|
+
}
|
|
120
|
+
for (const [k, v] of Object.entries(p)) {
|
|
121
|
+
// Only string fields can reach a command line; extra non-string fields
|
|
122
|
+
// (e.g. a snapshot's `resume` object) are never spliced into argv.
|
|
123
|
+
if (typeof v === "string" && !SAFE.test(v)) {
|
|
124
|
+
throw new Error(`Unsafe value for ${k} in team "${team}": ${JSON.stringify(v)} (allowed: ${SAFE})`);
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
if (resumeRef !== undefined && !SAFE.test(resumeRef)) {
|
|
128
|
+
throw new Error(`Unsafe resume ref for ${p.name}: ${JSON.stringify(resumeRef)} (allowed: ${SAFE})`);
|
|
129
|
+
}
|
|
130
|
+
if (p.runner === "claude-code" && p.extensions) {
|
|
131
|
+
throw new Error(`Peer "${p.name}": extensions: are pi-only and cannot combine with runner: claude-code.`);
|
|
132
|
+
}
|
|
133
|
+
const parts =
|
|
134
|
+
p.runner === "claude-code"
|
|
135
|
+
? ["just", "_claude-peer", p.name]
|
|
136
|
+
: p.extensions
|
|
137
|
+
? ["just", "_peer-plus", p.extensions, p.persona, p.name]
|
|
138
|
+
: ["just", "_peer", p.persona, p.name];
|
|
139
|
+
if (p.model) parts.push(p.model);
|
|
140
|
+
if (resumeRef !== undefined) {
|
|
141
|
+
if (!p.model) parts.push(""); // keep the model positional aligned
|
|
142
|
+
parts.push(resumeRef);
|
|
143
|
+
}
|
|
144
|
+
if (project !== DEFAULT_PROJECT) {
|
|
145
|
+
if (!p.model && resumeRef === undefined) parts.push("");
|
|
146
|
+
if (resumeRef === undefined) parts.push("");
|
|
147
|
+
parts.push(project);
|
|
148
|
+
}
|
|
149
|
+
return parts;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// Parse a KEY=VALUE env file (B3): no shell evaluation, no expansion.
|
|
153
|
+
// Blank lines and #-comments are skipped; values may be single- or
|
|
154
|
+
// double-quoted (quotes stripped, contents taken literally).
|
|
155
|
+
export function parseEnvFile(raw: string, sourceName = "env file"): Record<string, string> {
|
|
156
|
+
const env: Record<string, string> = {};
|
|
157
|
+
const lines = raw.split("\n");
|
|
158
|
+
for (let i = 0; i < lines.length; i++) {
|
|
159
|
+
const line = lines[i].trim();
|
|
160
|
+
if (line === "" || line.startsWith("#")) continue;
|
|
161
|
+
const m = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
|
|
162
|
+
if (!m) {
|
|
163
|
+
throw new Error(`${sourceName}:${i + 1}: not a KEY=VALUE line: ${JSON.stringify(line)}`);
|
|
164
|
+
}
|
|
165
|
+
env[m[1]] = stripQuotes(m[2].trim());
|
|
166
|
+
}
|
|
167
|
+
return env;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// Resolve a peer's env_file to an absolute path inside the repo. The SAFE
|
|
171
|
+
// charset (enforced on every peer field) already excludes shell metacharacters;
|
|
172
|
+
// this adds the traversal guard: repo-relative, no escaping the repo root.
|
|
173
|
+
export function resolveEnvFilePath(envFile: string, repoRoot: string): string {
|
|
174
|
+
if (!SAFE.test(envFile)) {
|
|
175
|
+
throw new Error(`Unsafe env_file path: ${JSON.stringify(envFile)} (allowed: ${SAFE})`);
|
|
176
|
+
}
|
|
177
|
+
if (envFile.startsWith("/")) {
|
|
178
|
+
throw new Error(`env_file must be repo-relative, got absolute path: ${envFile}`);
|
|
179
|
+
}
|
|
180
|
+
const abs = resolvePath(repoRoot, envFile);
|
|
181
|
+
if (abs !== repoRoot && !abs.startsWith(repoRoot + "/")) {
|
|
182
|
+
throw new Error(`env_file escapes the repo root: ${envFile}`);
|
|
183
|
+
}
|
|
184
|
+
return abs;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
export interface TeamLayoutOptions {
|
|
188
|
+
team: string;
|
|
189
|
+
peers: Peer[];
|
|
190
|
+
repoRoot: string;
|
|
191
|
+
// B3 hook: resolve a peer's extra env (e.g. from its env_file). Returning
|
|
192
|
+
// undefined means no extra env for that peer.
|
|
193
|
+
envForPeer?: (peer: Peer) => Record<string, string> | undefined;
|
|
194
|
+
// B5 hook: resume ref (pi session path) for a peer being restored from a
|
|
195
|
+
// team snapshot. Returning undefined starts the peer fresh.
|
|
196
|
+
resumeForPeer?: (peer: Peer) => string | undefined;
|
|
197
|
+
// Pre-warm/stagger hook (see spawn-stagger.ts): seconds this pane should
|
|
198
|
+
// sleep before launching pi, injected as AGENT_FLEET_SPAWN_DELAY in the
|
|
199
|
+
// pane env. undefined or 0 launches immediately.
|
|
200
|
+
delayForPeer?: (peer: Peer) => number | undefined;
|
|
201
|
+
// B2 hook: when set, the hub occupies a larger root pane (ratio of the
|
|
202
|
+
// horizontal split) and the team tiles in the remaining space.
|
|
203
|
+
// Coms project scope shared by all panes in this layout. The default keeps
|
|
204
|
+
// existing argv shapes; non-default projects are appended to hidden recipe
|
|
205
|
+
// positional args after model/session.
|
|
206
|
+
project?: string;
|
|
207
|
+
hub?: { command: string[]; label: string; ratio?: number; cwd?: string; env?: Record<string, string> };
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
function paneNode(
|
|
211
|
+
peer: Peer,
|
|
212
|
+
team: string,
|
|
213
|
+
repoRoot: string,
|
|
214
|
+
envForPeer?: TeamLayoutOptions["envForPeer"],
|
|
215
|
+
resumeForPeer?: TeamLayoutOptions["resumeForPeer"],
|
|
216
|
+
project = DEFAULT_PROJECT,
|
|
217
|
+
delayForPeer?: TeamLayoutOptions["delayForPeer"],
|
|
218
|
+
): LayoutNode {
|
|
219
|
+
validateProject(project);
|
|
220
|
+
const env = { ...envForPeer?.(peer) };
|
|
221
|
+
const delay = delayForPeer?.(peer);
|
|
222
|
+
if (delay !== undefined) {
|
|
223
|
+
if (!Number.isFinite(delay) || delay < 0) {
|
|
224
|
+
throw new Error(`Invalid spawn delay for peer "${peer.name}": ${delay}`);
|
|
225
|
+
}
|
|
226
|
+
if (delay > 0) env[STAGGER_ENV_VAR] = String(Math.round(delay));
|
|
227
|
+
}
|
|
228
|
+
return {
|
|
229
|
+
type: "pane",
|
|
230
|
+
command: peerCommand(peer, team, resumeForPeer?.(peer), project),
|
|
231
|
+
cwd: repoRoot,
|
|
232
|
+
label: peer.name as string,
|
|
233
|
+
...(Object.keys(env).length > 0 ? { env } : {}),
|
|
234
|
+
};
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
// Balanced BSP over a list of panes: split the list in half, alternating
|
|
238
|
+
// split direction by depth — the herdr equivalent of tmux's tiled layout.
|
|
239
|
+
function bsp(nodes: LayoutNode[], depth: number): LayoutNode {
|
|
240
|
+
if (nodes.length === 1) return nodes[0];
|
|
241
|
+
const mid = Math.ceil(nodes.length / 2);
|
|
242
|
+
return {
|
|
243
|
+
type: "split",
|
|
244
|
+
direction: depth % 2 === 0 ? "right" : "down",
|
|
245
|
+
ratio: mid / nodes.length,
|
|
246
|
+
first: bsp(nodes.slice(0, mid), depth + 1),
|
|
247
|
+
second: bsp(nodes.slice(mid), depth + 1),
|
|
248
|
+
};
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
// peers.yaml team → herdr layout tree for layout.apply.
|
|
252
|
+
export function buildTeamLayout(opts: TeamLayoutOptions): LayoutNode {
|
|
253
|
+
const { team, peers, repoRoot, envForPeer, resumeForPeer, delayForPeer, hub, project = DEFAULT_PROJECT } = opts;
|
|
254
|
+
validateProject(project);
|
|
255
|
+
if (peers.length === 0) {
|
|
256
|
+
if (!hub) throw new Error(`Team "${team}" has no peers.`);
|
|
257
|
+
return {
|
|
258
|
+
type: "pane",
|
|
259
|
+
command: hub.command,
|
|
260
|
+
cwd: hub.cwd ?? repoRoot,
|
|
261
|
+
label: hub.label,
|
|
262
|
+
...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
|
|
263
|
+
};
|
|
264
|
+
}
|
|
265
|
+
const panes = peers.map((p) => paneNode(p, team, repoRoot, envForPeer, resumeForPeer, project, delayForPeer));
|
|
266
|
+
const grid = bsp(panes, hub ? 1 : 0);
|
|
267
|
+
if (!hub) return grid;
|
|
268
|
+
return {
|
|
269
|
+
type: "split",
|
|
270
|
+
direction: "right",
|
|
271
|
+
ratio: hub.ratio ?? 0.4,
|
|
272
|
+
first: {
|
|
273
|
+
type: "pane",
|
|
274
|
+
command: hub.command,
|
|
275
|
+
cwd: hub.cwd ?? repoRoot,
|
|
276
|
+
label: hub.label,
|
|
277
|
+
...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
|
|
278
|
+
},
|
|
279
|
+
second: grid,
|
|
280
|
+
};
|
|
281
|
+
}
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
// scripts/lib/hermes-bridge-core.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for the Hermes ⇄ coms bridge: qid correlation, Telegram
|
|
4
|
+
// formatting, answer-file validation, answer mapping, timeout outcomes,
|
|
5
|
+
// state transitions, and ndjson log records. No sockets, no fs, no Hermes CLI.
|
|
6
|
+
|
|
7
|
+
import * as os from "node:os";
|
|
8
|
+
import * as path from "node:path";
|
|
9
|
+
|
|
10
|
+
export const QID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
|
|
11
|
+
export const TELEGRAM_TEXT_LIMIT = 4096;
|
|
12
|
+
export const DEFAULT_REMOTE_TIMEOUT_MS = 1_800_000;
|
|
13
|
+
export const HUB_Q_PREFIX = "HUB-Q";
|
|
14
|
+
export const ANSWER_FILE_SUFFIX = ".answer.json";
|
|
15
|
+
|
|
16
|
+
export const BRIDGE_EVENT_NAMES = [
|
|
17
|
+
"question_received",
|
|
18
|
+
"delivered",
|
|
19
|
+
"delivery_error",
|
|
20
|
+
"answered",
|
|
21
|
+
"cancelled",
|
|
22
|
+
"timeout",
|
|
23
|
+
"late_answer",
|
|
24
|
+
] as const;
|
|
25
|
+
|
|
26
|
+
export type BridgeEventName = (typeof BRIDGE_EVENT_NAMES)[number];
|
|
27
|
+
export type QuestionState = "pending" | "delivered" | "answered" | "cancelled" | "timeout";
|
|
28
|
+
|
|
29
|
+
export interface QuestionOption {
|
|
30
|
+
title: string;
|
|
31
|
+
description?: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface HermesBridgeQuestion {
|
|
35
|
+
qid: string;
|
|
36
|
+
project: string;
|
|
37
|
+
question: string;
|
|
38
|
+
context?: string;
|
|
39
|
+
options?: QuestionOption[];
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export interface HermesAnswerFile {
|
|
43
|
+
qid: string;
|
|
44
|
+
answer: string;
|
|
45
|
+
answered_by: string;
|
|
46
|
+
at: string;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export type AskResponse =
|
|
50
|
+
| { kind: "selection"; selections: string[]; comment?: string }
|
|
51
|
+
| { kind: "freeform"; text: string };
|
|
52
|
+
|
|
53
|
+
export type AnswerRejectReason =
|
|
54
|
+
| "invalid_path"
|
|
55
|
+
| "invalid_qid"
|
|
56
|
+
| "foreign_qid"
|
|
57
|
+
| "invalid_json"
|
|
58
|
+
| "invalid_schema"
|
|
59
|
+
| "qid_mismatch";
|
|
60
|
+
|
|
61
|
+
export type AnswerFileValidation =
|
|
62
|
+
| { ok: true; qid: string; answer: HermesAnswerFile }
|
|
63
|
+
| { ok: false; reason: AnswerRejectReason; qid?: string; detail?: string };
|
|
64
|
+
|
|
65
|
+
export type StateTransition =
|
|
66
|
+
| { ok: true; state: QuestionState | null }
|
|
67
|
+
| { ok: false; reason: "unsupported_transition"; state: QuestionState | null; event: BridgeEventName };
|
|
68
|
+
|
|
69
|
+
export interface LogRecord {
|
|
70
|
+
at: string;
|
|
71
|
+
qid: string;
|
|
72
|
+
event: BridgeEventName;
|
|
73
|
+
detail?: unknown;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export function hermesBridgeDir(home = os.homedir()): string {
|
|
77
|
+
return path.join(home, ".pi", "coms", "hermes-bridge");
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export function questionsDir(home = os.homedir()): string {
|
|
81
|
+
return path.join(hermesBridgeDir(home), "questions");
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export function logPath(home = os.homedir()): string {
|
|
85
|
+
return path.join(hermesBridgeDir(home), "log.ndjson");
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
export function answerFilePath(qid: string, dir = questionsDir()): string {
|
|
89
|
+
return path.join(dir, `${qid}${ANSWER_FILE_SUFFIX}`);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export function isValidQid(qid: unknown): qid is string {
|
|
93
|
+
return typeof qid === "string" && QID_RE.test(qid);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export function qidFromPromptEnvelope(env: { msg_id?: unknown }): string {
|
|
97
|
+
if (!isValidQid(env.msg_id)) throw new Error("prompt msg_id must be a 26-character Crockford ULID qid");
|
|
98
|
+
return env.msg_id;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function truncateUtf16(text: string, limit: number): string {
|
|
102
|
+
if (text.length <= limit) return text;
|
|
103
|
+
if (limit <= 0) return "";
|
|
104
|
+
if (limit === 1) return "…";
|
|
105
|
+
return `${text.slice(0, limit - 1)}…`;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
function formatOptions(options: QuestionOption[]): string {
|
|
109
|
+
return options
|
|
110
|
+
.map((option, index) => {
|
|
111
|
+
const desc = option.description ? ` — ${option.description}` : "";
|
|
112
|
+
return `${index + 1}. ${option.title}${desc}`;
|
|
113
|
+
})
|
|
114
|
+
.join("\n");
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
export function formatTelegramQuestion(input: HermesBridgeQuestion, limit = TELEGRAM_TEXT_LIMIT): string {
|
|
118
|
+
if (!isValidQid(input.qid)) throw new Error("qid must be a 26-character Crockford ULID");
|
|
119
|
+
const options = input.options ?? [];
|
|
120
|
+
const header = `❓ [${HUB_Q_PREFIX}:${input.qid}] ${input.question}`;
|
|
121
|
+
const project = truncateUtf16(input.project.replace(/\s+/g, " ").trim() || "default", 128);
|
|
122
|
+
const projectBlock = `\n\n📁 Project: ${project}`;
|
|
123
|
+
const optionsBlock = options.length > 0 ? `\n\nOptions:\n${formatOptions(options)}` : "";
|
|
124
|
+
const instruction = `\n\n↩ Reply to this message, or type: ${HUB_Q_PREFIX}:${input.qid}: <answer>`;
|
|
125
|
+
const contextPrefix = input.context ? "\n\nContext: " : "";
|
|
126
|
+
const fixedLength = header.length + projectBlock.length + contextPrefix.length + optionsBlock.length + instruction.length;
|
|
127
|
+
const contextBudget = Math.max(0, limit - fixedLength);
|
|
128
|
+
const context = input.context ? truncateUtf16(input.context, contextBudget) : "";
|
|
129
|
+
return truncateUtf16(`${header}${projectBlock}${contextPrefix}${context}${optionsBlock}${instruction}`, limit);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
export function mapAnswerToAskResponse(answer: string, options: QuestionOption[] = []): AskResponse {
|
|
133
|
+
const text = answer.trim();
|
|
134
|
+
if (options.length > 0) {
|
|
135
|
+
if (/^\d+$/.test(text)) {
|
|
136
|
+
const index = Number(text) - 1;
|
|
137
|
+
const option = options[index];
|
|
138
|
+
if (option) return { kind: "selection", selections: [option.title] };
|
|
139
|
+
}
|
|
140
|
+
const byTitle = options.find((option) => option.title.toLowerCase() === text.toLowerCase());
|
|
141
|
+
if (byTitle) return { kind: "selection", selections: [byTitle.title] };
|
|
142
|
+
}
|
|
143
|
+
return { kind: "freeform", text };
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
function qidFromAnswerPath(filePath: string): { ok: true; qid: string } | { ok: false; reason: AnswerRejectReason } {
|
|
147
|
+
const base = path.basename(filePath);
|
|
148
|
+
if (!base.endsWith(ANSWER_FILE_SUFFIX)) return { ok: false, reason: "invalid_path" };
|
|
149
|
+
const qid = base.slice(0, -ANSWER_FILE_SUFFIX.length);
|
|
150
|
+
if (!isValidQid(qid)) return { ok: false, reason: "invalid_qid" };
|
|
151
|
+
return { ok: true, qid };
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
function isIsoTimestamp(value: string): boolean {
|
|
155
|
+
return !Number.isNaN(Date.parse(value));
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function schemaValid(value: unknown): value is HermesAnswerFile {
|
|
159
|
+
const rec = value as HermesAnswerFile;
|
|
160
|
+
return (
|
|
161
|
+
!!rec &&
|
|
162
|
+
typeof rec === "object" &&
|
|
163
|
+
isValidQid(rec.qid) &&
|
|
164
|
+
typeof rec.answer === "string" &&
|
|
165
|
+
typeof rec.answered_by === "string" &&
|
|
166
|
+
rec.answered_by.length > 0 &&
|
|
167
|
+
typeof rec.at === "string" &&
|
|
168
|
+
isIsoTimestamp(rec.at)
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
export function validateAnswerFile(
|
|
173
|
+
raw: string,
|
|
174
|
+
filePath: string,
|
|
175
|
+
livePendingQids: Iterable<string>,
|
|
176
|
+
): AnswerFileValidation {
|
|
177
|
+
const pathQid = qidFromAnswerPath(filePath);
|
|
178
|
+
if (!pathQid.ok) return { ok: false, reason: pathQid.reason };
|
|
179
|
+
const pending = new Set(livePendingQids);
|
|
180
|
+
if (!pending.has(pathQid.qid)) return { ok: false, reason: "foreign_qid", qid: pathQid.qid };
|
|
181
|
+
|
|
182
|
+
let parsed: unknown;
|
|
183
|
+
try {
|
|
184
|
+
parsed = JSON.parse(raw);
|
|
185
|
+
} catch (err) {
|
|
186
|
+
return { ok: false, reason: "invalid_json", qid: pathQid.qid, detail: err instanceof Error ? err.message : String(err) };
|
|
187
|
+
}
|
|
188
|
+
if (!schemaValid(parsed)) return { ok: false, reason: "invalid_schema", qid: pathQid.qid };
|
|
189
|
+
if (parsed.qid !== pathQid.qid) return { ok: false, reason: "qid_mismatch", qid: pathQid.qid };
|
|
190
|
+
return { ok: true, qid: pathQid.qid, answer: parsed };
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
export function timeoutMsFromEnv(env: Pick<NodeJS.ProcessEnv, "PI_COMS_TIMEOUT_MS"> = process.env): number {
|
|
194
|
+
const raw = env.PI_COMS_TIMEOUT_MS;
|
|
195
|
+
if (!raw) return DEFAULT_REMOTE_TIMEOUT_MS;
|
|
196
|
+
const n = Number(raw);
|
|
197
|
+
return Number.isFinite(n) && n > 0 ? n : DEFAULT_REMOTE_TIMEOUT_MS;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
export function timeoutErrorMessage(timeoutMs: number): string {
|
|
201
|
+
return `no remote answer within ${timeoutMs}ms`;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
export function timeoutTelegramNote(qid: string, timeoutMs: number): string {
|
|
205
|
+
return `⌛ [${HUB_Q_PREFIX}:${qid}] The question timed out after ${timeoutMs}ms.`;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
export function timeoutOutcome(qid: string, timeoutMs = timeoutMsFromEnv()): {
|
|
209
|
+
response: null;
|
|
210
|
+
error: string;
|
|
211
|
+
telegramNote: string;
|
|
212
|
+
} {
|
|
213
|
+
return {
|
|
214
|
+
response: null,
|
|
215
|
+
error: timeoutErrorMessage(timeoutMs),
|
|
216
|
+
telegramNote: timeoutTelegramNote(qid, timeoutMs),
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
export function transitionState(state: QuestionState | null, event: BridgeEventName): StateTransition {
|
|
221
|
+
if (state === null && event === "question_received") return { ok: true, state: "pending" };
|
|
222
|
+
if (state === "pending" && event === "delivered") return { ok: true, state: "delivered" };
|
|
223
|
+
if (state === "pending" && event === "delivery_error") return { ok: true, state: null };
|
|
224
|
+
if ((state === "pending" || state === "delivered") && event === "cancelled") return { ok: true, state: "cancelled" };
|
|
225
|
+
if ((state === "pending" || state === "delivered") && event === "timeout") return { ok: true, state: "timeout" };
|
|
226
|
+
if (state === "delivered" && event === "answered") return { ok: true, state: "answered" };
|
|
227
|
+
if ((state === "answered" || state === "cancelled" || state === "timeout") && event === "late_answer") {
|
|
228
|
+
return { ok: true, state };
|
|
229
|
+
}
|
|
230
|
+
return { ok: false, reason: "unsupported_transition", state, event };
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
export function makeLogRecord(qid: string, event: BridgeEventName, detail?: unknown, at = new Date().toISOString()): LogRecord {
|
|
234
|
+
if (!isValidQid(qid)) throw new Error("qid must be a 26-character Crockford ULID");
|
|
235
|
+
if (!BRIDGE_EVENT_NAMES.includes(event)) throw new Error(`unsupported bridge event: ${event}`);
|
|
236
|
+
return detail === undefined ? { at, qid, event } : { at, qid, event, detail };
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
export function renderLogRecord(record: LogRecord): string {
|
|
240
|
+
return `${JSON.stringify(record)}\n`;
|
|
241
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from "../../.pi/harnesses/lib/hermes-monitor-events.ts";
|