@chankov/agent-fleet 2.0.16 → 2.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (569) hide show
  1. package/.pi/harnesses/agent-hub/README.md +4 -0
  2. package/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  3. package/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  4. package/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  5. package/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  6. package/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  7. package/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
  8. package/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  9. package/.pi/harnesses/agent-hub/index.ts +8 -2
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
  12. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  13. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +9 -24
  14. package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
  15. package/.pi/harnesses/agent-hub/prompts/fragments.ts +7 -0
  16. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  17. package/.pi/harnesses/agent-hub/system1-communication-store.ts +29 -7
  18. package/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  19. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  20. package/.pi/harnesses/agent-hub/work-mode.ts +6 -1
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/index.ts +6 -23
  23. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  24. package/.pi/harnesses/lib/damage-control-shared.ts +29 -0
  25. package/.pi/harnesses/lib/safe-source-read.js +29 -0
  26. package/.pi/harnesses/lib/system1/config-agentic.js +14 -0
  27. package/.pi/harnesses/lib/system1/config-v2.js +6 -3
  28. package/.versions/2.0.17/.pi/agent-fleet/hermes/README.md +347 -0
  29. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  30. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  31. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  32. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  33. package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  34. package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  35. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  36. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  37. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  38. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  39. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  40. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  41. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  42. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  43. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  44. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  45. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  46. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  47. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  48. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  49. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  50. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  51. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  52. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  53. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  54. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  55. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  56. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  57. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  58. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  59. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  60. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  61. package/.versions/2.0.17/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  62. package/.versions/2.0.17/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  63. package/.versions/2.0.17/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  64. package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  65. package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  66. package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  67. package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  68. package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  69. package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet.ts +217 -0
  70. package/.versions/2.0.17/.pi/agent-fleet/scripts/flow.ts +157 -0
  71. package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  72. package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  73. package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  74. package/.versions/2.0.17/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  75. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  76. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  77. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  78. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  79. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  80. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  81. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  82. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  83. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  84. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  85. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  86. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  87. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  88. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  89. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  90. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  91. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  92. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  93. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  94. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  95. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  96. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  97. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  98. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  99. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  100. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  101. package/.versions/2.0.17/.pi/agent-fleet/scripts/package-lock.json +35 -0
  102. package/.versions/2.0.17/.pi/agent-fleet/scripts/package.json +9 -0
  103. package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  104. package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  105. package/.versions/2.0.17/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  106. package/.versions/2.0.17/.pi/agent-fleet/scripts/team-up.ts +378 -0
  107. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  108. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  109. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  110. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  111. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  112. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  113. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  114. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  115. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  116. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  117. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  118. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  119. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  120. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  121. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  122. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  123. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  124. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  125. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  126. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  127. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  128. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  129. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  130. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  131. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  132. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  133. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  134. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  135. package/.versions/2.0.17/.pi/agents/dispatch-policy.yaml +32 -0
  136. package/.versions/2.0.17/.pi/agents/model-profiles.yaml +134 -0
  137. package/.versions/2.0.17/.pi/agents/peers.yaml +147 -0
  138. package/.versions/2.0.17/.pi/agents/teams.yaml +41 -0
  139. package/.versions/2.0.17/.pi/agents/voices.yaml +13 -0
  140. package/.versions/2.0.17/.pi/damage-control-rules.yaml +297 -0
  141. package/.versions/2.0.17/.pi/extensions/btw/README.md +120 -0
  142. package/.versions/2.0.17/.pi/extensions/btw/index.ts +914 -0
  143. package/.versions/2.0.17/.pi/extensions/btw/package.json +6 -0
  144. package/.versions/2.0.17/.pi/extensions/btw/state.js +179 -0
  145. package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  146. package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  147. package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  148. package/.versions/2.0.17/.pi/extensions/compact-and-continue/README.md +42 -0
  149. package/.versions/2.0.17/.pi/extensions/compact-and-continue/index.ts +120 -0
  150. package/.versions/2.0.17/.pi/extensions/compact-and-continue/package.json +6 -0
  151. package/.versions/2.0.17/.pi/extensions/mcp-bridge/README.md +46 -0
  152. package/.versions/2.0.17/.pi/extensions/mcp-bridge/index.ts +206 -0
  153. package/.versions/2.0.17/.pi/extensions/mcp-bridge/package.json +6 -0
  154. package/.versions/2.0.17/.pi/extensions/package-lock.json +1175 -0
  155. package/.versions/2.0.17/.pi/extensions/package.json +9 -0
  156. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/README.md +224 -0
  157. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/config.ts +198 -0
  158. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  159. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/index.ts +248 -0
  160. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/package.json +6 -0
  161. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  162. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  163. package/.versions/2.0.17/.pi/harnesses/agent-hub/README.md +1456 -0
  164. package/.versions/2.0.17/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  165. package/.versions/2.0.17/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  166. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  167. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  168. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  169. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  170. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  171. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
  172. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  173. package/.versions/2.0.17/.pi/harnesses/agent-hub/artifacts.js +146 -0
  174. package/.versions/2.0.17/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  175. package/.versions/2.0.17/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  176. package/.versions/2.0.17/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  177. package/.versions/2.0.17/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  178. package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  179. package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  180. package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  181. package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  182. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  183. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  184. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  185. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  186. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  187. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  188. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  189. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  190. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  191. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  192. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  193. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  194. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  195. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  196. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  197. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  198. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  199. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  200. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  201. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  202. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  203. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  204. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  205. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  206. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  207. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  208. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  209. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  210. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  211. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  212. package/.versions/2.0.17/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  213. package/.versions/2.0.17/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  214. package/.versions/2.0.17/.pi/harnesses/agent-hub/config/overrides.ts +155 -0
  215. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  216. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  217. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  218. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  219. package/.versions/2.0.17/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  220. package/.versions/2.0.17/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  221. package/.versions/2.0.17/.pi/harnesses/agent-hub/context-window.js +108 -0
  222. package/.versions/2.0.17/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  223. package/.versions/2.0.17/.pi/harnesses/agent-hub/delegate.ts +467 -0
  224. package/.versions/2.0.17/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
  225. package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  226. package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  227. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  228. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  229. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  230. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
  231. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  232. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
  233. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  234. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  235. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  236. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  237. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  238. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  239. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  240. package/.versions/2.0.17/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  241. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  242. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  243. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  244. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  245. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  246. package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  247. package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  248. package/.versions/2.0.17/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  249. package/.versions/2.0.17/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  250. package/.versions/2.0.17/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
  251. package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
  252. package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  253. package/.versions/2.0.17/.pi/harnesses/agent-hub/footer.ts +30 -0
  254. package/.versions/2.0.17/.pi/harnesses/agent-hub/helpers.ts +270 -0
  255. package/.versions/2.0.17/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  256. package/.versions/2.0.17/.pi/harnesses/agent-hub/index.ts +2607 -0
  257. package/.versions/2.0.17/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  258. package/.versions/2.0.17/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  259. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  260. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  261. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  262. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  263. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  264. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  265. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  266. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  267. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  268. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  269. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  270. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  271. package/.versions/2.0.17/.pi/harnesses/agent-hub/no-progress.ts +563 -0
  272. package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  273. package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  274. package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  275. package/.versions/2.0.17/.pi/harnesses/agent-hub/package.json +7 -0
  276. package/.versions/2.0.17/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  277. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  278. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  279. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  280. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  281. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/work-mode.ts +136 -0
  282. package/.versions/2.0.17/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  283. package/.versions/2.0.17/.pi/harnesses/agent-hub/presentation.ts +48 -0
  284. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-config.ts +16 -0
  285. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  286. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  287. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  288. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-local.ts +71 -0
  289. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  290. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  291. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  292. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  293. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  294. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot.ts +228 -0
  295. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  296. package/.versions/2.0.17/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  297. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
  298. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/fragments.ts +123 -0
  299. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  300. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/system-prompt.ts +124 -0
  301. package/.versions/2.0.17/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  302. package/.versions/2.0.17/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  303. package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  304. package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  305. package/.versions/2.0.17/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  306. package/.versions/2.0.17/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  307. package/.versions/2.0.17/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  308. package/.versions/2.0.17/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
  309. package/.versions/2.0.17/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
  310. package/.versions/2.0.17/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  311. package/.versions/2.0.17/.pi/harnesses/agent-hub/return-contract.js +349 -0
  312. package/.versions/2.0.17/.pi/harnesses/agent-hub/return-extract.js +77 -0
  313. package/.versions/2.0.17/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  314. package/.versions/2.0.17/.pi/harnesses/agent-hub/review-findings.js +104 -0
  315. package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  316. package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  317. package/.versions/2.0.17/.pi/harnesses/agent-hub/run-budget.js +554 -0
  318. package/.versions/2.0.17/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  319. package/.versions/2.0.17/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  320. package/.versions/2.0.17/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  321. package/.versions/2.0.17/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  322. package/.versions/2.0.17/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  323. package/.versions/2.0.17/.pi/harnesses/agent-hub/session-health.js +110 -0
  324. package/.versions/2.0.17/.pi/harnesses/agent-hub/session-start.ts +42 -0
  325. package/.versions/2.0.17/.pi/harnesses/agent-hub/spawn.ts +534 -0
  326. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  327. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-communication-store.ts +151 -0
  328. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  329. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  330. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  331. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  332. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  333. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  334. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  335. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  336. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  337. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  338. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  339. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  340. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  341. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  342. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  343. package/.versions/2.0.17/.pi/harnesses/agent-hub/timeline.ts +72 -0
  344. package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  345. package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  346. package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  347. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
  348. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  349. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  350. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  351. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  352. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
  353. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  354. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  355. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  356. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  357. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  358. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  359. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  360. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  361. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  362. package/.versions/2.0.17/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  363. package/.versions/2.0.17/.pi/harnesses/agent-hub/types.ts +66 -0
  364. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  365. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  366. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  367. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  368. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  369. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  370. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  371. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  372. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  373. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  374. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  375. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  376. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  377. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  378. package/.versions/2.0.17/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  379. package/.versions/2.0.17/.pi/harnesses/agent-hub/version.ts +42 -0
  380. package/.versions/2.0.17/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  381. package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  382. package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode.ts +184 -0
  383. package/.versions/2.0.17/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  384. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/README.md +59 -0
  385. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/index.ts +558 -0
  386. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  387. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  388. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  389. package/.versions/2.0.17/.pi/harnesses/coms/README.md +100 -0
  390. package/.versions/2.0.17/.pi/harnesses/coms/index.ts +282 -0
  391. package/.versions/2.0.17/.pi/harnesses/coms/package.json +7 -0
  392. package/.versions/2.0.17/.pi/harnesses/coms/version.ts +42 -0
  393. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/README.md +135 -0
  394. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/index.ts +533 -0
  395. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/package.json +7 -0
  396. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/version.ts +42 -0
  397. package/.versions/2.0.17/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  398. package/.versions/2.0.17/.pi/harnesses/lib/coms-core-io.ts +385 -0
  399. package/.versions/2.0.17/.pi/harnesses/lib/coms-core.ts +577 -0
  400. package/.versions/2.0.17/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  401. package/.versions/2.0.17/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  402. package/.versions/2.0.17/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  403. package/.versions/2.0.17/.pi/harnesses/lib/context-budget-view.ts +107 -0
  404. package/.versions/2.0.17/.pi/harnesses/lib/context-budget.ts +114 -0
  405. package/.versions/2.0.17/.pi/harnesses/lib/damage-control-shared.ts +226 -0
  406. package/.versions/2.0.17/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  407. package/.versions/2.0.17/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  408. package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  409. package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  410. package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  411. package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  412. package/.versions/2.0.17/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  413. package/.versions/2.0.17/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  414. package/.versions/2.0.17/.pi/harnesses/lib/fleet-panel.ts +34 -0
  415. package/.versions/2.0.17/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  416. package/.versions/2.0.17/.pi/harnesses/lib/fleet-selection.ts +24 -0
  417. package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  418. package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  419. package/.versions/2.0.17/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  420. package/.versions/2.0.17/.pi/harnesses/lib/herdr-client.ts +472 -0
  421. package/.versions/2.0.17/.pi/harnesses/lib/herdr-presence.ts +399 -0
  422. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  423. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  424. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  425. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  426. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  427. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  428. package/.versions/2.0.17/.pi/harnesses/lib/safe-source-read.js +29 -0
  429. package/.versions/2.0.17/.pi/harnesses/lib/spawned-peers.js +191 -0
  430. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-agentic.js +14 -0
  431. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-json.js +37 -0
  432. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-loader.js +44 -0
  433. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-proactive.js +57 -0
  434. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-triage.js +42 -0
  435. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-v2.js +103 -0
  436. package/.versions/2.0.17/.pi/harnesses/lib/system1/config.js +50 -0
  437. package/.versions/2.0.17/.pi/harnesses/lib/system1/contracts.ts +154 -0
  438. package/.versions/2.0.17/.pi/harnesses/lib/system1/demo.ts +95 -0
  439. package/.versions/2.0.17/.pi/harnesses/lib/system1/jev.ts +503 -0
  440. package/.versions/2.0.17/.pi/harnesses/lib/system1/selection.js +11 -0
  441. package/.versions/2.0.17/.pi/harnesses/lib/system1/service.ts +245 -0
  442. package/.versions/2.0.17/.pi/harnesses/lib/update-check.ts +222 -0
  443. package/.versions/2.0.17/.pi/harnesses/package-lock.json +2039 -0
  444. package/.versions/2.0.17/.pi/harnesses/package.json +10 -0
  445. package/.versions/2.0.17/.pi/prompts/af-build.md +27 -0
  446. package/.versions/2.0.17/.pi/prompts/af-code-simplify.md +22 -0
  447. package/.versions/2.0.17/.pi/prompts/af-constraints.md +31 -0
  448. package/.versions/2.0.17/.pi/prompts/af-plan.md +17 -0
  449. package/.versions/2.0.17/.pi/prompts/af-review.md +16 -0
  450. package/.versions/2.0.17/.pi/prompts/af-set-hermes-telegram.md +15 -0
  451. package/.versions/2.0.17/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  452. package/.versions/2.0.17/.pi/prompts/af-setup-rules.md +20 -0
  453. package/.versions/2.0.17/.pi/prompts/af-ship.md +17 -0
  454. package/.versions/2.0.17/.pi/prompts/af-spec.md +15 -0
  455. package/.versions/2.0.17/.pi/prompts/af-test.md +19 -0
  456. package/.versions/2.0.17/.pi/skills/bowser/SKILL.md +145 -0
  457. package/.versions/2.0.17/.version +1 -0
  458. package/.versions/2.0.17/agents/architect.md +24 -0
  459. package/.versions/2.0.17/agents/bowser.md +28 -0
  460. package/.versions/2.0.17/agents/builder.md +55 -0
  461. package/.versions/2.0.17/agents/code-reviewer.md +209 -0
  462. package/.versions/2.0.17/agents/deep-researcher.md +32 -0
  463. package/.versions/2.0.17/agents/documenter.md +22 -0
  464. package/.versions/2.0.17/agents/orchestrator.md +22 -0
  465. package/.versions/2.0.17/agents/plan-reviewer.md +83 -0
  466. package/.versions/2.0.17/agents/planner.md +105 -0
  467. package/.versions/2.0.17/agents/releaser.md +24 -0
  468. package/.versions/2.0.17/agents/researcher.md +30 -0
  469. package/.versions/2.0.17/agents/security-auditor.md +167 -0
  470. package/.versions/2.0.17/agents/test-engineer.md +153 -0
  471. package/.versions/2.0.17/agents/web-debugger.md +44 -0
  472. package/.versions/2.0.17/agents/web-performance-auditor.md +194 -0
  473. package/.versions/2.0.17/bin/catalog/harness-runtime-closure.json +73 -0
  474. package/.versions/2.0.17/codex/fleet-session-client/SKILL.md +34 -0
  475. package/.versions/2.0.17/codex/fleet-session-client.zip +0 -0
  476. package/.versions/2.0.17/docs/ARCHITECTURE.md +834 -0
  477. package/.versions/2.0.17/docs/agent-fleet-setup.md +1101 -0
  478. package/.versions/2.0.17/docs/claude-code-coms-bridge.md +134 -0
  479. package/.versions/2.0.17/docs/codex-session-bridge.md +219 -0
  480. package/.versions/2.0.17/docs/coms-hermes-bridge.md +188 -0
  481. package/.versions/2.0.17/docs/getting-started.md +126 -0
  482. package/.versions/2.0.17/docs/npm-install.md +530 -0
  483. package/.versions/2.0.17/docs/pi-extensions.md +454 -0
  484. package/.versions/2.0.17/docs/pi-setup.md +92 -0
  485. package/.versions/2.0.17/docs/skill-anatomy.md +150 -0
  486. package/.versions/2.0.17/install-manifest.json +3193 -0
  487. package/.versions/2.0.17/justfile +247 -0
  488. package/.versions/2.0.17/manifest-meta.json +1071 -0
  489. package/.versions/2.0.17/references/accessibility-checklist.md +160 -0
  490. package/.versions/2.0.17/references/communication-contract.md +26 -0
  491. package/.versions/2.0.17/references/definition-of-done.md +67 -0
  492. package/.versions/2.0.17/references/fleet-coordination-patterns.md +171 -0
  493. package/.versions/2.0.17/references/observability-checklist.md +92 -0
  494. package/.versions/2.0.17/references/orchestration-patterns.md +370 -0
  495. package/.versions/2.0.17/references/performance-checklist.md +236 -0
  496. package/.versions/2.0.17/references/prompting-patterns.md +380 -0
  497. package/.versions/2.0.17/references/security-checklist.md +245 -0
  498. package/.versions/2.0.17/references/testing-patterns.md +235 -0
  499. package/.versions/2.0.17/references/workflow-authoring.md +304 -0
  500. package/.versions/2.0.17/skills/_internal/grilling.md +59 -0
  501. package/.versions/2.0.17/skills/browser-testing-with-devtools/SKILL.md +351 -0
  502. package/.versions/2.0.17/skills/code-review-and-quality/SKILL.md +396 -0
  503. package/.versions/2.0.17/skills/compound-learning/SKILL.md +137 -0
  504. package/.versions/2.0.17/skills/constraint-driven-development/SKILL.md +338 -0
  505. package/.versions/2.0.17/skills/constraint-driven-development/references/floor-guard.md +99 -0
  506. package/.versions/2.0.17/skills/context-engineering/SKILL.md +341 -0
  507. package/.versions/2.0.17/skills/deprecation-and-migration/SKILL.md +247 -0
  508. package/.versions/2.0.17/skills/designing-agents/SKILL.md +394 -0
  509. package/.versions/2.0.17/skills/designing-agents/pi-harness-authoring.md +222 -0
  510. package/.versions/2.0.17/skills/drafting-workflows/SKILL.md +143 -0
  511. package/.versions/2.0.17/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  512. package/.versions/2.0.17/skills/frontend-ui-engineering/SKILL.md +328 -0
  513. package/.versions/2.0.17/skills/git-workflow-and-versioning/SKILL.md +316 -0
  514. package/.versions/2.0.17/skills/idea-refine/SKILL.md +182 -0
  515. package/.versions/2.0.17/skills/idea-refine/examples.md +238 -0
  516. package/.versions/2.0.17/skills/idea-refine/frameworks.md +99 -0
  517. package/.versions/2.0.17/skills/idea-refine/refinement-criteria.md +113 -0
  518. package/.versions/2.0.17/skills/idea-refine/scripts/idea-refine.sh +15 -0
  519. package/.versions/2.0.17/skills/incremental-implementation/SKILL.md +353 -0
  520. package/.versions/2.0.17/skills/interview-me/SKILL.md +226 -0
  521. package/.versions/2.0.17/skills/orchestration-verification/SKILL.md +182 -0
  522. package/.versions/2.0.17/skills/peer-coms/SKILL.md +90 -0
  523. package/.versions/2.0.17/skills/performance-optimization/SKILL.md +496 -0
  524. package/.versions/2.0.17/skills/planning-and-task-breakdown/SKILL.md +318 -0
  525. package/.versions/2.0.17/skills/repository-ai-setup/SKILL.md +117 -0
  526. package/.versions/2.0.17/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  527. package/.versions/2.0.17/skills/repository-ai-setup/references/apply-contract.md +74 -0
  528. package/.versions/2.0.17/skills/repository-ai-setup/references/provenance-template.md +16 -0
  529. package/.versions/2.0.17/skills/repository-ai-setup/references/setup-flow.md +108 -0
  530. package/.versions/2.0.17/skills/repository-ai-setup/references/verify-setup.md +20 -0
  531. package/.versions/2.0.17/skills/security-and-hardening/SKILL.md +524 -0
  532. package/.versions/2.0.17/skills/spec-driven-development/SKILL.md +295 -0
  533. package/.versions/2.0.17/skills/using-agent-skills/SKILL.md +198 -0
  534. package/.versions/2.0.17/vendor/agent-skills-upstream/LICENSE +21 -0
  535. package/.versions/2.0.17/vendor/agent-skills-upstream/README.md +430 -0
  536. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  537. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  538. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  539. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  540. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  541. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  542. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  543. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  544. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  545. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  546. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  547. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  548. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  549. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  550. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  551. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  552. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  553. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  554. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  555. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  556. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  557. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  558. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  559. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  560. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  561. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  562. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  563. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  564. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  565. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  566. package/CHANGELOG.md +12 -0
  567. package/docs/system1-agentic.md +106 -0
  568. package/install-manifest.json +1 -1
  569. package/package.json +5 -2
@@ -0,0 +1,558 @@
1
+ import { retainDeliverable } from "../execution-evidence.ts";
2
+ import { buildRuntimeResult, minimalChangeRequirement, preflightDeliverables, readBackDeliverables, type AcceptanceRequirement, type DeliverableContract, type VerificationCheckInput } from "../acceptance.ts";
3
+ import { normalizeResearchContract, withNoProgress, canonicalExecutor, type NoProgressGuard } from "../no-progress.ts";
4
+ import { randomUUID } from "node:crypto";
5
+ import { mkdirSync, writeFileSync } from "node:fs";
6
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
7
+ import { blockingFindingCap, checkReviewRoundCap, checkTaskBudget, checkTierPersonaGate, checkTurnBudget, isReviewPersona, remainingTaskResearch, reviewBudgetClause, reviewRoundCap } from "../run-budget.js";
8
+ import { countReviewFindings, findingBudgetNotice } from "../review-findings.js";
9
+ import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
10
+ import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
11
+ import type { BudgetRecovery } from "../budget-recovery.ts";
12
+ import { checkScope, diffAgainst, reviewableChangedPaths, snapshotWorktree, worktreeRevision } from "../scope-gate.js";
13
+ import { diagnoseChangedTypeScript, formatAdvisory, type DiagnosticsResult } from "../../lib/changed-file-diagnostics.ts";
14
+ import { correctStructuredReturnForCompiler, crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
15
+ import { shouldExtractReturn } from "../return-extract.js";
16
+ import { normalizeAgentInput, safeAgentKey, safePathWithin, taskFingerprint } from "../helpers.ts";
17
+ import { MAX_AUTO_RESEARCH_QUESTIONS, MAX_AUTO_RESEARCH_ROUNDS, type ResearchAgentDef, type ResearchRuntime } from "../research/runtime.ts";
18
+ import type { BudgetContext, SessionTotals, TurnReport } from "../context/budgets.ts";
19
+ import type { AssertionsArtifactsContext, InputArtifactPreview } from "../context/assertions-artifacts.ts";
20
+ import type { DispatchAgentParams, SpawnResearchParams, ToolExecutionResult, ToolExecutor, ToolUpdate } from "./context.ts";
21
+ import type { AgentState } from "../types.ts";
22
+ import { diagnoseToolProtocol, type ToolProtocolDiagnostic } from "../tool-protocol.ts";
23
+ import type { TaskResumeInput } from "../task-resume-contract.ts";
24
+ import { evaluateProcessObligations, noteProcessStage, processAllowsPersona, processPreEffectGate, type ProcessObligationState, type ProcessVerdict } from "../process-obligations.ts";
25
+ import { activeOrchestrationHandoff, plannerRequiredRefusal, reviewMayClose } from "../orchestration-activation.ts";
26
+ import { authorizePlanStatusUpdate } from "../orchestration-route.ts";
27
+
28
+ type Gate = { reason: string; message: string } | null;
29
+ type DispatchResult = import("../dispatch-native-types.ts").NativeDispatchResult;
30
+
31
+ export interface DispatchExecutionState {
32
+ getTurnDispatchCount(): number; setTurnDispatchCount(value: number): void;
33
+ getTurnResearchCount(): number; setTurnResearchCount(value: number): void;
34
+ getTaskDispatchCount(): number; setTaskDispatchCount(value: number): void;
35
+ getTaskResearchCount(): number; setTaskResearchCount(value: number): void;
36
+ getTaskReviewRounds(): number; setTaskReviewRounds(value: number): void;
37
+ getTaskTier(): string | null;
38
+ getTurnReport(): TurnReport;
39
+ getSessionTotals(): SessionTotals;
40
+ getTurnDispatchFingerprints(): Set<string>;
41
+ getExternalBlockers(): Array<{ agent: string; what: string }>;
42
+ getExternalBlockerAcknowledged(): boolean; setExternalBlockerAcknowledged(value: boolean): void;
43
+ getExternalBlockerRefusedOnce(): boolean; setExternalBlockerRefusedOnce(value: boolean): void;
44
+ isAskUserAvailable(): boolean;
45
+ getUserLanguage(): string;
46
+ getSessionDir(): string;
47
+ getAgentStates(): Map<string, AgentState>;
48
+ getAssertions(): Array<{ id: string; tag: string; text: string; source: string; reference?: string; criticalConditions?: string[]; testCommand?: string; status: string; evidence?: string; evidenceTaskId?: string; evidenceRevision?: string }>;
49
+ getResearchPersonas(): ResearchAgentDef[];
50
+ getActiveWritableDispatches(): number; setActiveWritableDispatches(value: number): void;
51
+ getWritableOverlapCounter(): number; setWritableOverlapCounter(value: number): void;
52
+ getProcessState?(): ProcessObligationState;
53
+ processBlock?(): { reason: string; message: string } | null;
54
+ setProcessState?(value: ProcessObligationState): void;
55
+ persistProcessVerdict?(state: ProcessObligationState, verdict: ProcessVerdict): void;
56
+ }
57
+
58
+ export interface DispatchExecutorDeps {
59
+ noProgress: NoProgressGuard;
60
+ state: DispatchExecutionState;
61
+ budget: BudgetContext;
62
+ budgetRecovery: BudgetRecovery;
63
+ artifacts: AssertionsArtifactsContext;
64
+ research: ResearchRuntime<any>;
65
+ provisionalCapabilityRefusal(pack: "fleet"): ToolExecutionResult | null;
66
+ dispatchAgent(agent: string, task: string, ctx: ExtensionContext, artifacts: InputArtifactPreview[], scope: string[], watchdog?: boolean, backend?: "auto" | "native" | "coms", resume?: boolean, resumeContract?: Omit<TaskResumeInput, "previous">): Promise<DispatchResult>;
67
+ runReturnExtraction(path: string, ids: string[], ctx: ExtensionContext): Promise<any>;
68
+ extractNeedsResearch(output: string): string[];
69
+ extractAskUserQuestions(output: string): string[];
70
+ contextPressure(percent: number): boolean;
71
+ displayName(name: string): string;
72
+ getToolCatalogVersion?(): string;
73
+ resolvedAgentModel?(def: AgentState["def"], ctx: ExtensionContext): string | undefined;
74
+ diagnoseChangedTypeScript?: typeof diagnoseChangedTypeScript;
75
+ }
76
+
77
+ interface PreparedDispatch { taskToken: object; taskId: string; beforeRevision: string; requirements: AcceptanceRequirement[]; contract: DeliverableContract; resumeContract: Omit<TaskResumeInput, "previous">; sessionDir: string; agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
78
+ interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; autoResearchTaskCapped: boolean; }
79
+ interface Tracking { writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; }
80
+ interface WorktreeObservation { skipped: boolean; reason?: string; paths: string[]; concurrentWritableOverlap: boolean; }
81
+
82
+ export function preflightGate(d: DispatchExecutorDeps, persona: string): Gate {
83
+ const s = d.state;
84
+ const blocked = checkExternalBlockerGate({ blockers: s.getExternalBlockers(), acknowledged: s.getExternalBlockerAcknowledged(), askUserAvailable: s.isAskUserAvailable(), refusedOnce: s.getExternalBlockerRefusedOnce() });
85
+ if (blocked) { s.setExternalBlockerRefusedOnce(true); return blocked; }
86
+ const blockedProcess = s.processBlock?.();
87
+ if (blockedProcess) return blockedProcess;
88
+ const process = s.getProcessState?.();
89
+ return process && processAllowsPersona(process, persona) ? null : checkTierPersonaGate(s.getTaskTier(), persona);
90
+ }
91
+
92
+ function refusalCategoryFor(status: string, reason?: string): "not_started" | "operator_cancelled" | "unknown_tool" {
93
+ const values = [status, reason].filter((v): v is string => typeof v === "string").map(v => v.toLowerCase());
94
+ if (values.some(v => v.includes("operator_cancel") || v === "cancelled" || v === "canceled")) return "operator_cancelled";
95
+ if (values.some(v => v.includes("unknown_tool"))) return "unknown_tool";
96
+ return "not_started";
97
+ }
98
+
99
+ /** T7: authoritative state snapshot rendered into refusals. Prompt prose never changes
100
+ * state; setter/result/gate share one snapshot (task/tier/source). Refusals show the
101
+ * actual tier/catalog/revision so the operator can correct against reality. */
102
+ function refusalSnapshot(d: DispatchExecutorDeps, ctx: ExtensionContext): string {
103
+ try {
104
+ const tier = (d.state as any)?.getTaskTier?.() ?? "unknown";
105
+ const catalog = (d as any)?.getToolCatalogVersion?.() ?? "unknown";
106
+ let revision = "unavailable";
107
+ try { revision = worktreeRevision(ctx.cwd || process.cwd(), []); } catch {}
108
+ return `Snapshot: tier "${tier}", catalog "${catalog}", revision "${revision}". Prompt prose did not change state.`;
109
+ } catch { return "Snapshot unavailable."; }
110
+ }
111
+
112
+ /** Runtime-owned preflight refusal: never launched a process, never produced effects.
113
+ * Callers must not infer execution from exitCode alone; started:false is authoritative. */
114
+ function refusal(d: DispatchExecutorDeps, agent: string, task: string, status: string, message: string, reason?: string): ToolExecutionResult {
115
+ d.state.getTurnReport().refusals++; d.state.getSessionTotals().refusals++;
116
+ const recoveryCategory = refusalCategoryFor(status, reason);
117
+ return { content: [{ type: "text", text: message }], details: { agent, task, status, reason: reason ?? status, recoveryCategory, elapsed: 0, exitCode: 1, fullOutput: "", started: false, notStarted: true, effects: "none" } };
118
+ }
119
+
120
+ const RESEARCH_DISPATCH_NAMES = new Set(["researcher", "deep-researcher"]);
121
+
122
+ function rosterNames(d: DispatchExecutorDeps): string[] {
123
+ return Array.from(d.state.getAgentStates().values()).map(s => s.def.name);
124
+ }
125
+
126
+ function isResearchDispatchName(d: DispatchExecutorDeps, agent: string): boolean {
127
+ if (RESEARCH_DISPATCH_NAMES.has(agent)) return true;
128
+ return d.state.getResearchPersonas().some(p => normalizeAgentInput(p.name) === agent);
129
+ }
130
+
131
+ function unknownAgentMessage(agent: string, available: string[], researchHint: boolean): string {
132
+ const roster = available.length ? available.join(", ") : "(none)";
133
+ const research = researchHint
134
+ ? `\n\n"${agent}" is a research persona. Call spawn_research with persona "${agent}" instead of dispatch_agent. Do not invent a substitute dispatch.`
135
+ : "";
136
+ return `Unknown agent "${agent}". dispatch_agent only accepts the active roster. Available agents: ${roster}.${research}\n\nDo not invent a substitute dispatch. ${["planner", "code-reviewer", "plan-reviewer", "security-auditor"].includes(agent) ? `Ask the human to activate the required role with /af-agents-add ${agent} or /af-agents-team; this does not change the tier or budget. ` : ""}Use an available agent, or spawn_research for a research persona.`;
137
+ }
138
+
139
+ export function validateDispatchAgent(d: DispatchExecutorDeps, agent: string, task: string): ToolExecutionResult | null {
140
+ const available = rosterNames(d);
141
+ const onRoster = d.state.getAgentStates().has(agent) || available.some(name => normalizeAgentInput(name) === agent);
142
+ if (isResearchDispatchName(d, agent)) {
143
+ return refusal(d, agent, task, "research_persona_via_dispatch", unknownAgentMessage(agent, available, true), "research_persona_via_dispatch");
144
+ }
145
+ if (!onRoster) {
146
+ return refusal(d, agent, task, "unknown_agent", unknownAgentMessage(agent, available, false), "unknown_agent");
147
+ }
148
+ return null;
149
+ }
150
+
151
+ function dispatchRequirements(d: DispatchExecutorDeps, agent: string, task: string): AcceptanceRequirement[] {
152
+ const state = d.state.getAgentStates().get(agent.toLowerCase());
153
+ if (!state || !hasWriteCapability(state.def.tools)) return [];
154
+ const ids = new Set(extractAssertionIds(task));
155
+ const ledger = d.state.getAssertions().filter(assertion => ids.size === 0 || ids.has(assertion.id)).map(assertion => ({
156
+ id: assertion.id, tag: assertion.tag, text: assertion.text, source: assertion.source,
157
+ reference: assertion.reference, criticalConditions: assertion.criticalConditions, testCommand: assertion.testCommand,
158
+ status: assertion.status as AcceptanceRequirement["status"], evidenceTaskId: assertion.evidenceTaskId,
159
+ evidenceRevision: assertion.evidenceRevision, evidenceRefs: assertion.evidence ? [assertion.evidence] : [],
160
+ }));
161
+ return [...ledger, minimalChangeRequirement()];
162
+ }
163
+
164
+ function appendRuntimeAcceptanceContract(task: string, requirements: AcceptanceRequirement[]): string {
165
+ if (!requirements.length) return task;
166
+ const lines = requirements.map(requirement => {
167
+ const origin = [requirement.source, requirement.reference].filter(Boolean).join(" · ");
168
+ const critical = requirement.criticalConditions?.length ? ` Critical: ${requirement.criticalConditions.join("; ")}.` : "";
169
+ return `- ${requirement.id} [${requirement.tag}]: ${requirement.text} (source: ${origin}).${critical}${requirement.testCommand ? ` Explicit verification command: ${JSON.stringify(requirement.testCommand)} (execute only through approved bash).` : ""}`;
170
+ });
171
+ return `${task}\n\n## Runtime acceptance contract (machine-appended)\nThese requirements survive dispatch and compaction. A claim, file presence, or listed command is not proof; report evidence, while the runtime decides acceptance.\n${lines.join("\n")}`;
172
+ }
173
+
174
+ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentParams, ctx: ExtensionContext): PreparedDispatch | ToolExecutionResult {
175
+ const s = d.state; const { task, artifacts, scope, review_reason } = params; const agent = normalizeAgentInput(params.agent);
176
+ const rosterRefusal = validateDispatchAgent(d, agent, task);
177
+ if (rosterRefusal) return rosterRefusal;
178
+ if (s.getAgentStates().get(agent)?.status === "running") return { content: [{ type: "text", text: "Agent is busy; nothing started, queued or charged. Re-invoke explicitly after it is idle." }], details: { status: "busy", reason: "busy", recoveryCategory: "busy", started: false, exitCode: 1 } };
179
+ d.budget.ensureTaskTier();
180
+ const routeReason = plannerRequiredRefusal(task, agent, s.getProcessState?.());
181
+ const processGate = routeReason ? { reason: "planner_required", message: routeReason } : s.processBlock?.() ?? (s.getProcessState ? processPreEffectGate(s.getProcessState(), "child", agent) : { reason: "process_state_unavailable", message: "Process state is unavailable; child launch fails closed." });
182
+ const preflight = preflightGate(d, agent) ?? processGate ?? checkReviewRoundCap(s.getTaskTier(), agent, s.getTaskReviewRounds()) ?? (s.getProcessState && processAllowsPersona(s.getProcessState(), agent) ? null : checkDocsLane(agent, scope || [], review_reason));
183
+ if (preflight) return refusal(d, agent, task, preflight.reason, `${preflight.message}\n\n${refusalSnapshot(d, ctx as any)}`, preflight.reason);
184
+ const taskRefusal = checkTaskBudget("dispatch", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
185
+ if (taskRefusal) return refusal(d, agent, task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
186
+ const turnRefusal = checkTurnBudget("dispatch", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
187
+ if (turnRefusal) return refusal(d, agent, task, "budget_refused", turnRefusal.message, turnRefusal.reason);
188
+ let contract: DeliverableContract;
189
+ try { contract = preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: s.getSessionDir() }); }
190
+ catch (error) { return refusal(d, agent, task, "scope_preflight_failed", String(error)); }
191
+ const fingerprint = taskFingerprint(agent, task);
192
+ if (s.getTurnDispatchFingerprints().has(fingerprint)) return refusal(d, agent, task, "duplicate_refused", `⚠ Duplicate dispatch refused: you already dispatched ${agent} with this task (or a trivial rewording of it) THIS turn. Use the earlier result — re-read its digest/returnPath — or change the task materially (new instructions, corrected inputs) before re-dispatching.`);
193
+ let inputArtifacts: InputArtifactPreview[];
194
+ try { inputArtifacts = d.artifacts.loadInputArtifacts(artifacts, ctx); }
195
+ catch (err: any) { return { content: [{ type: "text", text: `⚠ Dispatch NOT sent and NOT counted against the turn budget — input artifact could not be resolved:\n${err?.message || err}\n\nFix the path and dispatch again.` }], details: { agent, task, status: "artifact_preflight_failed", reason: "artifact_preflight_failed", recoveryCategory: "not_started" as const, elapsed: 0, exitCode: 1, fullOutput: "", started: false, notStarted: true, effects: "none" } }; }
196
+ s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1);
197
+ if (isReviewPersona(agent)) s.setTaskReviewRounds(s.getTaskReviewRounds() + 1);
198
+ s.getSessionTotals().dispatches++; d.budget.updateModeStatus();
199
+ const scopeGlobs = (scope || []).map(String).map(x => x.trim()).filter(Boolean);
200
+ const requirements = dispatchRequirements(d, agent, task);
201
+ const acceptedTask = appendRuntimeAcceptanceContract(task, requirements);
202
+ const declaredTask = contract.files.length ? `${acceptedTask}\n\n## Expected deliverables (explicit contract)\nProduce these exact files and report their paths. The hub will read them back; a prose claim is not delivery.\n${contract.files.map(file => `- ${file.path}`).join("\n")}` : acceptedTask;
203
+ const agentState = s.getAgentStates().get(agent.toLowerCase());
204
+ const resumeContract = {
205
+ taskId: d.noProgress.taskId(), instructions: declaredTask, scope: scopeGlobs,
206
+ deliverables: contract.files.map(file => file.path), artifacts: inputArtifacts.map(artifact => artifact.path),
207
+ model: agentState ? (d.resolvedAgentModel?.(agentState.def, ctx) ?? agentState.def.model ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : null)) : null,
208
+ permissions: agentState?.def.tools ?? "",
209
+ };
210
+ return { taskToken: d.noProgress.taskToken(), taskId: resumeContract.taskId, beforeRevision: worktreeRevision(ctx.cwd || process.cwd(), []), requirements, contract, resumeContract, sessionDir: s.getSessionDir(), agent, task: declaredTask, inputArtifacts, scopeGlobs, fingerprint };
211
+ }
212
+
213
+ function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx: ExtensionContext): Tracking {
214
+ const s = d.state; const state = s.getAgentStates().get(prepared.agent.toLowerCase()); const canWrite = !!state && hasWriteCapability(state.def.tools);
215
+ const tracking = { writable: canWrite, snapshot: null as any, overlapBaseline: s.getWritableOverlapCounter(), concurrentAtStart: false };
216
+ if (canWrite) {
217
+ tracking.concurrentAtStart = s.getActiveWritableDispatches() > 0;
218
+ if (tracking.concurrentAtStart) s.setWritableOverlapCounter(s.getWritableOverlapCounter() + 1);
219
+ s.setActiveWritableDispatches(s.getActiveWritableDispatches() + 1);
220
+ tracking.snapshot = snapshotWorktree(ctx.cwd || process.cwd());
221
+ }
222
+ return tracking;
223
+ }
224
+
225
+ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<RunData> {
226
+ const findingClause = reviewBudgetClause(d.state.getTaskTier(), p.agent); const dispatchedTask = findingClause ? `${p.task}\n\n${findingClause}` : p.task;
227
+ let result = await d.dispatchAgent(p.agent, dispatchedTask, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", false, p.resumeContract);
228
+ let billed = result.billed ?? 0; let out = result.out ?? 0; const researchRounds: RunData["researchRounds"] = []; let autoResearchTaskCapped = false;
229
+ while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS && p.taskToken === d.noProgress.taskToken() && p.sessionDir === d.state.getSessionDir()) {
230
+ const left = remainingTaskResearch(d.budget.currentTaskBudget(), d.budget.taskCounters()); if (left === 0) { autoResearchTaskCapped = true; break; }
231
+ const questions = d.extractNeedsResearch(result.output).slice(0, left == null ? MAX_AUTO_RESEARCH_QUESTIONS : Math.min(MAX_AUTO_RESEARCH_QUESTIONS, left)); if (!questions.length) break;
232
+ d.state.setTaskResearchCount(d.state.getTaskResearchCount() + questions.length); d.budget.updateModeStatus();
233
+ onUpdate?.({ content: [{ type: "text", text: `${p.agent} paused for research (${questions.length} question(s)) — spawning read-only helpers...` }], details: { agent: p.agent, task: p.task, status: "researching" } });
234
+ const findingsDir = safePathWithin(p.sessionDir, "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
235
+ const answered = await Promise.all(questions.map(async question => {
236
+ const def = d.research.anonymousDef(); const state = d.research.createState(def, false, d.research.resolveModel(def, undefined, ctx));
237
+ const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-${response.dispatchId ?? randomUUID()}.md`);
238
+ writeFileSync(file, `# Research findings r${state.id}\n\n**Question:** ${question}\n\n${response.exitCode === 0 ? response.output : `(research helper failed, exit ${response.exitCode})\n\n${response.output}`}\n`, { encoding: "utf-8", flag: "wx" }); return { question, file };
239
+ }));
240
+ researchRounds.push({ questions, files: answered.map(a => a.file) });
241
+ const resume = "Research findings for your NEEDS_RESEARCH questions are ready. Read each file with your read tool, then continue from where you paused:\n" + answered.map((a, i) => `${i + 1}. ${a.question}\n → ${a.file}`).join("\n");
242
+ if (p.taskToken !== d.noProgress.taskToken() || p.sessionDir !== d.state.getSessionDir()) break;
243
+ result = await d.dispatchAgent(p.agent, resume, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", true, p.resumeContract); billed += result.billed ?? 0; out += result.out ?? 0;
244
+ }
245
+ return { result, billed, out, researchRounds, autoResearchTaskCapped };
246
+ }
247
+
248
+ function observeWorktree(d: DispatchExecutorDeps, tracking: Tracking, ctx: ExtensionContext): WorktreeObservation | null {
249
+ if (!tracking.snapshot) return null;
250
+ const diff = diffAgainst(tracking.snapshot, ctx.cwd || process.cwd());
251
+ const concurrentWritableOverlap = tracking.concurrentAtStart || d.state.getWritableOverlapCounter() !== tracking.overlapBaseline;
252
+ return diff.skipped
253
+ ? { skipped: true, reason: diff.reason, paths: [], concurrentWritableOverlap }
254
+ : { skipped: false, paths: diff.paths, concurrentWritableOverlap };
255
+ }
256
+
257
+ function scopeResult(p: PreparedDispatch, observation: WorktreeObservation | null): any {
258
+ if (!observation || p.scopeGlobs.length === 0) return null;
259
+ if (observation.skipped) return { skipped: true, reason: observation.reason, declaredScope: p.scopeGlobs, concurrentWritableOverlap: observation.concurrentWritableOverlap };
260
+ return { ...checkScope(observation.paths, p.scopeGlobs), changedPaths: observation.paths, declaredScope: p.scopeGlobs, concurrentWritableOverlap: observation.concurrentWritableOverlap };
261
+ }
262
+
263
+ function incompleteObservation(reason: string, overlap: boolean): DiagnosticsResult {
264
+ return { status: "incomplete", reason, changedFiles: [], attribution: overlap ? "uncertain" : "no_observed_overlap", projects: [], uncoveredFiles: [] };
265
+ }
266
+
267
+ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
268
+ const s = d.state; const { result, researchRounds } = run; const cwd = ctx.cwd || process.cwd();
269
+ const sameTaskNow = () => p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir();
270
+ const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
271
+ // Observe immediately at logical child completion, before Hub-owned artifacts are written.
272
+ const observation = tracking.writable ? observeWorktree(d, tracking, ctx) : null;
273
+ const deliveredReturn = parseDeliveredReturn(result.output, ids, disposition.delivered);
274
+ let parsedReturn: any = deliveredReturn.parsed; let contractNotices: any[] = deliveredReturn.notices;
275
+ const shouldUseDigest = ids.length > 0 || !!parsedReturn; const state = sameTaskNow() ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined;
276
+ const key = safeAgentKey(state?.def.name ?? p.agent); const backendUsed = state?.lastBackend ?? null;
277
+ const failureMetadata = { dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null,
278
+ agent: p.agent, task: p.task, scope: p.scopeGlobs, exitCode: result.exitCode, diagnostics: result.diagnostics ?? null };
279
+ const artifactOutput = disposition.delivered ? result.output
280
+ : `# Dispatch failure\n\n\`\`\`json\n${JSON.stringify(failureMetadata, null, 2)}\n\`\`\`\n\n## Output\n\n${result.output}`;
281
+ const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind as any, result.dispatchId, p.sessionDir) : null;
282
+ const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
283
+ if (returnPath && shouldExtractReturn(parsedReturn, ids)) {
284
+ onUpdate?.({ content: [{ type: "text", text: `${p.agent} returned no structured block — extracting it from the report...` }], details: { agent: p.agent, task: p.task, status: "extracting_return" } });
285
+ const recovered = await d.runReturnExtraction(returnPath, ids, ctx);
286
+ if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
287
+ }
288
+
289
+ // The one shared post-run delta feeds both scope reporting and compiler selection.
290
+ let compilerDiagnostics: DiagnosticsResult | null = null; let compilerEvidencePath: string | null = null; let compilerEvidenceError: string | null = null;
291
+ const compilerInspectedRevision = worktreeRevision(cwd, []);
292
+ const eligibleForCompiler = disposition.delivered && tracking.writable && backendUsed === "native" && sameTaskNow();
293
+ if (eligibleForCompiler && observation?.skipped) {
294
+ compilerDiagnostics = incompleteObservation(`worktree observation unavailable: ${observation.reason ?? "unknown reason"}`, observation.concurrentWritableOverlap);
295
+ } else if (eligibleForCompiler && observation && observation.paths.some(path => /\.(?:ts|tsx|mts|cts)$/i.test(path))) {
296
+ try {
297
+ compilerDiagnostics = await (d.diagnoseChangedTypeScript ?? diagnoseChangedTypeScript)(observation.paths, {
298
+ cwd,
299
+ attribution: observation.concurrentWritableOverlap ? "uncertain" : "no_observed_overlap",
300
+ cacheLane: key,
301
+ runId: result.dispatchId ?? randomUUID(),
302
+ });
303
+ } catch (error) {
304
+ compilerDiagnostics = incompleteObservation(`compiler diagnostics failed safely: ${String(error)}`, observation.concurrentWritableOverlap);
305
+ }
306
+ }
307
+ if (observation) {
308
+ observation.concurrentWritableOverlap = observation.concurrentWritableOverlap || tracking.concurrentAtStart || s.getWritableOverlapCounter() !== tracking.overlapBaseline;
309
+ if (compilerDiagnostics && observation.concurrentWritableOverlap) compilerDiagnostics = { ...compilerDiagnostics, attribution: "uncertain" };
310
+ }
311
+ const sameTask = sameTaskNow();
312
+ if (sameTask && compilerDiagnostics) {
313
+ const correction = correctStructuredReturnForCompiler(parsedReturn, ids, compilerDiagnostics);
314
+ parsedReturn = correction.parsed;
315
+ contractNotices = [...crossCheck(parsedReturn, ids), ...correction.demotedIds.map(id => ({ type: "compiler_diagnostics", id }))];
316
+ }
317
+ const assessmentId = result.dispatchId ?? randomUUID();
318
+ if (compilerDiagnostics && compilerDiagnostics.status !== "skipped") {
319
+ try {
320
+ compilerEvidencePath = d.artifacts.writeRunArtifact(`${key}-compiler`, state?.runCount ?? 0,
321
+ `# Compiler diagnostics\n\n\`\`\`json\n${JSON.stringify(compilerDiagnostics, null, 2)}\n\`\`\`\n`, "evidence", assessmentId, p.sessionDir);
322
+ } catch (error) { compilerEvidenceError = String(error); }
323
+ }
324
+ const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd, sessionDir: p.sessionDir },
325
+ (index, bytes) => retainDeliverable(p.sessionDir, assessmentId, index, bytes));
326
+ let protocolDiagnostic: ToolProtocolDiagnostic | null = null; let protocolEvidencePath: string | null = null;
327
+ if (disposition.delivered && backendUsed === "native") {
328
+ protocolDiagnostic = diagnoseToolProtocol({
329
+ output: result.output,
330
+ toolEvents: result.toolEvents ?? [],
331
+ deliverables: readback,
332
+ origin: { kind: "task", taskId: p.taskId, dispatchId: result.dispatchId ?? assessmentId },
333
+ effectiveConfiguration: {
334
+ backend: backendUsed,
335
+ model: result.diagnostics?.modelUsed ?? state?.def.model ?? null,
336
+ tools: result.diagnostics?.effectiveTools ?? String(state?.def.tools ?? "").split(",").map(tool => tool.trim()).filter(Boolean),
337
+ },
338
+ evidenceRefs: [returnPath ?? undefined, ...readback.map(item => item.retainedPath)].filter((value): value is string => !!value),
339
+ });
340
+ if (protocolDiagnostic) {
341
+ protocolEvidencePath = d.artifacts.writeRunArtifact(`${key}-tool-protocol`, state?.runCount ?? 0,
342
+ JSON.stringify(protocolDiagnostic, null, 2), "evidence", randomUUID(), p.sessionDir);
343
+ protocolDiagnostic.evidenceRefs = [...new Set([...protocolDiagnostic.evidenceRefs, protocolEvidencePath])];
344
+ }
345
+ }
346
+ const executionStatus = disposition.pending ? "pending" : disposition.delivered ? "completed" : "failed";
347
+ const afterRevision = worktreeRevision(cwd, []);
348
+ const changes = !tracking.writable || !observation
349
+ ? { status: "unknown" as const, paths: [] as string[], attribution: "not_observed" as const }
350
+ : observation.skipped
351
+ ? { status: "unknown" as const, paths: [] as string[], attribution: "not_observed" as const }
352
+ : { status: observation.paths.length ? "changed" as const : "unchanged" as const, paths: observation.paths, attribution: observation.concurrentWritableOverlap ? "uncertain" as const : "certain" as const };
353
+ const checks: VerificationCheckInput[] = (compilerDiagnostics?.projects ?? []).map(project => ({
354
+ producer: "runtime", kind: "compilation", taskId: p.taskId, command: [...(project.argv ?? [])], exitCode: project.exitCode,
355
+ inspectedRevision: compilerInspectedRevision, evidenceRef: compilerEvidencePath ?? "",
356
+ requirementIds: ["AF-MIN-CHANGE"],
357
+ }));
358
+ for (const record of backendUsed === "native" && tracking.writable ? result.runtimeTests ?? [] : []) for (const kind of ["test", "code-grep"] as const) {
359
+ const covered = p.requirements.filter(requirement => requirement.tag === kind && requirement.source && requirement.testCommand === record.command);
360
+ if (!covered.length) continue;
361
+ const coverage = covered.map(requirement => ({ id: requirement.id, source: requirement.source, text: requirement.text, reference: requirement.reference, criticalConditions: requirement.criticalConditions ?? [] }));
362
+ // This artifact records the observed command and declared coverage, not a
363
+ // pre-evaluation ledger snapshot. The acceptance artifact evaluates this
364
+ // check against the current task/revision and exact requirement binding.
365
+ const evidenceRef = d.artifacts.writeRunArtifact(`${key}-test-check`, state?.runCount ?? 0, JSON.stringify({
366
+ schema: "agent-fleet.runtime-test-evidence/v1",
367
+ observation: record,
368
+ declaration: { taskId: p.taskId, dispatchId: result.dispatchId, kind, coverage },
369
+ evaluationSource: "agent-fleet.runtime-result/v1 verification.checks and verification.requirements",
370
+ }, null, 2), "evidence", randomUUID(), p.sessionDir);
371
+ checks.push({ producer: "runtime", kind, command: [record.command], exitCode: record.exitCode,
372
+ inspectedRevision: record.beforeRevision === record.afterRevision ? record.afterRevision : "changed-during-check",
373
+ evidenceRef, requirementIds: ["AF-MIN-CHANGE", ...covered.map(requirement => requirement.id)], taskId: p.taskId,
374
+ coverage,
375
+ });
376
+ }
377
+ const runtimeResult: any = buildRuntimeResult({
378
+ task: { id: p.taskId, current: sameTask && p.taskId === d.noProgress.taskId(), beforeRevision: p.beforeRevision, afterRevision },
379
+ execution: { status: executionStatus, exitCode: result.exitCode, dispatchId: result.dispatchId ?? null },
380
+ changes, requirements: p.requirements, deliverables: readback, checks,
381
+ evidenceRefs: [returnPath ?? undefined, failurePath ?? undefined, compilerEvidencePath ?? undefined, protocolEvidencePath ?? undefined].filter((value): value is string => !!value),
382
+ });
383
+ let processVerdict: ProcessVerdict | null = null;
384
+ if (s.getProcessState) {
385
+ let processState = s.getProcessState();
386
+ const taskChanges = (paths: string[]) => reviewableChangedPaths(paths, cwd, p.sessionDir, p.scopeGlobs, p.contract.files.map(file => file.path));
387
+ if (runtimeResult.acceptance.accepted && runtimeResult.verification.evidenceRefs[0]) {
388
+ processState = noteProcessStage(processState, "acceptance", { evidenceRef: runtimeResult.verification.evidenceRefs[0], revision: afterRevision, changedFiles: taskChanges(observation?.paths ?? []) });
389
+ }
390
+ const stage = p.agent === "planner" ? "plan" : isReviewPersona(p.agent) ? "review" : null;
391
+ const affirmativeReview = /(?:^|\n)\s*(?:verdict\s*:\s*)?APPROVE\b/im.test(result.output) && !/(?:^|\n)\s*(?:verdict\s*:\s*)?REJECT\b/im.test(result.output);
392
+ const reviewScope = checkScope(processState.changedFiles, p.scopeGlobs);
393
+ const reviewAuthorized = stage !== "review" || (affirmativeReview && processState.changedFiles.length > 0 && reviewScope.outOfScope.length === 0 && reviewMayClose({ revision: afterRevision, scope: processState.changedFiles, output: result.output, evidenceRef: runPath ?? undefined, declared: !!parsedReturn, wide: processState.scope === "wide" || !!processState.additions?.some(item => item.status === "active" && item.reason === "wide_change") }));
394
+ // A declared plan must read back successfully; a refusal or unresolved
395
+ // decision is not plan evidence. No declaration still permits a retained
396
+ // nonempty plan return. The Hub cannot judge its semantic adequacy.
397
+ const planProduced = stage !== "plan" || (result.output.trim().length > 0
398
+ && runtimeResult.compatibility.hubAcceptanceStatus !== "deliverable_failed"
399
+ && !(parsedReturn?.requires_user_decision ?? []).some((entry: unknown) => String(entry).trim().toLowerCase() !== "none")
400
+ && d.extractNeedsResearch(result.output).length === 0 && d.extractAskUserQuestions(result.output).length === 0);
401
+ if (stage && planProduced && reviewAuthorized && disposition.delivered && result.exitCode === 0 && sameTask && runPath) {
402
+ processState = noteProcessStage(processState, stage, { evidenceRef: runPath, revision: afterRevision });
403
+ }
404
+ const planDeliverable = p.contract.files.map(file => file.path).find(path => /plan/i.test(path));
405
+ if (p.agent === "builder" && planDeliverable && runPath && authorizePlanStatusUpdate({ planPath: planDeliverable, allowedScope: p.scopeGlobs, evidenceRefs: [runPath] }).allowed && sameTask) {
406
+ processState = noteProcessStage(processState, "plan", { evidenceRef: runPath, revision: afterRevision });
407
+ }
408
+ s.setProcessState?.(processState);
409
+ processVerdict = evaluateProcessObligations(processState, { writable: tracking.writable || stage !== null, budgetTier: s.getTaskTier() ?? "small", t2Accepted: runtimeResult.acceptance.accepted, currentRevision: afterRevision });
410
+ runtimeResult.process = processVerdict;
411
+ if (!processVerdict.accepted) {
412
+ runtimeResult.acceptance = { status: "not_accepted", accepted: false, reasons: [...new Set([...runtimeResult.acceptance.reasons, ...Object.entries(processVerdict.obligations).filter(([, value]) => value.status === "open").map(([name]) => `process_${name}_open`)])] };
413
+ if (runtimeResult.compatibility.hubAcceptanceStatus !== "deliverable_failed") runtimeResult.compatibility = { hubAcceptanceStatus: "needs_verification", flowStatus: "rejected" };
414
+ }
415
+ s.persistProcessVerdict?.(processState, processVerdict);
416
+ if (s.processBlock?.()) {
417
+ runtimeResult.acceptance = { status: "not_accepted", accepted: false, reasons: [...new Set([...runtimeResult.acceptance.reasons, s.processBlock()!.reason])] };
418
+ runtimeResult.compatibility = { hubAcceptanceStatus: "needs_verification", flowStatus: "rejected" };
419
+ }
420
+ }
421
+ if (sameTask && result.dispatchId && !disposition.pending) {
422
+ // T2/F3: use the canonical wrapper identity so production reconcile can match.
423
+ // Previously this wrote raw p.agent while the wrapper used canonical([cwd, actor]).
424
+ d.noProgress.recordDispatchEvidence({
425
+ dispatchId: result.dispatchId, taskId: p.taskId, executor: canonicalExecutor(cwd, p.agent), revision: afterRevision,
426
+ changedScope: changes.attribution === 'certain' ? changes.paths : [], readback,
427
+ concurrentWriters: observation?.concurrentWritableOverlap ?? true,
428
+ effectsRef: protocolEvidencePath ?? undefined,
429
+ completed: disposition.delivered && result.exitCode === 0,
430
+ blockingFindings: isReviewPersona(p.agent) && countReviewFindings(result.output).nonBlocking > 0 ? countReviewFindings(result.output).blocking : -1,
431
+ coveredScope: isReviewPersona(p.agent) && result.exitCode === 0 ? d.noProgress.reviewCoverage(p.taskId).filter(path => checkScope([path], p.scopeGlobs).outOfScope.length === 0) : [],
432
+ edited: p.beforeRevision !== afterRevision || !!observation && (observation.skipped || observation.paths.length > 0),
433
+ evidenceRef: runPath ?? '', openRequirements: runtimeResult.verification.requirements.filter((r: any) => r.status !== 'passed').map((r: any) => r.id),
434
+ });
435
+ }
436
+ const accepted = runtimeResult.acceptance.accepted;
437
+ const acceptanceStatus = runtimeResult.compatibility.hubAcceptanceStatus;
438
+ const questions = d.extractAskUserQuestions(result.output);
439
+ const contractGap = acceptanceStatus === "deliverable_failed" ? "missing_deliverable" : !parsedReturn && questions.length ? "missing_structured_return" : null;
440
+ const blockedOnUser = questions.length > 0 && !protocolDiagnostic && executionStatus === "completed";
441
+ const status = protocolDiagnostic ? "tool_protocol_error" : blockedOnUser ? "blocked_on_user" : accepted ? "accepted" : executionStatus === "completed" && (runtimeResult.verification.status === "failed" || acceptanceStatus === "deliverable_failed") ? "verification_failed" : executionStatus === "completed" ? "completed_unverified" : disposition.status;
442
+ const assessment = { ...runtimeResult,
443
+ executionStatus, acceptanceStatus, accepted, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots,
444
+ assertions: ids, structuredReturn: parsedReturn, contractNotices, compilerDiagnostics, compilerEvidencePath, protocolDiagnostic, protocolEvidencePath };
445
+ const assessmentPath = disposition.pending ? null : d.artifacts.writeRunArtifact(`${key}-acceptance`, state?.runCount ?? 0, JSON.stringify(assessment, null, 2), "evidence", assessmentId, p.sessionDir);
446
+ if (sameTask && [0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
447
+ if (sameTask) { s.getTurnReport().dispatches.push({ agent: p.agent, status, elapsed: result.elapsed, billed: run.billed, out: run.out }); s.getSessionTotals().billed += run.billed; s.getSessionTotals().out += run.out; }
448
+ const unresolved = d.extractNeedsResearch(result.output); const answered = researchRounds.reduce((n, r) => n + r.questions.length, 0);
449
+ const notices: string[] = [];
450
+ if (!sameTask) notices.push("Late result from a prior task/session: evidence retained in its original namespace; current-task counters and blockers were not changed.");
451
+ if (disposition.delivered) notices.push(accepted
452
+ ? `Execution and current-state verification accepted by the runtime contract. Acceptance check: ${assessmentPath}`
453
+ : protocolDiagnostic
454
+ ? `Tool protocol error: ${protocolDiagnostic.message} Evidence: ${protocolEvidencePath}. No text was executed and no retry was started.`
455
+ : `Execution completed, NOT accepted. ${acceptanceStatus === "deliverable_failed" ? "Expected deliverable readback failed." : "Verification is missing, failed, stale, unsupported, or attribution-uncertain; file presence, exit 0, and claims are not proof."} Acceptance check: ${assessmentPath}`);
456
+ if (readback.some(file => file.changed === false)) notices.push("Some deliverables already existed unchanged. Do not attribute their creation to this execution.");
457
+ const blockers = extractExternalBlockers(result.output); if (sameTask && blockers.length) { for (const what of blockers) if (!s.getExternalBlockers().some(b => b.what === what)) s.getExternalBlockers().push({ agent: p.agent, what }); s.setExternalBlockerAcknowledged(false); s.setExternalBlockerRefusedOnce(false); notices.push(`⛔ ${p.agent} reported an EXTERNAL BLOCKER — something outside the fleet's reach is missing:\n${blockers.map((w, i) => ` ${i + 1}. ${w}`).join("\n")}\nThe next dispatch/research call is refused until you escalate this to the human. Do not build a substitute for the missing fact.`); }
458
+ if (questions.length) notices.push(`⚠ ${questions.length} ASK_USER question(s) raised by ${p.agent}. You MUST call ask_user for each (in ${s.getUserLanguage()}) before re-dispatching. Resume only with USER_ANSWER: ${result.dispatchId ?? "<dispatchId>"} :: <question>:\n${questions.map((q, i) => ` ${i + 1}. ${q}`).join("\n")}`);
459
+ notices.push("Orchestration handoff is in details.orchestration. Start from its manifest; reread a file only when it is missing, stale, or conflicting. A wide review closes only with a full regression marker. Model routing was not changed.");
460
+ if (researchRounds.length) notices.push(`ℹ ${p.agent} auto-paused for research ${researchRounds.length} round(s); ${answered} question(s) answered by read-only helpers. Findings were saved under ${safePathWithin(s.getSessionDir(), "findings")} and read by the agent directly — they are NOT inlined here.`);
461
+ if (unresolved.length && researchRounds.length >= MAX_AUTO_RESEARCH_ROUNDS) notices.push(`⚠ ${p.agent} still requests research (${unresolved.length} question(s)) but the auto-research budget is exhausted. Run spawn_research yourself and re-dispatch with the findings, or simplify the task.`);
462
+ if (run.autoResearchTaskCapped) notices.push(`⚠ ${p.agent} paused for research, but the TASK research envelope is spent (${s.getTaskResearchCount()}/${d.budget.currentTaskBudget().maxResearch}) — no helper was spawned and the specialist was not resumed. Its questions are unanswered. Narrow the task so it can proceed on what it has, or call set_task_tier with new_task: true if this is genuinely different work.`);
463
+ if (returnPath) notices.push(`Full specialist output: ${returnPath}`);
464
+ if (disposition.pending) notices.push("⏳ DELIVERY PENDING — no result or assertion evidence is available yet, and no return/failure artifact was written. Use the msg_id above with coms_get/coms_await; do not re-dispatch.");
465
+ if (failurePath) notices.push(`⚠ DELIVERY FAILURE (exit ${result.exitCode}) — no specialist result was returned. The error output is at ${failurePath}; it is NOT a return and carries no assertion evidence. The work may or may not have happened — check the artifacts the task was supposed to produce before re-dispatching.`);
466
+ if (compilerDiagnostics && compilerDiagnostics.status !== "skipped") {
467
+ const advisory = formatAdvisory(compilerDiagnostics);
468
+ const evidence = compilerEvidencePath ? `Full compiler evidence: ${compilerEvidencePath}` : `Compiler evidence artifact unavailable: ${compilerEvidenceError ?? "unknown error"}`;
469
+ if (advisory) notices.push(`${advisory}\n${evidence}`);
470
+ else if (compilerDiagnostics.projects.length) notices.push(`Compiler diagnostics completed with no errors. ${evidence}`);
471
+ }
472
+ const corrected = p.inputArtifacts.filter(a => a.resolvedFromKind); if (corrected.length) notices.push(`ℹ Artifact path corrected: ${corrected.map(a => `"${a.input}" → ${a.displayPath}`).join("; ")}. Use the corrected path from now on.`);
473
+ if (state && d.contextPressure(state.contextPct)) notices.push(`⚠ ${d.displayName(state.def.name)} context at ${Math.ceil(state.contextPct)}% — consider /af-agents-restart ${state.def.name} (state lives in the artifacts/ledger, a restart is cheap).`);
474
+ const scopeViolations = scopeResult(p, observation); const scopeNotice = scopeNoticeText(scopeViolations); if (scopeNotice) notices.push(scopeNotice.trim());
475
+ const finding = isReviewPersona(p.agent) ? findingBudgetNotice(p.agent, blockingFindingCap(s.getTaskTier()), countReviewFindings(result.output), s.getTaskReviewRounds(), reviewRoundCap(s.getTaskTier())) || "" : ""; if (finding) notices.push(finding.trim());
476
+ const docs = docsLaneNotice(p.agent, p.scopeGlobs, processVerdict?.obligations?.review?.status === "open"); if (docs) notices.push(docs);
477
+ const contract = contractNoticeText(contractNotices); const extraction = returnExtracted ? "ℹ The specialist declared no structured return. The block below was EXTRACTED from its report by a cheap read-only pass — weaker than a declared return. Verify the named evidence before you gate on it." : "";
478
+ const digest = shouldUseDigest ? [extraction, structuredReturnDigest(parsedReturn) || "Structured return: (none parsed)", contract].filter(Boolean).join("\n\n") : (result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output);
479
+ return { content: [{ type: "text", text: `[${p.agent}] ${status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}${processVerdict ? `\n\nProcess: ${processVerdict.explanation}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status, ...(protocolDiagnostic ? { recoveryCategory: "tool_protocol_error", reason: protocolDiagnostic.message, protocolDiagnostic, protocolEvidencePath, protocolEffectsEvidenceRef: protocolEvidencePath } : blockedOnUser ? { recoveryCategory: "blocked_on_user", reason: "waiting for a recorded user answer", protocolDiagnostic: null, protocolEvidencePath: null } : { protocolDiagnostic: null, protocolEvidencePath: null }), contractGap, executionStatus, acceptanceStatus, accepted, runtimeResult, processVerdict, taskIdentity: runtimeResult.task, changeResult: runtimeResult.changes, verificationResult: runtimeResult.verification, staleTask: !sameTask, deliverableReadback: readback, scopeRoots: p.contract.scopeRoots, assessmentPath, backendRequested: params.backend ?? "auto", backendUsed, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null, diagnostics: result.diagnostics ?? null, evidencePath: result.evidencePath ?? null, lifecycle: (result as any).lifecycle ?? null, termination: (result as any).termination ?? (result.diagnostics as any)?.termination ?? null, spawnError: (result.diagnostics as any)?.spawnError ?? null, compilerDiagnostics, compilerEvidencePath, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, orchestration: activeOrchestrationHandoff({ agent: p.agent, task: p.task, scope: p.scopeGlobs, revision: afterRevision, changes: changes.attribution === "certain" ? changes.paths : [], exitCode: result.exitCode, questions, evidenceRefs: runtimeResult.verification.evidenceRefs, approvedPlan: !!s.getProcessState?.().plan?.evidenceRef, risk: s.getProcessState?.().risk === "high" ? "high" : "low", scopeBreadth: s.getProcessState?.().scope === "wide" ? "wide" : "narrow", sharedCode: false, model: backendUsed ?? undefined, elapsedMs: result.elapsed }), researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
480
+ }
481
+
482
+ function dispatchExecutionConditions(d: DispatchExecutorDeps, params: DispatchAgentParams, ctx: ExtensionContext): Record<string, unknown> {
483
+ const state = d.state.getAgentStates().get(normalizeAgentInput(params.agent));
484
+ return {
485
+ model: (state ? d.resolvedAgentModel?.(state.def, ctx) : undefined) ?? state?.def.model ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : null),
486
+ backend: params.backend ?? "auto",
487
+ };
488
+ }
489
+
490
+ function researchExecutionConditions(d: DispatchExecutorDeps, params: SpawnResearchParams, ctx: ExtensionContext): Record<string, unknown> {
491
+ const persona = params.persona ? d.state.getResearchPersonas().find(item => item.name.toLowerCase() === params.persona!.toLowerCase()) : undefined;
492
+ try {
493
+ const def = persona ?? d.research.anonymousDef();
494
+ return { model: d.research.resolveModel(def, persona ? undefined : params.model, ctx), tools: "read,grep,find,ls" };
495
+ } catch {
496
+ return { model: params.model ?? null, tools: "read,grep,find,ls" };
497
+ }
498
+ }
499
+
500
+ export function structuredResearchPrompt(params: SpawnResearchParams): string {
501
+ const contract = normalizeResearchContract(params);
502
+ if (!contract.readScope.length && !contract.goal && !contract.expectedResult) return params.task;
503
+ return [params.task, "", "## Structured research contract",
504
+ contract.readScope.length ? `Read scope:\n${contract.readScope.map(path => `- ${path}`).join("\n")}` : "Read scope: not declared",
505
+ contract.goal ? `Goal: ${contract.goal}` : "Goal: not declared",
506
+ contract.expectedResult ? `Expected result: ${contract.expectedResult}` : "Expected result: not declared",
507
+ ].join("\n");
508
+ }
509
+
510
+ export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
511
+ return withNoProgress(d, "dispatch", async (_id, params, signal, onUpdate, ctx) => {
512
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability;
513
+ const agent = normalizeAgentInput(params.agent);
514
+ const invalid = validateDispatchAgent(d, agent, params.task); if (invalid) return invalid;
515
+ if (d.state.getAgentStates().get(agent)?.status === "running") return { content: [{ type: "text", text: "Agent is busy; nothing started, queued or charged. Re-invoke explicitly after it is idle." }], details: { status: "busy", reason: "busy", recoveryCategory: "busy", started: false, exitCode: 1 } };
516
+ d.budget.ensureTaskTier();
517
+ const processGate = d.state.processBlock?.() ?? (d.state.getProcessState ? processPreEffectGate(d.state.getProcessState(), "child", agent) : { reason: "process_state_unavailable", message: "Process state is unavailable; child launch fails closed." });
518
+ const preflight = preflightGate(d, agent) ?? processGate ?? checkReviewRoundCap(d.state.getTaskTier(), agent, d.state.getTaskReviewRounds()) ?? (d.state.getProcessState && processAllowsPersona(d.state.getProcessState(), agent) ? null : checkDocsLane(agent, params.scope || [], params.review_reason));
519
+ if (preflight) return refusal(d, agent, params.task, preflight.reason, `${preflight.message}\n\n${refusalSnapshot(d, ctx)}`);
520
+ try { preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: d.state.getSessionDir() }); }
521
+ catch (error) { return refusal(d, agent, params.task, "scope_preflight_failed", String(error)); }
522
+ const budgetBlock = await d.budgetRecovery.ensure("dispatch", `${agent}: ${params.task}`, ctx, signal);
523
+ if (budgetBlock) return refusal(d, agent, params.task, budgetBlock.reason, budgetBlock.message);
524
+ if (signal?.aborted) return refusal(d, agent, params.task, "cancelled", "Operation cancelled before dispatch.");
525
+ const prepared = prepareDispatch(d, params, ctx); if (!("agent" in prepared)) return prepared;
526
+ const tracking = startTracking(d, prepared, ctx);
527
+ try { onUpdate?.({ content: [{ type: "text", text: `Dispatching to ${prepared.agent}...` }], details: { agent: prepared.agent, task: prepared.task, status: "dispatching" } }); return await finishDispatch(d, prepared, params, await runWithAutoResearch(d, prepared, params, ctx, onUpdate), tracking, ctx, onUpdate); }
528
+ catch (err: any) { return { content: [{ type: "text", text: `Error dispatching to ${prepared.agent}: ${err?.message || err}` }], details: { agent: prepared.agent, task: prepared.task, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
529
+ finally { if (tracking.writable) d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); }
530
+ }, (params, ctx) => dispatchExecutionConditions(d, params, ctx));
531
+ }
532
+
533
+ export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
534
+ return withNoProgress(d, "research", async (_id, params, signal, onUpdate, ctx) => {
535
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability; const s = d.state; d.budget.ensureTaskTier();
536
+ const preflight = preflightGate(d, params.persona || ""); if (preflight) return refusal(d, "", params.task, preflight.reason, `${preflight.message}\n\n${refusalSnapshot(d, ctx)}`, preflight.reason);
537
+ const budgetBlock = await d.budgetRecovery.ensure("research", params.task, ctx, signal);
538
+ if (budgetBlock) return refusal(d, "", params.task, budgetBlock.reason, budgetBlock.message);
539
+ if (signal?.aborted) return refusal(d, "", params.task, "cancelled", "Operation cancelled before research.");
540
+ const taskRefusal = checkTaskBudget("research", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
541
+ if (taskRefusal) return refusal(d, "", params.task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
542
+ const turnRefusal = checkTurnBudget("research", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
543
+ if (turnRefusal) return refusal(d, "", params.task, "budget_refused", turnRefusal.message, turnRefusal.reason);
544
+ let def: any; let persona = false;
545
+ if (params.persona) { def = s.getResearchPersonas().find(x => x.name.toLowerCase() === params.persona!.toLowerCase()); if (!def) return { content: [{ type: "text", text: `No research persona "${params.persona}". Available: ${s.getResearchPersonas().map(x => x.name).join(", ") || "(none defined)"}. Omit \`persona\` for an ad-hoc helper. (Not counted against the turn budget.)` }], details: { status: "not_started", reason: "unknown_agent", recoveryCategory: "not_started" as const, started: false, notStarted: true, effects: "none", exitCode: 1 } }; persona = true; } else def = d.research.anonymousDef();
546
+ const model = d.research.resolveModel(def, persona ? undefined : params.model, ctx); let artifacts: InputArtifactPreview[];
547
+ try { artifacts = d.artifacts.loadInputArtifacts(params.artifacts, ctx); } catch (err: any) { return { content: [{ type: "text", text: `⚠ Research NOT spawned and NOT counted against the turn budget — input artifact could not be resolved:\n${err?.message || err}\n\nFix the path and try again.` }], details: { status: "artifact_preflight_failed", reason: "artifact_preflight_failed", recoveryCategory: "not_started" as const, started: false, notStarted: true, effects: "none", exitCode: 1 } }; }
548
+ s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; s.getSessionTotals().research++; d.budget.updateModeStatus();
549
+ const state = d.research.createState(def, persona, model); onUpdate?.({ content: [{ type: "text", text: `Spawning research helper r${state.id}...` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, status: "spawning" } });
550
+ try { const result = await d.research.spawn(state, structuredResearchPrompt(params), ctx, artifacts, signal); const status = result.termination ? result.termination.reason : result.exitCode === 0 ? "done" : "error"; const output = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output; return { content: [{ type: "text", text: `[research r${state.id} · ${persona ? d.displayName(def.name) : "ad-hoc"} · read-only] ${status} in ${Math.round(result.elapsed / 1000)}s\n\n${output}${result.evidencePath ? `\n\nFull execution evidence: ${result.evidencePath}` : ""}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId, evidencePath: result.evidencePath, transcriptPath: result.transcriptPath, termination: result.termination, lifecycle: (result as any).lifecycle ?? null, researchContract: normalizeResearchContract(params), artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
551
+ catch (err: any) { return { content: [{ type: "text", text: `Error spawning research helper: ${err?.message || err}` }], details: { handle: `r${state.id}`, model, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
552
+ }, (params, ctx) => researchExecutionConditions(d, params, ctx));
553
+ }
554
+
555
+ function hasWriteCapability(tools: string): boolean { const set = new Set(String(tools || "").split(",").map(x => x.trim()).filter(Boolean)); return ["write", "edit", "bash"].some(x => set.has(x)); }
556
+ function scopeNoticeText(v: any): string { if (!v) return ""; if (v.skipped) return `\n\n⚠ Scope gate skipped: ${v.reason || "not a git worktree"}.`; if (!v.outOfScope?.length) return ""; const overlap = v.concurrentWritableOverlap ? " Concurrent writable dispatches overlapped this run, so attribution is approximate." : ""; return `\n\n⚠ Scope advisory: changed outside declared scope: ${v.outOfScope.join(", ")}. Review these paths and decide whether to accept them or explicitly order cleanup; the hub did not revert anything.${overlap}`; }
557
+ function structuredReturnDigest(parsed: any): string { if (!parsed) return ""; const lines = ["Structured return (parsed):"]; for (const key of ["assertions_proven", "assertions_unproven", "assertions_failed"]) { const entries = parsed[key] || []; if (!entries.length) continue; lines.push(`${key}:`); for (const entry of entries) { const evidence = entry.evidence ? ` — evidence: ${entry.evidence}` : ""; const reason = entry.reason ? ` — reason: ${entry.reason}` : ""; const note = entry.note || (entry.evidence ? "" : "(no note)"); lines.push(`- ${entry.id}${note ? `: ${note}` : ""}${evidence}${reason}`); } } for (const key of ["changed_files", "tests_run", "open_risks", "requires_user_decision"]) { const entries = parsed[key] || []; if (entries.length) lines.push(`${key}: ${entries.slice(0, 5).join("; ")}${entries.length > 5 ? " …" : ""}`); } return lines.join("\n"); }
558
+ function contractNoticeText(notices: any[]): string { if (!notices?.length) return ""; const lines = ["⚠ Structured return contract notices:"]; const missing = notices.filter(n => n.type === "missing").map(n => n.id); const noStructured = notices.find(n => n.type === "no_structured_return"); if (noStructured) lines.push(`- no_structured_return: no parseable structured return for dispatched assertions ${(noStructured.ids || []).join(", ")} — treat all as unproven; full output is on disk.`); if (missing.length) lines.push(`- missing: return does not cover ${missing.join(", ")} — treat as unproven.`); for (const n of notices.filter(n => n.type === "proven_without_evidence")) lines.push(`- proven_without_evidence: ${n.id} claimed proven without named evidence — demoted to unproven.`); for (const n of notices.filter(n => n.type === "compiler_diagnostics")) lines.push(`- compiler_diagnostics: ${n.id} was claimed proven but a completed compiler check found an error in an observed changed file — demoted to unproven with original evidence retained.`); return lines.join("\n"); }
@@ -0,0 +1,16 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import type { TriageInput } from "../dispatch-triage-contract.ts";
4
+ import type { createTriageRuntime } from "../dispatch-triage-runtime.ts";
5
+ export function registerDispatchTriage(pi: ExtensionAPI, deps: { runtime(): ReturnType<typeof createTriageRuntime> | null; input(task: string, scope: string[], language: string, domain: string): TriageInput; blocked(): unknown }) {
6
+ pi.registerTool({
7
+ name: "dispatch_triage", label: "Dispatch triage",
8
+ description: "Optional System 1 advice before dispatch_agent: eligible persona or abstention, uncertainty and additive security/destructive signals. Never starts an agent, grants permission, reduces gates or changes budgets. Send only minimal non-secret task context; no credentials or file contents. Off unless human-configured. Not mandatory before dispatch.",
9
+ parameters: Type.Object({ task: Type.String({ description: "Minimal non-secret task description, not a transcript" }), scope: Type.Array(Type.String()), language: Type.String({ description: "Task language, e.g. bg or en" }), domain: Type.String({ description: "Domain covered by the approved calibration profile" }) }),
10
+ async execute(_id, params, signal) {
11
+ const blocked = deps.blocked();
12
+ const result = blocked ?? await deps.runtime()?.evaluate(deps.input(params.task,params.scope,params.language,params.domain),signal) ?? { status: "skipped", reason: "consumer_off" };
13
+ return { content: [{ type: "text", text: JSON.stringify(result) }], details: result };
14
+ },
15
+ });
16
+ }