@chankov/agent-fleet 0.0.5 → 0.0.7
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/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +133 -74
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +61 -12
- package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +970 -406
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +30 -4
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +6 -5
- package/.pi/harnesses/coms/index.ts +92 -70
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +9 -9
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
- package/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +198 -40
- package/agents/code-reviewer.md +2 -2
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +60 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +67 -15
- package/docs/agent-fleet-setup.md +13 -13
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +18 -8
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/docs/npm-install.md +21 -21
- package/docs/pi-extensions.md +7 -7
- package/docs/pi-setup.md +51 -47
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/references/fleet-coordination-patterns.md +2 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +16 -14
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- /package/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import {
|
|
2
|
+
accessDecisionChoices,
|
|
3
|
+
accessRequestCacheKey,
|
|
4
|
+
appendExemptionToFile,
|
|
5
|
+
fileExemptionsFor,
|
|
6
|
+
type AccessDecision,
|
|
7
|
+
type AccessDecisionChoice,
|
|
8
|
+
type AccessRequest,
|
|
9
|
+
} from "../lib/damage-control-shared.ts";
|
|
10
|
+
|
|
11
|
+
type ApprovalContext = {
|
|
12
|
+
hasUI: boolean;
|
|
13
|
+
ui: {
|
|
14
|
+
notify(message: string, level?: string): void;
|
|
15
|
+
select(title: string, options: string[], settings: { timeout: number }): Promise<string | undefined>;
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
type ReplySocket = {
|
|
20
|
+
write(chunk: string): unknown;
|
|
21
|
+
end(): unknown;
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
type AccessApprovalDeps = {
|
|
25
|
+
getContext(): ApprovalContext | null | undefined;
|
|
26
|
+
getExemptionsFile(): string | null | undefined;
|
|
27
|
+
appendLog(entry: Record<string, unknown>): void;
|
|
28
|
+
now(): string;
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
export function createAccessApprovalRouter(deps: AccessApprovalDeps) {
|
|
32
|
+
let askQueue: Promise<unknown> = Promise.resolve();
|
|
33
|
+
let generation = 0;
|
|
34
|
+
const denyCache = new Set<string>();
|
|
35
|
+
const pending = new Map<string, Promise<AccessDecisionChoice>>();
|
|
36
|
+
|
|
37
|
+
const respond = (socket: ReplySocket, msgId: string, decision: AccessDecisionChoice) => {
|
|
38
|
+
const reply: AccessDecision = { type: "access_decision", msg_id: msgId, decision };
|
|
39
|
+
try { socket.write(JSON.stringify(reply) + "\n"); } catch { /* child may have timed out */ }
|
|
40
|
+
try { socket.end(); } catch { /* ignore */ }
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
const validRequest = (request: AccessRequest) =>
|
|
44
|
+
typeof request.pattern === "string" && request.pattern.length > 0 &&
|
|
45
|
+
(request.category === "zero_access" || request.category === "read_only" || request.category === "no_delete");
|
|
46
|
+
|
|
47
|
+
const decide = (request: AccessRequest): Promise<AccessDecisionChoice> => {
|
|
48
|
+
const agent = (typeof request.agent === "string" && request.agent) || request.sender_session || "unknown-agent";
|
|
49
|
+
const pattern = request.pattern;
|
|
50
|
+
const cacheKey = accessRequestCacheKey({ ...request, agent, pattern });
|
|
51
|
+
const exemptionsFile = deps.getExemptionsFile();
|
|
52
|
+
const requestGeneration = generation;
|
|
53
|
+
|
|
54
|
+
if (fileExemptionsFor(exemptionsFile ?? undefined, agent).some((entry) => entry.pattern === pattern)) {
|
|
55
|
+
return Promise.resolve("allow_all");
|
|
56
|
+
}
|
|
57
|
+
if (denyCache.has(cacheKey)) return Promise.resolve("deny");
|
|
58
|
+
const existing = pending.get(cacheKey);
|
|
59
|
+
if (existing) return existing;
|
|
60
|
+
|
|
61
|
+
const ask = askQueue.then(async (): Promise<AccessDecisionChoice> => {
|
|
62
|
+
if (requestGeneration !== generation) return "deny";
|
|
63
|
+
const ctx = deps.getContext();
|
|
64
|
+
if (!ctx?.hasUI) return "deny";
|
|
65
|
+
|
|
66
|
+
const labels = new Map<AccessDecisionChoice, string>([
|
|
67
|
+
["deny", "Deny (keep blocked)"],
|
|
68
|
+
["allow_once", "Allow once"],
|
|
69
|
+
["allow_agent", `Allow for ${agent} (this session)`],
|
|
70
|
+
["allow_all", "Allow for all agents (this session)"],
|
|
71
|
+
]);
|
|
72
|
+
const allowed = accessDecisionChoices(request.category);
|
|
73
|
+
const options = allowed.map((decision) => labels.get(decision)!);
|
|
74
|
+
ctx.ui.notify(
|
|
75
|
+
`🛡️ Access request from ${agent}: ${request.rule}\n tool: ${request.tool}\n attempted: ${String(request.invocation || "").slice(0, 200)}`,
|
|
76
|
+
"warning",
|
|
77
|
+
);
|
|
78
|
+
try {
|
|
79
|
+
const choice = await ctx.ui.select(
|
|
80
|
+
`🛡️ ${agent} requests access: ${pattern}`,
|
|
81
|
+
options,
|
|
82
|
+
{ timeout: 600_000 },
|
|
83
|
+
);
|
|
84
|
+
if (requestGeneration !== generation) return "deny";
|
|
85
|
+
const selected = allowed.find((decision) => labels.get(decision) === choice) ?? "deny";
|
|
86
|
+
if (selected === "deny" && choice === labels.get("deny")) denyCache.add(cacheKey);
|
|
87
|
+
return selected;
|
|
88
|
+
} catch {
|
|
89
|
+
return "deny";
|
|
90
|
+
}
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
askQueue = ask.catch(() => {});
|
|
94
|
+
pending.set(cacheKey, ask);
|
|
95
|
+
void ask.finally(() => pending.delete(cacheKey));
|
|
96
|
+
return ask;
|
|
97
|
+
};
|
|
98
|
+
|
|
99
|
+
return {
|
|
100
|
+
async handle(socket: ReplySocket, request: AccessRequest): Promise<void> {
|
|
101
|
+
if (!validRequest(request)) {
|
|
102
|
+
respond(socket, request.msg_id, "deny");
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
const agent = (typeof request.agent === "string" && request.agent) || request.sender_session || "unknown-agent";
|
|
106
|
+
const decision = await decide(request).catch((): AccessDecisionChoice => "deny");
|
|
107
|
+
const exemptionsFile = deps.getExemptionsFile();
|
|
108
|
+
if ((decision === "allow_agent" || decision === "allow_all") && exemptionsFile) {
|
|
109
|
+
try {
|
|
110
|
+
appendExemptionToFile(exemptionsFile, {
|
|
111
|
+
pattern: request.pattern,
|
|
112
|
+
scope: "session",
|
|
113
|
+
agent: decision === "allow_agent" ? agent : undefined,
|
|
114
|
+
grantedVia: "escalation",
|
|
115
|
+
grantedAt: deps.now(),
|
|
116
|
+
});
|
|
117
|
+
} catch { /* allow-once semantics still hold via the reply */ }
|
|
118
|
+
}
|
|
119
|
+
deps.appendLog({ action: `escalation_${decision}`, agent, pattern: request.pattern, tool: request.tool, rule: request.rule });
|
|
120
|
+
try {
|
|
121
|
+
deps.getContext()?.ui.notify(
|
|
122
|
+
`🛡️ Access ${decision === "deny" ? "denied" : `granted (${decision.replace(/_/g, " ")})`}: ${request.pattern} — ${agent}`,
|
|
123
|
+
decision === "deny" ? "warning" : "info",
|
|
124
|
+
);
|
|
125
|
+
} catch { /* ignore */ }
|
|
126
|
+
respond(socket, request.msg_id, decision);
|
|
127
|
+
},
|
|
128
|
+
reset() {
|
|
129
|
+
generation++;
|
|
130
|
+
askQueue = Promise.resolve();
|
|
131
|
+
denyCache.clear();
|
|
132
|
+
pending.clear();
|
|
133
|
+
},
|
|
134
|
+
};
|
|
135
|
+
}
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
import { isAbsolute, relative, resolve, sep } from "node:path";
|
|
2
|
+
|
|
3
|
+
// `failures` is deliberately its own kind, not a flavour of `returns`: a run
|
|
4
|
+
// that errored or timed out produced no specialist result, and storing its error
|
|
5
|
+
// text as a return is the most expensive artifact in the system — a 142-byte
|
|
6
|
+
// coms error stub written to returns/code-reviewer-run4.md cost a full dispatch
|
|
7
|
+
// investigating a review that had in fact succeeded, only its reply was lost.
|
|
8
|
+
export const ARTIFACT_KINDS = ["returns", "failures", "plans", "reviews", "inventories", "evidence"];
|
|
9
|
+
|
|
10
|
+
const SESSION_RELATIVE_PREFIXES = new Set(["artifacts", "findings", "delegations"]);
|
|
11
|
+
const PREVIEW_LIMIT = 180;
|
|
12
|
+
|
|
13
|
+
export function resolveArtifactPath(inputPath, options) {
|
|
14
|
+
const raw = String(inputPath || "").trim();
|
|
15
|
+
if (!raw) throw new Error("Artifact path must be a non-empty string");
|
|
16
|
+
if (/\0/.test(raw)) throw new Error(`Invalid artifact path ${JSON.stringify(raw)}`);
|
|
17
|
+
|
|
18
|
+
const repoDir = resolve(options.repoDir);
|
|
19
|
+
const sessionDir = resolve(options.sessionDir);
|
|
20
|
+
const artifactRoot = options.artifactRoot ? resolve(options.artifactRoot) : resolve(sessionDir, "artifacts");
|
|
21
|
+
const normalized = raw.replace(/\\/g, "/").replace(/^\.\//, "");
|
|
22
|
+
|
|
23
|
+
const candidates = [];
|
|
24
|
+
if (isAbsolute(raw)) {
|
|
25
|
+
const absoluteTarget = resolve(raw);
|
|
26
|
+
if (isWithin(artifactRoot, absoluteTarget)) {
|
|
27
|
+
candidates.push({ root: artifactRoot, target: absoluteTarget, displayBase: artifactRoot, prefix: "artifacts" });
|
|
28
|
+
} else if (isWithin(sessionDir, absoluteTarget)) {
|
|
29
|
+
candidates.push({ root: sessionDir, target: absoluteTarget, displayBase: sessionDir, prefix: ".pi/agent-sessions" });
|
|
30
|
+
}
|
|
31
|
+
candidates.push({ root: repoDir, target: absoluteTarget, displayBase: repoDir, prefix: "" });
|
|
32
|
+
} else {
|
|
33
|
+
const first = normalized.split("/")[0];
|
|
34
|
+
if (first === "artifacts") {
|
|
35
|
+
candidates.push({ root: sessionDir, target: safeJoin(sessionDir, normalized), displayBase: artifactRoot, prefix: "artifacts" });
|
|
36
|
+
} else if (ARTIFACT_KINDS.includes(first)) {
|
|
37
|
+
candidates.push({ root: artifactRoot, target: safeJoin(artifactRoot, normalized), displayBase: artifactRoot, prefix: "artifacts" });
|
|
38
|
+
candidates.push({ root: repoDir, target: safeJoin(repoDir, normalized), displayBase: repoDir, prefix: "" });
|
|
39
|
+
} else if (SESSION_RELATIVE_PREFIXES.has(first)) {
|
|
40
|
+
candidates.push({ root: sessionDir, target: safeJoin(sessionDir, normalized), displayBase: sessionDir, prefix: ".pi/agent-sessions" });
|
|
41
|
+
} else {
|
|
42
|
+
candidates.push({ root: repoDir, target: safeJoin(repoDir, normalized), displayBase: repoDir, prefix: "" });
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
const valid = candidates.filter((candidate) => isWithin(candidate.root, candidate.target));
|
|
47
|
+
if (valid.length === 0) {
|
|
48
|
+
throw new Error(`Refusing artifact path outside repo/session: ${raw}`);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
const exists = typeof options.exists === "function" ? options.exists : () => true;
|
|
52
|
+
const found = valid.find((candidate) => exists(candidate.target));
|
|
53
|
+
if (found) {
|
|
54
|
+
return {
|
|
55
|
+
input: raw,
|
|
56
|
+
path: found.target,
|
|
57
|
+
displayPath: displayPath(found.target, found.displayBase, found.prefix),
|
|
58
|
+
resolvedFromKind: null,
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
// Nothing at the requested path. The hub writes EVERY auto-return under
|
|
63
|
+
// `returns/`, while the deliverable protocol teaches dispatchers that documents
|
|
64
|
+
// live in `artifacts/<kind>/` — so `reviews/code-reviewer-run1.md` is the
|
|
65
|
+
// natural and wrong guess for a file that is sitting in `returns/`. Look for
|
|
66
|
+
// the same name under the other kinds instead of reporting a missing file.
|
|
67
|
+
const requested = matchKindPath(normalized);
|
|
68
|
+
if (requested) {
|
|
69
|
+
const hits = ARTIFACT_KINDS
|
|
70
|
+
.filter((kind) => kind !== requested.kind)
|
|
71
|
+
.map((kind) => ({ kind, target: resolve(artifactRoot, `${kind}/${requested.rest}`) }))
|
|
72
|
+
.filter((candidate) => isWithin(artifactRoot, candidate.target) && exists(candidate.target));
|
|
73
|
+
if (hits.length === 1) {
|
|
74
|
+
return {
|
|
75
|
+
input: raw,
|
|
76
|
+
path: hits[0].target,
|
|
77
|
+
displayPath: displayPath(hits[0].target, artifactRoot, "artifacts"),
|
|
78
|
+
resolvedFromKind: hits[0].kind,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
// Never guess between kinds: two files with the same name are two documents.
|
|
82
|
+
if (hits.length > 1) {
|
|
83
|
+
throw new Error(
|
|
84
|
+
`Ambiguous artifact ${raw}: "${requested.rest}" exists under ${hits.map((h) => `${h.kind}/`).join(" and ")}. ` +
|
|
85
|
+
"Name the kind explicitly.",
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
const picked = valid[0];
|
|
91
|
+
return {
|
|
92
|
+
input: raw,
|
|
93
|
+
path: picked.target,
|
|
94
|
+
displayPath: displayPath(picked.target, picked.displayBase, picked.prefix),
|
|
95
|
+
resolvedFromKind: null,
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** `reviews/x.md` / `artifacts/reviews/x.md` → `{ kind: "reviews", rest: "x.md" }`. */
|
|
100
|
+
function matchKindPath(normalized) {
|
|
101
|
+
const parts = String(normalized || "").split("/").filter(Boolean);
|
|
102
|
+
const offset = parts[0] === "artifacts" ? 1 : 0;
|
|
103
|
+
const kind = parts[offset];
|
|
104
|
+
if (!ARTIFACT_KINDS.includes(kind)) return null;
|
|
105
|
+
const rest = parts.slice(offset + 1).join("/");
|
|
106
|
+
return rest ? { kind, rest } : null;
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export function resolveArtifactPaths(paths, options) {
|
|
110
|
+
return (paths || []).map((p) => resolveArtifactPath(p, options));
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export function artifactPreviewFromText(text) {
|
|
114
|
+
const lines = String(text || "").split(/\r?\n/);
|
|
115
|
+
const heading = lines.map((line) => line.trim()).find((line) => /^#{1,6}\s+\S/.test(line));
|
|
116
|
+
if (heading) return truncate(heading.replace(/^#{1,6}\s+/, ""));
|
|
117
|
+
const first = lines.map((line) => line.trim()).find(Boolean);
|
|
118
|
+
return first ? truncate(first) : "(empty file)";
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export function formatInputArtifactsSection(items) {
|
|
122
|
+
if (!items || items.length === 0) return "";
|
|
123
|
+
const lines = items.map((item) => `- ${item.displayPath || item.path} — ${item.preview || "(no preview)"}`);
|
|
124
|
+
return `\n\n## Input artifacts\nRead these files with your own read tool when needed. The dispatcher is passing paths plus a one-line preview only; file bodies are intentionally not inlined.\n${lines.join("\n")}`;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function safeJoin(root, relativePath) {
|
|
128
|
+
const target = resolve(root, relativePath);
|
|
129
|
+
if (!isWithin(root, target)) throw new Error(`Refusing artifact path outside repo/session: ${relativePath}`);
|
|
130
|
+
return target;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function isWithin(root, target) {
|
|
134
|
+
const rel = relative(resolve(root), resolve(target));
|
|
135
|
+
return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel));
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function displayPath(target, base, prefix) {
|
|
139
|
+
const rel = relative(resolve(base), resolve(target)).split(sep).join("/");
|
|
140
|
+
if (!prefix) return rel || ".";
|
|
141
|
+
return rel ? `${prefix}/${rel}` : prefix;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
function truncate(value) {
|
|
145
|
+
return value.length > PREVIEW_LIMIT ? `${value.slice(0, PREVIEW_LIMIT - 1)}…` : value;
|
|
146
|
+
}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
// Assertion-ledger contract — pure validation for the `set_assertions` tool.
|
|
2
|
+
//
|
|
3
|
+
// Two rules, both drawn from the post-mortem of the hub sessions that declared
|
|
4
|
+
// 30 assertions (GO1–GO5, A1–A25) in one call and then spent a dispatch plus an
|
|
5
|
+
// ASK_USER cycle answering "where were A9–A16 defined?":
|
|
6
|
+
//
|
|
7
|
+
// 1. Every assertion names its origin, so an id can always be traced back to
|
|
8
|
+
// the plan/spec line it came from. Refused when missing — a sourceless id
|
|
9
|
+
// is exactly the failure that cost the cycle.
|
|
10
|
+
// 2. The open ledger is capped at MAX_OPEN_ASSERTIONS per batch. Warned, not
|
|
11
|
+
// refused: a large task legitimately has many assertions, they just should
|
|
12
|
+
// not all be open at once. Declare the rest when their batch starts.
|
|
13
|
+
|
|
14
|
+
export const MAX_OPEN_ASSERTIONS = 8;
|
|
15
|
+
|
|
16
|
+
const str = (v) => String(v ?? "").trim();
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Validate + normalize one `set_assertions` batch.
|
|
20
|
+
* Returns { ok, refusal?, warning, assertions } — `assertions` is empty on a
|
|
21
|
+
* refusal so a rejected batch can never half-replace the live ledger.
|
|
22
|
+
*/
|
|
23
|
+
export function validateAssertionBatch(input) {
|
|
24
|
+
const batch = Array.isArray(input) ? input : [];
|
|
25
|
+
|
|
26
|
+
const sourceless = batch
|
|
27
|
+
.map((a, i) => (str(a?.source) === "" ? str(a?.id) || `#${i + 1}` : null))
|
|
28
|
+
.filter((label) => label !== null);
|
|
29
|
+
|
|
30
|
+
if (sourceless.length > 0) {
|
|
31
|
+
return {
|
|
32
|
+
ok: false,
|
|
33
|
+
refusal:
|
|
34
|
+
`Ledger unchanged: ${sourceless.length} assertion(s) declare no source — ${sourceless.join(", ")}. ` +
|
|
35
|
+
"Every assertion must name where it comes from (e.g. source: \"PLAN-x.md:585-595\", " +
|
|
36
|
+
"\"user request\", \"review finding F3\") so a specialist asked to prove it can read the origin " +
|
|
37
|
+
"instead of asking. Re-send the batch with a source on each.",
|
|
38
|
+
warning: null,
|
|
39
|
+
assertions: [],
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const assertions = batch.map((a) => ({
|
|
44
|
+
id: str(a?.id),
|
|
45
|
+
tag: str(a?.tag),
|
|
46
|
+
text: str(a?.text),
|
|
47
|
+
source: str(a?.source),
|
|
48
|
+
}));
|
|
49
|
+
|
|
50
|
+
const warning =
|
|
51
|
+
assertions.length > MAX_OPEN_ASSERTIONS
|
|
52
|
+
? `⚠ ${assertions.length} assertions are open at once (soft cap ${MAX_OPEN_ASSERTIONS}). ` +
|
|
53
|
+
"Keep this batch to the assertions the next dispatches actually prove and defer the rest — " +
|
|
54
|
+
"declare them with a fresh set_assertions when their batch starts. Accepted as-is."
|
|
55
|
+
: null;
|
|
56
|
+
|
|
57
|
+
return { ok: true, warning, assertions };
|
|
58
|
+
}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
// Dispatch backend policy — pure logic for routing dispatch_agent calls to a
|
|
2
|
+
// native pi subagent or a same-name coms peer (.pi/agents/dispatch-policy.yaml).
|
|
3
|
+
// Parsing + resolution only: no I/O, no pi imports, testable under node --test.
|
|
4
|
+
// The wiring (pool lookup, envelope send, fallback spawn) lives in index.ts.
|
|
5
|
+
|
|
6
|
+
const NAME_RE = /^[A-Za-z0-9_-]+$/;
|
|
7
|
+
const DEFAULT_GRACE_S = 30;
|
|
8
|
+
|
|
9
|
+
export const DEFAULT_POLICY = Object.freeze({
|
|
10
|
+
default: "native",
|
|
11
|
+
grace_s: DEFAULT_GRACE_S,
|
|
12
|
+
substitutions: {},
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
function stripComment(line) {
|
|
16
|
+
// Values in this file never contain '#'; a minimal comment strip is enough.
|
|
17
|
+
const i = line.indexOf("#");
|
|
18
|
+
return i < 0 ? line : line.slice(0, i);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
// Minimal parser for the specific dispatch-policy.yaml shape:
|
|
22
|
+
// default: native | coms
|
|
23
|
+
// grace_s: <seconds>
|
|
24
|
+
// substitutions:
|
|
25
|
+
// <member>:
|
|
26
|
+
// prefer: native | coms
|
|
27
|
+
// fallback: native | none
|
|
28
|
+
// timeout_s: <seconds>
|
|
29
|
+
// Not a general YAML parser; tolerant of comments and blank lines only.
|
|
30
|
+
// Never throws: malformed input degrades to DEFAULT_POLICY pieces, with a
|
|
31
|
+
// warning per dropped construct so the hub can notify once.
|
|
32
|
+
export function parseDispatchPolicy(raw) {
|
|
33
|
+
const policy = { default: "native", grace_s: DEFAULT_GRACE_S, substitutions: {} };
|
|
34
|
+
const warnings = [];
|
|
35
|
+
if (typeof raw !== "string" || raw.trim() === "") return { policy, warnings };
|
|
36
|
+
|
|
37
|
+
let inSubstitutions = false;
|
|
38
|
+
let currentMember = null;
|
|
39
|
+
|
|
40
|
+
for (const rawLine of String(raw).split("\n")) {
|
|
41
|
+
const line = stripComment(rawLine.replace(/\s+$/, ""));
|
|
42
|
+
if (line.trim() === "") continue;
|
|
43
|
+
const indent = line.length - line.trimStart().length;
|
|
44
|
+
const content = line.trim();
|
|
45
|
+
const kv = content.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
|
|
46
|
+
if (!kv) {
|
|
47
|
+
warnings.push(`dispatch-policy: ignored unparseable line: ${content}`);
|
|
48
|
+
// Don't let fields after a broken member header leak into the previous member.
|
|
49
|
+
currentMember = null;
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
const [, key, value] = kv;
|
|
53
|
+
|
|
54
|
+
if (indent === 0) {
|
|
55
|
+
currentMember = null;
|
|
56
|
+
inSubstitutions = false;
|
|
57
|
+
if (key === "substitutions" && value === "") {
|
|
58
|
+
inSubstitutions = true;
|
|
59
|
+
} else if (key === "default") {
|
|
60
|
+
if (value === "native" || value === "coms") policy.default = value;
|
|
61
|
+
else warnings.push(`dispatch-policy: default must be native|coms, got "${value}"`);
|
|
62
|
+
} else if (key === "grace_s") {
|
|
63
|
+
const n = Number(value);
|
|
64
|
+
if (Number.isFinite(n) && n >= 0) policy.grace_s = Math.floor(n);
|
|
65
|
+
else warnings.push(`dispatch-policy: grace_s must be a non-negative number, got "${value}"`);
|
|
66
|
+
} else {
|
|
67
|
+
warnings.push(`dispatch-policy: unknown top-level key "${key}"`);
|
|
68
|
+
}
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
if (!inSubstitutions) continue;
|
|
73
|
+
|
|
74
|
+
// Member header (one indent level, no value).
|
|
75
|
+
if (value === "") {
|
|
76
|
+
if (NAME_RE.test(key)) {
|
|
77
|
+
currentMember = key.toLowerCase();
|
|
78
|
+
policy.substitutions[currentMember] = { prefer: "coms", fallback: "native" };
|
|
79
|
+
} else {
|
|
80
|
+
warnings.push(`dispatch-policy: invalid member name "${key}"`);
|
|
81
|
+
currentMember = null;
|
|
82
|
+
}
|
|
83
|
+
continue;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
// Member field (deeper indent, key: value).
|
|
87
|
+
if (!currentMember) {
|
|
88
|
+
warnings.push(`dispatch-policy: field "${key}" outside a member block`);
|
|
89
|
+
continue;
|
|
90
|
+
}
|
|
91
|
+
const sub = policy.substitutions[currentMember];
|
|
92
|
+
if (key === "prefer") {
|
|
93
|
+
if (value === "native" || value === "coms") sub.prefer = value;
|
|
94
|
+
else warnings.push(`dispatch-policy: ${currentMember}.prefer must be native|coms, got "${value}"`);
|
|
95
|
+
} else if (key === "fallback") {
|
|
96
|
+
if (value === "native" || value === "none") sub.fallback = value;
|
|
97
|
+
else warnings.push(`dispatch-policy: ${currentMember}.fallback must be native|none, got "${value}"`);
|
|
98
|
+
} else if (key === "timeout_s") {
|
|
99
|
+
const n = Number(value);
|
|
100
|
+
if (Number.isFinite(n) && n > 0) sub.timeout_s = Math.floor(n);
|
|
101
|
+
else warnings.push(`dispatch-policy: ${currentMember}.timeout_s must be a positive number, got "${value}"`);
|
|
102
|
+
} else {
|
|
103
|
+
warnings.push(`dispatch-policy: unknown field "${key}" for member ${currentMember}`);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
return { policy, warnings };
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
// Decide the backend for one dispatch. Pure: the caller supplies the CURRENT
|
|
111
|
+
// live pool peer names (peersInScope() at dispatch time — hub and peers boot
|
|
112
|
+
// in parallel, so this must never be cached from team activation).
|
|
113
|
+
//
|
|
114
|
+
// Returns one of:
|
|
115
|
+
// { backend: "native" }
|
|
116
|
+
// { backend: "native", comsMissedNotice: "<member> prefers a coms peer ..." }
|
|
117
|
+
// { backend: "coms", peerName, timeout_s? } — peerName is the pool's exact spelling
|
|
118
|
+
// { backend: "await-coms", grace_s } — coms-required, peer not live yet: poll, then refuse
|
|
119
|
+
export function resolveDispatchBackend({ agentName, policy, livePeerNames }) {
|
|
120
|
+
const p = policy && typeof policy === "object" ? policy : DEFAULT_POLICY;
|
|
121
|
+
const name = String(agentName || "").toLowerCase();
|
|
122
|
+
const sub = (p.substitutions || {})[name];
|
|
123
|
+
const prefer = sub ? sub.prefer : p.default === "coms" ? "coms" : "native";
|
|
124
|
+
if (prefer !== "coms") return { backend: "native" };
|
|
125
|
+
|
|
126
|
+
const live = Array.isArray(livePeerNames) ? livePeerNames : [];
|
|
127
|
+
const match = live.find((n) => String(n).toLowerCase() === name);
|
|
128
|
+
if (match !== undefined) {
|
|
129
|
+
const out = { backend: "coms", peerName: String(match) };
|
|
130
|
+
if (sub && sub.timeout_s) out.timeout_s = sub.timeout_s;
|
|
131
|
+
return out;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
if (sub && sub.fallback === "none") {
|
|
135
|
+
return { backend: "await-coms", grace_s: Number.isFinite(p.grace_s) ? p.grace_s : DEFAULT_GRACE_S };
|
|
136
|
+
}
|
|
137
|
+
return {
|
|
138
|
+
backend: "native",
|
|
139
|
+
comsMissedNotice:
|
|
140
|
+
`${agentName}: prefers a coms peer but none named "${name}" is live in the pool — using the native subagent.`,
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// The refusal returned when a coms-required member's peer never appeared
|
|
145
|
+
// within the grace window.
|
|
146
|
+
export function comsRequiredRefusal(agentName, graceS) {
|
|
147
|
+
return (
|
|
148
|
+
`"${agentName}" is configured as coms-required (fallback: none) but no live peer named ` +
|
|
149
|
+
`"${String(agentName).toLowerCase()}" appeared in the pool within ${graceS}s. ` +
|
|
150
|
+
"Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /af-coms, " +
|
|
151
|
+
"or set `fallback: native` in .pi/agents/dispatch-policy.yaml."
|
|
152
|
+
);
|
|
153
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// Context-window resolution and the pre-spawn overflow guard.
|
|
2
|
+
//
|
|
3
|
+
// The bug this fixes: the hub measured EVERY specialist and research helper
|
|
4
|
+
// against `ctx.model.contextWindow` — the DISPATCHER's window. A specialist on
|
|
5
|
+
// custom/Qwen3.6-35B-A3B-4bit (49152) and one on a 400k hosted model were
|
|
6
|
+
// divided by the same number, so `⚠ Planner context at 315%` could mean either
|
|
7
|
+
// "the window is wrong for that provider" or "the run really did run 3× over",
|
|
8
|
+
// and nothing in the output told them apart.
|
|
9
|
+
//
|
|
10
|
+
// The authoritative source is pi's own model registry (ctx.modelRegistry.find),
|
|
11
|
+
// which is where the dispatcher's own window came from. This module keeps the
|
|
12
|
+
// resolution pure by taking a `lookup(provider, modelId)` function, and records
|
|
13
|
+
// WHERE each window came from so a wrong number is traceable rather than
|
|
14
|
+
// mysterious.
|
|
15
|
+
|
|
16
|
+
/** Stop resuming a session when the projected prompt reaches this share of the window. */
|
|
17
|
+
export const PRESPAWN_HEADROOM = 0.9;
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* "openrouter/google/gemini-3-flash-preview" → provider "openrouter",
|
|
21
|
+
* model id "google/gemini-3-flash-preview". A spec with no slash has no
|
|
22
|
+
* provider and cannot be looked up.
|
|
23
|
+
*/
|
|
24
|
+
export function splitModelSpec(spec) {
|
|
25
|
+
const s = String(spec ?? "").trim();
|
|
26
|
+
const slash = s.indexOf("/");
|
|
27
|
+
if (slash <= 0 || slash === s.length - 1) return { provider: "", modelId: s };
|
|
28
|
+
return { provider: s.slice(0, slash), modelId: s.slice(slash + 1) };
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Resolve the context window for a model spec.
|
|
33
|
+
* `lookup(provider, modelId)` is pi's registry find (may return undefined);
|
|
34
|
+
* `fallbackWindow` is the dispatcher's own window, used only when the registry
|
|
35
|
+
* has nothing. Returns { window, source } — source names the origin so a
|
|
36
|
+
* suspicious percentage can be traced to the number that produced it.
|
|
37
|
+
*/
|
|
38
|
+
export function resolveContextWindow(spec, { lookup, fallbackWindow = 0 } = {}) {
|
|
39
|
+
const { provider, modelId } = splitModelSpec(spec);
|
|
40
|
+
if (provider && typeof lookup === "function") {
|
|
41
|
+
let model;
|
|
42
|
+
try { model = lookup(provider, modelId); } catch { model = undefined; }
|
|
43
|
+
const win = Number(model?.contextWindow);
|
|
44
|
+
if (Number.isFinite(win) && win > 0) {
|
|
45
|
+
return { window: win, source: `pi model registry (${provider}/${modelId})` };
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
const fallback = Number(fallbackWindow);
|
|
49
|
+
if (Number.isFinite(fallback) && fallback > 0) {
|
|
50
|
+
return {
|
|
51
|
+
window: fallback,
|
|
52
|
+
// Named explicitly: this is the number that made 315% ambiguous.
|
|
53
|
+
source: `dispatcher's own model — not ${spec || "this model"}'s window`,
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
return { window: 0, source: "unknown" };
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** Percent of the window consumed. 0 when the window is unknown. */
|
|
60
|
+
export function contextPct({ input = 0, cacheRead = 0, cacheWrite = 0 } = {}, window) {
|
|
61
|
+
const win = Number(window);
|
|
62
|
+
if (!Number.isFinite(win) || win <= 0) return 0;
|
|
63
|
+
return (((input || 0) + (cacheRead || 0) + (cacheWrite || 0)) / win) * 100;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Rough prompt size in tokens. Deliberately crude (~4 chars/token) — it decides
|
|
68
|
+
* whether to start a session fresh, and being approximately right before the
|
|
69
|
+
* run beats being exactly right after it.
|
|
70
|
+
*/
|
|
71
|
+
export function estimatePromptTokens(text) {
|
|
72
|
+
return Math.ceil(String(text ?? "").length / 4);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Pre-spawn guard: would resuming this session overflow the window? Recycling
|
|
77
|
+
* AFTER the run is what made the post-mortem's warnings arrive 985s too late.
|
|
78
|
+
* `priorTokens` is the resumed session's last measured total.
|
|
79
|
+
*/
|
|
80
|
+
export function shouldRecycleBeforeSpawn({ priorTokens = 0, promptTokens = 0, window, headroom = PRESPAWN_HEADROOM }) {
|
|
81
|
+
const win = Number(window);
|
|
82
|
+
if (!Number.isFinite(win) || win <= 0) return null;
|
|
83
|
+
if (priorTokens <= 0) return null; // nothing accumulated — nothing to drop
|
|
84
|
+
const projected = priorTokens + promptTokens;
|
|
85
|
+
const limit = win * headroom;
|
|
86
|
+
if (projected < limit) return null;
|
|
87
|
+
return {
|
|
88
|
+
projected,
|
|
89
|
+
window: win,
|
|
90
|
+
message:
|
|
91
|
+
`projected prompt ~${Math.round(projected / 1000)}k tokens against a ${Math.round(win / 1000)}k window ` +
|
|
92
|
+
`(${Math.round((projected / win) * 100)}%)`,
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* The one-time diagnostic for a reading over 100%: name the window and where it
|
|
98
|
+
* came from, so "wrong window" and "genuine overflow" stop looking identical.
|
|
99
|
+
*/
|
|
100
|
+
export function overWindowDiagnostic({ agent, model, pct, window, source }) {
|
|
101
|
+
return (
|
|
102
|
+
`⚠ ${agent} measured ${Math.round(pct)}% of its context window (${Math.round(window / 1000)}k tokens, ` +
|
|
103
|
+
`source: ${source}) on ${model}. Over 100% means either that window is wrong for this provider or the ` +
|
|
104
|
+
"run genuinely exceeded it — compare the model's declared window before treating the number as real."
|
|
105
|
+
);
|
|
106
|
+
}
|