@chankov/agent-fleet 2.2.2 → 2.2.3

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 (766) hide show
  1. package/.pi/harnesses/agent-hub/README.md +18 -2
  2. package/.pi/harnesses/agent-hub/budget-recovery.ts +28 -0
  3. package/.pi/harnesses/agent-hub/commands/recover.ts +28 -9
  4. package/.pi/harnesses/agent-hub/context/assertion-journal.ts +133 -0
  5. package/.pi/harnesses/agent-hub/index.ts +100 -17
  6. package/.pi/harnesses/agent-hub/no-progress.ts +133 -19
  7. package/.pi/harnesses/agent-hub/operator-current-state.ts +51 -6
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  10. package/.pi/harnesses/agent-hub/process-obligations.ts +1 -1
  11. package/.pi/harnesses/agent-hub/recover-policy.ts +1 -1
  12. package/.pi/harnesses/agent-hub/recover-state.ts +46 -6
  13. package/.pi/harnesses/agent-hub/recovery-continuation.ts +134 -0
  14. package/.pi/harnesses/agent-hub/tools/action-executors.ts +24 -3
  15. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  16. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +60 -17
  17. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +2 -1
  18. package/.pi/harnesses/agent-hub/tools/recover-task.ts +16 -0
  19. package/.pi/harnesses/agent-hub/verification-diagnostics.ts +23 -0
  20. package/.pi/harnesses/agent-hub/work-mode.ts +4 -2
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/index.ts +7 -5
  23. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  24. package/.pi/harnesses/lib/bash-policy-analysis.ts +9 -1
  25. package/.pi/harnesses/lib/exact-permission-port.ts +6 -4
  26. package/.versions/2.2.3/.pi/agent-fleet/hermes/README.md +347 -0
  27. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  28. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  29. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  30. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  31. package/.versions/2.2.3/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  32. package/.versions/2.2.3/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  33. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  34. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  35. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  36. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  37. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  38. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  39. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  40. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  41. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  42. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  43. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  44. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  45. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  46. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  47. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  48. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  49. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  50. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  51. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  52. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  53. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  54. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  55. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  56. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  57. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  58. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  59. package/.versions/2.2.3/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  60. package/.versions/2.2.3/.pi/agent-fleet/hooks/coms-stop-hook.mjs +124 -0
  61. package/.versions/2.2.3/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  62. package/.versions/2.2.3/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  63. package/.versions/2.2.3/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  64. package/.versions/2.2.3/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  65. package/.versions/2.2.3/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  66. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/0.167-shared.json +1900 -0
  67. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/README.md +223 -0
  68. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/assessment.md +83 -0
  69. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile-0.167.json +5627 -0
  70. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile.md +43 -0
  71. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap.md +45 -0
  72. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture-profile.ts +53 -0
  73. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture.ts +102 -0
  74. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/catalog.md +91 -0
  75. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/channel.md +21 -0
  76. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurement.md +133 -0
  77. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurements.json +74 -0
  78. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/notification-profile-0.167.json +2679 -0
  79. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/observer.md +101 -0
  80. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/opaque-response.md +57 -0
  81. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/open-sent.md +68 -0
  82. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/probe-reader.md +51 -0
  83. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/profile.md +71 -0
  84. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/projection.md +147 -0
  85. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/reconnect.md +40 -0
  86. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/response-unions.md +74 -0
  87. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/semver.md +124 -0
  88. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/surface.md +73 -0
  89. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  90. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/response-fixture.ts +23 -0
  91. package/.versions/2.2.3/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  92. package/.versions/2.2.3/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +63 -0
  93. package/.versions/2.2.3/.pi/agent-fleet/scripts/fleet.ts +244 -0
  94. package/.versions/2.2.3/.pi/agent-fleet/scripts/flow.ts +166 -0
  95. package/.versions/2.2.3/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  96. package/.versions/2.2.3/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  97. package/.versions/2.2.3/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  98. package/.versions/2.2.3/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  99. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  100. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-bootstrap-files.ts +46 -0
  101. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-bootstrap-probe.ts +52 -0
  102. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-bootstrap-producer.ts +131 -0
  103. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-connection-history.ts +51 -0
  104. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-daemon-observer.ts +137 -0
  105. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-desktop-discovery.ts +84 -0
  106. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-desktop-preflight.ts +130 -0
  107. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +113 -0
  108. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-measurement.ts +218 -0
  109. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-native-presence.ts +61 -0
  110. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-probe-transcript.ts +135 -0
  111. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-send-lineage.ts +72 -0
  112. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +101 -0
  113. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  114. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  115. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +453 -0
  116. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  117. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  118. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  119. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-bootstrap.ts +207 -0
  120. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +76 -0
  121. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  122. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +132 -0
  123. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  124. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  125. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +175 -0
  126. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +435 -0
  127. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  128. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  129. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  130. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  131. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  132. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +44 -0
  133. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  134. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  135. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  136. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
  137. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
  138. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  139. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-command.ts +264 -0
  140. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  141. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +239 -0
  142. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  143. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  144. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  145. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  146. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  147. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  148. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  149. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  150. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  151. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  152. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  153. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  154. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  155. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  156. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  157. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  158. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  159. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/team-project.ts +176 -0
  160. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  161. package/.versions/2.2.3/.pi/agent-fleet/scripts/package-lock.json +57 -0
  162. package/.versions/2.2.3/.pi/agent-fleet/scripts/package.json +10 -0
  163. package/.versions/2.2.3/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  164. package/.versions/2.2.3/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  165. package/.versions/2.2.3/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  166. package/.versions/2.2.3/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  167. package/.versions/2.2.3/.pi/agent-fleet/scripts/team-up.ts +378 -0
  168. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  169. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  170. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  171. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  172. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  173. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  174. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/git.ts +108 -0
  175. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  176. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  177. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  178. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  179. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  180. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  181. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  182. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  183. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/quality.ts +78 -0
  184. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  185. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  186. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  187. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  188. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  189. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  190. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  191. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  192. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  193. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  194. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  195. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  196. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  197. package/.versions/2.2.3/.pi/agents/dispatch-policy.yaml +32 -0
  198. package/.versions/2.2.3/.pi/agents/model-profiles.yaml +132 -0
  199. package/.versions/2.2.3/.pi/agents/peers.yaml +147 -0
  200. package/.versions/2.2.3/.pi/agents/teams.yaml +41 -0
  201. package/.versions/2.2.3/.pi/agents/voices.yaml +13 -0
  202. package/.versions/2.2.3/.pi/damage-control-rules.yaml +297 -0
  203. package/.versions/2.2.3/.pi/extensions/btw/README.md +120 -0
  204. package/.versions/2.2.3/.pi/extensions/btw/index.ts +916 -0
  205. package/.versions/2.2.3/.pi/extensions/btw/package.json +6 -0
  206. package/.versions/2.2.3/.pi/extensions/btw/state.js +179 -0
  207. package/.versions/2.2.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  208. package/.versions/2.2.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  209. package/.versions/2.2.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  210. package/.versions/2.2.3/.pi/extensions/compact-and-continue/README.md +42 -0
  211. package/.versions/2.2.3/.pi/extensions/compact-and-continue/index.ts +136 -0
  212. package/.versions/2.2.3/.pi/extensions/compact-and-continue/package.json +6 -0
  213. package/.versions/2.2.3/.pi/extensions/mcp-bridge/README.md +46 -0
  214. package/.versions/2.2.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  215. package/.versions/2.2.3/.pi/extensions/mcp-bridge/package.json +6 -0
  216. package/.versions/2.2.3/.pi/extensions/package-lock.json +1175 -0
  217. package/.versions/2.2.3/.pi/extensions/package.json +9 -0
  218. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/README.md +224 -0
  219. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/config.ts +199 -0
  220. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  221. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  222. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  223. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  224. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  225. package/.versions/2.2.3/.pi/harnesses/agent-hub/README.md +1657 -0
  226. package/.versions/2.2.3/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  227. package/.versions/2.2.3/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  228. package/.versions/2.2.3/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  229. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  230. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  231. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  232. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  233. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  234. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  235. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  236. package/.versions/2.2.3/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  237. package/.versions/2.2.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  238. package/.versions/2.2.3/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  239. package/.versions/2.2.3/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  240. package/.versions/2.2.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  241. package/.versions/2.2.3/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  242. package/.versions/2.2.3/.pi/harnesses/agent-hub/budget-recovery.ts +151 -0
  243. package/.versions/2.2.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  244. package/.versions/2.2.3/.pi/harnesses/agent-hub/capability-packs.ts +187 -0
  245. package/.versions/2.2.3/.pi/harnesses/agent-hub/codex-bootstrap.ts +117 -0
  246. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  247. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  248. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  249. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  250. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  251. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  252. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  253. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  254. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  255. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  256. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  257. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  258. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  259. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  260. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  261. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  262. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  263. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  264. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  265. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  266. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  267. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  268. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  269. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/recover.ts +81 -0
  270. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  271. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  272. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  273. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  274. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  275. package/.versions/2.2.3/.pi/harnesses/agent-hub/config/agents.ts +183 -0
  276. package/.versions/2.2.3/.pi/harnesses/agent-hub/config/model-profiles.ts +240 -0
  277. package/.versions/2.2.3/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  278. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  279. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/assertion-journal.ts +133 -0
  280. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +234 -0
  281. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  282. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  283. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  284. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  285. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  286. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  287. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  288. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  289. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  290. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  291. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-compat.ts +45 -0
  292. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  293. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  294. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  295. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  296. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-window.js +108 -0
  297. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  298. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  299. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  300. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  301. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  302. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  303. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  304. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  305. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  306. package/.versions/2.2.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  307. package/.versions/2.2.3/.pi/harnesses/agent-hub/delegate.ts +478 -0
  308. package/.versions/2.2.3/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  309. package/.versions/2.2.3/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  310. package/.versions/2.2.3/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  311. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  312. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  313. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  314. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +318 -0
  315. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +264 -0
  316. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +297 -0
  317. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native.ts +242 -0
  318. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  319. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  320. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  321. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  322. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  323. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  324. package/.versions/2.2.3/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  325. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  326. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  327. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  328. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  329. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-watchdog.js +344 -0
  330. package/.versions/2.2.3/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  331. package/.versions/2.2.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  332. package/.versions/2.2.3/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  333. package/.versions/2.2.3/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  334. package/.versions/2.2.3/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  335. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  336. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  337. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  338. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  339. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  340. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  341. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  342. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  343. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  344. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  345. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  346. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  347. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  348. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  349. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  350. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  351. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  352. package/.versions/2.2.3/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  353. package/.versions/2.2.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +69 -0
  354. package/.versions/2.2.3/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  355. package/.versions/2.2.3/.pi/harnesses/agent-hub/footer.ts +29 -0
  356. package/.versions/2.2.3/.pi/harnesses/agent-hub/helpers.ts +269 -0
  357. package/.versions/2.2.3/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  358. package/.versions/2.2.3/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  359. package/.versions/2.2.3/.pi/harnesses/agent-hub/index.ts +2805 -0
  360. package/.versions/2.2.3/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  361. package/.versions/2.2.3/.pi/harnesses/agent-hub/input/shortcuts.ts +16 -0
  362. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  363. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  364. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  365. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  366. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  367. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  368. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  369. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  370. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  371. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  372. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  373. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  374. package/.versions/2.2.3/.pi/harnesses/agent-hub/no-progress.ts +741 -0
  375. package/.versions/2.2.3/.pi/harnesses/agent-hub/operator-current-state.ts +102 -0
  376. package/.versions/2.2.3/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  377. package/.versions/2.2.3/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  378. package/.versions/2.2.3/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  379. package/.versions/2.2.3/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  380. package/.versions/2.2.3/.pi/harnesses/agent-hub/package.json +7 -0
  381. package/.versions/2.2.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  382. package/.versions/2.2.3/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  383. package/.versions/2.2.3/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  384. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  385. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  386. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  387. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/roster.ts +103 -0
  388. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/work-mode.ts +104 -0
  389. package/.versions/2.2.3/.pi/harnesses/agent-hub/poll-command.ts +184 -0
  390. package/.versions/2.2.3/.pi/harnesses/agent-hub/presentation.ts +54 -0
  391. package/.versions/2.2.3/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  392. package/.versions/2.2.3/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  393. package/.versions/2.2.3/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  394. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  395. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  396. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  397. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  398. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  399. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  400. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  401. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  402. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  403. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  404. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  405. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  406. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-snapshot.ts +287 -0
  407. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  408. package/.versions/2.2.3/.pi/harnesses/agent-hub/process-obligations.ts +210 -0
  409. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/context.ts +72 -0
  410. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/fragments.ts +94 -0
  411. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/session-start.ts +89 -0
  412. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +142 -0
  413. package/.versions/2.2.3/.pi/harnesses/agent-hub/provider-semaphore.js +143 -0
  414. package/.versions/2.2.3/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  415. package/.versions/2.2.3/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  416. package/.versions/2.2.3/.pi/harnesses/agent-hub/recover-state.ts +144 -0
  417. package/.versions/2.2.3/.pi/harnesses/agent-hub/recovery-continuation.ts +134 -0
  418. package/.versions/2.2.3/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  419. package/.versions/2.2.3/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  420. package/.versions/2.2.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  421. package/.versions/2.2.3/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  422. package/.versions/2.2.3/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  423. package/.versions/2.2.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  424. package/.versions/2.2.3/.pi/harnesses/agent-hub/return-contract.js +371 -0
  425. package/.versions/2.2.3/.pi/harnesses/agent-hub/return-extract.js +77 -0
  426. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  427. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-continuity.ts +76 -0
  428. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-findings.js +96 -0
  429. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-reuse.ts +48 -0
  430. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  431. package/.versions/2.2.3/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  432. package/.versions/2.2.3/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  433. package/.versions/2.2.3/.pi/harnesses/agent-hub/run-budget.js +362 -0
  434. package/.versions/2.2.3/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  435. package/.versions/2.2.3/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  436. package/.versions/2.2.3/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  437. package/.versions/2.2.3/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  438. package/.versions/2.2.3/.pi/harnesses/agent-hub/scope-gate.js +271 -0
  439. package/.versions/2.2.3/.pi/harnesses/agent-hub/scope-overlap.ts +46 -0
  440. package/.versions/2.2.3/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  441. package/.versions/2.2.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  442. package/.versions/2.2.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
  443. package/.versions/2.2.3/.pi/harnesses/agent-hub/spawn.ts +702 -0
  444. package/.versions/2.2.3/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  445. package/.versions/2.2.3/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  446. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  447. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  448. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  449. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  450. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-brief.ts +98 -0
  451. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  452. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  453. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  454. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  455. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  456. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  457. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  458. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  459. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  460. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  461. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  462. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-runtime.ts +132 -0
  463. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  464. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  465. package/.versions/2.2.3/.pi/harnesses/agent-hub/timeline.ts +72 -0
  466. package/.versions/2.2.3/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +83 -0
  467. package/.versions/2.2.3/.pi/harnesses/agent-hub/tool-catalog-state.ts +125 -0
  468. package/.versions/2.2.3/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  469. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/action-executors.ts +237 -0
  470. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  471. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  472. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  473. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/context.ts +151 -0
  474. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +93 -0
  475. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +971 -0
  476. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  477. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +23 -0
  478. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  479. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  480. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/poll-panel-core.ts +30 -0
  481. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/poll-panel.ts +33 -0
  482. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/recover-task.ts +16 -0
  483. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/run-flow.ts +177 -0
  484. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  485. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  486. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  487. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  488. package/.versions/2.2.3/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  489. package/.versions/2.2.3/.pi/harnesses/agent-hub/types.ts +66 -0
  490. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  491. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  492. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  493. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  494. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +173 -0
  495. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  496. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  497. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  498. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  499. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  500. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  501. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  502. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  503. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  504. package/.versions/2.2.3/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  505. package/.versions/2.2.3/.pi/harnesses/agent-hub/verification-diagnostics.ts +23 -0
  506. package/.versions/2.2.3/.pi/harnesses/agent-hub/version.ts +42 -0
  507. package/.versions/2.2.3/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  508. package/.versions/2.2.3/.pi/harnesses/agent-hub/work-mode.ts +185 -0
  509. package/.versions/2.2.3/.pi/harnesses/agent-hub/write-isolation.ts +232 -0
  510. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/README.md +59 -0
  511. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/index.ts +571 -0
  512. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  513. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  514. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  515. package/.versions/2.2.3/.pi/harnesses/coms/README.md +105 -0
  516. package/.versions/2.2.3/.pi/harnesses/coms/index.ts +308 -0
  517. package/.versions/2.2.3/.pi/harnesses/coms/package.json +7 -0
  518. package/.versions/2.2.3/.pi/harnesses/coms/version.ts +42 -0
  519. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/README.md +161 -0
  520. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/index.ts +661 -0
  521. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  522. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  523. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  524. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  525. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  526. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  527. package/.versions/2.2.3/.pi/harnesses/lib/approval-wait.ts +17 -0
  528. package/.versions/2.2.3/.pi/harnesses/lib/bash-policy-analysis.ts +193 -0
  529. package/.versions/2.2.3/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  530. package/.versions/2.2.3/.pi/harnesses/lib/clarification-policy.ts +9 -0
  531. package/.versions/2.2.3/.pi/harnesses/lib/codex-compat.ts +97 -0
  532. package/.versions/2.2.3/.pi/harnesses/lib/codex-contract.ts +259 -0
  533. package/.versions/2.2.3/.pi/harnesses/lib/codex-notification-profile.ts +75 -0
  534. package/.versions/2.2.3/.pi/harnesses/lib/coms-core-io.ts +422 -0
  535. package/.versions/2.2.3/.pi/harnesses/lib/coms-core.ts +738 -0
  536. package/.versions/2.2.3/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  537. package/.versions/2.2.3/.pi/harnesses/lib/coms-observation.ts +74 -0
  538. package/.versions/2.2.3/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  539. package/.versions/2.2.3/.pi/harnesses/lib/coms-response-read.ts +107 -0
  540. package/.versions/2.2.3/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  541. package/.versions/2.2.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +124 -0
  542. package/.versions/2.2.3/.pi/harnesses/lib/context-budget-view.ts +112 -0
  543. package/.versions/2.2.3/.pi/harnesses/lib/context-budget.ts +114 -0
  544. package/.versions/2.2.3/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  545. package/.versions/2.2.3/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  546. package/.versions/2.2.3/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  547. package/.versions/2.2.3/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  548. package/.versions/2.2.3/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  549. package/.versions/2.2.3/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  550. package/.versions/2.2.3/.pi/harnesses/lib/damage-policy.ts +35 -0
  551. package/.versions/2.2.3/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  552. package/.versions/2.2.3/.pi/harnesses/lib/damage-result-view.ts +16 -0
  553. package/.versions/2.2.3/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  554. package/.versions/2.2.3/.pi/harnesses/lib/exact-permission-port.ts +40 -0
  555. package/.versions/2.2.3/.pi/harnesses/lib/execution-trace.ts +45 -0
  556. package/.versions/2.2.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  557. package/.versions/2.2.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  558. package/.versions/2.2.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  559. package/.versions/2.2.3/.pi/harnesses/lib/fleet-bootstrap-channel.ts +148 -0
  560. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-catalog.ts +30 -0
  561. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-chat-view.ts +55 -0
  562. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  563. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-namespace.ts +2 -0
  564. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-policy-snapshot.ts +10 -0
  565. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  566. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  567. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  568. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  569. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  570. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  571. package/.versions/2.2.3/.pi/harnesses/lib/fleet-connection-control.ts +94 -0
  572. package/.versions/2.2.3/.pi/harnesses/lib/fleet-connection-diagnostics.ts +7 -0
  573. package/.versions/2.2.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  574. package/.versions/2.2.3/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  575. package/.versions/2.2.3/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  576. package/.versions/2.2.3/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  577. package/.versions/2.2.3/.pi/harnesses/lib/fleet-notification-admission.ts +32 -0
  578. package/.versions/2.2.3/.pi/harnesses/lib/fleet-notification-bootstrap.ts +172 -0
  579. package/.versions/2.2.3/.pi/harnesses/lib/fleet-notification-validation.ts +122 -0
  580. package/.versions/2.2.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  581. package/.versions/2.2.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  582. package/.versions/2.2.3/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  583. package/.versions/2.2.3/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  584. package/.versions/2.2.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  585. package/.versions/2.2.3/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  586. package/.versions/2.2.3/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  587. package/.versions/2.2.3/.pi/harnesses/lib/fleet-target-identity.ts +9 -0
  588. package/.versions/2.2.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  589. package/.versions/2.2.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  590. package/.versions/2.2.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  591. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  592. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  593. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  594. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  595. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  596. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  597. package/.versions/2.2.3/.pi/harnesses/lib/identical-dialog.ts +27 -0
  598. package/.versions/2.2.3/.pi/harnesses/lib/installation-state.js +62 -0
  599. package/.versions/2.2.3/.pi/harnesses/lib/peer-target.ts +24 -0
  600. package/.versions/2.2.3/.pi/harnesses/lib/policy-roots.js +117 -0
  601. package/.versions/2.2.3/.pi/harnesses/lib/policy-roots.ts +32 -0
  602. package/.versions/2.2.3/.pi/harnesses/lib/process-shared.ts +9 -0
  603. package/.versions/2.2.3/.pi/harnesses/lib/resource-closure.js +26 -0
  604. package/.versions/2.2.3/.pi/harnesses/lib/safe-source-read.js +29 -0
  605. package/.versions/2.2.3/.pi/harnesses/lib/semantic-approval.ts +80 -0
  606. package/.versions/2.2.3/.pi/harnesses/lib/session-target.ts +62 -0
  607. package/.versions/2.2.3/.pi/harnesses/lib/spawned-peers.js +191 -0
  608. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  609. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  610. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  611. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  612. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-json.js +37 -0
  613. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-loader.js +53 -0
  614. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  615. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-triage.js +42 -0
  616. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-v2.js +112 -0
  617. package/.versions/2.2.3/.pi/harnesses/lib/system1/config.js +50 -0
  618. package/.versions/2.2.3/.pi/harnesses/lib/system1/contracts.ts +154 -0
  619. package/.versions/2.2.3/.pi/harnesses/lib/system1/demo.ts +95 -0
  620. package/.versions/2.2.3/.pi/harnesses/lib/system1/jev.ts +503 -0
  621. package/.versions/2.2.3/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  622. package/.versions/2.2.3/.pi/harnesses/lib/system1/selection.js +11 -0
  623. package/.versions/2.2.3/.pi/harnesses/lib/system1/service.ts +245 -0
  624. package/.versions/2.2.3/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  625. package/.versions/2.2.3/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  626. package/.versions/2.2.3/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  627. package/.versions/2.2.3/.pi/harnesses/lib/target-capabilities.js +7 -0
  628. package/.versions/2.2.3/.pi/harnesses/lib/update-check.ts +227 -0
  629. package/.versions/2.2.3/.pi/harnesses/lib/workspace-context.js +115 -0
  630. package/.versions/2.2.3/.pi/harnesses/lib/workspace-context.ts +22 -0
  631. package/.versions/2.2.3/.pi/harnesses/package-lock.json +2121 -0
  632. package/.versions/2.2.3/.pi/harnesses/package.json +13 -0
  633. package/.versions/2.2.3/.pi/prompts/af-build.md +27 -0
  634. package/.versions/2.2.3/.pi/prompts/af-code-simplify.md +22 -0
  635. package/.versions/2.2.3/.pi/prompts/af-constraints.md +31 -0
  636. package/.versions/2.2.3/.pi/prompts/af-plan.md +17 -0
  637. package/.versions/2.2.3/.pi/prompts/af-review.md +16 -0
  638. package/.versions/2.2.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  639. package/.versions/2.2.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  640. package/.versions/2.2.3/.pi/prompts/af-setup-rules.md +20 -0
  641. package/.versions/2.2.3/.pi/prompts/af-ship.md +17 -0
  642. package/.versions/2.2.3/.pi/prompts/af-spec.md +15 -0
  643. package/.versions/2.2.3/.pi/prompts/af-test.md +19 -0
  644. package/.versions/2.2.3/.pi/skills/bowser/SKILL.md +145 -0
  645. package/.versions/2.2.3/.version +1 -0
  646. package/.versions/2.2.3/agents/architect.md +24 -0
  647. package/.versions/2.2.3/agents/bowser.md +28 -0
  648. package/.versions/2.2.3/agents/builder.md +55 -0
  649. package/.versions/2.2.3/agents/code-reviewer.md +209 -0
  650. package/.versions/2.2.3/agents/deep-researcher.md +32 -0
  651. package/.versions/2.2.3/agents/documenter.md +22 -0
  652. package/.versions/2.2.3/agents/plan-reviewer.md +83 -0
  653. package/.versions/2.2.3/agents/planner.md +107 -0
  654. package/.versions/2.2.3/agents/releaser.md +24 -0
  655. package/.versions/2.2.3/agents/researcher.md +30 -0
  656. package/.versions/2.2.3/agents/security-auditor.md +167 -0
  657. package/.versions/2.2.3/agents/test-engineer.md +153 -0
  658. package/.versions/2.2.3/agents/web-debugger.md +44 -0
  659. package/.versions/2.2.3/agents/web-performance-auditor.md +194 -0
  660. package/.versions/2.2.3/bin/catalog/harness-runtime-closure.json +85 -0
  661. package/.versions/2.2.3/docs/ARCHITECTURE.md +1291 -0
  662. package/.versions/2.2.3/docs/agent-fleet-setup.md +1161 -0
  663. package/.versions/2.2.3/docs/claude-code-coms-bridge.md +147 -0
  664. package/.versions/2.2.3/docs/codex-local-mcp.md +520 -0
  665. package/.versions/2.2.3/docs/codex-session-bridge.md +44 -0
  666. package/.versions/2.2.3/docs/codex-setup.md +183 -0
  667. package/.versions/2.2.3/docs/coms-hermes-bridge.md +188 -0
  668. package/.versions/2.2.3/docs/fleet-native-voice.md +151 -0
  669. package/.versions/2.2.3/docs/getting-started.md +126 -0
  670. package/.versions/2.2.3/docs/npm-install.md +535 -0
  671. package/.versions/2.2.3/docs/pi-extensions.md +450 -0
  672. package/.versions/2.2.3/docs/pi-setup.md +92 -0
  673. package/.versions/2.2.3/docs/skill-anatomy.md +150 -0
  674. package/.versions/2.2.3/install-manifest.json +3227 -0
  675. package/.versions/2.2.3/justfile +246 -0
  676. package/.versions/2.2.3/manifest-meta.json +1099 -0
  677. package/.versions/2.2.3/references/accessibility-checklist.md +160 -0
  678. package/.versions/2.2.3/references/communication-contract.md +26 -0
  679. package/.versions/2.2.3/references/definition-of-done.md +67 -0
  680. package/.versions/2.2.3/references/fleet-coordination-patterns.md +171 -0
  681. package/.versions/2.2.3/references/observability-checklist.md +92 -0
  682. package/.versions/2.2.3/references/orchestration-patterns.md +370 -0
  683. package/.versions/2.2.3/references/performance-checklist.md +236 -0
  684. package/.versions/2.2.3/references/prompting-patterns.md +380 -0
  685. package/.versions/2.2.3/references/security-checklist.md +245 -0
  686. package/.versions/2.2.3/references/testing-patterns.md +235 -0
  687. package/.versions/2.2.3/references/workflow-authoring.md +304 -0
  688. package/.versions/2.2.3/skills/_internal/grilling.md +59 -0
  689. package/.versions/2.2.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  690. package/.versions/2.2.3/skills/code-review-and-quality/SKILL.md +396 -0
  691. package/.versions/2.2.3/skills/compound-learning/SKILL.md +137 -0
  692. package/.versions/2.2.3/skills/constraint-driven-development/SKILL.md +338 -0
  693. package/.versions/2.2.3/skills/constraint-driven-development/references/floor-guard.md +99 -0
  694. package/.versions/2.2.3/skills/context-engineering/SKILL.md +341 -0
  695. package/.versions/2.2.3/skills/deprecation-and-migration/SKILL.md +247 -0
  696. package/.versions/2.2.3/skills/designing-agents/SKILL.md +394 -0
  697. package/.versions/2.2.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  698. package/.versions/2.2.3/skills/drafting-workflows/SKILL.md +143 -0
  699. package/.versions/2.2.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  700. package/.versions/2.2.3/skills/fleet-connect/SKILL.md +29 -0
  701. package/.versions/2.2.3/skills/fleet-connect.zip +0 -0
  702. package/.versions/2.2.3/skills/fleet-native-voice/SKILL.md +103 -0
  703. package/.versions/2.2.3/skills/fleet-native-voice/agents/openai.yaml +4 -0
  704. package/.versions/2.2.3/skills/fleet-native-voice.zip +0 -0
  705. package/.versions/2.2.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  706. package/.versions/2.2.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  707. package/.versions/2.2.3/skills/idea-refine/SKILL.md +182 -0
  708. package/.versions/2.2.3/skills/idea-refine/examples.md +238 -0
  709. package/.versions/2.2.3/skills/idea-refine/frameworks.md +99 -0
  710. package/.versions/2.2.3/skills/idea-refine/refinement-criteria.md +113 -0
  711. package/.versions/2.2.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  712. package/.versions/2.2.3/skills/incremental-implementation/SKILL.md +353 -0
  713. package/.versions/2.2.3/skills/incremental-implementation.zip +0 -0
  714. package/.versions/2.2.3/skills/interview-me/SKILL.md +226 -0
  715. package/.versions/2.2.3/skills/orchestration-verification/SKILL.md +182 -0
  716. package/.versions/2.2.3/skills/peer-coms/SKILL.md +90 -0
  717. package/.versions/2.2.3/skills/performance-optimization/SKILL.md +496 -0
  718. package/.versions/2.2.3/skills/planning-and-task-breakdown/SKILL.md +318 -0
  719. package/.versions/2.2.3/skills/planning-and-task-breakdown.zip +0 -0
  720. package/.versions/2.2.3/skills/repository-ai-setup/SKILL.md +135 -0
  721. package/.versions/2.2.3/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  722. package/.versions/2.2.3/skills/repository-ai-setup/references/apply-contract.md +74 -0
  723. package/.versions/2.2.3/skills/repository-ai-setup/references/provenance-template.md +16 -0
  724. package/.versions/2.2.3/skills/repository-ai-setup/references/setup-flow.md +108 -0
  725. package/.versions/2.2.3/skills/repository-ai-setup/references/verify-setup.md +20 -0
  726. package/.versions/2.2.3/skills/repository-ai-setup.zip +0 -0
  727. package/.versions/2.2.3/skills/security-and-hardening/SKILL.md +524 -0
  728. package/.versions/2.2.3/skills/spec-driven-development/SKILL.md +295 -0
  729. package/.versions/2.2.3/skills/spec-driven-development.zip +0 -0
  730. package/.versions/2.2.3/skills/using-agent-skills/SKILL.md +198 -0
  731. package/.versions/2.2.3/vendor/agent-skills-upstream/LICENSE +21 -0
  732. package/.versions/2.2.3/vendor/agent-skills-upstream/README.md +430 -0
  733. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  734. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  735. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  736. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  737. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  738. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  739. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  740. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  741. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  742. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  743. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  744. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  745. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  746. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  747. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  748. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  749. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  750. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  751. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  752. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  753. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  754. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  755. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  756. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  757. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  758. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  759. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  760. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  761. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  762. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  763. package/CHANGELOG.md +19 -0
  764. package/docs/hub-task-continuation.md +23 -0
  765. package/install-manifest.json +1 -1
  766. package/package.json +4 -3
@@ -0,0 +1,971 @@
1
+ import { verificationDiagnostics, verificationDiagnosticNotice } from '../verification-diagnostics.ts';
2
+ import { basePersonaName, parallelInstanceName } from "../run-budget.js";
3
+ import { privateRequirements, privateDeclarationHash, privateClassification, type PrivateProofUse } from '../private-config-review.ts';
4
+ import { capturePrivateConfig, privateConfigRevision, type PrivateConfigBinding } from '../private-config-current-state.ts';
5
+ import { finishPrivateConfigReview } from '../private-config-review.ts';
6
+ import { validateBoundAssertionIds } from "../return-contract.js";
7
+ import { anchorRuntimeReceipt, beginReceiptCapture, receiptDeclarationHash, reusableRuntimeChecks, type ReceiptCapture, type RuntimeReceipt } from "../runtime-receipts.ts";
8
+ import { captureReviewBaseline, retainReviewHistory, reviewContinuation, type ReviewBaseline } from "../review-continuity.ts";
9
+ import { ORCHESTRATOR_CLARIFICATION } from "../../lib/clarification-policy.ts";
10
+ import { reviewInput, retainReview, reusableReview, type ReviewInput } from "../review-reuse.ts";
11
+ import { affirmativeReviewVerdict } from "../review-verdict.ts";
12
+ import { captureOperatorState, operatorStateChecksDiagnostic, operatorStateNextStep, operatorReviewState, operatorScopeSyntax, persistOperatorStateProof, type OperatorStateCandidate } from "../operator-current-state.ts";
13
+ import { retainDeliverable } from "../execution-evidence.ts";
14
+ import { buildRuntimeResult, minimalChangeRequirement, preflightDeliverables, readBackDeliverables, type AcceptanceRequirement, type DeliverableContract, type VerificationCheckInput } from "../acceptance.ts";
15
+ import { normalizeResearchContract, withNoProgress, canonicalExecutor, type NoProgressGuard } from "../no-progress.ts";
16
+ import { randomUUID } from "node:crypto";
17
+ import { mkdirSync, writeFileSync } from "node:fs";
18
+ import { isAbsolute } from "node:path";
19
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
20
+ import { blockingFindingCap, checkTierPersonaGate, isReviewPersona, reviewBudgetClause } from "../run-budget.js";
21
+ import { countReviewFindings, findingBudgetNotice } from "../review-findings.js";
22
+ import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
23
+ import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
24
+ import { checkScope, diffAgainst, nestedRevisionScopes, reviewableChangedPaths, revisionOf, revisionScopes, snapshotRevision, snapshotWorktree, worktreeRevision } from "../scope-gate.js";
25
+ import { findScopeOverlap } from "../scope-overlap.ts";
26
+ import { diagnoseChangedTypeScript, formatAdvisory, type DiagnosticsResult } from "../../lib/changed-file-diagnostics.ts";
27
+ import { correctStructuredReturnForCompiler, crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
28
+ import { shouldExtractReturn } from "../return-extract.js";
29
+ import { normalizeAgentInput, safeAgentKey, safePathWithin, taskFingerprint } from "../helpers.ts";
30
+ import { MAX_AUTO_RESEARCH_QUESTIONS, MAX_AUTO_RESEARCH_ROUNDS, type ResearchAgentDef, type ResearchRuntime } from "../research/runtime.ts";
31
+ import type { BudgetContext, SessionTotals, TurnReport } from "../context/budgets.ts";
32
+ import type { AssertionsArtifactsContext, InputArtifactPreview } from "../context/assertions-artifacts.ts";
33
+ import type { DispatchAgentParams, SpawnResearchParams, ToolExecutionResult, ToolExecutor, ToolUpdate } from "./context.ts";
34
+ import type { AgentState } from "../types.ts";
35
+ import { diagnoseToolProtocol, type ToolProtocolDiagnostic } from "../tool-protocol.ts";
36
+ import type { TaskResumeInput } from "../task-resume-contract.ts";
37
+ import { evaluateProcessObligations, noteProcessStage, processAllowsPersona, processPreEffectGate, type ProcessObligationState, type ProcessVerdict } from "../process-obligations.ts";
38
+ import { activeOrchestrationHandoff, reviewMayClose } from "../orchestration-activation.ts";
39
+ import { authorizePlanStatusUpdate } from "../orchestration-route.ts";
40
+
41
+ type Gate = { reason: string; message: string } | null;
42
+ type DispatchResult = import("../dispatch-native-types.ts").NativeDispatchResult;
43
+
44
+ export interface WriterEntry { agent: string; scope: string[]; isolated: boolean }
45
+
46
+ export interface DispatchExecutionState {
47
+ getTurnDispatchCount(): number; setTurnDispatchCount(value: number): void;
48
+ getTurnResearchCount(): number; setTurnResearchCount(value: number): void;
49
+ getTaskDispatchCount(): number; setTaskDispatchCount(value: number): void;
50
+ getTaskResearchCount(): number; setTaskResearchCount(value: number): void;
51
+ getTaskReviewRounds(): number; setTaskReviewRounds(value: number): void;
52
+ getTaskTier(): string | null;
53
+ getAcceptedUserInput?(): string | undefined;
54
+ getTurnReport(): TurnReport;
55
+ getSessionTotals(): SessionTotals;
56
+ getTurnDispatchFingerprints(): Set<string>;
57
+ getExternalBlockers(): Array<{ agent: string; what: string }>;
58
+ getExternalBlockerAcknowledged(): boolean; setExternalBlockerAcknowledged(value: boolean): void;
59
+ getExternalBlockerRefusedOnce(): boolean; setExternalBlockerRefusedOnce(value: boolean): void;
60
+ isAskUserAvailable(): boolean;
61
+ getUserLanguage(): string;
62
+ getSessionDir(): string;
63
+ getAgentStates(): Map<string, AgentState>;
64
+ getAssertions(): Array<{ id: string; tag: string; text: string; source: string; reference?: string; criticalConditions?: string[]; testCommand?: string; compilerCommand?: string; status: string; evidence?: string; evidenceTaskId?: string; evidenceRevision?: string }>;
65
+ getResearchPersonas(): ResearchAgentDef[];
66
+ /** Adds an installed, dispatchable persona to the active team; null when none is installed under that name. */
67
+ addInstalledAgent?(agent: string): { ok: boolean; message: string } | null;
68
+ /** Installed personas dispatch_agent may target (research and catalog-only personas excluded). */
69
+ getInstalledAgentNames?(): string[];
70
+ /** Writable dispatches running now, with their declared scope and whether they are OS-isolated. */
71
+ getActiveWriters?(): WriterEntry[];
72
+ /** Registers a writable dispatch; an isolated one makes its native launch sandboxed. Returns its release. */
73
+ beginWriter?(entry: WriterEntry): () => void;
74
+ /** Creates (or reuses) a parallel instance of an installed writable persona, e.g. builder-2. */
75
+ addAgentInstance?(base: string, instance: string): boolean;
76
+ /** Records an admitted delegation in the current task brief. */
77
+ recordDelegation?(entry: { agent: string; kind: "specialist" | "research"; task: string; scope: string[]; researchId?: number }): void;
78
+ getActiveWritableDispatches(): number; setActiveWritableDispatches(value: number): void;
79
+ getWritableOverlapCounter(): number; setWritableOverlapCounter(value: number): void;
80
+ getProcessState?(): ProcessObligationState;
81
+ processBlock?(): { reason: string; message: string } | null;
82
+ setProcessState?(value: ProcessObligationState): void;
83
+ persistProcessVerdict?(state: ProcessObligationState, verdict: ProcessVerdict): void;
84
+ }
85
+
86
+ export interface DispatchExecutorDeps {
87
+ noProgress: NoProgressGuard;
88
+ state: DispatchExecutionState;
89
+ budget: BudgetContext;
90
+ artifacts: AssertionsArtifactsContext;
91
+ research: ResearchRuntime<any>;
92
+ provisionalCapabilityRefusal(pack: "fleet"): ToolExecutionResult | null;
93
+ dispatchAgent(agent: string, task: string, ctx: ExtensionContext, artifacts: InputArtifactPreview[], scope: string[], watchdog?: boolean, backend?: "auto" | "native" | "coms", resume?: boolean, resumeContract?: Omit<TaskResumeInput, "previous">, revisionScopes?: string[]): Promise<DispatchResult>;
94
+ runReturnExtraction(path: string, ids: string[], ctx: ExtensionContext): Promise<any>;
95
+ /** Opt-in profile assistance: recover a missing submit_result from the written report. */
96
+ returnExtractionAssist?(): boolean;
97
+ extractNeedsResearch(output: string): string[];
98
+ extractAskUserQuestions(output: string): string[];
99
+ contextPressure(percent: number): boolean;
100
+ displayName(name: string): string;
101
+ getToolCatalogVersion?(): string;
102
+ resolvedAgentModel?(def: AgentState["def"], ctx: ExtensionContext): string | undefined;
103
+ diagnoseChangedTypeScript?: typeof diagnoseChangedTypeScript;
104
+ }
105
+
106
+ interface PreparedDispatch { privateConfig?: PrivateConfigBinding; operatorCandidate?: OperatorStateCandidate; beforeSnapshot?: unknown; reviewBaseline?: ReviewBaseline|null; reviewInput?: ReviewInput|null; taskToken: object; taskId: string; beforeRevision: string; /** Task revision basis (D8); [] at a root repository. */ revisionScopes: string[]; requirements: AcceptanceRequirement[]; contract: DeliverableContract; resumeContract: Omit<TaskResumeInput, "previous">; sessionDir: string; agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; parallel?: boolean; }
107
+ interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; }
108
+ interface Tracking { receiptCapture?: ReceiptCapture; writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; release?: () => void; isolatedScope?: string[]; }
109
+ interface WorktreeObservation { skipped: boolean; reason?: string; paths: string[]; foreignPaths?: string[]; snapshot?: unknown; concurrentWritableOverlap: boolean; gaps?: Array<{ scope: string; reason: string }>; repositories?: Array<{ root: string; prefix: string; head: string; scopes: string[] }>; }
110
+
111
+ export function preflightGate(d: DispatchExecutorDeps, persona: string): Gate {
112
+ const s = d.state;
113
+ const blocked = checkExternalBlockerGate({ blockers: s.getExternalBlockers(), acknowledged: s.getExternalBlockerAcknowledged(), askUserAvailable: s.isAskUserAvailable(), refusedOnce: s.getExternalBlockerRefusedOnce() });
114
+ if (blocked) { s.setExternalBlockerRefusedOnce(true); return blocked; }
115
+ const blockedProcess = s.processBlock?.();
116
+ if (blockedProcess) return blockedProcess;
117
+ const process = s.getProcessState?.();
118
+ return process && processAllowsPersona(process, persona) ? null : checkTierPersonaGate(s.getTaskTier(), persona);
119
+ }
120
+
121
+ function refusalCategoryFor(status: string, reason?: string): "not_started" | "operator_cancelled" | "unknown_tool" {
122
+ const values = [status, reason].filter((v): v is string => typeof v === "string").map(v => v.toLowerCase());
123
+ if (values.some(v => v.includes("operator_cancel") || v === "cancelled" || v === "canceled")) return "operator_cancelled";
124
+ if (values.some(v => v.includes("unknown_tool"))) return "unknown_tool";
125
+ return "not_started";
126
+ }
127
+
128
+ /** T7: authoritative state snapshot rendered into refusals. Prompt prose never changes
129
+ * state; setter/result/gate share one snapshot (task/tier/source). Refusals show the
130
+ * actual tier/catalog/revision so the operator can correct against reality. */
131
+ function refusalSnapshot(d: DispatchExecutorDeps, ctx: ExtensionContext): string {
132
+ try {
133
+ const tier = (d.state as any)?.getTaskTier?.() ?? "unknown";
134
+ const catalog = (d as any)?.getToolCatalogVersion?.() ?? "unknown";
135
+ let revision = "unavailable";
136
+ try { const cwd = ctx.cwd || process.cwd(); revision = revisionOf(cwd, revisionScopes(cwd, (d.state as any)?.getProcessState?.()?.changedFiles ?? [])); } catch {}
137
+ return `Snapshot: tier "${tier}", catalog "${catalog}", revision "${revision}". Prompt prose did not change state.`;
138
+ } catch { return "Snapshot unavailable."; }
139
+ }
140
+
141
+ /** Runtime-owned preflight refusal: never launched a process, never produced effects.
142
+ * Callers must not infer execution from exitCode alone; started:false is authoritative. */
143
+ function refusal(d: DispatchExecutorDeps, agent: string, task: string, status: string, message: string, reason?: string): ToolExecutionResult {
144
+ d.state.getTurnReport().refusals++; d.state.getSessionTotals().refusals++;
145
+ const recoveryCategory = refusalCategoryFor(status, reason);
146
+ 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" } };
147
+ }
148
+
149
+ const RESEARCH_DISPATCH_NAMES = new Set(["researcher", "deep-researcher"]);
150
+
151
+ function rosterNames(d: DispatchExecutorDeps): string[] {
152
+ return Array.from(d.state.getAgentStates().values()).map(s => s.def.name);
153
+ }
154
+
155
+ function isResearchDispatchName(d: DispatchExecutorDeps, agent: string): boolean {
156
+ if (RESEARCH_DISPATCH_NAMES.has(agent)) return true;
157
+ return d.state.getResearchPersonas().some(p => normalizeAgentInput(p.name) === agent);
158
+ }
159
+
160
+ function unknownAgentMessage(agent: string, available: string[], researchHint: boolean): string {
161
+ const roster = available.length ? available.join(", ") : "(none)";
162
+ const research = researchHint
163
+ ? `\n\n"${agent}" is a research persona. Call spawn_research with persona "${agent}" instead of dispatch_agent. Do not invent a substitute dispatch.`
164
+ : "";
165
+ const processRole = !researchHint && ["planner", "code-reviewer", "plan-reviewer", "security-auditor"].includes(agent)
166
+ ? `Ask the human to install the ${agent} persona (agent-fleet setup, or /af-agents-add ${agent} when its file is present); once installed, dispatching it adds it to the team. This does not change the tier or budget. `
167
+ : "";
168
+ return `Unknown agent "${agent}". dispatch_agent accepts installed agents. Installed agents: ${roster}.${research}\n\nDo not invent a substitute dispatch. ${processRole}Use an installed agent, or spawn_research for a research persona.`;
169
+ }
170
+
171
+ export function validateDispatchAgent(d: DispatchExecutorDeps, agent: string, task: string, ctx?: ExtensionContext): ToolExecutionResult | null {
172
+ const roster = rosterNames(d);
173
+ let onRoster = d.state.getAgentStates().has(agent) || roster.some(name => normalizeAgentInput(name) === agent);
174
+ const available = [...new Set([...roster, ...(d.state.getInstalledAgentNames?.() ?? [])])];
175
+ if (isResearchDispatchName(d, agent)) {
176
+ return refusal(d, agent, task, "research_persona_via_dispatch", unknownAgentMessage(agent, available, true), "research_persona_via_dispatch");
177
+ }
178
+ if (!onRoster) {
179
+ // Every installed agent is dispatchable. The first dispatch adds it to the
180
+ // active team, so backend policy and session reuse keep working per member.
181
+ const added = d.state.addInstalledAgent?.(agent) ?? null;
182
+ if (added?.ok) {
183
+ onRoster = true;
184
+ try { ctx?.ui?.notify?.(`dispatch_agent: ${added.message}`, "info"); } catch { /* observational only */ }
185
+ }
186
+ }
187
+ if (!onRoster) {
188
+ return refusal(d, agent, task, "unknown_agent", unknownAgentMessage(agent, available, false), "unknown_agent");
189
+ }
190
+ return null;
191
+ }
192
+
193
+ function dispatchRequirements(d: DispatchExecutorDeps, agent: string, task: string): AcceptanceRequirement[] {
194
+ const state = d.state.getAgentStates().get(agent.toLowerCase());
195
+ if (!state || !hasWriteCapability(state.def.tools)) return [];
196
+ // validateBoundAssertionIds returns undefined only for an undefined input (legacy caller marker); the ledger map is always an array,
197
+ // so `?? []` is a type narrowing with no runtime effect — an invalid ledger still throws, an empty ledger still yields an empty set.
198
+ const ledgerIds = validateBoundAssertionIds(d.state.getAssertions().map(assertion => assertion.id)) ?? [];
199
+ const ids = new Set(ledgerIds.filter(id => String(task).split(/[^A-Za-z0-9_-]+/).includes(id)));
200
+ const ledger = d.state.getAssertions().filter(assertion => assertion.id === "AF-MIN-CHANGE" || ids.size === 0 || ids.has(assertion.id)).map(assertion => ({
201
+ id: assertion.id, tag: assertion.tag, text: assertion.text, source: assertion.source,
202
+ reference: assertion.reference, criticalConditions: assertion.criticalConditions, testCommand: assertion.testCommand, compilerCommand: assertion.compilerCommand,
203
+ status: assertion.status as AcceptanceRequirement["status"], evidenceTaskId: assertion.evidenceTaskId,
204
+ evidenceRevision: assertion.evidenceRevision, evidenceRefs: assertion.evidence ? [assertion.evidence] : [],
205
+ }));
206
+ const minimal = minimalChangeRequirement(), inherited = ledger.find(r => r.id === minimal.id);
207
+ if (inherited) inherited.criticalConditions = [...new Set([...(inherited.criticalConditions ?? []), ...(minimal.criticalConditions ?? []), ...(inherited.text !== minimal.text ? [minimal.text] : [])])];
208
+ return inherited ? ledger : [...ledger, minimal];
209
+ }
210
+
211
+ function appendRuntimeAcceptanceContract(task: string, requirements: AcceptanceRequirement[]): string {
212
+ if (!requirements.length) return task;
213
+ const lines = requirements.map(requirement => {
214
+ const origin = [requirement.source, requirement.reference].filter(Boolean).join(" · ");
215
+ const critical = requirement.criticalConditions?.length ? ` Critical: ${requirement.criticalConditions.join("; ")}.` : "";
216
+ return `- ${requirement.id} [${requirement.tag}]: ${requirement.text} (source: ${origin}).${critical}${requirement.compilerCommand ? ` Explicit compiler command: ${JSON.stringify(requirement.compilerCommand)} (execute only through approved bash).` : ""}${requirement.testCommand ? ` Explicit verification command: ${JSON.stringify(requirement.testCommand)} (execute only through approved bash).` : ""}`;
217
+ });
218
+ 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. Run explicit commands unchanged, one bash call per command, sequentially with no overlapping tool calls. Do not append echo, pipe, redirect, or wrap them; runtime captures exit codes, and altered command strings cannot satisfy the declaration.\n${lines.join("\n")}`;
219
+ }
220
+
221
+ const SCOPE_GLOB = /[*?[\]{}!]/;
222
+
223
+ /**
224
+ * Writes run one at a time unless every concurrent writer is OS-isolated to a
225
+ * disjoint exact scope (PHILOSOPHY, 2026-11-11). "Writable" follows the existing
226
+ * rule (write, edit or bash), so a bash-capable reviewer is also a writer; an
227
+ * isolated writer with an empty scope cannot write to the repository at all.
228
+ */
229
+ export function parallelWriterGate(d: DispatchExecutorDeps, agent: string, params: DispatchAgentParams): ToolExecutionResult | null {
230
+ const s = d.state; const def = s.getAgentStates().get(agent)?.def;
231
+ if (!def || !hasWriteCapability(def.tools)) return null;
232
+ const parallel = params.parallel === true;
233
+ const scope = (params.scope || []).map(String).map(entry => entry.trim()).filter(Boolean);
234
+ if (parallel) {
235
+ if (params.backend === "coms") return refusal(d, agent, params.task, "parallel_requires_native", "parallel: true needs the native OS write sandbox; a coms peer cannot be isolated. Use backend auto or native.");
236
+ const glob = scope.find(entry => SCOPE_GLOB.test(entry));
237
+ if (glob) return refusal(d, agent, params.task, "parallel_scope_invalid", `parallel: true needs exact existing files or directories as scope; globs cannot be enforced by the sandbox (${glob}).`);
238
+ if (params.scope_mode === "create") return refusal(d, agent, params.task, "parallel_scope_invalid", "parallel: true needs existing scope paths; create new files inside an existing directory that is in scope.");
239
+ }
240
+ const active = s.getActiveWriters?.()
241
+ ?? Array.from({ length: s.getActiveWritableDispatches() }, () => ({ agent: "a writable dispatch", scope: [], isolated: false }));
242
+ if (!active.length) return null;
243
+ const names = active.map(writer => writer.agent).join(", ");
244
+ if (!parallel) return refusal(d, agent, params.task, "writer_active", `${names} is running as a writable dispatch, so writes stay sequential; nothing started or charged. Wait for it to finish, or run writers together by dispatching each with parallel: true and disjoint exact scopes.`);
245
+ const open = active.find(writer => !writer.isolated);
246
+ if (open) return refusal(d, agent, params.task, "writer_active_unisolated", `${open.agent} is running without write isolation, so no other writer may start; nothing started or charged. Wait for it to finish.`);
247
+ for (const writer of active) {
248
+ const overlap = scope.length && writer.scope.length ? findScopeOverlap(scope, writer.scope) : null;
249
+ if (overlap) return refusal(d, agent, params.task, "scope_overlap", `Scope overlaps ${writer.agent}'s running write scope (${overlap.left} ↔ ${overlap.right}); nothing started or charged. Give parallel writers disjoint scopes or wait.`);
250
+ }
251
+ return null;
252
+ }
253
+
254
+ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentParams, ctx: ExtensionContext): PreparedDispatch | ToolExecutionResult {
255
+ const s = d.state; const { task, artifacts, scope, review_reason } = params; const agent = normalizeAgentInput(params.agent);
256
+ const privateMode = params.review_mode === 'private-config-current-state';
257
+ const operatorMode = params.review_mode === 'operator-current-state';
258
+ if (!privateMode && (params.private_config_files !== undefined || params.verifier_sources !== undefined)) return refusal(d,agent,task,'private_config_preflight_failed','Private declarations require explicit private-config-current-state mode.');
259
+ if (privateMode) {
260
+ try {
261
+ const tools = String(s.getAgentStates().get(agent)?.def.tools ?? '').split(',').map(t => t.trim());
262
+ if (!['code-reviewer','security-auditor'].includes(agent) || params.backend !== 'native' || params.scope_mode === 'create' || scope?.length || params.deliverables?.length || artifacts?.length || !s.getProcessState || (s.getProcessState().changedFiles.length || s.getProcessState().workOrigin || s.getProcessState().acceptance.evidenceRef || s.getProcessState().review.evidenceRef || s.getProcessState().additions?.some(a => a.status === 'active' && a.reason !== 'irreversible_execution')) || tools.some(t => ['edit','write'].includes(t)) || !tools.includes('bash')) throw Error();
263
+ const declarations = s.getAssertions();
264
+ if (!declarations.some(r => r.id !== 'AF-MIN-CHANGE') || declarations.some(r => !['test','code-grep'].includes(r.tag) || !r.testCommand && !r.compilerCommand)) throw Error();
265
+ capturePrivateConfig(ctx.cwd || process.cwd(), params.private_config_files, params.verifier_sources);
266
+ } catch { return refusal(d,agent,task,'private_config_preflight_failed','Private verification requires exact safe configuration/helper declarations, explicit automated checks and an independent native read-only reviewer; no source obligations, artifacts or Git scope.'); }
267
+ }
268
+ if(operatorMode){try{operatorScopeSyntax(scope);}catch{return refusal(d,agent,task,'operator_state_preflight_failed','Current-state scope must contain 1–128 unique exact files; no aliases/globs.');}}
269
+ if(operatorMode && (!['code-reviewer','security-auditor'].includes(agent)||params.backend!=='native'||params.scope_mode==='create'||params.deliverables?.length||!s.getProcessState))
270
+ return refusal(d,agent,task,'operator_state_preflight_failed','Current-state verification requires a native code/security reviewer, existing exact files and no deliverables.');
271
+ const rosterRefusal = validateDispatchAgent(d, agent, task, ctx);
272
+ if (rosterRefusal) return rosterRefusal;
273
+ const writerRefusal = parallelWriterGate(d, agent, params);
274
+ if (writerRefusal) return writerRefusal;
275
+ 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 } };
276
+ d.budget.ensureTaskTier();
277
+ const processGate = s.processBlock?.() ?? (s.getProcessState ? processPreEffectGate(s.getProcessState(), "child", agent) : { reason: "process_state_unavailable", message: "Process state is unavailable; child launch fails closed." });
278
+ const preflight = preflightGate(d, agent) ?? processGate ?? (s.getProcessState && processAllowsPersona(s.getProcessState(), agent) ? null : checkDocsLane(agent, scope || [], review_reason));
279
+ if (preflight) return refusal(d, agent, task, preflight.reason, `${preflight.message}\n\n${refusalSnapshot(d, ctx as any)}`, preflight.reason);
280
+ let contract: DeliverableContract;
281
+ try { contract = preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: s.getSessionDir() }); }
282
+ catch (error) { return refusal(d, agent, task, "scope_preflight_failed", String(error)); }
283
+ const takeSnapshot=()=>snapshotWorktree(ctx.cwd||process.cwd(),(scope||[]).map(String).map(x=>x.trim()).filter(Boolean));
284
+ // The task revision basis (D8, 2026-11-12), read off the snapshot this dispatch takes
285
+ // anyway: [] at a root repository, where every revision is the whole repository as
286
+ // before; otherwise each nested repository holding a declared path or a registered
287
+ // task file, whole.
288
+ const basisPaths=[...(scope||[]).map(String).map(x=>x.trim()).filter(Boolean),...(s.getProcessState?.().changedFiles??[])];
289
+ const basisFor=(snapshot:any):string[]=>snapshot?.nested?nestedRevisionScopes(ctx.cwd||process.cwd(),basisPaths):snapshot?.skipped&&basisPaths.length?revisionScopes(ctx.cwd||process.cwd(),basisPaths):[];
290
+ const revisionFor=(snapshot:any,basis:string[])=>basis.length?revisionOf(ctx.cwd||process.cwd(),basis):snapshotRevision(snapshot);
291
+ let operatorCandidate:OperatorStateCandidate|undefined,operatorSnapshot:any;
292
+ if(operatorMode){
293
+ try {
294
+ const state=s.getAgentStates().get(agent),tools=String(state?.def.tools??'').split(',').map(t=>t.trim());
295
+ if(!state||tools.some(t=>['edit','write'].includes(t)))throw Error('operator_state_writable_tools');
296
+ if(!tools.includes('bash'))throw Error('operator_state_tests_unavailable');
297
+ operatorSnapshot=takeSnapshot();
298
+ operatorCandidate=captureOperatorState({scope,cwd:ctx.cwd||process.cwd(),snapshot:operatorSnapshot,revision:revisionFor(operatorSnapshot,basisFor(operatorSnapshot))});
299
+ if(checkScope(s.getProcessState!().changedFiles,operatorCandidate.paths).outOfScope.length)throw Error('operator_state_incomplete_scope');
300
+ }catch(e){return refusal(d,agent,task,'operator_state_preflight_failed',e instanceof Error&&/^operator_state_[a-z_]+$/.test(e.message)?e.message:'operator_state_scope_unavailable');}
301
+ }
302
+ const fingerprint = taskFingerprint(agent, isReviewPersona(agent) ? `${task}\n${review_reason ?? ""}\n${JSON.stringify(scope ?? [])}${operatorMode?'\noperator-current-state':''}` : task);
303
+ // A consumed continuation permit is the explicit, human-confirmed repeat of an
304
+ // interrupted attempt (e.g. a watchdog stop this turn), not a model re-dispatch.
305
+ if (s.getTurnDispatchFingerprints().has(fingerprint) && !d.noProgress.continuing?.()) 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.`);
306
+ let inputArtifacts: InputArtifactPreview[];
307
+ try { inputArtifacts = d.artifacts.loadInputArtifacts(artifacts, ctx); }
308
+ catch (err: any) { return { content: [{ type: "text", text: `⚠ Dispatch NOT sent and NOT counted — 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" } }; }
309
+ s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1);
310
+ if (isReviewPersona(agent)) s.setTaskReviewRounds(s.getTaskReviewRounds() + 1);
311
+ s.getSessionTotals().dispatches++; d.budget.updateModeStatus();
312
+ const scopeGlobs = (scope || []).map(String).map(x => x.trim()).filter(Boolean);
313
+ try { s.recordDelegation?.({ agent, kind: "specialist", task, scope: scopeGlobs }); } catch { /* the brief is a record, never a gate */ }
314
+ const requirements = privateMode ? privateRequirements(s.getAssertions() as AcceptanceRequirement[]) : dispatchRequirements(d, agent, operatorMode ? '' : task);
315
+ const privateConfig: PrivateConfigBinding | undefined = privateMode ? {files: [...params.private_config_files!].sort(), sources: [...params.verifier_sources!].sort(), taskId: d.noProgress.taskId(), sessionDir: s.getSessionDir(), declarationHash: receiptDeclarationHash(requirements, scopeGlobs, s.getAcceptedUserInput?.(), inputArtifacts), captureId: '', generation: '', epoch: 0} : undefined;
316
+ const acceptedTask = appendRuntimeAcceptanceContract(task, requirements) + (privateConfig ? '\n\n## Private configuration current-state review\nReview the declared verifier/helper sources for semantic adequacy and completeness of declared dependencies. Private bodies are NOT input artifacts: never attach, copy, quote or export them. Run each exact declared offline command through approved bash. No activation, notification runtime, sockets, grants, policy changes or journal replay. Return an explicit APPROVE/REJECT and full scoped regression evidence. This private proof cannot satisfy Git source obligations.\nVerifier/helper sources: ' + JSON.stringify(privateConfig.sources) : '') + (operatorCandidate ? '\n\n## Explicit operator-current-state verification\nInspect the exact current candidate; do not modify source or claim historical authorship. Run every explicit automated verification command through approved bash, and report full scoped regression evidence. Manual assertions remain unsupported by automation. Return an explicit APPROVE/REJECT; runtime verifies unchanged scope/revision and actual checks. This does not make your read-only task a changed-task success.' : '');
317
+ 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;
318
+ const agentState = s.getAgentStates().get(agent.toLowerCase());
319
+ const resumeContract = {
320
+ ...(privateConfig ? {privateConfig} : {}),
321
+ taskId: d.noProgress.taskId(), instructions: declaredTask, scope: scopeGlobs,
322
+ // No parent ledger is the supported legacy task-text contract, not a bound minimal-only contract.
323
+ boundAssertionIds: s.getAssertions().length ? Object.freeze(validateBoundAssertionIds(requirements.map(requirement => requirement.id))) : undefined,
324
+ deliverables: contract.files.map(file => file.path), artifacts: inputArtifacts.map(artifact => artifact.path),
325
+ model: agentState ? (d.resolvedAgentModel?.(agentState.def, ctx) ?? agentState.def.model ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : null)) : null,
326
+ permissions: agentState?.def.tools ?? "",
327
+ };
328
+ // One pre-run snapshot is both the revision baseline and a writable run's delta base.
329
+ const beforeSnapshot = operatorSnapshot ?? takeSnapshot();
330
+ const revisionBasis = basisFor(beforeSnapshot);
331
+ return { privateConfig, operatorCandidate, beforeSnapshot, reviewInput: !privateMode && s.getProcessState ? reviewInput(ctx.cwd || process.cwd(), d.noProgress.taskId(), agent, scopeGlobs, operatorReviewState(s.getProcessState(),operatorCandidate), s.getAssertions(), inputArtifacts, s.getAcceptedUserInput?.()) : null, taskToken: d.noProgress.taskToken(), taskId: resumeContract.taskId, beforeRevision: revisionFor(beforeSnapshot, revisionBasis), revisionScopes: revisionBasis, requirements, contract, resumeContract, sessionDir: s.getSessionDir(), agent, task: declaredTask, inputArtifacts, scopeGlobs, fingerprint, parallel: params.parallel === true };
332
+ }
333
+
334
+ function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx: ExtensionContext): Tracking {
335
+ const s = d.state; const state = s.getAgentStates().get(prepared.agent.toLowerCase()); const canWrite = !!state && hasWriteCapability(state.def.tools);
336
+ const tracking: Tracking = { writable: canWrite, snapshot: null as any, overlapBaseline: s.getWritableOverlapCounter(), concurrentAtStart: s.getActiveWritableDispatches() > 0 };
337
+ if (canWrite) {
338
+ tracking.concurrentAtStart = s.getActiveWritableDispatches() > 0;
339
+ if (tracking.concurrentAtStart) s.setWritableOverlapCounter(s.getWritableOverlapCounter() + 1);
340
+ s.setActiveWritableDispatches(s.getActiveWritableDispatches() + 1);
341
+ // Registering an isolated writer is what makes its native launch sandboxed to its scope.
342
+ tracking.release = s.beginWriter?.({ agent: prepared.agent, scope: prepared.scopeGlobs, isolated: prepared.parallel === true });
343
+ if (prepared.parallel) tracking.isolatedScope = prepared.scopeGlobs;
344
+ tracking.snapshot = prepared.beforeSnapshot ?? snapshotWorktree(ctx.cwd || process.cwd(), prepared.scopeGlobs);
345
+ }
346
+ try { anchorReceipts(); } catch (error) { tracking.release?.(); throw error; }
347
+ return tracking;
348
+ function anchorReceipts(): void {
349
+ if (canWrite && s.getProcessState && s.setProcessState && s.persistProcessVerdict) {
350
+ const processState = s.getProcessState();
351
+ const started = beginReceiptCapture(processState.runtimeReceipts, { taskId: prepared.taskId, sessionDir: prepared.sessionDir, scope: prepared.scopeGlobs, declarationHash: receiptDeclarationHash(prepared.requirements, prepared.scopeGlobs, s.getAcceptedUserInput?.(), prepared.inputArtifacts) }, !tracking.concurrentAtStart);
352
+ const next = { ...processState, runtimeReceipts: started.state };
353
+ if (prepared.privateConfig) { delete next.privateVerification; next.privateVerificationRequired = true; }
354
+ s.setProcessState(next);
355
+ s.persistProcessVerdict(next, evaluateProcessObligations(next, { writable: true, budgetTier: s.getTaskTier() ?? "small" }));
356
+ if (s.processBlock?.()) throw Error("Runtime receipt capture could not be persisted");
357
+ tracking.receiptCapture = started.capture;
358
+ if (prepared.privateConfig) {
359
+ Object.assign(prepared.privateConfig, {captureId: started.capture.captureId, generation: started.capture.generation, epoch: started.capture.epoch});
360
+ prepared.beforeRevision = privateConfigRevision(ctx.cwd || process.cwd(), prepared.beforeRevision, prepared.privateConfig);
361
+ if (prepared.beforeRevision === 'unavailable') throw Error('Private capture unavailable');
362
+ }
363
+ }
364
+ }
365
+ }
366
+
367
+ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<RunData> {
368
+ const findingClause = reviewBudgetClause(d.state.getTaskTier(), p.agent); const dispatchedTask = findingClause ? `${p.task}\n\n${findingClause}` : p.task;
369
+ let result = await d.dispatchAgent(p.agent, dispatchedTask, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", false, p.resumeContract, p.revisionScopes);
370
+ let billed = result.billed ?? 0; let out = result.out ?? 0; const researchRounds: RunData["researchRounds"] = [];
371
+ while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS && p.taskToken === d.noProgress.taskToken() && p.sessionDir === d.state.getSessionDir()) {
372
+ const questions = d.extractNeedsResearch(result.output).slice(0, MAX_AUTO_RESEARCH_QUESTIONS); if (!questions.length) break;
373
+ d.state.setTaskResearchCount(d.state.getTaskResearchCount() + questions.length); d.budget.updateModeStatus();
374
+ 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" } });
375
+ const findingsDir = safePathWithin(p.sessionDir, "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
376
+ const answered = await Promise.all(questions.map(async question => {
377
+ const def = d.research.anonymousDef(); const state = d.research.createState(def, false, d.research.resolveModel(def, undefined, ctx));
378
+ const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-${response.dispatchId ?? randomUUID()}.md`);
379
+ 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 };
380
+ }));
381
+ researchRounds.push({ questions, files: answered.map(a => a.file) });
382
+ 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");
383
+ if (p.taskToken !== d.noProgress.taskToken() || p.sessionDir !== d.state.getSessionDir()) break;
384
+ result = await d.dispatchAgent(p.agent, resume, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", true, p.resumeContract, p.revisionScopes); billed += result.billed ?? 0; out += result.out ?? 0;
385
+ }
386
+ return { result, billed, out, researchRounds };
387
+ }
388
+
389
+ /** Writable dispatches running now other than this one (registry when available, else the counter). */
390
+ function otherActiveWriters(d: DispatchExecutorDeps, p: PreparedDispatch, tracking: Tracking): { agent: string }[] {
391
+ const s = d.state;
392
+ const writers = s.getActiveWriters?.()
393
+ ?? Array.from({ length: Math.max(0, s.getActiveWritableDispatches() - (tracking.writable ? 1 : 0)) }, () => ({ agent: "a writable dispatch" }));
394
+ return writers.filter(writer => writer.agent.toLowerCase() !== p.agent.toLowerCase());
395
+ }
396
+
397
+ function observeWorktree(d: DispatchExecutorDeps, tracking: Tracking, ctx: ExtensionContext): WorktreeObservation | null {
398
+ if (!tracking.snapshot) return null;
399
+ const diff = diffAgainst(tracking.snapshot, ctx.cwd || process.cwd());
400
+ if (tracking.isolatedScope && !diff.skipped) {
401
+ // The OS sandbox confined this writer to its scope, and the admission gate let
402
+ // only isolated writers with disjoint scopes run beside it. Changes outside
403
+ // its scope cannot be its own; they are reported, never attributed to it.
404
+ const own = tracking.isolatedScope.length ? checkScope(diff.paths, tracking.isolatedScope).inScope : [];
405
+ return { ...diff, paths: own, foreignPaths: diff.paths.filter(path => !own.includes(path)), concurrentWritableOverlap: false };
406
+ }
407
+ const concurrentWritableOverlap = tracking.concurrentAtStart || d.state.getWritableOverlapCounter() !== tracking.overlapBaseline;
408
+ return { ...diff, concurrentWritableOverlap };
409
+ }
410
+
411
+ function scopeResult(p: PreparedDispatch, observation: WorktreeObservation | null): any {
412
+ if (!observation || p.scopeGlobs.length === 0) return null;
413
+ if (observation.skipped) return { skipped: true, reason: observation.reason, gaps: observation.gaps, declaredScope: p.scopeGlobs, concurrentWritableOverlap: observation.concurrentWritableOverlap };
414
+ return { ...checkScope(observation.paths, p.scopeGlobs), changedPaths: observation.paths, declaredScope: p.scopeGlobs, concurrentWritableOverlap: observation.concurrentWritableOverlap, gaps: observation.gaps, repositories: observation.repositories };
415
+ }
416
+
417
+ function incompleteObservation(reason: string, overlap: boolean): DiagnosticsResult {
418
+ return { status: "incomplete", reason, changedFiles: [], attribution: overlap ? "uncertain" : "no_observed_overlap", projects: [], uncoveredFiles: [] };
419
+ }
420
+
421
+ /** Compiler discovery starts at each observed repository, never at a non-Git parent. */
422
+ async function diagnoseObservation(d: DispatchExecutorDeps, observation: WorktreeObservation, cwd: string, cacheLane: string, runId: string): Promise<DiagnosticsResult> {
423
+ const diagnose = d.diagnoseChangedTypeScript ?? diagnoseChangedTypeScript;
424
+ const options = { cwd, attribution: observation.concurrentWritableOverlap ? "uncertain" as const : "no_observed_overlap" as const, cacheLane, runId };
425
+ if (!observation.repositories) return diagnose(observation.paths, options);
426
+ const results: DiagnosticsResult[] = [];
427
+ for (const repo of observation.repositories) {
428
+ const paths = observation.paths.filter(path => path.startsWith(`${repo.prefix}/`)).map(path => path.slice(repo.prefix.length + 1));
429
+ if (!paths.some(path => /\.(?:ts|tsx|mts|cts)$/i.test(path))) continue;
430
+ const workspacePath = (path: string) => isAbsolute(path) ? path : `${repo.prefix}/${path}`;
431
+ const unavailable = (reason: string): DiagnosticsResult => ({
432
+ ...incompleteObservation(reason, observation.concurrentWritableOverlap), changedFiles: paths.map(workspacePath), uncoveredFiles: paths.map(workspacePath),
433
+ projects: [{ project: repo.root, status: "unavailable", reason, exitCode: null, argv: [], stdout: "", stderr: "", diagnostics: [] }],
434
+ });
435
+ try {
436
+ const result = await diagnose(paths, { ...options, cwd: repo.root });
437
+ results.push({ ...result, changedFiles: result.changedFiles.map(workspacePath), uncoveredFiles: result.uncoveredFiles?.map(workspacePath), projects: result.projects.map(project => ({
438
+ ...project, project: workspacePath(project.project), changedFiles: project.changedFiles?.map(workspacePath),
439
+ diagnostics: project.diagnostics.map(diagnostic => ({ ...diagnostic, ...(diagnostic.file ? { file: workspacePath(diagnostic.file) } : {}) })),
440
+ })) });
441
+ // A passing sibling project cannot cover a repository whose compiler
442
+ // verification was incomplete. Retain the unavailable check explicitly.
443
+ if (result.status !== "completed" || result.uncoveredFiles?.length) results.push(unavailable(`${repo.prefix}: ${result.reason ?? "Compiler coverage incomplete"}`));
444
+ } catch (error) { results.push(unavailable(`Compiler observation failed for ${repo.prefix}: ${String(error)}`)); }
445
+ }
446
+ const reasons = [...(observation.gaps ?? []).map(gap => `${gap.scope}: ${gap.reason}`), ...results.filter(result => result.status === "incomplete").map(result => result.reason ?? "Compiler observation incomplete")];
447
+ return { status: reasons.length ? "incomplete" : results.some(result => result.status === "completed") ? "completed" : "skipped",
448
+ reason: reasons.length ? reasons.join("; ") : undefined, attribution: options.attribution,
449
+ changedFiles: [...new Set(results.flatMap(result => result.changedFiles))], projects: results.flatMap(result => result.projects), uncoveredFiles: [...new Set(results.flatMap(result => result.uncoveredFiles ?? []))] };
450
+ }
451
+
452
+ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
453
+ const s = d.state; const { result, researchRounds } = run; const cwd = ctx.cwd || process.cwd();
454
+ const sameTaskNow = () => p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir();
455
+ const ids = validateBoundAssertionIds(p.resumeContract.boundAssertionIds) ?? extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
456
+ // Observe immediately at logical child completion, before Hub-owned artifacts are written.
457
+ const observation = tracking.writable ? observeWorktree(d, tracking, ctx) : null;
458
+ const submission = disposition.delivered ? result.specialistResult : undefined;
459
+ const deliveredReturn = submission
460
+ ? { parsed: submission, notices: crossCheck(submission, ids) }
461
+ : parseDeliveredReturn(result.output, ids, disposition.delivered);
462
+ let parsedReturn: any = deliveredReturn.parsed; let contractNotices: any[] = deliveredReturn.notices;
463
+ const shouldUseDigest = ids.length > 0 || !!parsedReturn; const state = sameTaskNow() ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined;
464
+ const key = safeAgentKey(state?.def.name ?? p.agent); const backendUsed = state?.lastBackend ?? null;
465
+ const failureMetadata = { dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null,
466
+ agent: p.agent, task: p.task, scope: p.scopeGlobs, exitCode: result.exitCode, diagnostics: result.diagnostics ?? null };
467
+ const artifactOutput = disposition.delivered ? (submission ? result.output + "\n\n## Submitted result\n\n" + JSON.stringify(submission, null, 2) : result.output)
468
+ : `# Dispatch failure\n\n\`\`\`json\n${JSON.stringify(failureMetadata, null, 2)}\n\`\`\`\n\n## Output\n\n${result.output}`;
469
+ const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind as any, result.dispatchId, p.sessionDir) : null;
470
+ const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
471
+ if (returnPath && (!result.specialistResultTool || d.returnExtractionAssist?.() === true) && shouldExtractReturn(parsedReturn, ids)) {
472
+ 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" } });
473
+ const recovered = await d.runReturnExtraction(returnPath, ids, ctx);
474
+ if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
475
+ }
476
+
477
+ // The one shared post-run delta feeds both scope reporting and compiler selection.
478
+ let compilerDiagnostics: DiagnosticsResult | null = null; let compilerEvidencePath: string | null = null; let compilerEvidenceError: string | null = null;
479
+ // The post-run observation also yields the revision; only an awaited compiler run
480
+ // needs a fresh revision for acceptance afterwards.
481
+ const compilerInspectedRevision = observation && !observation.skipped && observation.snapshot ? snapshotRevision(observation.snapshot) : worktreeRevision(cwd, [], p.scopeGlobs);
482
+ let compilerRan = false;
483
+ const eligibleForCompiler = disposition.delivered && tracking.writable && backendUsed === "native" && sameTaskNow();
484
+ if (eligibleForCompiler && observation?.skipped) {
485
+ compilerDiagnostics = incompleteObservation(`worktree observation unavailable: ${observation.reason ?? "unknown reason"}`, observation.concurrentWritableOverlap);
486
+ } else if (eligibleForCompiler && observation && (observation.gaps?.length || observation.paths.some(path => /\.(?:ts|tsx|mts|cts)$/i.test(path)))) {
487
+ compilerRan = true;
488
+ try {
489
+ compilerDiagnostics = await diagnoseObservation(d, observation, cwd, key, result.dispatchId ?? randomUUID());
490
+ } catch (error) {
491
+ compilerDiagnostics = incompleteObservation(`compiler diagnostics failed safely: ${String(error)}`, observation.concurrentWritableOverlap);
492
+ }
493
+ }
494
+ if (observation && !tracking.isolatedScope) {
495
+ observation.concurrentWritableOverlap = observation.concurrentWritableOverlap || tracking.concurrentAtStart || s.getWritableOverlapCounter() !== tracking.overlapBaseline;
496
+ if (compilerDiagnostics && observation.concurrentWritableOverlap) compilerDiagnostics = { ...compilerDiagnostics, attribution: "uncertain" };
497
+ }
498
+ const sameTask = sameTaskNow();
499
+ if (sameTask && compilerDiagnostics) {
500
+ const correction = correctStructuredReturnForCompiler(parsedReturn, ids, compilerDiagnostics);
501
+ parsedReturn = correction.parsed;
502
+ contractNotices = [...crossCheck(parsedReturn, ids), ...correction.demotedIds.map(id => ({ type: "compiler_diagnostics", id }))];
503
+ }
504
+ const assessmentId = result.dispatchId ?? randomUUID();
505
+ if (compilerDiagnostics && compilerDiagnostics.status !== "skipped") {
506
+ try {
507
+ compilerEvidencePath = d.artifacts.writeRunArtifact(`${key}-compiler`, state?.runCount ?? 0,
508
+ `# Compiler diagnostics\n\n\`\`\`json\n${JSON.stringify(compilerDiagnostics, null, 2)}\n\`\`\`\n`, "evidence", assessmentId, p.sessionDir);
509
+ } catch (error) { compilerEvidenceError = String(error); }
510
+ }
511
+ const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd, sessionDir: p.sessionDir },
512
+ (index, bytes) => retainDeliverable(p.sessionDir, assessmentId, index, bytes));
513
+ let protocolDiagnostic: ToolProtocolDiagnostic | null = null; let protocolEvidencePath: string | null = null;
514
+ if (disposition.delivered && backendUsed === "native") {
515
+ protocolDiagnostic = diagnoseToolProtocol({
516
+ output: result.output,
517
+ toolEvents: result.toolEvents ?? [],
518
+ deliverables: readback,
519
+ origin: { kind: "task", taskId: p.taskId, dispatchId: result.dispatchId ?? assessmentId },
520
+ effectiveConfiguration: {
521
+ backend: backendUsed,
522
+ model: result.diagnostics?.modelUsed ?? state?.def.model ?? null,
523
+ tools: result.diagnostics?.effectiveTools ?? String(state?.def.tools ?? "").split(",").map(tool => tool.trim()).filter(Boolean),
524
+ },
525
+ evidenceRefs: [returnPath ?? undefined, ...readback.map(item => item.retainedPath)].filter((value): value is string => !!value),
526
+ });
527
+ if (protocolDiagnostic) {
528
+ protocolEvidencePath = d.artifacts.writeRunArtifact(`${key}-tool-protocol`, state?.runCount ?? 0,
529
+ JSON.stringify(protocolDiagnostic, null, 2), "evidence", randomUUID(), p.sessionDir);
530
+ protocolDiagnostic.evidenceRefs = [...new Set([...protocolDiagnostic.evidenceRefs, protocolEvidencePath])];
531
+ }
532
+ }
533
+ const executionStatus = disposition.pending ? "pending" : disposition.delivered ? "completed" : "failed";
534
+ const repositoryAfterRevision = p.revisionScopes.length ? revisionOf(cwd, p.revisionScopes) : compilerRan ? worktreeRevision(cwd, [], p.scopeGlobs) : compilerInspectedRevision;
535
+ // Each recorded stage is checked over the basis it was recorded with.
536
+ const stageRevision = (scopes: readonly string[]) => scopes.join("\n") === p.revisionScopes.join("\n") ? afterRevision : revisionOf(cwd, [...scopes]);
537
+ const afterRevision = p.privateConfig ? privateConfigRevision(cwd, repositoryAfterRevision, p.privateConfig) : repositoryAfterRevision;
538
+ const changes = !tracking.writable || !observation
539
+ ? { status: "unknown" as const, paths: [] as string[], attribution: "not_observed" as const }
540
+ : observation.skipped
541
+ ? { status: "unknown" as const, paths: [] as string[], attribution: "not_observed" as const }
542
+ : { status: observation.paths.length ? "changed" as const : "unchanged" as const, paths: observation.paths, attribution: observation.concurrentWritableOverlap || observation.gaps?.length ? "uncertain" as const : "certain" as const };
543
+ const checks: VerificationCheckInput[] = (compilerDiagnostics?.projects ?? []).map(project => ({
544
+ producer: "runtime", kind: "compilation", taskId: p.taskId, command: [...(project.argv ?? [])], exitCode: project.exitCode,
545
+ inspectedRevision: compilerInspectedRevision, evidenceRef: compilerEvidencePath ?? "",
546
+ requirementIds: ["AF-MIN-CHANGE"],
547
+ }));
548
+ const receiptCapture = tracking.receiptCapture;
549
+ const receiptState = s.getProcessState?.().runtimeReceipts;
550
+ // Stream integrity is independent of observations: an empty check list is not proof of a clean capture.
551
+ // When native capture is expected, a missing integrity value fails closed; only an explicit "complete" is clean.
552
+ const captureExpected = backendUsed === "native" && (tracking.writable || !!p.operatorCandidate || !!p.privateConfig);
553
+ const captureIntegrity = result.lifecycle?.runtimeCaptureIntegrity;
554
+ const captureClean = captureExpected ? captureIntegrity === "complete" : captureIntegrity !== "tainted";
555
+ // Only declared evidence producers govern receipt exclusivity. Preparatory
556
+ // bash inspections can overlap reads without overlapping any evidence run.
557
+ // Source revision, stream integrity and concurrent-writer gates still apply.
558
+ const evidenceCommands = new Set(p.requirements.flatMap(requirement =>
559
+ [requirement.testCommand, requirement.compilerCommand].filter(Boolean)));
560
+ const exclusive = captureClean && !(result.runtimeTests ?? []).some(record => evidenceCommands.has(record.command) && record.exclusive === false) && !tracking.concurrentAtStart && s.getWritableOverlapCounter() === tracking.overlapBaseline && s.getActiveWritableDispatches() <= (tracking.writable ? 1 : 0);
561
+ const captureCurrent = !!receiptCapture && !!receiptState && sameTaskNow() && receiptCapture.taskId === d.noProgress.taskId()
562
+ && receiptState.pending.length === 1 && receiptState.pending[0] === receiptCapture.captureId
563
+ && receiptCapture.sessionDir === s.getSessionDir() && receiptCapture.generation === receiptState.generation && receiptCapture.epoch === receiptState.epoch
564
+ && receiptCapture.declarationHash === receiptDeclarationHash(p.privateConfig ? privateRequirements(s.getAssertions() as AcceptanceRequirement[]) : dispatchRequirements(d, p.agent, p.operatorCandidate ? '' : params.task), p.scopeGlobs, s.getAcceptedUserInput?.(), p.inputArtifacts);
565
+ const observations = backendUsed === "native" && (tracking.writable || !!p.operatorCandidate || !!p.privateConfig) ? result.runtimeTests ?? [] : [];
566
+ // A newer failure/unknown result for a command supersedes its success, even
567
+ // when the unknown observer result could not construct a success receipt.
568
+ const latest = new Map(observations.map(record => [record.command, record]));
569
+ if (receiptCapture && receiptState) {
570
+ const retained = !p.privateConfig && captureCurrent && exclusive && p.beforeRevision === afterRevision && backendUsed === "native" ? reusableRuntimeChecks(receiptState, receiptCapture, afterRevision) : [];
571
+ checks.push(...retained.filter(check => !latest.has(check.command[0])));
572
+ }
573
+ const anchored: RuntimeReceipt[] = [];
574
+ for (const record of latest.values()) for (const kind of ["test", "code-grep", "compilation"] as const) {
575
+ const covered = p.requirements.filter(requirement => ["test", "code-grep"].includes(requirement.tag) && requirement.source && (kind === "compilation" ? requirement.compilerCommand === record.command : requirement.tag === kind && requirement.testCommand === record.command));
576
+ if (!covered.length) continue;
577
+ const coverage = covered.map(requirement => ({ id: requirement.id, source: requirement.source, text: requirement.text, reference: requirement.reference, criticalConditions: requirement.criticalConditions ?? [] }));
578
+ const serialized = JSON.stringify({
579
+ schema: "agent-fleet.runtime-test-evidence/v1", observation: record,
580
+ declaration: { taskId: p.taskId, dispatchId: result.dispatchId, kind, coverage },
581
+ ...(receiptCapture ? { capture: receiptCapture } : {}),
582
+ evaluationSource: "agent-fleet.runtime-result/v1 verification.checks and verification.requirements",
583
+ }, null, 2);
584
+ const evidenceRef = d.artifacts.writeRunArtifact(`${key}-test-check`, state?.runCount ?? 0, serialized, "evidence", randomUUID(), p.sessionDir);
585
+ // Fresh observations follow the same rule as the parser-owned exclusive flag: anything other than an explicit
586
+ // "complete" capture stream (tainted, or a missing value) makes the record ineligible for acceptance.
587
+ const check: VerificationCheckInput = { producer: "runtime", kind, command: [record.command], exitCode: record.exitCode,
588
+ inspectedRevision: record.exclusive === false || captureIntegrity !== "complete" ? "unavailable" : record.beforeRevision === record.afterRevision ? record.afterRevision : "changed-during-check",
589
+ evidenceRef, requirementIds: [...new Set(["AF-MIN-CHANGE", ...covered.map(requirement => requirement.id)])], taskId: p.taskId, coverage };
590
+ checks.push(check);
591
+ if (captureCurrent && exclusive && record.producer === "agent-fleet.runtime-test/v1" && record.exclusive !== false && result.dispatchId && record.exitCode === 0 && record.beforeRevision === afterRevision && record.afterRevision === afterRevision && /^[a-f0-9]{64}$/.test(afterRevision)) {
592
+ try { anchored.push(anchorRuntimeReceipt(receiptCapture!, check, result.dispatchId, serialized)); } catch { /* No anchor => no continuation. */ }
593
+ }
594
+ }
595
+ if (receiptCapture && receiptState && sameTaskNow()) {
596
+ // Retention is not reuse: a clean unrelated inspection must not erase
597
+ // anchors merely because its declaration/scope cannot borrow them. Reuse
598
+ // still validates the exact contract, revision and evidence bytes above.
599
+ // New observations (including failures/unknowns) supersede that command.
600
+ const records = captureCurrent && exclusive && p.beforeRevision === afterRevision && backendUsed === "native"
601
+ ? [...receiptState.records.filter(r => !latest.has(r.check.command[0])), ...anchored].slice(-64) : [];
602
+ const next = { ...s.getProcessState!(), runtimeReceipts: { ...receiptState, pending: receiptState.pending.filter(id => id !== receiptCapture.captureId), records } };
603
+ s.setProcessState?.(next);
604
+ // The ordinary finish path below journals this state through processAuditRecord.
605
+ }
606
+
607
+ const runtimeResult: any = buildRuntimeResult({
608
+ task: { id: p.taskId, current: sameTask && p.taskId === d.noProgress.taskId(), beforeRevision: p.beforeRevision, afterRevision },
609
+ execution: { status: executionStatus, exitCode: result.exitCode, dispatchId: result.dispatchId ?? null },
610
+ changes, requirements: p.requirements, deliverables: readback, checks,
611
+ evidenceRefs: [returnPath ?? undefined, failurePath ?? undefined, compilerEvidencePath ?? undefined, protocolEvidencePath ?? undefined].filter((value): value is string => !!value),
612
+ });
613
+ const checkDiagnostics = captureExpected && disposition.delivered ? verificationDiagnostics(p.requirements, observations, checks) : null;
614
+ if (submission && (submission.status !== "completed" || submission.requires_user_decision.some(question => question.trim().toLowerCase() !== "none"))) {
615
+ runtimeResult.acceptance = { status: "not_accepted", accepted: false, reasons: [...runtimeResult.acceptance.reasons, "specialist_" + submission.status] };
616
+ runtimeResult.compatibility = { hubAcceptanceStatus: "needs_verification", flowStatus: "rejected" };
617
+ }
618
+ const privateConfigVerification = p.privateConfig ? finishPrivateConfigReview({
619
+ cwd, binding: p.privateConfig, beforeRevision: p.beforeRevision, revision: afterRevision, sameTask: sameTaskNow(), native: backendUsed === 'native',
620
+ reviewerValid: ['code-reviewer','security-auditor'].includes(state?.def.name ?? '') && !String(state?.def.tools ?? '').split(',').some(t => ['edit','write'].includes(t.trim())),
621
+ stillCurrent: () => sameTaskNow() && s.getActiveWritableDispatches() <= (tracking.writable ? 1 : 0) && s.getWritableOverlapCounter() === tracking.overlapBaseline
622
+ && !s.getProcessState?.().changedFiles.length && !s.getProcessState?.().acceptance.evidenceRef && !s.getProcessState?.().review.evidenceRef
623
+ && s.getProcessState?.().runtimeReceipts?.generation === p.privateConfig!.generation && s.getProcessState?.().runtimeReceipts?.epoch === p.privateConfig!.epoch
624
+ && tracking.receiptCapture?.declarationHash === privateDeclarationHash(s.getAssertions() as AcceptanceRequirement[], s.getAcceptedUserInput?.()),
625
+ exclusive, captureCurrent,
626
+ delivered: disposition.delivered, exitCode: result.exitCode, dispatchId: result.dispatchId, submission, protocolDiagnostic, output: result.output, parsedReturn,
627
+ questions: d.extractAskUserQuestions(result.output), research: d.extractNeedsResearch(result.output), verification: runtimeResult.verification, anchored,
628
+ sourceDelta: !!observation?.skipped || !!observation?.paths.length || !!observation?.gaps?.length,
629
+ sourceObligations: !!s.getProcessState?.().changedFiles.length || !!s.getProcessState?.().workOrigin || !!s.getProcessState?.().acceptance.evidenceRef || !!s.getProcessState?.().review.evidenceRef || !!s.getProcessState?.().additions?.some(a => a.status === 'active' && a.reason !== 'irreversible_execution'), returnPath: runPath, writer: d.artifacts.writeRunArtifact, runCount: state?.runCount ?? 0,
630
+ }) : undefined;
631
+ let processVerdict: ProcessVerdict | null = null;
632
+ let operatorStateVerification:any = p.operatorCandidate ? {status:'unproven',origin:p.operatorCandidate.origin,historicalAttribution:'not_claimed',scope:p.operatorCandidate.paths,revision:afterRevision} : undefined;
633
+ if (s.getProcessState) {
634
+ let processState = s.getProcessState();
635
+ const taskChanges = (paths: string[]) => reviewableChangedPaths(paths, cwd, p.sessionDir, p.scopeGlobs, p.contract.files.map(file => file.path));
636
+ if (!p.privateConfig && !p.operatorCandidate && runtimeResult.acceptance.accepted && runtimeResult.verification.evidenceRefs[0]) {
637
+ processState = noteProcessStage(processState, "acceptance", { evidenceRef: runtimeResult.verification.evidenceRefs[0], revision: afterRevision, revisionScopes: p.revisionScopes, changedFiles: taskChanges(observation?.paths ?? []) });
638
+ }
639
+ const stage = p.privateConfig ? null : basePersonaName(p.agent) === "planner" ? "plan" : isReviewPersona(p.agent) ? "review" : null;
640
+ const affirmativeReview = affirmativeReviewVerdict(result.output);
641
+ // Candidate registration happens only after independent review and actual
642
+ // same-revision runtime checks, never from reported past edits.
643
+ const candidateReviewInput=stage==='review'?reviewInput(cwd,p.taskId,p.agent,p.scopeGlobs,operatorReviewState(processState,p.operatorCandidate),s.getAssertions(),p.inputArtifacts,s.getAcceptedUserInput?.()):null;
644
+ // Named, ordered qualifiers: the same conjunction as before, so a refusal can
645
+ // say which one failed. Diagnostics never relax or reorder a gate.
646
+ const reviewQualifiers: Array<[string, boolean]> = [
647
+ ["tool_protocol_error", !protocolDiagnostic],
648
+ ["deliverable_failed", runtimeResult.compatibility.hubAcceptanceStatus !== "deliverable_failed"],
649
+ ["submission_incomplete", !submission || submission.status === "completed"],
650
+ ["blocking_findings", countReviewFindings(result.output).blocking === 0],
651
+ ["assertions_failed", !(parsedReturn?.assertions_failed ?? []).length],
652
+ ["unresolved_questions", !d.extractAskUserQuestions(result.output).length],
653
+ ["needs_research", !d.extractNeedsResearch(result.output).length],
654
+ ["requires_user_decision", !(parsedReturn?.requires_user_decision ?? []).some((entry:unknown)=>String(entry).trim().toLowerCase()!=="none")],
655
+ ["review_input_changed", !p.reviewInput || JSON.stringify(p.reviewInput) === JSON.stringify(candidateReviewInput)],
656
+ ];
657
+ const reviewComplete = reviewQualifiers.every(([, ok]) => ok);
658
+ const checksRefusal = p.operatorCandidate ? operatorStateChecksDiagnostic({candidate:p.operatorCandidate,revision:afterRevision,sameTask:sameTaskNow(),native:backendUsed==='native',exclusive,verification:runtimeResult.verification}) : null;
659
+ const candidateQualifiers: Array<[string, boolean]> = p.operatorCandidate ? [
660
+ ...reviewQualifiers,
661
+ ["not_review_stage", stage==='review'],
662
+ ["not_same_task", sameTaskNow()],
663
+ ["not_delivered", disposition.delivered&&result.exitCode===0],
664
+ ["submission_incomplete", !result.specialistResultTool||submission?.status==='completed'],
665
+ ["review_input_missing", !!p.reviewInput],
666
+ ["verdict_not_affirmative", affirmativeReview],
667
+ ["regression_not_closed", reviewMayClose({revision:afterRevision,scope:p.operatorCandidate.paths,output:result.output,evidenceRef:runPath??undefined,declared:!!parsedReturn,wide:processState.scope==='wide'||!!processState.additions?.some(item=>item.status==='active'&&item.reason==='wide_change')})],
668
+ [checksRefusal ?? "runtime_checks", checksRefusal === null],
669
+ ] : [];
670
+ const failedQualifiers = [...new Set(candidateQualifiers.filter(([, ok]) => !ok).map(([code]) => code))];
671
+ const candidateReady = !!p.operatorCandidate && failedQualifiers.length === 0;
672
+ if (p.operatorCandidate && failedQualifiers.length) operatorStateVerification = { ...operatorStateVerification, reason: failedQualifiers[0], failedQualifiers, nextStep: operatorStateNextStep(failedQualifiers[0]) };
673
+ if(candidateReady&&p.operatorCandidate){
674
+ try {
675
+ const evidenceRef=persistOperatorStateProof({writer:d.artifacts.writeRunArtifact,sessionDir:p.sessionDir,runCount:state?.runCount??0,dispatchId:result.dispatchId||randomUUID(),record:{schema:'agent-fleet.operator-state-verification/v1',...p.operatorCandidate,taskId:p.taskId,checks:runtimeResult.verification.checks,manualAssertions:'not_automatically_proven'}});
676
+ processState=noteProcessStage(processState,'acceptance',{evidenceRef,revision:afterRevision,revisionScopes:p.revisionScopes,changedFiles:p.operatorCandidate.paths,workOrigin:'operator-current-state'});
677
+ operatorStateVerification={...operatorStateVerification,status:'accepted',evidenceRef};
678
+ } catch { operatorStateVerification={...operatorStateVerification,reason:'evidence_readback_failed',failedQualifiers:['evidence_readback_failed'],nextStep:operatorStateNextStep('evidence_readback_failed')}; }
679
+ }
680
+ const reviewScope = checkScope(processState.changedFiles, p.scopeGlobs);
681
+ const completedReviewInput = candidateReviewInput;
682
+ // The review that closes the task covers the whole change with no other writer
683
+ // running (PHILOSOPHY, 2026-11-11): an area review beside a parallel writer is
684
+ // evidence for its area, never the task's final review.
685
+ const otherWriters = otherActiveWriters(d, p, tracking);
686
+ const reviewAuthorized = stage !== "review" || (otherWriters.length === 0 && (!p.operatorCandidate || operatorStateVerification?.status==='accepted') && reviewComplete && 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") }));
687
+ // A declared plan must read back successfully; a refusal or unresolved
688
+ // decision is not plan evidence. No declaration still permits a retained
689
+ // nonempty plan return. The Hub cannot judge its semantic adequacy.
690
+ const planProduced = stage !== "plan" || ((!submission || submission.status === "completed") && result.output.trim().length > 0
691
+ && runtimeResult.compatibility.hubAcceptanceStatus !== "deliverable_failed"
692
+ && !(parsedReturn?.requires_user_decision ?? []).some((entry: unknown) => String(entry).trim().toLowerCase() !== "none")
693
+ && d.extractNeedsResearch(result.output).length === 0 && d.extractAskUserQuestions(result.output).length === 0);
694
+ if (stage && planProduced && reviewAuthorized && disposition.delivered && result.exitCode === 0 && sameTask && runPath) {
695
+ processState = noteProcessStage(processState, stage, { evidenceRef: runPath, revision: afterRevision, revisionScopes: p.revisionScopes });
696
+ if(stage === "review" && !tracking.writable && !tracking.concurrentAtStart && !s.getActiveWritableDispatches() && tracking.overlapBaseline === s.getWritableOverlapCounter()
697
+ && p.reviewInput && JSON.stringify(p.reviewInput) === JSON.stringify(completedReviewInput)) processState=retainReview(processState,completedReviewInput,runPath,cwd);
698
+ }
699
+ if(stage === "review" && disposition.delivered && sameTask && runPath && p.reviewInput && p.reviewBaseline
700
+ && !tracking.writable && !tracking.concurrentAtStart && !s.getActiveWritableDispatches()
701
+ && tracking.overlapBaseline === s.getWritableOverlapCounter()
702
+ && JSON.stringify(p.reviewInput) === JSON.stringify(completedReviewInput)){
703
+ try {
704
+ const baselineRef=d.artifacts.writeRunArtifact(key+"-review-baseline",state?.runCount??0,JSON.stringify(p.reviewBaseline),"returns",result.dispatchId,p.sessionDir);
705
+ if(baselineRef)processState=retainReviewHistory(processState,p.reviewInput,runPath,baselineRef,cwd);
706
+ } catch { /* Missing optional baseline forces a full review next time. */ }
707
+ }
708
+ const planDeliverable = p.contract.files.map(file => file.path).find(path => /plan/i.test(path));
709
+ if (p.agent === "builder" && planDeliverable && runPath && authorizePlanStatusUpdate({ planPath: planDeliverable, allowedScope: p.scopeGlobs, evidenceRefs: [runPath] }).allowed && sameTask) {
710
+ processState = noteProcessStage(processState, "plan", { evidenceRef: runPath, revision: afterRevision, revisionScopes: p.revisionScopes });
711
+ }
712
+ if (p.privateConfig && privateConfigVerification?.status === 'accepted' && 'evidenceRef' in privateConfigVerification && 'evidenceHash' in privateConfigVerification && 'reviewer' in privateConfigVerification) {
713
+ processState.privateVerification = { origin: 'private-config-current-state', binding: structuredClone(p.privateConfig), revision: afterRevision,
714
+ evidenceRef: privateConfigVerification.evidenceRef as string, evidenceHash: privateConfigVerification.evidenceHash as string, reviewer: privateConfigVerification.reviewer,
715
+ overlap: tracking.overlapBaseline, classification: privateClassification(processState),
716
+ receipts: anchored.map(r => ({ evidenceRef: r.check.evidenceRef, evidenceHash: r.evidenceHash })) };
717
+ }
718
+ const privateUse: PrivateProofUse = { cwd, taskId: d.noProgress.taskId(), sessionDir: s.getSessionDir(), declarationHash: privateDeclarationHash(s.getAssertions() as AcceptanceRequirement[], s.getAcceptedUserInput?.()), activeWriters: s.getActiveWritableDispatches() - (tracking.writable ? 1 : 0), overlap: s.getWritableOverlapCounter() };
719
+ s.setProcessState?.(processState);
720
+ processVerdict = evaluateProcessObligations(processState, { writable: tracking.writable || stage !== null, budgetTier: s.getTaskTier() ?? "small", t2Accepted: !p.privateConfig && !p.operatorCandidate && runtimeResult.acceptance.accepted, currentRevision: stageRevision, ...(p.privateConfig ? { privateUse } : {}) });
721
+ runtimeResult.process = processVerdict;
722
+ if (!processVerdict.accepted) {
723
+ 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`)])] };
724
+ if (runtimeResult.compatibility.hubAcceptanceStatus !== "deliverable_failed") runtimeResult.compatibility = { hubAcceptanceStatus: "needs_verification", flowStatus: "rejected" };
725
+ }
726
+ s.persistProcessVerdict?.(processState, processVerdict);
727
+ if (s.processBlock?.()) {
728
+ runtimeResult.acceptance = { status: "not_accepted", accepted: false, reasons: [...new Set([...runtimeResult.acceptance.reasons, s.processBlock()!.reason])] };
729
+ runtimeResult.compatibility = { hubAcceptanceStatus: "needs_verification", flowStatus: "rejected" };
730
+ }
731
+ }
732
+ if (sameTask && result.dispatchId && !disposition.pending) {
733
+ // T2/F3: use the canonical wrapper identity so production reconcile can match.
734
+ // Previously this wrote raw p.agent while the wrapper used canonical([cwd, actor]).
735
+ d.noProgress.recordDispatchEvidence({
736
+ dispatchId: result.dispatchId, taskId: p.taskId, executor: canonicalExecutor(cwd, p.agent), revision: afterRevision, revisionScopes: p.revisionScopes,
737
+ changedScope: changes.attribution === 'certain' ? changes.paths : [], readback,
738
+ concurrentWriters: observation?.concurrentWritableOverlap ?? true,
739
+ effectsRef: protocolEvidencePath ?? undefined,
740
+ completed: disposition.delivered && result.exitCode === 0,
741
+ // A nonblocking review (the reconcile contract) approves with zero blocking findings;
742
+ // whether it also lists suggestions is irrelevant.
743
+ blockingFindings: isReviewPersona(p.agent) && affirmativeReviewVerdict(result.output) ? countReviewFindings(result.output).blocking : -1,
744
+ coveredScope: isReviewPersona(p.agent) && result.exitCode === 0 ? d.noProgress.reviewCoverage(p.taskId).filter(path => checkScope([path], p.scopeGlobs).outOfScope.length === 0) : [],
745
+ edited: p.beforeRevision !== afterRevision || !!observation && (observation.skipped || observation.paths.length > 0),
746
+ evidenceRef: runPath ?? '', openRequirements: runtimeResult.verification.requirements.filter((r: any) => r.status !== 'passed').map((r: any) => r.id),
747
+ });
748
+ }
749
+ const accepted = !p.operatorCandidate && runtimeResult.acceptance.accepted;
750
+ const acceptanceStatus = runtimeResult.compatibility.hubAcceptanceStatus;
751
+ const questions = [...new Set([...d.extractAskUserQuestions(result.output), ...(submission?.requires_user_decision ?? []).filter(question => question.trim().toLowerCase() !== "none")])];
752
+ const contractGap = acceptanceStatus === "deliverable_failed" ? "missing_deliverable" : !parsedReturn && questions.length ? "missing_structured_return" : null;
753
+ const blockedOnUser = questions.length > 0 && !protocolDiagnostic && executionStatus === "completed";
754
+ 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;
755
+ const assessment = { ...runtimeResult, verificationDiagnostics: checkDiagnostics,
756
+ executionStatus, acceptanceStatus, accepted, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots,
757
+ assertions: ids, structuredReturn: parsedReturn, contractNotices, compilerDiagnostics, compilerEvidencePath, protocolDiagnostic, protocolEvidencePath };
758
+ const assessmentPath = disposition.pending ? null : d.artifacts.writeRunArtifact(`${key}-acceptance`, state?.runCount ?? 0, JSON.stringify(assessment, null, 2), "evidence", assessmentId, p.sessionDir);
759
+ if (sameTask && [0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
760
+ 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; }
761
+ const unresolved = d.extractNeedsResearch(result.output); const answered = researchRounds.reduce((n, r) => n + r.questions.length, 0);
762
+ const notices: string[] = [];
763
+ const checkNotice = checkDiagnostics && verificationDiagnosticNotice(checkDiagnostics);
764
+ if (checkNotice) notices.push(checkNotice);
765
+ if (operatorStateVerification && operatorStateVerification.status !== "accepted" && operatorStateVerification.reason) notices.push(`Current-state review did not register the candidate: ${operatorStateVerification.reason}${operatorStateVerification.failedQualifiers?.length > 1 ? ` (also: ${operatorStateVerification.failedQualifiers.slice(1).join(", ")})` : ""}. ${operatorStateVerification.nextStep} Manual assertions stay open; nothing was marked proven.`);
766
+ 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.");
767
+ if (disposition.delivered) notices.push(accepted
768
+ ? `Execution and current-state verification accepted by the runtime contract. Acceptance check: ${assessmentPath}`
769
+ : protocolDiagnostic
770
+ ? `Tool protocol error: ${protocolDiagnostic.message} Evidence: ${protocolEvidencePath}. No text was executed and no retry was started.`
771
+ : `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}`);
772
+ if (readback.some(file => file.changed === false)) notices.push("Some deliverables already existed unchanged. Do not attribute their creation to this execution.");
773
+ 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.`); }
774
+ if (questions.length) notices.push(`⚠ ${questions.length} ASK_USER question(s) raised by ${p.agent}. Orchestrator triage required. ${ORCHESTRATOR_CLARIFICATION} Dispatch ID: ${result.dispatchId ?? "<dispatchId>"}. Human escalation language: ${s.getUserLanguage()}. Questions:\n${questions.map((q, i) => ` ${i + 1}. ${q}`).join("\n")}`);
775
+ 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.");
776
+ 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.`);
777
+ 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.`);
778
+ if (returnPath) notices.push(`Full specialist output: ${returnPath}`);
779
+ if (isReviewPersona(p.agent) && !p.privateConfig) {
780
+ const writing = otherActiveWriters(d, p, tracking);
781
+ if (writing.length) notices.push(`Area review: ${writing.map(writer => writer.agent).join(", ")} was still writing, so this review is evidence for its own scope only and does not close the task's review. Run one final review of the whole change once no writer is active.`);
782
+ }
783
+ if (tracking.isolatedScope) notices.push(`Parallel writer: OS-sandboxed to ${tracking.isolatedScope.join(", ") || "no repository paths"}; only changes inside that scope are attributed to ${p.agent}.${observation?.foreignPaths?.length ? ` Changes outside it during the run (not attributed): ${observation.foreignPaths.slice(0, 12).join(", ")}${observation.foreignPaths.length > 12 ? " …" : ""}.` : ""} Run the full checks once no writer is active.`);
784
+ 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.");
785
+ 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.`);
786
+ if (compilerDiagnostics && compilerDiagnostics.status !== "skipped") {
787
+ const advisory = formatAdvisory(compilerDiagnostics);
788
+ const evidence = compilerEvidencePath ? `Full compiler evidence: ${compilerEvidencePath}` : `Compiler evidence artifact unavailable: ${compilerEvidenceError ?? "unknown error"}`;
789
+ if (advisory) notices.push(`${advisory}\n${evidence}`);
790
+ else if (compilerDiagnostics.projects.length) notices.push(`Compiler diagnostics completed with no errors. ${evidence}`);
791
+ }
792
+ 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.`);
793
+ 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).`);
794
+ const scopeViolations = scopeResult(p, observation); const scopeNotice = scopeNoticeText(scopeViolations); if (scopeNotice) notices.push(scopeNotice.trim());
795
+ const finding = isReviewPersona(p.agent) ? findingBudgetNotice(p.agent, blockingFindingCap(s.getTaskTier()), countReviewFindings(result.output)) || "" : ""; if (finding) notices.push(finding.trim());
796
+ const docs = docsLaneNotice(p.agent, p.scopeGlobs, processVerdict?.obligations?.review?.status === "open"); if (docs) notices.push(docs);
797
+ 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." : "";
798
+ 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);
799
+ return { content: [{ type: "text", text: `[${p.agent}] Specialist: ${submission?.status ?? executionStatus}; task accepted: ${accepted ? "yes" : "no"}. ${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, specialistCompletion: submission?.status ?? (executionStatus === "completed" ? "reported_unstructured" : executionStatus), resultProtocol: submission ? "submit_result" : result.specialistResultTool ? "submission_missing" : "legacy", taskAccepted: accepted, ...(protocolDiagnostic ? { recoveryCategory: "tool_protocol_error", reason: protocolDiagnostic.message, protocolDiagnostic, protocolEvidencePath, protocolEffectsEvidenceRef: protocolEvidencePath } : blockedOnUser ? { recoveryCategory: "blocked_on_user", reason: "waiting for a sourced clarification answer", protocolDiagnostic: null, protocolEvidencePath: null } : { protocolDiagnostic: null, protocolEvidencePath: null }), contractGap, executionStatus, acceptanceStatus, accepted, runtimeResult, processVerdict, ...(operatorStateVerification?{operatorStateVerification}:{}), ...(privateConfigVerification?{privateConfigVerification}:{}), taskIdentity: runtimeResult.task, changeResult: runtimeResult.changes, verificationResult: runtimeResult.verification, verificationDiagnostics: checkDiagnostics, 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 })) } };
800
+ }
801
+
802
+ function dispatchExecutionConditions(d: DispatchExecutorDeps, params: DispatchAgentParams, ctx: ExtensionContext): Record<string, unknown> {
803
+ const state = d.state.getAgentStates().get(normalizeAgentInput(params.agent));
804
+ return {
805
+ model: (state ? d.resolvedAgentModel?.(state.def, ctx) : undefined) ?? state?.def.model ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : null),
806
+ backend: params.backend ?? "auto",
807
+ externalBlockerAcknowledged: d.state.getExternalBlockerAcknowledged(),
808
+ };
809
+ }
810
+
811
+ function researchExecutionConditions(d: DispatchExecutorDeps, params: SpawnResearchParams, ctx: ExtensionContext): Record<string, unknown> {
812
+ const persona = params.persona ? d.state.getResearchPersonas().find(item => item.name.toLowerCase() === params.persona!.toLowerCase()) : undefined;
813
+ try {
814
+ const def = persona ?? d.research.anonymousDef();
815
+ return { model: d.research.resolveModel(def, persona ? undefined : params.model, ctx), tools: "read,grep,find,ls", externalBlockerAcknowledged: d.state.getExternalBlockerAcknowledged() };
816
+ } catch {
817
+ return { model: params.model ?? null, tools: "read,grep,find,ls", externalBlockerAcknowledged: d.state.getExternalBlockerAcknowledged() };
818
+ }
819
+ }
820
+
821
+ export function structuredResearchPrompt(params: SpawnResearchParams): string {
822
+ const contract = normalizeResearchContract(params);
823
+ if (!contract.readScope.length && !contract.goal && !contract.expectedResult) return params.task;
824
+ return [params.task, "", "## Structured research contract",
825
+ contract.readScope.length ? `Read scope:\n${contract.readScope.map(path => `- ${path}`).join("\n")}` : "Read scope: not declared",
826
+ contract.goal ? `Goal: ${contract.goal}` : "Goal: not declared",
827
+ contract.expectedResult ? `Expected result: ${contract.expectedResult}` : "Expected result: not declared",
828
+ ].join("\n");
829
+ }
830
+
831
+ /**
832
+ * A persona runs one dispatch at a time (one session, one executor). A second
833
+ * `parallel: true` dispatch to a persona that is already writing gets its own
834
+ * instance (builder--p2, builder--p3, ...) with a separate session and executor.
835
+ * Claims are counted synchronously, so concurrent tool calls cannot pick the same
836
+ * instance and a refused duplicate cannot free another call's claim. Nothing else
837
+ * changes: the parallel writer gate still decides whether each one may run.
838
+ */
839
+ export function routeParallelInstance(d: DispatchExecutorDeps, params: DispatchAgentParams, reserved: Map<string, number>): { params: DispatchAgentParams; release: () => void } {
840
+ const base = normalizeAgentInput(params.agent);
841
+ const busy = (name: string) => (reserved.get(name) ?? 0) > 0 || d.state.getAgentStates().get(name)?.status === "running"
842
+ || (d.state.getActiveWriters?.() ?? []).some(writer => writer.agent.toLowerCase() === name);
843
+ let agent = base;
844
+ if (params.parallel === true && busy(base) && d.state.addAgentInstance) {
845
+ for (let n = 2; n <= 16; n++) {
846
+ const candidate = parallelInstanceName(base, n);
847
+ if (busy(candidate)) continue;
848
+ try { if (d.state.addAgentInstance(base, candidate)) agent = candidate; } catch { /* stay on the base; the gate explains */ }
849
+ break;
850
+ }
851
+ }
852
+ reserved.set(agent, (reserved.get(agent) ?? 0) + 1);
853
+ let released = false;
854
+ return { params: agent === base ? params : { ...params, agent }, release: () => {
855
+ if (released) return;
856
+ released = true;
857
+ const left = (reserved.get(agent) ?? 1) - 1;
858
+ if (left > 0) reserved.set(agent, left); else reserved.delete(agent);
859
+ } };
860
+ }
861
+
862
+ export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
863
+ const reserved = new Map<string, number>();
864
+ const guarded = createGuardedDispatchExecutor(d);
865
+ return async (id, params, signal, onUpdate, ctx) => {
866
+ const routed = routeParallelInstance(d, params, reserved);
867
+ try { return await guarded(id, routed.params, signal, onUpdate, ctx); }
868
+ finally { routed.release(); }
869
+ };
870
+ }
871
+
872
+ function createGuardedDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
873
+ return withNoProgress(d, "dispatch", async (_id, params, signal, onUpdate, ctx) => {
874
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability;
875
+ const agent = normalizeAgentInput(params.agent);
876
+ const invalid = validateDispatchAgent(d, agent, params.task, ctx); if (invalid) return invalid;
877
+ 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 } };
878
+ d.budget.ensureTaskTier();
879
+ 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." });
880
+ const preflight = preflightGate(d, agent) ?? processGate ?? (d.state.getProcessState && processAllowsPersona(d.state.getProcessState(), agent) ? null : checkDocsLane(agent, params.scope || [], params.review_reason));
881
+ if (preflight) return refusal(d, agent, params.task, preflight.reason, `${preflight.message}\n\n${refusalSnapshot(d, ctx)}`);
882
+ try { preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: d.state.getSessionDir() }); }
883
+ catch (error) { return refusal(d, agent, params.task, "scope_preflight_failed", String(error)); }
884
+ if (signal?.aborted) return refusal(d, agent, params.task, "cancelled", "Operation cancelled before dispatch.");
885
+ if (isReviewPersona(agent) && params.review_mode !== 'operator-current-state' && params.review_mode !== 'private-config-current-state' && !params.review_reason && !params.deliverables?.length && !/(?:USER|ORCHESTRATOR)_ANSWER:/.test(params.task) && !d.state.getActiveWritableDispatches() && d.state.getProcessState) {
886
+ const state=d.state.getProcessState();
887
+ let cached=null;
888
+ try { cached=reusableReview(state,reviewInput(ctx.cwd,d.noProgress.taskId(),agent,params.scope??[],state,d.state.getAssertions(),d.artifacts.loadInputArtifacts(params.artifacts,ctx),d.state.getAcceptedUserInput?.()),ctx.cwd); } catch { /* incomplete evidence must run the normal path */ }
889
+ if(cached){
890
+ const basis=revisionScopes(ctx.cwd,[...(params.scope??[]),...state.changedFiles]);
891
+ const revision=basis.length?revisionOf(ctx.cwd,basis):worktreeRevision(ctx.cwd,[],params.scope??[]);
892
+ const next=noteProcessStage(state,"review",{evidenceRef:cached.evidenceRef,revision,revisionScopes:basis});
893
+ const verdict=evaluateProcessObligations(next,{writable:true,budgetTier:d.state.getTaskTier()??"small",currentRevision:(scopes:readonly string[])=>scopes.join("\n")===basis.join("\n")?revision:revisionOf(ctx.cwd,[...scopes])});
894
+ d.state.setProcessState?.(next);d.state.persistProcessVerdict?.(next,verdict);
895
+ if(d.state.processBlock?.())return refusal(d,agent,params.task,"process_state_corrupt","Review reuse could not persist current evidence.");
896
+ return {content:[{type:"text",text:`Independent ${agent} review already covers this unchanged scope and requirements. Reused evidence: ${cached.evidenceRef}. No child launched. New review focus requires review_reason.`}],details:{status:"review_reused",reused:true,started:false,notStarted:true,exitCode:0,elapsed:0,returnPath:cached.evidenceRef,processVerdict:verdict,accepted:verdict.accepted}};
897
+ }
898
+ }
899
+ if(params.review_mode !== 'private-config-current-state' && isReviewPersona(agent) && d.state.getProcessState){
900
+ const state=d.state.getProcessState();
901
+ if(state.review.evidenceRef){
902
+ const next={...state,review:{...state.review,evidenceRef:null,revision:null},reviews:(state.reviews??[]).filter(r=>r.agent!==agent)};
903
+ d.state.setProcessState?.(next);d.state.persistProcessVerdict?.(next,evaluateProcessObligations(next,{writable:true,budgetTier:d.state.getTaskTier()??"small"}));
904
+ if(d.state.processBlock?.())return refusal(d,agent,params.task,"process_state_corrupt","Fresh review invalidation could not be persisted.");
905
+ }
906
+ }
907
+ const prepared = prepareDispatch(d, params, ctx); if (!("agent" in prepared)) return prepared;
908
+ if (!prepared.privateConfig && isReviewPersona(agent) && d.state.getProcessState) {
909
+ const state=d.state.getProcessState();
910
+ prepared.reviewBaseline=captureReviewBaseline(ctx.cwd,prepared.reviewInput??null,state);
911
+ const continuation=reviewContinuation(state,prepared.reviewInput??null,prepared.reviewBaseline,ctx.cwd,!!params.review_reason);
912
+ prepared.task+=continuation;
913
+ if(continuation)prepared.task+="\nRecorded verification evidence (check its revision and applicability; not automatic proof of a fix): "+JSON.stringify(state.acceptance);
914
+ prepared.resumeContract.instructions=prepared.task;
915
+ }
916
+ let tracking: Tracking;
917
+ try { tracking = startTracking(d, prepared, ctx); }
918
+ catch { d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); return refusal(d, agent, params.task, "receipt_capture_failed", "Runtime receipt capture could not be durably anchored; no child launched."); }
919
+ 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); }
920
+ 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: "" } }; }
921
+ finally { tracking.release?.(); if (tracking.writable) d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); }
922
+ }, (params, ctx) => dispatchExecutionConditions(d, params, ctx));
923
+ }
924
+
925
+ export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
926
+ return withNoProgress(d, "research", researchExecution(d), (params, ctx) => researchExecutionConditions(d, params, ctx));
927
+ }
928
+
929
+ /** Recovery analysis is read-only and each run is an explicit operator request bounded by the
930
+ * coordinator. It must not inherit the research no-progress fence: a crashed analysis would
931
+ * otherwise permanently refuse every later re-analysis of the same interrupted task. */
932
+ export function createRecoveryResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
933
+ const execute = researchExecution(d);
934
+ return async (id, params, signal, onUpdate, ctx) => {
935
+ try { normalizeResearchContract(params); }
936
+ catch (error) { return { content: [{ type: "text", text: String(error) }], details: { status: "invalid_input", reason: "invalid_read_scope", recoveryCategory: "invalid_input", started: false, exitCode: 1 } }; }
937
+ return execute(id, params, signal, onUpdate, ctx);
938
+ };
939
+ }
940
+
941
+ function researchExecution(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
942
+ return async (_id, params, signal, onUpdate, ctx) => {
943
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability; const s = d.state; d.budget.ensureTaskTier();
944
+ const preflight = preflightGate(d, params.persona || ""); if (preflight) return refusal(d, "", params.task, preflight.reason, `${preflight.message}\n\n${refusalSnapshot(d, ctx)}`, preflight.reason);
945
+ if (signal?.aborted) return refusal(d, "", params.task, "cancelled", "Operation cancelled before research.");
946
+ let def: any; let persona = false;
947
+ 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. (Nothing started or counted.)` }], 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();
948
+ const model = d.research.resolveModel(def, persona ? undefined : params.model, ctx); let artifacts: InputArtifactPreview[];
949
+ try { artifacts = d.artifacts.loadInputArtifacts(params.artifacts, ctx); } catch (err: any) { return { content: [{ type: "text", text: `⚠ Research NOT spawned and NOT counted — 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 } }; }
950
+ s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; s.getSessionTotals().research++; d.budget.updateModeStatus();
951
+ const taskToken=d.noProgress.taskToken(),sessionDir=s.getSessionDir();
952
+ const admit=()=>taskToken===d.noProgress.taskToken()&&sessionDir===s.getSessionDir()&&!signal?.aborted&&!d.provisionalCapabilityRefusal('fleet')&&!preflightGate(d,params.persona||'');
953
+ const state = d.research.createState(def, persona, model);
954
+ try { s.recordDelegation?.({ agent: persona ? def.name : "research", kind: "research", task: params.task, scope: params.read_scope ?? [], researchId: state.id }); } catch { /* the brief is a record, never a gate */ }
955
+ onUpdate?.({ content: [{ type: "text", text: `Spawning research helper r${state.id}...` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, status: "spawning" } });
956
+ try { const result = await d.research.spawn(state, structuredResearchPrompt(params), ctx, artifacts, signal, {readScope:normalizeResearchContract(params).readScope,admit}); 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 })) } }; }
957
+ 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: "" } }; }
958
+ };
959
+ }
960
+
961
+ 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)); }
962
+ function scopeNoticeText(v: any): string {
963
+ if (!v) return "";
964
+ const gaps = v.gaps?.length ? `\n\n⚠ Git observation gaps: ${v.gaps.map((gap: { scope: string; reason: string }) => `${gap.scope}: ${gap.reason}`).join("; ")}. Other observed scopes remain available; coverage is incomplete.` : "";
965
+ if (v.skipped) return `\n\n⚠ Scope gate skipped: ${v.reason || "not a git worktree"}.${gaps}`;
966
+ if (!v.outOfScope?.length) return gaps;
967
+ const overlap = v.concurrentWritableOverlap ? " Concurrent writable dispatches overlapped this run, so attribution is approximate." : "";
968
+ return `${gaps}\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}`;
969
+ }
970
+ function structuredReturnDigest(parsed: any): string { if (!parsed) return ""; const lines = ["Structured return (parsed):"]; if(parsed.summary)lines.push(parsed.summary); if(parsed.evidence?.length)lines.push("Evidence references: "+parsed.evidence.map((ref:any)=>ref.path).join(", ")); 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"); }
971
+ 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"); }