@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,163 @@
|
|
|
1
|
+
import * as crypto from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as net from "node:net";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
|
|
6
|
+
import type { MonitorRegistration } from "./hermes-monitor-registry.ts";
|
|
7
|
+
|
|
8
|
+
export const MAX_SOCKET_FRAME_BYTES = 64 * 1024;
|
|
9
|
+
export const MAX_SNAPSHOT_BYTES = 256 * 1024;
|
|
10
|
+
export const MAX_CANCEL_RESPONSE_BYTES = 16 * 1024;
|
|
11
|
+
export const PARTIAL_FRAME_TIMEOUT_MS = 1000;
|
|
12
|
+
export const MAX_SOCKET_CONNECTIONS = 32;
|
|
13
|
+
export const MAX_TASK_ID_LENGTH = 128;
|
|
14
|
+
export const MAX_AFTER_SEQUENCE = 1_000_000_000;
|
|
15
|
+
/** 2 MiB covers the 256 KiB retained UTF-8 output after worst-case JSON escaping plus its envelope. */
|
|
16
|
+
export const MAX_OUTPUT_RESPONSE_BYTES = 2 * 1024 * 1024;
|
|
17
|
+
export const MAX_EVENT_WAITERS = 8;
|
|
18
|
+
export const MAX_EVENT_WAIT_MS = 25_000;
|
|
19
|
+
|
|
20
|
+
interface SnapshotRequest {
|
|
21
|
+
type: "snapshot";
|
|
22
|
+
token: string;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
function authorized(actual: string, expected: string): boolean {
|
|
26
|
+
const actualBytes = Buffer.from(actual);
|
|
27
|
+
const expectedBytes = Buffer.from(expected);
|
|
28
|
+
return actualBytes.length === expectedBytes.length && crypto.timingSafeEqual(actualBytes, expectedBytes);
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function validTaskRequest(taskId: unknown, generation: unknown, afterSequence?: unknown): boolean { return typeof taskId === "string" && /^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(taskId) && taskId.length <= MAX_TASK_ID_LENGTH && Number.isInteger(generation) && (generation as number) >= 1 && (afterSequence === undefined || (Number.isInteger(afterSequence) && (afterSequence as number) >= 0 && (afterSequence as number) <= MAX_AFTER_SEQUENCE)); }
|
|
32
|
+
|
|
33
|
+
function parseRequest(frame: string): SnapshotRequest | null {
|
|
34
|
+
try {
|
|
35
|
+
const value = JSON.parse(frame) as Partial<SnapshotRequest>;
|
|
36
|
+
if (value.type !== "snapshot" || typeof value.token !== "string") return null;
|
|
37
|
+
return { type: "snapshot", token: value.token };
|
|
38
|
+
} catch {
|
|
39
|
+
return null;
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export class MonitorSocketServer {
|
|
44
|
+
private readonly registration: MonitorRegistration;
|
|
45
|
+
private readonly server: net.Server;
|
|
46
|
+
private connections = 0;
|
|
47
|
+
private eventWaiters = 0;
|
|
48
|
+
private readonly sockets = new Set<net.Socket>();
|
|
49
|
+
|
|
50
|
+
constructor(registration: MonitorRegistration) {
|
|
51
|
+
this.registration = registration;
|
|
52
|
+
// Consumers are documented to half-close after writing their single frame.
|
|
53
|
+
// Without allowHalfOpen the runtime would end our writable side on that FIN,
|
|
54
|
+
// silently dropping any response that settles later than the current turn —
|
|
55
|
+
// every long-poll `events` reply, and any cancel that waits on a real exit.
|
|
56
|
+
this.server = net.createServer({ allowHalfOpen: true }, (socket) => {
|
|
57
|
+
if (this.connections >= MAX_SOCKET_CONNECTIONS) { socket.destroy(); return; }
|
|
58
|
+
this.connections += 1;
|
|
59
|
+
this.sockets.add(socket);
|
|
60
|
+
socket.once("close", () => { this.connections -= 1; this.sockets.delete(socket); });
|
|
61
|
+
this.handle(socket);
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
private assertOwnedSocketPath(): void {
|
|
66
|
+
if (!this.registration.socketDir || path.resolve(this.registration.socketPath) !== path.join(path.resolve(this.registration.socketDir), "s")) throw new Error("monitor socket path is not registry-owned");
|
|
67
|
+
if (fs.lstatSync(this.registration.socketDir).isSymbolicLink() || (fs.statSync(this.registration.socketDir).mode & 0o777) !== 0o700) throw new Error("monitor socket directory is unsafe");
|
|
68
|
+
}
|
|
69
|
+
private async removeVerifiedStaleSocket(): Promise<void> {
|
|
70
|
+
this.assertOwnedSocketPath(); if (!fs.existsSync(this.registration.socketPath)) return;
|
|
71
|
+
const active=await new Promise<boolean>(resolve=>{const probe=net.createConnection(this.registration.socketPath);probe.once("connect",()=>{probe.destroy();resolve(true);});probe.once("error",()=>resolve(false));});
|
|
72
|
+
if (active) throw new Error("monitor socket is already active");
|
|
73
|
+
if (fs.lstatSync(this.registration.socketPath).isSymbolicLink()) throw new Error("monitor socket must not be a symlink"); fs.unlinkSync(this.registration.socketPath);
|
|
74
|
+
}
|
|
75
|
+
async listen(): Promise<void> {
|
|
76
|
+
await this.removeVerifiedStaleSocket(); return new Promise((resolve, reject) => { this.server.once("error", reject); this.server.listen(this.registration.socketPath, () => { this.server.off("error", reject); fs.chmodSync(this.registration.socketPath, 0o600); resolve(); }); });
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
async close(): Promise<void> {
|
|
80
|
+
for (const socket of this.sockets) socket.destroy();
|
|
81
|
+
await new Promise<void>((resolve, reject) => this.server.close((error) => error ? reject(error) : resolve()));
|
|
82
|
+
this.assertOwnedSocketPath(); try { fs.unlinkSync(this.registration.socketPath); } catch (error: any) { if (error?.code !== "ENOENT") throw error; }
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
mode(): number {
|
|
86
|
+
return fs.statSync(this.registration.socketPath).mode & 0o777;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
private handle(socket: net.Socket): void {
|
|
90
|
+
// A long-poll callback may settle after its peer disconnects. Keep that
|
|
91
|
+
// late write local to this connection instead of emitting an unhandled error.
|
|
92
|
+
socket.on("error", () => {});
|
|
93
|
+
let buffer = "";
|
|
94
|
+
let handled = false;
|
|
95
|
+
const deadline = setTimeout(() => { if (!handled) socket.destroy(); }, PARTIAL_FRAME_TIMEOUT_MS);
|
|
96
|
+
socket.on("data", (chunk) => {
|
|
97
|
+
if (handled) return;
|
|
98
|
+
buffer += chunk.toString("utf8");
|
|
99
|
+
if (Buffer.byteLength(buffer, "utf8") > MAX_SOCKET_FRAME_BYTES) {
|
|
100
|
+
socket.destroy();
|
|
101
|
+
return;
|
|
102
|
+
}
|
|
103
|
+
const newline = buffer.indexOf("\n");
|
|
104
|
+
if (newline < 0) return;
|
|
105
|
+
handled = true;
|
|
106
|
+
const request = parseRequest(buffer.slice(0, newline));
|
|
107
|
+
clearTimeout(deadline);
|
|
108
|
+
let value: { type?: string; token?: string; taskId?: string; generation?: number };
|
|
109
|
+
try { value = JSON.parse(buffer.slice(0, newline)) as typeof value; } catch { socket.destroy(); return; }
|
|
110
|
+
if (value.type === "events") {
|
|
111
|
+
if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
|
|
112
|
+
const afterSequence=(value as any).afterSequence, limit=(value as any).limit, waitMs=(value as any).waitMs;
|
|
113
|
+
if (!this.registration.events || !Number.isInteger(afterSequence) || afterSequence < 0 || afterSequence > MAX_AFTER_SEQUENCE || !Number.isInteger(limit) || limit < 1 || limit > 100 || !Number.isInteger(waitMs) || waitMs < 0 || waitMs > MAX_EVENT_WAIT_MS) { socket.destroy(); return; }
|
|
114
|
+
if (waitMs > 0 && this.eventWaiters >= MAX_EVENT_WAITERS) { socket.end(JSON.stringify({ ok: false, error: "too_many_waiters" }) + "\n"); return; }
|
|
115
|
+
let waiterReleased = false;
|
|
116
|
+
const releaseWaiter = () => {
|
|
117
|
+
if (waitMs > 0 && !waiterReleased) { waiterReleased = true; this.eventWaiters--; }
|
|
118
|
+
};
|
|
119
|
+
const abort = new AbortController();
|
|
120
|
+
if (waitMs > 0) {
|
|
121
|
+
this.eventWaiters++;
|
|
122
|
+
// Release on FIN as well as close: with allowHalfOpen a gone peer is
|
|
123
|
+
// otherwise indistinguishable from a live one, and a parked waiter
|
|
124
|
+
// would hold a slot for the full wait window. A client that wants to
|
|
125
|
+
// park on a long poll keeps its write side open (as the watcher does);
|
|
126
|
+
// one that half-closes gets an immediate bounded reply instead.
|
|
127
|
+
const release = () => { abort.abort(); releaseWaiter(); };
|
|
128
|
+
socket.once("close", release);
|
|
129
|
+
socket.once("end", release);
|
|
130
|
+
}
|
|
131
|
+
Promise.resolve().then(()=>this.registration.events!({afterSequence,limit,waitMs,signal:abort.signal})).then((events:any)=>{
|
|
132
|
+
if (events?.error === "cursor_too_old") socket.end(JSON.stringify({ ok: false, error: "cursor_too_old", snapshotRequired: true, firstAvailableSequence: events.firstAvailableSequence, latestSequence: events.latestSequence }) + "\n");
|
|
133
|
+
else socket.end(JSON.stringify({ok:true,events})+"\n");
|
|
134
|
+
}).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")).finally(releaseWaiter); return;
|
|
135
|
+
}
|
|
136
|
+
if (value.type === "invoke") {
|
|
137
|
+
if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
|
|
138
|
+
if (!this.registration.invoke) { socket.end(JSON.stringify({ ok: false, error: "unsupported" }) + "\n"); return; }
|
|
139
|
+
const request={...(value as any)}; delete (request as any).token; delete (request as any).type;
|
|
140
|
+
Promise.resolve().then(()=>this.registration.invoke!(request)).then(result=>socket.end(JSON.stringify({ok:true,result})+"\n")).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")); return;
|
|
141
|
+
}
|
|
142
|
+
if (value.type === "output") {
|
|
143
|
+
if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
|
|
144
|
+
if (!this.registration.output || (value as any).afterSequence === undefined || !validTaskRequest(value.taskId, value.generation, (value as any).afterSequence)) { socket.destroy(); return; }
|
|
145
|
+
Promise.resolve().then(()=>this.registration.output!({ taskId: value.taskId!, generation: value.generation!, afterSequence: (value as any).afterSequence })).then((output) => { const body=JSON.stringify({ ok:true, output }); if(Buffer.byteLength(body)>MAX_OUTPUT_RESPONSE_BYTES) socket.end(JSON.stringify({ok:false,error:"response_too_large"})+"\n"); else socket.end(body+"\n"); }).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")); return;
|
|
146
|
+
}
|
|
147
|
+
if (value.type === "cancel") {
|
|
148
|
+
if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
|
|
149
|
+
if (!this.registration.cancel || !validTaskRequest(value.taskId, value.generation)) { socket.destroy(); return; }
|
|
150
|
+
Promise.resolve().then(()=>this.registration.cancel!({ taskId: value.taskId!, generation: value.generation! })).then((result) => { const body=JSON.stringify({ ok: true, result }); if (Buffer.byteLength(body, "utf8") > MAX_CANCEL_RESPONSE_BYTES) socket.end(JSON.stringify({ok:false,error:"response_too_large"})+"\n"); else socket.end(body + "\n"); }).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")); return;
|
|
151
|
+
}
|
|
152
|
+
if (!request || !authorized(request.token, this.registration.token)) {
|
|
153
|
+
if (request) socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n");
|
|
154
|
+
else socket.destroy();
|
|
155
|
+
return;
|
|
156
|
+
}
|
|
157
|
+
try { const response = JSON.stringify({ ok: true, snapshot: this.registration.snapshot() }); if (Buffer.byteLength(response, "utf8") > MAX_SNAPSHOT_BYTES) socket.end(JSON.stringify({ok:false,error:"response_too_large"})+"\n"); else socket.end(response + "\n"); } catch { socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n"); }
|
|
158
|
+
});
|
|
159
|
+
socket.on("end", () => {
|
|
160
|
+
if (!handled) socket.destroy();
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { createChildTask, createParentTask, type CreateChildTaskInput, type CreateParentTaskInput, type MonitorTask } from "./hermes-monitor-model.ts";
|
|
2
|
+
export const MAX_OUTPUT_BYTES=256*1024;
|
|
3
|
+
export const MONITOR_RETENTION_MS=7*24*60*60*1000;
|
|
4
|
+
export const MONITOR_RETENTION_MAX=200;
|
|
5
|
+
const terminal=new Set(["completed","blocked","failed","cancelled","orphaned","done"]);
|
|
6
|
+
const active=(state:string)=>state==="starting"||state==="running"||state==="cancelling"||state==="recovering";
|
|
7
|
+
export function pruneMonitorTasks<T extends {state:string;updatedAt?:string}>(options:{now:Date;tasks:T[]}):T[]{const cutoff=options.now.getTime()-MONITOR_RETENTION_MS;const running=options.tasks.filter(t=>active(t.state));const terminalTasks=options.tasks.filter(t=>!active(t.state)&&(!t.updatedAt||new Date(t.updatedAt).getTime()>=cutoff)).sort((a,b)=>new Date(a.updatedAt??0).getTime()-new Date(b.updatedAt??0).getTime()).slice(-MONITOR_RETENTION_MAX);return [...running,...terminalTasks];}
|
|
8
|
+
export interface MonitorOutput{text:string;sequence:number;firstSequence:number;truncated:boolean}
|
|
9
|
+
interface StoredOutput{chunks:{sequence:number;text:string}[];sequence:number;truncated:boolean}
|
|
10
|
+
interface StoredTask{task:MonitorTask;output:StoredOutput;createdAt:string;updatedAt:string}
|
|
11
|
+
function suffix(text:string,limit:number){let bytes=0;const chars:string[]=[];for(const char of Array.from(text).reverse()){const size=Buffer.byteLength(char);if(bytes+size>limit)break;chars.push(char);bytes+=size;}return chars.reverse().join("");}
|
|
12
|
+
|
|
13
|
+
export class MonitorStore {
|
|
14
|
+
private readonly tasks=new Map<string,StoredTask>(); private readonly now:()=>Date;
|
|
15
|
+
constructor(options:{now?:()=>Date}={}){this.now=options.now??(()=>new Date());}
|
|
16
|
+
private key(id:string,generation:number){return `${id}:${generation}`;} private stamp(){return this.now().toISOString();}
|
|
17
|
+
createParent(input:CreateParentTaskInput){return this.add(createParentTask(input));}
|
|
18
|
+
createChild(input:CreateChildTaskInput){if(![...this.tasks.values()].some(s=>s.task.id===input.parentId&&s.task.generation===input.parentGeneration&&s.task.kind==="parent"))throw new Error(`parent task ${input.parentId} was not found`);return this.add(createChildTask(input));}
|
|
19
|
+
patch(id:string,generation:number,values:any){const stored=this.require(id,generation);Object.assign(stored.task,values);stored.updatedAt=this.stamp();return stored.task;}
|
|
20
|
+
transition(id:string,generation:number,state:any){const stored=this.require(id,generation);if(terminal.has(stored.task.state))throw new Error("terminal transition");stored.task.state=state;stored.updatedAt=this.stamp();return stored.task;}
|
|
21
|
+
get(id:string,generation?:number){return generation===undefined?[...this.tasks.values()].find(s=>s.task.id===id)?.task:this.tasks.get(this.key(id,generation))?.task;}
|
|
22
|
+
appendPublicOutput(id:string,generation:number,text:string){const stored=this.require(id,generation);if(terminal.has(stored.task.state))throw new Error("terminal output");const sequence=stored.output.sequence+1, chunk=suffix(text,MAX_OUTPUT_BYTES),chunks=[...stored.output.chunks,{sequence,text:chunk}];let bytes=chunks.reduce((n,c)=>n+Buffer.byteLength(c.text),0),truncated=stored.output.truncated||bytes<Buffer.byteLength(text);while(bytes>MAX_OUTPUT_BYTES&&chunks.length>1){bytes-=Buffer.byteLength(chunks.shift()!.text);truncated=true;}stored.output={chunks,sequence,truncated};stored.updatedAt=this.stamp();return this.outputAfter(stored.output,0);}
|
|
23
|
+
readOutput(id:string,generation:number,afterSequence:number){return this.outputAfter(this.require(id,generation).output,afterSequence);}
|
|
24
|
+
snapshot(){return {tasks:[...this.tasks.values()].map(s=>this.publicTask(s))};} durableSnapshot(){return{tasks:[...this.tasks.values()].map(s=>({...this.publicTask(s),outputChunks:s.output.chunks.map(c=>({...c}),),outputLatestSequence:s.output.sequence,outputFirstSequence:s.output.chunks[0]?.sequence??0,outputTruncated:s.output.truncated}))};} restore(rows:any[]){for(const row of rows){const key=this.key(row.id,row.generation);if(this.tasks.has(key))continue;const output=row.output??"";this.tasks.set(key,{task:{...row},output:{chunks:Array.isArray(row.outputChunks)?row.outputChunks.map((c:any)=>({sequence:c.sequence,text:c.text})):output?[{sequence:row.outputSequence??1,text:output}]:[],sequence:row.outputLatestSequence??row.outputSequence??0,truncated:row.outputTruncated??!!row.truncated},createdAt:row.createdAt??this.stamp(),updatedAt:row.updatedAt??this.stamp()});}}
|
|
25
|
+
prune(now=this.now()){const cutoff=now.getTime()-MONITOR_RETENTION_MS;const values=[...this.tasks.values()];const protectedIds=new Set<string>();for(const s of values)if(active(s.task.state)){protectedIds.add(this.key(s.task.id,s.task.generation));if(s.task.parentId)for(const p of values)if(p.task.id===s.task.parentId)protectedIds.add(this.key(p.task.id,p.task.generation));for(const c of values)if(c.task.parentId===s.task.id)protectedIds.add(this.key(c.task.id,c.task.generation));}const candidates=values.filter(s=>!active(s.task.state)&&!protectedIds.has(this.key(s.task.id,s.task.generation))).sort((a,b)=>Date.parse(a.updatedAt)-Date.parse(b.updatedAt));const expired=candidates.filter(s=>Date.parse(s.updatedAt)<cutoff);for(const s of expired)this.tasks.delete(this.key(s.task.id,s.task.generation));const remaining=[...this.tasks.values()].filter(s=>!active(s.task.state)&&!protectedIds.has(this.key(s.task.id,s.task.generation))).sort((a,b)=>Date.parse(a.updatedAt)-Date.parse(b.updatedAt));while(remaining.length>MONITOR_RETENTION_MAX){const oldest=remaining.shift()!;this.tasks.delete(this.key(oldest.task.id,oldest.task.generation));}return this.snapshot();}
|
|
26
|
+
private add(task:MonitorTask){const key=this.key(task.id,task.generation);if(this.tasks.has(key))throw new Error(`task ${task.id} generation ${task.generation} already exists`);const stamp=this.stamp();this.tasks.set(key,{task,output:{chunks:[],sequence:0,truncated:false},createdAt:stamp,updatedAt:stamp});return task;}
|
|
27
|
+
private publicTask(s:StoredTask){const output=this.outputAfter(s.output,0);return {...s.task,createdAt:s.createdAt,updatedAt:s.updatedAt,outputSequence:output.sequence,firstSequence:output.firstSequence,truncated:output.truncated};}
|
|
28
|
+
private outputAfter(output:StoredOutput,after:number):MonitorOutput{return{text:output.chunks.filter(c=>c.sequence>after).map(c=>c.text).join(""),sequence:output.sequence,firstSequence:output.chunks[0]?.sequence??0,truncated:output.truncated};}
|
|
29
|
+
private require(id:string,generation:number){const stored=this.tasks.get(this.key(id,generation));if(!stored)throw new Error(`task ${id} generation ${generation} was not found`);return stored;}
|
|
30
|
+
}
|
|
31
|
+
export function createMonitorStore(options:{now:()=>Date}){const store=new MonitorStore(options);const baseSnapshot=store.snapshot.bind(store);return Object.assign(store,{snapshot(){const all=(baseSnapshot() as any).tasks;return{tasks:all.filter((t:any)=>t.kind==='parent').map((parent:any)=>({id:parent.id,generation:parent.generation,children:all.filter((child:any)=>child.parentId===parent.id).map((child:any)=>({id:child.id,generation:child.generation,state:child.state,workspaceId:child.workspaceId,hubPaneId:child.hubPaneId,outputSequence:child.outputSequence,updatedAt:child.updatedAt}))}))};}});}
|
|
@@ -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,191 @@
|
|
|
1
|
+
// Spawned coms peers: pane launch, readiness policy and the never-addressed sweep.
|
|
2
|
+
//
|
|
3
|
+
// Lives in the SHARED harness lib, not under agent-hub: `just fleet peer`
|
|
4
|
+
// (.pi/agent-fleet/scripts/peer-launch.ts) launches a single peer with the same pane plumbing
|
|
5
|
+
// and the same readiness timings, and the fleet scripts are installed into
|
|
6
|
+
// target projects that may not have selected the agent-hub harness at all.
|
|
7
|
+
//
|
|
8
|
+
// Root cause this encodes: `herdr_spawn_peer` launches a REUSABLE coms peer —
|
|
9
|
+
// it boots idle and waits for a `coms_send`. Spawning it delivers no work. One
|
|
10
|
+
// session spawned `repair-builder` and `final-test-worker`, sent all twelve of
|
|
11
|
+
// its messages to a third peer, and left two empty panes named like workers.
|
|
12
|
+
// The spawns were a sound reaction to a broken session; nothing told the
|
|
13
|
+
// dispatcher when the peers became addressable, and nothing noticed they never
|
|
14
|
+
// were addressed.
|
|
15
|
+
//
|
|
16
|
+
// Two answers: the spawn returns a readiness verdict instead of a bare pane id,
|
|
17
|
+
// and an unaddressed hub-spawned peer is named at the end of the session.
|
|
18
|
+
|
|
19
|
+
// Second root cause this encodes: herdr's `pane.split` takes NO command — a
|
|
20
|
+
// split always opens a plain interactive shell in `cwd`. The hub used to pass
|
|
21
|
+
// `command: argv` to it; herdr silently ignores unknown params, so every
|
|
22
|
+
// "spawned peer" was an empty shell pane with the right label, the tool
|
|
23
|
+
// reported success, and the peer never existed. `just fleet team` was
|
|
24
|
+
// unaffected because it launches through `layout.apply`, whose pane nodes DO
|
|
25
|
+
// carry an argv. A hub spawn is therefore three steps: split, wait for the
|
|
26
|
+
// pane's shell prompt, then type the command line.
|
|
27
|
+
|
|
28
|
+
/** Longest we wait for a spawned peer to register in the coms pool. */
|
|
29
|
+
export const PEER_READY_TIMEOUT_MS = 45_000;
|
|
30
|
+
|
|
31
|
+
/** Longest we wait for a freshly split pane to reach its shell prompt. */
|
|
32
|
+
export const PANE_PROMPT_TIMEOUT_MS = 10_000;
|
|
33
|
+
|
|
34
|
+
/** Poll interval while watching a new pane for its shell prompt, in ms. */
|
|
35
|
+
export const PANE_PROMPT_POLL_MS = 250;
|
|
36
|
+
|
|
37
|
+
/** Shell metacharacter-free values pass through unquoted; everything else is quoted. */
|
|
38
|
+
const BARE_ARG = /^[A-Za-z0-9._/,:=@%+-]+$/;
|
|
39
|
+
|
|
40
|
+
function shellQuote(arg) {
|
|
41
|
+
const s = String(arg ?? "");
|
|
42
|
+
if (s === "") return "''"; // positional placeholders must survive as empty args
|
|
43
|
+
if (BARE_ARG.test(s)) return s;
|
|
44
|
+
return `'${s.replace(/'/g, `'\\''`)}'`;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* An argv (as built by peerCommand) turned into one line of shell input,
|
|
49
|
+
* newline included. Quoting matters for the empty positional placeholders the
|
|
50
|
+
* `just` recipes use to keep later positionals aligned — unquoted they would
|
|
51
|
+
* vanish and shift `--project` into the model slot.
|
|
52
|
+
*/
|
|
53
|
+
export function paneLaunchLine(argv) {
|
|
54
|
+
if (!Array.isArray(argv) || argv.length === 0) {
|
|
55
|
+
throw new Error("paneLaunchLine: empty argv");
|
|
56
|
+
}
|
|
57
|
+
return `${argv.map(shellQuote).join(" ")}\n`;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Does this pane read end at an interactive shell prompt? Typing before the
|
|
62
|
+
* shell is up can drop the line, and herdr's own `agent.start` refuses a pane
|
|
63
|
+
* that is not at a prompt, so the spawn waits for one. Best-effort by design:
|
|
64
|
+
* the caller sends anyway once PANE_PROMPT_TIMEOUT_MS is spent.
|
|
65
|
+
*/
|
|
66
|
+
export function looksLikeShellPrompt(text) {
|
|
67
|
+
if (typeof text !== "string") return false;
|
|
68
|
+
const lines = text.replace(/\r/g, "").split("\n");
|
|
69
|
+
while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines.pop();
|
|
70
|
+
if (lines.length === 0) return false;
|
|
71
|
+
return /[$#%>❯➜›]\s*$/.test(lines[lines.length - 1]);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Launch an argv in a freshly split pane by typing it at the pane's shell.
|
|
76
|
+
* `client` is the herdr client (paneRead/paneSendText/paneSendKeys).
|
|
77
|
+
*
|
|
78
|
+
* Text and Enter go as separate calls on purpose: bash enables bracketed
|
|
79
|
+
* paste, where a newline inside sent text is inserted into the line editor
|
|
80
|
+
* instead of executing it. A pane that never shows a prompt still gets the
|
|
81
|
+
* command — the shell's input queue survives a slow banner — but the caller
|
|
82
|
+
* is told, because that is also what a pane whose shell died looks like.
|
|
83
|
+
*/
|
|
84
|
+
export async function launchPeerInPane(client, paneId, argv, opts = {}) {
|
|
85
|
+
const {
|
|
86
|
+
timeoutMs = PANE_PROMPT_TIMEOUT_MS,
|
|
87
|
+
pollMs = PANE_PROMPT_POLL_MS,
|
|
88
|
+
now = Date.now,
|
|
89
|
+
sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
|
|
90
|
+
} = opts;
|
|
91
|
+
const line = paneLaunchLine(argv).replace(/\n$/, "");
|
|
92
|
+
const started = now();
|
|
93
|
+
let promptSeen = false;
|
|
94
|
+
for (;;) {
|
|
95
|
+
try {
|
|
96
|
+
const { read } = await client.paneRead({ pane_id: paneId, lines: 5 });
|
|
97
|
+
if (looksLikeShellPrompt(read?.text ?? "")) {
|
|
98
|
+
promptSeen = true;
|
|
99
|
+
break;
|
|
100
|
+
}
|
|
101
|
+
} catch {
|
|
102
|
+
// Pane not readable yet; the timeout below bounds the wait.
|
|
103
|
+
}
|
|
104
|
+
if (now() - started >= timeoutMs) break;
|
|
105
|
+
await sleep(pollMs);
|
|
106
|
+
}
|
|
107
|
+
await client.paneSendText(paneId, line);
|
|
108
|
+
await client.paneSendKeys(paneId, ["enter"]);
|
|
109
|
+
return { promptSeen, waitedMs: now() - started };
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* Seconds a hub-spawned pi peer should sleep before launching (the justfile
|
|
114
|
+
* recipes honor it as AGENT_FLEET_SPAWN_DELAY). Same stale-OAuth lock race
|
|
115
|
+
* that staggers team spawns: the first peer refreshes the token, so only a
|
|
116
|
+
* sibling spawned inside the warm-up window has to wait. `needed` is
|
|
117
|
+
* oauthNeedsWarmup() re-read at each spawn — once the warmer lands a fresh
|
|
118
|
+
* token it goes false and nobody waits.
|
|
119
|
+
*/
|
|
120
|
+
export function spawnStaggerSeconds({ needed, lastSpawnAt, now, warmupSeconds }) {
|
|
121
|
+
if (!needed || !Number.isFinite(warmupSeconds) || warmupSeconds <= 0) return 0;
|
|
122
|
+
if (typeof lastSpawnAt !== "number" || !Number.isFinite(lastSpawnAt)) return 0;
|
|
123
|
+
if (now - lastSpawnAt >= warmupSeconds * 1000) return 0;
|
|
124
|
+
return warmupSeconds;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** Poll backoff while waiting for registration, in ms; the last step repeats. */
|
|
128
|
+
export const PEER_READY_BACKOFF_MS = [250, 500, 1_000, 2_000, 3_000];
|
|
129
|
+
|
|
130
|
+
/** Backoff delay for the nth readiness poll (0-based); the last step repeats. */
|
|
131
|
+
export function peerReadyDelayMs(attempt) {
|
|
132
|
+
const i = Math.max(0, Math.min(Math.floor(attempt) || 0, PEER_READY_BACKOFF_MS.length - 1));
|
|
133
|
+
return PEER_READY_BACKOFF_MS[i];
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* The verdict a spawn reports back. `ready` means the peer is in the pool and
|
|
138
|
+
* `coms_send` will reach it; otherwise it is still booting and the caller is
|
|
139
|
+
* told how long we waited rather than being left to guess.
|
|
140
|
+
* @param {{name: string, paneId: string, found: boolean, waitedMs: number, timeoutMs?: number, paneTail?: string}} input
|
|
141
|
+
*/
|
|
142
|
+
export function peerReadyVerdict({ name, paneId, found, waitedMs, timeoutMs = PEER_READY_TIMEOUT_MS, paneTail }) {
|
|
143
|
+
if (found) {
|
|
144
|
+
return {
|
|
145
|
+
peer_ready: true,
|
|
146
|
+
peer_name: name,
|
|
147
|
+
pane_id: paneId,
|
|
148
|
+
waited_ms: waitedMs,
|
|
149
|
+
message:
|
|
150
|
+
`Peer "${name}" is ready in pane ${paneId} after ${Math.round(waitedMs / 1000)}s — ` +
|
|
151
|
+
`address it with coms_send(target: "${name}", ...). It boots idle and does no work until you send.`,
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
// A peer that missed the window is usually dead, not slow, so the verdict
|
|
155
|
+
// carries the pane's own last words instead of sending the caller off to
|
|
156
|
+
// run herdr_read_pane to find out.
|
|
157
|
+
const tail = typeof paneTail === "string" ? paneTail.trim() : "";
|
|
158
|
+
return {
|
|
159
|
+
peer_ready: false,
|
|
160
|
+
peer_name: name,
|
|
161
|
+
pane_id: paneId,
|
|
162
|
+
waited_ms: waitedMs,
|
|
163
|
+
pane_tail: tail || null,
|
|
164
|
+
message:
|
|
165
|
+
`Peer "${name}" did not register in the coms pool within ${Math.round(timeoutMs / 1000)}s — ` +
|
|
166
|
+
`assume it failed to start rather than that it is slow. Do not coms_send to it. ` +
|
|
167
|
+
`Check coms_list; if it never appears, close the pane with herdr_close_pane.` +
|
|
168
|
+
(tail ? `\n\nLast output of pane ${paneId}:\n${tail}` : ""),
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* Sweep report for peers this hub spawned. `entries` carry
|
|
174
|
+
* { name, paneId, addressed } — `addressed` is true once any coms_send targeted
|
|
175
|
+
* that peer. Returns null when every spawned peer got work (the common case).
|
|
176
|
+
*/
|
|
177
|
+
export function unaddressedPeerSweep(entries) {
|
|
178
|
+
const idle = (Array.isArray(entries) ? entries : []).filter((e) => e && !e.addressed);
|
|
179
|
+
if (idle.length === 0) return null;
|
|
180
|
+
const rows = idle.map((e) => ` ${e.name} (pane ${e.paneId ?? "?"}) — spawned, never sent to`);
|
|
181
|
+
return {
|
|
182
|
+
count: idle.length,
|
|
183
|
+
peers: idle.map((e) => ({ name: e.name, pane_id: e.paneId ?? null })),
|
|
184
|
+
message: [
|
|
185
|
+
`⚠ ${idle.length} hub-spawned peer(s) never received a message:`,
|
|
186
|
+
...rows,
|
|
187
|
+
"A spawned peer boots idle and waits — it is holding a pane and a model session for nothing.",
|
|
188
|
+
`Close them with herdr_close_pane (asks for your confirmation) or send them work.`,
|
|
189
|
+
].join("\n"),
|
|
190
|
+
};
|
|
191
|
+
}
|
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
// @ts-nocheck
|
|
2
|
+
/** JSON parser that refuses duplicate object keys, including escaped aliases. */
|
|
3
|
+
export function parseConfigJson(text) {
|
|
4
|
+
let i = 0;
|
|
5
|
+
const space = () => { while (/\s/.test(text[i] ?? '') && i < text.length) i++; };
|
|
6
|
+
const string = () => {
|
|
7
|
+
const start = i++;
|
|
8
|
+
while (i < text.length) {
|
|
9
|
+
if (text[i] === '\\') { i += 2; continue; }
|
|
10
|
+
if (text[i++] === '"') return JSON.parse(text.slice(start, i));
|
|
11
|
+
}
|
|
12
|
+
throw new Error('Invalid JSON string');
|
|
13
|
+
};
|
|
14
|
+
const value = path => {
|
|
15
|
+
space();
|
|
16
|
+
if (text[i] === '{') {
|
|
17
|
+
i++; space(); const keys = new Set();
|
|
18
|
+
if (text[i] === '}') { i++; return; }
|
|
19
|
+
while (i < text.length) {
|
|
20
|
+
space(); if (text[i] !== '"') throw new Error(`Invalid JSON at ${path}`);
|
|
21
|
+
const key = string();
|
|
22
|
+
if (keys.has(key)) throw new Error(`Duplicate JSON key: ${path}.${key}`);
|
|
23
|
+
keys.add(key); space(); if (text[i++] !== ':') throw new Error(`Invalid JSON at ${path}`);
|
|
24
|
+
value(`${path}.${key}`); space();
|
|
25
|
+
const end = text[i++]; if (end === '}') return; if (end !== ',') throw new Error(`Invalid JSON at ${path}`);
|
|
26
|
+
}
|
|
27
|
+
} else if (text[i] === '[') {
|
|
28
|
+
i++; space(); if (text[i] === ']') { i++; return; }
|
|
29
|
+
let index = 0;
|
|
30
|
+
while (i < text.length) { value(`${path}[${index++}]`); space(); const end = text[i++]; if (end === ']') return; if (end !== ',') throw new Error(`Invalid JSON at ${path}`); }
|
|
31
|
+
} else if (text[i] === '"') { string(); return; }
|
|
32
|
+
else { const start = i; while (i < text.length && !/[\s,}\]]/.test(text[i])) i++; JSON.parse(text.slice(start, i)); return; }
|
|
33
|
+
throw new Error(`Invalid JSON at ${path}`);
|
|
34
|
+
};
|
|
35
|
+
value('$'); space(); if (i !== text.length) throw new Error('Invalid trailing JSON');
|
|
36
|
+
return JSON.parse(text);
|
|
37
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
// @ts-nocheck
|
|
2
|
+
// Caller-owned session I/O boundary; consumers use this snapshot, never legacy files.
|
|
3
|
+
import { closeSync, constants, fstatSync, lstatSync, openSync, readSync } from 'node:fs';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { normalizeSystem1Config } from './config-v2.js';
|
|
6
|
+
import { parseConfigJson } from './config-json.js';
|
|
7
|
+
import { system1SelectedByDesired } from './selection.js';
|
|
8
|
+
const MAX_CONFIG_BYTES = 1024 * 1024;
|
|
9
|
+
const sameFile = (a, b) => a.dev === b.dev && a.ino === b.ino;
|
|
10
|
+
function readWorkspaceJson(root, name) {
|
|
11
|
+
let fd;
|
|
12
|
+
try {
|
|
13
|
+
const parent = join(root, '.ai');
|
|
14
|
+
const parentStat = lstatSync(parent);
|
|
15
|
+
if (!parentStat.isDirectory()) return null;
|
|
16
|
+
const path = join(parent, name);
|
|
17
|
+
const stat = lstatSync(path);
|
|
18
|
+
if (!stat.isFile() || stat.size > MAX_CONFIG_BYTES) return null;
|
|
19
|
+
if (typeof constants.O_NOFOLLOW !== 'number') return null;
|
|
20
|
+
fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
21
|
+
const opened = fstatSync(fd);
|
|
22
|
+
const currentParent = lstatSync(parent);
|
|
23
|
+
if (!opened.isFile() || opened.size > MAX_CONFIG_BYTES || !sameFile(stat, opened) || !currentParent.isDirectory() || !sameFile(parentStat, currentParent)) return null;
|
|
24
|
+
// Bound actual reads as well as metadata: a concurrently growing file is refused.
|
|
25
|
+
const buffer = Buffer.alloc(MAX_CONFIG_BYTES + 1);
|
|
26
|
+
let length = 0, count;
|
|
27
|
+
while (length < buffer.length && (count = readSync(fd, buffer, length, buffer.length - length, null)) > 0) length += count;
|
|
28
|
+
if (length > MAX_CONFIG_BYTES) return null;
|
|
29
|
+
const after = fstatSync(fd);
|
|
30
|
+
if (opened.size !== after.size || opened.mtimeMs !== after.mtimeMs || opened.ctimeMs !== after.ctimeMs) return null;
|
|
31
|
+
return parseConfigJson(buffer.toString('utf8', 0, length));
|
|
32
|
+
} catch (error) { return error.code === 'ENOENT' ? undefined : null; }
|
|
33
|
+
finally { if (fd !== undefined) closeSync(fd); }
|
|
34
|
+
}
|
|
35
|
+
export function readSystem1Document(root) { return readWorkspaceJson(root, 'system1.json'); }
|
|
36
|
+
export function loadSystem1Snapshot(root) { return normalizeSystem1Config(readSystem1Document(root)); }
|
|
37
|
+
export function readSystem1Selected(root) {
|
|
38
|
+
return system1SelectedByDesired(readWorkspaceJson(root, 'agent-fleet.json'));
|
|
39
|
+
}
|
|
40
|
+
export function providerDocument(snapshot) {
|
|
41
|
+
if (snapshot.status === 'missing') return undefined;
|
|
42
|
+
if (snapshot.status === 'migration_required') return snapshot.legacyProvider;
|
|
43
|
+
return snapshot.provider ?? null;
|
|
44
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// Pure configuration validation shared by Node CLI and Hub.
|
|
2
|
+
// @ts-nocheck
|
|
3
|
+
const safePath = (path) => typeof path === "string" && path.length > 0 && path.length <= 256 && !path.includes("\\") && !path.includes("\0") && !path.startsWith("/") && path.split("/").every(s => !!s && s !== "." && s !== ".." && !s.startsWith("."));
|
|
4
|
+
const safeRulePath = (path) => typeof path === "string" && path.startsWith(".ai/") ? safePath(path.slice(4)) : safePath(path);
|
|
5
|
+
const exact = (v, keys) => typeof v === "object" && v !== null && !Array.isArray(v) && Object.keys(v).every(k => keys.includes(k)) && keys.every(k => k in v);
|
|
6
|
+
const paths = (v) => Array.isArray(v) && v.length <= 32 && v.every(safePath) && new Set(v).size === v.length;
|
|
7
|
+
const safeBasename = (v) => typeof v === "string" && safePath(v) && !v.includes("/") && !v.includes("*") && !v.includes("?");
|
|
8
|
+
export function parseLocalBindings(value) {
|
|
9
|
+
if (!Array.isArray(value) || value.length > 16)
|
|
10
|
+
throw new Error("Invalid local bindings");
|
|
11
|
+
return Object.freeze(value.map((item) => {
|
|
12
|
+
if (!exact(item, ["version", "validator", "rule", "applicability", "exceptions", "placement"]) && !exact(item, ["version", "validator", "rule", "applicability", "exceptions"]))
|
|
13
|
+
throw new Error("Invalid local binding schema");
|
|
14
|
+
const b = item;
|
|
15
|
+
if (b.version !== 1 || !["relative-markdown-links", "new-file-placement"].includes(b.validator) ||
|
|
16
|
+
!exact(b.rule, ["path", "heading", "occurrence", "hash"]) || !safeRulePath(b.rule.path) || !b.rule.path.endsWith(".md") ||
|
|
17
|
+
typeof b.rule.heading !== "string" || !b.rule.heading.trim() || b.rule.heading.length > 200 || !Number.isSafeInteger(b.rule.occurrence) || b.rule.occurrence < 1 || !/^[a-f0-9]{64}$/.test(b.rule.hash) ||
|
|
18
|
+
(!exact(b.applicability, ["paths", "kinds"]) && !exact(b.applicability, ["paths", "kinds", "basename"])) || (b.applicability.basename !== undefined && (!safeBasename(b.applicability.basename) || !b.applicability.paths.includes(b.applicability.basename))) || !paths(b.applicability.paths) || !b.applicability.paths.length || !Array.isArray(b.applicability.kinds) || !b.applicability.kinds.length || new Set(b.applicability.kinds).size !== b.applicability.kinds.length || !b.applicability.kinds.every(k => k === "added" || k === "modified") ||
|
|
19
|
+
!exact(b.exceptions, ["paths", "legacy"]) || !paths(b.exceptions.paths) || typeof b.exceptions.legacy !== "boolean" ||
|
|
20
|
+
(b.validator === "new-file-placement" ? !exact(b.placement, ["prefix"]) || !safePath(b.placement.prefix) || b.applicability.kinds.some(k => k !== "added") : b.placement !== undefined))
|
|
21
|
+
throw new Error("Invalid local binding values");
|
|
22
|
+
return Object.freeze({ version: 1, validator: b.validator, rule: Object.freeze({ ...b.rule }), applicability: Object.freeze({ paths: Object.freeze([...b.applicability.paths]), kinds: Object.freeze([...b.applicability.kinds]), ...(b.applicability.basename === undefined ? {} : { basename: b.applicability.basename }) }), exceptions: Object.freeze({ paths: Object.freeze([...b.exceptions.paths]), legacy: b.exceptions.legacy }), ...(b.placement ? { placement: Object.freeze({ ...b.placement }) } : {}) });
|
|
23
|
+
}));
|
|
24
|
+
}
|
|
25
|
+
const DEFAULT_BUDGET = 100;
|
|
26
|
+
export const PROACTIVE_LIMITS = Object.freeze({ maxUnits: 20, maxRetainedBytes: 256 * 1024, maxStateBytes: 32 * 1024, maxQuestions: 16, maxCallsPerTurn: 2, captureMs: 1000, maxFileBytes: 64 * 1024 });
|
|
27
|
+
const keys = new Set(["version", "mode", "remoteContext", "include", "maxEvaluationsPerSession", "localBindings"]);
|
|
28
|
+
const OFF = Object.freeze({ version: 1, mode: "off", remoteContext: "disabled", include: Object.freeze([]), maxEvaluationsPerSession: 0 });
|
|
29
|
+
function includePath(value) {
|
|
30
|
+
if (typeof value !== "string" || !value || value.length > 256 || value.startsWith("/") || value.startsWith(".") || value.includes("\\") || value.includes("\0") || /[{}!\[\]?]/.test(value))
|
|
31
|
+
return false;
|
|
32
|
+
const segments = value.split("/");
|
|
33
|
+
return segments.every(s => !!s && s !== ".." && s !== "." && !s.startsWith(".")) && !segments.some(s => /^(node_modules|vendor|dist|build|coverage|\.git|\.pi)$/i.test(s)) && (segments.length > 1 || !value.includes("*"));
|
|
34
|
+
}
|
|
35
|
+
export function parseProactiveConfig(value) {
|
|
36
|
+
if (typeof value !== "object" || value === null || Array.isArray(value))
|
|
37
|
+
throw new Error("Invalid proactive review config");
|
|
38
|
+
const v = value;
|
|
39
|
+
if (Object.keys(v).some(k => !keys.has(k)) || v.version !== 1 || !["off", "shadow", "advisory"].includes(String(v.mode)))
|
|
40
|
+
throw new Error("Unsupported proactive review config");
|
|
41
|
+
if (v.remoteContext !== undefined && v.remoteContext !== "disabled" && v.remoteContext !== "selected-excerpts")
|
|
42
|
+
throw new Error("Invalid remoteContext");
|
|
43
|
+
if (v.include !== undefined && (!Array.isArray(v.include) || v.include.length > 32 || !v.include.every(includePath) || new Set(v.include).size !== v.include.length))
|
|
44
|
+
throw new Error("Invalid include scope");
|
|
45
|
+
const bindings = v.localBindings === undefined ? undefined : parseLocalBindings(v.localBindings);
|
|
46
|
+
const budget = v.maxEvaluationsPerSession ?? DEFAULT_BUDGET;
|
|
47
|
+
if (!Number.isSafeInteger(budget) || Number(budget) < 0 || Number(budget) > 100)
|
|
48
|
+
throw new Error("Invalid session budget");
|
|
49
|
+
if (v.mode === "off") {
|
|
50
|
+
if ((v.remoteContext && v.remoteContext !== "disabled") || (Array.isArray(v.include) && v.include.length) || bindings?.length || (v.maxEvaluationsPerSession !== undefined && budget !== 0))
|
|
51
|
+
throw new Error("Off config must not authorize capture");
|
|
52
|
+
return OFF;
|
|
53
|
+
}
|
|
54
|
+
if (!Array.isArray(v.include) || !v.include.length)
|
|
55
|
+
throw new Error("Explicit include scope required");
|
|
56
|
+
return Object.freeze({ version: 1, mode: v.mode, remoteContext: (v.remoteContext ?? "disabled"), include: Object.freeze([...v.include]), maxEvaluationsPerSession: Number(budget), ...(bindings ? { localBindings: bindings } : {}) });
|
|
57
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
// Pure configuration validation shared by Node CLI and Hub.
|
|
2
|
+
// @ts-nocheck
|
|
3
|
+
export const TRIAGE_VERSION = "dispatch-triage/v1";
|
|
4
|
+
export const TASK_TRIAGE_QUESTION_VERSION = "task-triage/questions/v1";
|
|
5
|
+
export const TASK_TRIAGE_POLICY_VERSION = "task-triage/policy/v1";
|
|
6
|
+
export const TASK_TRIAGE_STATE_VERSION = "task-triage/state/v1";
|
|
7
|
+
export const TASK_TRIAGE_PROVIDER = "typesafe";
|
|
8
|
+
export const TASK_TRIAGE_MODEL = "jev-1.13.0";
|
|
9
|
+
export const TASK_TRIAGE_LIMITS = Object.freeze({ maxTaskBytes: 40 * 1024, maxStateBytes: 64 * 1024, maxCallsPerSession: 100, timeoutMs: 2000 });
|
|
10
|
+
export function validProfile(p) {
|
|
11
|
+
const x = p;
|
|
12
|
+
return !!x && x.version === TRIAGE_VERSION && x.approved === true && typeof x.evidence === "string" && !!x.evidence.trim()
|
|
13
|
+
&& typeof x.provider === "string" && !!x.provider && typeof x.model === "string" && !!x.model
|
|
14
|
+
&& [x.languages, x.domains].every(v => Array.isArray(v) && v.length > 0 && v.every(s => typeof s === "string" && !!s))
|
|
15
|
+
&& [x.minConfidence, x.minMargin, x.securityThreshold, x.destructiveThreshold].every(v => typeof v === "number" && Number.isFinite(v) && v >= 0 && v <= 1);
|
|
16
|
+
}
|
|
17
|
+
export function parseTriageConfig(value) {
|
|
18
|
+
const c = value;
|
|
19
|
+
if (!c || typeof c !== "object" || Array.isArray(c) || Object.keys(c).some(k => !["version", "mode", "remoteContextApproved", "maxCalls", "maxStateBytes", "maxTaskBytes", "maxRoleBytes", "profile", "orchestratorBeforeDispatch"].includes(k)) || c.version !== 1 || !["off", "shadow", "advisory"].includes(c.mode) || typeof c.remoteContextApproved !== "boolean")
|
|
20
|
+
return null;
|
|
21
|
+
if (![c.maxCalls, c.maxStateBytes, c.maxTaskBytes, c.maxRoleBytes].every(n => Number.isSafeInteger(n) && n > 0))
|
|
22
|
+
return null;
|
|
23
|
+
if (c.profile !== undefined && !validProfile(c.profile))
|
|
24
|
+
return null;
|
|
25
|
+
if (c.orchestratorBeforeDispatch !== undefined && typeof c.orchestratorBeforeDispatch !== "boolean")
|
|
26
|
+
return null;
|
|
27
|
+
return JSON.parse(JSON.stringify(c));
|
|
28
|
+
}
|
|
29
|
+
const keys = ["version", "mode", "remoteContextApproved", "provider", "model", "questionVersion", "policyVersion", "limits"];
|
|
30
|
+
export function parseTaskTriageConfig(value) {
|
|
31
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
32
|
+
return { status: "invalid" };
|
|
33
|
+
const x = value;
|
|
34
|
+
if (Object.keys(x).some(k => !keys.includes(k)) || x.version !== 1 || (x.mode !== "off" && x.mode !== "experimental") || typeof x.remoteContextApproved !== "boolean" || x.provider !== TASK_TRIAGE_PROVIDER || x.model !== TASK_TRIAGE_MODEL || x.questionVersion !== TASK_TRIAGE_QUESTION_VERSION || x.policyVersion !== TASK_TRIAGE_POLICY_VERSION || !x.limits || typeof x.limits !== "object" || Array.isArray(x.limits))
|
|
35
|
+
return { status: "invalid" };
|
|
36
|
+
const limits = x.limits;
|
|
37
|
+
if (Object.keys(limits).length !== Object.keys(TASK_TRIAGE_LIMITS).length || Object.entries(TASK_TRIAGE_LIMITS).some(([k, v]) => limits[k] !== v))
|
|
38
|
+
return { status: "invalid" };
|
|
39
|
+
if (x.mode === "off")
|
|
40
|
+
return x.remoteContextApproved ? { status: "invalid" } : { status: "off" };
|
|
41
|
+
return x.remoteContextApproved ? { status: "active", config: x } : { status: "off" };
|
|
42
|
+
}
|