@chankov/agent-fleet 1.0.4 → 2.0.1

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 (894) hide show
  1. package/.pi/harnesses/agent-hub/README.md +57 -66
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  32. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  38. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  39. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  40. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  41. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  42. package/.pi/harnesses/agent-hub/index.ts +1324 -9645
  43. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  44. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  45. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  51. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  53. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  58. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  59. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  60. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  61. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  62. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  63. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  64. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  65. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  66. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  67. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  68. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  69. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  70. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  71. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  72. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  73. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  75. package/.pi/harnesses/agent-hub/types.ts +60 -0
  76. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  77. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  78. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  79. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  80. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  81. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  82. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  83. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  84. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  85. package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
  86. package/.pi/harnesses/coms/index.ts +139 -1630
  87. package/.pi/harnesses/coms/package.json +1 -1
  88. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  89. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  90. package/.pi/harnesses/lib/coms-core.ts +577 -0
  91. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  92. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  93. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  94. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  95. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  96. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  97. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  98. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  99. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  100. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  101. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  102. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  103. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  104. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  105. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  106. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  107. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  108. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  109. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  110. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  111. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  112. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  113. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  114. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  115. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  116. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  117. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  118. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  119. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  120. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  121. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  122. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  123. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  124. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  125. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  126. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  127. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  128. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  129. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  130. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  131. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  132. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  133. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  134. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  135. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  136. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  137. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  138. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  139. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  140. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  141. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  142. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  143. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  144. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  145. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  146. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  147. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  148. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  149. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  150. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  151. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  152. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  153. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  154. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  155. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  156. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  157. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  158. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  159. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  160. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  161. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  162. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  163. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  164. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  165. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  166. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  167. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  168. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  169. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  170. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  171. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  172. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  173. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  174. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  175. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  176. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  177. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  178. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  179. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  180. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  181. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  182. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  183. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  184. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  185. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  186. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  187. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  188. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  189. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  190. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  191. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  192. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  193. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  194. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  195. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  196. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  197. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  198. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  199. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  200. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  201. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  202. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  203. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  204. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  205. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  206. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  207. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  208. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  209. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  210. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  211. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  212. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  213. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  214. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  215. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  216. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  217. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  218. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  219. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  220. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  221. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  222. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  223. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  224. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  225. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  226. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  227. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  228. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  229. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  230. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  231. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  232. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  233. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  234. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  235. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  236. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  237. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  238. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  239. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  240. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  241. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  242. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  243. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  244. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  245. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  246. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  247. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  248. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  249. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  250. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  251. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  252. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  253. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  254. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  255. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  256. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  257. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  258. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  259. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  260. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  261. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  262. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  263. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  264. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  265. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  266. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  267. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  268. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  269. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  270. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  271. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  272. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  273. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  274. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  275. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  276. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  277. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  278. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  279. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  280. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  281. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  282. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  283. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  284. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  285. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  286. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  287. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  288. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  289. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  290. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  291. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  292. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  293. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  294. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  295. package/.versions/2.0.0/.version +1 -0
  296. package/.versions/2.0.0/agents/architect.md +25 -0
  297. package/.versions/2.0.0/agents/bowser.md +28 -0
  298. package/.versions/2.0.0/agents/builder.md +56 -0
  299. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  300. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  301. package/.versions/2.0.0/agents/documenter.md +19 -0
  302. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  303. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  304. package/.versions/2.0.0/agents/planner.md +71 -0
  305. package/.versions/2.0.0/agents/releaser.md +25 -0
  306. package/.versions/2.0.0/agents/researcher.md +29 -0
  307. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  308. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  309. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  310. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  311. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  312. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  313. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  314. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  315. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  316. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  317. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  318. package/.versions/2.0.0/docs/getting-started.md +98 -0
  319. package/.versions/2.0.0/docs/npm-install.md +292 -0
  320. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  321. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  322. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  323. package/.versions/2.0.0/hermes/README.md +347 -0
  324. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  325. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  326. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  327. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  328. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  329. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  330. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  331. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  332. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  333. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  334. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  335. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  336. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  337. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  338. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  339. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  340. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  341. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  342. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  343. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  344. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  345. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  346. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  347. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  348. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  349. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  350. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  351. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  352. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  353. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  354. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  355. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  356. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  357. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  358. package/.versions/2.0.0/install-manifest.json +2745 -0
  359. package/.versions/2.0.0/justfile +272 -0
  360. package/.versions/2.0.0/manifest-meta.json +882 -0
  361. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  362. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  363. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  364. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  365. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  366. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  367. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  368. package/.versions/2.0.0/references/security-checklist.md +179 -0
  369. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  370. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  371. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  372. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  373. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  374. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  375. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  376. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  377. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  378. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  379. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  380. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  381. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  382. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  383. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  384. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  385. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  386. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  387. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  388. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  389. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  390. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  391. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  392. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  393. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  394. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  395. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  396. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  397. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  398. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  399. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  400. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  401. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  402. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  403. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  404. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  405. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  406. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  407. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  408. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  409. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  410. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  411. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  412. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  413. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  414. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  415. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  416. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  417. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  418. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  419. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  420. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  421. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  422. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  423. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  424. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  425. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  426. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  427. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  428. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  429. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  430. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  431. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  432. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  433. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  434. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  435. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  436. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  437. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  438. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  439. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  440. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  441. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  442. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  443. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  444. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  445. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  446. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  447. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  448. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  449. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  450. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  451. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  452. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  453. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  454. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  455. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  456. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  457. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  458. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  459. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  460. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  461. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  462. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  463. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  464. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  465. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  466. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  467. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  468. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  469. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  470. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  471. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  472. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  473. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  474. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  475. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  476. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  477. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  478. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  479. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  480. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  481. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  482. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  483. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  484. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  485. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  486. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  487. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  488. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  489. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  490. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  491. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  492. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  493. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  494. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  495. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  496. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  497. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  498. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  499. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  500. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  501. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  502. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  503. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  504. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  505. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  506. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  507. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  508. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  509. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  510. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  511. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  512. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  513. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  514. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  515. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  516. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  517. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  518. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  519. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  520. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  521. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  522. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  523. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  524. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  525. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  526. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  527. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  528. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  529. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  530. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  531. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  532. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  533. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  534. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  535. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  536. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  537. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  538. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  539. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  540. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  541. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  542. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  543. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  544. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  545. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  546. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  547. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  548. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  549. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  550. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  551. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  552. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  553. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  554. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  555. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  556. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  557. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  558. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  559. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  560. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  561. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  562. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  563. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  564. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  565. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  566. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  567. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  568. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  569. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  570. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  571. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  572. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  573. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  574. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  575. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  576. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  577. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  578. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  579. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  580. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  581. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  582. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  583. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  584. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  585. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  586. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  587. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  588. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  589. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  590. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  591. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  592. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  593. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  594. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  595. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  596. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  597. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  598. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  599. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  600. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  601. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  602. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  603. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  604. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  605. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  606. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  607. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  608. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  609. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  610. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  611. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  612. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  613. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  614. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  615. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  616. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  617. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  618. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  619. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  620. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  621. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  622. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  623. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  624. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  625. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  626. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  627. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  628. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  629. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  630. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  631. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  632. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  633. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  634. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  635. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  636. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  637. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  638. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  639. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  640. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  641. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  642. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  643. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  644. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  645. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  646. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  647. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  648. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  649. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  650. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  651. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  652. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  653. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  654. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  655. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  656. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  657. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  658. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  659. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  660. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  661. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  662. package/.versions/2.0.1/.version +1 -0
  663. package/.versions/2.0.1/agents/architect.md +25 -0
  664. package/.versions/2.0.1/agents/bowser.md +28 -0
  665. package/.versions/2.0.1/agents/builder.md +56 -0
  666. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  667. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  668. package/.versions/2.0.1/agents/documenter.md +22 -0
  669. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  670. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  671. package/.versions/2.0.1/agents/planner.md +73 -0
  672. package/.versions/2.0.1/agents/releaser.md +25 -0
  673. package/.versions/2.0.1/agents/researcher.md +31 -0
  674. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  675. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  676. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  677. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  678. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  679. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  680. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  681. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  682. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  683. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  684. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  685. package/.versions/2.0.1/docs/getting-started.md +119 -0
  686. package/.versions/2.0.1/docs/npm-install.md +292 -0
  687. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  688. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  689. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  690. package/.versions/2.0.1/hermes/README.md +347 -0
  691. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  692. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  693. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  694. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  695. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  696. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  697. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  698. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  699. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  700. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  701. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  702. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  703. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  704. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  705. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  706. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  707. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  708. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  709. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  710. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  711. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  712. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  713. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  714. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  715. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  716. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  717. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  718. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  719. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  720. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  721. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  722. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  723. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  724. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  725. package/.versions/2.0.1/install-manifest.json +2830 -0
  726. package/.versions/2.0.1/justfile +286 -0
  727. package/.versions/2.0.1/manifest-meta.json +913 -0
  728. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  729. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  730. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  731. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  732. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  733. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  734. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  735. package/.versions/2.0.1/references/security-checklist.md +179 -0
  736. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  737. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  738. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  739. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  740. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  741. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  742. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  743. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  744. package/.versions/2.0.1/scripts/flow.ts +121 -0
  745. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  746. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  747. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  748. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  749. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  750. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  751. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  752. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  753. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  754. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  755. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  756. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  757. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  758. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  759. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  760. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  761. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  762. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  763. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  764. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  765. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  766. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  767. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  768. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  769. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  770. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  771. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  772. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  773. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  774. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  775. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  776. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  777. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  778. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  779. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  780. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  781. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  782. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  783. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  784. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  785. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  786. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  787. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  788. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  789. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  790. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  791. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  792. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  793. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  794. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  795. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  796. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  797. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  798. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  799. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  800. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  801. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  802. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  803. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  804. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  805. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  806. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  807. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  808. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  809. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  810. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  811. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  812. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  813. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  814. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  815. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  816. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  817. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  818. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  819. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  820. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  821. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  822. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  823. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  824. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  825. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  826. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  827. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  828. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  829. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  830. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  831. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  832. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  833. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  834. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  835. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  836. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  837. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  838. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  839. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  840. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  841. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  842. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  843. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  844. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  845. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  846. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  847. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  848. package/CHANGELOG.md +40 -0
  849. package/README.md +26 -5
  850. package/agents/code-reviewer.md +1 -0
  851. package/agents/documenter.md +3 -0
  852. package/agents/orchestrator.md +3 -1
  853. package/agents/planner.md +2 -0
  854. package/agents/researcher.md +2 -0
  855. package/bin/lib/overrides.js +2 -0
  856. package/bin/lib/validate-overrides.js +1 -1
  857. package/docs/ARCHITECTURE.md +45 -13
  858. package/docs/MIGRATION-agent-fleet.md +4 -4
  859. package/docs/agent-fleet-setup.md +15 -15
  860. package/docs/getting-started.md +21 -0
  861. package/docs/npm-install.md +1 -1
  862. package/docs/pi-extensions.md +16 -18
  863. package/docs/workflows.md +136 -0
  864. package/install-manifest.json +86 -1
  865. package/justfile +16 -2
  866. package/manifest-meta.json +32 -1
  867. package/package.json +11 -3
  868. package/references/workflow-authoring.md +304 -0
  869. package/scripts/fleet.ts +23 -10
  870. package/scripts/flow.ts +121 -0
  871. package/scripts/lib/fleet-command.ts +15 -11
  872. package/scripts/lib/flow-command.ts +77 -0
  873. package/scripts/lib/flow-maintenance.ts +230 -0
  874. package/scripts/lib/team-project.ts +2 -2
  875. package/scripts/team-up.ts +10 -10
  876. package/scripts/workflows/lib/agent-phase.ts +118 -0
  877. package/scripts/workflows/lib/changes.ts +61 -0
  878. package/scripts/workflows/lib/env.ts +34 -0
  879. package/scripts/workflows/lib/envelopes.ts +141 -0
  880. package/scripts/workflows/lib/gates.ts +81 -0
  881. package/scripts/workflows/lib/git.ts +96 -0
  882. package/scripts/workflows/lib/permissions.ts +130 -0
  883. package/scripts/workflows/lib/personas.ts +44 -0
  884. package/scripts/workflows/lib/quality.ts +64 -0
  885. package/scripts/workflows/lib/run.ts +106 -0
  886. package/scripts/workflows/lib/trace.ts +34 -0
  887. package/scripts/workflows/tsconfig.json +22 -0
  888. package/scripts/workflows/wf-build-test.ts +61 -0
  889. package/scripts/workflows/wf-document.ts +50 -0
  890. package/scripts/workflows/wf-quality.ts +20 -0
  891. package/scripts/workflows/wf-scout.ts +38 -0
  892. package/skills/drafting-workflows/SKILL.md +143 -0
  893. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  894. package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
@@ -0,0 +1,116 @@
1
+ import {
2
+ buildPeerLaunchPlan,
3
+ type PeerLaunchContext,
4
+ type PeerLaunchPlan,
5
+ type PeerRunner,
6
+ } from "../../../scripts/lib/peer-launch.ts";
7
+ import { launchPeerInPane, peerReadyVerdict } from "../lib/spawned-peers.js";
8
+
9
+ export interface HubPeerSpawnRequest {
10
+ name: string;
11
+ runner?: PeerRunner;
12
+ persona?: string;
13
+ no_persona?: boolean;
14
+ model?: string;
15
+ extensions?: string;
16
+ browser?: boolean;
17
+ all_extensions?: boolean;
18
+ direction?: "right" | "down";
19
+ }
20
+
21
+ export interface HubPeerSpawnContext extends PeerLaunchContext {
22
+ /** The current Hub/coms project. The request cannot override it. */
23
+ project: string;
24
+ }
25
+
26
+ /**
27
+ * Constrained Agent Hub adapter for the canonical Fleet peer resolver.
28
+ * Project, placement, env-file source, and raw Pi argv are not LLM-controlled:
29
+ * the project comes from the Hub identity and envFile can only come back from
30
+ * a validated peers.yaml declaration inside buildPeerLaunchPlan().
31
+ */
32
+ export function buildHubPeerSpawnPlan(
33
+ request: HubPeerSpawnRequest,
34
+ context: HubPeerSpawnContext,
35
+ ): PeerLaunchPlan {
36
+ return buildPeerLaunchPlan(
37
+ {
38
+ name: request.name,
39
+ ...(request.runner ? { runner: request.runner } : {}),
40
+ ...(request.persona ? { persona: request.persona } : {}),
41
+ ...(request.no_persona ? { noPersona: true } : {}),
42
+ ...(request.model ? { model: request.model } : {}),
43
+ ...(request.extensions ? { extensions: request.extensions } : {}),
44
+ ...(request.browser ? { browser: true } : {}),
45
+ ...(request.all_extensions ? { allExtensions: true } : {}),
46
+ ...(request.direction ? { direction: request.direction } : {}),
47
+ project: context.project,
48
+ here: false,
49
+ },
50
+ context,
51
+ );
52
+ }
53
+
54
+ interface HubPeerPaneClient {
55
+ paneSplit(params: {
56
+ target_pane_id: string;
57
+ direction: "right" | "down";
58
+ cwd: string;
59
+ env?: Record<string, string>;
60
+ focus: boolean;
61
+ }): Promise<{ pane: { pane_id: string } }>;
62
+ paneRename(paneId: string, label: string): Promise<unknown>;
63
+ paneRead(params: { pane_id: string; lines: number }): Promise<{ read: { text?: string } }>;
64
+ paneSendText(paneId: string, text: string): Promise<unknown>;
65
+ paneSendKeys(paneId: string, keys: string[]): Promise<unknown>;
66
+ }
67
+
68
+ export interface HubPeerPaneLaunchOptions {
69
+ client: HubPeerPaneClient;
70
+ targetPaneId: string;
71
+ cwd: string;
72
+ env?: Record<string, string>;
73
+ waitForRegistration(name: string): Promise<{ found: boolean; waitedMs: number }>;
74
+ paneTail(paneId: string): Promise<string>;
75
+ onLaunched?(paneId: string): void;
76
+ }
77
+
78
+ /** Split next to the Hub, type the canonical argv, then return readiness proof. */
79
+ export async function launchHubPeerInPane(
80
+ plan: PeerLaunchPlan,
81
+ options: HubPeerPaneLaunchOptions,
82
+ ): Promise<{
83
+ paneId: string;
84
+ promptSeen: boolean;
85
+ promptWaitedMs: number;
86
+ verdict: ReturnType<typeof peerReadyVerdict>;
87
+ }> {
88
+ const env = options.env ?? {};
89
+ const { pane } = await options.client.paneSplit({
90
+ target_pane_id: options.targetPaneId,
91
+ direction: plan.direction,
92
+ cwd: options.cwd,
93
+ ...(Object.keys(env).length > 0 ? { env } : {}),
94
+ focus: false,
95
+ });
96
+ try {
97
+ await options.client.paneRename(pane.pane_id, plan.name);
98
+ } catch {
99
+ // A label is cosmetic; the pane id and coms identity remain authoritative.
100
+ }
101
+ const launch = await launchPeerInPane(options.client, pane.pane_id, plan.command);
102
+ options.onLaunched?.(pane.pane_id);
103
+ const readiness = await options.waitForRegistration(plan.name);
104
+ const tail = readiness.found ? undefined : await options.paneTail(pane.pane_id);
105
+ return {
106
+ paneId: pane.pane_id,
107
+ promptSeen: launch.promptSeen,
108
+ promptWaitedMs: launch.waitedMs,
109
+ verdict: peerReadyVerdict({
110
+ name: plan.name,
111
+ paneId: pane.pane_id,
112
+ ...readiness,
113
+ ...(tail === undefined ? {} : { paneTail: tail }),
114
+ }),
115
+ };
116
+ }
@@ -0,0 +1,126 @@
1
+ export interface ModelPolicyDef {
2
+ name: string;
3
+ model?: string;
4
+ fallbackModel?: string;
5
+ models?: string[];
6
+ thinking?: string;
7
+ subagents?: Record<string, { model: string; fallbackModel?: string }>;
8
+ }
9
+
10
+ export interface ModelPolicyPorts<TDef extends ModelPolicyDef> {
11
+ getAllDefs(): readonly TDef[];
12
+ getActiveDef(name: string): TDef | undefined;
13
+ getResearchDefs(): readonly TDef[];
14
+ refreshUi(): void;
15
+ }
16
+
17
+ export interface ModelSubstitutionUiPort {
18
+ loadAvailable(current?: string): Promise<readonly { spec: string }[] | null>;
19
+ notify(message: string, level: "error" | "info" | "success"): void;
20
+ }
21
+
22
+ export interface ModelPolicy<TDef extends ModelPolicyDef> {
23
+ allowedModels(def: TDef): string[];
24
+ substitutedModel(model: string | undefined): string | undefined;
25
+ resolvedModel(def: TDef): string | undefined;
26
+ resolvedSubagentModel(persona: string, role: string, declared: string): string;
27
+ resolvedThinking(def: TDef): string | undefined;
28
+ switchablePersonaDef(name: string): TDef | undefined;
29
+ allKnownModels(): string[];
30
+ getPersonaOverride(name: string): string | undefined;
31
+ setPersonaOverride(name: string, model: string | undefined): void;
32
+ getSubagentOverride(persona: string, role: string): string | undefined;
33
+ setSubagentOverride(persona: string, role: string, model: string | undefined): void;
34
+ setThinkingOverride(name: string, thinking: string | undefined): void;
35
+ getSubstitution(source: string): string | undefined;
36
+ substitutionEntries(): IterableIterator<[string, string]>;
37
+ applyProfile(profile: Readonly<Record<string, string>>): string[];
38
+ applySessionSubstitution(source: string, target: string, ui: ModelSubstitutionUiPort): Promise<boolean>;
39
+ reset(): void;
40
+ }
41
+
42
+ export function createModelPolicy<TDef extends ModelPolicyDef>(ports: ModelPolicyPorts<TDef>): ModelPolicy<TDef> {
43
+ const personaOverrides = new Map<string, string>();
44
+ const substitutions = new Map<string, string>();
45
+ const thinkingOverrides = new Map<string, string>();
46
+ const subagentOverrides = new Map<string, string>();
47
+ const key = (value: string) => value.toLowerCase();
48
+ const roleKey = (persona: string, role: string) => `${key(persona)}.${key(role)}`;
49
+
50
+ function allowedModels(def: TDef): string[] {
51
+ const out: string[] = [];
52
+ for (const model of [def.model, ...(def.models || [])]) if (model && !out.includes(model)) out.push(model);
53
+ return out;
54
+ }
55
+ function substitutedModel(model: string | undefined): string | undefined {
56
+ return model ? substitutions.get(model) ?? model : undefined;
57
+ }
58
+ function resolvedModel(def: TDef): string | undefined {
59
+ return substitutedModel(personaOverrides.get(key(def.name)) ?? def.model);
60
+ }
61
+ function resolvedSubagentModel(persona: string, role: string, declared: string): string {
62
+ return substitutedModel(subagentOverrides.get(roleKey(persona, role)) ?? declared) ?? declared;
63
+ }
64
+ function resolvedThinking(def: TDef): string | undefined {
65
+ return thinkingOverrides.get(key(def.name)) ?? def.thinking;
66
+ }
67
+ function switchablePersonaDef(name: string): TDef | undefined {
68
+ return ports.getActiveDef(key(name)) ?? ports.getResearchDefs().find(def => key(def.name) === key(name));
69
+ }
70
+ function allKnownModels(): string[] {
71
+ const seen = new Set<string>();
72
+ const out: string[] = [];
73
+ const add = (model: string | undefined) => { if (model && !seen.has(model)) { seen.add(model); out.push(model); } };
74
+ for (const def of ports.getAllDefs()) {
75
+ add(def.model); add(def.fallbackModel);
76
+ for (const model of def.models ?? []) add(model);
77
+ for (const role of Object.values(def.subagents ?? {})) { add(role.model); add(role.fallbackModel); }
78
+ }
79
+ for (const model of personaOverrides.values()) add(model);
80
+ for (const model of subagentOverrides.values()) add(model);
81
+ for (const source of substitutions.keys()) add(source);
82
+ return out;
83
+ }
84
+ function setPersonaOverride(name: string, model: string | undefined): void {
85
+ if (model === undefined) personaOverrides.delete(key(name)); else personaOverrides.set(key(name), model);
86
+ }
87
+ function setSubagentOverride(persona: string, role: string, model: string | undefined): void {
88
+ const target = roleKey(persona, role);
89
+ if (model === undefined) subagentOverrides.delete(target); else subagentOverrides.set(target, model);
90
+ }
91
+ function applyProfile(profile: Readonly<Record<string, string>>): string[] {
92
+ const applied: string[] = [];
93
+ for (const [persona, model] of Object.entries(profile)) {
94
+ const def = ports.getAllDefs().find(candidate => key(candidate.name) === key(persona));
95
+ if (!def) continue;
96
+ setPersonaOverride(persona, model === def.model ? undefined : model);
97
+ applied.push(persona);
98
+ }
99
+ ports.refreshUi();
100
+ return applied;
101
+ }
102
+ async function applySessionSubstitution(source: string, target: string, ui: ModelSubstitutionUiPort): Promise<boolean> {
103
+ const known = allKnownModels();
104
+ if (!known.includes(source)) { ui.notify(`Unknown configured source model "${source}". Choose one of: ${known.join(", ") || "none"}.`, "error"); return false; }
105
+ const available = await ui.loadAvailable(substitutions.get(source));
106
+ if (!available) return false;
107
+ if (!available.some(choice => choice.spec === target)) { ui.notify(`Target model "${target}" is not currently available in Pi.`, "error"); return false; }
108
+ if (source === target) { ui.notify(`Source and target are the same (${source}); the session substitution was not changed.`, "info"); return false; }
109
+ const previous = substitutions.get(source);
110
+ if (previous === target) { ui.notify(`Substitution ${source} → ${target} is already active for this session.`, "info"); return false; }
111
+ substitutions.set(source, target);
112
+ const personas = ports.getAllDefs().filter(def => (personaOverrides.get(key(def.name)) ?? def.model) === source);
113
+ const roles = ports.getAllDefs().flatMap(def => Object.entries(def.subagents ?? {}).filter(([role, config]) => (subagentOverrides.get(roleKey(def.name, role)) ?? config.model) === source));
114
+ ports.refreshUi();
115
+ ui.notify(`${previous ? "Updated" : "Saved"} session substitution ${source} → ${target}. ${personas.length} persona${personas.length === 1 ? "" : "s"} and ${roles.length} sub-role${roles.length === 1 ? "" : "s"} currently resolve through it; future agents spawned from the same configured source inherit it automatically. Current runs are not interrupted.`, "success");
116
+ return true;
117
+ }
118
+ return {
119
+ allowedModels, substitutedModel, resolvedModel, resolvedSubagentModel, resolvedThinking, switchablePersonaDef, allKnownModels,
120
+ getPersonaOverride: name => personaOverrides.get(key(name)), setPersonaOverride,
121
+ getSubagentOverride: (persona, role) => subagentOverrides.get(roleKey(persona, role)), setSubagentOverride,
122
+ setThinkingOverride: (name, thinking) => { if (thinking === undefined) thinkingOverrides.delete(key(name)); else thinkingOverrides.set(key(name), thinking); },
123
+ getSubstitution: source => substitutions.get(source), substitutionEntries: () => substitutions.entries(), applyProfile, applySessionSubstitution,
124
+ reset: () => { personaOverrides.clear(); substitutions.clear(); subagentOverrides.clear(); thinkingOverrides.clear(); },
125
+ };
126
+ }
@@ -0,0 +1,79 @@
1
+ export interface RosterDef { name: string }
2
+ export interface RosterState<TDef extends RosterDef> { def: TDef; status: string }
3
+ export interface RosterMutationResult { ok: boolean; message: string }
4
+ export interface SessionAdoption { file: string | null; quarantined: string | null; reason: string | null }
5
+
6
+ export interface RosterPolicyPorts<TDef extends RosterDef, TState extends RosterState<TDef>> {
7
+ getTeams(): Readonly<Record<string, readonly string[]>>;
8
+ getAllDefs(): readonly TDef[];
9
+ getStates(): Map<string, TState>;
10
+ getActiveTeamName(): string;
11
+ setActiveTeamName(name: string): void;
12
+ clearBackendNotices(): void;
13
+ createFreshState(def: TDef, adoption?: SessionAdoption): TState;
14
+ adoptSession(def: TDef): SessionAdoption;
15
+ quarantineSession(def: TDef): { usable: boolean; quarantined: string | null; reason: string | null };
16
+ persist(teamName: string): void;
17
+ recompute(): void;
18
+ refreshUi(): void;
19
+ displayName(name: string): string;
20
+ orchestratorNeedsRosterAfterDrop(size: number): boolean;
21
+ }
22
+
23
+ export interface RosterPolicy<TDef extends RosterDef> {
24
+ activateTeam(teamName: string): void;
25
+ persistActiveRoster(): void;
26
+ add(name: string): RosterMutationResult;
27
+ drop(name: string): RosterMutationResult;
28
+ }
29
+
30
+ export function createRosterPolicy<TDef extends RosterDef, TState extends RosterState<TDef>>(ports: RosterPolicyPorts<TDef, TState>): RosterPolicy<TDef> {
31
+ function activateTeam(teamName: string): void {
32
+ ports.setActiveTeamName(teamName);
33
+ const members = ports.getTeams()[teamName] || [];
34
+ const defsByName = new Map(ports.getAllDefs().map(def => [def.name.toLowerCase(), def]));
35
+ const states = ports.getStates();
36
+ states.clear();
37
+ ports.clearBackendNotices();
38
+ for (const member of members) {
39
+ const def = defsByName.get(member.toLowerCase());
40
+ if (def) states.set(def.name.toLowerCase(), ports.createFreshState(def, ports.adoptSession(def)));
41
+ }
42
+ ports.recompute();
43
+ }
44
+ function persistActiveRoster(): void {
45
+ const team = ports.getActiveTeamName();
46
+ if (team && ports.getStates().size > 0) ports.persist(team);
47
+ }
48
+ function add(name: string): RosterMutationResult {
49
+ const key = String(name || "").trim().toLowerCase();
50
+ const def = ports.getAllDefs().find(candidate => candidate.name.toLowerCase() === key);
51
+ if (!def) {
52
+ const available = ports.getAllDefs().map(candidate => candidate.name).sort().join(", ") || "(none)";
53
+ return { ok: false, message: `No persona "${name}". Available: ${available}` };
54
+ }
55
+ const states = ports.getStates();
56
+ if (states.has(def.name.toLowerCase())) return { ok: false, message: `${ports.displayName(def.name)} is already in the active team` };
57
+ const adoption = ports.adoptSession(def);
58
+ states.set(def.name.toLowerCase(), ports.createFreshState(def, adoption));
59
+ if (!ports.getActiveTeamName()) ports.setActiveTeamName("ad-hoc");
60
+ ports.recompute(); ports.refreshUi();
61
+ const note = adoption.quarantined ? ` — its previous session file was unusable (${adoption.reason}) and was quarantined to ${adoption.quarantined}; it starts clean` : "";
62
+ return { ok: true, message: `${ports.displayName(def.name)} added to the active team${note}` };
63
+ }
64
+ function drop(name: string): RosterMutationResult {
65
+ const key = String(name || "").trim().toLowerCase();
66
+ const states = ports.getStates();
67
+ const state = states.get(key);
68
+ if (!state) return { ok: false, message: `"${name}" is not in the active team (${Array.from(states.values()).map(item => item.def.name).join(", ") || "empty"})` };
69
+ if (state.status === "running") return { ok: false, message: `${ports.displayName(state.def.name)} is running — wait for it to finish or /af-agents-kill it first` };
70
+ if (ports.orchestratorNeedsRosterAfterDrop(states.size - 1)) return { ok: false, message: `${ports.displayName(state.def.name)} is the last team member — switch to operator work mode or add a replacement before dropping it` };
71
+ states.delete(key);
72
+ if (states.size === 0) ports.setActiveTeamName("");
73
+ ports.recompute(); ports.refreshUi();
74
+ const health = ports.quarantineSession(state.def);
75
+ const note = health.usable ? " (its session file is kept for re-adding)" : health.quarantined ? ` (its session file was unusable — ${health.reason} — and was quarantined to ${health.quarantined}; re-adding starts clean)` : " (it has no session file; re-adding starts clean)";
76
+ return { ok: true, message: `${ports.displayName(state.def.name)} dropped from the active team${note}` };
77
+ }
78
+ return { activateTeam, persistActiveRoster, add, drop };
79
+ }
@@ -0,0 +1,118 @@
1
+ import { CAPABILITY_PACKS, persistedCapabilityState, resolveCapabilityPacks, type CapabilityPack, type CapabilityResolution, type ContextState, type PendingOperation } from "../capability-packs.ts";
2
+ import { confirmationGate, type CapabilityConfirmationState, type ConfirmableCapabilityPack } from "../capability-confirmation.ts";
3
+ import { orchestratorNeedsRoster } from "../helpers.ts";
4
+ import { WORK_MODE_ENTRY_TYPE, resolveWorkModeTools, type WorkMode } from "../work-mode.ts";
5
+ import { selectedPickerValue, workModeChangeBlockedByRoster, workModePickerOptions } from "../work-mode-controls.ts";
6
+
7
+ export interface WorkModeUiPort {
8
+ hasUI?: boolean;
9
+ ui: { notify(message: string, level: "error" | "warning" | "info" | "success"): void; setStatus(key: string, value: string): void; select(title: string, options: string[]): Promise<string | undefined> };
10
+ }
11
+ export interface PersistedCapabilityRestore { taskPacks: CapabilityPack[]; provisional: CapabilityPack[]; confirmation: CapabilityConfirmationState }
12
+ export interface WorkModePolicyPorts {
13
+ getBaselineTools(): readonly string[];
14
+ getRosterSize(): number;
15
+ getActiveTeamName(): string;
16
+ getComsReady(): boolean;
17
+ getHerdrReady(): boolean;
18
+ getAskUserAvailable(): boolean;
19
+ getIdentityLabel(): string | null;
20
+ getTaskTier(): string | null;
21
+ getPendingOperations(): PendingOperation[];
22
+ getContextState(): ContextState;
23
+ setActiveTools(tools: string[]): void;
24
+ persist(type: string, data: unknown): void;
25
+ replayDeferredInputs(): void;
26
+ watchdogArmed(workMode: WorkMode): boolean;
27
+ }
28
+ export interface WorkModePolicy {
29
+ getWorkMode(): WorkMode;
30
+ setRestoredWorkMode(mode: WorkMode): void;
31
+ getCapabilityResolution(): CapabilityResolution;
32
+ getCapabilityConfirmation(): CapabilityConfirmationState;
33
+ setCapabilityConfirmation(pack: ConfirmableCapabilityPack, status: CapabilityConfirmationState[ConfirmableCapabilityPack]): void;
34
+ restoreCapabilities(state: PersistedCapabilityRestore): void;
35
+ resetCapabilities(): void;
36
+ resolveIncomingCapabilities(userText: string, newTask?: boolean): void;
37
+ provisionalCapabilityRefusal(pack: ConfirmableCapabilityPack): { content: { type: "text"; text: string }[]; details: { status: string; confirmation: string; pack: ConfirmableCapabilityPack } } | null;
38
+ applyWorkModeTools(): void;
39
+ updateStatus(ctx: WorkModeUiPort): void;
40
+ statusText(): string;
41
+ modelWorkBlockedByRosterRecovery(ctx: WorkModeUiPort): boolean;
42
+ setRosterRecovery(required: boolean, diagnostic?: string): void;
43
+ clearRosterRecovery(): void;
44
+ commit(next: WorkMode, ctx: WorkModeUiPort): Promise<"ok" | "unchanged" | "roster">;
45
+ applySelection(next: WorkMode, ctx: WorkModeUiPort): Promise<void>;
46
+ openPicker(ctx: WorkModeUiPort): Promise<void>;
47
+ }
48
+
49
+ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMode = "operator"): WorkModePolicy {
50
+ let workMode = initial;
51
+ let rosterRecoveryRequired = false;
52
+ let rosterRecoveryDiagnostic = "";
53
+ let taskPacks: CapabilityPack[] = [];
54
+ let provisionalPacks: CapabilityPack[] = [];
55
+ let confirmation: CapabilityConfirmationState = {};
56
+ let resolution = resolveCapabilityPacks({ workMode, userText: "", taskPacks: [], comsReady: false, herdrReady: false, pendingOperations: [], contextState: "normal" });
57
+
58
+ function resolveIncomingCapabilities(userText: string, newTask = false): void {
59
+ resolution = resolveCapabilityPacks({
60
+ workMode, userText,
61
+ taskTier: (["trivial", "small", "feature", "project"] as const).find(tier => tier === ports.getTaskTier()),
62
+ taskPacks, provisionalPacks,
63
+ comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(),
64
+ pendingOperations: ports.getPendingOperations(), contextState: ports.getContextState(), newTask,
65
+ });
66
+ for (const pack of ["fleet", "peer", "workspace"] as const) {
67
+ if (confirmation[pack] === "promoted" || confirmation[pack] === "declined") {
68
+ resolution.provisional = resolution.provisional.filter(candidate => candidate !== pack);
69
+ resolution.confirmationRequired = resolution.confirmationRequired.filter(candidate => candidate !== pack);
70
+ if (confirmation[pack] === "promoted" && !resolution.active.includes(pack)) resolution.active.push(pack);
71
+ }
72
+ }
73
+ taskPacks = resolution.nextTaskPacks = CAPABILITY_PACKS.filter(pack => pack !== "core" && pack !== "compaction" && resolution.active.includes(pack));
74
+ provisionalPacks = resolution.provisional.filter(pack => confirmation[pack as ConfirmableCapabilityPack] !== "declined");
75
+ try { ports.persist("agent-hub-capability-packs", persistedCapabilityState(resolution, confirmation)); } catch { /* best effort */ }
76
+ }
77
+ function applyWorkModeTools(): void {
78
+ ports.setActiveTools(resolveWorkModeTools({ workMode, baselineTools: ports.getBaselineTools(), comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(), askUserAvailable: ports.getAskUserAvailable(), capabilityPacks: [...resolution.active, ...resolution.provisional] }));
79
+ }
80
+ function statusText(): string {
81
+ return [`Work Mode: ${workMode}`, `Direct tools: ${workMode === "operator" ? "enabled" : "disabled"}`, `Native roster: ${ports.getActiveTeamName() || "(none)"} (${ports.getRosterSize()})`, `Coms: ${ports.getComsReady() ? `ready${ports.getIdentityLabel() ? ` (${ports.getIdentityLabel()})` : ""}` : "unavailable"}`, `Herdr: ${ports.getHerdrReady() ? "ready" : "unavailable"}`].join("\n");
82
+ }
83
+ function refusalMessage(): string { return "Orchestrator work mode requires at least one native specialist. Add one with /af-agents-add or select /af-agents-team first."; }
84
+ function watchdogNote(next: WorkMode): string { return next === "orchestrator" ? ports.watchdogArmed(next) ? "\nDrift watchdog: armed (orchestrator auto). /af-watchdog off to disarm." : "\nDrift watchdog: off (explicit hub setting)." : ""; }
85
+ async function commit(next: WorkMode, ctx: WorkModeUiPort): Promise<"ok" | "unchanged" | "roster"> {
86
+ if (orchestratorNeedsRoster(next, ports.getRosterSize())) return "roster";
87
+ if (next === workMode) return "unchanged";
88
+ workMode = next;
89
+ if (workMode === "operator") { rosterRecoveryRequired = false; rosterRecoveryDiagnostic = ""; setTimeout(ports.replayDeferredInputs, 0); }
90
+ resolveIncomingCapabilities(""); applyWorkModeTools(); ctx.ui.setStatus("hub-work-mode", `Work Mode: ${workMode}`); ports.persist(WORK_MODE_ENTRY_TYPE, { workMode });
91
+ return "ok";
92
+ }
93
+ async function applySelection(next: WorkMode, ctx: WorkModeUiPort): Promise<void> {
94
+ if (workModeChangeBlockedByRoster(workMode, next, ports.getRosterSize())) { ctx.ui.notify(refusalMessage(), "warning"); return; }
95
+ const result = await commit(next, ctx);
96
+ if (result === "roster") { ctx.ui.notify(refusalMessage(), "warning"); return; }
97
+ ctx.ui.notify(`${statusText()}\nPrompt and tools update on the next model call.${watchdogNote(next)}`, result === "ok" ? "success" : "info");
98
+ }
99
+ async function openPicker(ctx: WorkModeUiPort): Promise<void> {
100
+ const picker = workModePickerOptions(workMode);
101
+ const choice = await ctx.ui.select(picker.title, [...picker.options]);
102
+ const next = selectedPickerValue(picker.options, choice, picker.workModes);
103
+ if (next) await applySelection(next, ctx);
104
+ }
105
+ return {
106
+ getWorkMode: () => workMode, setRestoredWorkMode: mode => { workMode = mode; },
107
+ getCapabilityResolution: () => resolution, getCapabilityConfirmation: () => confirmation,
108
+ setCapabilityConfirmation: (pack, status) => { if (status) confirmation[pack] = status; else delete confirmation[pack]; },
109
+ restoreCapabilities: state => { taskPacks = [...state.taskPacks]; provisionalPacks = [...state.provisional]; confirmation = { ...state.confirmation }; },
110
+ resetCapabilities: () => { taskPacks = []; provisionalPacks = []; confirmation = {}; },
111
+ resolveIncomingCapabilities,
112
+ provisionalCapabilityRefusal: pack => { const gate = confirmationGate(confirmation, pack, resolution.provisional.includes(pack)); return gate.allowed ? null : { content: [{ type: "text", text: gate.message }], details: { status: "provisional_confirmation_required", confirmation: gate.status, pack } }; },
113
+ applyWorkModeTools, updateStatus: ctx => ctx.ui.setStatus("hub-work-mode", `Work Mode: ${workMode}`), statusText,
114
+ modelWorkBlockedByRosterRecovery: ctx => { if (workMode !== "orchestrator" || !rosterRecoveryRequired) return false; const message = `${rosterRecoveryDiagnostic || "No valid native roster is active."} Select one with /af-agents-team, restart with --agent-team <name>, or switch explicitly with /af-work-mode operator.`; ctx.ui.notify(message, "error"); if (!ctx.hasUI) console.error(`[agent-hub] ${message}`); return true; },
115
+ setRosterRecovery: (required, diagnostic = "") => { rosterRecoveryRequired = required; rosterRecoveryDiagnostic = required ? diagnostic : ""; }, clearRosterRecovery: () => { rosterRecoveryRequired = false; rosterRecoveryDiagnostic = ""; },
116
+ commit, applySelection, openPicker,
117
+ };
118
+ }
@@ -0,0 +1,48 @@
1
+ import { existsSync } from "node:fs";
2
+ import { fileURLToPath } from "node:url";
3
+ import { join } from "node:path";
4
+
5
+ const VALID_THINKING_LEVELS = new Set(["off", "minimal", "low", "medium", "high", "xhigh"]);
6
+ const THINKING_ABBREV: Record<string, string> = { off: "", minimal: "min", low: "low", medium: "med", high: "hi", xhigh: "xh" };
7
+
8
+ export function displayName(name: string): string {
9
+ return name.split("-").map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
10
+ }
11
+
12
+ export function extractAskUserQuestions(output: string): string[] {
13
+ return extractMarkers(output, "ASK_USER");
14
+ }
15
+
16
+ export function extractNeedsResearch(output: string): string[] {
17
+ return extractMarkers(output, "NEEDS_RESEARCH");
18
+ }
19
+
20
+ function extractMarkers(output: string, marker: string): string[] {
21
+ const questions: string[] = [];
22
+ const pattern = new RegExp(`^${marker}\\s*:\\s*(.+)$`, "i");
23
+ for (const rawLine of output.split("\n")) {
24
+ const question = rawLine.trim().match(pattern)?.[1]?.trim();
25
+ if (question && !questions.includes(question)) questions.push(question);
26
+ }
27
+ return questions;
28
+ }
29
+
30
+ export function resolveThinkingLevel(raw?: string): string {
31
+ if (!raw) return "off";
32
+ const value = raw.trim().toLowerCase();
33
+ if (VALID_THINKING_LEVELS.has(value)) return value;
34
+ return ["on", "true", "yes", "1"].includes(value) ? "low" : "off";
35
+ }
36
+
37
+ export function abbrevThinking(level: string): string {
38
+ return THINKING_ABBREV[level] ?? "";
39
+ }
40
+
41
+ export function resolveDelegateExtension(cwd: string): string | null {
42
+ try {
43
+ const extension = fileURLToPath(new URL("./delegate.ts", import.meta.url));
44
+ if (existsSync(extension)) return extension;
45
+ } catch {}
46
+ const local = join(cwd, ".pi", "harnesses", "agent-hub", "delegate.ts");
47
+ return existsSync(local) ? local : null;
48
+ }
@@ -0,0 +1,46 @@
1
+ import type { CapabilityPack, CapabilityResolution } from "../capability-packs.ts";
2
+ import type { WorkMode } from "../work-mode.ts";
3
+
4
+ export interface HubPromptAgent {
5
+ name: string;
6
+ displayName: string;
7
+ description: string;
8
+ tools: string;
9
+ }
10
+
11
+ export interface HubPromptResearchPersona {
12
+ name: string;
13
+ displayName: string;
14
+ description: string;
15
+ model?: string;
16
+ thinking: string;
17
+ }
18
+
19
+ export interface HubPromptState {
20
+ taskTier: string;
21
+ taskTierAssumed: boolean;
22
+ turnDispatchCount: number;
23
+ turnResearchCount: number;
24
+ taskDispatchCount: number;
25
+ taskResearchCount: number;
26
+ taskReviewRounds: number;
27
+ turnBudget: { maxDispatches: number | null; maxResearch: number | null };
28
+ taskBudget: { wallMs: number | null };
29
+ provisionalConfirmations: readonly { pack: CapabilityPack; reason: string; question: string }[];
30
+ }
31
+
32
+ /** Read-only prompt dependencies. Mutable Hub state remains owned by index.ts. */
33
+ export interface HubPromptContext {
34
+ getCapabilityResolution(): CapabilityResolution;
35
+ getActiveTools(): readonly string[];
36
+ getAgents(): readonly HubPromptAgent[];
37
+ getResearchPersonas(): readonly HubPromptResearchPersona[];
38
+ getPromptState(): HubPromptState;
39
+ getWorkMode(): WorkMode;
40
+ getActiveTeamName(): string;
41
+ getUserLanguage(): string;
42
+ isAskUserAvailable(): boolean;
43
+ isComsReady(): boolean;
44
+ getIdentity(): { name: string; project: string } | null;
45
+ isHerdrFleetReady(): boolean;
46
+ }
@@ -0,0 +1,115 @@
1
+ import type { CapabilityResolution } from "../capability-packs.ts";
2
+ import type { HubPromptState } from "./context.ts";
3
+
4
+ export function askUserFragment(askUserAvailable: boolean, userLanguage: string): string {
5
+ return askUserAvailable
6
+ ? `## When to call \`ask_user\` (non-negotiable triggers)
7
+ - Requirements are ambiguous, incomplete, or contradictory.
8
+ - Multiple valid approaches exist and the trade-off is preference-dependent
9
+ (architecture, library choice, naming, scope cuts).
10
+ - A specialist returned an \`ASK_USER:\` marker — surface every one.
11
+ - A specialist's output contradicts an earlier specialist's output, or contradicts
12
+ the user's stated requirement — ask the user to resolve it.
13
+ - The next dispatch would be costly to undo (destructive edit, migration, mass
14
+ rename, production-facing change, secret/credential handling).
15
+ - You're about to assume a value (path, version, flag, threshold) the user did
16
+ not specify.
17
+
18
+ Calling \`ask_user\`:
19
+ - Read the tool's own description for the exact parameter shape — different
20
+ installs ship slightly different schemas. Always pass \`question\` and, when
21
+ helpful, \`context\` (a 1–3 line summary of what you've already found).
22
+ - Provide multiple-choice \`options\` whenever you can enumerate 2–6 valid
23
+ answers — it's faster for the user than free text.
24
+ - Ask exactly **one** focused question per call. Do not bundle unrelated questions.`
25
+ : `## ask_user is NOT available in this session
26
+ The \`pi-ask-user\` package is not installed, so you have no interactive way to
27
+ ask the human. You MUST instead:
28
+ - State every assumption explicitly in ${userLanguage} before dispatching.
29
+ - Phrase it as: "Assuming X (because Y) — say STOP/correct if wrong, otherwise I'll proceed."
30
+ - Wait for the user's next message before continuing on anything destructive.
31
+ - For \`ASK_USER:\` markers raised by specialists, relay the question verbatim to
32
+ the user in ${userLanguage} and wait for their reply in the next turn.`;
33
+ }
34
+
35
+ export function dispatchFragment(fleetActive: boolean, askUserAvailable: boolean, userLanguage: string): string {
36
+ if (!fleetActive) return "";
37
+ return askUserAvailable
38
+ ? `- BEFORE dispatching: if anything is ambiguous, missing, or could go several valid
39
+ ways, call \`ask_user\` first. Never invent constraints or "reasonable defaults"
40
+ the user did not state.
41
+ - Dispatch tasks via \`dispatch_agent\`. Each dispatched task is automatically
42
+ augmented with clarification/research plus deliverable-to-file protocols. For document handoff, pass artifact paths through the optional \`artifacts\` array; never paste full plan/review/inventory bodies into a task.
43
+ - For dispatches carrying A1/A2-style assertions, specialist returns arrive pre-parsed as \`details.structuredReturn\` with \`details.contractNotices\`; the full raw output is persisted at \`details.returnPath\` and kept for compatibility in \`details.fullOutput\`. Spawn a reader only when the digest/path is not enough.
44
+ - After each dispatch, INSPECT the result for ASK_USER questions (also surfaced in
45
+ the result \`details.questions\`). For each one: call \`ask_user\` in ${userLanguage},
46
+ then re-dispatch the specialist with the answer.`
47
+ : `- BEFORE dispatching: if anything is ambiguous, missing, or could go several valid
48
+ ways, STATE your assumption explicitly in ${userLanguage} and wait for the user
49
+ to correct it. Never invent constraints or "reasonable defaults" silently.
50
+ - Dispatch tasks via \`dispatch_agent\`. Each dispatched task is automatically
51
+ augmented with clarification/research plus deliverable-to-file protocols. For document handoff, pass artifact paths through the optional \`artifacts\` array; never paste full plan/review/inventory bodies into a task.
52
+ - For dispatches carrying A1/A2-style assertions, specialist returns arrive pre-parsed as \`details.structuredReturn\` with \`details.contractNotices\`; the full raw output is persisted at \`details.returnPath\` and kept for compatibility in \`details.fullOutput\`. Spawn a reader only when the digest/path is not enough.
53
+ - After each dispatch, INSPECT the result for ASK_USER questions (also surfaced in
54
+ the result \`details.questions\`). For each one: relay it verbatim to the user
55
+ in ${userLanguage} and wait for the reply before re-dispatching.`;
56
+ }
57
+
58
+ export function ambiguityFragment(askUserAvailable: boolean, userLanguage: string): string {
59
+ return askUserAvailable
60
+ ? `- NEVER proceed past an ambiguity by guessing. Either call \`ask_user\`, or state
61
+ the assumption explicitly in ${userLanguage} and say you'll proceed unless corrected.`
62
+ : `- NEVER proceed past an ambiguity by guessing. State the assumption explicitly
63
+ in ${userLanguage} and wait for the user to confirm or correct.`;
64
+ }
65
+
66
+ export function languageFragment(askUserAvailable: boolean, userLanguage: string): string {
67
+ const englishNoOp = userLanguage.toLowerCase() === "english" ? " (If user-language is English this is a no-op.)" : "";
68
+ return askUserAvailable
69
+ ? `- ALWAYS communicate with the human user in **${userLanguage}**. Every message you
70
+ write to the user, every \`ask_user\` question and \`context\` field — ${userLanguage}.
71
+ - Task strings you send via \`dispatch_agent\` stay in **English**. The specialist
72
+ personas are written in English; do not translate task descriptions for them.
73
+ - When a specialist emits an \`ASK_USER:\` line in English, translate it to
74
+ ${userLanguage} before passing it through \`ask_user\`.${englishNoOp}`
75
+ : `- ALWAYS communicate with the human user in **${userLanguage}**. Every message you
76
+ write to the user is ${userLanguage}.
77
+ - Task strings you send via \`dispatch_agent\` stay in **English**. The specialist
78
+ personas are written in English; do not translate task descriptions for them.
79
+ - When a specialist emits an \`ASK_USER:\` line in English, translate it to
80
+ ${userLanguage} before relaying to the user.${englishNoOp}`;
81
+ }
82
+
83
+ export function stateCapsuleFragment(state: HubPromptState, resolution: CapabilityResolution): string {
84
+ const cap = (n: number | null) => (n == null ? "unlimited" : String(n));
85
+ const capMin = (ms: number | null) => (ms == null ? "unlimited" : `${Math.round(ms / 60_000)} min`);
86
+ const capabilityState = [...resolution.active].map(pack => `${pack}:${resolution.reasons[pack]}`).join(", ");
87
+ const provisionalState = resolution.provisional.map(pack => `${pack}:${resolution.reasons[pack]}`).join(", ");
88
+ return `## Current task state
89
+ - tier: ${state.taskTier}${state.taskTierAssumed ? "?" : ""}; turn dispatches: ${state.turnDispatchCount}; research: ${state.turnResearchCount}
90
+ - task dispatches: ${state.taskDispatchCount}; research: ${state.taskResearchCount}; review rounds: ${state.taskReviewRounds}
91
+ - packs active: ${capabilityState}; provisional: ${provisionalState || "none"}
92
+ - provisional confirmation: ${state.provisionalConfirmations.map(item => `${item.pack} (${item.reason}) → call ask_user exactly once with ${JSON.stringify(item.question)}`).join("; ") || "none"}
93
+ - budgets: dispatch ${cap(state.turnBudget.maxDispatches)}, research ${cap(state.turnBudget.maxResearch)}, task wall ${capMin(state.taskBudget.wallMs)}.`;
94
+ }
95
+
96
+ export const TASK_TRIAGE_FRAGMENT = `## Task triage (before dispatch)
97
+ Call \`set_task_tier\` honestly: trivial/small work uses minimal ceremony; feature/project work uses the assertion ledger and a review gate. A provided plan is the specification, not consent to execute unrequested phases. Keep related plan work in coherent batches, pass a narrow scope, and treat a budget refusal as a stop-and-ask-human signal; code enforcement remains authoritative.`;
98
+
99
+ export function verificationFragment(maxOpenAssertions: number): string {
100
+ return `## Verification Contract
101
+ For non-trivial work, record at most ${maxOpenAssertions} narrow, sourced assertions before building and pass them verbatim to specialists. Advance only on named evidence; unproven/failed is not done. Runtime-UI claims require runtime observation. Use \`skills/orchestration-verification/SKILL.md\` for formats, parity inventories, and regression resets. After compaction, read the ledger before continuing.`;
102
+ }
103
+
104
+ export function comsFragment(peerActive: boolean, comsReady: boolean, identity: { name: string; project: string } | null): string {
105
+ return peerActive && comsReady && identity ? `
106
+ ## Peer agents (coms)
107
+ You are peer "${identity.name}" in project "${identity.project}". Use \`coms_list\` for the human-scoped pool and status; the Hub cannot widen it. Send one self-contained prompt, then await/get the returned msg_id without resending. Match send/await deadlines. Prefer team dispatch unless the task needs a standing peer, and never duplicate a dispatch to its same-name peer.
108
+ ` : "";
109
+ }
110
+
111
+ export const COMPACTION_FRAGMENT = `
112
+ ## Context recovery
113
+ - Context pressure is approaching or above the automatic recovery threshold. Keep tool output concise; redirect full test/package logs to files and inspect summaries or tails.
114
+ - \`request_compaction\` is available for explicit recovery. Automatic recovery preserves task state and continues from the compaction summary.
115
+ `;