@chankov/agent-fleet 2.0.16 → 2.0.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/harnesses/agent-hub/README.md +4 -0
- package/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
- package/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.pi/harnesses/agent-hub/index.ts +8 -2
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +9 -24
- package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +7 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
- package/.pi/harnesses/agent-hub/system1-communication-store.ts +29 -7
- package/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
- package/.pi/harnesses/agent-hub/work-mode.ts +6 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/index.ts +6 -23
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/damage-control-shared.ts +29 -0
- package/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.pi/harnesses/lib/system1/config-agentic.js +14 -0
- package/.pi/harnesses/lib/system1/config-v2.js +6 -3
- package/.versions/2.0.17/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.17/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.17/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.17/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.17/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.17/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.17/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.17/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.17/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.17/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.17/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.17/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.17/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.17/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.17/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.17/.pi/extensions/package.json +9 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/README.md +1456 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/config/overrides.ts +155 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/delegate.ts +467 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/index.ts +2607 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/no-progress.ts +563 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/work-mode.ts +136 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-config.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-local.ts +71 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot.ts +228 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/fragments.ts +123 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/system-prompt.ts +124 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/spawn.ts +534 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-communication-store.ts +151 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode.ts +184 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.17/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.17/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.17/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.17/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/index.ts +533 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.17/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.17/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.17/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.17/.pi/harnesses/lib/damage-control-shared.ts +226 -0
- package/.versions/2.0.17/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.17/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.17/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.17/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.versions/2.0.17/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-agentic.js +14 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-proactive.js +57 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-v2.js +103 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.17/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.17/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.17/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.17/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.17/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.17/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.17/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.17/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.17/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.17/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.17/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.17/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.17/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.17/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.17/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.17/.version +1 -0
- package/.versions/2.0.17/agents/architect.md +24 -0
- package/.versions/2.0.17/agents/bowser.md +28 -0
- package/.versions/2.0.17/agents/builder.md +55 -0
- package/.versions/2.0.17/agents/code-reviewer.md +209 -0
- package/.versions/2.0.17/agents/deep-researcher.md +32 -0
- package/.versions/2.0.17/agents/documenter.md +22 -0
- package/.versions/2.0.17/agents/orchestrator.md +22 -0
- package/.versions/2.0.17/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.17/agents/planner.md +105 -0
- package/.versions/2.0.17/agents/releaser.md +24 -0
- package/.versions/2.0.17/agents/researcher.md +30 -0
- package/.versions/2.0.17/agents/security-auditor.md +167 -0
- package/.versions/2.0.17/agents/test-engineer.md +153 -0
- package/.versions/2.0.17/agents/web-debugger.md +44 -0
- package/.versions/2.0.17/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.17/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.17/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.17/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.17/docs/ARCHITECTURE.md +834 -0
- package/.versions/2.0.17/docs/agent-fleet-setup.md +1101 -0
- package/.versions/2.0.17/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.17/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.17/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.17/docs/getting-started.md +126 -0
- package/.versions/2.0.17/docs/npm-install.md +530 -0
- package/.versions/2.0.17/docs/pi-extensions.md +454 -0
- package/.versions/2.0.17/docs/pi-setup.md +92 -0
- package/.versions/2.0.17/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.17/install-manifest.json +3193 -0
- package/.versions/2.0.17/justfile +247 -0
- package/.versions/2.0.17/manifest-meta.json +1071 -0
- package/.versions/2.0.17/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.17/references/communication-contract.md +26 -0
- package/.versions/2.0.17/references/definition-of-done.md +67 -0
- package/.versions/2.0.17/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.17/references/observability-checklist.md +92 -0
- package/.versions/2.0.17/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.17/references/performance-checklist.md +236 -0
- package/.versions/2.0.17/references/prompting-patterns.md +380 -0
- package/.versions/2.0.17/references/security-checklist.md +245 -0
- package/.versions/2.0.17/references/testing-patterns.md +235 -0
- package/.versions/2.0.17/references/workflow-authoring.md +304 -0
- package/.versions/2.0.17/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.17/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.17/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.17/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.17/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.17/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.17/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.17/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.17/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.17/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.17/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.17/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.17/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.17/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.17/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.17/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.17/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.17/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.17/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.17/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.17/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.17/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.17/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.17/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.17/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.17/skills/repository-ai-setup/SKILL.md +117 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.17/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.17/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.17/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +12 -0
- package/docs/system1-agentic.md +106 -0
- package/install-manifest.json +1 -1
- package/package.json +5 -2
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type {ExtensionAPI} from '@mariozechner/pi-coding-agent';
|
|
2
|
+
import {Type} from '@sinclair/typebox';
|
|
3
|
+
import type {AgenticRuntime} from '../agentic-runtime.ts';
|
|
4
|
+
// Nested values are JSON-validated again by the bounded runtime contract.
|
|
5
|
+
const json=Type.Unknown();
|
|
6
|
+
const text=Type.Union([Type.String(),Type.Array(json),Type.Record(Type.String(),json)]);
|
|
7
|
+
const base={id:Type.String({pattern:'^[A-Za-z0-9_-]{1,64}$'}),instructions:text};
|
|
8
|
+
export const ASK_SYSTEM1_PARAMETERS=Type.Object({
|
|
9
|
+
state:Type.Optional(text),
|
|
10
|
+
paths:Type.Optional(Type.Array(Type.Object({path:Type.String({maxLength:1024}),startLine:Type.Optional(Type.Integer({minimum:1})),endLine:Type.Optional(Type.Integer({minimum:1}))},{additionalProperties:false}),{maxItems:20})),
|
|
11
|
+
evidenceRefs:Type.Optional(Type.Array(Type.String({maxLength:256}),{maxItems:20})),
|
|
12
|
+
questions:Type.Array(Type.Union([
|
|
13
|
+
Type.Object({...base,type:Type.Literal('choice'),options:Type.Record(Type.String(),Type.Union([text,Type.Null()]))},{additionalProperties:false}),
|
|
14
|
+
Type.Object({...base,type:Type.Literal('predicate'),criteria:Type.Optional(Type.Object({true:Type.Optional(text),false:Type.Optional(text)},{additionalProperties:false}))},{additionalProperties:false}),
|
|
15
|
+
Type.Object({...base,type:Type.Literal('ordinal'),levels:Type.Array(Type.String(),{minItems:2,maxItems:10})},{additionalProperties:false}),
|
|
16
|
+
]),{minItems:1,maxItems:16}),
|
|
17
|
+
},{additionalProperties:false});
|
|
18
|
+
export function registerAskSystem1(pi:ExtensionAPI,deps:{runtime():AgenticRuntime|null}) {
|
|
19
|
+
pi.registerTool({name:'ask_system1',label:'Ask System 1',parameters:ASK_SYSTEM1_PARAMETERS,
|
|
20
|
+
description:'Advisory System 1 batch for bounded semantic judgments: classification, selected-file relevance, risk, assumptions, request clarity and failure interpretation. In recommended mode, call first for suitable judgments, including small tasks, before extended reasoning or research for the same question. Use minimal non-secret state, selected repo files/ranges and opted-in recorded bash evidence refs. Never executes commands, grants rights, proves test/review pass, changes gates or replaces required reading before editing. Bodies are not returned; summaries retain hashes and local readback references. Explicit parent Hub opt-in only; unavailable/partial evidence refuses rather than truncates. Choice questions require other or unknown.',
|
|
21
|
+
async execute(_id,params,signal) {
|
|
22
|
+
const result=await deps.runtime()?.evaluate(params,signal)??{status:'skipped',reason:'consumer_off',advisory:true,sourceSummary:[]};
|
|
23
|
+
return {content:[{type:'text',text:JSON.stringify(result)}],details:result};
|
|
24
|
+
}});
|
|
25
|
+
}
|
|
@@ -16,7 +16,7 @@ export async function openSystem1Communication(ctx: Pick<ExtensionContext, "ui">
|
|
|
16
16
|
let content: string[];
|
|
17
17
|
if (detail) {
|
|
18
18
|
const p = store.snapshot().find(p => p.id === detail);
|
|
19
|
-
content = p ? [`${p.consumer} · ${p.provider}/${p.model} · ${p.status} · ${p.id}`, ...(p.consumer === "task-triage" ? ["Provider result only; task acceptance and obligations are separate"] : []), "Request", p.request ?? p.requestOmitted ?? "unavailable", "Response", p.response ?? p.responseOmitted ?? "pending", `${action === 0 ? "❯" : " "} Copy request ${action === 1 ? "❯" : " "} Copy response`].flatMap(x => x.split("\n")) : ["Pair evicted or capture cleared. Esc back."];
|
|
19
|
+
content = p ? [`${p.consumer} · ${p.provider}/${p.model} · ${p.status} · ${p.id}`, ...(p.consumer === "task-triage" ? ["Provider result only; task acceptance and obligations are separate"] : p.consumer === 'agenticAsk' ? ['Advisory metadata only; no execution evidence, permission or gate closure'] : []), "Request", p.request ?? p.requestOmitted ?? "unavailable", "Response", p.response ?? p.responseOmitted ?? "pending", `${action === 0 ? "❯" : " "} Copy request ${action === 1 ? "❯" : " "} Copy response`].flatMap(x => x.split("\n")) : ["Pair evicted or capture cleared. Esc back."];
|
|
20
20
|
} else {
|
|
21
21
|
const entries = rows(); const retained = entries.findIndex(r => `${r.pair.id}:${r.direction}` === selectedKey); if (retained >= 0) selected = retained; selected = Math.max(0, Math.min(selected, entries.length - 1));
|
|
22
22
|
selectedKey = entries[selected] ? `${entries[selected].pair.id}:${entries[selected].direction}` : "";
|
|
@@ -24,6 +24,7 @@ const HUB_OWNED_TOOLS = new Set<string>([
|
|
|
24
24
|
...ORCHESTRATION_TOOLS,
|
|
25
25
|
...CONDITIONAL_TOOLS,
|
|
26
26
|
"filesystem",
|
|
27
|
+
"ask_system1",
|
|
27
28
|
]);
|
|
28
29
|
|
|
29
30
|
export function parseWorkMode(value: unknown): WorkMode | null {
|
|
@@ -141,9 +142,10 @@ export function workModePrompt(workMode: WorkMode): { intro: string; hardRules:
|
|
|
141
142
|
return {
|
|
142
143
|
intro: "You are a dispatcher agent — an orchestrator. You coordinate specialist agents to accomplish tasks. You have no generic direct coding tools.",
|
|
143
144
|
hardRules: `- NEVER try to execute, edit, or write repository code directly — you have no generic bash/write/edit tools.
|
|
144
|
-
- \`filesystem\` is
|
|
145
|
+
- \`filesystem\` is a narrow direct inspection exception: always available in orchestrator for read-only stat, inventory, excerpt, and readback. Call stat before excerpt. The self-read ceiling is 64 KiB for one file and 64 KiB for the whole turn, including inventory. A too_large refusal means do not retry: call spawn_research for a summary or dispatch_agent with the path only. Snapshot stays profile-gated. It grants no arbitrary write or shell authority.
|
|
145
146
|
- Tool availability is never gate admission: a visible tool can still refuse under tier, process, budget, or safety gates. Read the refusal's snapshot and correct the prerequisite; routine slash resets are not the recovery path.
|
|
146
147
|
- Optionally use \`dispatch_triage\` for System 1 persona/risk advice before dispatch when it is listed in the active tools. It is not a gate or permission; low predicted risk never removes checks. Do not call it when it is absent.
|
|
148
|
+
- When listed, \`ask_system1\` provides bounded semantic judgments over explicitly selected evidence. Follow its configured usage policy; recommended mode makes it the first route for suitable judgments. It never executes shell, grants permission, closes gates or replaces required reading/review. Do not call it when absent.
|
|
147
149
|
- ALWAYS use \`dispatch_agent\` to get implementation work done; use \`spawn_research\` for recon that \`filesystem\` cannot answer.
|
|
148
150
|
- The turn dispatch number in Current task state is the effective allowance. Orchestrator raises trivial/small to at least 3 dispatches per turn unless a max-dispatches-per-turn ceiling is configured. Research calls and the task dispatch envelope stay on the tier.`,
|
|
149
151
|
};
|
|
@@ -158,6 +160,8 @@ export function resolveWorkModeTools(options: {
|
|
|
158
160
|
deterministicTools?: boolean;
|
|
159
161
|
/** Omit dispatch_triage unless the consumer can evaluate. Default off. */
|
|
160
162
|
triageEnabled?: boolean;
|
|
163
|
+
/** Approved parent-only advisory consumer; default off. */
|
|
164
|
+
agenticAskEnabled?: boolean;
|
|
161
165
|
/** Active and provisional packs; omitted only for legacy callers. */
|
|
162
166
|
capabilityPacks?: readonly ("core" | "fleet" | "verification" | "peer" | "workspace" | "compaction")[];
|
|
163
167
|
}): string[] {
|
|
@@ -171,6 +175,7 @@ export function resolveWorkModeTools(options: {
|
|
|
171
175
|
if (packs.has("peer") && options.comsReady) tools.push(...COMS_TOOLS);
|
|
172
176
|
if (packs.has("workspace") && options.herdrReady) tools.push(...HERDR_TOOLS);
|
|
173
177
|
if (packs.has("core") && options.askUserAvailable) tools.push("ask_user");
|
|
178
|
+
if (packs.has("core") && options.agenticAskEnabled === true) tools.push("ask_system1");
|
|
174
179
|
if (packs.has("compaction")) tools.push("request_compaction");
|
|
175
180
|
// Operator inspection stays profile-gated. Orchestrator always gets the same
|
|
176
181
|
// tool, but snapshot remains refused unless deterministic-tools is on.
|
|
@@ -40,6 +40,7 @@ import * as fs from "fs";
|
|
|
40
40
|
import * as path from "path";
|
|
41
41
|
import * as os from "os";
|
|
42
42
|
import {
|
|
43
|
+
damageControlPathMatches,
|
|
43
44
|
AGENT_ID_ENV,
|
|
44
45
|
ASK_ENDPOINT_ENV,
|
|
45
46
|
EXEMPTIONS_FILE_ENV,
|
|
@@ -157,24 +158,6 @@ export default function (pi: ExtensionAPI) {
|
|
|
157
158
|
return false;
|
|
158
159
|
}
|
|
159
160
|
|
|
160
|
-
function isPathMatch(targetPath: string, pattern: string, cwd: string): boolean {
|
|
161
|
-
const resolvedPattern = pattern.startsWith("~") ? path.join(os.homedir(), pattern.slice(1)) : pattern;
|
|
162
|
-
|
|
163
|
-
if (resolvedPattern.endsWith("/")) {
|
|
164
|
-
const absolutePattern = path.isAbsolute(resolvedPattern) ? resolvedPattern : path.resolve(cwd, resolvedPattern);
|
|
165
|
-
return targetPath.startsWith(absolutePattern);
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
const regexPattern = resolvedPattern
|
|
169
|
-
.replace(/[.+^${}()|[\]\\]/g, "\\$&")
|
|
170
|
-
.replace(/\*/g, ".*");
|
|
171
|
-
|
|
172
|
-
const regex = new RegExp(`^${regexPattern}$|^${regexPattern}/|/${regexPattern}$|/${regexPattern}/`);
|
|
173
|
-
|
|
174
|
-
const relativePath = path.relative(cwd, targetPath);
|
|
175
|
-
|
|
176
|
-
return regex.test(targetPath) || regex.test(relativePath) || targetPath.includes(resolvedPattern) || relativePath.includes(resolvedPattern);
|
|
177
|
-
}
|
|
178
161
|
|
|
179
162
|
// An exemption unlocks the exact protected pattern it names, or any target
|
|
180
163
|
// it would itself match under the same rules the block used.
|
|
@@ -182,7 +165,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
182
165
|
if (ex.pattern === matchedPattern) return true;
|
|
183
166
|
if (command && command.includes(ex.pattern)) return true;
|
|
184
167
|
for (const p of inputPaths) {
|
|
185
|
-
if (
|
|
168
|
+
if (damageControlPathMatches(resolvePath(p, cwd), ex.pattern, cwd)) return true;
|
|
186
169
|
}
|
|
187
170
|
return false;
|
|
188
171
|
}
|
|
@@ -311,7 +294,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
311
294
|
for (const p of pathsToCheck) {
|
|
312
295
|
const resolved = resolvePath(p, ctx.cwd);
|
|
313
296
|
for (const zap of rules.zeroAccessPaths) {
|
|
314
|
-
if (
|
|
297
|
+
if (damageControlPathMatches(resolved, zap, ctx.cwd)) {
|
|
315
298
|
matchedPattern = zap;
|
|
316
299
|
matchedCategory = "zero_access";
|
|
317
300
|
return `Access to zero-access path restricted: ${zap}`;
|
|
@@ -338,7 +321,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
338
321
|
|
|
339
322
|
if (isToolCallEventType("grep", event) && event.input.glob) {
|
|
340
323
|
for (const zap of rules.zeroAccessPaths) {
|
|
341
|
-
if (event.input.glob.includes(zap) ||
|
|
324
|
+
if (event.input.glob.includes(zap) || damageControlPathMatches(event.input.glob, zap, ctx.cwd)) {
|
|
342
325
|
violationReason = `Glob matches zero-access path: ${zap}`;
|
|
343
326
|
matchedPattern = zap;
|
|
344
327
|
matchedCategory = "zero_access";
|
|
@@ -351,7 +334,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
351
334
|
// above only sees the search root ("."), so check the pattern too, mirroring grep's glob.
|
|
352
335
|
if (!violationReason && isToolCallEventType("find", event) && event.input.pattern) {
|
|
353
336
|
for (const zap of rules.zeroAccessPaths) {
|
|
354
|
-
if (event.input.pattern.includes(zap) ||
|
|
337
|
+
if (event.input.pattern.includes(zap) || damageControlPathMatches(event.input.pattern, zap, ctx.cwd)) {
|
|
355
338
|
violationReason = `Find pattern matches zero-access path: ${zap}`;
|
|
356
339
|
matchedPattern = zap;
|
|
357
340
|
matchedCategory = "zero_access";
|
|
@@ -418,7 +401,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
418
401
|
for (const p of inputPaths) {
|
|
419
402
|
const resolved = resolvePath(p, ctx.cwd);
|
|
420
403
|
for (const rop of rules.readOnlyPaths) {
|
|
421
|
-
if (
|
|
404
|
+
if (damageControlPathMatches(resolved, rop, ctx.cwd)) {
|
|
422
405
|
violationReason = `Modification of read-only path restricted: ${rop}`;
|
|
423
406
|
matchedPattern = rop;
|
|
424
407
|
matchedCategory = "read_only";
|
|
@@ -17,6 +17,21 @@ import * as fs from "fs";
|
|
|
17
17
|
import * as net from "net";
|
|
18
18
|
import * as os from "os";
|
|
19
19
|
import * as path from "path";
|
|
20
|
+
import { parse as parseYaml } from 'yaml';
|
|
21
|
+
import { safeSourceRead } from './safe-source-read.js';
|
|
22
|
+
|
|
23
|
+
/** Explicit file-access check for consumers outside the named tool hook. Invalid policy fails closed. */
|
|
24
|
+
export function currentFileAccessAllowed(root: string, target: string): boolean {
|
|
25
|
+
const project = path.join(root, '.pi/damage-control-rules.yaml');
|
|
26
|
+
const global = path.join(os.homedir(), '.pi/damage-control-rules.yaml');
|
|
27
|
+
try {
|
|
28
|
+
const selected = fs.existsSync(project) ? project : fs.existsSync(global) ? global : null;
|
|
29
|
+
if (!selected) return true;
|
|
30
|
+
const policy = parseYaml(safeSourceRead(selected === project ? root : os.homedir(), selected, 65536).toString('utf8'));
|
|
31
|
+
if (!policy || typeof policy !== 'object' || Array.isArray(policy) || (policy.zeroAccessPaths !== undefined && (!Array.isArray(policy.zeroAccessPaths) || policy.zeroAccessPaths.some((p: unknown) => typeof p !== 'string')))) return false;
|
|
32
|
+
return !(policy.zeroAccessPaths ?? []).some((p: string) => damageControlPathMatches(path.resolve(root, target), p, root));
|
|
33
|
+
} catch { return false; }
|
|
34
|
+
}
|
|
20
35
|
|
|
21
36
|
// Env plumbing agent-hub sets on spawned children. spawnPiAgent spreads
|
|
22
37
|
// process.env, so delegate grandchildren inherit these for free.
|
|
@@ -195,3 +210,17 @@ export function requestAccessFromHub(
|
|
|
195
210
|
sock.on("close", () => settle("error"));
|
|
196
211
|
});
|
|
197
212
|
}
|
|
213
|
+
|
|
214
|
+
export function damageControlPathMatches(targetPath: string, pattern: string, cwd: string): boolean {
|
|
215
|
+
const resolvedPattern = pattern.startsWith("~") ? path.join(os.homedir(), pattern.slice(1)) : pattern;
|
|
216
|
+
if (resolvedPattern.endsWith("/")) {
|
|
217
|
+
const absolutePattern = path.isAbsolute(resolvedPattern) ? resolvedPattern : path.resolve(cwd, resolvedPattern);
|
|
218
|
+
return targetPath.startsWith(absolutePattern);
|
|
219
|
+
}
|
|
220
|
+
const regexPattern = resolvedPattern
|
|
221
|
+
.replace(/[.+^${}()|[\]\\]/g, "\\$&")
|
|
222
|
+
.replace(/\*/g, ".*");
|
|
223
|
+
const regex = new RegExp(`^${regexPattern}$|^${regexPattern}/|/${regexPattern}$|/${regexPattern}/`);
|
|
224
|
+
const relativePath = path.relative(cwd, targetPath);
|
|
225
|
+
return regex.test(targetPath) || regex.test(relativePath) || targetPath.includes(resolvedPattern) || relativePath.includes(resolvedPattern);
|
|
226
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
// @ts-nocheck
|
|
2
|
+
import {closeSync,constants,fstatSync,lstatSync,openSync,readSync,realpathSync} from 'node:fs';
|
|
3
|
+
import {isAbsolute,join,relative,resolve} from 'node:path';
|
|
4
|
+
export function checkedSourcePath(root,path) {
|
|
5
|
+
const realRoot=realpathSync(root), full=resolve(path), rel=relative(realRoot,full);
|
|
6
|
+
if(!rel||rel.startsWith('..')||isAbsolute(rel))throw Error('source_denied');
|
|
7
|
+
let cursor=realRoot;
|
|
8
|
+
for(const part of rel.split('/')) {cursor=join(cursor,part);if(lstatSync(cursor).isSymbolicLink())throw Error('source_denied');}
|
|
9
|
+
if(realpathSync(full)!==full)throw Error('source_denied');
|
|
10
|
+
return full;
|
|
11
|
+
}
|
|
12
|
+
export function safeSourceRead(root,path,maxBytes,check=()=>{},afterFirstRead=()=>{}) {
|
|
13
|
+
check();const full=checkedSourcePath(root,path), fd=openSync(full,constants.O_RDONLY|constants.O_NOFOLLOW|constants.O_NONBLOCK);
|
|
14
|
+
try {
|
|
15
|
+
const before=fstatSync(fd);
|
|
16
|
+
if(!before.isFile())throw Error('source_denied');
|
|
17
|
+
if(before.size>maxBytes)throw Error('state_too_large');
|
|
18
|
+
// Recheck the opened descriptor against the fenced pathname before any bytes
|
|
19
|
+
// are read, including an ancestor swapped between the preflight and open.
|
|
20
|
+
checkedSourcePath(root,full);const opened=lstatSync(full);
|
|
21
|
+
if(opened.ino!==before.ino||opened.dev!==before.dev)throw Error('source_changed');
|
|
22
|
+
const read=()=>{const b=Buffer.alloc(before.size);let offset=0;while(offset<b.length){check();const n=readSync(fd,b,offset,b.length-offset,offset);if(!n)throw Error('source_changed');offset+=n;}return b;};
|
|
23
|
+
const bytes=read();afterFirstRead();const confirm=read(),after=fstatSync(fd);checkedSourcePath(root,full);const final=lstatSync(full);
|
|
24
|
+
if(!bytes.equals(confirm)||['size','mtimeMs','ctimeMs','ino','dev'].some(k=>before[k]!==after[k])||final.ino!==after.ino||final.dev!==after.dev)throw Error('source_changed');
|
|
25
|
+
if(bytes.includes(0))throw Error('source_denied');
|
|
26
|
+
try{new TextDecoder('utf-8',{fatal:true}).decode(bytes);}catch{throw Error('source_denied');}
|
|
27
|
+
check();return bytes;
|
|
28
|
+
}finally{closeSync(fd);}
|
|
29
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
// @ts-nocheck
|
|
2
|
+
// Pure Node-compatible consumer configuration; no I/O or provider construction.
|
|
3
|
+
export const AGENTIC_LIMITS = Object.freeze({ maxFiles: 20, maxQuestions: 16, maxStateBytes: 8192, maxQuestionsBytes: 16384, maxSourceBytes: 65536, maxRequestBytes: 131072, maxCallsPerSession: 100, timeoutMs: 2000, collectionMs: 1000, maxHandles: 20, maxRetainedBytes: 1048576 });
|
|
4
|
+
export function parseAgenticConfig(value) {
|
|
5
|
+
if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).some(k => !['mode','remoteContextApproved','include','allowToolOutputs','limits'].includes(k))) throw new Error('Invalid agentic section');
|
|
6
|
+
if (!['off','advisory','recommended'].includes(value.mode) || (value.remoteContextApproved !== undefined && typeof value.remoteContextApproved !== 'boolean') || (value.allowToolOutputs !== undefined && typeof value.allowToolOutputs !== 'boolean')) throw new Error('Invalid agentic mode or consent');
|
|
7
|
+
const include = value.include ?? [];
|
|
8
|
+
if (!Array.isArray(include) || include.length > AGENTIC_LIMITS.maxFiles || include.some(p => typeof p !== 'string' || !p || p.length > 1024 || /[\\\0*?]/.test(p) || p.startsWith('/') || p.replace(/\/$/,'').split('/').some(s => !s || s === '.' || s === '..'))) throw new Error('Invalid include scope');
|
|
9
|
+
const supplied = value.limits ?? {};
|
|
10
|
+
if (!supplied || typeof supplied !== 'object' || Array.isArray(supplied) || Object.keys(supplied).some(k => !Object.hasOwn(AGENTIC_LIMITS,k))) throw new Error('Invalid agentic limits');
|
|
11
|
+
const limits = { ...AGENTIC_LIMITS, ...supplied };
|
|
12
|
+
if (Object.entries(limits).some(([key,n]) => !Number.isSafeInteger(n) || n <= 0 || n > AGENTIC_LIMITS[key])) throw new Error('Invalid agentic limits');
|
|
13
|
+
return { mode:value.mode, remoteContextApproved:value.remoteContextApproved === true, include:[...include], allowToolOutputs:value.allowToolOutputs === true, limits };
|
|
14
|
+
}
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
// Pure, immutable document normalizer. No filesystem, environment, or inference.
|
|
3
3
|
import { parseProactiveConfig } from './config-proactive.js';
|
|
4
4
|
import { parseTriageConfig, parseTaskTriageConfig, TASK_TRIAGE_LIMITS } from './config-triage.js';
|
|
5
|
-
|
|
5
|
+
import { parseAgenticConfig } from './config-agentic.js';
|
|
6
|
+
export const CONSUMERS = Object.freeze(['watchdog', 'proactiveReview', 'dispatchTriage', 'taskTriage', 'agenticAsk']);
|
|
6
7
|
export function deepFreeze(value) {
|
|
7
8
|
if (value && typeof value === 'object' && !Object.isFrozen(value)) {
|
|
8
9
|
for (const item of Object.values(value)) deepFreeze(item);
|
|
@@ -16,6 +17,7 @@ const fields = {
|
|
|
16
17
|
proactiveReview: ['mode', 'remoteContext', 'include', 'maxEvaluationsPerSession', 'localBindings'],
|
|
17
18
|
dispatchTriage: ['mode', 'remoteContextApproved', 'maxCalls', 'maxStateBytes', 'maxTaskBytes', 'maxRoleBytes', 'profile', 'orchestratorBeforeDispatch'],
|
|
18
19
|
taskTriage: ['mode', 'remoteContextApproved', 'questionVersion', 'policyVersion', 'limits'],
|
|
20
|
+
agenticAsk: ['mode', 'remoteContextApproved', 'include', 'allowToolOutputs', 'limits'],
|
|
19
21
|
};
|
|
20
22
|
export function normalizeSystem1Config(value) {
|
|
21
23
|
const errors = [];
|
|
@@ -75,7 +77,8 @@ export function normalizeSystem1Config(value) {
|
|
|
75
77
|
if (name === 'watchdog') {
|
|
76
78
|
if (!['off', 'shadow', 'active'].includes(section.mode)) { error(`${path}.mode`); throw new Error(); }
|
|
77
79
|
config = section;
|
|
78
|
-
} else if (name === '
|
|
80
|
+
} else if (name === 'agenticAsk') config = parseAgenticConfig(section);
|
|
81
|
+
else if (name === 'proactiveReview') config = parseProactiveConfig({ version: 1, ...section });
|
|
79
82
|
else if (name === 'dispatchTriage') {
|
|
80
83
|
if (section.profile && Object.keys(section.profile).some(k => !['version','approved','evidence','provider','model','languages','domains','minConfidence','minMargin','securityThreshold','destructiveThreshold'].includes(k))) {
|
|
81
84
|
for (const key of Object.keys(section.profile)) if (!['version','approved','evidence','provider','model','languages','domains','minConfidence','minMargin','securityThreshold','destructiveThreshold'].includes(key)) error(`${path}.profile.${key}`, 'unknown_field');
|
|
@@ -88,7 +91,7 @@ export function normalizeSystem1Config(value) {
|
|
|
88
91
|
if (parsed.status === 'invalid') throw new Error();
|
|
89
92
|
config = { version: 1, provider: value.provider, model: value.model, ...section };
|
|
90
93
|
}
|
|
91
|
-
const status = config.mode === 'off' || (
|
|
94
|
+
const status = config.mode === 'off' || (['taskTriage', 'agenticAsk'].includes(name) && !config.remoteContextApproved) ? 'off' : 'ready';
|
|
92
95
|
consumers[name] = { status, config };
|
|
93
96
|
} catch (failure) {
|
|
94
97
|
const field = { 'Invalid include scope':'include', 'Explicit include scope required':'include', 'Invalid remoteContext':'remoteContext', 'Invalid session budget':'maxEvaluationsPerSession', 'Invalid local bindings':'localBindings', 'Invalid local binding schema':'localBindings', 'Invalid local binding values':'localBindings' }[failure.message];
|
|
@@ -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).
|