@chankov/agent-fleet 2.0.12 → 2.0.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agent-fleet/scripts/flow.ts +5 -3
- package/.pi/agent-fleet/scripts/lib/flow-command.ts +9 -4
- package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +3 -1
- package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.pi/agents/model-profiles.yaml +80 -29
- package/.pi/agents/peers.yaml +18 -18
- package/.pi/agents/voices.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +55 -4
- package/.pi/harnesses/agent-hub/commands/audit.ts +1 -1
- package/.pi/harnesses/agent-hub/commands/context.ts +1 -1
- package/.pi/harnesses/agent-hub/config/model-profiles.ts +1 -0
- package/.pi/harnesses/agent-hub/delegate.ts +5 -3
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +27 -2
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +29 -0
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +6 -0
- package/.pi/harnesses/agent-hub/index.ts +75 -40
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/profile-activation.ts +2 -2
- package/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
- package/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
- package/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
- package/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -1
- package/.pi/harnesses/agent-hub/return-extract.js +1 -1
- package/.pi/harnesses/agent-hub/session-audit.ts +6 -5
- package/.pi/harnesses/agent-hub/system1-activity.ts +67 -0
- package/.pi/harnesses/agent-hub/system1-report.ts +142 -1
- package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -0
- package/.pi/harnesses/agent-hub/tools/run-flow.ts +16 -2
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +26 -5
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +30 -5
- package/.pi/harnesses/agent-hub/ui/fleet-source.ts +7 -2
- package/.pi/harnesses/agent-hub/ui/grid.ts +12 -7
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +41 -2
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +4 -2
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +14 -3
- package/.pi/harnesses/lib/fleet-detail-view.ts +68 -7
- package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.pi/harnesses/lib/fleet-strip-view.ts +44 -9
- package/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.13/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.13/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.13/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.13/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.13/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.13/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.13/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.13/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.13/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.13/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.13/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.13/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.13/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.13/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.13/.pi/extensions/package.json +9 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/README.md +1360 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context.ts +45 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/delegate.ts +467 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/index.ts +2336 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/no-progress.ts +359 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/context.ts +53 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/system-prompt.ts +115 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/run-budget.js +542 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/session-audit.ts +227 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/spawn.ts +526 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-report.ts +225 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-runtime.ts +276 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/context.ts +142 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +124 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode.ts +173 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.13/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.13/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.13/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.13/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.13/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.13/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.13/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.13/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.13/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-read-model.ts +536 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.13/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.13/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.13/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/config.js +61 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/demo.ts +106 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.13/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.13/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.13/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.13/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.13/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.13/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.13/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.13/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.13/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.13/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.13/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.13/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.13/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.13/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.13/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.13/.version +1 -0
- package/.versions/2.0.13/agents/architect.md +24 -0
- package/.versions/2.0.13/agents/bowser.md +28 -0
- package/.versions/2.0.13/agents/builder.md +55 -0
- package/.versions/2.0.13/agents/code-reviewer.md +209 -0
- package/.versions/2.0.13/agents/deep-researcher.md +32 -0
- package/.versions/2.0.13/agents/documenter.md +22 -0
- package/.versions/2.0.13/agents/orchestrator.md +22 -0
- package/.versions/2.0.13/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.13/agents/planner.md +105 -0
- package/.versions/2.0.13/agents/releaser.md +24 -0
- package/.versions/2.0.13/agents/researcher.md +30 -0
- package/.versions/2.0.13/agents/security-auditor.md +167 -0
- package/.versions/2.0.13/agents/test-engineer.md +153 -0
- package/.versions/2.0.13/agents/web-debugger.md +44 -0
- package/.versions/2.0.13/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.13/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.13/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.13/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.13/docs/ARCHITECTURE.md +753 -0
- package/.versions/2.0.13/docs/agent-fleet-setup.md +900 -0
- package/.versions/2.0.13/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.13/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.13/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.13/docs/getting-started.md +126 -0
- package/.versions/2.0.13/docs/npm-install.md +468 -0
- package/.versions/2.0.13/docs/pi-extensions.md +454 -0
- package/.versions/2.0.13/docs/pi-setup.md +92 -0
- package/.versions/2.0.13/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.13/install-manifest.json +3175 -0
- package/.versions/2.0.13/justfile +247 -0
- package/.versions/2.0.13/manifest-meta.json +1057 -0
- package/.versions/2.0.13/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.13/references/communication-contract.md +26 -0
- package/.versions/2.0.13/references/definition-of-done.md +67 -0
- package/.versions/2.0.13/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.13/references/observability-checklist.md +92 -0
- package/.versions/2.0.13/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.13/references/performance-checklist.md +236 -0
- package/.versions/2.0.13/references/prompting-patterns.md +380 -0
- package/.versions/2.0.13/references/security-checklist.md +245 -0
- package/.versions/2.0.13/references/testing-patterns.md +235 -0
- package/.versions/2.0.13/references/workflow-authoring.md +304 -0
- package/.versions/2.0.13/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.13/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.13/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.13/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.13/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.13/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.13/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.13/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.13/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.13/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.13/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.13/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.13/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.13/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.13/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.13/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.13/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.13/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.13/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.13/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.13/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.13/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.13/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.13/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.13/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.13/skills/repository-ai-setup/SKILL.md +117 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.13/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.13/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.13/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +10 -0
- package/README.md +3 -3
- package/agents/architect.md +2 -3
- package/agents/bowser.md +2 -2
- package/agents/builder.md +2 -3
- package/agents/code-reviewer.md +7 -8
- package/agents/deep-researcher.md +3 -4
- package/agents/documenter.md +2 -3
- package/agents/orchestrator.md +2 -3
- package/agents/plan-reviewer.md +5 -6
- package/agents/planner.md +5 -6
- package/agents/releaser.md +2 -3
- package/agents/researcher.md +4 -5
- package/agents/security-auditor.md +6 -7
- package/agents/test-engineer.md +3 -4
- package/agents/web-debugger.md +3 -3
- package/agents/web-performance-auditor.md +3 -3
- package/bin/catalog/harness-runtime-closure.json +30 -18
- package/bin/cli.js +47 -1
- package/bin/lib/apply.js +16 -0
- package/bin/lib/overrides.js +37 -1
- package/bin/lib/project-provenance.js +119 -0
- package/bin/lib/scan.js +1 -1
- package/bin/lib/transaction.js +1 -1
- package/bin/lib/validate-overrides.js +37 -3
- package/catalog/agent-prompts/README.md +12 -0
- package/catalog/agent-prompts/architecture-decision-author.md +24 -0
- package/catalog/agent-prompts/requirements-author.md +21 -0
- package/catalog/commands/README.md +13 -0
- package/catalog/commands/assess-change-impact.md +19 -0
- package/catalog/commands/audit-documentation.md +19 -0
- package/catalog/rules/README.md +33 -0
- package/catalog/rules/ai/policy-authoring.md +22 -0
- package/catalog/rules/architecture/behavior-preserving-refactoring.md +25 -0
- package/catalog/rules/architecture/public-contracts.md +22 -0
- package/catalog/rules/architecture/repository-boundaries.md +21 -0
- package/catalog/rules/architecture/structural-change-registration.md +25 -0
- package/catalog/rules/backend/notification-date-time.md +25 -0
- package/catalog/rules/bundles/README.md +16 -0
- package/catalog/rules/data/enum-semantics.md +25 -0
- package/catalog/rules/data/mixed-ownership-data.md +22 -0
- package/catalog/rules/data/reporting-queries.md +34 -0
- package/catalog/rules/docs/docs-maintenance.md +25 -0
- package/catalog/rules/frameworks/vue.md +25 -0
- package/catalog/rules/frontend/async-ui-states.md +26 -0
- package/catalog/rules/frontend/established-ui-primitives.md +25 -0
- package/catalog/rules/frontend/form-validation.md +26 -0
- package/catalog/rules/frontend/navigation-contracts.md +25 -0
- package/catalog/rules/languages/csharp.md +25 -0
- package/catalog/rules/languages/javascript.md +25 -0
- package/catalog/rules/languages/sql.md +24 -0
- package/catalog/rules/security/authorization-before-effects.md +26 -0
- package/catalog/rules/security/diagnostic-data-safety.md +22 -0
- package/catalog/rules/security/response-data-minimization.md +25 -0
- package/catalog/rules/security/trusted-tenant-scope.md +26 -0
- package/catalog/rules/testing/shared-package-consumers.md +25 -0
- package/catalog/rules/testing/verification-conventions.md +24 -0
- package/docs/ARCHITECTURE.md +50 -2
- package/docs/agent-fleet-setup.md +246 -28
- package/docs/codex-session-bridge.md +1 -1
- package/docs/pi-extensions.md +10 -5
- package/docs/workflows.md +4 -3
- package/install-manifest.json +125 -3
- package/manifest-meta.json +77 -15
- package/package.json +5 -3
- package/skills/repository-ai-setup/SKILL.md +117 -0
- package/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/skills/repository-ai-setup/references/verify-setup.md +20 -0
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import type { WorkMode } from './work-mode.ts';
|
|
2
|
+
import {
|
|
3
|
+
TOOL_CATALOG_ENTRY_TYPE,
|
|
4
|
+
catalogSnapshot,
|
|
5
|
+
emitToolCatalogDelta,
|
|
6
|
+
restoreToolCatalogAfterCompaction,
|
|
7
|
+
type ToolCatalogDelta,
|
|
8
|
+
type ToolCatalogSnapshot,
|
|
9
|
+
} from './tool-catalog-state.ts';
|
|
10
|
+
import { UNKNOWN_TOOL_COUNTER_ENTRY_TYPE, type UnknownToolCounterSnapshot } from './unknown-tool-counter.ts';
|
|
11
|
+
|
|
12
|
+
export interface ToolCatalogReconcileInput {
|
|
13
|
+
fromMode: WorkMode;
|
|
14
|
+
toMode: WorkMode;
|
|
15
|
+
previous: readonly string[];
|
|
16
|
+
next: readonly string[];
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export interface ToolCatalogCompactionInput {
|
|
20
|
+
mode: WorkMode;
|
|
21
|
+
getEffectiveTools(): readonly string[];
|
|
22
|
+
persist(type: string, data: unknown): void;
|
|
23
|
+
counterSnapshot(): UnknownToolCounterSnapshot;
|
|
24
|
+
retainCounter(): void;
|
|
25
|
+
establishToolStateChange(previousCatalogVersion: string, nextCatalogVersion: string, evidenceRef: string): number;
|
|
26
|
+
settle(): void;
|
|
27
|
+
onError?(error: unknown): void;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Runtime-owned catalog state. The active turn is latched before model input. */
|
|
31
|
+
export function createToolCatalogRuntime(initial: ToolCatalogSnapshot) {
|
|
32
|
+
let currentCatalog = restoreToolCatalogAfterCompaction(initial);
|
|
33
|
+
let activeTurnCatalog: ToolCatalogSnapshot | null = null;
|
|
34
|
+
|
|
35
|
+
function reconcile(input: ToolCatalogReconcileInput): { snapshot: ToolCatalogSnapshot; delta: ToolCatalogDelta } {
|
|
36
|
+
const delta = emitToolCatalogDelta({ ...input, previousCatalogVersion: currentCatalog.catalogVersion });
|
|
37
|
+
currentCatalog = catalogSnapshot(input.toMode, delta.available);
|
|
38
|
+
return { snapshot: currentCatalog, delta };
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
return {
|
|
42
|
+
current: () => currentCatalog,
|
|
43
|
+
restore(snapshot: ToolCatalogSnapshot) { currentCatalog = restoreToolCatalogAfterCompaction(snapshot); return currentCatalog; },
|
|
44
|
+
reconcile,
|
|
45
|
+
beginTurn() { activeTurnCatalog = currentCatalog; return activeTurnCatalog; },
|
|
46
|
+
endTurn() { activeTurnCatalog = null; },
|
|
47
|
+
catalogForMessage() { return activeTurnCatalog ?? currentCatalog; },
|
|
48
|
+
compact(input: ToolCatalogCompactionInput): { snapshot: ToolCatalogSnapshot; delta: ToolCatalogDelta } | null {
|
|
49
|
+
try {
|
|
50
|
+
const restored = restoreToolCatalogAfterCompaction(currentCatalog);
|
|
51
|
+
const result = reconcile({ fromMode: restored.mode, toMode: input.mode, previous: restored.tools, next: input.getEffectiveTools() });
|
|
52
|
+
const evidenceRef = `session-entry:${TOOL_CATALOG_ENTRY_TYPE}:${result.delta.catalogVersion}`;
|
|
53
|
+
input.persist(TOOL_CATALOG_ENTRY_TYPE, { snapshot: result.snapshot, delta: result.delta, reason: 'compaction_restore' });
|
|
54
|
+
input.persist(UNKNOWN_TOOL_COUNTER_ENTRY_TYPE, { snapshot: input.counterSnapshot(), reason: 'compaction_restore' });
|
|
55
|
+
if (result.delta.evidence.changed) input.establishToolStateChange(result.delta.evidence.previousCatalogVersion, result.delta.evidence.catalogVersion, evidenceRef);
|
|
56
|
+
return result;
|
|
57
|
+
} catch (error) {
|
|
58
|
+
input.onError?.(error);
|
|
59
|
+
return null;
|
|
60
|
+
} finally {
|
|
61
|
+
input.retainCounter();
|
|
62
|
+
input.settle();
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export type ToolCatalogRuntime = ReturnType<typeof createToolCatalogRuntime>;
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import type { WorkMode } from "./work-mode.ts";
|
|
3
|
+
|
|
4
|
+
export const TOOL_CATALOG_STATE_SCHEMA = "agent-fleet.tool-catalog-state/v1" as const;
|
|
5
|
+
export const TOOL_CATALOG_ENTRY_TYPE = "agent-hub-tool-catalog-state";
|
|
6
|
+
|
|
7
|
+
export interface ToolCatalogSnapshot {
|
|
8
|
+
schema?: typeof TOOL_CATALOG_STATE_SCHEMA;
|
|
9
|
+
catalogVersion: string;
|
|
10
|
+
tools: string[];
|
|
11
|
+
mode: WorkMode;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface ToolCatalogDelta {
|
|
15
|
+
schema: "agent-fleet.tool-catalog-delta/v1";
|
|
16
|
+
fromMode: WorkMode;
|
|
17
|
+
toMode: WorkMode;
|
|
18
|
+
removed: string[];
|
|
19
|
+
added: string[];
|
|
20
|
+
available: string[];
|
|
21
|
+
substitutes: Record<string, string>;
|
|
22
|
+
substituteLimits: Record<string, string>;
|
|
23
|
+
permissionExpansion: false;
|
|
24
|
+
catalogVersion: string;
|
|
25
|
+
evidence: {
|
|
26
|
+
producer: "runtime-active-tool-catalog";
|
|
27
|
+
previousCatalogVersion: string;
|
|
28
|
+
catalogVersion: string;
|
|
29
|
+
changed: boolean;
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
const normalizedTools = (tools: readonly string[]): string[] => [...new Set(tools.map(tool => String(tool).trim()).filter(Boolean))].sort();
|
|
34
|
+
|
|
35
|
+
export function toolCatalogVersion(tools: readonly string[]): string {
|
|
36
|
+
return `catalog-sha256:${createHash("sha256").update(JSON.stringify(normalizedTools(tools))).digest("hex")}`;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function substituteForUnavailableTool(tool: string, availableTools: readonly string[]): { tool: string; limitation: string } | null {
|
|
40
|
+
const available = normalizedTools(availableTools);
|
|
41
|
+
const has = (candidate: string) => available.includes(candidate);
|
|
42
|
+
if (["write", "edit", "bash"].includes(tool) && has("dispatch_agent")) {
|
|
43
|
+
return { tool: "dispatch_agent", limitation: "delegate the requested effect; the orchestrator gains no direct filesystem or shell permission" };
|
|
44
|
+
}
|
|
45
|
+
if (["read", "grep", "find", "ls"].includes(tool) && has("spawn_research")) {
|
|
46
|
+
return { tool: "spawn_research", limitation: "delegate read-only inspection; no direct tool permission is restored" };
|
|
47
|
+
}
|
|
48
|
+
for (const candidate of ["read", "grep", "find", "spawn_research", "dispatch_agent"]) {
|
|
49
|
+
if (has(candidate)) return { tool: candidate, limitation: "available safe path only; it does not reproduce unavailable permissions" };
|
|
50
|
+
}
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export function emitToolCatalogDelta(input: {
|
|
55
|
+
fromMode: WorkMode;
|
|
56
|
+
toMode: WorkMode;
|
|
57
|
+
previous: readonly string[];
|
|
58
|
+
next: readonly string[];
|
|
59
|
+
previousCatalogVersion?: string;
|
|
60
|
+
}): ToolCatalogDelta {
|
|
61
|
+
const previous = normalizedTools(input.previous);
|
|
62
|
+
const available = normalizedTools(input.next);
|
|
63
|
+
const previousSet = new Set(previous);
|
|
64
|
+
const nextSet = new Set(available);
|
|
65
|
+
const removed = previous.filter(tool => !nextSet.has(tool));
|
|
66
|
+
const added = available.filter(tool => !previousSet.has(tool));
|
|
67
|
+
const substitutes: Record<string, string> = {};
|
|
68
|
+
const substituteLimits: Record<string, string> = {};
|
|
69
|
+
for (const removedTool of removed) {
|
|
70
|
+
const substitute = substituteForUnavailableTool(removedTool, available);
|
|
71
|
+
if (!substitute) continue;
|
|
72
|
+
substitutes[removedTool] = substitute.tool;
|
|
73
|
+
substituteLimits[removedTool] = substitute.limitation;
|
|
74
|
+
}
|
|
75
|
+
const previousCatalogVersion = input.previousCatalogVersion ?? toolCatalogVersion(previous);
|
|
76
|
+
const catalogVersion = toolCatalogVersion(available);
|
|
77
|
+
return {
|
|
78
|
+
schema: "agent-fleet.tool-catalog-delta/v1",
|
|
79
|
+
fromMode: input.fromMode,
|
|
80
|
+
toMode: input.toMode,
|
|
81
|
+
removed,
|
|
82
|
+
added,
|
|
83
|
+
available,
|
|
84
|
+
substitutes,
|
|
85
|
+
substituteLimits,
|
|
86
|
+
permissionExpansion: false,
|
|
87
|
+
catalogVersion,
|
|
88
|
+
evidence: {
|
|
89
|
+
producer: "runtime-active-tool-catalog",
|
|
90
|
+
previousCatalogVersion,
|
|
91
|
+
catalogVersion,
|
|
92
|
+
changed: removed.length > 0 || added.length > 0,
|
|
93
|
+
},
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export function restoreToolCatalogAfterCompaction(snapshot: ToolCatalogSnapshot): ToolCatalogSnapshot {
|
|
98
|
+
if (!snapshot || typeof snapshot.catalogVersion !== "string" || !snapshot.catalogVersion.trim()) throw new Error("tool catalog snapshot requires catalogVersion");
|
|
99
|
+
if (snapshot.mode !== "operator" && snapshot.mode !== "orchestrator") throw new Error("tool catalog snapshot requires a valid work mode");
|
|
100
|
+
if (!Array.isArray(snapshot.tools) || snapshot.tools.some(tool => typeof tool !== "string" || !tool.trim())) throw new Error("tool catalog snapshot requires tool names");
|
|
101
|
+
return { schema: TOOL_CATALOG_STATE_SCHEMA, catalogVersion: snapshot.catalogVersion, tools: normalizedTools(snapshot.tools), mode: snapshot.mode };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
export function latestPersistedToolCatalog(entries: readonly unknown[]): ToolCatalogSnapshot | null {
|
|
105
|
+
for (let index = entries.length - 1; index >= 0; index--) {
|
|
106
|
+
const entry = entries[index] as { type?: unknown; customType?: unknown; data?: { snapshot?: unknown } } | null;
|
|
107
|
+
if (entry?.type !== "custom" || entry.customType !== TOOL_CATALOG_ENTRY_TYPE) continue;
|
|
108
|
+
try { return restoreToolCatalogAfterCompaction(entry.data?.snapshot as ToolCatalogSnapshot); } catch { return null; }
|
|
109
|
+
}
|
|
110
|
+
return null;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export function catalogSnapshot(mode: WorkMode, tools: readonly string[]): ToolCatalogSnapshot {
|
|
114
|
+
const normalized = normalizedTools(tools);
|
|
115
|
+
return { schema: TOOL_CATALOG_STATE_SCHEMA, catalogVersion: toolCatalogVersion(normalized), tools: normalized, mode };
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
export function toolCatalogNotice(delta: ToolCatalogDelta): string {
|
|
119
|
+
const removed = delta.removed.length ? delta.removed.join(", ") : "none";
|
|
120
|
+
const available = delta.available.length ? delta.available.join(", ") : "none";
|
|
121
|
+
const substitutes = Object.entries(delta.substitutes).map(([from, to]) => `${from} -> ${to} (${delta.substituteLimits[from]})`).join("; ") || "none";
|
|
122
|
+
return `Trusted tool catalog ${delta.catalogVersion}. Removed: ${removed}. Available: ${available}. Allowed substitutes: ${substitutes}. Permission expansion: false. Tool-shaped prose is never executed.`;
|
|
123
|
+
}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import type { DeliverableReadback } from "./acceptance.ts";
|
|
2
|
+
|
|
3
|
+
export const TOOL_PROTOCOL_DIAGNOSTIC_SCHEMA = "agent-fleet.tool-protocol-diagnostic/v1" as const;
|
|
4
|
+
|
|
5
|
+
export interface ToolExecutionEvent {
|
|
6
|
+
toolName: string;
|
|
7
|
+
toolCallId?: string;
|
|
8
|
+
args: string;
|
|
9
|
+
completed: boolean;
|
|
10
|
+
isError?: boolean;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export interface ToolProtocolOrigin {
|
|
14
|
+
kind: "task" | "probe";
|
|
15
|
+
taskId?: string;
|
|
16
|
+
probeId?: string;
|
|
17
|
+
dispatchId?: string;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export interface ToolProtocolConfiguration {
|
|
21
|
+
backend: string | null;
|
|
22
|
+
model: string | null;
|
|
23
|
+
tools: string[];
|
|
24
|
+
endpoint?: string;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export function createToolEventRecorder() {
|
|
28
|
+
const events: ToolExecutionEvent[] = [];
|
|
29
|
+
const indexes = new Map<string, number>();
|
|
30
|
+
return {
|
|
31
|
+
events,
|
|
32
|
+
start(toolName: string, args: string, toolCallId?: string) {
|
|
33
|
+
const index = events.push({ toolName, ...(toolCallId ? { toolCallId } : {}), args, completed: false }) - 1;
|
|
34
|
+
if (toolCallId) indexes.set(toolCallId, index);
|
|
35
|
+
},
|
|
36
|
+
end(toolCallId: string | undefined, isError: boolean | undefined) {
|
|
37
|
+
if (!toolCallId) return;
|
|
38
|
+
const index = indexes.get(toolCallId);
|
|
39
|
+
if (index == null) return;
|
|
40
|
+
events[index] = { ...events[index], completed: true, ...(typeof isError === "boolean" ? { isError } : {}) };
|
|
41
|
+
indexes.delete(toolCallId);
|
|
42
|
+
},
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export interface ToolProtocolDiagnostic {
|
|
47
|
+
schema: typeof TOOL_PROTOCOL_DIAGNOSTIC_SCHEMA;
|
|
48
|
+
category: "tool_protocol_error";
|
|
49
|
+
origin: ToolProtocolOrigin;
|
|
50
|
+
effectiveConfiguration: ToolProtocolConfiguration;
|
|
51
|
+
claim: { tool: "write"; path: string };
|
|
52
|
+
correlation: { matchingEvents: number; deliverableStatus: DeliverableReadback["status"] | "not_declared" };
|
|
53
|
+
effects: { status: "none" | "partial"; observedPaths: string[] };
|
|
54
|
+
conclusion: { scope: "this_run"; statement: string };
|
|
55
|
+
evidenceRefs: string[];
|
|
56
|
+
message: string;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function withoutFencedExamples(text: string): string {
|
|
60
|
+
return text.replace(/```[^\n]*\n[\s\S]*?```/g, "");
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function terminalPseudoWrite(text: string): { tool: "write"; path: string } | null {
|
|
64
|
+
const candidate = withoutFencedExamples(String(text || "")).trim();
|
|
65
|
+
const xml = candidate.match(/<tool_call\b[^>]*>[\s\S]*?<function\s*=\s*["']?write["']?\s*>([\s\S]*?)<\/function>\s*<\/tool_call>\s*$/i);
|
|
66
|
+
if (xml) {
|
|
67
|
+
const path = xml[1].replace(/<[^>]+>/g, "").trim();
|
|
68
|
+
if (path && !/\s/.test(path)) return { tool: "write", path };
|
|
69
|
+
}
|
|
70
|
+
const jsonLine = candidate.split(/\r?\n/).at(-1)?.trim();
|
|
71
|
+
if (jsonLine?.startsWith("{") && jsonLine.endsWith("}")) {
|
|
72
|
+
try {
|
|
73
|
+
const value = JSON.parse(jsonLine);
|
|
74
|
+
const tool = String(value.tool ?? value.name ?? value.function ?? "").toLowerCase();
|
|
75
|
+
const path = String(value.path ?? value.arguments?.path ?? value.parameters?.path ?? "").trim();
|
|
76
|
+
if (tool === "write" && path) return { tool: "write", path };
|
|
77
|
+
} catch {}
|
|
78
|
+
}
|
|
79
|
+
return null;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function normalized(path: string): string {
|
|
83
|
+
return String(path || "").trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
function samePath(left: string, right: string): boolean {
|
|
87
|
+
const a = normalized(left), b = normalized(right);
|
|
88
|
+
return a === b || a.endsWith(`/${b}`) || b.endsWith(`/${a}`);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function eventPath(event: ToolExecutionEvent): string | null {
|
|
92
|
+
try {
|
|
93
|
+
const args = JSON.parse(event.args);
|
|
94
|
+
const value = args?.path ?? args?.file ?? args?.filePath;
|
|
95
|
+
return typeof value === "string" ? value : null;
|
|
96
|
+
} catch { return null; }
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function diagnoseToolProtocol(input: {
|
|
100
|
+
output: string;
|
|
101
|
+
toolEvents: readonly ToolExecutionEvent[];
|
|
102
|
+
deliverables: readonly DeliverableReadback[];
|
|
103
|
+
origin: ToolProtocolOrigin;
|
|
104
|
+
effectiveConfiguration: ToolProtocolConfiguration;
|
|
105
|
+
evidenceRefs?: readonly string[];
|
|
106
|
+
}): ToolProtocolDiagnostic | null {
|
|
107
|
+
const claim = terminalPseudoWrite(input.output);
|
|
108
|
+
if (!claim) return null;
|
|
109
|
+
const deliverable = input.deliverables.find(item => samePath(item.path, claim.path));
|
|
110
|
+
const matchingEvents = input.toolEvents.filter(event => event.toolName.toLowerCase() === claim.tool && event.completed && samePath(eventPath(event) ?? "", claim.path));
|
|
111
|
+
// A real matching event means the tool protocol worked; failed effects/readback
|
|
112
|
+
// remain T2 verification failures rather than being relabelled as protocol errors.
|
|
113
|
+
if (matchingEvents.length > 0 || (deliverable?.status === "read" && deliverable.changed === true)) return null;
|
|
114
|
+
// Without a declared target there is no trusted readback against which to call
|
|
115
|
+
// terminal tool-shaped prose an unexecuted task effect.
|
|
116
|
+
if (!deliverable) return null;
|
|
117
|
+
const observedPaths = input.deliverables.filter(item => item.status === "read" && item.changed === true).map(item => item.path).sort();
|
|
118
|
+
const otherWriteEffect = input.toolEvents.some(event => event.toolName.toLowerCase() === "write" && event.completed && event.isError !== true);
|
|
119
|
+
const effectsStatus = observedPaths.length > 0 || otherWriteEffect ? "partial" : "none";
|
|
120
|
+
const status = deliverable.status;
|
|
121
|
+
const message = `No matching write event for ${claim.path}; declared deliverable is ${status}. Tool-shaped text was not executed.`;
|
|
122
|
+
return {
|
|
123
|
+
schema: TOOL_PROTOCOL_DIAGNOSTIC_SCHEMA,
|
|
124
|
+
category: "tool_protocol_error",
|
|
125
|
+
origin: { ...input.origin },
|
|
126
|
+
effectiveConfiguration: { ...input.effectiveConfiguration, tools: [...input.effectiveConfiguration.tools] },
|
|
127
|
+
claim,
|
|
128
|
+
correlation: { matchingEvents: 0, deliverableStatus: status },
|
|
129
|
+
effects: { status: effectsStatus, observedPaths },
|
|
130
|
+
conclusion: { scope: "this_run", statement: "The claimed write is unsupported by this run's trusted tool events and deliverable readback." },
|
|
131
|
+
evidenceRefs: [...new Set(input.evidenceRefs ?? [])],
|
|
132
|
+
message,
|
|
133
|
+
};
|
|
134
|
+
}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
import { profilePeerGate } from '../policy/profile-runtime.ts';
|
|
2
|
+
import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
3
|
+
import { consumeReservedTaskId, reserveActualTaskId } from "../budget-recovery.ts";
|
|
4
|
+
import { DEFAULT_TASK_TIER, applyTierChange } from "../run-budget.js";
|
|
5
|
+
import { validateAssertionBatch } from "../assertion-ledger.js";
|
|
6
|
+
import { validateEvidence } from "../evidence-rules.js";
|
|
7
|
+
import { applyProcessClassification, createProcessState, processOpenObligations, processPreEffectGate, type ProcessObligationState } from "../process-obligations.ts";
|
|
8
|
+
import { safePathWithin } from "../helpers.ts";
|
|
9
|
+
import { TIMEOUT_MS } from "../../lib/coms-core.ts";
|
|
10
|
+
import type { Assertion, AssertionStatus, AssertionsArtifactsContext } from "../context/assertions-artifacts.ts";
|
|
11
|
+
import type { BudgetContext, TurnReport } from "../context/budgets.ts";
|
|
12
|
+
import type { HubStateContext } from "../context/hub-state.ts";
|
|
13
|
+
import type {
|
|
14
|
+
ComsAwaitParams, ComsGetParams, ComsListParams, ComsSendParams, SetAssertionsParams,
|
|
15
|
+
SetTaskTierParams, TeamAdjustParams, ToolExecutionResult, ToolExecutor, UpdateAssertionParams,
|
|
16
|
+
} from "./context.ts";
|
|
17
|
+
|
|
18
|
+
const TEAM_ADJUST_ROSTER_CAP = 8;
|
|
19
|
+
type Refusal = ToolExecutionResult | null;
|
|
20
|
+
|
|
21
|
+
export interface ActionExecutorDeps {
|
|
22
|
+
budget: BudgetContext;
|
|
23
|
+
artifacts: AssertionsArtifactsContext;
|
|
24
|
+
hubState: HubStateContext;
|
|
25
|
+
provisionalCapabilityRefusal(pack: "fleet" | "peer"): Refusal;
|
|
26
|
+
getTaskTier(): string | null;
|
|
27
|
+
setTaskTier(value: string): void;
|
|
28
|
+
getTaskTierAssumed(): boolean;
|
|
29
|
+
setTaskTierAssumed(value: boolean): void;
|
|
30
|
+
getProcessState?(): ProcessObligationState | null;
|
|
31
|
+
setProcessState?(value: ProcessObligationState): void;
|
|
32
|
+
persistProcessState?(value: ProcessObligationState): void;
|
|
33
|
+
getTaskDispatchCount(): number;
|
|
34
|
+
getTaskResearchCount(): number;
|
|
35
|
+
getTurnReport(): TurnReport;
|
|
36
|
+
getAssertions(): Assertion[];
|
|
37
|
+
setAssertions(value: Assertion[]): void;
|
|
38
|
+
currentTaskId(): string;
|
|
39
|
+
currentRevision(ctx: ExtensionContext): string;
|
|
40
|
+
confirmTaskSupersession?(input: { oldTaskId: string; newTaskId: string; reason: string }, ctx: ExtensionContext, signal?: AbortSignal): Promise<boolean>;
|
|
41
|
+
adoptReservedTaskId?(id: string, resetTaskWindow: () => void): void;
|
|
42
|
+
getAgentStates(): Map<string, { def: { name: string } }>;
|
|
43
|
+
rosterAdd(agent: string): { ok: boolean; message: string };
|
|
44
|
+
rosterDrop(agent: string): { ok: boolean; message: string };
|
|
45
|
+
getIdentity(): unknown | null;
|
|
46
|
+
getComs(): any;
|
|
47
|
+
resolveTarget(target: string): { name: string; model?: string } | null;
|
|
48
|
+
appendMachineHandoffSections(brief: string): string;
|
|
49
|
+
markPeerAddressed(name: string): void;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export interface ActionExecutors {
|
|
53
|
+
executeSetTaskTier: ToolExecutor<SetTaskTierParams>;
|
|
54
|
+
executeTeamAdjust: ToolExecutor<TeamAdjustParams>;
|
|
55
|
+
executeSetAssertions: ToolExecutor<SetAssertionsParams>;
|
|
56
|
+
executeUpdateAssertion: ToolExecutor<UpdateAssertionParams>;
|
|
57
|
+
executeGetAssertions: ToolExecutor<Record<string, never>>;
|
|
58
|
+
executeComsList: ToolExecutor<ComsListParams>;
|
|
59
|
+
executeComsSend: ToolExecutor<ComsSendParams>;
|
|
60
|
+
executeComsGet: ToolExecutor<ComsGetParams>;
|
|
61
|
+
executeComsAwait: ToolExecutor<ComsAwaitParams>;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export function createActionExecutors(d: ActionExecutorDeps): ActionExecutors {
|
|
65
|
+
let fallbackProcessState = createProcessState();
|
|
66
|
+
const getProcessState = () => d.getProcessState?.() ?? fallbackProcessState;
|
|
67
|
+
const setProcessState = (value: ProcessObligationState) => { fallbackProcessState = value; d.setProcessState?.(value); d.persistProcessState?.(value); };
|
|
68
|
+
const executeSetTaskTier: ToolExecutor<SetTaskTierParams> = async (_callId, params, signal, _onUpdate, ctx) => {
|
|
69
|
+
const { tier, risk, scope, reason, new_task } = params;
|
|
70
|
+
if (new_task && !(typeof reason === "string" && reason.trim())) return { content: [{ type: "text", text: "A genuine new task requires a non-empty reason." }], details: { status: "error", reason: "new_task_reason_required" } };
|
|
71
|
+
if (!new_task) { const refusal = d.provisionalCapabilityRefusal("fleet"); if (refusal) return refusal; }
|
|
72
|
+
const currentTier = new_task ? null : (d.getTaskTierAssumed() ? null : d.getTaskTier());
|
|
73
|
+
const change = applyTierChange(currentTier, tier, reason);
|
|
74
|
+
if (!change.ok) return { content: [{ type: "text", text: change.message }], details: { status: "error", reason: change.reason, tier: change.tier } };
|
|
75
|
+
const processChange = applyProcessClassification(getProcessState(), { risk, scope, reason, newTask: !!new_task });
|
|
76
|
+
if (!processChange.ok) return { content: [{ type: "text", text: processChange.message }], details: { status: "error", reason: "process_classification", tier: change.tier, risk: processChange.state.risk, scope: processChange.state.scope } };
|
|
77
|
+
let reservedNewTaskId: string | undefined;
|
|
78
|
+
if (new_task && processOpenObligations(getProcessState()).length) {
|
|
79
|
+
reservedNewTaskId = reserveActualTaskId();
|
|
80
|
+
let consumed = false;
|
|
81
|
+
try {
|
|
82
|
+
const confirmed = !!d.confirmTaskSupersession && await d.confirmTaskSupersession({ oldTaskId: d.currentTaskId(), newTaskId: reservedNewTaskId, reason: String(reason).trim() }, ctx, signal);
|
|
83
|
+
consumed = confirmed && consumeReservedTaskId(reservedNewTaskId);
|
|
84
|
+
if (!consumed) return { content: [{ type: "text", text: "Open obligations were not superseded: operator confirmation was absent, denied, stale, duplicate, or for another task." }], details: { status: "refused", reason: "task_supersession_not_authorized" } };
|
|
85
|
+
} finally {
|
|
86
|
+
if (!consumed) consumeReservedTaskId(reservedNewTaskId);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
if (new_task) {
|
|
90
|
+
const resetAt = Date.now();
|
|
91
|
+
const prior = d.budget.taskResetSnapshot(resetAt);
|
|
92
|
+
const resetTaskWindow = () => d.budget.resetTaskWindow(null, resetAt);
|
|
93
|
+
if (reservedNewTaskId && d.adoptReservedTaskId) d.adoptReservedTaskId(reservedNewTaskId, resetTaskWindow);
|
|
94
|
+
else resetTaskWindow();
|
|
95
|
+
d.setAssertions([]);
|
|
96
|
+
d.artifacts.persistAssertions();
|
|
97
|
+
d.budget.appendTaskResetEntry("tool:set_task_tier", null, prior, ctx);
|
|
98
|
+
}
|
|
99
|
+
setProcessState(processChange.state);
|
|
100
|
+
d.setTaskTier(change.tier); d.setTaskTierAssumed(false); d.getTurnReport().tier = change.tier; d.budget.updateModeStatus();
|
|
101
|
+
const b = d.budget.currentBudget(); const tb = d.budget.currentTaskBudget();
|
|
102
|
+
const cap = (n: number | null) => n == null ? "unlimited" : String(n);
|
|
103
|
+
const spent = `${d.getTaskDispatchCount()}/${cap(tb.maxDispatches)} dispatches, ${d.getTaskResearchCount()}/${cap(tb.maxResearch)} research`;
|
|
104
|
+
return { content: [{ type: "text", text: `${change.message}${new_task ? " (new task window opened; prior assertion ledger cleared)" : ""}\n${processChange.message} Budget tier differs intentionally: it limits spend and cannot erase correctness obligations.\nPer turn: ${cap(b.maxDispatches)} dispatches, ${cap(b.maxResearch)} research. Whole task: ${spent} spent. Size the apparatus accordingly — do not spend a cap just because it exists.` }], details: { status: "ok", tier: change.tier, risk: processChange.state.risk, scope: processChange.state.scope, process: processChange.state, escalated: change.escalated, newTask: !!new_task, ...(reservedNewTaskId ? { newTaskId: reservedNewTaskId } : {}) } };
|
|
105
|
+
};
|
|
106
|
+
|
|
107
|
+
const executeTeamAdjust: ToolExecutor<TeamAdjustParams> = async (_id, params, _signal, _update, ctx) => {
|
|
108
|
+
const refusal = d.provisionalCapabilityRefusal("fleet"); if (refusal) return refusal;
|
|
109
|
+
const act = String(params.action || "").trim().toLowerCase();
|
|
110
|
+
if (!d.budget.currentBudget().delegation) {
|
|
111
|
+
const tier = d.getTaskTier() ?? DEFAULT_TASK_TIER;
|
|
112
|
+
return { content: [{ type: "text", text: `team_adjust is disabled at tier "${tier}" — a single-specialist path never needs roster changes. Raise the task tier with set_task_tier if the work outgrew "${tier}".` }], details: { status: "refused" } };
|
|
113
|
+
}
|
|
114
|
+
if (act !== "add" && act !== "drop") return { content: [{ type: "text", text: `Unknown action "${params.action}" — expected add or drop.` }], details: { status: "error" } };
|
|
115
|
+
if (act === "add" && d.getAgentStates().size >= TEAM_ADJUST_ROSTER_CAP) return { content: [{ type: "text", text: `Roster cap reached (${TEAM_ADJUST_ROSTER_CAP}) — drop an unused member first, or ask the user to /af-agents-add manually.` }], details: { status: "refused" } };
|
|
116
|
+
const result = act === "add" ? d.rosterAdd(params.agent) : d.rosterDrop(params.agent);
|
|
117
|
+
if (result.ok) ctx.ui.notify(`team_adjust (${act}): ${result.message} — dispatcher's reason: ${params.reason || "(none given)"}`, "info");
|
|
118
|
+
const roster = Array.from(d.getAgentStates().values()).map(s => s.def.name).join(", ");
|
|
119
|
+
return { content: [{ type: "text", text: `${result.message}. Active team: ${roster}.` }], details: { status: result.ok ? "ok" : "refused", roster } };
|
|
120
|
+
};
|
|
121
|
+
|
|
122
|
+
const executeSetAssertions: ToolExecutor<SetAssertionsParams> = async (_id, params, _signal, _update, ctx) => {
|
|
123
|
+
const verdict = validateAssertionBatch(params.assertions);
|
|
124
|
+
if (!verdict.ok) return { content: [{ type: "text", text: verdict.refusal! }], details: { status: "rejected", reason: "missing-source" } };
|
|
125
|
+
const assertions = verdict.assertions.map(a => ({ ...a, status: "open" as AssertionStatus })); d.setAssertions(assertions);
|
|
126
|
+
d.artifacts.persistAssertions(); d.artifacts.updateAssertionStatus();
|
|
127
|
+
if (verdict.warning) ctx.ui.notify(verdict.warning, "warning");
|
|
128
|
+
const head = `Ledger set: ${assertions.length} assertion(s) open — ${assertions.map(a => a.id).join(", ") || "(none)"}. Pass the relevant ones verbatim into each dispatch and advance only on proven.`;
|
|
129
|
+
return { content: [{ type: "text", text: verdict.warning ? `${head}\n\n${verdict.warning}` : head }], details: { count: assertions.length, capWarning: Boolean(verdict.warning) } };
|
|
130
|
+
};
|
|
131
|
+
|
|
132
|
+
const executeUpdateAssertion: ToolExecutor<UpdateAssertionParams> = async (_id, params, _signal, _update, ctx) => {
|
|
133
|
+
const assertions = d.getAssertions(); const wanted = String(params.status).trim().toLowerCase();
|
|
134
|
+
if (!["proven", "unproven", "failed"].includes(wanted)) return { content: [{ type: "text", text: `status must be one of proven | unproven | failed (got "${params.status}").` }], details: { status: "error" } };
|
|
135
|
+
const a = assertions.find(x => x.id.toLowerCase() === String(params.id).trim().toLowerCase());
|
|
136
|
+
if (!a) return { content: [{ type: "text", text: `No assertion "${params.id}" in the ledger. Call set_assertions first, or check the id. Current: ${assertions.map(x => x.id).join(", ") || "(empty)"}.` }], details: { status: "error" } };
|
|
137
|
+
if (wanted === "proven") {
|
|
138
|
+
const gate = processPreEffectGate(getProcessState(), "prove", "", d.currentRevision(ctx));
|
|
139
|
+
if (gate) return { content: [{ type: "text", text: gate.message }], details: { status: "refused", reason: gate.reason } };
|
|
140
|
+
const validation = validateEvidence(a.tag, params.evidence || "", { fileExists: d.artifacts.evidencePathExists, evidenceRoot: safePathWithin(d.artifacts.artifactsRoot(), "evidence") });
|
|
141
|
+
if (!validation.ok) return { content: [{ type: "text", text: `${a.id} stays ${a.status}: ${validation.reason}` }], details: { status: "rejected", reason: validation.reason } };
|
|
142
|
+
}
|
|
143
|
+
a.status = wanted as AssertionStatus; a.evidence = wanted === "unproven" ? undefined : (params.evidence?.trim() || undefined);
|
|
144
|
+
if (wanted === "unproven") { a.evidenceTaskId = undefined; a.evidenceRevision = undefined; }
|
|
145
|
+
else { a.evidenceTaskId = d.currentTaskId(); a.evidenceRevision = d.currentRevision(ctx); }
|
|
146
|
+
d.artifacts.persistAssertions(); d.artifacts.updateAssertionStatus();
|
|
147
|
+
const open = assertions.filter(x => x.status === "open" || x.status === "unproven").map(x => x.id); const failed = assertions.filter(x => x.status === "failed").map(x => x.id);
|
|
148
|
+
const tail = failed.length ? `Failed: ${failed.join(", ")}. Still open: ${open.join(", ") || "none"}.` : open.length ? `Still open: ${open.join(", ")}.` : "All assertions proven.";
|
|
149
|
+
return { content: [{ type: "text", text: `${a.id} → ${a.status}${a.evidence ? ` (${a.evidence})` : ""}. ${tail}` }], details: { id: a.id, status: a.status } };
|
|
150
|
+
};
|
|
151
|
+
|
|
152
|
+
const executeGetAssertions: ToolExecutor<Record<string, never>> = async () => d.getAssertions().length === 0
|
|
153
|
+
? { content: [{ type: "text", text: "Ledger is empty. Call set_assertions to build the acceptance assertions before dispatching." }], details: { count: 0 } }
|
|
154
|
+
: { content: [{ type: "text", text: d.artifacts.renderAssertionLedgerText() }], details: { count: d.getAssertions().length } };
|
|
155
|
+
|
|
156
|
+
const executeComsList: ToolExecutor<ComsListParams> = async (_id, params) => {
|
|
157
|
+
if (!d.getIdentity()) return { content: [{ type: "text", text: "coms not initialised." }], details: { agents: [], project: null } };
|
|
158
|
+
const coms = d.getComs(); const result = await coms.list(params);
|
|
159
|
+
const notice = result.widenRequested ? `\n\n(Discovery is scoped to "${result.project}"${coms.scope.includeExplicit ? "" : ", explicit peers hidden"}. Widening to other projects or revealing --explicit peers is a human action via /af-coms --project <name> or /af-coms --all.)` : "";
|
|
160
|
+
const lines = result.agents.length === 0 ? "No peer agents in your pool." : result.agents.map((agent: any) => `${agent.alive ? "●" : "✗"} ${agent.name} (${agent.model})${agent.context_used_pct != null ? ` ${agent.context_used_pct}%` : " ?%"} [${agent.alive ? agent.status ?? "unknown" : "unreachable"}${agent.pane_id ? ` pane ${agent.pane_id}` : ""}]${agent.purpose ? ` — ${agent.purpose}` : ""}`).join("\n");
|
|
161
|
+
return { content: [{ type: "text", text: `${result.agents.length} peer(s) in pool (project ${result.project}):\n${lines}${notice}` }], details: result };
|
|
162
|
+
};
|
|
163
|
+
const executeComsSend: ToolExecutor<ComsSendParams> = async (_id, params) => {
|
|
164
|
+
const target = d.resolveTarget(params.target);
|
|
165
|
+
const profileRefusal = profilePeerGate({ peerModel: target?.model, targetResolved: !!target }); if (profileRefusal) return profileRefusal;
|
|
166
|
+
const refusal = d.provisionalCapabilityRefusal("peer"); if (refusal) return refusal;
|
|
167
|
+
const pending = d.hubState.getPendingHandoff();
|
|
168
|
+
const authorized = !!(target && pending && pending.target === target.name && params.handoff_token === pending.token);
|
|
169
|
+
const prompt = authorized ? d.appendMachineHandoffSections(String(params.prompt || "")) : String(params.prompt || "");
|
|
170
|
+
const sent = await d.getComs().send({ target: params.target, prompt, conversation_id: params.conversation_id ?? null, response_schema: (params.response_schema as object | undefined) ?? null, reply_timeout_ms: params.reply_timeout_ms ?? null });
|
|
171
|
+
d.markPeerAddressed(sent.target); if (authorized) d.hubState.setPendingHandoff(null);
|
|
172
|
+
return { content: [{ type: "text", text: `coms_send → ${sent.target}\nmsg_id ${sent.msg_id}\nhops ${sent.hops}` }], details: { msg_id: sent.msg_id, target: sent.target, target_session: sent.target_session, hops: sent.hops } };
|
|
173
|
+
};
|
|
174
|
+
const executeComsGet: ToolExecutor<ComsGetParams> = async (_id, params) => {
|
|
175
|
+
const result = d.getComs().get(params.msg_id); const text = result.status === "error" ? `coms_get: unknown msg_id ${params.msg_id}` : result.status === "pending" ? "coms_get: pending" : result.error ? `coms_get: error — ${result.error}` : `coms_get: complete\n${typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2)}`;
|
|
176
|
+
return { content: [{ type: "text", text }], details: result };
|
|
177
|
+
};
|
|
178
|
+
const executeComsAwait: ToolExecutor<ComsAwaitParams> = async (_id, params) => {
|
|
179
|
+
const result = await d.getComs().await(params.msg_id, typeof params.timeout_ms === "number" && params.timeout_ms > 0 ? params.timeout_ms : TIMEOUT_MS);
|
|
180
|
+
if (result.status === "pending") return { content: [{ type: "text", text: "coms_await: pending — wait budget exhausted; the peer may still complete" }], details: { status: "pending" } };
|
|
181
|
+
if (result.status === "error") { const unknown = result.error === "unknown msg_id"; return { content: [{ type: "text", text: unknown ? `coms_await: unknown msg_id ${params.msg_id}` : `coms_await: error — ${result.error}` }], details: unknown ? { error: "unknown msg_id" } : { status: "error", error: result.error } }; }
|
|
182
|
+
return { content: [{ type: "text", text: typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2) }], details: { response: result.response } };
|
|
183
|
+
};
|
|
184
|
+
return { executeSetTaskTier, executeTeamAdjust, executeSetAssertions, executeUpdateAssertion, executeGetAssertions, executeComsList, executeComsSend, executeComsGet, executeComsAwait };
|
|
185
|
+
}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
import { Type } from "@sinclair/typebox";
|
|
3
|
+
import { Text } from "@mariozechner/pi-tui";
|
|
4
|
+
import type { ComsAwaitParams, ComsGetParams, ComsListParams, ComsSendParams, ToolContext } from "./context.ts";
|
|
5
|
+
|
|
6
|
+
export function registerComsTools(pi: ExtensionAPI, toolCtx: ToolContext): void {
|
|
7
|
+
pi.registerTool({
|
|
8
|
+
name: "coms_list",
|
|
9
|
+
label: "Coms List",
|
|
10
|
+
description: "List peers in the human-scoped pool; this tool cannot widen discovery.",
|
|
11
|
+
parameters: Type.Object({
|
|
12
|
+
project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /af-coms displays — a widening request is ignored." })),
|
|
13
|
+
include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /af-coms --all." })),
|
|
14
|
+
}),
|
|
15
|
+
execute(toolCallId, params, signal, onUpdate, ctx) {
|
|
16
|
+
return toolCtx.executeComsList(toolCallId, params as ComsListParams, signal, onUpdate, ctx);
|
|
17
|
+
},
|
|
18
|
+
renderCall(args, theme) {
|
|
19
|
+
const proj = (args as any).project;
|
|
20
|
+
const filter = proj ? ` ${proj}` : "";
|
|
21
|
+
return new Text(
|
|
22
|
+
theme.fg("toolTitle", theme.bold("coms_list")) + theme.fg("dim", filter),
|
|
23
|
+
0, 0,
|
|
24
|
+
);
|
|
25
|
+
},
|
|
26
|
+
renderResult(result, options, theme) {
|
|
27
|
+
const details = result.details as any;
|
|
28
|
+
const agents: any[] = details?.agents ?? [];
|
|
29
|
+
const header = theme.fg("accent", `📡 ${agents.length} peer(s)`);
|
|
30
|
+
if (!options.expanded || agents.length === 0) {
|
|
31
|
+
return new Text(header, 0, 0);
|
|
32
|
+
}
|
|
33
|
+
const rows = agents.map((a) => {
|
|
34
|
+
const dot = a.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
|
|
35
|
+
const pct = a.context_used_pct != null ? `${a.context_used_pct}%` : "?%";
|
|
36
|
+
const state = a.alive ? (a.status ?? "unknown") : "unreachable";
|
|
37
|
+
const stateFg = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
|
|
38
|
+
return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)} ` +
|
|
39
|
+
`${theme.fg(stateFg as any, state)}${a.pane_id ? theme.fg("dim", ` ${a.pane_id}`) : ""}`;
|
|
40
|
+
}).join("\n");
|
|
41
|
+
return new Text(header + "\n" + rows, 0, 0);
|
|
42
|
+
},
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
pi.registerTool({
|
|
46
|
+
name: "coms_send",
|
|
47
|
+
label: "Coms Send",
|
|
48
|
+
description: "Send to an in-pool peer; use its msg_id with coms_get or coms_await.",
|
|
49
|
+
parameters: Type.Object({
|
|
50
|
+
target: Type.String({ description: "Peer name (preferred) or session_id — must be a peer currently in your coms pool (shown in the widget). Out-of-pool targets are refused; ask the human to widen scope with /af-coms --project or /af-coms --all." }),
|
|
51
|
+
prompt: Type.String({ description: "The prompt to send." }),
|
|
52
|
+
handoff_token: Type.Optional(Type.String({ description: "Internal /af-handoff token. Only include when the /af-handoff follow-up explicitly gives you one; it authorizes the machine-appended ledger/artifact appendix." })),
|
|
53
|
+
conversation_id: Type.Optional(Type.String()),
|
|
54
|
+
response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
|
|
55
|
+
reply_timeout_ms: Type.Optional(Type.Number({ description: "Receiver-side reply deadline in ms; pass the same budget used for coms_await. Clamped by the receiver." })),
|
|
56
|
+
}),
|
|
57
|
+
execute(toolCallId, params, signal, onUpdate, ctx) {
|
|
58
|
+
return toolCtx.executeComsSend(toolCallId, params as ComsSendParams, signal, onUpdate, ctx);
|
|
59
|
+
},
|
|
60
|
+
renderCall(args, theme) {
|
|
61
|
+
const tgt = (args as any).target ?? "?";
|
|
62
|
+
const prompt = (args as any).prompt ?? "";
|
|
63
|
+
const preview = prompt.length > 60 ? prompt.slice(0, 57) + "..." : prompt;
|
|
64
|
+
return new Text(
|
|
65
|
+
theme.fg("toolTitle", theme.bold("coms_send ")) +
|
|
66
|
+
theme.fg("accent", tgt) +
|
|
67
|
+
theme.fg("dim", " — ") +
|
|
68
|
+
theme.fg("muted", preview),
|
|
69
|
+
0, 0,
|
|
70
|
+
);
|
|
71
|
+
},
|
|
72
|
+
renderResult(result, _options, theme) {
|
|
73
|
+
const d = result.details as any;
|
|
74
|
+
if (!d) {
|
|
75
|
+
const t = result.content[0];
|
|
76
|
+
return new Text(t?.type === "text" ? t.text : "", 0, 0);
|
|
77
|
+
}
|
|
78
|
+
return new Text(
|
|
79
|
+
theme.fg("success", "→ ") +
|
|
80
|
+
theme.fg("accent", d.target) +
|
|
81
|
+
theme.fg("dim", ` msg_id `) +
|
|
82
|
+
theme.fg("warning", d.msg_id),
|
|
83
|
+
0, 0,
|
|
84
|
+
);
|
|
85
|
+
},
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
pi.registerTool({
|
|
89
|
+
name: "coms_get",
|
|
90
|
+
label: "Coms Get",
|
|
91
|
+
description:
|
|
92
|
+
"Non-blocking poll of a pending coms_send reply. Returns status pending|complete|error and (when complete) the response.",
|
|
93
|
+
parameters: Type.Object({
|
|
94
|
+
msg_id: Type.String({ description: "msg_id returned by coms_send." }),
|
|
95
|
+
}),
|
|
96
|
+
execute(toolCallId, params, signal, onUpdate, ctx) {
|
|
97
|
+
return toolCtx.executeComsGet(toolCallId, params as ComsGetParams, signal, onUpdate, ctx);
|
|
98
|
+
},
|
|
99
|
+
renderCall(args, theme) {
|
|
100
|
+
const id = (args as any).msg_id ?? "?";
|
|
101
|
+
return new Text(
|
|
102
|
+
theme.fg("toolTitle", theme.bold("coms_get ")) + theme.fg("warning", id),
|
|
103
|
+
0, 0,
|
|
104
|
+
);
|
|
105
|
+
},
|
|
106
|
+
renderResult(result, _options, theme) {
|
|
107
|
+
const d = result.details as any;
|
|
108
|
+
const status = d?.status ?? "?";
|
|
109
|
+
const color = status === "complete" ? "success" : status === "pending" ? "warning" : "error";
|
|
110
|
+
return new Text(theme.fg(color, status), 0, 0);
|
|
111
|
+
},
|
|
112
|
+
});
|
|
113
|
+
|
|
114
|
+
pi.registerTool({
|
|
115
|
+
name: "coms_await",
|
|
116
|
+
label: "Coms Await",
|
|
117
|
+
description: "Wait for a pending coms_send reply; timeout leaves it pending.",
|
|
118
|
+
parameters: Type.Object({
|
|
119
|
+
msg_id: Type.String({ description: "msg_id returned by coms_send." }),
|
|
120
|
+
timeout_ms: Type.Optional(Type.Number({ description: "Override the default timeout (ms)." })),
|
|
121
|
+
}),
|
|
122
|
+
execute(toolCallId, params, signal, onUpdate, ctx) {
|
|
123
|
+
return toolCtx.executeComsAwait(toolCallId, params as ComsAwaitParams, signal, onUpdate, ctx);
|
|
124
|
+
},
|
|
125
|
+
renderCall(args, theme) {
|
|
126
|
+
const id = (args as any).msg_id ?? "?";
|
|
127
|
+
return new Text(
|
|
128
|
+
theme.fg("toolTitle", theme.bold("coms_await ")) + theme.fg("warning", id),
|
|
129
|
+
0, 0,
|
|
130
|
+
);
|
|
131
|
+
},
|
|
132
|
+
renderResult(result, _options, theme) {
|
|
133
|
+
const d = result.details as any;
|
|
134
|
+
if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
|
|
135
|
+
if (d?.status === "pending") return new Text(theme.fg("warning", "⏳ pending"), 0, 0);
|
|
136
|
+
return new Text(theme.fg("success", "✓ response received"), 0, 0);
|
|
137
|
+
},
|
|
138
|
+
});
|
|
139
|
+
}
|