@chankov/agent-fleet 2.0.5 → 2.0.6

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 (514) hide show
  1. package/.pi/harnesses/agent-hub/README.md +74 -10
  2. package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  3. package/.pi/harnesses/agent-hub/artifacts.js +1 -1
  4. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
  5. package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  6. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  7. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  8. package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  9. package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
  10. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
  11. package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
  12. package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
  13. package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
  14. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
  15. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
  16. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +22 -0
  17. package/.pi/harnesses/agent-hub/dispatch-native.ts +25 -11
  18. package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  19. package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
  20. package/.pi/harnesses/agent-hub/index.ts +79 -43
  21. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
  22. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
  23. package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
  24. package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  25. package/.pi/harnesses/agent-hub/package.json +1 -1
  26. package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
  27. package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
  28. package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
  29. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  30. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  31. package/.pi/harnesses/agent-hub/research/runtime.ts +17 -2
  32. package/.pi/harnesses/agent-hub/research/spawn-run.ts +14 -6
  33. package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
  34. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  35. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
  36. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +65 -24
  37. package/.pi/harnesses/agent-hub/types.ts +1 -0
  38. package/.pi/harnesses/agent-hub/ui/pool.ts +6 -1
  39. package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
  40. package/.pi/harnesses/ask-user-remote/README.md +8 -2
  41. package/.pi/harnesses/ask-user-remote/index.ts +40 -14
  42. package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  43. package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
  44. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  45. package/.pi/harnesses/coms/README.md +1 -1
  46. package/.pi/harnesses/coms/index.ts +7 -1
  47. package/.pi/harnesses/coms/package.json +1 -1
  48. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  49. package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
  50. package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
  51. package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  52. package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
  53. package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
  54. package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
  55. package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
  56. package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
  57. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  58. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  59. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  60. package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
  74. package/.versions/2.0.6/.pi/extensions/package.json +9 -0
  75. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
  83. package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  84. package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  85. package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
  86. package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  87. package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  88. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  89. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  90. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  91. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  92. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  93. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  94. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  95. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  96. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  97. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  98. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  99. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  100. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  101. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  102. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  103. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  104. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  105. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  106. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  107. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  108. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  109. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  110. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  111. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  112. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  113. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  114. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  115. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  116. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  117. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  118. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  119. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  120. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  121. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  122. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  123. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  124. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  125. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  126. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  127. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
  128. package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  129. package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
  130. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  131. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  132. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  133. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  134. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  135. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  136. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  137. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  138. package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  139. package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  140. package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  141. package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  142. package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  143. package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  144. package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
  145. package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
  146. package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  147. package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
  148. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  149. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  150. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  151. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  152. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  153. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  154. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  155. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  156. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  157. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  158. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  159. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  160. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  161. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  162. package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  163. package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  164. package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  165. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  166. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  167. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  168. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  169. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  170. package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  171. package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
  172. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  173. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  174. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  175. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  176. package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  177. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  178. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  179. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  180. package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  181. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
  182. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
  183. package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
  184. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
  185. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  186. package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  187. package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  188. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
  189. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
  190. package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
  191. package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
  192. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  193. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  194. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  195. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  196. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  197. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  198. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  199. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  200. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  201. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  202. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  203. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  204. package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
  205. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  206. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  207. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  208. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  209. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  210. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  211. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  212. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  213. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  214. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  215. package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
  216. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  217. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  218. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
  219. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
  220. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  221. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  222. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  223. package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
  224. package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
  225. package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
  226. package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
  227. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
  228. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  229. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  230. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
  231. package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
  232. package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
  233. package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  234. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  235. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  236. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
  237. package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
  238. package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  239. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  240. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  241. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  242. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  243. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  244. package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  245. package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  246. package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
  247. package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  248. package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
  249. package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  250. package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
  251. package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
  252. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  253. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  254. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  255. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  256. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  257. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  258. package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
  259. package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
  260. package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
  261. package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
  262. package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
  263. package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
  264. package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
  265. package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  266. package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  267. package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
  268. package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
  269. package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
  270. package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
  271. package/.versions/2.0.6/.version +1 -0
  272. package/.versions/2.0.6/agents/architect.md +25 -0
  273. package/.versions/2.0.6/agents/bowser.md +28 -0
  274. package/.versions/2.0.6/agents/builder.md +56 -0
  275. package/.versions/2.0.6/agents/code-reviewer.md +210 -0
  276. package/.versions/2.0.6/agents/deep-researcher.md +33 -0
  277. package/.versions/2.0.6/agents/documenter.md +23 -0
  278. package/.versions/2.0.6/agents/orchestrator.md +23 -0
  279. package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
  280. package/.versions/2.0.6/agents/planner.md +106 -0
  281. package/.versions/2.0.6/agents/releaser.md +25 -0
  282. package/.versions/2.0.6/agents/researcher.md +31 -0
  283. package/.versions/2.0.6/agents/security-auditor.md +168 -0
  284. package/.versions/2.0.6/agents/test-engineer.md +154 -0
  285. package/.versions/2.0.6/agents/web-debugger.md +44 -0
  286. package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
  287. package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
  288. package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
  289. package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
  290. package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
  291. package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
  292. package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
  293. package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
  294. package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
  295. package/.versions/2.0.6/docs/getting-started.md +126 -0
  296. package/.versions/2.0.6/docs/npm-install.md +301 -0
  297. package/.versions/2.0.6/docs/pi-extensions.md +446 -0
  298. package/.versions/2.0.6/docs/pi-setup.md +76 -0
  299. package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
  300. package/.versions/2.0.6/hermes/README.md +347 -0
  301. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  302. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  303. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  304. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  305. package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
  306. package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
  307. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  308. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  309. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  310. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  311. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  312. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  313. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  314. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  315. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  316. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  317. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  318. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  319. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  320. package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  321. package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  322. package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
  323. package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
  324. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  325. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  326. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  327. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  328. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  329. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  330. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  331. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  332. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  333. package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
  334. package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
  335. package/.versions/2.0.6/install-manifest.json +2924 -0
  336. package/.versions/2.0.6/justfile +247 -0
  337. package/.versions/2.0.6/manifest-meta.json +976 -0
  338. package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
  339. package/.versions/2.0.6/references/communication-contract.md +26 -0
  340. package/.versions/2.0.6/references/definition-of-done.md +67 -0
  341. package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
  342. package/.versions/2.0.6/references/observability-checklist.md +91 -0
  343. package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
  344. package/.versions/2.0.6/references/performance-checklist.md +153 -0
  345. package/.versions/2.0.6/references/prompting-patterns.md +380 -0
  346. package/.versions/2.0.6/references/security-checklist.md +179 -0
  347. package/.versions/2.0.6/references/testing-patterns.md +236 -0
  348. package/.versions/2.0.6/references/workflow-authoring.md +304 -0
  349. package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
  350. package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
  351. package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
  352. package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
  353. package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
  354. package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
  355. package/.versions/2.0.6/scripts/fleet.ts +216 -0
  356. package/.versions/2.0.6/scripts/flow.ts +137 -0
  357. package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  358. package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
  359. package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
  360. package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
  361. package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
  362. package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
  363. package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  364. package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
  365. package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
  366. package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
  367. package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
  368. package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
  369. package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
  370. package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
  371. package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
  372. package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  373. package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
  374. package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  375. package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  376. package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  377. package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  378. package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  379. package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
  380. package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
  381. package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
  382. package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
  383. package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
  384. package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
  385. package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
  386. package/.versions/2.0.6/scripts/package-lock.json +35 -0
  387. package/.versions/2.0.6/scripts/package.json +9 -0
  388. package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
  389. package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
  390. package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
  391. package/.versions/2.0.6/scripts/team-up.ts +378 -0
  392. package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
  393. package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
  394. package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
  395. package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
  396. package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
  397. package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
  398. package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
  399. package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
  400. package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
  401. package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
  402. package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
  403. package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
  404. package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
  405. package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
  406. package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
  407. package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
  408. package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
  409. package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
  410. package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
  411. package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
  412. package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
  413. package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
  414. package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
  415. package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
  416. package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
  417. package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
  418. package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
  419. package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  420. package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
  421. package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
  422. package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  423. package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
  424. package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  425. package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
  426. package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  427. package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  428. package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  429. package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
  430. package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
  431. package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
  432. package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  433. package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  434. package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
  435. package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
  436. package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
  437. package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
  438. package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
  439. package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
  440. package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
  441. package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
  442. package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
  443. package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  444. package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
  445. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  446. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  447. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  448. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  449. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  450. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  451. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  452. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  453. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  454. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  455. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  456. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  457. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  458. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  459. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  460. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  461. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  462. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  463. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  464. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  465. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  466. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  467. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  468. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  469. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  470. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  471. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  472. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  473. package/CHANGELOG.md +23 -0
  474. package/README.md +12 -14
  475. package/bin/catalog/harness-runtime-closure.json +1 -6
  476. package/bin/lib/desired.js +2 -2
  477. package/bin/lib/features.js +8 -1
  478. package/bin/snapshot-version.js +1 -2
  479. package/codex/fleet-session-client/SKILL.md +34 -0
  480. package/codex/fleet-session-client.zip +0 -0
  481. package/docs/ARCHITECTURE.md +4 -4
  482. package/docs/MIGRATION-agent-fleet.md +2 -2
  483. package/docs/assets/branding/README.md +33 -0
  484. package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
  485. package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
  486. package/docs/codex-session-bridge.md +219 -0
  487. package/docs/coms-hermes-bridge.md +4 -5
  488. package/docs/getting-started.md +2 -0
  489. package/docs/npm-install.md +3 -1
  490. package/docs/pi-setup.md +2 -0
  491. package/hermes/README.md +1 -1
  492. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
  493. package/install-manifest.json +54 -72
  494. package/justfile +0 -42
  495. package/manifest-meta.json +50 -43
  496. package/package.json +10 -7
  497. package/scripts/coms-cli.ts +2 -61
  498. package/scripts/fleet-codex-client.ts +69 -0
  499. package/scripts/fleet-codex-read.py +146 -0
  500. package/scripts/fleet.ts +0 -6
  501. package/scripts/lib/fleet-codex-catalog.ts +63 -0
  502. package/scripts/lib/fleet-codex-operations.ts +190 -0
  503. package/scripts/lib/fleet-codex-session.ts +166 -0
  504. package/scripts/lib/fleet-codex-transport.ts +124 -0
  505. package/scripts/lib/fleet-command.ts +5 -23
  506. package/scripts/lib/team-project.ts +15 -50
  507. package/scripts/team-up.ts +6 -34
  508. package/codex/CONDUCTOR.md +0 -148
  509. package/docs/codex-remote-conductor.md +0 -170
  510. package/scripts/codex-conductor.ts +0 -41
  511. package/scripts/codex-remote-control.ts +0 -167
  512. package/scripts/lib/codex-conductor.ts +0 -88
  513. package/scripts/lib/codex-remote-control.ts +0 -482
  514. package/systemd/user/agent-fleet-codex-remote-control.service.in +0 -23
@@ -1,3 +1,5 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { mkdirSync } from "node:fs";
1
3
  import type { ChildProcess } from "child_process";
2
4
  import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
5
  import type { Termination, spawnPiAgentWithModelFallback } from "../spawn.ts";
@@ -34,6 +36,9 @@ export interface ResearchAgentDef {
34
36
 
35
37
  export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef> {
36
38
  id: number;
39
+ dispatchId: string;
40
+ sessionPath: string;
41
+ evidenceDir: string;
37
42
  def: TDef;
38
43
  persona: boolean;
39
44
  model: string;
@@ -55,6 +60,9 @@ export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef>
55
60
  }
56
61
 
57
62
  export interface ResearchResult {
63
+ dispatchId?: string;
64
+ evidencePath?: string;
65
+ transcriptPath?: string;
58
66
  output: string;
59
67
  exitCode: number;
60
68
  elapsed: number;
@@ -120,7 +128,8 @@ export function parseResearchHandle(arg: string): number | null {
120
128
  }
121
129
 
122
130
  export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: ResearchRuntimeDeps<TDef>): ResearchRuntime<TDef> {
123
- const sessionPath = (id: number) => safePathWithin(deps.hubState.getSessionDir(), `research-${id}.json`);
131
+ const paths = new Map<number, string>();
132
+ const sessionPath = (id: number) => { const path = paths.get(id); if (!path) throw new Error(`Unknown research handle r${id}`); return path; };
124
133
  const finalized = new WeakSet<ResearchState<TDef>>();
125
134
  const finalize = (state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome) => {
126
135
  if (finalized.has(state)) return;
@@ -145,6 +154,7 @@ export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: Resea
145
154
  return {
146
155
  states: deps.getResearchStates,
147
156
  reset() {
157
+ paths.clear();
148
158
  deps.setResearchStates(new Map());
149
159
  deps.setNextResearchId(1);
150
160
  },
@@ -162,8 +172,13 @@ export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: Resea
162
172
  createState(def, persona, model) {
163
173
  const id = deps.getNextResearchId();
164
174
  deps.setNextResearchId(id + 1);
175
+ const dispatchId = randomUUID();
176
+ const evidenceDir = safePathWithin(deps.hubState.getSessionDir(), "dispatches", dispatchId);
177
+ mkdirSync(evidenceDir, { recursive: true, mode: 0o700 });
178
+ const rawSession = safePathWithin(evidenceDir, "session.json");
179
+ paths.set(id, rawSession);
165
180
  const state: ResearchState<TDef> = {
166
- id, def, persona, model, status: "running", task: "", toolCount: 0, messageCount: 0,
181
+ id, dispatchId, evidenceDir, sessionPath: rawSession, def, persona, model, status: "running", task: "", toolCount: 0, messageCount: 0,
167
182
  elapsed: 0, lastWork: "", contextPct: 0, contextTokens: 0, timeline: [],
168
183
  };
169
184
  deps.getResearchStates().set(id, state);
@@ -1,3 +1,5 @@
1
+ import { dirname } from "node:path";
2
+ import { beginExecutionEvidence, finishExecutionEvidence } from "../execution-evidence.ts";
1
3
  import { profileFallback } from '../policy/profile-runtime.ts';
2
4
  import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
5
  import { contextPct, resolveContextWindow } from "../context-window.js";
@@ -19,7 +21,7 @@ function completeOutput<TDef extends ResearchAgentDef>(state: ResearchState<TDef
19
21
  output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
20
22
  }
21
23
  if (res.exitCode !== 0) {
22
- const errText = String(res.stderr ?? "").trim();
24
+ const errText = [res.assistantError, res.stderr].filter(Boolean).join("\n\n").trim();
23
25
  const tail = errText.length > 1500 ? `...\n${errText.slice(-1500)}` : errText;
24
26
  const errBlock = tail ? `\n\n[stderr]\n${tail}` : "";
25
27
  output = output ? `${output}${errBlock}` : `Research helper r${state.id} exited with code ${res.exitCode} and produced no output.${errBlock}`;
@@ -33,14 +35,19 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
33
35
  ): Promise<ResearchResult> {
34
36
  const startTime = Date.now();
35
37
  let result: ResearchResult | undefined;
38
+ let diagnostics: object | null = null;
39
+ const transcriptPath = safePathWithin(state.evidenceDir, "transcript.jsonl");
40
+
36
41
  const settle = (status: ResearchFinalizeOutcome["status"], historyStatus: ResearchFinalizeOutcome["historyStatus"], lastWork: string, settled: ResearchResult): ResearchResult => {
37
42
  state.elapsed = settled.elapsed;
38
43
  deps.finalize(state, { status, historyStatus, lastWork });
39
- result = settled;
40
- return settled;
44
+ deps.flushTimelineStore(state);
45
+ result = finishExecutionEvidence(state.evidenceDir, { ...settled, dispatchId: state.dispatchId, transcriptPath, sessionPath: state.sessionPath, diagnostics });
46
+ return result;
41
47
  };
42
48
 
43
49
  try {
50
+ beginExecutionEvidence(dirname(dirname(state.evidenceDir)), state.dispatchId, { task: prompt, agent: state.def.name, modelRequested: state.model }, inputArtifacts);
44
51
  if (!state.histEntry) state.histEntry = deps.executionHistory.start("research", `Research r${state.id}`);
45
52
 
46
53
  const safety = deps.requireSafetyHarness(deps.getSafetyHarnessPath());
@@ -55,7 +62,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
55
62
  state.killedByOperator = false;
56
63
  deps.flushTimelineStore(state);
57
64
  state.timeline = [];
58
- state.transcriptStore = deps.createTranscriptStore(safePathWithin(deps.hubState.getSessionDir(), "transcripts", `research-r${state.id}.jsonl`));
65
+ state.transcriptStore = deps.createTranscriptStore(transcriptPath);
59
66
 
60
67
  state.timer = setInterval(() => {
61
68
  state.elapsed = Date.now() - startTime;
@@ -63,7 +70,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
63
70
  }, 1000);
64
71
  const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
65
72
  const wantThinking = thinkingLevel !== "off";
66
- const sessionPath = deps.sessionPath(state.id);
73
+ const sessionPath = state.sessionPath;
67
74
  const researchWindow = resolveContextWindow(state.model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
68
75
  const fallbackCandidate = profileFallback(deps.substitutedModel(deps.fallbackModelFor(state.def, state.model)));
69
76
  const fallback = fallbackCandidate === state.model ? undefined : fallbackCandidate;
@@ -116,6 +123,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
116
123
  },
117
124
  }, { midRun: isReadOnlyToolList(deps.researchTools) }));
118
125
 
126
+ diagnostics = { assistantError: res.assistantError ?? null, stderr: res.stderr, spawnError: res.spawnError ?? null, modelUsed: res.modelUsed ?? null, toolCallsStarted: res.toolCallsStarted ?? null, termination: res.termination ?? null, processExitCode: res.exitCode };
119
127
  state.elapsed = Date.now() - startTime;
120
128
  state.proc = undefined;
121
129
  if (res.spawnError) {
@@ -127,7 +135,7 @@ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
127
135
  }
128
136
  if (state.killedByOperator) {
129
137
  state.killedByOperator = false;
130
- return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode ?? 143, elapsed: state.elapsed });
138
+ return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode == null || res.exitCode === 0 ? 143 : res.exitCode, elapsed: state.elapsed });
131
139
  }
132
140
 
133
141
  const status = res.exitCode === 0 ? "done" : "error";
@@ -1,19 +1,47 @@
1
1
  import { execFileSync } from "node:child_process";
2
+ import { createHash } from "node:crypto";
3
+ import { lstatSync, readFileSync, readlinkSync } from "node:fs";
4
+ import { join } from "node:path";
2
5
 
3
6
  export function snapshotWorktree(cwd) {
4
- const status = gitStatus(cwd);
5
- if (status.skipped) return { skipped: true, reason: status.reason, paths: new Set() };
6
- return { skipped: false, paths: new Set(status.paths) };
7
+ const status = gitStatus(cwd);
8
+ if (status.skipped) return { skipped: true, reason: status.reason, paths: new Set() };
9
+ try {
10
+ const fingerprints = new Map(status.paths.map(path => [path, fileFingerprint(cwd, path)]));
11
+ let head = "";
12
+ try { head = execFileSync("git", ["-C", cwd, "rev-parse", "HEAD"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim(); } catch {}
13
+ return { skipped: false, paths: new Set(status.paths), fingerprints, head };
14
+ } catch (error) { return { skipped: true, reason: String(error), paths: new Set() }; }
15
+ }
16
+
17
+ function fileFingerprint(cwd, path) {
18
+ try {
19
+ const file = join(cwd, path), stat = lstatSync(file);
20
+ if (!stat.isFile() && !stat.isSymbolicLink()) throw new Error(`Cannot prove file-content delta for ${path}`);
21
+ return createHash("sha256").update(String(stat.mode)).update("\0").update(stat.isSymbolicLink() ? readlinkSync(file) : readFileSync(file)).digest("hex");
22
+ } catch (error) { if (error.code === "ENOENT") return "missing"; throw error; }
7
23
  }
8
24
 
9
25
  export function diffAgainst(snapshot, cwd) {
10
- const current = snapshotWorktree(cwd);
11
- if (snapshot?.skipped || current.skipped) {
12
- return { skipped: true, reason: snapshot?.reason || current.reason || "scope gate skipped", paths: [] };
13
- }
14
- const before = snapshot?.paths instanceof Set ? snapshot.paths : new Set(snapshot?.paths || []);
15
- const paths = [...current.paths].filter((p) => !before.has(p)).sort();
16
- return { skipped: false, paths };
26
+ const current = snapshotWorktree(cwd);
27
+ if (snapshot?.skipped || current.skipped || snapshot?.head !== current.head) {
28
+ return { skipped: true, reason: snapshot?.reason || current.reason || "HEAD changed during observation; content attribution is incomplete", paths: [] };
29
+ }
30
+ try {
31
+ const paths = [...new Set([...snapshot.paths, ...current.paths])].filter(path => {
32
+ const before = snapshot.fingerprints.get(path);
33
+ return before === undefined || before !== (current.fingerprints.get(path) ?? fileFingerprint(cwd, path));
34
+ }).sort();
35
+ return { skipped: false, paths };
36
+ } catch (error) { return { skipped: true, reason: String(error), paths: [] }; }
37
+ }
38
+
39
+ /** Runtime outputs are not input progress. Callers add explicitly supplied evidence separately. */
40
+ export function worktreeRevision(cwd, scopes = []) {
41
+ const snapshot = snapshotWorktree(cwd);
42
+ if (snapshot.skipped) return "unavailable";
43
+ const entries = [...snapshot.fingerprints].filter(([path]) => !path.startsWith(".pi/agent-sessions/") && (!scopes.length || checkScope([path], scopes).inScope.length)).sort(([a], [b]) => a.localeCompare(b));
44
+ return createHash("sha256").update(JSON.stringify([snapshot.head, entries])).digest("hex");
17
45
  }
18
46
 
19
47
  export function checkScope(changedPaths, scopeGlobs) {
@@ -31,7 +59,7 @@ export function checkScope(changedPaths, scopeGlobs) {
31
59
 
32
60
  function gitStatus(cwd) {
33
61
  try {
34
- const output = execFileSync("git", ["-C", cwd, "status", "--porcelain", "--untracked-files=all"], {
62
+ const output = execFileSync("git", ["-C", cwd, "status", "--porcelain", "-z", "--untracked-files=all"], {
35
63
  encoding: "utf-8",
36
64
  stdio: ["ignore", "pipe", "pipe"],
37
65
  });
@@ -42,15 +70,13 @@ function gitStatus(cwd) {
42
70
  }
43
71
 
44
72
  function parsePorcelain(output) {
45
- const paths = [];
46
- for (const line of String(output || "").split(/\r?\n/)) {
47
- if (!line.trim()) continue;
48
- let file = line.slice(3).trim();
49
- const rename = file.match(/ -> (.+)$/);
50
- if (rename) file = rename[1];
51
- paths.push(normalizePath(unquotePorcelainPath(file)));
52
- }
53
- return uniqueSorted(paths.filter(Boolean));
73
+ const entries = String(output || "").split("\0"), paths = [];
74
+ for (let i = 0; i < entries.length; i++) {
75
+ const entry = entries[i]; if (!entry) continue;
76
+ paths.push(entry.slice(3));
77
+ if (/[RC]/.test(entry.slice(0, 2)) && entries[i + 1]) paths.push(entries[++i]);
78
+ }
79
+ return uniqueSorted(paths);
54
80
  }
55
81
 
56
82
  function matchesScope(changedPath, scope) {
@@ -69,11 +95,13 @@ function globToRegExp(glob) {
69
95
  const c = glob[i];
70
96
  if (c === "*") {
71
97
  if (glob[i + 1] === "*") {
72
- out += ".*";
73
- i++;
98
+ if (glob[i + 2] === "/") { out += "(?:.*/)?"; i += 2; }
99
+ else { out += ".*"; i++; }
74
100
  } else {
75
101
  out += "[^/]*";
76
102
  }
103
+ } else if (c === "?") {
104
+ out += "[^/]";
77
105
  } else {
78
106
  out += escapeRegExp(c);
79
107
  }
@@ -90,14 +118,6 @@ function uniqueSorted(values) {
90
118
  return [...new Set(values)].sort();
91
119
  }
92
120
 
93
- function unquotePorcelainPath(value) {
94
- const trimmed = String(value || "").trim();
95
- if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
96
- try { return JSON.parse(trimmed); } catch { return trimmed.slice(1, -1); }
97
- }
98
- return trimmed;
99
- }
100
-
101
121
  function escapeRegExp(value) {
102
122
  return value.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
103
123
  }
@@ -9,6 +9,8 @@ export interface DispatchAgentParams {
9
9
  task: string;
10
10
  artifacts?: string[];
11
11
  scope?: string[];
12
+ scope_mode?: "existing" | "create";
13
+ deliverables?: string[];
12
14
  watchdog?: boolean;
13
15
  review_reason?: string;
14
16
  backend?: "auto" | "native" | "coms";
@@ -13,6 +13,8 @@ export function registerDispatchAgent(pi: ExtensionAPI, toolCtx: ToolContext): v
13
13
  task: Type.String({ description: "Task description for the agent to execute" }),
14
14
  artifacts: Type.Optional(Type.Array(Type.String({ description: "Input artifact path; the specialist reads it." }))),
15
15
  scope: Type.Optional(Type.Array(Type.String({ description: "Advisory writable-file globs; violations are reported, never reverted." }))),
16
+ deliverables: Type.Optional(Type.Array(Type.String({ description: "Expected output file path, read back after execution. Presence is not semantic acceptance." }))),
17
+ scope_mode: Type.Optional(Type.Union([Type.Literal("existing"), Type.Literal("create")], { description: "Default existing: refuse missing scope roots; create explicitly permits new roots." })),
16
18
  watchdog: Type.Optional(Type.Boolean({ description: "Override this dispatch's drift watchdog." })),
17
19
  review_reason: Type.Optional(Type.String({ description: "Why a docs-only review is needed." })),
18
20
  backend: Type.Optional(Type.Union([
@@ -55,10 +57,11 @@ export function registerDispatchAgent(pi: ExtensionAPI, toolCtx: ToolContext): v
55
57
  );
56
58
  }
57
59
 
58
- const icon = details.status === "done" ? "✓" : "✗";
59
- const color = details.status === "done" ? "success" : "error";
60
+ const completed = details.executionStatus === "completed";
61
+ const icon = details.accepted === true ? "✓" : completed || details.pending ? "○" : "✗";
62
+ const color = details.accepted === true ? "success" : completed || details.pending ? "warning" : "error";
60
63
  const elapsed = typeof details.elapsed === "number" ? Math.round(details.elapsed / 1000) : 0;
61
- const header = theme.fg(color, `${icon} ${details.agent}`) +
64
+ const header = theme.fg(color, `${icon} ${details.agent}${completed && !details.accepted ? " — completed; acceptance unproven" : ""}`) +
62
65
  theme.fg("dim", ` ${elapsed}s`);
63
66
 
64
67
  const questions: string[] = Array.isArray(details.questions) ? details.questions : [];
@@ -1,10 +1,14 @@
1
+ import { retainDeliverable } from "../execution-evidence.ts";
2
+ import { preflightDeliverables, readBackDeliverables, type DeliverableContract } from "../acceptance.ts";
3
+ import { withNoProgress, type NoProgressGuard } from "../no-progress.ts";
4
+ import { randomUUID } from "node:crypto";
1
5
  import { mkdirSync, writeFileSync } from "node:fs";
2
6
  import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
7
  import { blockingFindingCap, checkReviewRoundCap, checkTaskBudget, checkTierPersonaGate, checkTurnBudget, isReviewPersona, remainingTaskResearch, reviewBudgetClause, reviewRoundCap } from "../run-budget.js";
4
8
  import { countReviewFindings, findingBudgetNotice } from "../review-findings.js";
5
9
  import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
6
10
  import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
7
- import { budgetContinuationInstruction } from "../budget-continuation.ts";
11
+ import type { BudgetRecovery } from "../budget-recovery.ts";
8
12
  import { checkScope, diffAgainst, snapshotWorktree } from "../scope-gate.js";
9
13
  import { crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
10
14
  import { shouldExtractReturn } from "../return-extract.js";
@@ -15,7 +19,7 @@ import type { AssertionsArtifactsContext, InputArtifactPreview } from "../contex
15
19
  import type { DispatchAgentParams, SpawnResearchParams, ToolExecutionResult, ToolExecutor, ToolUpdate } from "./context.ts";
16
20
 
17
21
  type Gate = { reason: string; message: string } | null;
18
- type DispatchResult = { output: string; exitCode: number; elapsed: number; billed?: number; out?: number; pending?: boolean; sessionReset?: unknown };
22
+ type DispatchResult = import("../dispatch-native-types.ts").NativeDispatchResult;
19
23
  type AgentState = { def: { name: string; tools: string }; runCount: number; contextPct: number; lastBackend?: string | null };
20
24
 
21
25
  export interface DispatchExecutionState {
@@ -41,8 +45,10 @@ export interface DispatchExecutionState {
41
45
  }
42
46
 
43
47
  export interface DispatchExecutorDeps {
48
+ noProgress: NoProgressGuard;
44
49
  state: DispatchExecutionState;
45
50
  budget: BudgetContext;
51
+ budgetRecovery: BudgetRecovery;
46
52
  artifacts: AssertionsArtifactsContext;
47
53
  research: ResearchRuntime<any>;
48
54
  provisionalCapabilityRefusal(pack: "fleet"): ToolExecutionResult | null;
@@ -54,7 +60,7 @@ export interface DispatchExecutorDeps {
54
60
  displayName(name: string): string;
55
61
  }
56
62
 
57
- interface PreparedDispatch { agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
63
+ interface PreparedDispatch { taskToken: object; contract: DeliverableContract; sessionDir: string; agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
58
64
  interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; autoResearchTaskCapped: boolean; }
59
65
  interface Tracking { writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; }
60
66
 
@@ -109,9 +115,12 @@ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentPa
109
115
  const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(s.getTaskTier(), agent, s.getTaskReviewRounds()) ?? checkDocsLane(agent, scope || [], review_reason);
110
116
  if (preflight) return refusal(d, agent, task, preflight.reason, preflight.message, preflight.reason);
111
117
  const taskRefusal = checkTaskBudget("dispatch", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
112
- if (taskRefusal) { d.budget.armBudgetContinuation("task", taskRefusal.reason); return refusal(d, agent, task, "task_budget_refused", budgetContinuationInstruction(taskRefusal.message, "task", s.getUserLanguage()), taskRefusal.reason); }
118
+ if (taskRefusal) return refusal(d, agent, task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
113
119
  const turnRefusal = checkTurnBudget("dispatch", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
114
- if (turnRefusal) { d.budget.armBudgetContinuation("turn", turnRefusal.reason); return refusal(d, agent, task, "budget_refused", budgetContinuationInstruction(turnRefusal.message, "turn", s.getUserLanguage()), turnRefusal.reason); }
120
+ if (turnRefusal) return refusal(d, agent, task, "budget_refused", turnRefusal.message, turnRefusal.reason);
121
+ let contract: DeliverableContract;
122
+ try { contract = preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: s.getSessionDir() }); }
123
+ catch (error) { return refusal(d, agent, task, "scope_preflight_failed", String(error)); }
115
124
  const fingerprint = taskFingerprint(agent, task);
116
125
  if (s.getTurnDispatchFingerprints().has(fingerprint)) return refusal(d, agent, task, "duplicate_refused", `⚠ Duplicate dispatch refused: you already dispatched ${agent} with this task (or a trivial rewording of it) THIS turn. Use the earlier result — re-read its digest/returnPath — or change the task materially (new instructions, corrected inputs) before re-dispatching.`);
117
126
  let inputArtifacts: InputArtifactPreview[];
@@ -120,7 +129,8 @@ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentPa
120
129
  s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1);
121
130
  if (isReviewPersona(agent)) s.setTaskReviewRounds(s.getTaskReviewRounds() + 1);
122
131
  s.getSessionTotals().dispatches++; d.budget.updateModeStatus();
123
- return { agent, task, inputArtifacts, scopeGlobs: (scope || []).map(String).map(x => x.trim()).filter(Boolean), fingerprint };
132
+ const declaredTask = contract.files.length ? `${task}\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")}` : task;
133
+ return { taskToken: d.noProgress.taskToken(), contract, sessionDir: s.getSessionDir(), agent, task: declaredTask, inputArtifacts, scopeGlobs: (scope || []).map(String).map(x => x.trim()).filter(Boolean), fingerprint };
124
134
  }
125
135
 
126
136
  function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx: ExtensionContext): Tracking {
@@ -139,19 +149,20 @@ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch,
139
149
  const findingClause = reviewBudgetClause(d.state.getTaskTier(), p.agent); const dispatchedTask = findingClause ? `${p.task}\n\n${findingClause}` : p.task;
140
150
  let result = await d.dispatchAgent(p.agent, dispatchedTask, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto");
141
151
  let billed = result.billed ?? 0; let out = result.out ?? 0; const researchRounds: RunData["researchRounds"] = []; let autoResearchTaskCapped = false;
142
- while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS) {
152
+ while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS && p.taskToken === d.noProgress.taskToken() && p.sessionDir === d.state.getSessionDir()) {
143
153
  const left = remainingTaskResearch(d.budget.currentTaskBudget(), d.budget.taskCounters()); if (left === 0) { autoResearchTaskCapped = true; break; }
144
154
  const questions = d.extractNeedsResearch(result.output).slice(0, left == null ? MAX_AUTO_RESEARCH_QUESTIONS : Math.min(MAX_AUTO_RESEARCH_QUESTIONS, left)); if (!questions.length) break;
145
155
  d.state.setTaskResearchCount(d.state.getTaskResearchCount() + questions.length); d.budget.updateModeStatus();
146
156
  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" } });
147
- const findingsDir = safePathWithin(d.state.getSessionDir(), "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
157
+ const findingsDir = safePathWithin(p.sessionDir, "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
148
158
  const answered = await Promise.all(questions.map(async question => {
149
159
  const def = d.research.anonymousDef(); const state = d.research.createState(def, false, d.research.resolveModel(def, undefined, ctx));
150
- const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-r${state.id}.md`);
151
- 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`, "utf-8"); return { question, file };
160
+ const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-${response.dispatchId ?? randomUUID()}.md`);
161
+ 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 };
152
162
  }));
153
163
  researchRounds.push({ questions, files: answered.map(a => a.file) });
154
164
  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");
165
+ if (p.taskToken !== d.noProgress.taskToken() || p.sessionDir !== d.state.getSessionDir()) break;
155
166
  result = await d.dispatchAgent(p.agent, resume, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", true); billed += result.billed ?? 0; out += result.out ?? 0;
156
167
  }
157
168
  return { result, billed, out, researchRounds, autoResearchTaskCapped };
@@ -165,20 +176,37 @@ function scopeResult(d: DispatchExecutorDeps, p: PreparedDispatch, tracking: Tra
165
176
  }
166
177
 
167
178
  async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
168
- const s = d.state; const { result, researchRounds } = run; const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
179
+ const s = d.state; const { result, researchRounds } = run;
180
+ const sameTask = p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir(); const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
169
181
  let { parsed: parsedReturn, notices: contractNotices } = parseDeliveredReturn(result.output, ids, disposition.delivered); const shouldUseDigest = ids.length > 0 || !!parsedReturn;
170
- const state = s.getAgentStates().get(p.agent.toLowerCase()); const key = safeAgentKey(state?.def.name ?? p.agent);
171
- const runPath = disposition.artifactKind && (shouldUseDigest || !disposition.delivered) ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, result.output, disposition.artifactKind) : null;
182
+ const state = sameTask ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined; const key = safeAgentKey(state?.def.name ?? p.agent);
183
+ const failureMetadata = { dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null,
184
+ agent: p.agent, task: p.task, scope: p.scopeGlobs, exitCode: result.exitCode, diagnostics: result.diagnostics ?? null };
185
+ const artifactOutput = disposition.delivered ? result.output
186
+ : `# Dispatch failure\n\n\`\`\`json\n${JSON.stringify(failureMetadata, null, 2)}\n\`\`\`\n\n## Output\n\n${result.output}`;
187
+ const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind, result.dispatchId, p.sessionDir) : null;
172
188
  const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
173
189
  if (returnPath && shouldExtractReturn(parsedReturn, ids)) {
174
190
  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" } });
175
191
  const recovered = await d.runReturnExtraction(returnPath, ids, ctx); if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
176
192
  }
177
- if ([0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
178
- s.getTurnReport().dispatches.push({ agent: p.agent, status: disposition.status, elapsed: result.elapsed, billed: run.billed, out: run.out }); s.getSessionTotals().billed += run.billed; s.getSessionTotals().out += run.out;
193
+ const assessmentId = result.dispatchId ?? randomUUID();
194
+ const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd: ctx.cwd || process.cwd(), sessionDir: p.sessionDir },
195
+ (index, bytes) => retainDeliverable(p.sessionDir, assessmentId, index, bytes));
196
+ const deliverableFailed = readback.some(file => file.status !== "read");
197
+ const executionStatus = disposition.pending ? "pending" : disposition.delivered ? "completed" : "failed";
198
+ const status = disposition.delivered ? deliverableFailed ? "verification_failed" : "completed_unverified" : disposition.status;
199
+ const acceptanceStatus = disposition.pending || !disposition.delivered ? "not_available" : deliverableFailed ? "deliverable_failed" : "needs_verification";
200
+ const assessment = { executionStatus, acceptanceStatus, accepted: false, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots, assertions: ids };
201
+ const assessmentPath = disposition.pending ? null : d.artifacts.writeRunArtifact(`${key}-acceptance`, state?.runCount ?? 0, JSON.stringify(assessment, null, 2), "evidence", assessmentId, p.sessionDir);
202
+ if (sameTask && [0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
203
+ 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; }
179
204
  const questions = d.extractAskUserQuestions(result.output); const unresolved = d.extractNeedsResearch(result.output); const answered = researchRounds.reduce((n, r) => n + r.questions.length, 0);
180
205
  const notices: string[] = [];
181
- const blockers = extractExternalBlockers(result.output); if (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.`); }
206
+ 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.");
207
+ if (disposition.delivered) notices.push(`Execution completed, NOT accepted. ${deliverableFailed ? "Expected deliverable readback failed." : "Verify correctness against the assertion ledger; file presence and exit 0 are not proof."} Acceptance check: ${assessmentPath}`);
208
+ if (readback.some(file => file.changed === false)) notices.push("Some deliverables already existed unchanged. Do not attribute their creation to this execution.");
209
+ 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.`); }
182
210
  if (questions.length) notices.push(`⚠ ${questions.length} ASK_USER question(s) raised by ${p.agent}. You MUST call ask_user for each (in ${s.getUserLanguage()}) before re-dispatching:\n${questions.map((q, i) => ` ${i + 1}. ${q}`).join("\n")}`);
183
211
  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.`);
184
212
  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.`);
@@ -193,37 +221,50 @@ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, para
193
221
  const docs = docsLaneNotice(p.agent, p.scopeGlobs); if (docs) notices.push(docs);
194
222
  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." : "";
195
223
  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);
196
- return { content: [{ type: "text", text: `[${p.agent}] ${disposition.status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status: disposition.status, backendRequested: params.backend ?? "auto", backendUsed: state?.lastBackend ?? null, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
224
+ return { content: [{ type: "text", text: `[${p.agent}] ${status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status, executionStatus, acceptanceStatus, accepted: false, staleTask: !sameTask, deliverableReadback: readback, scopeRoots: p.contract.scopeRoots, assessmentPath, backendRequested: params.backend ?? "auto", backendUsed: state?.lastBackend ?? null, 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, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
197
225
  }
198
226
 
199
227
  export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
200
- return async (_id, params, _signal, onUpdate, ctx) => {
228
+ return withNoProgress(d, "dispatch", async (_id, params, signal, onUpdate, ctx) => {
201
229
  const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability;
230
+ d.budget.ensureTaskTier();
231
+ const agent = normalizeAgentInput(params.agent);
232
+ const invalid = validateDispatchAgent(d, agent, params.task); if (invalid) return invalid;
233
+ const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(d.state.getTaskTier(), agent, d.state.getTaskReviewRounds()) ?? checkDocsLane(agent, params.scope || [], params.review_reason);
234
+ if (preflight) return refusal(d, agent, params.task, preflight.reason, preflight.message);
235
+ try { preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: d.state.getSessionDir() }); }
236
+ catch (error) { return refusal(d, agent, params.task, "scope_preflight_failed", String(error)); }
237
+ const budgetBlock = await d.budgetRecovery.ensure("dispatch", `${agent}: ${params.task}`, ctx, signal);
238
+ if (budgetBlock) return refusal(d, agent, params.task, budgetBlock.reason, budgetBlock.message);
239
+ if (signal?.aborted) return refusal(d, agent, params.task, "cancelled", "Operation cancelled before dispatch.");
202
240
  const prepared = prepareDispatch(d, params, ctx); if (!("agent" in prepared)) return prepared;
203
241
  const tracking = startTracking(d, prepared, ctx);
204
242
  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); }
205
243
  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: "" } }; }
206
244
  finally { if (tracking.writable) d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); }
207
- };
245
+ });
208
246
  }
209
247
 
210
248
  export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
211
- return async (_id, params, signal, onUpdate, ctx) => {
249
+ return withNoProgress(d, "research", async (_id, params, signal, onUpdate, ctx) => {
212
250
  const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability; const s = d.state; d.budget.ensureTaskTier();
213
251
  const preflight = preflightGate(d, params.persona || ""); if (preflight) return refusal(d, "", params.task, preflight.reason, preflight.message, preflight.reason);
252
+ const budgetBlock = await d.budgetRecovery.ensure("research", params.task, ctx, signal);
253
+ if (budgetBlock) return refusal(d, "", params.task, budgetBlock.reason, budgetBlock.message);
254
+ if (signal?.aborted) return refusal(d, "", params.task, "cancelled", "Operation cancelled before research.");
214
255
  const taskRefusal = checkTaskBudget("research", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
215
- if (taskRefusal) { d.budget.armBudgetContinuation("task", taskRefusal.reason); return refusal(d, "", params.task, "task_budget_refused", budgetContinuationInstruction(taskRefusal.message, "task", s.getUserLanguage()), taskRefusal.reason); }
256
+ if (taskRefusal) return refusal(d, "", params.task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
216
257
  const turnRefusal = checkTurnBudget("research", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
217
- if (turnRefusal) { d.budget.armBudgetContinuation("turn", turnRefusal.reason); return refusal(d, "", params.task, "budget_refused", budgetContinuationInstruction(turnRefusal.message, "turn", s.getUserLanguage()), turnRefusal.reason); }
258
+ if (turnRefusal) return refusal(d, "", params.task, "budget_refused", turnRefusal.message, turnRefusal.reason);
218
259
  let def: any; let persona = false;
219
260
  if (params.persona) { def = s.getResearchPersonas().find(x => x.name.toLowerCase() === params.persona!.toLowerCase()); if (!def) return { content: [{ type: "text", text: `No research persona "${params.persona}". Available: ${s.getResearchPersonas().map(x => x.name).join(", ") || "(none defined)"}. Omit \`persona\` for an ad-hoc helper. (Not counted against the turn budget.)` }], details: { status: "error" } }; persona = true; } else def = d.research.anonymousDef();
220
261
  const model = d.research.resolveModel(def, persona ? undefined : params.model, ctx); let artifacts: InputArtifactPreview[];
221
262
  try { artifacts = d.artifacts.loadInputArtifacts(params.artifacts, ctx); } catch (err: any) { return { content: [{ type: "text", text: `⚠ Research NOT spawned and NOT counted against the turn budget — input artifact could not be resolved:\n${err?.message || err}\n\nFix the path and try again.` }], details: { status: "artifact_preflight_failed" } }; }
222
263
  s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; s.getSessionTotals().research++; d.budget.updateModeStatus();
223
264
  const state = d.research.createState(def, persona, model); onUpdate?.({ content: [{ type: "text", text: `Spawning research helper r${state.id}...` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, status: "spawning" } });
224
- try { const result = await d.research.spawn(state, params.task, ctx, artifacts, signal); const status = result.termination ? result.termination.reason : result.exitCode === 0 ? "done" : "error"; const output = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output; return { content: [{ type: "text", text: `[research r${state.id} · ${persona ? d.displayName(def.name) : "ad-hoc"} · read-only] ${status} in ${Math.round(result.elapsed / 1000)}s\n\n${output}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, termination: result.termination, artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
265
+ try { const result = await d.research.spawn(state, params.task, ctx, artifacts, signal); const status = result.termination ? result.termination.reason : result.exitCode === 0 ? "done" : "error"; const output = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output; return { content: [{ type: "text", text: `[research r${state.id} · ${persona ? d.displayName(def.name) : "ad-hoc"} · read-only] ${status} in ${Math.round(result.elapsed / 1000)}s\n\n${output}${result.evidencePath ? `\n\nFull execution evidence: ${result.evidencePath}` : ""}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId, evidencePath: result.evidencePath, transcriptPath: result.transcriptPath, termination: result.termination, artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
225
266
  catch (err: any) { return { content: [{ type: "text", text: `Error spawning research helper: ${err?.message || err}` }], details: { handle: `r${state.id}`, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
226
- };
267
+ });
227
268
  }
228
269
 
229
270
  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)); }
@@ -30,6 +30,7 @@ export interface AgentDef extends ResearchAgentDef {
30
30
  }
31
31
 
32
32
  export interface AgentState {
33
+ dispatchId?: string;
33
34
  def: AgentDef;
34
35
  status: "idle" | "running" | "done" | "error";
35
36
  task: string;
@@ -64,7 +64,12 @@ export function createPoolPresentation(deps: PoolPresentationDeps): PoolPresenta
64
64
  const left = theme.fg("dim", "┏━") + theme.fg("border", " coms ");
65
65
  const remaining = safeWidth - 9 - (identity ? identity.name.length + 4 : 0) - 1;
66
66
  if (identity && remaining >= 1) {
67
- topBorder = left + theme.fg("dim", "━") + theme.fg("dim", "━".repeat(remaining)) + theme.fg("dim", " ") + hexFg(identity.color, identity.name) + theme.fg("dim", " ━") + theme.fg("dim", "┓");
67
+ const projectTag = `project: ${identity.project}`;
68
+ const projectFill = remaining + 1 - projectTag.length - 3;
69
+ const middle = projectFill >= 1
70
+ ? theme.fg("dim", "━".repeat(projectFill)) + theme.fg("border", projectTag) + theme.fg("dim", "━━━")
71
+ : theme.fg("dim", "━".repeat(remaining + 1));
72
+ topBorder = left + middle + theme.fg("dim", " ") + hexFg(identity.color, identity.name) + theme.fg("dim", " ━┓");
68
73
  } else {
69
74
  topBorder = left + theme.fg("dim", "━".repeat(Math.max(0, safeWidth - 9)) + "┓");
70
75
  }
@@ -38,7 +38,7 @@ export function workModePickerOptions(current: WorkMode): { title: string; optio
38
38
  const options = workModes.map(workMode => formatPickerOption(
39
39
  workMode === current,
40
40
  workMode,
41
- workMode === "operator" ? "Direct tools enabled" : "Delegate-only; requires a native roster",
41
+ workMode === "operator" ? "Direct tools enabled" : "Delegate-only; auto-loads the first valid team if no agents are active",
42
42
  ));
43
43
  return { title: `Fleet Work Mode — Alt+M · current ${current}`, options, workModes };
44
44
  }
@@ -2,10 +2,10 @@
2
2
 
3
3
  Harness wrapper for `pi-ask-user` that preserves the stock `ask_user` UI and result shape while optionally racing it against the Hermes `user-remote` coms peer.
4
4
 
5
- The experimental Codex Remote-Control conductor is **not** an inbound `ask_user` route. It initiates approval-gated outbound delegation from Android; Hermes remains the only phone answer participant in this race. See the [Codex conductor runbook](https://github.com/chankov/agent-fleet/blob/main/docs/codex-remote-conductor.md).
5
+ The experimental ChatGPT Fleet session client can explicitly list and answer wrapper-owned questions through the existing coms socket. Local UI, Hermes and addressed client responses share the same first-valid-answer race. See the [session client runbook](https://github.com/chankov/agent-fleet/blob/main/docs/codex-session-bridge.md).
6
6
 
7
7
  - The stock `pi-ask-user` extension is loaded through a capture proxy; its `ask_user` tool is not registered directly.
8
- - If no live `user-remote` peer is present at call time, the wrapper calls stock `execute` with the original arguments and signal unchanged.
8
+ - If neither an addressed question channel nor a live `user-remote` peer is available, the wrapper calls stock `execute` with the original arguments and signal unchanged.
9
9
  - Remote lookup follows the explicit Pi `--project <name>` flag at tool-execution time (then `pi.getFlag`, `PI_COMS_PROJECT`, and finally `default`), so a hub and bridge in the same non-default pool can race correctly even though Pi finishes CLI parsing after extension factories load.
10
10
  - If `user-remote` is present, the wrapper races local stock UI against the remote coms request using `race-core.js`; first answer wins and local-first emits one best-effort cancel.
11
11
  - If another extension already registered `ask_user`, registration failure is caught and logged as a warning instead of crashing the session.
@@ -51,3 +51,9 @@ Pick **one** path for Agent Fleet skills and lifecycle prompts:
51
51
  `agent-fleet verify` / `doctor` emit a read-only `pi-package-ownership` advisory when both paths overlap. See [docs/pi-setup.md](../../../docs/pi-setup.md).
52
52
 
53
53
  Tests use fakes for the stock TUI and coms peer. The abort test proves signal propagation and the stock-shaped `{cancelled:true}` result through a fake captured tool; it does not drive a live TUI overlay.
54
+
55
+ ## Addressed client questions
56
+
57
+ When co-loaded with an updated Hub or coms harness, the wrapper exposes its pending questions to `fleet-codex-client.ts questions`. The session-specific coms custom-envelope route checks owner identity and dispatches `list`, `answer` and `cancel` requests directly into the same local/remote race latch. No extra remote peer or service is needed.
58
+
59
+ Only valid responses allowed by the question flags can win. The accepted answer returns the stock tool result; local-first and remote-first races classify later submissions explicitly. Tool abort and session reset expire the address. The process keeps bounded pending/terminal records; a restart never makes old question IDs answerable. Unsupported/skipped wrappers are reported as such. See [client runbook](../../../docs/codex-session-bridge.md) for the CLI, limits and recovery semantics.