@chankov/agent-fleet 2.0.15 → 2.0.16
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 +5 -1
- package/.pi/harnesses/agent-hub/config/overrides.ts +1 -6
- package/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +4 -15
- package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +8 -7
- package/.pi/harnesses/agent-hub/index.ts +10 -6
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/proactive-config.ts +11 -35
- package/.pi/harnesses/agent-hub/proactive-local.ts +1 -18
- package/.pi/harnesses/agent-hub/system1-runtime.ts +7 -29
- package/.pi/harnesses/agent-hub/task-triage-config.ts +8 -16
- package/.pi/harnesses/agent-hub/task-triage-contract.ts +1 -6
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.pi/harnesses/lib/system1/config-proactive.js +57 -0
- package/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.pi/harnesses/lib/system1/config-v2.js +100 -0
- package/.pi/harnesses/lib/system1/config.js +7 -18
- package/.pi/harnesses/lib/system1/contracts.ts +4 -2
- package/.pi/harnesses/lib/system1/demo.ts +3 -12
- package/.versions/2.0.16/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.16/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.16/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.16/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.16/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.16/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.16/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.16/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.16/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.16/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.16/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.16/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.16/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.16/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.16/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.16/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.16/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.16/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.16/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.16/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.16/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.16/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.16/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.16/.pi/extensions/package.json +9 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.16/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/README.md +1452 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/config/overrides.ts +155 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/delegate.ts +467 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/fixtures/registration-surface.json +64 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/index.ts +2601 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/no-progress.ts +563 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/work-mode.ts +135 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-config.ts +16 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-local.ts +71 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/fragments.ts +116 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/spawn.ts +534 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-communication-store.ts +129 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/work-mode.ts +179 -0
- package/.versions/2.0.16/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.16/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.16/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.16/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.16/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.16/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.16/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.16/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.16/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.16/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.16/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.16/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.16/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.16/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.16/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.16/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.16/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.16/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.16/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
- package/.versions/2.0.16/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.16/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.16/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.16/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.16/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.16/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.16/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.16/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.16/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/config-proactive.js +57 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/config-v2.js +100 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.16/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.16/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.16/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.16/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.16/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.16/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.16/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.16/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.16/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.16/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.16/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.16/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.16/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.16/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.16/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.16/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.16/.version +1 -0
- package/.versions/2.0.16/agents/architect.md +24 -0
- package/.versions/2.0.16/agents/bowser.md +28 -0
- package/.versions/2.0.16/agents/builder.md +55 -0
- package/.versions/2.0.16/agents/code-reviewer.md +209 -0
- package/.versions/2.0.16/agents/deep-researcher.md +32 -0
- package/.versions/2.0.16/agents/documenter.md +22 -0
- package/.versions/2.0.16/agents/orchestrator.md +22 -0
- package/.versions/2.0.16/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.16/agents/planner.md +105 -0
- package/.versions/2.0.16/agents/releaser.md +24 -0
- package/.versions/2.0.16/agents/researcher.md +30 -0
- package/.versions/2.0.16/agents/security-auditor.md +167 -0
- package/.versions/2.0.16/agents/test-engineer.md +153 -0
- package/.versions/2.0.16/agents/web-debugger.md +44 -0
- package/.versions/2.0.16/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.16/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.16/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.16/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.16/docs/ARCHITECTURE.md +834 -0
- package/.versions/2.0.16/docs/agent-fleet-setup.md +1101 -0
- package/.versions/2.0.16/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.16/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.16/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.16/docs/getting-started.md +126 -0
- package/.versions/2.0.16/docs/npm-install.md +530 -0
- package/.versions/2.0.16/docs/pi-extensions.md +454 -0
- package/.versions/2.0.16/docs/pi-setup.md +92 -0
- package/.versions/2.0.16/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.16/install-manifest.json +3193 -0
- package/.versions/2.0.16/justfile +247 -0
- package/.versions/2.0.16/manifest-meta.json +1071 -0
- package/.versions/2.0.16/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.16/references/communication-contract.md +26 -0
- package/.versions/2.0.16/references/definition-of-done.md +67 -0
- package/.versions/2.0.16/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.16/references/observability-checklist.md +92 -0
- package/.versions/2.0.16/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.16/references/performance-checklist.md +236 -0
- package/.versions/2.0.16/references/prompting-patterns.md +380 -0
- package/.versions/2.0.16/references/security-checklist.md +245 -0
- package/.versions/2.0.16/references/testing-patterns.md +235 -0
- package/.versions/2.0.16/references/workflow-authoring.md +304 -0
- package/.versions/2.0.16/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.16/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.16/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.16/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.16/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.16/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.16/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.16/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.16/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.16/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.16/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.16/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.16/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.16/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.16/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.16/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.16/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.16/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.16/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.16/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.16/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.16/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.16/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.16/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.16/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.16/skills/repository-ai-setup/SKILL.md +117 -0
- package/.versions/2.0.16/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.16/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.16/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.16/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.16/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.16/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.16/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.16/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.16/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +12 -0
- package/bin/cli.js +17 -0
- package/bin/lib/doctor.js +41 -32
- package/bin/lib/system1-migration.js +107 -0
- package/bin/lib/task-triage-setup.js +31 -71
- package/bin/lib/transaction.js +61 -20
- package/bin/lib/workspace-safety.js +3 -2
- package/docs/ARCHITECTURE.md +9 -4
- package/docs/agent-fleet-setup.md +28 -17
- package/docs/npm-install.md +9 -4
- package/docs/system1-config.md +83 -0
- package/install-manifest.json +3 -3
- package/manifest-meta.json +2 -2
- package/package.json +6 -4
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-closure.user-run.mjs +0 -336
- package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs +0 -157
|
@@ -0,0 +1,399 @@
|
|
|
1
|
+
// .pi/harnesses/lib/herdr-presence.ts
|
|
2
|
+
//
|
|
3
|
+
// The herdr presence backend for the coms layer (used by both the standalone
|
|
4
|
+
// coms harness and the copy embedded in agent-hub). Two halves:
|
|
5
|
+
//
|
|
6
|
+
// - HerdrPresence — reports THIS agent's state into its pane
|
|
7
|
+
// (pane.report_agent) so the herdr sidebar shows live pi agent states.
|
|
8
|
+
// - HerdrAgentWatch — watches OTHER agents via agent.list +
|
|
9
|
+
// events.subscribe (push, no polling): global pane.created/closed/exited
|
|
10
|
+
// plus a per-pane agent_status_changed subscription for every tracked
|
|
11
|
+
// pane (herdr has no wildcard for that topic — spike finding). When the
|
|
12
|
+
// tracked pane set changes, the stream is torn down and resubscribed.
|
|
13
|
+
//
|
|
14
|
+
// Two wire dialects for the same idea — "this pane is coms peer X":
|
|
15
|
+
//
|
|
16
|
+
// tokens (herdr >= 0.7.4) `tokens: { coms, proj, ctx, q }` on
|
|
17
|
+
// pane.report_metadata. Values are uncapped, so the
|
|
18
|
+
// peer name arrives whole and the PROJECT travels
|
|
19
|
+
// with it — which is what makes the join a real key
|
|
20
|
+
// (two projects may each run an `orchestrator`).
|
|
21
|
+
// custom_status (<= 0.7.3) a single 32-char-capped string,
|
|
22
|
+
// `<name> <pct>% q<depth>`, name FIRST so a
|
|
23
|
+
// truncated tail still leaves the identity readable.
|
|
24
|
+
//
|
|
25
|
+
// herdr 0.7.4 dropped `custom_status` from PaneReportMetadataParams entirely,
|
|
26
|
+
// which made every report fail — silently, because report() swallows errors.
|
|
27
|
+
// So: tokens first, one latched fallback to the legacy string, and an onError
|
|
28
|
+
// hook so a dialect mismatch is never invisible again.
|
|
29
|
+
//
|
|
30
|
+
// Pure module: no pi imports; erasable-TS; testable under node --test.
|
|
31
|
+
|
|
32
|
+
import {
|
|
33
|
+
herdr,
|
|
34
|
+
herdrAvailable,
|
|
35
|
+
subscribe,
|
|
36
|
+
type HerdrClientOptions,
|
|
37
|
+
type SubscribeHandle,
|
|
38
|
+
type Subscription,
|
|
39
|
+
} from "./herdr-client.ts";
|
|
40
|
+
|
|
41
|
+
export const CUSTOM_STATUS_MAX = 32;
|
|
42
|
+
|
|
43
|
+
// HERDR_ENV=1 + HERDR_PANE_ID mark a process running inside a herdr pane.
|
|
44
|
+
export function herdrPaneId(env: NodeJS.ProcessEnv = process.env): string | null {
|
|
45
|
+
if (env.HERDR_ENV !== "1") return null;
|
|
46
|
+
return env.HERDR_PANE_ID || null;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
// True when this process should use the herdr presence backend: inside a
|
|
50
|
+
// herdr pane AND the server answers ping.
|
|
51
|
+
export async function herdrPresenceAvailable(
|
|
52
|
+
opts: HerdrClientOptions = {},
|
|
53
|
+
env: NodeJS.ProcessEnv = process.env,
|
|
54
|
+
): Promise<boolean> {
|
|
55
|
+
if (!herdrPaneId(env)) return false;
|
|
56
|
+
return (await herdrAvailable(opts)) !== null;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
// What a pane advertises about the coms peer occupying it.
|
|
60
|
+
export interface PeerPresence {
|
|
61
|
+
name: string;
|
|
62
|
+
// The coms project. Optional only because the legacy dialect cannot carry
|
|
63
|
+
// it; always pass it when you have it — without it, two projects running a
|
|
64
|
+
// peer of the same name are indistinguishable to any watcher.
|
|
65
|
+
project?: string | null;
|
|
66
|
+
contextUsedPct: number;
|
|
67
|
+
queueDepth: number;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// Token keys must match herdr's `^[A-Za-z0-9_-]{1,32}$`; at most 16 per pane.
|
|
71
|
+
// `ctx`/`q` are for human eyes in the sidebar — the registry entry carries the
|
|
72
|
+
// authoritative numbers — so they are formatted, not raw.
|
|
73
|
+
export function peerTokens(presence: PeerPresence): Record<string, string> {
|
|
74
|
+
const tokens: Record<string, string> = {
|
|
75
|
+
coms: presence.name,
|
|
76
|
+
ctx: `${Math.round(presence.contextUsedPct)}%`,
|
|
77
|
+
q: `q${presence.queueDepth}`,
|
|
78
|
+
};
|
|
79
|
+
if (presence.project) tokens.proj = presence.project;
|
|
80
|
+
return tokens;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
// Legacy dialect: `<name> <pct>% q<depth>` truncated to the 32-char server cap,
|
|
84
|
+
// name first. The project does not fit and is therefore not carried.
|
|
85
|
+
export function formatPeerStatus(name: string, contextUsedPct: number, queueDepth: number): string {
|
|
86
|
+
const s = `${name} ${Math.round(contextUsedPct)}% q${queueDepth}`;
|
|
87
|
+
return s.length <= CUSTOM_STATUS_MAX ? s : s.slice(0, CUSTOM_STATUS_MAX);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// Inverse of formatPeerStatus: the peer name is everything before the last
|
|
91
|
+
// ` <pct>% q<n>` tail (tolerates a name that was itself truncated).
|
|
92
|
+
export function parsePeerName(customStatus: string | undefined | null): string | null {
|
|
93
|
+
if (!customStatus) return null;
|
|
94
|
+
const m = customStatus.match(/^(.*?)\s+\d+%\s+q\d*$/);
|
|
95
|
+
const name = (m ? m[1] : customStatus).trim();
|
|
96
|
+
return name || null;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
// The one place that knows how to read a peer identity off a herdr pane,
|
|
100
|
+
// whichever dialect wrote it. `agent.rename` also puts a name on a pane, but
|
|
101
|
+
// that one is human-assigned and not necessarily a coms peer, so it is the last
|
|
102
|
+
// resort rather than the first.
|
|
103
|
+
export function peerNameFrom(agent: HerdrAgentInfo | undefined | null): string | null {
|
|
104
|
+
if (!agent) return null;
|
|
105
|
+
const token = agent.tokens?.coms;
|
|
106
|
+
if (typeof token === "string" && token.trim()) return token.trim();
|
|
107
|
+
const legacy = parsePeerName(agent.custom_status);
|
|
108
|
+
if (legacy) return legacy;
|
|
109
|
+
const named = agent.name;
|
|
110
|
+
return typeof named === "string" && named.trim() ? named.trim() : null;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// The coms project a pane advertises, or null when the writer could not carry
|
|
114
|
+
// one (legacy dialect). Null means "unscoped", never "the default project".
|
|
115
|
+
export function peerProjectFrom(agent: HerdrAgentInfo | undefined | null): string | null {
|
|
116
|
+
const token = agent?.tokens?.proj;
|
|
117
|
+
return typeof token === "string" && token.trim() ? token.trim() : null;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
export type PresenceState = "idle" | "working" | "blocked" | "unknown";
|
|
121
|
+
|
|
122
|
+
export interface HerdrPresenceOptions extends HerdrClientOptions {
|
|
123
|
+
paneId: string;
|
|
124
|
+
// Identity herdr uses to arbitrate reporting authority (required by the
|
|
125
|
+
// API). Convention: `coms:<session_id>`.
|
|
126
|
+
source: string;
|
|
127
|
+
// Detected-agent label shown in the sidebar; pi peers report "pi".
|
|
128
|
+
agentLabel?: string;
|
|
129
|
+
// Called the first time an annotation dialect is rejected, and again if the
|
|
130
|
+
// fallback is rejected too. Presence stays best-effort, but a herdr that no
|
|
131
|
+
// longer speaks our wire format must not be able to hide.
|
|
132
|
+
onError?: (err: Error, dialect: AnnotationDialect) => void;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
export type AnnotationDialect = "tokens" | "custom_status";
|
|
136
|
+
|
|
137
|
+
// Reports this agent's state into its herdr pane. All calls are best-effort:
|
|
138
|
+
// presence must never break the session, so errors resolve false.
|
|
139
|
+
//
|
|
140
|
+
// Two wire calls per report (both idempotent): pane.report_agent carries the
|
|
141
|
+
// state and covers panes herdr's built-in detection does NOT recognize; for
|
|
142
|
+
// recognized panes (pi has a detection manifest) that call is accepted but
|
|
143
|
+
// IGNORED — detection holds agent authority — so pane.report_metadata carries
|
|
144
|
+
// the peer annotation that detection cannot provide.
|
|
145
|
+
//
|
|
146
|
+
// The annotation dialect is negotiated by trying and latching, not by version
|
|
147
|
+
// sniffing: `herdr --version` is a string we would have to keep a table for,
|
|
148
|
+
// while a rejected request is the actual answer to the actual question.
|
|
149
|
+
export class HerdrPresence {
|
|
150
|
+
private opts: HerdrPresenceOptions;
|
|
151
|
+
private dialect: AnnotationDialect | null = null;
|
|
152
|
+
private reported = new Set<AnnotationDialect>();
|
|
153
|
+
|
|
154
|
+
constructor(opts: HerdrPresenceOptions) {
|
|
155
|
+
this.opts = opts;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
// Which dialect this pane's herdr accepted, once known. Exposed for
|
|
159
|
+
// diagnostics (the coms audit log records it) — never a branch condition
|
|
160
|
+
// anywhere but here.
|
|
161
|
+
acceptedDialect(): AnnotationDialect | null {
|
|
162
|
+
return this.dialect;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
private noteError(err: Error, dialect: AnnotationDialect): void {
|
|
166
|
+
if (this.reported.has(dialect)) return;
|
|
167
|
+
this.reported.add(dialect);
|
|
168
|
+
try {
|
|
169
|
+
this.opts.onError?.(err, dialect);
|
|
170
|
+
} catch {
|
|
171
|
+
// a broken reporter must not break presence
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
private async writeAnnotation(presence: PeerPresence, agent: string, dialect: AnnotationDialect): Promise<boolean> {
|
|
176
|
+
const base = {
|
|
177
|
+
pane_id: this.opts.paneId,
|
|
178
|
+
source: this.opts.source,
|
|
179
|
+
agent,
|
|
180
|
+
// Expire if this reporter dies without releasing: a bit over two
|
|
181
|
+
// keepalive cycles keeps the annotation fresh-or-gone.
|
|
182
|
+
ttl_ms: 90_000,
|
|
183
|
+
};
|
|
184
|
+
const params =
|
|
185
|
+
dialect === "tokens"
|
|
186
|
+
? { ...base, tokens: peerTokens(presence) }
|
|
187
|
+
: {
|
|
188
|
+
...base,
|
|
189
|
+
custom_status: formatPeerStatus(presence.name, presence.contextUsedPct, presence.queueDepth),
|
|
190
|
+
};
|
|
191
|
+
try {
|
|
192
|
+
await herdr.paneReportMetadata(params, this.opts);
|
|
193
|
+
this.dialect = dialect;
|
|
194
|
+
return true;
|
|
195
|
+
} catch (err) {
|
|
196
|
+
this.noteError(err as Error, dialect);
|
|
197
|
+
return false;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
// The identity half of presence on its own: "this pane is coms peer X",
|
|
202
|
+
// with no claim about what the agent is doing. Callers whose pane state is
|
|
203
|
+
// owned by someone else use this instead of report() — the Claude bridge
|
|
204
|
+
// reads `agent_status` back as its own turn-completion signal, so a state
|
|
205
|
+
// it reported itself would poison the loop that polls it.
|
|
206
|
+
async annotate(presence: PeerPresence): Promise<boolean> {
|
|
207
|
+
const agent = this.opts.agentLabel ?? "pi";
|
|
208
|
+
// Once a dialect has worked, stop probing: a retry per report would put
|
|
209
|
+
// a guaranteed-failing request on the wire every 30s forever.
|
|
210
|
+
const order: AnnotationDialect[] = this.dialect ? [this.dialect] : ["tokens", "custom_status"];
|
|
211
|
+
for (const dialect of order) {
|
|
212
|
+
if (await this.writeAnnotation(presence, agent, dialect)) return true;
|
|
213
|
+
}
|
|
214
|
+
return false;
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
async report(state: PresenceState, presence: PeerPresence): Promise<boolean> {
|
|
218
|
+
let ok = false;
|
|
219
|
+
try {
|
|
220
|
+
await herdr.paneReportAgent(
|
|
221
|
+
{ pane_id: this.opts.paneId, source: this.opts.source, agent: this.opts.agentLabel ?? "pi", state },
|
|
222
|
+
this.opts,
|
|
223
|
+
);
|
|
224
|
+
ok = true;
|
|
225
|
+
} catch {
|
|
226
|
+
// fall through — the annotation may still land
|
|
227
|
+
}
|
|
228
|
+
return (await this.annotate(presence)) || ok;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
async release(): Promise<void> {
|
|
232
|
+
try {
|
|
233
|
+
await herdr.paneReleaseAgent(
|
|
234
|
+
{ pane_id: this.opts.paneId, source: this.opts.source, agent: this.opts.agentLabel ?? "pi" },
|
|
235
|
+
this.opts,
|
|
236
|
+
);
|
|
237
|
+
} catch {
|
|
238
|
+
// best-effort
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
export interface HerdrAgentInfo {
|
|
244
|
+
pane_id: string;
|
|
245
|
+
agent?: string;
|
|
246
|
+
agent_status?: string;
|
|
247
|
+
// herdr >= 0.7.4
|
|
248
|
+
tokens?: Record<string, string>;
|
|
249
|
+
name?: string;
|
|
250
|
+
// herdr <= 0.7.3
|
|
251
|
+
custom_status?: string;
|
|
252
|
+
workspace_id?: string;
|
|
253
|
+
[key: string]: unknown;
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
export interface AgentWatchOptions extends HerdrClientOptions {
|
|
257
|
+
// Called with the full current agent set after every change (initial
|
|
258
|
+
// snapshot included). Consumers diff/join against their own state.
|
|
259
|
+
onChange: (agents: HerdrAgentInfo[]) => void;
|
|
260
|
+
// This process's own pane — excluded from the tracked set.
|
|
261
|
+
ownPaneId?: string | null;
|
|
262
|
+
onError?: (err: Error) => void;
|
|
263
|
+
reconnectDelayMs?: number;
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
// Push-driven view of the herdr agent population. start() takes an
|
|
267
|
+
// agent.list snapshot and opens the event stream; pane lifecycle events
|
|
268
|
+
// refresh the snapshot (and the per-pane subscription set).
|
|
269
|
+
export class HerdrAgentWatch {
|
|
270
|
+
private opts: AgentWatchOptions;
|
|
271
|
+
private agents = new Map<string, HerdrAgentInfo>();
|
|
272
|
+
private stream: SubscribeHandle | null = null;
|
|
273
|
+
private stopped = false;
|
|
274
|
+
private resyncTimer: ReturnType<typeof setTimeout> | null = null;
|
|
275
|
+
// Pane-id set the live stream was opened with. resync() only tears the
|
|
276
|
+
// stream down when the set actually changed — an unconditional resubscribe
|
|
277
|
+
// would loop forever through onConnect → resync → resubscribe → onConnect,
|
|
278
|
+
// hammering the server with stream churn (seen live: herdr pegged a core).
|
|
279
|
+
private subscribedKey: string | null = null;
|
|
280
|
+
|
|
281
|
+
constructor(opts: AgentWatchOptions) {
|
|
282
|
+
this.opts = opts;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
current(): HerdrAgentInfo[] {
|
|
286
|
+
return [...this.agents.values()];
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
async start(): Promise<void> {
|
|
290
|
+
await this.resync();
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
stop(): void {
|
|
294
|
+
this.stopped = true;
|
|
295
|
+
this.stream?.close();
|
|
296
|
+
this.stream = null;
|
|
297
|
+
this.subscribedKey = null;
|
|
298
|
+
if (this.resyncTimer) clearTimeout(this.resyncTimer);
|
|
299
|
+
this.resyncTimer = null;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
// Re-list agents, rebuild the subscription set if it changed, notify.
|
|
303
|
+
private async resync(): Promise<void> {
|
|
304
|
+
if (this.stopped) return;
|
|
305
|
+
try {
|
|
306
|
+
const { agents } = await herdr.agentList(this.opts);
|
|
307
|
+
this.agents.clear();
|
|
308
|
+
for (const a of agents as HerdrAgentInfo[]) {
|
|
309
|
+
const paneId = a.pane_id as string | undefined;
|
|
310
|
+
if (!paneId || paneId === this.opts.ownPaneId) continue;
|
|
311
|
+
this.agents.set(paneId, a);
|
|
312
|
+
}
|
|
313
|
+
} catch (err) {
|
|
314
|
+
this.opts.onError?.(err as Error);
|
|
315
|
+
}
|
|
316
|
+
const key = [...this.agents.keys()].sort().join("\n");
|
|
317
|
+
if (this.stream === null || key !== this.subscribedKey) this.resubscribe(key);
|
|
318
|
+
this.opts.onChange(this.current());
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
// Debounced resync: lifecycle events often arrive in bursts (layout.apply
|
|
322
|
+
// creates N panes); one refresh after the burst is enough.
|
|
323
|
+
private scheduleResync(): void {
|
|
324
|
+
if (this.stopped || this.resyncTimer) return;
|
|
325
|
+
this.resyncTimer = setTimeout(() => {
|
|
326
|
+
this.resyncTimer = null;
|
|
327
|
+
void this.resync();
|
|
328
|
+
}, 250);
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
private resubscribe(key: string): void {
|
|
332
|
+
this.stream?.close();
|
|
333
|
+
this.subscribedKey = null;
|
|
334
|
+
if (this.stopped) return;
|
|
335
|
+
const subs: Subscription[] = [
|
|
336
|
+
{ type: "pane.created" },
|
|
337
|
+
{ type: "pane.closed" },
|
|
338
|
+
{ type: "pane.exited" },
|
|
339
|
+
{ type: "workspace.closed" },
|
|
340
|
+
];
|
|
341
|
+
for (const paneId of this.agents.keys()) {
|
|
342
|
+
subs.push({ type: "pane.agent_status_changed", pane_id: paneId });
|
|
343
|
+
}
|
|
344
|
+
// The ack of THIS deliberately opened stream must not resync: the
|
|
345
|
+
// snapshot is milliseconds old, and resyncing here restarts the
|
|
346
|
+
// subscribe/close loop. Only a genuine drop + reconnect (events
|
|
347
|
+
// possibly missed while disconnected) warrants a fresh snapshot.
|
|
348
|
+
let initialAck = true;
|
|
349
|
+
this.stream = subscribe(subs, (ev) => this.handleEvent(ev.event, ev.data), {
|
|
350
|
+
socketPath: this.opts.socketPath,
|
|
351
|
+
reconnectDelayMs: this.opts.reconnectDelayMs,
|
|
352
|
+
onError: this.opts.onError,
|
|
353
|
+
onConnect: () => {
|
|
354
|
+
if (initialAck) {
|
|
355
|
+
initialAck = false;
|
|
356
|
+
return;
|
|
357
|
+
}
|
|
358
|
+
this.scheduleResync();
|
|
359
|
+
},
|
|
360
|
+
});
|
|
361
|
+
this.subscribedKey = key;
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
private handleEvent(event: string, data: Record<string, unknown>): void {
|
|
365
|
+
const paneId = data.pane_id as string | undefined;
|
|
366
|
+
switch (event) {
|
|
367
|
+
case "pane.agent_status_changed": {
|
|
368
|
+
if (!paneId) return;
|
|
369
|
+
const existing = this.agents.get(paneId);
|
|
370
|
+
if (existing) {
|
|
371
|
+
existing.agent_status = data.agent_status as string;
|
|
372
|
+
if (typeof data.agent === "string") existing.agent = data.agent;
|
|
373
|
+
if (typeof data.custom_status === "string") existing.custom_status = data.custom_status;
|
|
374
|
+
this.opts.onChange(this.current());
|
|
375
|
+
} else {
|
|
376
|
+
// Status for a pane we don't track yet (e.g. agent detected
|
|
377
|
+
// after creation) — refresh the snapshot.
|
|
378
|
+
this.scheduleResync();
|
|
379
|
+
}
|
|
380
|
+
return;
|
|
381
|
+
}
|
|
382
|
+
case "pane.closed":
|
|
383
|
+
case "pane.exited": {
|
|
384
|
+
if (paneId && this.agents.delete(paneId)) {
|
|
385
|
+
this.opts.onChange(this.current());
|
|
386
|
+
}
|
|
387
|
+
// The pane set changed either way — resubscribe without the
|
|
388
|
+
// dead pane (and catch anything created meanwhile).
|
|
389
|
+
this.scheduleResync();
|
|
390
|
+
return;
|
|
391
|
+
}
|
|
392
|
+
case "pane.created":
|
|
393
|
+
case "workspace.closed": {
|
|
394
|
+
this.scheduleResync();
|
|
395
|
+
return;
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
}
|
|
399
|
+
}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
import * as crypto from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
|
|
5
|
+
import { validateMonitorEvent } from "./hermes-monitor-model.ts";
|
|
6
|
+
|
|
7
|
+
export const EVENT_RETENTION_MS = 24 * 60 * 60 * 1000;
|
|
8
|
+
export const EVENT_RETENTION_MAX = 4096;
|
|
9
|
+
|
|
10
|
+
function mode(file: string): number { return fs.statSync(file).mode & 0o777; }
|
|
11
|
+
|
|
12
|
+
function safeFile(file: string): void {
|
|
13
|
+
if (!path.isAbsolute(file)) throw new Error("event journal path must be absolute");
|
|
14
|
+
const directory = path.dirname(file);
|
|
15
|
+
if (fs.existsSync(directory) && (fs.lstatSync(directory).isSymbolicLink() || mode(directory) !== 0o700)) throw new Error("event journal directory is unsafe");
|
|
16
|
+
fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
17
|
+
fs.chmodSync(directory, 0o700);
|
|
18
|
+
if (!fs.existsSync(file)) return;
|
|
19
|
+
const stat = fs.lstatSync(file);
|
|
20
|
+
if (stat.isSymbolicLink() || !stat.isFile() || mode(file) !== 0o600) throw new Error("event journal is unsafe");
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** Persist only the monitor-event contract; arbitrary extra fields are never journaled. */
|
|
24
|
+
function safeEvent(value: unknown): any {
|
|
25
|
+
const valid = validateMonitorEvent(value);
|
|
26
|
+
if (!valid) return null;
|
|
27
|
+
const event: any = {
|
|
28
|
+
schema: valid.schema, schemaVersion: valid.schemaVersion, eventId: valid.eventId,
|
|
29
|
+
eventSequence: valid.eventSequence, profileKey: valid.profileKey, hubInstanceId: valid.hubInstanceId,
|
|
30
|
+
ownerId: valid.ownerId, occurredAt: valid.occurredAt, kind: valid.kind, materialKey: valid.materialKey,
|
|
31
|
+
};
|
|
32
|
+
if (valid.task) {
|
|
33
|
+
event.task = { id: valid.task.id, generation: valid.task.generation };
|
|
34
|
+
for (const key of ["parentId", "specialist", "fromState", "toState", "outputSequence"])
|
|
35
|
+
if (valid.task[key] !== undefined) event.task[key] = valid.task[key];
|
|
36
|
+
}
|
|
37
|
+
return event;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export class MonitorEventJournal {
|
|
41
|
+
private readonly file: string;
|
|
42
|
+
private readonly now: () => Date;
|
|
43
|
+
private events: any[] = [];
|
|
44
|
+
private sequence = 0;
|
|
45
|
+
private waiters = new Set<{ afterSequence: number; limit: number; resolve: (value: any) => void; timer: NodeJS.Timeout }>();
|
|
46
|
+
|
|
47
|
+
constructor(options: { file: string; now?: () => Date }) {
|
|
48
|
+
this.file = options.file;
|
|
49
|
+
this.now = options.now ?? (() => new Date());
|
|
50
|
+
safeFile(this.file);
|
|
51
|
+
this.load();
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
private load(): void {
|
|
55
|
+
if (!fs.existsSync(this.file)) return;
|
|
56
|
+
const body = fs.readFileSync(this.file, "utf8");
|
|
57
|
+
if (!body) return;
|
|
58
|
+
const lines = body.split("\n");
|
|
59
|
+
if (lines.at(-1) === "") lines.pop();
|
|
60
|
+
for (const line of lines) {
|
|
61
|
+
let event: any;
|
|
62
|
+
try { event = safeEvent(JSON.parse(line)); } catch { throw new Error("event journal is torn or corrupt"); }
|
|
63
|
+
if (!event) throw new Error("event journal is unsafe");
|
|
64
|
+
if (!this.events.length) this.sequence = event.eventSequence - 1;
|
|
65
|
+
if (event.eventSequence !== this.sequence + 1) throw new Error("event journal is unsafe");
|
|
66
|
+
this.events.push(event);
|
|
67
|
+
this.sequence = event.eventSequence;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
append(value: unknown): any {
|
|
72
|
+
const event = safeEvent(value);
|
|
73
|
+
if (!event || event.eventSequence !== this.sequence + 1) throw new Error("invalid event sequence");
|
|
74
|
+
const fd = fs.openSync(this.file, "a", 0o600);
|
|
75
|
+
try {
|
|
76
|
+
fs.writeSync(fd, `${JSON.stringify(event)}\n`);
|
|
77
|
+
fs.fsyncSync(fd);
|
|
78
|
+
} finally {
|
|
79
|
+
fs.closeSync(fd);
|
|
80
|
+
}
|
|
81
|
+
fs.chmodSync(this.file, 0o600);
|
|
82
|
+
this.events.push(event);
|
|
83
|
+
this.sequence = event.eventSequence;
|
|
84
|
+
this.resolveWaiters();
|
|
85
|
+
this.prune();
|
|
86
|
+
return event;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
private prune(): void {
|
|
90
|
+
const cutoff = this.now().getTime() - EVENT_RETENTION_MS;
|
|
91
|
+
const retained = this.events.filter(event => Date.parse(event.occurredAt) >= cutoff).slice(-EVENT_RETENTION_MAX);
|
|
92
|
+
if (retained.length === this.events.length) return;
|
|
93
|
+
const temporary = `${this.file}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;
|
|
94
|
+
const fd = fs.openSync(temporary, "wx", 0o600);
|
|
95
|
+
try {
|
|
96
|
+
fs.writeSync(fd, retained.map(event => JSON.stringify(event)).join("\n") + (retained.length ? "\n" : ""));
|
|
97
|
+
fs.fsyncSync(fd);
|
|
98
|
+
} finally { fs.closeSync(fd); }
|
|
99
|
+
fs.renameSync(temporary, this.file);
|
|
100
|
+
const directoryFd = fs.openSync(path.dirname(this.file), "r");
|
|
101
|
+
try { fs.fsyncSync(directoryFd); } finally { fs.closeSync(directoryFd); }
|
|
102
|
+
this.events = retained;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
private result(afterSequence: number, limit: number, timedOut = false): any {
|
|
106
|
+
const firstAvailableSequence = this.events[0]?.eventSequence ?? this.sequence + 1;
|
|
107
|
+
if (afterSequence < firstAvailableSequence - 1) return { error: "cursor_too_old", snapshotRequired: true, firstAvailableSequence, latestSequence: this.sequence };
|
|
108
|
+
return { firstAvailableSequence, latestSequence: this.sequence, items: this.events.filter(event => event.eventSequence > afterSequence).slice(0, limit), timedOut };
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
replay(afterSequence: number, limit: number, waitMs = 0, signal?: AbortSignal): any | Promise<any> {
|
|
112
|
+
if (!Number.isInteger(afterSequence) || !Number.isInteger(limit) || limit < 1 || limit > 100 || !Number.isInteger(waitMs) || waitMs < 0 || waitMs > 25_000) throw new Error("invalid cursor");
|
|
113
|
+
const immediate = this.result(afterSequence, limit);
|
|
114
|
+
if (immediate.error || immediate.items.length || waitMs === 0) return immediate;
|
|
115
|
+
return new Promise(resolve => {
|
|
116
|
+
const waiter: any = { afterSequence, limit, resolve, timer: setTimeout(() => this.removeWaiter(waiter, true), waitMs) };
|
|
117
|
+
this.waiters.add(waiter);
|
|
118
|
+
if (signal?.aborted) { this.removeWaiter(waiter, false); return; }
|
|
119
|
+
signal?.addEventListener("abort", () => this.removeWaiter(waiter, false), { once: true });
|
|
120
|
+
});
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
cancelWaiter(waiter: unknown): void { this.removeWaiter(waiter as any, false); }
|
|
124
|
+
private removeWaiter(waiter: any, timedOut: boolean): void {
|
|
125
|
+
if (!this.waiters.delete(waiter)) return;
|
|
126
|
+
clearTimeout(waiter.timer);
|
|
127
|
+
waiter.resolve(this.result(waiter.afterSequence, waiter.limit, timedOut));
|
|
128
|
+
}
|
|
129
|
+
private resolveWaiters(): void {
|
|
130
|
+
for (const waiter of [...this.waiters]) {
|
|
131
|
+
const result = this.result(waiter.afterSequence, waiter.limit);
|
|
132
|
+
if (result.error || result.items.length) this.removeWaiter(waiter, false);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
latestSequence(): number { return this.sequence; }
|
|
136
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { herdr, subscribe, type HerdrClientOptions, type SubscribeHandle } from "./herdr-client.ts";
|
|
2
|
+
|
|
3
|
+
export interface HubCorrelation { workspaceId?: string; hubPaneId?: string; status: "correlated" | "uncorrelated" | "reconnecting"; }
|
|
4
|
+
|
|
5
|
+
export async function correlateHubPane(env: NodeJS.ProcessEnv = process.env, opts: HerdrClientOptions = {}): Promise<HubCorrelation> {
|
|
6
|
+
const hubPaneId = env.HERDR_PANE_ID;
|
|
7
|
+
if (env.HERDR_ENV !== "1" || !hubPaneId) return { status: "uncorrelated" };
|
|
8
|
+
try { const { pane } = await herdr.paneGet(hubPaneId, { socketPath: env.HERDR_SOCKET_PATH, ...opts }); return { workspaceId: pane.workspace_id, hubPaneId, status: "correlated" }; }
|
|
9
|
+
catch { return { hubPaneId, status: "reconnecting" }; }
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export function watchHubMonitor(options: { env?: NodeJS.ProcessEnv; onStatus: (value: HubCorrelation) => void; onOutput?: (output: { sequence: number; text: string }) => void; initialCursor?: number; reconnectDelayMs?: number }): SubscribeHandle | null {
|
|
13
|
+
const env = options.env ?? process.env;
|
|
14
|
+
const paneId = env.HERDR_PANE_ID;
|
|
15
|
+
if (env.HERDR_ENV !== "1" || !paneId) { options.onStatus({ status: "uncorrelated" }); return null; }
|
|
16
|
+
let cursor = options.initialCursor ?? 0;
|
|
17
|
+
const refresh = async () => {
|
|
18
|
+
try {
|
|
19
|
+
const { pane } = await herdr.paneGet(paneId, { socketPath: env.HERDR_SOCKET_PATH });
|
|
20
|
+
options.onStatus({ workspaceId: pane.workspace_id, hubPaneId: paneId, status: "correlated" });
|
|
21
|
+
const output = (pane as { monitor_resync_output?: { sequence?: number; text?: string } }).monitor_resync_output;
|
|
22
|
+
if (output && typeof output.sequence === "number" && output.sequence > cursor && typeof output.text === "string") { cursor = output.sequence; options.onOutput?.({ sequence: output.sequence, text: output.text }); }
|
|
23
|
+
} catch { options.onStatus({ hubPaneId: paneId, status: "reconnecting" }); }
|
|
24
|
+
};
|
|
25
|
+
void refresh();
|
|
26
|
+
let connected = false;
|
|
27
|
+
return subscribe([{ type: "pane.agent_status_changed", pane_id: paneId }], () => void refresh(), { socketPath: env.HERDR_SOCKET_PATH, reconnectDelayMs: options.reconnectDelayMs, onConnect: () => { if (connected) options.onStatus({ hubPaneId: paneId, status: "reconnecting" }); connected = true; void refresh(); }, onError: () => options.onStatus({ hubPaneId: paneId, status: "reconnecting" }) });
|
|
28
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export type MonitorTaskState = "starting" | "running" | "cancelling" | "completed" | "blocked" | "failed" | "cancelled" | "orphaned" | "recovering";
|
|
2
|
+
export const TERMINAL_TASK_STATES = new Set<MonitorTaskState>(["completed","blocked","failed","cancelled","orphaned"]);export type MonitorTaskKind="parent"|"child";
|
|
3
|
+
export interface MonitorTask{id:string;generation:number;kind:MonitorTaskKind;state:MonitorTaskState;parentId?:string;parentGeneration?:number;hubInstanceId?:string;checkoutId?:string;specialist?:string;workspaceId?:string;hubPaneId?:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
|
|
4
|
+
export interface CreateParentTaskInput{id:string;generation:number;hubInstanceId:string;checkoutId:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
|
|
5
|
+
export interface CreateChildTaskInput{id:string;generation:number;parentId:string;parentGeneration:number;specialist:string;workspaceId?:string;hubPaneId?:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
|
|
6
|
+
function requireStableIdentity(id:string,generation:number){if(!id)throw Error("task id is required");if(!Number.isInteger(generation)||generation<1)throw Error("task generation must be a positive integer");}const owner=(i:any)=>({...((i.ownerSessionId)?{ownerSessionId:i.ownerSessionId}:{}),...((i.ownerLeaseExpiresAt)?{ownerLeaseExpiresAt:i.ownerLeaseExpiresAt}:{})});
|
|
7
|
+
export function createParentTask(input:CreateParentTaskInput):MonitorTask{requireStableIdentity(input.id,input.generation);if(!input.hubInstanceId||!input.checkoutId)throw Error("parent correlation is required");return{id:input.id,generation:input.generation,kind:"parent",state:"starting",hubInstanceId:input.hubInstanceId,checkoutId:input.checkoutId,...owner(input)};}
|
|
8
|
+
export function createChildTask(input:CreateChildTaskInput):MonitorTask{requireStableIdentity(input.id,input.generation);if(!input.parentId||!Number.isInteger(input.parentGeneration)||input.parentGeneration<1||!input.specialist)throw Error("child hierarchy is required");return{id:input.id,generation:input.generation,kind:"child",state:"starting",parentId:input.parentId,parentGeneration:input.parentGeneration,specialist:input.specialist,...(input.workspaceId?{workspaceId:input.workspaceId}:{}),...(input.hubPaneId?{hubPaneId:input.hubPaneId}:{}),...owner(input)};}
|
|
9
|
+
export function transitionTask(task:MonitorTask,state:MonitorTaskState):MonitorTask{if(TERMINAL_TASK_STATES.has(task.state))throw Error(`terminal task ${task.id} cannot mutate`);if(state==="starting")throw Error("tasks cannot transition back to starting");return{...task,state};}export function continueTask(task:MonitorTask):MonitorTask{if(task.state!=="blocked")throw Error(`only blocked task ${task.id} can continue`);return{...task,generation:task.generation+1,state:"starting"};}
|
|
10
|
+
|
|
11
|
+
export const MONITOR_EVENT_SCHEMA="agent-fleet.monitor-event" as const;
|
|
12
|
+
export const MONITOR_EVENT_KINDS=new Set(["hub.turn_started","hub.turn_completed","hub.queue_depth_changed","hub.capability_changed","task.started","task.state_changed","task.output_advanced","task.late_event","task.generation_superseded","owner.lease_changed","owner.recovering","owner.orphaned","action.requested","action.accepted","action.rejected","action.completed"]);
|
|
13
|
+
export const MONITOR_INVOKE_ACTIONS=new Set(["request_status","request_verification","narrow_scope","request_research","request_specialist"]);
|
|
14
|
+
const id=(v:unknown,max=128)=>typeof v==="string"&&v.length>0&&v.length<=max&&/^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(v);
|
|
15
|
+
const positive=(v:unknown)=>Number.isInteger(v)&&(v as number)>0&&(v as number)<=1_000_000_000;
|
|
16
|
+
export function normalizeIngressTaskState(value:unknown):MonitorTaskState|null{return value==="done"?"completed":typeof value==="string"&&(["starting","running","cancelling","completed","blocked","failed","cancelled","orphaned","recovering"] as string[]).includes(value)?value as MonitorTaskState:null;}
|
|
17
|
+
export function validateMonitorEvent(value:unknown):any|null{const v=value as any;if(!v||v.schema!==MONITOR_EVENT_SCHEMA||v.schemaVersion!==1||!id(v.eventId)||!positive(v.eventSequence)||!id(v.profileKey,80)||!id(v.hubInstanceId)||!id(v.ownerId)||typeof v.occurredAt!=="string"||Number.isNaN(Date.parse(v.occurredAt))||!MONITOR_EVENT_KINDS.has(v.kind)||!id(v.materialKey,256))return null;if(v.task!==undefined){if(!v.task||!id(v.task.id)||!positive(v.task.generation)||(v.task.outputSequence!==undefined&&(!Number.isInteger(v.task.outputSequence)||v.task.outputSequence<0))||(v.task.toState!==undefined&&normalizeIngressTaskState(v.task.toState)!==v.task.toState))return null;}return structuredClone(v);}
|
|
18
|
+
export function validateMonitorInvoke(value:unknown):any|null{const v=value as any;if(!v||!id(v.requestId)||!id(v.taskId)||!positive(v.generation)||!MONITOR_INVOKE_ACTIONS.has(v.action)||!v.parameters||typeof v.parameters!=="object"||!v.basis||v.basis.judgment!=="confirmed"||typeof v.basis.deviation!=="string"||v.basis.deviation.length>64)return null;const p=v.parameters;if(Object.keys(p).some(k=>!["assertionIds","evidenceEventIds","instruction"].includes(k))||!Array.isArray(p.assertionIds)||p.assertionIds.length>20||!Array.isArray(p.evidenceEventIds)||p.evidenceEventIds.length>20||p.assertionIds.some((x:unknown)=>!id(x,64))||p.evidenceEventIds.some((x:unknown)=>!id(x,128))||(p.instruction!==undefined&&(typeof p.instruction!=="string"||p.instruction.length>1024)))return null;return structuredClone(v);}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import * as crypto from "node:crypto"; import * as fs from "node:fs"; import * as path from "node:path";
|
|
2
|
+
export interface MonitorRegistration {profileKey:string;namespacePath:string;socketPath:string;socketDir:string;token:string;namespaceMode:number;tokenMode:number;discoveryPath:string;snapshot():unknown;cancel?(r:{taskId:string;generation:number}):unknown|Promise<unknown>;output?(r:{taskId:string;generation:number;afterSequence:number}):unknown|Promise<unknown>;events?(r:{afterSequence:number;limit:number;waitMs:number;signal?:AbortSignal}):unknown|Promise<unknown>;invoke?(r:unknown):unknown|Promise<unknown>;cleanup():void;renew():void;leaseMs:number;ownerId?:string;leaseExpiresAt?:string;}
|
|
3
|
+
export interface MonitorRegistryOptions {runtimeDir:string;now?:()=>Date;pid?:number;leaseMs?:number;beforeRenewPublish?:()=>void;} export interface RegisterMonitorInput {profilePath:string;profileId?:string;hubInstanceId:string;snapshot:()=>unknown;}
|
|
4
|
+
const D=0o700,F=0o600;const validDiscovery=(d:any)=>typeof d?.owner==="string"&&/^[0-9a-f-]{36}$/i.test(d.owner)&&typeof d.token==="string"&&/^token-[0-9a-f-]{36}$/i.test(d.token)&&typeof d.socket==="string"&&/^@runtime\/s\/[a-f0-9]+\/s$/.test(d.socket)&&typeof d.lease?.hub==="string"&&/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(d.lease.hub)&&Number.isInteger(d.lease?.pid)&&d.lease.pid>0&&typeof d.lease?.startedAt==="string"&&!Number.isNaN(Date.parse(d.lease.startedAt))&&typeof d.lease?.expiresAt==="string"&&!Number.isNaN(Date.parse(d.lease.expiresAt));const mode=(p:string)=>fs.statSync(p).mode&0o777;function dir(p:string){if(!path.isAbsolute(p))throw Error("monitor runtime directory must be absolute");fs.mkdirSync(p,{recursive:true,mode:D});if(fs.lstatSync(p).isSymbolicLink())throw Error("monitor runtime directory must not be a symlink");fs.chmodSync(p,D);}export function canonicalMonitorProfileId(id:string){if(!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id)||id.includes(".."))throw Error("monitor profile id is unsafe");return crypto.createHash("sha256").update(id).digest("hex");}function profile(p:string,id?:string){if(id)return canonicalMonitorProfileId(id);const real=fs.realpathSync(p);if(!fs.statSync(real).isDirectory())throw Error("monitor profile path must be a directory");return crypto.createHash("sha256").update(real).digest("hex");}function hub(id:string){if(!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id)||id.includes(".."))throw Error("hub instance id is unsafe");return crypto.createHash("sha256").update(id).digest("hex");}function atomic(p:string,s:string){const t=`${p}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;fs.writeFileSync(t,s,{mode:F,flag:"wx"});fs.chmodSync(t,F);fs.renameSync(t,p);}
|
|
5
|
+
export class MonitorRegistry {private runtimeDir:string;private now:()=>Date;private pid:number;private leaseMs:number;private beforeRenewPublish?:()=>void;constructor(o:MonitorRegistryOptions){this.runtimeDir=o.runtimeDir;this.now=o.now??(()=>new Date());this.pid=o.pid??process.pid;this.leaseMs=o.leaseMs??30_000;this.beforeRenewPublish=o.beforeRenewPublish;dir(this.runtimeDir);}register(input:RegisterMonitorInput):MonitorRegistration{const key=profile(input.profilePath,input.profileId),h=hub(input.hubInstanceId),ns=path.join(this.runtimeDir,key,h);dir(path.join(this.runtimeDir,key));dir(ns);for(const file of fs.readdirSync(ns).filter(x=>x.startsWith("discovery-"))){const discoveryPath=path.join(ns,file);try{const d=JSON.parse(fs.readFileSync(discoveryPath,"utf8"));if(!validDiscovery(d)||d.token!==`token-${d.owner}`||d.socket!==`@runtime/s/${crypto.createHash("sha256").update(`${key}:${h}:${d.owner}`).digest("hex").slice(0,32)}/s`)throw new Error("monitor discovery metadata is malformed");if(new Date(d.lease?.expiresAt).getTime()>this.now().getTime()){const error:any=Error("monitor namespace is owned by an active lease");error.leaseExpiresAt=d.lease.expiresAt;throw error;}const tokenName=d.token;if(typeof tokenName==="string"&&/^token-[0-9a-f-]+$/.test(tokenName))try{fs.unlinkSync(path.join(ns,tokenName))}catch(e:any){if(e?.code!=="ENOENT")throw e;}fs.unlinkSync(discoveryPath);const socket=typeof d.socket==="string"?d.socket:"";if(socket.startsWith("@runtime/s/")&&socket.endsWith("/s")){const socketDir=path.join(this.runtimeDir,socket.slice("@runtime/".length,-2));if(socketDir.startsWith(path.join(this.runtimeDir,"s")+path.sep))try{fs.rmSync(socketDir,{recursive:true,force:true})}catch{}}}catch(e:any){if(/active lease|malformed/.test(String(e)))throw e;if(e instanceof SyntaxError||e instanceof TypeError||e instanceof RangeError)throw new Error("monitor discovery metadata is malformed");}}
|
|
6
|
+
const owner=crypto.randomUUID(),socketDir=path.join(this.runtimeDir,"s",crypto.createHash("sha256").update(`${key}:${h}:${owner}`).digest("hex").slice(0,32));dir(socketDir);const tokenPath=path.join(ns,`token-${owner}`),discoveryPath=path.join(ns,`discovery-${owner}.json`),socketPath=path.join(socketDir,"s"),token=crypto.randomBytes(32).toString("hex"),started=this.now();atomic(tokenPath,token);const tokenFd=fs.openSync(tokenPath,"r");const write=(issued:Date)=>atomic(discoveryPath,JSON.stringify({owner,socket:`@runtime/s/${path.basename(socketDir)}/s`,token:path.basename(tokenPath),lease:{hub:input.hubInstanceId,pid:this.pid,startedAt:started.toISOString(),expiresAt:new Date(issued.getTime()+this.leaseMs).toISOString()}}));write(started);const owns=()=>{try{return fs.fstatSync(tokenFd).nlink===1&&fs.readFileSync(tokenPath,"utf8")===token&&JSON.parse(fs.readFileSync(discoveryPath,"utf8")).owner===owner;}catch{return false;}};const cleanup=()=>{if(!owns())return;for(const p of [tokenPath,discoveryPath])try{fs.unlinkSync(p)}catch(e:any){if(e?.code!=="ENOENT")throw e;}finally{try{fs.closeSync(tokenFd)}catch{}}};return{profileKey:key,ownerId:owner,leaseExpiresAt:new Date(started.getTime()+this.leaseMs).toISOString(),namespacePath:ns,socketPath,socketDir,token,namespaceMode:mode(ns),tokenMode:mode(tokenPath),discoveryPath,snapshot:input.snapshot,cleanup,renew:()=>{if(!owns())throw Error("monitor ownership lost");this.beforeRenewPublish?.();if(!owns())throw Error("monitor ownership lost");const renewedAt=this.now();write(renewedAt);if(!owns()){try{if(JSON.parse(fs.readFileSync(discoveryPath,"utf8")).owner===owner)fs.unlinkSync(discoveryPath)}catch{}throw Error("monitor ownership lost");}return{leaseExpiresAt:new Date(renewedAt.getTime()+this.leaseMs).toISOString()};},leaseMs:this.leaseMs};} evidenceForOwner(ownerId:string,hubInstanceId:string){try{if(!/^[0-9a-f-]{36}$/i.test(ownerId))throw Error("malformed");const h=hub(hubInstanceId);for(const profileKey of fs.readdirSync(this.runtimeDir)){const p=path.join(this.runtimeDir,profileKey,h,`discovery-${ownerId}.json`);if(!fs.existsSync(p))continue;const d=JSON.parse(fs.readFileSync(p,"utf8"));if(!validDiscovery(d)||d.owner!==ownerId||d.token!==`token-${ownerId}`)throw Error("malformed");const token=path.join(path.dirname(p),d.token),socket=path.join(this.runtimeDir,d.socket.slice("@runtime/".length));return{owner:fs.existsSync(token),socket:fs.existsSync(socket),session:fs.existsSync(token),expired:new Date(d.lease.expiresAt).getTime()<=this.now().getTime()};}return{owner:false,socket:false,session:false,expired:true};}catch(error){return{transient:true,error};}}}
|