@chankov/agent-fleet 2.0.9 → 2.0.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agent-fleet/scripts/flow.ts +26 -8
- package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
- package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
- package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
- package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
- package/.pi/extensions/pi-voice-stt/README.md +24 -5
- package/.pi/extensions/pi-voice-stt/examples/stt.json +4 -4
- package/.pi/harnesses/agent-hub/README.md +53 -18
- package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
- package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
- package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
- package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
- package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
- package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
- package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
- package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
- package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
- package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
- package/.pi/harnesses/agent-hub/delegate.ts +19 -2
- package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
- package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.pi/harnesses/agent-hub/helpers.ts +5 -1
- package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
- package/.pi/harnesses/agent-hub/index.ts +145 -14
- package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
- package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
- package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
- package/.pi/harnesses/agent-hub/return-contract.js +34 -0
- package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
- package/.pi/harnesses/agent-hub/spawn.ts +61 -7
- package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
- package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +253 -41
- package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
- package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
- package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
- package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
- package/.pi/harnesses/agent-hub/types.ts +2 -0
- package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
- package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/index.ts +9 -0
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.10/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/flow.ts +137 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.10/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.10/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.10/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.10/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.10/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.10/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.10/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.10/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.10/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.10/.pi/extensions/package.json +9 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/README.md +1217 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/config/agents.ts +177 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/index.ts +2132 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +335 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.10/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.10/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.10/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.10/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.10/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.10/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-read-model.ts +213 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.10/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.10/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.10/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.10/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.10/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.10/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.10/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.10/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.10/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.10/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.10/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.10/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.10/.version +1 -0
- package/.versions/2.0.10/agents/architect.md +25 -0
- package/.versions/2.0.10/agents/bowser.md +28 -0
- package/.versions/2.0.10/agents/builder.md +56 -0
- package/.versions/2.0.10/agents/code-reviewer.md +210 -0
- package/.versions/2.0.10/agents/deep-researcher.md +33 -0
- package/.versions/2.0.10/agents/documenter.md +23 -0
- package/.versions/2.0.10/agents/orchestrator.md +23 -0
- package/.versions/2.0.10/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.10/agents/planner.md +106 -0
- package/.versions/2.0.10/agents/releaser.md +25 -0
- package/.versions/2.0.10/agents/researcher.md +31 -0
- package/.versions/2.0.10/agents/security-auditor.md +168 -0
- package/.versions/2.0.10/agents/test-engineer.md +154 -0
- package/.versions/2.0.10/agents/web-debugger.md +44 -0
- package/.versions/2.0.10/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.10/bin/catalog/harness-runtime-closure.json +32 -0
- package/.versions/2.0.10/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.10/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.10/docs/ARCHITECTURE.md +416 -0
- package/.versions/2.0.10/docs/agent-fleet-setup.md +586 -0
- package/.versions/2.0.10/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.10/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.10/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.10/docs/getting-started.md +126 -0
- package/.versions/2.0.10/docs/npm-install.md +383 -0
- package/.versions/2.0.10/docs/pi-extensions.md +449 -0
- package/.versions/2.0.10/docs/pi-setup.md +92 -0
- package/.versions/2.0.10/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.10/install-manifest.json +2991 -0
- package/.versions/2.0.10/justfile +247 -0
- package/.versions/2.0.10/manifest-meta.json +970 -0
- package/.versions/2.0.10/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.10/references/communication-contract.md +26 -0
- package/.versions/2.0.10/references/definition-of-done.md +67 -0
- package/.versions/2.0.10/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.10/references/observability-checklist.md +92 -0
- package/.versions/2.0.10/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.10/references/performance-checklist.md +236 -0
- package/.versions/2.0.10/references/prompting-patterns.md +380 -0
- package/.versions/2.0.10/references/security-checklist.md +245 -0
- package/.versions/2.0.10/references/testing-patterns.md +235 -0
- package/.versions/2.0.10/references/workflow-authoring.md +304 -0
- package/.versions/2.0.10/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.10/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.10/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.10/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.10/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.10/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.10/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.10/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.10/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.10/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.10/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.10/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.10/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.10/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.10/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.10/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.10/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.10/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.10/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.10/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.10/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.10/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.10/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.11/.pi/extensions/package.json +9 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
- package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
- package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.11/.version +1 -0
- package/.versions/2.0.11/agents/architect.md +25 -0
- package/.versions/2.0.11/agents/bowser.md +28 -0
- package/.versions/2.0.11/agents/builder.md +56 -0
- package/.versions/2.0.11/agents/code-reviewer.md +210 -0
- package/.versions/2.0.11/agents/deep-researcher.md +33 -0
- package/.versions/2.0.11/agents/documenter.md +23 -0
- package/.versions/2.0.11/agents/orchestrator.md +23 -0
- package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.11/agents/planner.md +106 -0
- package/.versions/2.0.11/agents/releaser.md +25 -0
- package/.versions/2.0.11/agents/researcher.md +31 -0
- package/.versions/2.0.11/agents/security-auditor.md +168 -0
- package/.versions/2.0.11/agents/test-engineer.md +154 -0
- package/.versions/2.0.11/agents/web-debugger.md +44 -0
- package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
- package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
- package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
- package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.11/docs/getting-started.md +126 -0
- package/.versions/2.0.11/docs/npm-install.md +383 -0
- package/.versions/2.0.11/docs/pi-extensions.md +449 -0
- package/.versions/2.0.11/docs/pi-setup.md +92 -0
- package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.11/install-manifest.json +3020 -0
- package/.versions/2.0.11/justfile +247 -0
- package/.versions/2.0.11/manifest-meta.json +970 -0
- package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.11/references/communication-contract.md +26 -0
- package/.versions/2.0.11/references/definition-of-done.md +67 -0
- package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.11/references/observability-checklist.md +92 -0
- package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.11/references/performance-checklist.md +236 -0
- package/.versions/2.0.11/references/prompting-patterns.md +380 -0
- package/.versions/2.0.11/references/security-checklist.md +245 -0
- package/.versions/2.0.11/references/testing-patterns.md +235 -0
- package/.versions/2.0.11/references/workflow-authoring.md +304 -0
- package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +19 -0
- package/README.md +1 -0
- package/agents/architect.md +1 -1
- package/agents/bowser.md +1 -1
- package/agents/builder.md +1 -1
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +1 -1
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +1 -1
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/researcher.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +1 -1
- package/agents/web-debugger.md +1 -1
- package/agents/web-performance-auditor.md +1 -1
- package/bin/catalog/harness-runtime-closure.json +29 -0
- package/bin/cli.js +23 -9
- package/bin/lib/doctor.js +83 -1
- package/bin/lib/path-boundaries.js +5 -6
- package/bin/lib/stt-wizard.js +154 -23
- package/docs/ARCHITECTURE.md +181 -2
- package/docs/agent-fleet-setup.md +26 -8
- package/docs/npm-install.md +29 -2
- package/docs/pi-setup.md +16 -0
- package/docs/workflows.md +8 -2
- package/install-manifest.json +31 -2
- package/package.json +13 -3
- package/skills/orchestration-verification/SKILL.md +1 -0
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: using-agent-skills
|
|
3
|
+
description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using Agent Skills
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
|
|
11
|
+
|
|
12
|
+
## Skill Discovery
|
|
13
|
+
|
|
14
|
+
When a task arrives, identify the development phase and apply the corresponding skill:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
Task arrives
|
|
18
|
+
│
|
|
19
|
+
├── Don't know what you want yet? ──────→ interview-me
|
|
20
|
+
├── Have a rough concept, need variants? → idea-refine
|
|
21
|
+
├── New project/feature/change? ──→ spec-driven-development
|
|
22
|
+
├── No quality bar written down? ──→ constraint-driven-development
|
|
23
|
+
├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
|
|
24
|
+
├── Implementing code? ────────────→ incremental-implementation
|
|
25
|
+
│ ├── UI work? ─────────────────→ frontend-ui-engineering
|
|
26
|
+
│ ├── API work? ────────────────→ api-and-interface-design
|
|
27
|
+
│ ├── Need better context? ─────→ context-engineering
|
|
28
|
+
│ ├── Need doc-verified code? ───→ source-driven-development
|
|
29
|
+
│ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
|
|
30
|
+
├── Writing/running tests? ────────→ test-driven-development
|
|
31
|
+
│ └── Browser-based? ───────────→ browser-testing-with-devtools
|
|
32
|
+
├── Something broke? ──────────────→ debugging-and-error-recovery
|
|
33
|
+
├── Reviewing code? ───────────────→ code-review-and-quality
|
|
34
|
+
│ ├── Too complex? ─────────────→ code-simplification
|
|
35
|
+
│ ├── Security concerns? ───────→ security-and-hardening
|
|
36
|
+
│ └── Performance concerns? ────→ performance-optimization
|
|
37
|
+
├── Committing/branching? ─────────→ git-workflow-and-versioning
|
|
38
|
+
├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
|
|
39
|
+
├── Deprecating/migrating? ────────→ deprecation-and-migration
|
|
40
|
+
├── Writing docs/ADRs? ───────────→ documentation-and-adrs
|
|
41
|
+
├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
|
|
42
|
+
└── Deploying/launching? ─────────→ shipping-and-launch
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Core Operating Behaviors
|
|
46
|
+
|
|
47
|
+
These behaviors apply at all times, across all skills. They are non-negotiable.
|
|
48
|
+
|
|
49
|
+
### 1. Surface Assumptions
|
|
50
|
+
|
|
51
|
+
Before implementing anything non-trivial, explicitly state your assumptions:
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
ASSUMPTIONS I'M MAKING:
|
|
55
|
+
1. [assumption about requirements]
|
|
56
|
+
2. [assumption about architecture]
|
|
57
|
+
3. [assumption about scope]
|
|
58
|
+
→ Correct me now or I'll proceed with these.
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
|
|
62
|
+
|
|
63
|
+
### 2. Manage Confusion Actively
|
|
64
|
+
|
|
65
|
+
When you encounter inconsistencies, conflicting requirements, or unclear specifications:
|
|
66
|
+
|
|
67
|
+
1. **STOP.** Do not proceed with a guess.
|
|
68
|
+
2. Name the specific confusion.
|
|
69
|
+
3. Present the tradeoff or ask the clarifying question.
|
|
70
|
+
4. Wait for resolution before continuing.
|
|
71
|
+
|
|
72
|
+
**Bad:** Silently picking one interpretation and hoping it's right.
|
|
73
|
+
**Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
|
|
74
|
+
|
|
75
|
+
### 3. Push Back When Warranted
|
|
76
|
+
|
|
77
|
+
You are not a yes-machine. When an approach has clear problems:
|
|
78
|
+
|
|
79
|
+
- Point out the issue directly
|
|
80
|
+
- Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
|
|
81
|
+
- Propose an alternative
|
|
82
|
+
- Accept the human's decision if they override with full information
|
|
83
|
+
|
|
84
|
+
Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
|
|
85
|
+
|
|
86
|
+
### 4. Enforce Simplicity
|
|
87
|
+
|
|
88
|
+
Your natural tendency is to overcomplicate. Actively resist it.
|
|
89
|
+
|
|
90
|
+
Before finishing any implementation, ask:
|
|
91
|
+
- Can this be done in fewer lines?
|
|
92
|
+
- Are these abstractions earning their complexity?
|
|
93
|
+
- Would a staff engineer look at this and say "why didn't you just..."?
|
|
94
|
+
|
|
95
|
+
If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
|
|
96
|
+
|
|
97
|
+
### 5. Maintain Scope Discipline
|
|
98
|
+
|
|
99
|
+
Touch only what you're asked to touch.
|
|
100
|
+
|
|
101
|
+
Do NOT:
|
|
102
|
+
- Remove comments you don't understand
|
|
103
|
+
- "Clean up" code orthogonal to the task
|
|
104
|
+
- Refactor adjacent systems as a side effect
|
|
105
|
+
- Delete code that seems unused without explicit approval
|
|
106
|
+
- Add features not in the spec because they "seem useful"
|
|
107
|
+
|
|
108
|
+
Your job is surgical precision, not unsolicited renovation.
|
|
109
|
+
|
|
110
|
+
### 6. Verify, Don't Assume
|
|
111
|
+
|
|
112
|
+
Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
|
|
113
|
+
|
|
114
|
+
Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
|
|
115
|
+
|
|
116
|
+
## Failure Modes to Avoid
|
|
117
|
+
|
|
118
|
+
These are the subtle errors that look like productivity but create problems:
|
|
119
|
+
|
|
120
|
+
1. Making wrong assumptions without checking
|
|
121
|
+
2. Not managing your own confusion — plowing ahead when lost
|
|
122
|
+
3. Not surfacing inconsistencies you notice
|
|
123
|
+
4. Not presenting tradeoffs on non-obvious decisions
|
|
124
|
+
5. Being sycophantic ("Of course!") to approaches with clear problems
|
|
125
|
+
6. Overcomplicating code and APIs
|
|
126
|
+
7. Modifying code or comments orthogonal to the task
|
|
127
|
+
8. Removing things you don't fully understand
|
|
128
|
+
9. Building without a spec because "it's obvious"
|
|
129
|
+
10. Skipping verification because "it looks right"
|
|
130
|
+
|
|
131
|
+
## Skill Rules
|
|
132
|
+
|
|
133
|
+
1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
|
|
134
|
+
|
|
135
|
+
2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
|
|
136
|
+
|
|
137
|
+
3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
|
|
138
|
+
|
|
139
|
+
4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
|
|
140
|
+
|
|
141
|
+
## Lifecycle Sequence
|
|
142
|
+
|
|
143
|
+
For a complete feature, the typical skill sequence is:
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
1. interview-me → Extract what the user actually wants
|
|
147
|
+
2. idea-refine → Refine vague ideas
|
|
148
|
+
3. spec-driven-development → Define what we're building
|
|
149
|
+
4. planning-and-task-breakdown → Break into verifiable chunks
|
|
150
|
+
5. context-engineering → Load the right context
|
|
151
|
+
6. source-driven-development → Verify against official docs
|
|
152
|
+
7. incremental-implementation → Build slice by slice
|
|
153
|
+
8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
|
|
154
|
+
9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
|
|
155
|
+
10. test-driven-development → Prove each slice works
|
|
156
|
+
11. code-review-and-quality → Review before merge
|
|
157
|
+
12. code-simplification → Reduce unnecessary complexity while preserving behavior
|
|
158
|
+
13. git-workflow-and-versioning → Clean commit history
|
|
159
|
+
14. documentation-and-adrs → Document decisions
|
|
160
|
+
15. deprecation-and-migration → Retire old systems and move users safely when needed
|
|
161
|
+
16. shipping-and-launch → Deploy safely
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
|
|
165
|
+
|
|
166
|
+
## Quick Reference
|
|
167
|
+
|
|
168
|
+
| Phase | Skill | One-Line Summary |
|
|
169
|
+
|-------|-------|-----------------|
|
|
170
|
+
| Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
|
|
171
|
+
| Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
|
|
172
|
+
| Define | spec-driven-development | Requirements and acceptance criteria before code |
|
|
173
|
+
| Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
|
|
174
|
+
| Build | incremental-implementation | Thin vertical slices, test each before expanding |
|
|
175
|
+
| Build | source-driven-development | Verify against official docs before implementing |
|
|
176
|
+
| Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
|
|
177
|
+
| Build | context-engineering | Right context at the right time |
|
|
178
|
+
| Build | frontend-ui-engineering | Production-quality UI with accessibility |
|
|
179
|
+
| Build | api-and-interface-design | Stable interfaces with clear contracts |
|
|
180
|
+
| Verify | test-driven-development | Failing test first, then make it pass |
|
|
181
|
+
| Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
|
|
182
|
+
| Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
|
|
183
|
+
| Review | code-review-and-quality | Five-axis review with quality gates |
|
|
184
|
+
| Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
|
|
185
|
+
| Review | security-and-hardening | OWASP prevention, input validation, least privilege |
|
|
186
|
+
| Review | performance-optimization | Measure first, optimize only what matters |
|
|
187
|
+
| Ship | git-workflow-and-versioning | Atomic commits, clean history |
|
|
188
|
+
| Ship | ci-cd-and-automation | Automated quality gates on every change |
|
|
189
|
+
| Ship | deprecation-and-migration | Remove old systems and migrate users safely |
|
|
190
|
+
| Ship | documentation-and-adrs | Document the why, not just the what |
|
|
191
|
+
| Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
|
|
192
|
+
| Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
|
|
@@ -0,0 +1,347 @@
|
|
|
1
|
+
# Hermes artifacts
|
|
2
|
+
|
|
3
|
+
This directory holds the in-repository Hermes surfaces of Agent Fleet: the
|
|
4
|
+
**Desktop plugin** that shows the live fleet, and the **skills** behind the
|
|
5
|
+
coms ⇄ Hermes question bridge. They are source artifacts, installed into a
|
|
6
|
+
profile explicitly — nothing here is published to npm and nothing writes to
|
|
7
|
+
`~/.hermes` unless you run an installer.
|
|
8
|
+
|
|
9
|
+
Two distinct integrations, easy to conflate:
|
|
10
|
+
|
|
11
|
+
| | What it does | Direction | Entry point |
|
|
12
|
+
|---|---|---|---|
|
|
13
|
+
| **Desktop plugin** (`agent-fleet-herdr`) | Shows every live Agent Fleet session, its state, what it is doing, and which agent is blocked on you | Hermes reads the fleet | [docs/hermes-desktop-plugins.md](../docs/hermes-desktop-plugins.md) |
|
|
14
|
+
| **Question bridge** (`hub-liaison`) | Relays an agent's `ask_user` question to Telegram and races your answer against a local one | The fleet asks you | [docs/coms-hermes-bridge.md](../docs/coms-hermes-bridge.md) |
|
|
15
|
+
|
|
16
|
+
## Desktop plugins
|
|
17
|
+
|
|
18
|
+
`desktop-plugins/<id>/` and `plugins/<id>/` are the two halves of a Hermes
|
|
19
|
+
plugin — the Electron pane and the FastAPI backend it calls. They are installed
|
|
20
|
+
into a profile with `.pi/agent-fleet/scripts/install-hermes-plugin.sh`, never published to npm.
|
|
21
|
+
The contract, the install runbook, and the failure modes that look identical
|
|
22
|
+
from the outside are documented in
|
|
23
|
+
[docs/hermes-desktop-plugins.md](../docs/hermes-desktop-plugins.md).
|
|
24
|
+
|
|
25
|
+
- `agent-fleet-herdr` — read-only panel of live Agent Fleet sessions grouped by
|
|
26
|
+
project, flagging the ones waiting for a human.
|
|
27
|
+
- `agent-fleet-monitor` — the separate agent-hub task view (leases, generations,
|
|
28
|
+
output cursors) over the local monitor transport described below. Its own
|
|
29
|
+
Desktop panel is deliberately left uninstalled: the subagent tree is rendered
|
|
30
|
+
inside `agent-fleet-herdr`'s session modal instead, so a human never has to
|
|
31
|
+
know which pane to open.
|
|
32
|
+
|
|
33
|
+
### Install the fleet panel
|
|
34
|
+
|
|
35
|
+
Needs Hermes v0.19.0+ with the Desktop app, this checkout, and a fleet that has
|
|
36
|
+
run at least once (so `~/.pi/coms/projects/` exists). herdr is optional —
|
|
37
|
+
without it rows read `unknown` instead of a live state.
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
.pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr # --profile / --copy / --dry-run / --uninstall
|
|
41
|
+
# then restart the Hermes DESKTOP APP (its gateway is the one that mounts the routes),
|
|
42
|
+
# start a fleet, and open the "Agent Fleet" tab:
|
|
43
|
+
just fleet team default
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+

|
|
47
|
+
|
|
48
|
+
Selecting a row opens a modal with that agent's purpose, model, context, queue,
|
|
49
|
+
uptime and heartbeat, a live tail of what it is doing read from its own
|
|
50
|
+
transcript, the subagents it is running with their stdout and a Cancel each, and
|
|
51
|
+
`Focus pane` to bring its workspace to the front.
|
|
52
|
+
|
|
53
|
+

|
|
54
|
+
|
|
55
|
+
Prerequisites in full, the API, the join rules, the failure modes and the
|
|
56
|
+
deliberate limits: [docs/hermes-desktop-plugins.md](../docs/hermes-desktop-plugins.md).
|
|
57
|
+
|
|
58
|
+
`skills/hub-watchdog/` is an optional foreground, fail-closed monitor consumer. It is packaged source, not an installed or enabled profile skill. Its profile-aware lifecycle is documented in [the watchdog runbook](../docs/hermes-watchdog-supervisor.md): no installer starts/stops a gateway or changes tools, and Gate O has no checked-in live origin proof. The supported posture is journal-only/dormant; it must not deliver, steer, cancel, recover, wake a chat, or choose a fallback route.
|
|
59
|
+
|
|
60
|
+
## Skills
|
|
61
|
+
|
|
62
|
+
- `skills/hub-liaison/` — gateway-side Telegram liaison. It writes `~/.pi/coms/hermes-bridge/questions/<qid>.answer.json` answer files for `[HUB-Q:<qid>]` questions consumed by `.pi/agent-fleet/scripts/coms-hermes-bridge.ts`.
|
|
63
|
+
- `skills/hub-conductor/` — dev-profile conductor. It uses `.pi/agent-fleet/scripts/coms-cli.ts list` and `.pi/agent-fleet/scripts/coms-cli.ts send --await --timeout` to delegate to live pi hub-team peers, while preserving the no-herdr damage-control boundary.
|
|
64
|
+
|
|
65
|
+
## Install
|
|
66
|
+
|
|
67
|
+
For `hub-liaison`, use Agent Fleet's deterministic profile-aware installer rather than a raw copy:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
agent-fleet set-hermes-telegram status --profile default
|
|
71
|
+
agent-fleet set-hermes-telegram install --profile default
|
|
72
|
+
# Only when status reports a differing local tree:
|
|
73
|
+
agent-fleet set-hermes-telegram install --profile default --force
|
|
74
|
+
# Restart a currently running gateway only by explicit request:
|
|
75
|
+
agent-fleet set-hermes-telegram install --profile default --force --restart
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
The command is `/af-set-hermes-telegram`. The installer resolves the real profile path via `hermes profile show`, refuses drift without `--force`, backs up forced replacements, copies atomically, and verifies skill/tool/gateway readiness. It never sends a test Telegram message and never starts a stopped gateway. See [the bridge runbook](../docs/coms-hermes-bridge.md#telegram-bridge-control-command).
|
|
79
|
+
|
|
80
|
+
The current `hermes skills install` CLI documents registry identifiers and direct HTTP(S) `SKILL.md` URLs, not local directories, so `hermes skills install .pi/agent-fleet/hermes/skills/hub-liaison` is not the supported local installation path.
|
|
81
|
+
|
|
82
|
+
`hub-conductor` remains a source artifact for the human's dev/conductor profile. Install it by a reviewed local copy into the path reported by `hermes profile show <profile>`, or publish/install it through a pinned Hermes skill source; it is intentionally not managed by the Telegram bridge command.
|
|
83
|
+
|
|
84
|
+
Use `hub-liaison` in the gateway-owning Telegram profile and `hub-conductor` in the human's dev/conductor profile. Verify availability with `hermes --profile <profile> skills list --enabled-only` before relying on them.
|
|
85
|
+
|
|
86
|
+
## Local agent-hub monitor integration
|
|
87
|
+
|
|
88
|
+
Agent Fleet exposes an optional **local monitor transport** for Hermes-facing tools. This is
|
|
89
|
+
separate from the Telegram/coms bridge:
|
|
90
|
+
|
|
91
|
+
- `hub-liaison` and `hub-conductor` handle human questions and delegation through coms.
|
|
92
|
+
- The monitor transport exposes dispatcher and specialist state through owner-only discovery,
|
|
93
|
+
a token file, and a Unix domain socket (UDS).
|
|
94
|
+
|
|
95
|
+
A Hermes UI, operator tool, or other local client may consume the transport contract described
|
|
96
|
+
below, but it owns its own presentation and lifecycle. The hub remains the source of truth for
|
|
97
|
+
task state and cancellation. Source artifacts being present in this repository or its package do
|
|
98
|
+
not install, enable, or prove a live Hermes client. In particular, monitor cursor/discovery
|
|
99
|
+
fields and local tests are not proof of a Hermes origin identity or watcher delivery route.
|
|
100
|
+
|
|
101
|
+
### Integration in action
|
|
102
|
+
|
|
103
|
+
The hub can surface an `ask_user` decision in Hermes Desktop while the specialist workflow keeps
|
|
104
|
+
running. The prompt preserves the question and its choices instead of flattening them into an
|
|
105
|
+
unstructured message:
|
|
106
|
+
|
|
107
|
+

|
|
108
|
+
|
|
109
|
+
The side-by-side view shows the same live question in the Pi hub and Hermes Desktop. This is the
|
|
110
|
+
question-piping path used for remote human input; task monitoring remains the separate local
|
|
111
|
+
transport described below.
|
|
112
|
+
|
|
113
|
+

|
|
114
|
+
|
|
115
|
+
### Start a monitored hub
|
|
116
|
+
|
|
117
|
+
Nothing to set up. A Herdr-backed hub is required because the stable hub identity includes
|
|
118
|
+
`HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`, so use a team recipe:
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
just fleet team default
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
[.pi/agent-fleet/scripts/lib/monitor-env.ts](../scripts/lib/monitor-env.ts) picks the profile ID (`dev`) and the
|
|
125
|
+
runtime directory (`$XDG_RUNTIME_DIR/agent-fleet-monitor`, created mode 0700) and the launchers
|
|
126
|
+
export both. Watch the tasks in the **agent-fleet-herdr** pane: select the hub's row, and its
|
|
127
|
+
subagents are a section of the modal with their live output and a Cancel each.
|
|
128
|
+
|
|
129
|
+
To point a hub at a different profile, or to turn the monitor off, set the variables yourself —
|
|
130
|
+
an existing value is never overwritten:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
AGENT_FLEET_PROFILE_ID=prod just fleet team default # a different Hermes profile
|
|
134
|
+
AGENT_FLEET_MONITOR=0 just fleet team default # unmonitored
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
If either monitor variable is invalid, if the runtime directory cannot be made mode 0700, or if
|
|
138
|
+
the hub lacks stable Herdr identity, the monitor stays disabled while normal agent-hub
|
|
139
|
+
orchestration continues. The profile ID must start with an alphanumeric character and may contain
|
|
140
|
+
only alphanumerics, `.`, `_`, or `-`; `..` is rejected — the same class
|
|
141
|
+
`.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py` enforces when it reads the directory
|
|
142
|
+
back, because a value one end accepts and the other rejects is an empty listing with no error
|
|
143
|
+
anywhere.
|
|
144
|
+
|
|
145
|
+
### Discover the local endpoint
|
|
146
|
+
|
|
147
|
+
The hub creates mode `0700` namespaces under the runtime root. Each active registration contains
|
|
148
|
+
one mode `0600` discovery file and token file, plus a mode `0600` socket:
|
|
149
|
+
|
|
150
|
+
```text
|
|
151
|
+
<runtime>/<profile-sha256>/<hub-sha256>/discovery-<owner-id>.json
|
|
152
|
+
<runtime>/<profile-sha256>/<hub-sha256>/token-<owner-id>
|
|
153
|
+
<runtime>/s/<registration-sha256>/s
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
You can list discovery paths without reading or printing their tokens:
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
find "$AGENT_FLEET_MONITOR_RUNTIME_DIR" -type f -name 'discovery-*.json' -print
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
A discovery record has this shape:
|
|
163
|
+
|
|
164
|
+
```json
|
|
165
|
+
{
|
|
166
|
+
"owner": "9db4478e-ef6e-4d5d-930b-6d637f5de4d1",
|
|
167
|
+
"socket": "@runtime/s/0123456789abcdef0123456789abcdef/s",
|
|
168
|
+
"token": "token-9db4478e-ef6e-4d5d-930b-6d637f5de4d1",
|
|
169
|
+
"lease": {
|
|
170
|
+
"hub": "<stable-hub-id>",
|
|
171
|
+
"pid": 12345,
|
|
172
|
+
"startedAt": "2026-07-21T09:00:00.000Z",
|
|
173
|
+
"expiresAt": "2026-07-21T09:00:30.000Z"
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
A consumer must reject expired or malformed discovery, paths outside the configured runtime root,
|
|
179
|
+
symlinks, unsafe modes, and socket/token names that do not match the discovery schema. It should
|
|
180
|
+
re-discover after reconnect instead of caching a token or absolute socket path. Never put the token
|
|
181
|
+
in a URL, log, Desktop storage, or command-line argument.
|
|
182
|
+
|
|
183
|
+
### Request snapshot, output, and cancellation
|
|
184
|
+
|
|
185
|
+
The UDS protocol is newline-delimited JSON with one request per connection. Read the token from the
|
|
186
|
+
discovery record's sibling token file, use it only in memory, and terminate every request with
|
|
187
|
+
`\n`.
|
|
188
|
+
|
|
189
|
+
```js
|
|
190
|
+
import net from "node:net";
|
|
191
|
+
|
|
192
|
+
export function monitorRequest(socketPath, request) {
|
|
193
|
+
return new Promise((resolve, reject) => {
|
|
194
|
+
const client = net.createConnection(socketPath);
|
|
195
|
+
let body = "";
|
|
196
|
+
client.setTimeout(1_000, () => client.destroy(new Error("monitor timeout")));
|
|
197
|
+
client.on("connect", () => client.end(`${JSON.stringify(request)}\n`));
|
|
198
|
+
client.on("data", chunk => { body += chunk; });
|
|
199
|
+
client.on("error", reject);
|
|
200
|
+
client.on("close", () => resolve(body ? JSON.parse(body) : null));
|
|
201
|
+
});
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
// `token` and `socketPath` were resolved and validated from live discovery.
|
|
205
|
+
const current = await monitorRequest(socketPath, { type: "snapshot", token });
|
|
206
|
+
const delta = await monitorRequest(socketPath, {
|
|
207
|
+
type: "output",
|
|
208
|
+
token,
|
|
209
|
+
taskId: "builder:1",
|
|
210
|
+
generation: 1,
|
|
211
|
+
afterSequence: 0
|
|
212
|
+
});
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
Example snapshot response:
|
|
216
|
+
|
|
217
|
+
```json
|
|
218
|
+
{
|
|
219
|
+
"ok": true,
|
|
220
|
+
"snapshot": {
|
|
221
|
+
"tasks": [
|
|
222
|
+
{
|
|
223
|
+
"id": "builder:1",
|
|
224
|
+
"generation": 1,
|
|
225
|
+
"kind": "child",
|
|
226
|
+
"state": "running",
|
|
227
|
+
"outputLatestSequence": 4
|
|
228
|
+
}
|
|
229
|
+
]
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
Continue incremental output from the returned sequence to avoid duplicates:
|
|
235
|
+
|
|
236
|
+
```js
|
|
237
|
+
const next = await monitorRequest(socketPath, {
|
|
238
|
+
type: "output",
|
|
239
|
+
token,
|
|
240
|
+
taskId: "builder:1",
|
|
241
|
+
generation: 1,
|
|
242
|
+
afterSequence: delta.output.sequence
|
|
243
|
+
});
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
Cancellation is an explicit operator action and must use the exact displayed task ID and
|
|
247
|
+
generation:
|
|
248
|
+
|
|
249
|
+
```js
|
|
250
|
+
const cancelled = await monitorRequest(socketPath, {
|
|
251
|
+
type: "cancel",
|
|
252
|
+
token,
|
|
253
|
+
taskId: "builder:1",
|
|
254
|
+
generation: 1
|
|
255
|
+
});
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
A native specialist cancellation targets only the hub-owned process generation and validates its
|
|
259
|
+
process identity before signalling it. Cancelling a coms-backed run abandons the hub's local wait;
|
|
260
|
+
the remote peer may continue, so it is never an automatic recovery target and the watchdog must not
|
|
261
|
+
retry or re-dispatch it. Neither operation creates, focuses, closes, or otherwise controls a
|
|
262
|
+
Herdr pane or workspace.
|
|
263
|
+
|
|
264
|
+
### Additive `events` and `invoke` requests
|
|
265
|
+
|
|
266
|
+
Two request types extend the same socket. A hub that does not implement them answers `unsupported`,
|
|
267
|
+
so a snapshot/output/cancel consumer keeps working unchanged.
|
|
268
|
+
|
|
269
|
+
`events` replays a bounded journal from a cursor the consumer holds. Set a read timeout that covers
|
|
270
|
+
the `waitMs` window you ask the hub to hold, or every quiet poll expires locally and looks like an
|
|
271
|
+
outage:
|
|
272
|
+
|
|
273
|
+
```js
|
|
274
|
+
const batch = await monitorRequest(socketPath, {
|
|
275
|
+
type: "events",
|
|
276
|
+
token,
|
|
277
|
+
afterSequence: 0,
|
|
278
|
+
limit: 50, // 1–100
|
|
279
|
+
waitMs: 2000 // 0–25000 long-poll window
|
|
280
|
+
});
|
|
281
|
+
// { ok: true, events: { firstAvailableSequence, latestSequence, items: [...], timedOut } }
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
A cursor older than the retained window is refused rather than silently skipped. Reconcile from a
|
|
285
|
+
fresh snapshot and resume from sequence 0:
|
|
286
|
+
|
|
287
|
+
```json
|
|
288
|
+
{"ok": false, "error": "cursor_too_old", "snapshotRequired": true, "firstAvailableSequence": 9, "latestSequence": 12}
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
`invoke` submits one typed request and returns an admission status — never a result of work:
|
|
292
|
+
|
|
293
|
+
```js
|
|
294
|
+
const admitted = await monitorRequest(socketPath, {
|
|
295
|
+
type: "invoke",
|
|
296
|
+
token,
|
|
297
|
+
requestId: "request-a",
|
|
298
|
+
taskId: "builder:1",
|
|
299
|
+
generation: 1,
|
|
300
|
+
action: "request_status",
|
|
301
|
+
parameters: { assertionIds: [], evidenceEventIds: ["hub:1"] },
|
|
302
|
+
basis: { deviation: "stalled_progress", judgment: "confirmed" }
|
|
303
|
+
});
|
|
304
|
+
// { ok: true, result: { status: "accepted" } }
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
`status` is one of `accepted`, `duplicate`, `queue_full`, `stale_generation`, `owner_changed`,
|
|
308
|
+
`already_terminal`, `idempotency_conflict`, `unsupported`, or `rejected`. `accepted` means the hub
|
|
309
|
+
queued a visible follow-up for its operator; it does not mean anything ran. Reusing a `requestId`
|
|
310
|
+
returns `duplicate` and adds no second follow-up; reusing it with different parameters returns
|
|
311
|
+
`idempotency_conflict`. The action set is closed — there is no shell, tool, Herdr, or free-text
|
|
312
|
+
surface.
|
|
313
|
+
|
|
314
|
+
### Failure and reconnect behavior
|
|
315
|
+
|
|
316
|
+
- `{"ok":false,"error":"unauthorized"}` means the token does not match current ownership.
|
|
317
|
+
- `monitor_unavailable` means the hub-side snapshot/output/cancel handler failed closed.
|
|
318
|
+
- `response_too_large` means the consumer must fall back to a fresh bounded snapshot or cursor.
|
|
319
|
+
- An empty response indicates malformed or out-of-contract input; do not retry it unchanged.
|
|
320
|
+
- When the lease expires, the socket closes, or ownership changes, discard the token and repeat
|
|
321
|
+
discovery. Never fall back to public TCP, a gateway endpoint, or Herdr pane control.
|
|
322
|
+
|
|
323
|
+
Stopping the hub removes its owned discovery, token, and socket. Historical monitor journals under
|
|
324
|
+
the configured runtime root are separate from this live registration and should be removed only by
|
|
325
|
+
an operator who has identified the exact profile/runtime scope.
|
|
326
|
+
|
|
327
|
+
## Usage notes
|
|
328
|
+
|
|
329
|
+
For `hub-liaison`, ensure the Telegram-capable profile has terminal/file-write tools enabled so it can create exactly `~/.pi/coms/hermes-bridge/questions/<qid>.answer.json` and nothing outside that questions directory.
|
|
330
|
+
|
|
331
|
+
For `hub-conductor`, either start the pi team/pool outside Hermes first, or use the repo recipe to create a visible conductor workspace:
|
|
332
|
+
|
|
333
|
+
```bash
|
|
334
|
+
just conductor docs # conductor pane (`hermes -p dev`) + docs team panes
|
|
335
|
+
just fleet conductor hermes docs --dry-run # preview, no Herdr calls
|
|
336
|
+
```
|
|
337
|
+
|
|
338
|
+
Inside Hermes, discover and delegate only through coms:
|
|
339
|
+
|
|
340
|
+
```bash
|
|
341
|
+
node --experimental-strip-types /home/nchankov/repos/agent-fleet/scripts/coms-cli.ts list
|
|
342
|
+
node --experimental-strip-types /home/nchankov/repos/agent-fleet/scripts/coms-cli.ts send <peer> "<task>" --await --timeout 300000
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
Hermes must not drive herdr panes or workspaces; the `just conductor` recipe creates the pane before Hermes starts. The no-herdr boundary is documented in `docs/coms-hermes-bridge.md` and governed by `.pi/damage-control-rules.yaml`.
|
|
346
|
+
|
|
347
|
+
Hermes/Telegram remains the inbound `ask_user` path. The experimental ChatGPT Fleet session client is a ChatGPT-initiated channel to an existing Pi session and is not an inbound `ask_user` route. See the [session client runbook](../docs/codex-session-bridge.md).
|