@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
@@ -11,6 +11,8 @@ import * as path from "node:path";
11
11
  import { fileURLToPath, pathToFileURL } from "node:url";
12
12
 
13
13
  import { raceAskUser } from "./race-core.js";
14
+ import { questionChannel, type QuestionChannel } from "./questions.ts";
15
+ import { registerRuntimeAsk } from "./runtime-ask.ts";
14
16
 
15
17
  interface ToolRegistration {
16
18
  name: string;
@@ -33,6 +35,7 @@ interface InstallOptions {
33
35
  /** When true, settings-listed packages are dormant (Pi `--no-extensions`/`-ne`). */
34
36
  extensionDiscoveryDisabled?: boolean;
35
37
  remoteProject?: string | (() => string);
38
+ questionChannel?: QuestionChannel;
36
39
  }
37
40
 
38
41
  export interface AskUserResultObservation {
@@ -394,25 +397,43 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
394
397
  remoteStart = null;
395
398
  }
396
399
 
397
- if (!remoteStart) {
400
+ const commentPreference = process.env.PI_ASK_USER_ALLOW_COMMENT?.trim().toLowerCase();
401
+ const addressed = (options.questionChannel ?? questionChannel).open(toolCallId, {
402
+ ...stockParams,
403
+ allowComment: stockParams.allowComment ?? ["1", "true", "yes", "on"].includes(commentPreference ?? ""),
404
+ });
405
+ if (remoteStart && addressed) remoteStart = {
406
+ ...remoteStart, result: remoteStart.result.then(addressed.validateRemote),
407
+ };
408
+ if (!remoteStart && !addressed) {
398
409
  const result = await stockTool.execute?.(toolCallId, stockParams, signal, onUpdate, ctx);
399
410
  emitAskUserObservation({ params: stockParams, result, phase: "result" });
400
411
  return result;
401
412
  }
402
413
 
403
- const result = await raceAskUser({
404
- runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, stockParams, localSignal, onUpdate, ctx),
405
- startRemote: () => remoteStart,
406
- cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
407
- createAbortController: () => {
408
- const controller = options.createAbortController?.() ?? new AbortController();
409
- linkAbortSignal(signal, controller);
410
- return controller;
411
- },
412
- signal,
413
- });
414
- emitAskUserObservation({ params: stockParams, result, phase: "result" });
415
- return result;
414
+ const expire = () => addressed?.expire();
415
+ if (signal?.aborted) expire();
416
+ else signal?.addEventListener("abort", expire, { once: true });
417
+ try {
418
+ const result = await raceAskUser({
419
+ runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, stockParams, localSignal, onUpdate, ctx),
420
+ startRemote: () => remoteStart,
421
+ cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
422
+ createAbortController: () => {
423
+ const controller = options.createAbortController?.() ?? new AbortController();
424
+ linkAbortSignal(signal, controller);
425
+ return controller;
426
+ },
427
+ signal,
428
+ registerAnswer: addressed?.registerAnswer,
429
+ onSettled: addressed?.onSettled,
430
+ });
431
+ emitAskUserObservation({ params: stockParams, result, phase: "result" });
432
+ return result;
433
+ } finally {
434
+ signal?.removeEventListener("abort", expire);
435
+ expire();
436
+ }
416
437
  },
417
438
  };
418
439
  }
@@ -436,6 +457,11 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
436
457
  });
437
458
  try {
438
459
  pi.registerTool(wrapped);
460
+ if (pi.events?.on && wrapped.execute) registerRuntimeAsk(pi.events, (...args) => wrapped.execute!(...args));
461
+ const channel = options.questionChannel ?? questionChannel;
462
+ channel.enabled = true;
463
+ pi.on?.("session_start", () => { channel.reset(); channel.enabled = true; });
464
+ pi.on?.("session_shutdown", () => { channel.reset(); channel.enabled = false; });
439
465
  return { registered: true, tool: wrapped };
440
466
  } catch (error) {
441
467
  const message = error instanceof Error ? error.message : String(error);
@@ -0,0 +1,161 @@
1
+ import { createHash, randomUUID } from 'node:crypto';
2
+ import type { Socket } from 'node:net';
3
+
4
+ export interface QuestionOwner { project:string; peer:string; sessionId:string; startedAt:string; }
5
+ export interface QuestionParams {
6
+ question:string; context?:string; options?:Array<string | {title:string; description?:string}>;
7
+ allowMultiple?:boolean; allowFreeform?:boolean; allowComment?:boolean;
8
+ }
9
+ type Answer = {kind:'selection'; selections:string[]; comment?:string} | {kind:'freeform'; text:string} | null;
10
+ type Status = 'pending' | 'answered' | 'cancelled' | 'expired' | 'failed';
11
+ interface Question {
12
+ id:string; toolCallId:string; owner:QuestionOwner; question:string; context?:string;
13
+ options:Array<{title:string; description?:string}>;
14
+ allowMultiple:boolean; allowFreeform:boolean; allowComment:boolean;
15
+ createdAt:string; expiresAt:null; state:Status;
16
+ }
17
+ interface RecordEntry {
18
+ question:Question; offer?: (result:unknown) => boolean;
19
+ receipt?: {requestId:string; digest:string};
20
+ }
21
+ const sameOwner = (a:QuestionOwner|null|undefined,b:QuestionOwner|null|undefined) => !!a && !!b &&
22
+ ['project','peer','sessionId','startedAt'].every(k => typeof a[k as keyof QuestionOwner] === 'string' && a[k as keyof QuestionOwner] === b[k as keyof QuestionOwner]);
23
+ const validId = (value:unknown):value is string => typeof value === 'string' && /^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$/.test(value);
24
+
25
+ /** Owned by the Pi process. Only the shared race latch can accept an answer. */
26
+ export class QuestionChannel {
27
+ enabled = false;
28
+ private entries = new Map<string,RecordEntry>();
29
+ private omitted = false;
30
+ private owner:() => QuestionOwner|null;
31
+ constructor(owner:() => QuestionOwner|null) { this.owner = owner; }
32
+ reset() { for (const entry of this.entries.values()) this.close(entry,'expired'); this.omitted=false; }
33
+ private close(entry:RecordEntry, state:Status) {
34
+ if (entry.question.state !== 'pending') return;
35
+ entry.question.state = state; entry.offer = undefined;
36
+ }
37
+ private check(owner:QuestionOwner) {
38
+ if (!this.enabled) return 'unsupported';
39
+ const current=this.owner();
40
+ for (const entry of this.entries.values()) if (!sameOwner(entry.question.owner,current)) this.close(entry,'expired');
41
+ return sameOwner(current,owner) ? null : 'stale';
42
+ }
43
+ open(toolCallId:string, params:QuestionParams) {
44
+ const owner=this.owner();
45
+ if (!this.enabled || !owner || !toolCallId || typeof params.question !== 'string' || !params.question.trim()) return null;
46
+ this.check(owner);
47
+ if (Buffer.byteLength(JSON.stringify(params)) > 16000 || [...this.entries.values()].filter(e=>e.question.state==='pending').length >= 64) {
48
+ this.omitted=true; return null;
49
+ }
50
+ // Retain bounded terminal records for duplicate and late classification.
51
+ for (const [id,entry] of this.entries) {
52
+ if (this.entries.size < 256) break;
53
+ if (entry.question.state !== 'pending') this.entries.delete(id);
54
+ }
55
+ const question:Question = {
56
+ id:randomUUID(), toolCallId, owner:{...owner}, question:params.question,
57
+ context:params.context?.trim() || undefined,
58
+ options:(params.options??[]).map(v=>typeof v==='string'?{title:v}:v),
59
+ allowMultiple:params.allowMultiple??false, allowFreeform:params.allowFreeform??true,
60
+ allowComment:params.allowComment??false, createdAt:new Date().toISOString(), expiresAt:null, state:'pending',
61
+ };
62
+ const entry:RecordEntry={question}; this.entries.set(question.id,entry);
63
+ return {
64
+ id:question.id,
65
+ registerAnswer:(offer:(result:unknown)=>boolean) => { if (question.state==='pending') entry.offer=offer; },
66
+ onSettled:({result}:{result?:{isError?:boolean;details?:{cancelled?:boolean}}}) => this.close(entry,!result||result.isError?'failed':result.details?.cancelled?'cancelled':'answered'),
67
+ validateRemote:(result:{details?:{response?:unknown;cancelled?:boolean}}) => {
68
+ const response=result?.details?.response;
69
+ if (validateAnswer(question,response)===undefined || (response===null)!==(result?.details?.cancelled===true)) throw Error('invalid remote answer');
70
+ return result;
71
+ },
72
+ expire:() => this.close(entry,'expired'),
73
+ };
74
+ }
75
+ list(owner:QuestionOwner, after?:string) {
76
+ const status=this.check(owner);
77
+ const entries=status?[]:[...this.entries.values()].filter(e=>sameOwner(e.question.owner,owner));
78
+ const start=after?entries.findIndex(e=>e.question.id===after):-1;
79
+ const pending=entries.slice(start+1).filter(e=>e.question.state==='pending');
80
+ const questions:Question[]=[];let bytes=0;
81
+ for(const entry of pending) {
82
+ const size=Buffer.byteLength(JSON.stringify(entry.question));
83
+ if(bytes+size>32768)break;
84
+ questions.push(structuredClone(entry.question));bytes+=size;
85
+ }
86
+ const closed=entries.filter(e=>e.question.state!=='pending');
87
+ return {status:status??'available', questions,
88
+ resolved:closed.slice(-64).map(e=>({id:e.question.id,state:e.question.state,requestId:e.receipt?.requestId})),
89
+ nextCursor:questions.length<pending.length?questions.at(-1)?.id??null:null,
90
+ partial:this.omitted||questions.length<pending.length||closed.length>64||Boolean(after&&start===-1)};
91
+ }
92
+ submit(owner:QuestionOwner, id:string, requestId:string, input:unknown) {
93
+ const status=this.check(owner);
94
+ if (status) return {status};
95
+ if (!validId(id) || !validId(requestId)) return {status:'invalid'};
96
+ if ([...this.entries.values()].some(e=>e.question.id!==id&&e.receipt?.requestId===requestId)) return {status:'conflict'};
97
+ const entry=this.entries.get(id);
98
+ if (!entry) return {status:'unknown_question'};
99
+ if (!sameOwner(entry.question.owner,owner)) return {status:'stale'};
100
+ const serialized=JSON.stringify(input);
101
+ if (typeof serialized !== 'string' || Buffer.byteLength(serialized)>16000) return {status:'invalid'};
102
+ const digest=createHash('sha256').update(serialized).digest('hex');
103
+ if (entry.receipt?.requestId===requestId) return {status:entry.receipt.digest===digest?'accepted':'conflict', questionId:id};
104
+ if (entry.question.state !== 'pending') return {status:entry.question.state==='expired'?'expired':'late', questionId:id};
105
+ if (!entry.offer) return {status:'not_ready'};
106
+ const answer=validateAnswer(entry.question,input);
107
+ if (answer===undefined) return {status:'invalid'};
108
+ const text=answer===null?'User cancelled the question':answer.kind==='freeform'?`User answered: ${answer.text}`:
109
+ `User answered: ${answer.selections.join(', ')}${answer.comment?` — ${answer.comment}`:''}`;
110
+ const result={content:[{type:'text',text}],details:{question:entry.question.question,context:entry.question.context,
111
+ options:entry.question.options,response:answer,cancelled:answer===null}};
112
+ if (!entry.offer(result)) return {status:'late',questionId:id};
113
+ entry.receipt={requestId,digest};
114
+ return {status:'accepted',questionId:id};
115
+ }
116
+ }
117
+
118
+ function validateAnswer(q:Question,input:unknown):Answer|undefined {
119
+ if (input===null) return null;
120
+ if (!input || typeof input!=='object' || Array.isArray(input)) return undefined;
121
+ const a=input as Record<string,unknown>;
122
+ if (a.kind==='freeform' && q.allowFreeform && Object.keys(a).every(k=>['kind','text'].includes(k)) && typeof a.text==='string' && a.text.trim()) {
123
+ return {kind:'freeform',text:a.text.trim()};
124
+ }
125
+ if (a.kind!=='selection' || !Object.keys(a).every(k=>['kind','selections','comment'].includes(k)) || !Array.isArray(a.selections) ||
126
+ !a.selections.length || (!q.allowMultiple && a.selections.length!==1) || new Set(a.selections).size!==a.selections.length ||
127
+ a.selections.some(v=>typeof v!=='string'||!q.options.some(o=>o.title===v)) ||
128
+ (a.comment!==undefined && (!q.allowComment || typeof a.comment!=='string'))) return undefined;
129
+ return {kind:'selection',selections:a.selections as string[],...(typeof a.comment==='string'&&a.comment.trim()?{comment:a.comment.trim()}:{})};
130
+ }
131
+
132
+ // Pi loads each extension through an independent jiti instance with moduleCache:false.
133
+ // Module-local singletons split the wrapper from its coms owner. Share the versioned
134
+ // channel on the process realm; session_shutdown/reset still expires every address.
135
+ const channelKey=Symbol.for('agent-fleet.addressed-questions.v1');
136
+ interface SharedChannel {peers:Set<() => QuestionOwner|null>;channel:QuestionChannel;}
137
+ const processState=globalThis as typeof globalThis & {[channelKey]?:SharedChannel};
138
+ function createSharedChannel():SharedChannel {
139
+ const peers=new Set<() => QuestionOwner|null>();
140
+ return {peers,channel:new QuestionChannel(()=>{
141
+ const owners=[...peers].map(get=>get()).filter((o):o is QuestionOwner=>o!==null);
142
+ return owners.length===1?owners[0]:null;
143
+ })};
144
+ }
145
+ const shared=processState[channelKey]??=createSharedChannel();
146
+ export const questionChannel=shared.channel;
147
+ export function registerQuestionPeer(getOwner:() => QuestionOwner|null) { shared.peers.add(getOwner); return () => { shared.peers.delete(getOwner); }; }
148
+
149
+ /** Uses coms' existing custom-envelope hook; never enqueues an LLM instruction. */
150
+ export function handleQuestionEnvelope(socket:Pick<Socket,'end'>, envelope:Record<string,unknown>, channel=questionChannel):boolean {
151
+ if (envelope.type!=='question_request') return false;
152
+ const owner=envelope.owner as QuestionOwner;
153
+ let result:Record<string,unknown>;
154
+ if (envelope.version!==1 || !owner || !validId(envelope.msg_id)) result={status:'invalid'};
155
+ else if (envelope.operation==='list') result=envelope.after!==undefined&&!validId(envelope.after)?{status:'invalid'}:channel.list(owner,envelope.after as string|undefined);
156
+ else if (envelope.operation==='answer' || envelope.operation==='cancel') result=channel.submit(owner,
157
+ envelope.questionId as string,envelope.msg_id,envelope.operation==='cancel'?null:envelope.answer);
158
+ else result={status:'unsupported'};
159
+ socket.end(JSON.stringify({type:'question_response',version:1,msg_id:envelope.msg_id,owner,...result})+'\n');
160
+ return true;
161
+ }
@@ -15,6 +15,8 @@ export async function raceAskUser({
15
15
  cancelRemote,
16
16
  createAbortController = () => new AbortController(),
17
17
  signal,
18
+ registerAnswer,
19
+ onSettled,
18
20
  }) {
19
21
  if (typeof runLocal !== "function") throw new TypeError("runLocal is required");
20
22
 
@@ -48,11 +50,11 @@ export async function raceAskUser({
48
50
 
49
51
  // No live user-remote peer, or remote startup failed before a qid existed:
50
52
  // preserve stock pi-ask-user behavior exactly by returning the local result.
51
- if (!remoteStart) return await localPromise;
53
+ if (!remoteStart && !registerAnswer) return await localPromise;
52
54
 
53
- remoteQid = typeof remoteStart.qid === "string" ? remoteStart.qid : null;
55
+ remoteQid = typeof remoteStart?.qid === "string" ? remoteStart.qid : null;
54
56
  remotePending = !!remoteQid;
55
- const remotePromise = Promise.resolve(remoteStart.result);
57
+ const remotePromise = remoteStart ? Promise.resolve(remoteStart.result) : null;
56
58
 
57
59
  // If the whole tool call is aborted (turn cancelled), withdraw the remote
58
60
  // question instead of leaving it live on the phone until timeout.
@@ -62,14 +64,27 @@ export async function raceAskUser({
62
64
  }
63
65
 
64
66
  return await new Promise((resolve, reject) => {
67
+ const finish = (source, result) => { onSettled?.({ source, result }); };
68
+ // The addressed endpoint receives the result of this same synchronous latch.
69
+ // A successful submission cannot lose to a later local or legacy reply.
70
+ registerAnswer?.((result) => {
71
+ if (settled || signal?.aborted) return false;
72
+ settled = true;
73
+ finish("addressed", result);
74
+ controller.abort?.();
75
+ void emitCancel("addressed_answered");
76
+ resolve(result);
77
+ return true;
78
+ });
65
79
  let localRejected = false;
66
80
  let localError;
67
- let remoteRejected = false;
81
+ let remoteRejected = !remotePromise;
68
82
 
69
83
  localPromise.then(
70
84
  async (result) => {
71
85
  if (settled) return;
72
86
  settled = true;
87
+ finish("local", result);
73
88
  await emitCancel("local_answered");
74
89
  resolve(result);
75
90
  },
@@ -79,16 +94,18 @@ export async function raceAskUser({
79
94
  localError = error;
80
95
  if (remoteRejected) {
81
96
  settled = true;
97
+ finish("error", undefined);
82
98
  reject(localError);
83
99
  }
84
100
  },
85
101
  );
86
102
 
87
- remotePromise.then(
103
+ remotePromise?.then(
88
104
  (result) => {
89
105
  remotePending = false;
90
106
  if (settled) return;
91
107
  settled = true;
108
+ finish("remote", result);
92
109
  controller.abort?.();
93
110
  resolve(result);
94
111
  },
@@ -98,6 +115,7 @@ export async function raceAskUser({
98
115
  // Remote errors are non-fatal: keep waiting for stock local behavior.
99
116
  if (localRejected) {
100
117
  settled = true;
118
+ finish("error", undefined);
101
119
  reject(localError);
102
120
  }
103
121
  },
@@ -0,0 +1,43 @@
1
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+
3
+ export interface RuntimeQuestion {
4
+ question: string;
5
+ context: string;
6
+ options: string[];
7
+ allowMultiple: false;
8
+ allowFreeform: false;
9
+ allowComment: false;
10
+ }
11
+ export interface RuntimeAskBus {
12
+ emit(channel: string, data: unknown): void;
13
+ on(channel: string, handler: (data: unknown) => void): () => void;
14
+ }
15
+ type ExecuteAsk = (id: string, params: RuntimeQuestion, signal: AbortSignal | undefined, onUpdate: undefined, ctx: ExtensionContext) => unknown;
16
+ interface Request {
17
+ id: string; params: RuntimeQuestion; signal?: AbortSignal; ctx: ExtensionContext;
18
+ result?: Promise<unknown>;
19
+ }
20
+ const CHANNEL = "agent-fleet:runtime-ask";
21
+
22
+ /** The existing wrapper owns local/remote racing; no second transport or tool registration. */
23
+ export function registerRuntimeAsk(bus: RuntimeAskBus, execute: ExecuteAsk): () => void {
24
+ return bus.on(CHANNEL, value => {
25
+ const request = value as Request;
26
+ if (request.result) return; // one owner, even if a wrapper was loaded twice
27
+ request.result = Promise.resolve().then(() => request.signal?.aborted
28
+ ? { details: { cancelled: true } }
29
+ : execute(request.id, request.params, request.signal, undefined, request.ctx));
30
+ });
31
+ }
32
+
33
+ /** Missing wrapper falls back to an explicit local dialog, never to model prose. */
34
+ export async function requestRuntimeAsk(bus: RuntimeAskBus, id: string, params: RuntimeQuestion, ctx: ExtensionContext, signal?: AbortSignal): Promise<unknown> {
35
+ if (signal?.aborted) return { details: { cancelled: true } };
36
+ const request: Request = { id, params, ctx, signal };
37
+ bus.emit(CHANNEL, request);
38
+ if (request.result) return request.result;
39
+ if (!ctx.hasUI) throw new Error("Budget confirmation unavailable: no ask-user transport or local UI.");
40
+ const choice = await ctx.ui.select(params.question + "\n" + params.context, params.options, { signal });
41
+ return { details: { cancelled: choice === undefined || signal?.aborted === true,
42
+ response: { kind: "selection", selections: choice === undefined ? [] : [choice] } } };
43
+ }
@@ -64,7 +64,7 @@ when you are on the herdr backend.
64
64
  Two optional phone-facing conductors use this same pool without becoming pane owners:
65
65
 
66
66
  - **Hermes/Telegram** is the inbound `ask_user` route and can also perform bounded coms delegation.
67
- - **Codex Remote Control** is an experimental outbound-only Android route. Its user-systemd service loads a managed contract from an external user-state workspace, and `scripts/codex-conductor.ts` permits only scoped `list` plus one serialized `send --await`. See the [operator runbook](https://github.com/chankov/agent-fleet/blob/main/docs/codex-remote-conductor.md).
67
+ - **ChatGPT Fleet session client** is an experimental ChatGPT-initiated client for an existing Pi session. It reuses list/send/await semantics and does not own a systemd unit. See the [session client runbook](https://github.com/chankov/agent-fleet/blob/main/docs/codex-session-bridge.md).
68
68
 
69
69
  Both must use the same validated project as the peers they target. Neither conductor may drive Herdr lifecycle.
70
70
 
@@ -20,6 +20,7 @@ import {
20
20
  TIMEOUT_MS,
21
21
  } from "../lib/coms-core.ts";
22
22
  import { registerVersionStatus } from "./version.ts";
23
+ import { handleQuestionEnvelope, registerQuestionPeer } from "../ask-user-remote/questions.ts";
23
24
 
24
25
  export default function (pi: ExtensionAPI) {
25
26
  pi.registerFlag("name", { description: "Override agent name (otherwise from frontmatter or auto-generated)", type: "string", default: undefined });
@@ -33,7 +34,12 @@ export default function (pi: ExtensionAPI) {
33
34
  pi,
34
35
  getContext: () => currentCtx,
35
36
  onPeersChanged: () => { if (currentCtx?.hasUI) installPoolWidget(currentCtx); },
37
+ handleCustomEnvelope: handleQuestionEnvelope,
36
38
  });
39
+ const unregisterQuestions = registerQuestionPeer(() => peer.ready && peer.identity ? {
40
+ project: peer.identity.project, peer: peer.identity.name,
41
+ sessionId: peer.identity.session_id, startedAt: peer.identity.started_at,
42
+ } : null);
37
43
 
38
44
  function renderPool(width: number, theme: Theme): string[] {
39
45
  const identity = peer.identity;
@@ -270,7 +276,7 @@ export default function (pi: ExtensionAPI) {
270
276
  });
271
277
  pi.on("before_agent_start", async () => { await peer.setTurnState("working"); });
272
278
  pi.on("agent_end", async (_event, ctx) => { await peer.setTurnState("idle"); await peer.respond(ctx); });
273
- pi.on("session_shutdown", async () => { await peer.shutdown(); if (currentCtx?.hasUI) currentCtx.ui.setWidget("coms-pool", undefined); });
279
+ pi.on("session_shutdown", async () => { unregisterQuestions(); await peer.shutdown(); if (currentCtx?.hasUI) currentCtx.ui.setWidget("coms-pool", undefined); });
274
280
  process.on("SIGINT", () => { void peer.shutdown(); });
275
281
  process.on("SIGTERM", () => { void peer.shutdown(); });
276
282
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.5"
6
+ "version": "2.0.6"
7
7
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.5"
6
+ "version": "2.0.6"
7
7
  }
@@ -53,11 +53,12 @@ to ${spawnBudget} delegate calls for this dispatch; parallel children are forced
53
53
  Children are terminal workers: they do not receive delegate tooling at remaining depth 0.`;
54
54
  }
55
55
 
56
- export function buildDeliverableProtocol(agentKey: string, runNumber: number): string {
56
+ export function buildDeliverableProtocol(agentKey: string, runNumber: number, artifactRoot = ".pi/agent-sessions/artifacts", dispatchId?: string): string {
57
+ const filename = `${agentKey}-${dispatchId ?? `run${runNumber}`}.md`;
57
58
  return `
58
59
 
59
60
  ## Deliverable-to-file protocol
60
- When your deliverable is a document (plan, review, critique, inventory, report), write the full document to the real session artifact path when your tools allow it: .pi/agent-sessions/artifacts/<kind>/${agentKey}-run${runNumber}.md (kinds: plans, reviews, inventories, evidence). Do NOT write repo-root ./artifacts/... files. In your final response, report and pass the artifact-relative handoff path: artifacts/<kind>/${agentKey}-run${runNumber}.md. If your persona already has an explicit output path contract such as planner PLAN_FILE, keep that existing behavior and also summarize/return the session artifact path the hub gives you.
61
+ When your deliverable is a document (plan, review, critique, inventory, report), write the full document to the real session artifact path when your tools allow it: ${artifactRoot}/<kind>/${filename} (kinds: plans, reviews, inventories, evidence). Do NOT write repo-root ./artifacts/... files. In your final response, report and pass the artifact-relative handoff path: artifacts/<kind>/${filename}. If your persona already has an explicit output path contract such as planner PLAN_FILE, keep that existing behavior and also summarize/return the session artifact path the hub gives you.
61
62
  Finish with the artifact-relative path plus a digest of no more than 10 lines. If the dispatch includes acceptance assertions (A1, A2, ...), also include the structured return from skills/orchestration-verification/SKILL.md. If your tools are read-only and you cannot write a document artifact yourself, finish with the digest + structured return; the hub will still persist your full final return under artifacts/returns/ for dispatcher recovery.`;
62
63
  }
63
64
 
@@ -108,7 +109,7 @@ export function buildSpecialistContextManifest(input: {
108
109
  };
109
110
  }
110
111
 
111
- export function nativeSpecialistSystemPrompt(input: { manifest: SpecialistContextManifest; userLanguage: string; agentKey: string; runNumber: number }): string {
112
+ export function nativeSpecialistSystemPrompt(input: { manifest: SpecialistContextManifest; userLanguage: string; agentKey: string; runNumber: number; artifactRoot?: string; dispatchId?: string }): string {
112
113
  const { manifest } = input;
113
114
  const paths = (label: string, values: string[]) => values.length ? `\n${label}: ${values.join(", ")}` : "";
114
115
  const framing = [
@@ -120,7 +121,7 @@ export function nativeSpecialistSystemPrompt(input: { manifest: SpecialistContex
120
121
  let prompt = references + buildClarificationProtocol(input.userLanguage);
121
122
  if (manifest.flags.assertions) prompt += "\n\n## Verification\nRead skills/orchestration-verification/SKILL.md for the structured return contract; apply the assertions supplied in the task.";
122
123
  if (manifest.delegateRoles.length) prompt += buildDelegationProtocol(manifest.delegateRoles);
123
- prompt += buildDeliverableProtocol(input.agentKey, input.runNumber);
124
+ prompt += buildDeliverableProtocol(input.agentKey, input.runNumber, input.artifactRoot, input.dispatchId);
124
125
  return prompt;
125
126
  }
126
127
 
@@ -61,7 +61,7 @@ export function renderFleetDashboard(vm: FleetViewModel, width: number, bodyHeig
61
61
  }
62
62
  }
63
63
  lines.push(theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"));
64
- lines.push(ellipsis(theme.fg("dim", vm.confirmation ?? "↑↓ select · Enter open · h history · m substitute · x kill · r restart · c continue · f filter · a all · q close"), w));
64
+ lines.push(ellipsis(theme.fg("dim", vm.confirmation ?? "↑↓ select · Enter open · h history · m substitute · x kill · r restart · f filter · a all · q close"), w));
65
65
  const coms = vm.comsLines ?? [];
66
66
  lines.push(...coms);
67
67
  const total = body + FLEET_CHROME_ROWS + coms.length;
@@ -0,0 +1,32 @@
1
+ # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
+ # DISPATCH time, never at team activation — the hub and its peers boot in
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
+ # after the session starts.
5
+ #
6
+ # default: native | coms — coms substitutes ANY active-team member that has
7
+ # a live same-name peer in the coms pool
8
+ # grace_s: <seconds> — how long a `fallback: none` member polls the pool
9
+ # for its peer before the dispatch is refused
10
+ # substitutions:
11
+ # <member>: — team-member/persona name (case-insensitive)
12
+ # prefer: native|coms — bare member block defaults to coms
13
+ # fallback: native|none — none = coms-required (refuse when no live peer)
14
+ # timeout_s: <seconds> — per-member reply timeout (default PI_COMS_TIMEOUT_MS)
15
+ #
16
+ # Missing file = everything native (no behavior change). This file is an
17
+ # orchestration decision; HOW each peer runs (model, runner: claude-code, env)
18
+ # stays in peers.yaml.
19
+
20
+ default: native
21
+ grace_s: 30
22
+
23
+ substitutions:
24
+ plan-reviewer:
25
+ prefer: coms
26
+ fallback: native
27
+ code-reviewer:
28
+ prefer: coms
29
+ fallback: native
30
+ documenter:
31
+ prefer: coms
32
+ fallback: native
@@ -0,0 +1,83 @@
1
+ # Flat profiles switch named personas; version: 2 profiles switch the complete fleet.
2
+ # See docs/agent-fleet-setup.md for defaults, child roles, services and policies.
3
+ mix-max:
4
+ code-reviewer: github-copilot/claude-opus-5
5
+ builder: openai-codex/gpt-5.6-sol
6
+ planner: github-copilot/claude-fable-5
7
+ plan-reviewer: openai-codex/gpt-5.6-sol
8
+ security-auditor: xai/grok-4.6
9
+ test-engineer: xai/grok-4.6
10
+ sol:
11
+ code-reviewer: openai-codex/gpt-5.6-sol
12
+ builder: openai-codex/gpt-5.6-sol
13
+ planner: openai-codex/gpt-5.6-sol
14
+ plan-reviewer: openai-codex/gpt-5.6-sol
15
+ security-auditor: openai-codex/gpt-5.6-sol
16
+ test-engineer: openai-codex/gpt-5.6-sol
17
+
18
+ # Local oMLX pair. 35B (qwen36) is the default brain: dispatcher, specialists,
19
+ # recon/preflight/feasibility/scout/sweeps, watchdog. 9B (qwen) is only the
20
+ # cheap, narrow helpers: documenter, docs, deps, conventions, planner voice-2,
21
+ # return-extractor. thinking stays off. Laguna is retired — do not reintroduce it.
22
+ local-duo:
23
+ version: 2
24
+ defaults:
25
+ model: &qwen36 omlx/Qwen3.6-35B-A3B-4bit
26
+ thinking: off
27
+ allowed-models:
28
+ - *qwen36
29
+ - omlx/Qwen3.6-35B-A3B-UD-MLX-3bit
30
+ - &qwen omlx/Qwen3.8-9B-heretic-uncensored-5bit-MLX
31
+ fallback: none
32
+ routing: native
33
+ dispatcher: *qwen36
34
+ agents:
35
+ architect: *qwen36
36
+ bowser: *qwen36
37
+ builder: *qwen36
38
+ code-reviewer: *qwen36
39
+ deep-researcher: *qwen36
40
+ documenter: *qwen
41
+ orchestrator: *qwen36
42
+ plan-reviewer: *qwen36
43
+ planner: *qwen36
44
+ releaser: *qwen36
45
+ researcher: *qwen36
46
+ security-auditor: *qwen36
47
+ test-engineer: *qwen36
48
+ web-debugger: *qwen36
49
+ web-performance-auditor: *qwen36
50
+ subagents:
51
+ builder:
52
+ recon: *qwen36
53
+ verifier: *qwen36
54
+ code-reviewer:
55
+ preflight: *qwen36
56
+ quality: *qwen36
57
+ perf: *qwen36
58
+ docs: *qwen
59
+ plan-reviewer:
60
+ feasibility: *qwen36
61
+ deps: *qwen
62
+ planner:
63
+ scout: *qwen36
64
+ rules: *qwen36
65
+ voice-1: *qwen36
66
+ voice-2: *qwen
67
+ voice-3: *qwen36
68
+ security-auditor:
69
+ recon: *qwen36
70
+ input-sweep: *qwen36
71
+ secrets-sweep: *qwen36
72
+ test-engineer:
73
+ coverage-scout: *qwen36
74
+ conventions: *qwen
75
+ services:
76
+ watchdog: *qwen36
77
+ return-extractor: *qwen
78
+ panel:
79
+ - name: qwen36
80
+ model: *qwen36
81
+ integrator: true
82
+ - name: qwen
83
+ model: *qwen