@chankov/agent-fleet 2.0.3 → 2.0.4

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 (452) hide show
  1. package/.pi/agents/model-profiles.yaml +64 -13
  2. package/.pi/agents/peers.yaml +11 -8
  3. package/.pi/harnesses/agent-hub/README.md +4 -2
  4. package/.pi/harnesses/agent-hub/config/agents.ts +13 -14
  5. package/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  6. package/.pi/harnesses/agent-hub/dispatch-coms.ts +6 -4
  7. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +6 -3
  8. package/.pi/harnesses/agent-hub/dispatch-native.ts +4 -1
  9. package/.pi/harnesses/agent-hub/index.ts +61 -9
  10. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +7 -7
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/policy/models.ts +35 -8
  13. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  14. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  15. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  16. package/.pi/harnesses/agent-hub/research/spawn-run.ts +2 -1
  17. package/.pi/harnesses/agent-hub/spawn.ts +17 -1
  18. package/.pi/harnesses/agent-hub/tools/action-executors.ts +2 -0
  19. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -0
  20. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +4 -1
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  23. package/.versions/2.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/2.0.4/.pi/agents/model-profiles.yaml +78 -0
  25. package/.versions/2.0.4/.pi/agents/peers.yaml +145 -0
  26. package/.versions/2.0.4/.pi/agents/teams.yaml +41 -0
  27. package/.versions/2.0.4/.pi/agents/voices.yaml +13 -0
  28. package/.versions/2.0.4/.pi/damage-control-rules.yaml +297 -0
  29. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  30. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  31. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  32. package/.versions/2.0.4/.pi/extensions/btw/README.md +120 -0
  33. package/.versions/2.0.4/.pi/extensions/btw/index.ts +914 -0
  34. package/.versions/2.0.4/.pi/extensions/btw/package.json +6 -0
  35. package/.versions/2.0.4/.pi/extensions/btw/state.js +179 -0
  36. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  37. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  38. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  39. package/.versions/2.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  40. package/.versions/2.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  41. package/.versions/2.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  42. package/.versions/2.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  43. package/.versions/2.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  44. package/.versions/2.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  45. package/.versions/2.0.4/.pi/extensions/package-lock.json +1175 -0
  46. package/.versions/2.0.4/.pi/extensions/package.json +9 -0
  47. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  48. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  49. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  50. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  51. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  52. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  53. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  54. package/.versions/2.0.4/.pi/harnesses/agent-hub/README.md +1160 -0
  55. package/.versions/2.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  56. package/.versions/2.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  57. package/.versions/2.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  58. package/.versions/2.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  59. package/.versions/2.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  60. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  61. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  62. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  63. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  64. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  65. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  66. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  67. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  68. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  69. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  70. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  71. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  72. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  73. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  74. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  75. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  76. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  77. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  78. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  79. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  80. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  81. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  82. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  83. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  84. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  85. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  86. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  87. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  88. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  89. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  90. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  91. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  92. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  93. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  94. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  95. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  96. package/.versions/2.0.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  97. package/.versions/2.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  98. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  99. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  100. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  101. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  102. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  103. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  104. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native.ts +187 -0
  105. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  106. package/.versions/2.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  107. package/.versions/2.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  108. package/.versions/2.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  109. package/.versions/2.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  110. package/.versions/2.0.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  111. package/.versions/2.0.4/.pi/harnesses/agent-hub/footer.ts +30 -0
  112. package/.versions/2.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  113. package/.versions/2.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  114. package/.versions/2.0.4/.pi/harnesses/agent-hub/index.ts +2088 -0
  115. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  116. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  117. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  118. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  119. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  120. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  121. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  122. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  123. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  124. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  125. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  126. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  127. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  128. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  129. package/.versions/2.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  130. package/.versions/2.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  131. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  132. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  133. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  134. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  135. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  136. package/.versions/2.0.4/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  137. package/.versions/2.0.4/.pi/harnesses/agent-hub/presentation.ts +48 -0
  138. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  139. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  140. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  141. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  142. package/.versions/2.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  143. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  144. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  145. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/spawn-run.ts +144 -0
  146. package/.versions/2.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  147. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  148. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  149. package/.versions/2.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  150. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  151. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  152. package/.versions/2.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  153. package/.versions/2.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  154. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  155. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  156. package/.versions/2.0.4/.pi/harnesses/agent-hub/spawn.ts +404 -0
  157. package/.versions/2.0.4/.pi/harnesses/agent-hub/timeline.ts +54 -0
  158. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/action-executors.ts +148 -0
  159. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  160. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  161. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  162. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  163. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  164. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  165. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +84 -0
  166. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  167. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  168. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  169. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  170. package/.versions/2.0.4/.pi/harnesses/agent-hub/types.ts +61 -0
  171. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  172. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  173. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  174. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  175. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  176. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  177. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  178. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  179. package/.versions/2.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  180. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  181. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  182. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  183. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  184. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  185. package/.versions/2.0.4/.pi/harnesses/coms/README.md +100 -0
  186. package/.versions/2.0.4/.pi/harnesses/coms/index.ts +276 -0
  187. package/.versions/2.0.4/.pi/harnesses/coms/package.json +7 -0
  188. package/.versions/2.0.4/.pi/harnesses/coms/version.ts +42 -0
  189. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  190. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  191. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  192. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  193. package/.versions/2.0.4/.pi/harnesses/lib/coms-core-io.ts +385 -0
  194. package/.versions/2.0.4/.pi/harnesses/lib/coms-core.ts +577 -0
  195. package/.versions/2.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  196. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  197. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  198. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  199. package/.versions/2.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  200. package/.versions/2.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  201. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  202. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  203. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  204. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  205. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  206. package/.versions/2.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  207. package/.versions/2.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  208. package/.versions/2.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  209. package/.versions/2.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  210. package/.versions/2.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  211. package/.versions/2.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  212. package/.versions/2.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  213. package/.versions/2.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  214. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  215. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  216. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  217. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  218. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  219. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  220. package/.versions/2.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  221. package/.versions/2.0.4/.pi/harnesses/package-lock.json +2039 -0
  222. package/.versions/2.0.4/.pi/harnesses/package.json +10 -0
  223. package/.versions/2.0.4/.pi/prompts/af-build.md +24 -0
  224. package/.versions/2.0.4/.pi/prompts/af-code-simplify.md +22 -0
  225. package/.versions/2.0.4/.pi/prompts/af-plan.md +17 -0
  226. package/.versions/2.0.4/.pi/prompts/af-review.md +16 -0
  227. package/.versions/2.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  228. package/.versions/2.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  229. package/.versions/2.0.4/.pi/prompts/af-ship.md +17 -0
  230. package/.versions/2.0.4/.pi/prompts/af-spec.md +15 -0
  231. package/.versions/2.0.4/.pi/prompts/af-test.md +19 -0
  232. package/.versions/2.0.4/.pi/skills/bowser/SKILL.md +145 -0
  233. package/.versions/2.0.4/.version +1 -0
  234. package/.versions/2.0.4/agents/architect.md +25 -0
  235. package/.versions/2.0.4/agents/bowser.md +28 -0
  236. package/.versions/2.0.4/agents/builder.md +56 -0
  237. package/.versions/2.0.4/agents/code-reviewer.md +210 -0
  238. package/.versions/2.0.4/agents/deep-researcher.md +33 -0
  239. package/.versions/2.0.4/agents/documenter.md +22 -0
  240. package/.versions/2.0.4/agents/orchestrator.md +23 -0
  241. package/.versions/2.0.4/agents/plan-reviewer.md +84 -0
  242. package/.versions/2.0.4/agents/planner.md +105 -0
  243. package/.versions/2.0.4/agents/releaser.md +25 -0
  244. package/.versions/2.0.4/agents/researcher.md +31 -0
  245. package/.versions/2.0.4/agents/security-auditor.md +168 -0
  246. package/.versions/2.0.4/agents/test-engineer.md +154 -0
  247. package/.versions/2.0.4/agents/web-debugger.md +44 -0
  248. package/.versions/2.0.4/agents/web-performance-auditor.md +194 -0
  249. package/.versions/2.0.4/bin/catalog/harness-runtime-closure.json +36 -0
  250. package/.versions/2.0.4/codex/CONDUCTOR.md +148 -0
  251. package/.versions/2.0.4/docs/ARCHITECTURE.md +407 -0
  252. package/.versions/2.0.4/docs/agent-fleet-setup.md +547 -0
  253. package/.versions/2.0.4/docs/claude-code-coms-bridge.md +133 -0
  254. package/.versions/2.0.4/docs/codex-remote-conductor.md +170 -0
  255. package/.versions/2.0.4/docs/coms-hermes-bridge.md +189 -0
  256. package/.versions/2.0.4/docs/getting-started.md +124 -0
  257. package/.versions/2.0.4/docs/npm-install.md +299 -0
  258. package/.versions/2.0.4/docs/pi-extensions.md +447 -0
  259. package/.versions/2.0.4/docs/pi-setup.md +74 -0
  260. package/.versions/2.0.4/docs/skill-anatomy.md +150 -0
  261. package/.versions/2.0.4/hermes/README.md +347 -0
  262. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  263. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  264. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  265. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  266. package/.versions/2.0.4/hermes/gates/gate-o-capability.md +8 -0
  267. package/.versions/2.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  268. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  269. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  270. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  271. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  272. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  273. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  274. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  275. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  276. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  277. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  278. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  279. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  280. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  281. package/.versions/2.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  282. package/.versions/2.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  283. package/.versions/2.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  284. package/.versions/2.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  285. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  286. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  287. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  288. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  289. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  290. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  291. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  292. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  293. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  294. package/.versions/2.0.4/hermes/watchdog-tests/__init__.py +0 -0
  295. package/.versions/2.0.4/hooks/coms-stop-hook.mjs +84 -0
  296. package/.versions/2.0.4/install-manifest.json +2942 -0
  297. package/.versions/2.0.4/justfile +289 -0
  298. package/.versions/2.0.4/manifest-meta.json +969 -0
  299. package/.versions/2.0.4/references/accessibility-checklist.md +160 -0
  300. package/.versions/2.0.4/references/communication-contract.md +26 -0
  301. package/.versions/2.0.4/references/definition-of-done.md +67 -0
  302. package/.versions/2.0.4/references/fleet-coordination-patterns.md +171 -0
  303. package/.versions/2.0.4/references/observability-checklist.md +91 -0
  304. package/.versions/2.0.4/references/orchestration-patterns.md +370 -0
  305. package/.versions/2.0.4/references/performance-checklist.md +153 -0
  306. package/.versions/2.0.4/references/prompting-patterns.md +380 -0
  307. package/.versions/2.0.4/references/security-checklist.md +179 -0
  308. package/.versions/2.0.4/references/testing-patterns.md +236 -0
  309. package/.versions/2.0.4/references/workflow-authoring.md +304 -0
  310. package/.versions/2.0.4/scripts/claude-code-preflight.ts +70 -0
  311. package/.versions/2.0.4/scripts/codex-conductor.ts +41 -0
  312. package/.versions/2.0.4/scripts/codex-remote-control.ts +167 -0
  313. package/.versions/2.0.4/scripts/coms-claude-bridge.ts +411 -0
  314. package/.versions/2.0.4/scripts/coms-cli.ts +484 -0
  315. package/.versions/2.0.4/scripts/coms-hermes-bridge.ts +413 -0
  316. package/.versions/2.0.4/scripts/fleet.ts +222 -0
  317. package/.versions/2.0.4/scripts/flow.ts +137 -0
  318. package/.versions/2.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  319. package/.versions/2.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  320. package/.versions/2.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  321. package/.versions/2.0.4/scripts/install-hermes-plugin.sh +180 -0
  322. package/.versions/2.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  323. package/.versions/2.0.4/scripts/lib/codex-conductor.ts +88 -0
  324. package/.versions/2.0.4/scripts/lib/codex-remote-control.ts +482 -0
  325. package/.versions/2.0.4/scripts/lib/coms-envelope.ts +582 -0
  326. package/.versions/2.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  327. package/.versions/2.0.4/scripts/lib/fleet-command.ts +270 -0
  328. package/.versions/2.0.4/scripts/lib/flow-command.ts +93 -0
  329. package/.versions/2.0.4/scripts/lib/flow-maintenance.ts +230 -0
  330. package/.versions/2.0.4/scripts/lib/herdr-layout.ts +281 -0
  331. package/.versions/2.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  332. package/.versions/2.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  333. package/.versions/2.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  334. package/.versions/2.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  335. package/.versions/2.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  336. package/.versions/2.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  337. package/.versions/2.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  338. package/.versions/2.0.4/scripts/lib/monitor-env.ts +146 -0
  339. package/.versions/2.0.4/scripts/lib/peer-launch.ts +318 -0
  340. package/.versions/2.0.4/scripts/lib/persona-banner.ts +62 -0
  341. package/.versions/2.0.4/scripts/lib/runtime-dependencies.js +124 -0
  342. package/.versions/2.0.4/scripts/lib/spawn-stagger.ts +101 -0
  343. package/.versions/2.0.4/scripts/lib/team-project.ts +213 -0
  344. package/.versions/2.0.4/scripts/lib/team-snapshot.ts +147 -0
  345. package/.versions/2.0.4/scripts/package-lock.json +35 -0
  346. package/.versions/2.0.4/scripts/package.json +9 -0
  347. package/.versions/2.0.4/scripts/peer-banner.ts +40 -0
  348. package/.versions/2.0.4/scripts/peer-launch.ts +285 -0
  349. package/.versions/2.0.4/scripts/team-snapshot.ts +237 -0
  350. package/.versions/2.0.4/scripts/team-up.ts +406 -0
  351. package/.versions/2.0.4/scripts/workflows/lib/agent-phase.ts +133 -0
  352. package/.versions/2.0.4/scripts/workflows/lib/changes.ts +61 -0
  353. package/.versions/2.0.4/scripts/workflows/lib/debate.ts +149 -0
  354. package/.versions/2.0.4/scripts/workflows/lib/env.ts +34 -0
  355. package/.versions/2.0.4/scripts/workflows/lib/envelopes.ts +169 -0
  356. package/.versions/2.0.4/scripts/workflows/lib/gates.ts +81 -0
  357. package/.versions/2.0.4/scripts/workflows/lib/git.ts +96 -0
  358. package/.versions/2.0.4/scripts/workflows/lib/merge.ts +95 -0
  359. package/.versions/2.0.4/scripts/workflows/lib/model-profile.ts +22 -0
  360. package/.versions/2.0.4/scripts/workflows/lib/model-visibility.ts +92 -0
  361. package/.versions/2.0.4/scripts/workflows/lib/permissions.ts +130 -0
  362. package/.versions/2.0.4/scripts/workflows/lib/personas.ts +57 -0
  363. package/.versions/2.0.4/scripts/workflows/lib/poll.ts +86 -0
  364. package/.versions/2.0.4/scripts/workflows/lib/quality.ts +64 -0
  365. package/.versions/2.0.4/scripts/workflows/lib/run.ts +108 -0
  366. package/.versions/2.0.4/scripts/workflows/lib/trace.ts +34 -0
  367. package/.versions/2.0.4/scripts/workflows/lib/voices.ts +128 -0
  368. package/.versions/2.0.4/scripts/workflows/lib/writer-lease.ts +112 -0
  369. package/.versions/2.0.4/scripts/workflows/tsconfig.json +22 -0
  370. package/.versions/2.0.4/scripts/workflows/wf-build-test.ts +61 -0
  371. package/.versions/2.0.4/scripts/workflows/wf-debate.ts +87 -0
  372. package/.versions/2.0.4/scripts/workflows/wf-document.ts +50 -0
  373. package/.versions/2.0.4/scripts/workflows/wf-poll.ts +95 -0
  374. package/.versions/2.0.4/scripts/workflows/wf-quality.ts +20 -0
  375. package/.versions/2.0.4/scripts/workflows/wf-scout.ts +38 -0
  376. package/.versions/2.0.4/skills/_internal/grilling.md +59 -0
  377. package/.versions/2.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  378. package/.versions/2.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  379. package/.versions/2.0.4/skills/compound-learning/SKILL.md +137 -0
  380. package/.versions/2.0.4/skills/context-engineering/SKILL.md +291 -0
  381. package/.versions/2.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  382. package/.versions/2.0.4/skills/designing-agents/SKILL.md +394 -0
  383. package/.versions/2.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  384. package/.versions/2.0.4/skills/drafting-workflows/SKILL.md +143 -0
  385. package/.versions/2.0.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  386. package/.versions/2.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  387. package/.versions/2.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  388. package/.versions/2.0.4/skills/idea-refine/SKILL.md +182 -0
  389. package/.versions/2.0.4/skills/idea-refine/examples.md +238 -0
  390. package/.versions/2.0.4/skills/idea-refine/frameworks.md +99 -0
  391. package/.versions/2.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  392. package/.versions/2.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  393. package/.versions/2.0.4/skills/incremental-implementation/SKILL.md +298 -0
  394. package/.versions/2.0.4/skills/interview-me/SKILL.md +226 -0
  395. package/.versions/2.0.4/skills/orchestration-verification/SKILL.md +181 -0
  396. package/.versions/2.0.4/skills/peer-coms/SKILL.md +90 -0
  397. package/.versions/2.0.4/skills/performance-optimization/SKILL.md +350 -0
  398. package/.versions/2.0.4/skills/planning-and-task-breakdown/SKILL.md +265 -0
  399. package/.versions/2.0.4/skills/security-and-hardening/SKILL.md +461 -0
  400. package/.versions/2.0.4/skills/spec-driven-development/SKILL.md +256 -0
  401. package/.versions/2.0.4/skills/using-agent-skills/SKILL.md +197 -0
  402. package/.versions/2.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  403. package/.versions/2.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  404. package/.versions/2.0.4/vendor/agent-skills-upstream/README.md +11 -0
  405. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  406. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  407. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  408. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  409. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  410. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  411. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  412. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  413. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  414. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  415. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  416. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  417. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  418. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  419. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  420. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  421. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  422. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  423. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  424. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  425. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  426. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  427. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  428. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  429. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  430. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  431. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  432. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  433. package/CHANGELOG.md +7 -0
  434. package/bin/catalog/harness-runtime-closure.json +2 -0
  435. package/bin/cli.js +47 -9
  436. package/bin/lib/doctor.js +35 -2
  437. package/bin/lib/reconcile.js +3 -2
  438. package/docs/agent-fleet-setup.md +74 -0
  439. package/docs/claude-code-coms-bridge.md +5 -0
  440. package/docs/getting-started.md +5 -0
  441. package/docs/npm-install.md +12 -5
  442. package/install-manifest.json +3 -1
  443. package/justfile +1 -1
  444. package/package.json +5 -3
  445. package/scripts/claude-code-preflight.ts +70 -0
  446. package/scripts/fleet.ts +23 -0
  447. package/scripts/lib/runtime-dependencies.js +124 -0
  448. package/scripts/peer-launch.ts +27 -1
  449. package/scripts/workflows/lib/agent-phase.ts +2 -1
  450. package/scripts/workflows/lib/model-profile.ts +22 -0
  451. package/scripts/workflows/lib/personas.ts +6 -3
  452. package/scripts/workflows/lib/voices.ts +3 -0
@@ -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,153 @@
1
+ import { isCompleteProfile, parseCompleteProfile, validateProfile, agentSelection, childSelection, profileModels, type ModelProfile, type CompleteModelProfile } from '../config/model-profiles.ts';
2
+ import { assertProfileModel } from './profile-runtime.ts';
3
+ export interface ModelPolicyDef {
4
+ name: string;
5
+ model?: string;
6
+ fallbackModel?: string;
7
+ models?: string[];
8
+ thinking?: string;
9
+ subagents?: Record<string, { model: string; fallbackModel?: string }>;
10
+ }
11
+
12
+ export interface ModelPolicyPorts<TDef extends ModelPolicyDef> {
13
+ getAllDefs(): readonly TDef[];
14
+ getActiveDef(name: string): TDef | undefined;
15
+ getResearchDefs(): readonly TDef[];
16
+ refreshUi(): void;
17
+ }
18
+
19
+ export interface ModelSubstitutionUiPort {
20
+ loadAvailable(current?: string): Promise<readonly { spec: string }[] | null>;
21
+ notify(message: string, level: "error" | "info" | "success"): void;
22
+ }
23
+
24
+ export interface ModelPolicy<TDef extends ModelPolicyDef> {
25
+ allowedModels(def: TDef): string[];
26
+ substitutedModel(model: string | undefined): string | undefined;
27
+ resolvedModel(def: TDef): string | undefined;
28
+ resolvedSubagentModel(persona: string, role: string, declared: string): string;
29
+ resolvedThinking(def: TDef): string | undefined;
30
+ switchablePersonaDef(name: string): TDef | undefined;
31
+ allKnownModels(): string[];
32
+ getPersonaOverride(name: string): string | undefined;
33
+ setPersonaOverride(name: string, model: string | undefined): void;
34
+ getSubagentOverride(persona: string, role: string): string | undefined;
35
+ setSubagentOverride(persona: string, role: string, model: string | undefined): void;
36
+ setThinkingOverride(name: string, thinking: string | undefined): void;
37
+ getSubstitution(source: string): string | undefined;
38
+ substitutionEntries(): IterableIterator<[string, string]>;
39
+ applyProfile(profile: ModelProfile): string[];
40
+ applySessionSubstitution(source: string, target: string, ui: ModelSubstitutionUiPort): Promise<boolean>;
41
+ reset(): void;
42
+ }
43
+
44
+ export function createModelPolicy<TDef extends ModelPolicyDef>(ports: ModelPolicyPorts<TDef>): ModelPolicy<TDef> {
45
+ const personaOverrides = new Map<string, string>();
46
+ const substitutions = new Map<string, string>();
47
+ const thinkingOverrides = new Map<string, string>();
48
+ const subagentOverrides = new Map<string, string>();
49
+ let complete: CompleteModelProfile | undefined;
50
+ const maps = [personaOverrides, substitutions, thinkingOverrides, subagentOverrides];
51
+ let saved: Map<string,string>[] | undefined;
52
+ const assertAllowed = (model: string) => { if(complete) assertProfileModel(model,{name:'active',profile:complete}); };
53
+ const refresh = () => { try { ports.refreshUi(); } catch { /* presentation cannot invalidate a model switch */ } };
54
+ const key = (value: string) => value.toLowerCase();
55
+ const roleKey = (persona: string, role: string) => `${key(persona)}.${key(role)}`;
56
+
57
+ function allowedModels(def: TDef): string[] {
58
+ const out: string[] = [];
59
+ if (complete) return complete["allowed-models"] ?? profileModels(complete);
60
+ for (const model of [def.model, ...(def.models || [])]) if (model && !out.includes(model)) out.push(model);
61
+ return out;
62
+ }
63
+ function substitutedModel(model: string | undefined): string | undefined {
64
+ return model ? substitutions.get(model) ?? model : undefined;
65
+ }
66
+ function resolvedModel(def: TDef): string | undefined {
67
+ return substitutedModel(personaOverrides.get(key(def.name)) ?? (complete ? agentSelection(complete,def.name).model : def.model));
68
+ }
69
+ function resolvedSubagentModel(persona: string, role: string, declared: string): string {
70
+ return substitutedModel(subagentOverrides.get(roleKey(persona, role)) ?? (complete ? childSelection(complete,persona,role).model : declared)) ?? declared;
71
+ }
72
+ function resolvedThinking(def: TDef): string | undefined {
73
+ return thinkingOverrides.get(key(def.name)) ?? (complete ? agentSelection(complete,def.name).thinking : def.thinking);
74
+ }
75
+ function switchablePersonaDef(name: string): TDef | undefined {
76
+ return ports.getActiveDef(key(name)) ?? ports.getResearchDefs().find(def => key(def.name) === key(name));
77
+ }
78
+ function allKnownModels(): string[] {
79
+ const seen = new Set<string>();
80
+ const out: string[] = [];
81
+ const add = (model: string | undefined) => { if (model && !seen.has(model)) { seen.add(model); out.push(model); } };
82
+ for (const def of ports.getAllDefs()) {
83
+ add(def.model); add(def.fallbackModel);
84
+ for (const model of def.models ?? []) add(model);
85
+ for (const role of Object.values(def.subagents ?? {})) { add(role.model); add(role.fallbackModel); }
86
+ }
87
+ for (const model of personaOverrides.values()) add(model);
88
+ for (const model of subagentOverrides.values()) add(model);
89
+ for (const source of substitutions.keys()) add(source);
90
+ if(complete) for(const model of profileModels(complete)) add(model);
91
+ return out;
92
+ }
93
+ function setPersonaOverride(name: string, model: string | undefined): void {
94
+ if (model !== undefined) assertAllowed(model);
95
+ if (model === undefined) personaOverrides.delete(key(name)); else personaOverrides.set(key(name), model);
96
+ }
97
+ function setSubagentOverride(persona: string, role: string, model: string | undefined): void {
98
+ if (model !== undefined) assertAllowed(model);
99
+ const target = roleKey(persona, role);
100
+ if (model === undefined) subagentOverrides.delete(target); else subagentOverrides.set(target, model);
101
+ }
102
+ function applyProfile(profile: ModelProfile): string[] {
103
+ if(isCompleteProfile(profile)) {
104
+ const parsed = parseCompleteProfile(profile);
105
+ const errors = validateProfile(parsed, ports.getAllDefs());
106
+ if(errors.length) throw new Error(errors.join('\n'));
107
+ if(!saved) saved=maps.map(map=>new Map(map));
108
+ for(const map of maps) map.clear();
109
+ complete=parsed;
110
+ refresh();
111
+ return ports.getAllDefs().map(def=>key(def.name));
112
+ }
113
+ if(saved) {
114
+ maps.forEach((map,i)=>{map.clear();for(const [k,v] of saved![i]) map.set(k,v);});
115
+ saved=undefined;
116
+ }
117
+ complete=undefined;
118
+ const applied: string[] = [];
119
+ for (const [persona, model] of Object.entries(profile)) {
120
+ const def = ports.getAllDefs().find(candidate => key(candidate.name) === key(persona));
121
+ if (!def) continue;
122
+ setPersonaOverride(persona, model === def.model ? undefined : model);
123
+ applied.push(persona);
124
+ }
125
+ refresh();
126
+ return applied;
127
+ }
128
+ async function applySessionSubstitution(source: string, target: string, ui: ModelSubstitutionUiPort): Promise<boolean> {
129
+ try { assertAllowed(target); } catch(error) { ui.notify(String(error), "error"); return false; }
130
+ const known = allKnownModels();
131
+ if (!known.includes(source)) { ui.notify(`Unknown configured source model "${source}". Choose one of: ${known.join(", ") || "none"}.`, "error"); return false; }
132
+ const available = await ui.loadAvailable(substitutions.get(source));
133
+ if (!available) return false;
134
+ if (!available.some(choice => choice.spec === target)) { ui.notify(`Target model "${target}" is not currently available in Pi.`, "error"); return false; }
135
+ if (source === target) { ui.notify(`Source and target are the same (${source}); the session substitution was not changed.`, "info"); return false; }
136
+ const previous = substitutions.get(source);
137
+ if (previous === target) { ui.notify(`Substitution ${source} → ${target} is already active for this session.`, "info"); return false; }
138
+ substitutions.set(source, target);
139
+ const personas = ports.getAllDefs().filter(def => (personaOverrides.get(key(def.name)) ?? def.model) === source);
140
+ const roles = ports.getAllDefs().flatMap(def => Object.entries(def.subagents ?? {}).filter(([role, config]) => (subagentOverrides.get(roleKey(def.name, role)) ?? config.model) === source));
141
+ refresh();
142
+ 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");
143
+ return true;
144
+ }
145
+ return {
146
+ allowedModels, substitutedModel, resolvedModel, resolvedSubagentModel, resolvedThinking, switchablePersonaDef, allKnownModels,
147
+ getPersonaOverride: name => personaOverrides.get(key(name)), setPersonaOverride,
148
+ getSubagentOverride: (persona, role) => subagentOverrides.get(roleKey(persona, role)), setSubagentOverride,
149
+ setThinkingOverride: (name, thinking) => { if (thinking === undefined) thinkingOverrides.delete(key(name)); else thinkingOverrides.set(key(name), thinking); },
150
+ getSubstitution: source => substitutions.get(source), substitutionEntries: () => substitutions.entries(), applyProfile, applySessionSubstitution,
151
+ reset: () => { complete=undefined; saved=undefined; personaOverrides.clear(); substitutions.clear(); subagentOverrides.clear(); thinkingOverrides.clear(); },
152
+ };
153
+ }
@@ -0,0 +1,62 @@
1
+ import { isCompleteProfile, parseCompleteProfile, profileModels, dispatcherSelection, validateProfile, type ModelProfile, type ModelSelection, type ProfileAgentDef } from '../config/model-profiles.ts';
2
+ import { setActiveProfile } from './profile-runtime.ts';
3
+ export interface ProfileActivationPorts {
4
+ busy(): boolean;
5
+ defs(): readonly ProfileAgentDef[];
6
+ available(): Promise<readonly string[]>;
7
+ dispatcher(): ModelSelection | undefined;
8
+ setDispatcher(selection: ModelSelection): Promise<boolean>;
9
+ apply(profile: ModelProfile): string[];
10
+ env?: NodeJS.ProcessEnv;
11
+ }
12
+ export function createProfileActivation(ports: ProfileActivationPorts) {
13
+ let baseline: ModelSelection | undefined;
14
+ let completeActive = false;
15
+ let switching = false;
16
+ return {
17
+ switching: () => switching,
18
+ reset() { baseline = undefined; completeActive = false; setActiveProfile(undefined, ports.env); },
19
+ async activate(name: string, input: ModelProfile): Promise<string[]> {
20
+ if (switching || ports.busy())
21
+ throw new Error('Model profile switch refused: wait for the dispatcher, agents and workflows to finish.');
22
+ switching = true;
23
+ try {
24
+ const profile = isCompleteProfile(input) ? parseCompleteProfile(input) : input;
25
+ const errors = validateProfile(profile, ports.defs());
26
+ if (errors.length)
27
+ throw new Error(errors.join('\n'));
28
+ const target = isCompleteProfile(profile) ? dispatcherSelection(profile) : completeActive ? baseline : undefined;
29
+ const available = new Set(await ports.available());
30
+ const required = [...profileModels(profile), ...(target ? [target.model] : [])];
31
+ const missing = [...new Set(required.filter(model => !available.has(model)))];
32
+ if (missing.length)
33
+ throw new Error(`Profile "${name}" not activated; models unavailable in Pi: ${missing.join(', ')}. No settings changed.`);
34
+ if (ports.busy())
35
+ throw new Error('Model profile switch refused: work started during validation.');
36
+ const previous = ports.dispatcher();
37
+ if (target) {
38
+ try {
39
+ if (!await ports.setDispatcher(target))
40
+ throw new Error(`Could not select dispatcher model ${target.model}`);
41
+ }
42
+ catch (error) {
43
+ if (previous)
44
+ await ports.setDispatcher(previous);
45
+ throw error;
46
+ }
47
+ }
48
+ if (isCompleteProfile(profile) && !completeActive)
49
+ baseline = previous;
50
+ const applied = ports.apply(profile);
51
+ completeActive = isCompleteProfile(profile);
52
+ setActiveProfile(completeActive ? { name, profile: profile as any } : undefined, ports.env);
53
+ if (!completeActive)
54
+ baseline = undefined;
55
+ return applied;
56
+ }
57
+ finally {
58
+ switching = false;
59
+ }
60
+ },
61
+ };
62
+ }
@@ -0,0 +1,64 @@
1
+ import { parseCompleteProfile, agentSelection, childSelection, serviceSelection, type CompleteModelProfile } from '../config/model-profiles.ts';
2
+ export const PROFILE_ENV = 'AGENT_FLEET_ACTIVE_MODEL_PROFILE';
3
+ export interface ActiveModelProfile {
4
+ name: string;
5
+ profile: CompleteModelProfile;
6
+ }
7
+ let activeRuns = 0;
8
+ export function profileWorkInFlight(): number { return activeRuns; }
9
+ export async function withProfileWork<T>(run: () => Promise<T>): Promise<T> { activeRuns++; try {
10
+ return await run();
11
+ }
12
+ finally {
13
+ activeRuns--;
14
+ } }
15
+ export function readActiveProfile(env: NodeJS.ProcessEnv = process.env): ActiveModelProfile | undefined {
16
+ const raw = env[PROFILE_ENV];
17
+ if (!raw)
18
+ return undefined;
19
+ try {
20
+ const value = JSON.parse(raw);
21
+ if (typeof value.name !== 'string' || !value.name)
22
+ throw new Error('missing name');
23
+ return { name: value.name, profile: parseCompleteProfile(value.profile) };
24
+ }
25
+ catch (error) {
26
+ throw new Error(`Invalid active model profile: ${error instanceof Error ? error.message : String(error)}`);
27
+ }
28
+ }
29
+ export function setActiveProfile(active: ActiveModelProfile | undefined, env: NodeJS.ProcessEnv = process.env): void {
30
+ if (active)
31
+ env[PROFILE_ENV] = JSON.stringify(active);
32
+ else
33
+ delete env[PROFILE_ENV];
34
+ }
35
+ export function assertProfileModel(model: string, active = readActiveProfile()): void {
36
+ if (active?.profile['allowed-models'] && !active.profile['allowed-models'].includes(model))
37
+ throw new Error(`Profile "${active.name}" refuses model "${model}"; allowed-models: ${active.profile['allowed-models'].join(', ')}`);
38
+ }
39
+ export function profileFallback(candidate: string | undefined, active = readActiveProfile()): string | undefined {
40
+ if (active?.profile.fallback === 'none')
41
+ return undefined;
42
+ if (candidate)
43
+ assertProfileModel(candidate, active);
44
+ return candidate;
45
+ }
46
+ export function profileAgent(name: string, active = readActiveProfile()) { return active ? agentSelection(active.profile, name) : undefined; }
47
+ export function profileChild(parent: string, role: string, active = readActiveProfile()) { return active ? childSelection(active.profile, parent, role) : undefined; }
48
+ export function profileService(service: 'watchdog' | 'return-extractor', active = readActiveProfile()) { return active ? serviceSelection(active.profile, service) : undefined; }
49
+ export function profilePanel(name: string, active = readActiveProfile()) {
50
+ if (!active)
51
+ return undefined;
52
+ if (name !== active.name)
53
+ throw new Error(`Profile "${active.name}" owns the poll/debate panel; select --panel ${active.name}.`);
54
+ const voices = active.profile.panel ?? [
55
+ { name: 'first', model: active.profile.defaults.model, integrator: true },
56
+ { name: 'second', model: active.profile.defaults.model },
57
+ ];
58
+ return voices.map(v => ({ thinking: active.profile.defaults.thinking ?? 'off', ...v }));
59
+ }
60
+ export function profilePeerRefusal() {
61
+ if (readActiveProfile()?.profile.routing !== 'native')
62
+ return null;
63
+ return { isError: true, content: [{ type: 'text' as const, text: 'Active model profile requires native agents; peer execution is disabled. Use dispatch_agent or leave this profile.' }], details: { error: 'model-profile-native' } };
64
+ }
@@ -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
+ }