@chankov/agent-fleet 2.0.5 → 2.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/.pi/harnesses/agent-hub/README.md +74 -10
  2. package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  3. package/.pi/harnesses/agent-hub/artifacts.js +1 -1
  4. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
  5. package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  6. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  7. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  8. package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  9. package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
  10. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
  11. package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
  12. package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
  13. package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
  14. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
  15. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
  16. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +22 -0
  17. package/.pi/harnesses/agent-hub/dispatch-native.ts +25 -11
  18. package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  19. package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
  20. package/.pi/harnesses/agent-hub/index.ts +79 -43
  21. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
  22. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
  23. package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
  24. package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  25. package/.pi/harnesses/agent-hub/package.json +1 -1
  26. package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
  27. package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
  28. package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
  29. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  30. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  31. package/.pi/harnesses/agent-hub/research/runtime.ts +17 -2
  32. package/.pi/harnesses/agent-hub/research/spawn-run.ts +14 -6
  33. package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
  34. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  35. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
  36. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +65 -24
  37. package/.pi/harnesses/agent-hub/types.ts +1 -0
  38. package/.pi/harnesses/agent-hub/ui/pool.ts +6 -1
  39. package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
  40. package/.pi/harnesses/ask-user-remote/README.md +8 -2
  41. package/.pi/harnesses/ask-user-remote/index.ts +40 -14
  42. package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  43. package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
  44. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  45. package/.pi/harnesses/coms/README.md +1 -1
  46. package/.pi/harnesses/coms/index.ts +7 -1
  47. package/.pi/harnesses/coms/package.json +1 -1
  48. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  49. package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
  50. package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
  51. package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  52. package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
  53. package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
  54. package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
  55. package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
  56. package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
  57. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  58. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  59. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  60. package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
  74. package/.versions/2.0.6/.pi/extensions/package.json +9 -0
  75. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
  83. package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  84. package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  85. package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
  86. package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  87. package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  88. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  89. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  90. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  91. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  92. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  93. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  94. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  95. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  96. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  97. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  98. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  99. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  100. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  101. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  102. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  103. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  104. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  105. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  106. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  107. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  108. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  109. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  110. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  111. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  112. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  113. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  114. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  115. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  116. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  117. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  118. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  119. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  120. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  121. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  122. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  123. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  124. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  125. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  126. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  127. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
  128. package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  129. package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
  130. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  131. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  132. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  133. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  134. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  135. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  136. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  137. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  138. package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  139. package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  140. package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  141. package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  142. package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  143. package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  144. package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
  145. package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
  146. package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  147. package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
  148. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  149. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  150. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  151. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  152. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  153. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  154. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  155. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  156. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  157. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  158. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  159. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  160. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  161. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  162. package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  163. package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  164. package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  165. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  166. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  167. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  168. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  169. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  170. package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  171. package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
  172. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  173. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  174. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  175. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  176. package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  177. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  178. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  179. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  180. package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  181. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
  182. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
  183. package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
  184. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
  185. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  186. package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  187. package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  188. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
  189. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
  190. package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
  191. package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
  192. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  193. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  194. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  195. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  196. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  197. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  198. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  199. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  200. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  201. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  202. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  203. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  204. package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
  205. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  206. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  207. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  208. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  209. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  210. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  211. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  212. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  213. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  214. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  215. package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
  216. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  217. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  218. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
  219. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
  220. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  221. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  222. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  223. package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
  224. package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
  225. package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
  226. package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
  227. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
  228. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  229. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  230. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
  231. package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
  232. package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
  233. package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  234. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  235. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  236. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
  237. package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
  238. package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  239. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  240. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  241. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  242. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  243. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  244. package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  245. package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  246. package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
  247. package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  248. package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
  249. package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  250. package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
  251. package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
  252. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  253. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  254. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  255. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  256. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  257. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  258. package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
  259. package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
  260. package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
  261. package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
  262. package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
  263. package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
  264. package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
  265. package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  266. package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  267. package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
  268. package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
  269. package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
  270. package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
  271. package/.versions/2.0.6/.version +1 -0
  272. package/.versions/2.0.6/agents/architect.md +25 -0
  273. package/.versions/2.0.6/agents/bowser.md +28 -0
  274. package/.versions/2.0.6/agents/builder.md +56 -0
  275. package/.versions/2.0.6/agents/code-reviewer.md +210 -0
  276. package/.versions/2.0.6/agents/deep-researcher.md +33 -0
  277. package/.versions/2.0.6/agents/documenter.md +23 -0
  278. package/.versions/2.0.6/agents/orchestrator.md +23 -0
  279. package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
  280. package/.versions/2.0.6/agents/planner.md +106 -0
  281. package/.versions/2.0.6/agents/releaser.md +25 -0
  282. package/.versions/2.0.6/agents/researcher.md +31 -0
  283. package/.versions/2.0.6/agents/security-auditor.md +168 -0
  284. package/.versions/2.0.6/agents/test-engineer.md +154 -0
  285. package/.versions/2.0.6/agents/web-debugger.md +44 -0
  286. package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
  287. package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
  288. package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
  289. package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
  290. package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
  291. package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
  292. package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
  293. package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
  294. package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
  295. package/.versions/2.0.6/docs/getting-started.md +126 -0
  296. package/.versions/2.0.6/docs/npm-install.md +301 -0
  297. package/.versions/2.0.6/docs/pi-extensions.md +446 -0
  298. package/.versions/2.0.6/docs/pi-setup.md +76 -0
  299. package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
  300. package/.versions/2.0.6/hermes/README.md +347 -0
  301. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  302. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  303. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  304. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  305. package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
  306. package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
  307. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  308. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  309. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  310. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  311. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  312. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  313. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  314. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  315. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  316. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  317. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  318. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  319. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  320. package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  321. package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  322. package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
  323. package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
  324. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  325. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  326. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  327. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  328. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  329. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  330. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  331. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  332. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  333. package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
  334. package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
  335. package/.versions/2.0.6/install-manifest.json +2924 -0
  336. package/.versions/2.0.6/justfile +247 -0
  337. package/.versions/2.0.6/manifest-meta.json +976 -0
  338. package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
  339. package/.versions/2.0.6/references/communication-contract.md +26 -0
  340. package/.versions/2.0.6/references/definition-of-done.md +67 -0
  341. package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
  342. package/.versions/2.0.6/references/observability-checklist.md +91 -0
  343. package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
  344. package/.versions/2.0.6/references/performance-checklist.md +153 -0
  345. package/.versions/2.0.6/references/prompting-patterns.md +380 -0
  346. package/.versions/2.0.6/references/security-checklist.md +179 -0
  347. package/.versions/2.0.6/references/testing-patterns.md +236 -0
  348. package/.versions/2.0.6/references/workflow-authoring.md +304 -0
  349. package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
  350. package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
  351. package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
  352. package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
  353. package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
  354. package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
  355. package/.versions/2.0.6/scripts/fleet.ts +216 -0
  356. package/.versions/2.0.6/scripts/flow.ts +137 -0
  357. package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  358. package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
  359. package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
  360. package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
  361. package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
  362. package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
  363. package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  364. package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
  365. package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
  366. package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
  367. package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
  368. package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
  369. package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
  370. package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
  371. package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
  372. package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  373. package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
  374. package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  375. package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  376. package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  377. package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  378. package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  379. package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
  380. package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
  381. package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
  382. package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
  383. package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
  384. package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
  385. package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
  386. package/.versions/2.0.6/scripts/package-lock.json +35 -0
  387. package/.versions/2.0.6/scripts/package.json +9 -0
  388. package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
  389. package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
  390. package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
  391. package/.versions/2.0.6/scripts/team-up.ts +378 -0
  392. package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
  393. package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
  394. package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
  395. package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
  396. package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
  397. package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
  398. package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
  399. package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
  400. package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
  401. package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
  402. package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
  403. package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
  404. package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
  405. package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
  406. package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
  407. package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
  408. package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
  409. package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
  410. package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
  411. package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
  412. package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
  413. package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
  414. package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
  415. package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
  416. package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
  417. package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
  418. package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
  419. package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  420. package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
  421. package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
  422. package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  423. package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
  424. package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  425. package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
  426. package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  427. package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  428. package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  429. package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
  430. package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
  431. package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
  432. package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  433. package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  434. package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
  435. package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
  436. package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
  437. package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
  438. package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
  439. package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
  440. package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
  441. package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
  442. package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
  443. package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  444. package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
  445. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  446. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  447. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  448. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  449. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  450. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  451. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  452. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  453. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  454. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  455. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  456. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  457. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  458. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  459. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  460. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  461. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  462. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  463. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  464. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  465. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  466. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  467. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  468. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  469. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  470. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  471. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  472. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  473. package/CHANGELOG.md +23 -0
  474. package/README.md +12 -14
  475. package/bin/catalog/harness-runtime-closure.json +1 -6
  476. package/bin/lib/desired.js +2 -2
  477. package/bin/lib/features.js +8 -1
  478. package/bin/snapshot-version.js +1 -2
  479. package/codex/fleet-session-client/SKILL.md +34 -0
  480. package/codex/fleet-session-client.zip +0 -0
  481. package/docs/ARCHITECTURE.md +4 -4
  482. package/docs/MIGRATION-agent-fleet.md +2 -2
  483. package/docs/assets/branding/README.md +33 -0
  484. package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
  485. package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
  486. package/docs/codex-session-bridge.md +219 -0
  487. package/docs/coms-hermes-bridge.md +4 -5
  488. package/docs/getting-started.md +2 -0
  489. package/docs/npm-install.md +3 -1
  490. package/docs/pi-setup.md +2 -0
  491. package/hermes/README.md +1 -1
  492. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
  493. package/install-manifest.json +54 -72
  494. package/justfile +0 -42
  495. package/manifest-meta.json +50 -43
  496. package/package.json +10 -7
  497. package/scripts/coms-cli.ts +2 -61
  498. package/scripts/fleet-codex-client.ts +69 -0
  499. package/scripts/fleet-codex-read.py +146 -0
  500. package/scripts/fleet.ts +0 -6
  501. package/scripts/lib/fleet-codex-catalog.ts +63 -0
  502. package/scripts/lib/fleet-codex-operations.ts +190 -0
  503. package/scripts/lib/fleet-codex-session.ts +166 -0
  504. package/scripts/lib/fleet-codex-transport.ts +124 -0
  505. package/scripts/lib/fleet-command.ts +5 -23
  506. package/scripts/lib/team-project.ts +15 -50
  507. package/scripts/team-up.ts +6 -34
  508. package/codex/CONDUCTOR.md +0 -148
  509. package/docs/codex-remote-conductor.md +0 -170
  510. package/scripts/codex-conductor.ts +0 -41
  511. package/scripts/codex-remote-control.ts +0 -167
  512. package/scripts/lib/codex-conductor.ts +0 -88
  513. package/scripts/lib/codex-remote-control.ts +0 -482
  514. package/systemd/user/agent-fleet-codex-remote-control.service.in +0 -23
@@ -4,7 +4,6 @@
4
4
  // already isolates peers by --project; this file only keeps team workspace
5
5
  // labels, snapshot files, and generated launch argv in sync with that scope.
6
6
 
7
- import * as os from "node:os";
8
7
  import * as path from "node:path";
9
8
 
10
9
  export const DEFAULT_PROJECT = "default";
@@ -14,13 +13,11 @@ export const DEFAULT_PROJECT = "default";
14
13
  // like "acme.prod", but ".." is not allowed anywhere.
15
14
  export const PROJECT_SAFE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
16
15
  export const TEAM_SAFE = /^[A-Za-z0-9_-]+$/;
17
- export const CODEX_CONTRACT_IDENTITY = "agent-fleet-codex-conductor-pilot-v1";
18
- export const DEFAULT_CODEX_TIMEOUT_MS = 300_000;
19
16
 
20
- export type ConductorBackend = "hermes" | "codex";
17
+ export type ConductorBackend = "hermes";
21
18
  // "peer" is the `just fleet peer <name>` workspace: a single pane for
22
19
  // a single peer, labelled by the PEER name where the others use a team name.
23
- export type WorkspaceMode = "peers" | "peer" | "hub" | "conductor-hermes" | "conductor-codex";
20
+ export type WorkspaceMode = "peers" | "peer" | "hub" | "conductor-hermes";
24
21
 
25
22
  export interface ConductorSpec {
26
23
  backend: ConductorBackend;
@@ -31,7 +28,7 @@ export interface ConductorSpec {
31
28
  env: Record<string, string>;
32
29
  ratio: number;
33
30
  displayText: string;
34
- expectedServiceScope: "none" | "agent-fleet-codex-remote-control.service";
31
+ expectedServiceScope: "none";
35
32
  conductorName: string;
36
33
  team: string;
37
34
  }
@@ -149,57 +146,25 @@ export function conductorCommand(): string[] {
149
146
 
150
147
  export function conductorSpec(
151
148
  backend: ConductorBackend,
152
- input: { repoRoot: string; runtimeDir?: string; team: string; project?: string; nodeBin?: string },
149
+ input: { repoRoot: string; team: string; project?: string },
153
150
  ): ConductorSpec {
154
151
  const repoRoot = validateAbsoluteRepoRoot(input.repoRoot);
155
152
  const team = validateTeamName(input.team);
156
- const project = validateProject(input.project ?? DEFAULT_PROJECT);
157
- const conductorName = `${backend}-${team}-conductor`;
158
- if (backend === "hermes") {
159
- return {
160
- backend,
161
- workspaceMode: "conductor-hermes",
162
- paneLabel: "conductor-hermes",
163
- command: conductorCommand(),
164
- cwd: repoRoot,
165
- env: {},
166
- ratio: 0.35,
167
- displayText: "Hermes conductor; no herdr control",
168
- expectedServiceScope: "none",
169
- conductorName,
170
- team,
171
- };
153
+ validateProject(input.project ?? DEFAULT_PROJECT);
154
+ if (backend !== "hermes") {
155
+ throw new Error(`Unknown conductor backend: ${JSON.stringify(backend)} (expected hermes)`);
172
156
  }
173
- const runtimeDir = input.runtimeDir ?? path.join(os.homedir(), ".local", "state", "agent-fleet", "codex-conductor");
174
- if (!path.isAbsolute(runtimeDir) || path.resolve(runtimeDir) !== runtimeDir) {
175
- throw new Error(`Codex conductor requires an absolute runtime directory: ${JSON.stringify(runtimeDir)}`);
176
- }
177
- const relativeRuntime = path.relative(repoRoot, runtimeDir);
178
- if (relativeRuntime === "" || (!relativeRuntime.startsWith("..") && !path.isAbsolute(relativeRuntime))) {
179
- throw new Error("Codex conductor requires a runtime directory outside repoRoot");
180
- }
181
- const workspaceDir = path.join(runtimeDir, "workspace");
182
- const nodeBin = input.nodeBin ?? process.execPath;
183
- if (!path.isAbsolute(nodeBin)) throw new Error(`Codex conductor requires an absolute Node binary path: ${JSON.stringify(nodeBin)}`);
184
157
  return {
185
158
  backend,
186
- workspaceMode: "conductor-codex",
187
- paneLabel: "conductor-codex-control",
188
- command: [nodeBin, "--experimental-strip-types", path.join(repoRoot, "scripts", "codex-remote-control.ts"), "control-pane"],
189
- cwd: workspaceDir,
190
- env: {
191
- AGENT_FLEET_REPO_ROOT: repoRoot,
192
- COMS_CLI_PROJECT: project,
193
- COMS_CLI_NAME: conductorName,
194
- COMS_CLI_TIMEOUT_MS: String(DEFAULT_CODEX_TIMEOUT_MS),
195
- AGENT_FLEET_CODEX_CONTRACT_PATH: path.join(workspaceDir, "AGENTS.md"),
196
- AGENT_FLEET_CODEX_CONTRACT_IDENTITY: CODEX_CONTRACT_IDENTITY,
197
- AGENT_FLEET_CONDUCTOR_BACKEND: "codex",
198
- },
159
+ workspaceMode: "conductor-hermes",
160
+ paneLabel: "conductor-hermes",
161
+ command: conductorCommand(),
162
+ cwd: repoRoot,
163
+ env: {},
199
164
  ratio: 0.35,
200
- displayText: "Codex control pane; requested systemd state only",
201
- expectedServiceScope: "agent-fleet-codex-remote-control.service",
202
- conductorName,
165
+ displayText: "Hermes conductor; no herdr control",
166
+ expectedServiceScope: "none",
167
+ conductorName: `${backend}-${team}-conductor`,
203
168
  team,
204
169
  };
205
170
  }
@@ -88,8 +88,8 @@ function parseConductorBackend(argv: string[]): ConductorBackend | null {
88
88
  if (indexes.length === 0) return null;
89
89
  const value = argv[indexes[0] + 1];
90
90
  if (!value || value.startsWith("--")) return "hermes"; // legacy bare --conductor
91
- if (value === "hermes" || value === "codex") return value;
92
- throw new Error(`Unknown conductor backend: ${JSON.stringify(value)} (expected hermes or codex)`);
91
+ if (value === "hermes") return value;
92
+ throw new Error(`Unknown conductor backend: ${JSON.stringify(value)} (expected hermes)`);
93
93
  }
94
94
 
95
95
  function loadTeam(team: string, peersYaml: string): Peer[] {
@@ -157,28 +157,6 @@ function makeDelayLoader(peers: Peer[], mode: "peers" | "hub" | "conductor"): (p
157
157
  return delayForPeer;
158
158
  }
159
159
 
160
- async function validateCodexLaunchOrDie(spec: ConductorSpec, project: string): Promise<void> {
161
- try {
162
- const { assertConductorContext, lifecyclePaths, loadOwnedConfig, preflight, requestedState } = await import("./lib/codex-remote-control.ts");
163
- const config = loadOwnedConfig(lifecyclePaths().configPath);
164
- assertConductorContext(config, {
165
- repoRoot: REPO_ROOT,
166
- project,
167
- team: spec.team,
168
- name: spec.conductorName,
169
- timeoutMs: Number(spec.env.COMS_CLI_TIMEOUT_MS),
170
- contractPath: String(spec.env.AGENT_FLEET_CODEX_CONTRACT_PATH),
171
- contractIdentity: String(spec.env.AGENT_FLEET_CODEX_CONTRACT_IDENTITY),
172
- });
173
- preflight(config);
174
- const state = requestedState();
175
- if (state.active !== "active" || state.sub !== "exited") {
176
- throw new Error(`Codex user service is not in requested active (exited) state: ${state.active} (${state.sub})`);
177
- }
178
- } catch (err) {
179
- die(`Codex launch refused before Herdr: ${err instanceof Error ? err.message : String(err)}`);
180
- }
181
- }
182
160
 
183
161
  function buildLayoutOrDie(
184
162
  team: string,
@@ -280,10 +258,8 @@ async function main(): Promise<void> {
280
258
  try {
281
259
  spec = conductor ? conductorSpec(conductor, {
282
260
  repoRoot: REPO_ROOT,
283
- runtimeDir: path.join(os.homedir(), ".local", "state", "agent-fleet", "codex-conductor"),
284
261
  team,
285
262
  project,
286
- nodeBin: process.execPath,
287
263
  }) : undefined;
288
264
  label = teamWorkspaceLabel(spec?.workspaceMode ?? (hub ? "hub" : "peers"), team, project, WORKTREE_TAG);
289
265
  } catch (err) {
@@ -319,7 +295,7 @@ async function main(): Promise<void> {
319
295
  // herdr installed, and secrets never reach the output.
320
296
  const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, true), project, rootPane);
321
297
  const projectNote = project === DEFAULT_PROJECT ? "" : `, project "${project}"`;
322
- const extra = mode === "hub" ? " + hub" : spec ? ` + ${spec.backend === "codex" ? "Codex conductor" : "Hermes conductor"}` : "";
298
+ const extra = mode === "hub" ? " + hub" : spec ? " + Hermes conductor" : "";
323
299
  console.log(
324
300
  `# team-up (dry run) — team "${team}"${projectNote}, ${peers.length} peer(s)${extra}, herdr workspace "${label}"`,
325
301
  );
@@ -332,7 +308,6 @@ async function main(): Promise<void> {
332
308
  return;
333
309
  }
334
310
 
335
- if (spec?.backend === "codex") await validateCodexLaunchOrDie(spec, project);
336
311
  const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, false), project, rootPane, makeDelayLoader(peers, mode));
337
312
 
338
313
  // Import lazily so --dry-run never touches the client (or the socket).
@@ -348,11 +323,9 @@ async function main(): Promise<void> {
348
323
  const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
349
324
  const dryCommand = mode === "hub"
350
325
  ? `just fleet team ${team} --dry-run${projectArgs}`
351
- : spec?.backend === "codex"
352
- ? `just fleet conductor codex ${team} --dry-run${projectArgs}`
353
- : mode === "conductor"
354
- ? `just fleet conductor hermes ${team} --dry-run${projectArgs}`
355
- : `just fleet team ${team} --no-hub --dry-run${projectArgs}`;
326
+ : mode === "conductor"
327
+ ? `just fleet conductor hermes ${team} --dry-run${projectArgs}`
328
+ : `just fleet team ${team} --no-hub --dry-run${projectArgs}`;
356
329
  console.error(`(dry run still works: ${dryCommand})`);
357
330
  process.exit(1);
358
331
  }
@@ -390,7 +363,6 @@ async function main(): Promise<void> {
390
363
  console.log(` • hub (${hubCommand(project, hubOptions).join(" ")} — guarded dispatcher)`);
391
364
  }
392
365
  if (spec) console.log(` • ${spec.paneLabel} (${spec.command.join(" ")} — ${spec.displayText})`);
393
- if (spec?.backend === "codex") console.log(" • Closing this workspace does not stop the enabled Codex user service; stop it explicitly.");
394
366
  for (const p of peers) console.log(` • ${p.name}`);
395
367
  console.log(`Focus: herdr workspace focus ${wsId}`);
396
368
  console.log(`Close: herdr workspace close ${wsId}`);
@@ -1,148 +0,0 @@
1
- # Agent Fleet Codex Conductor Contract
2
-
3
- **Status: experimental; verified with Codex CLI 0.144.6 on Linux.** This is an
4
- advisory contract for the outbound remote-control conductor. Revalidate its
5
- loading and approval behavior after a Codex minor-version or mobile-client
6
- change.
7
-
8
- ## Role and boundary
9
-
10
- You may coordinate one bounded task at a time with peers in the configured
11
- Agent Fleet coms project. Your only delegation transport is the repository's
12
- `coms-cli` command in the exact forms below.
13
-
14
- Codex is **outbound-only**. Hermes/Telegram remains the sole inbound
15
- `ask_user` relay. Do not implement, invoke, or imitate an inbound question
16
- channel. Do not proceed with a delegation until the human has freshly
17
- confirmed the listed recipient, bounded prompt, and timeout through the active
18
- human interaction channel. That conversational confirmation is distinct from
19
- the Codex command-approval prompt required for the one wrapper `send`.
20
-
21
- Pi damage-control wraps Pi tool calls only. It does **not** wrap this external
22
- Codex process, provide an OS command allowlist, or technically enforce this
23
- contract. Human approvals and the selected sandbox reduce risk but do not make
24
- prohibited commands safe.
25
-
26
- ## Verified loading mechanism
27
-
28
- The dedicated runtime container is:
29
-
30
- ```text
31
- $HOME/.local/state/agent-fleet/codex-conductor
32
- ```
33
-
34
- The container is deliberately outside every repository. Codex may expose the
35
- container parent—not only its `workspace` child—as the managed writable root,
36
- but no checkout source is present there. Wrapper commands must still run from
37
- the `workspace` child. The canonical repository contract lives outside the runtime
38
- container at `.pi/agent-fleet/codex/CONDUCTOR.md`. Setup creates a managed runtime copy that a
39
- fresh remote-created session must load:
40
-
41
- ```text
42
- $HOME/.local/state/agent-fleet/codex-conductor/workspace/AGENTS.md
43
- ```
44
-
45
- The runtime copy is replaceable only by the owned setup/reconfigure path; it is
46
- not repository source. `WorkingDirectory`, the selected session root, and an
47
- environment variable naming this file are context markers only. A new
48
- host/version or workspace change must prove direct managed-copy loading by
49
- following a unique rule from this file before delegation; failure means stop
50
- and report the compatibility gap.
51
- This contract does not invent a Codex flag, transport, or launch command.
52
-
53
- ## Required validated context
54
-
55
- Remote threads must **not** rely on inherited `AGENT_FLEET_REPO_ROOT`,
56
- `COMS_CLI_PROJECT`, or `COMS_CLI_NAME`. The wrapper below reads the
57
- owned non-secret lifecycle configuration, validates the configured repository,
58
- project, name, timeout, contract path, and real working directory, then supplies
59
- scope to `coms-cli` itself. It accepts no repository/project/name/timeout
60
- override. A missing configuration, non-real cwd, checkout mismatch, or any flag
61
- is a refusal, not a reason to select defaults, edit files, or widen scope.
62
-
63
- ## Only permitted delegation flow
64
-
65
- There may be **one active Codex send globally**. Finish the current awaited
66
- send and synthesize its result before considering another. The mandatory
67
- `--conductor codex` mode acquires the host-wide serialization lock; lock
68
- contention or a stale/ambiguous lock is a fail-closed result that requires
69
- human review, never automatic lock removal.
70
-
71
- 1. Remain in the dedicated `$HOME/.local/state/agent-fleet/codex-conductor/workspace` scratch directory. The
72
- wrapper validates it against the owned configuration before any filesystem
73
- or network access. Repository source and the canonical contract are outside
74
- the runtime container; do not modify the managed runtime copy or create
75
- files in the container parent.
76
- 2. Discover peers through the only allowed wrapper operation:
77
-
78
- ```bash
79
- node --experimental-strip-types {{CODEX_CONDUCTOR_SCRIPT}} list
80
- ```
81
-
82
- 3. Select only a recipient shown by that fresh command output. Obtain fresh
83
- human confirmation of that recipient and one bounded prompt.
84
- 4. Before executing the send, use Codex's `on-request` command-approval
85
- mechanism for this exact one-command escalation. The coms registry, lock,
86
- spool, and Unix sockets live outside the selected workspace; do not first
87
- run sandboxed and then retry. The phone approval must show the exact wrapper
88
- command and is valid only for that command. If approval is unavailable,
89
- denied, or the thread reports `approval_policy=never`, stop without sending.
90
- 5. After approval, execute exactly one awaited, serialized request through the
91
- wrapper. Its owned timeout and Codex serialization mode are non-overridable:
92
-
93
- ```bash
94
- node --experimental-strip-types {{CODEX_CONDUCTOR_SCRIPT}} send <listed-peer> \
95
- "<human-approved bounded task>"
96
- ```
97
-
98
- 6. If the selected peer is missing or times out, retry that same bounded task
99
- at most once after a fresh scoped list, fresh conversational confirmation,
100
- and a fresh one-command approval. Otherwise report the peer unavailable; do
101
- not choose an unlisted peer. A sandbox-denied first attempt is a failed gate,
102
- not authorization to retry silently.
103
- 7. Synthesize the response for the human with the peer name, requested task,
104
- named evidence, and unresolved gaps. A peer's unsupported prose claim is
105
- not evidence.
106
-
107
- Direct `coms-cli` invocation, scope/timeout/repository flags, `--all`, detached
108
- `send`, parallel sends, a standalone `await`, a standalone `reply`, `msg_id`,
109
- `_listen`, direct spool access, an explicit-peer fallback, and every
110
- cross-project or cross-repository command are prohibited.
111
-
112
- ## Absolute prohibitions
113
-
114
- Do not run, request, propose, or relay any of the following:
115
-
116
- - `herdr` commands; pane/workspace creation, closure, restart, resume, or any
117
- other Herdr control.
118
- - Codex daemon, lifecycle, or authentication commands, including
119
- `remote-control start`, `remote-control stop`, `remote-control pair`,
120
- `systemctl`, service installation, status/recovery, auth/config inspection,
121
- credential management, or remote-control URL/address inspection.
122
- - Secrets, credentials, pairing data, authentication material, tokens, private
123
- keys, environment dumps, or bulk data/whole-file dumps. Use bounded prompts
124
- and path references only.
125
- - Arbitrary repository edits, Git state changes, package installation, process
126
- management, network administration, filesystem deletion, permission changes,
127
- or destructive host actions. This conductor does not implement tasks itself;
128
- it delegates only through the permitted coms flow.
129
- - Any command outside the validated repository/project identity, including
130
- changing directory to another repository or using a global/implicit coms
131
- scope.
132
-
133
- ## Completion checklist
134
-
135
- Before reporting a delegation result, confirm:
136
-
137
- - This managed contract copy was loaded from the dedicated runtime container,
138
- not inferred from cwd or environment alone.
139
- - Required context was validated without exposing secrets.
140
- - A fresh scoped `list` showed the target before the one awaited send.
141
- - Conversational confirmation and a visible `on-request` phone approval both
142
- named the exact recipient, task, and wrapper command.
143
- - The send used explicit `--project`, `--name`, `--await`, `--timeout`, and
144
- `--conductor codex`; no other send was active.
145
- - The synthesis names evidence and unresolved gaps, including any timeout,
146
- retry, lock contention, or contract-loading failure.
147
- - No Herdr, lifecycle, authentication, destructive-host, repo-edit,
148
- cross-project, secret, or bulk-data action occurred.
@@ -1,170 +0,0 @@
1
- # Codex Remote-Control Conductor
2
-
3
- > **Experimental; verified with Codex CLI 0.144.6 on Linux.** The daemon is user-systemd-managed on the headless host, while manual pairing happens in the operator's interactive terminal. Revalidate the live gate after any Codex minor-version or mobile-client behavior change.
4
-
5
- The conductor is an outbound-initiated, singleton Codex remote-control service with a visible Herdr **control** pane. The pane displays user-systemd requested state; it never starts, stops, or owns the daemon. Based on the verified design boundary, closing its workspace leaves the enabled service running. The package source contract is [`../codex/CONDUCTOR.md`](../codex/CONDUCTOR.md); workspace setup installs its managed copy at `.pi/agent-fleet/codex/CONDUCTOR.md`. Hermes/Telegram remains the inbound `ask_user` route.
6
-
7
- ## Supported facts and limits
8
-
9
- - The pilot was validated with `codex-cli 0.144.6`. Public policy supports **only `0.144.x`**. Resolve the local binary with `command -v codex`; normal lifecycle state changes run a capability preflight, and `0.145.x` or later fail closed until reviewed.
10
- - The confirmed remote-control subcommands are `start`, `stop`, and `pair`.
11
- - The only approval modes are `untrusted`, `on-request`, and `never`. The only sandbox modes are `read-only`, `workspace-write`, and `danger-full-access`. **There is no `writes` mode.**
12
- - The verified posture is `on-request` with `workspace-write`. The runtime-only container is `$HOME/.local/state/agent-fleet/codex-conductor`, outside every checkout; wrapper commands execute from its `workspace` child. Codex 0.144.x/Android may expose the container parent as writable, but repository source and the managed `.pi/agent-fleet/codex/CONDUCTOR.md` remain outside it. Setup places a managed `workspace/AGENTS.md` copy inside the container. The helper requests the configured `~/.pi/coms` directory as the only extra writable root. The mobile client's managed permission profile still requires a visible one-command escalation for `send`; this approval is mandatory. A remote thread that reports `approval_policy=never` must not delegate.
13
- - Codex documents neither a foreground daemon lifecycle nor a websocket address/port. Do not configure, probe, document, or depend on a websocket port, PID, or health endpoint.
14
- - `systemd` state is not daemon health: `active (exited)` means that the requested start command succeeded, not that a paired client is usable.
15
- - Remote control is outbound-initiated and exclusive **as far as verified for this pilot**. It does not create inbound questions; use Hermes/Telegram for inbound `ask_user`.
16
-
17
- Both Codex and Hermes are external conductors. Their contracts and human approvals are advisory safeguards outside Pi's damage-control harness; Pi's guardrails and an OS command allowlist do not technically constrain either process. See [Hermes and coms](coms-hermes-bridge.md).
18
-
19
- ## Before touching the host
20
-
21
- 1. Confirm the operator accepts the singleton/global-stop limitation: `stop` can affect the remote-control daemon rather than a process systemd can prove it owns.
22
- 2. Use a Node runtime that supports `--experimental-strip-types` (Node `22.6+`) for these optional TypeScript recipes. Setup persists the exact `process.execPath` for systemd, and team-up passes the same absolute binary to the control pane.
23
- 3. Close Codex Desktop, editor-owned Codex app servers, and interactive Codex sessions for this host before starting the headless service. The remote-control host is singleton; a desktop/app-server owner can make headless `start` fail with `connection is errored`. Do not mix Mode B with the community Linux desktop workaround.
24
- 4. Set global `approval_policy = "on-request"` in `~/.codex/config.toml` after making a private backup. The Android client applies this global value to new threads and can override daemon-only config. This affects all local Codex sessions; the lifecycle preflight verifies the effective redacted `codex doctor --json` value and refuses `never`.
25
- 5. Keep pairing codes, credentials, auth files, remote-control URLs, approval transcripts, and screenshots **out of Git, documentation, plans, test fixtures, and logs**. Pairing output stays in the operator's terminal.
26
- 6. Run the non-mutating compatibility evidence. It confirms only advertised static capabilities and configured approval posture; it does not prove daemon ownership, pairing, session root, contract loading, approval delivery, or health.
27
-
28
- ```bash
29
- CODEX="$(command -v codex)"
30
- "$CODEX" --version
31
- "$CODEX" remote-control --help
32
- "$CODEX" remote-control start --help
33
- "$CODEX" remote-control stop --help
34
- "$CODEX" remote-control pair --help
35
- "$CODEX" doctor --json # redacted; preflight requires approval policy OnRequest
36
- node --experimental-strip-types scripts/codex-remote-control.ts preflight --codex-bin "$CODEX"
37
- ```
38
-
39
- **Compatibility stop condition:** if the version is not `0.144.x`, a required subcommand is absent, or `on-request` plus `workspace-write` cannot be demonstrated for this remote-control path, stop. Do not use guessed flags, a port, or a fallback launcher.
40
-
41
- The loading mechanism uses a managed runtime contract at `$HOME/.local/state/agent-fleet/codex-conductor/workspace/AGENTS.md`, copied from `.pi/agent-fleet/codex/CONDUCTOR.md` in an installed workspace (or from package-source `codex/CONDUCTOR.md` in an Agent Fleet development checkout). A fresh thread must prove that managed copy was loaded and that any mobile writable root remains inside the external user-state runtime container; cwd and environment markers alone remain insufficient.
42
-
43
- ## Lifecycle
44
-
45
- Run these recipes from the repository root. The helper rejects unsafe scope, invalid paths, unsupported Codex versions, and mismatched singleton configuration.
46
-
47
- ```bash
48
- just fleet conductor codex setup docs --project af
49
- ```
50
-
51
- The recipe resolves `codex`, the real repository root, and `$HOME/.pi/coms`, derives the isolated identity `codex-docs-conductor`, creates `$HOME/.local/state/agent-fleet/codex-conductor/workspace` outside the checkout and refreshes its owned contract copy with the absolute validated wrapper path. The lower-level `scripts/codex-remote-control.ts setup` command remains available for explicit integrations.
52
-
53
- `setup` preflights, writes non-secret owned files, reloads user systemd, and enables the service. It does **not** pair or start it. The owned paths are:
54
-
55
- - `~/.config/agent-fleet/codex-remote-control.json` (mode-restricted, non-secret configuration, including the external runtime directory)
56
- - `~/.config/systemd/user/agent-fleet-codex-remote-control.service`
57
- - `~/.local/state/agent-fleet/codex-conductor/workspace/AGENTS.md` (managed runtime copy)
58
-
59
- The unit is `Type=oneshot` with `RemainAfterExit=yes`, has no `Restart=` policy, uses the dedicated scratch directory as daemon `WorkingDirectory` (the verified mobile client broadens its managed root only to the runtime-only parent container), and runs preflight immediately before `remote-control start`. Start passes the verified `approval_policy="on-request"`, `sandbox_mode="workspace-write"`, and one `sandbox_workspace_write.writable_roots` entry for the validated coms directory. `ExecStopPost` uses the capability-checked stop path even after a failed `ExecStart`. A mobile managed profile can remain narrower, so the exact wrapper `send` must request and receive phone approval before its first execution. The unit makes no foreground, PID, port, or readiness claim.
60
-
61
- ### Pair — human interaction required
62
-
63
- Pair the mobile client manually in an interactive operator TTY, after setup. Any displayed pairing code is short-lived secret material:
64
-
65
- ```bash
66
- just fleet conductor codex pair
67
- ```
68
-
69
- Do not pipe, tee, capture, transcribe, screenshot, or commit the output. Never put pairing material or Codex credentials in the unit or config.
70
-
71
- ### Start, status, and conductor launch
72
-
73
- ```bash
74
- just fleet conductor codex start
75
- just fleet conductor codex status
76
- just fleet conductor codex docs --project af
77
- ```
78
-
79
- `status` reports only requested systemd state. Actual usability must be checked from the paired client, without inventing a network probe. The control pane similarly reports requested state only. Legacy `conductor-codex-pilot*` aliases remain available for the initial 0.144.x rollout.
80
-
81
- ### Use with `just fleet team` and Android
82
-
83
- The service does not start peers. Launch a hub/team in the exact project stored by setup:
84
-
85
- ```bash
86
- just fleet team docs --project af
87
- ```
88
-
89
- Do not also run `just fleet conductor codex docs --project af` for the same team unless a second peer set is intentional. The conductor mode is the alternative control-pane-plus-team layout when no Hub is needed.
90
-
91
- In ChatGPT Android, open the paired Remote Control host and create a fresh thread using:
92
-
93
- ```text
94
- $HOME/.local/state/agent-fleet/codex-conductor/workspace
95
- ```
96
-
97
- Do not start a local `codex` process as a substitute for the Android flow. Ask the thread to load its `AGENTS.md`, run one fresh wrapper list, and request approval once if needed. The managed contract contains the validated absolute wrapper path; do not reconstruct it or invoke `coms-cli` directly. For a send, first confirm the listed peer and exact bounded task conversationally, then approve the one displayed wrapper command. A denial stops without retry or side effect.
98
-
99
- Example read-only delegation:
100
-
101
- ```text
102
- List peers once. If researcher is visible, ask me to confirm:
103
- "Inspect the current implementation and return findings with file:line evidence; do not edit files."
104
- After confirmation, request approval for the exact wrapper send once.
105
- ```
106
-
107
- ### Stop, recovery, and reconfiguration
108
-
109
- ```bash
110
- just fleet conductor codex stop
111
- just fleet conductor codex recover
112
- ```
113
-
114
- Use recovery when the unit says `active (exited)` but the paired client is unavailable, or when an `ExecStart` failure left the unit in `failed`. It is an explicit operator-confirmed systemd stop/reset/preflight/start path, not a health probe. Plain `start` still refuses `failed` and directs the operator to recovery or uninstall. Stop and emergency stop safely clear a confirmed `failed` state; other ambiguous states refuse rather than guessing.
115
-
116
- To change the configured scope—or to upgrade an earlier in-checkout pilot runtime to the external user-state boundary—use `reconfigure` with the complete validated setup arguments, then explicitly stop/start as required. Do not edit the unit or config by hand:
117
-
118
- ```bash
119
- just fleet conductor codex reconfigure docs --project af
120
- ```
121
-
122
- ### Stale Codex send lock
123
-
124
- A crash or `SIGKILL` can leave `~/.pi/coms/locks/codex-send.lock`. Automatic removal is intentionally forbidden because removing a live lock could permit concurrent sends. When the wrapper reports a held-or-stale lock:
125
-
126
- 1. Do not retry or start another delegation.
127
- 2. Inspect the non-secret JSON metadata (`started_at`, `project`, `name`, and advisory `pid`) without copying it into repository artifacts.
128
- 3. Confirm in the mobile thread that no wrapper command is still running. A host-side `kill -0` check is insufficient because remote commands may use a different PID namespace.
129
- 4. Wait beyond the configured send timeout. If ownership remains uncertain, stop the user service and confirm that no delegation is active.
130
- 5. Only then remove that one exact lock file manually and restart/recover the service if it was stopped.
131
-
132
- Never use a wildcard cleanup or remove project spools as part of lock recovery.
133
-
134
- ### Version drift: emergency stop and uninstall
135
-
136
- If normal preflight fails after Codex version/capability drift, normal start/stop/recovery remains blocked. The only exception is an explicit emergency stop, which first proves that the currently installed CLI still advertises the exact `remote-control stop` capability:
137
-
138
- ```bash
139
- node --experimental-strip-types scripts/codex-remote-control.ts emergency-stop \
140
- --confirm emergency-stop-confirmed
141
- ```
142
-
143
- If that capability is absent, restore a supported `0.144.x` CLI before stopping or uninstalling. Never substitute a guessed stop command.
144
-
145
- Uninstall is explicit, operates only on the owned unit/config, accepts and clears a confirmed `failed` state, resets the loaded unit before deleting it, disables the service, reloads user systemd, and leaves Codex authentication and pairing state untouched:
146
-
147
- ```bash
148
- just fleet conductor codex uninstall
149
- # After version drift, use the lower-level helper only if the exact current
150
- # stop capability is proved:
151
- node --experimental-strip-types scripts/codex-remote-control.ts uninstall \
152
- --confirm operator-confirmed --emergency-confirm emergency-stop-confirmed
153
- ```
154
-
155
- Repository rollback does not stop or uninstall an already installed user service. If ownership is ambiguous, stop and review; do not remove files or use a broad manual cleanup. The scratch directory is retained if it contains operator-visible files; inspect it before removing it manually. After stopping/uninstalling the conductor, the operator may restore the private pre-change `config.toml` backup if `on-request` is not wanted for other Codex sessions.
156
-
157
- ## Verified live behavior
158
-
159
- The Linux/Android live gate passed with CLI `0.144.6`: the managed unit completed start/stop/restart, manual pairing connected the phone, a fresh mobile thread loaded the original parent contract before workspace isolation, and the wrapper listed the `af` pool despite the remote PID namespace. The human confirmed one bounded delegation and separately approved the exact elevated wrapper command; `documenter` replied `Pilot acknowledged. No files changed.` A second approval was denied, producing no researcher message and no lock. The lock was absent after completion, and closing the control workspace did not stop the service.
160
-
161
- Post-review live hardening passed on Android: because Codex 0.144.x can broaden the managed root to the runtime container parent regardless of daemon cwd, the entire container now lives under user state outside the checkout. A fresh Android thread used `$HOME/.local/state/agent-fleet/codex-conductor/workspace`, loaded its managed `AGENTS.md`, requested one approval for the rendered absolute list wrapper, listed `documenter` and `researcher`, and performed no edit or send.
162
-
163
- Remote threads use only `scripts/codex-conductor.ts` from the dedicated scratch workspace. It reads owned scope, pins the real coms directory, and refuses repository/project/name/timeout overrides. **Human interaction remains required** twice for every send: first to confirm the freshly listed recipient/task conversationally, then to approve the exact wrapper command through Codex's `on-request` approval. The command must request escalation before its first execution because coms state and Unix sockets are outside the selected workspace.
164
-
165
- ## Related documentation
166
-
167
- - [Experimental implementation plan](../plans/codex-remote-conductor.md) — gates and acceptance criteria.
168
- - [Canonical Codex conductor contract](../codex/CONDUCTOR.md) — bounded outbound delegation rules.
169
- - [Hermes/coms bridge](coms-hermes-bridge.md) — inbound human questions and Hermes conductor boundary.
170
- - [Architecture](ARCHITECTURE.md) — ownership of Pi, Herdr, coms, and external conductors.
@@ -1,41 +0,0 @@
1
- #!/usr/bin/env node
2
- // Experimental external Codex conductor wrapper. It exposes no lifecycle,
3
- // pairing, authentication, Herdr, or scope-override functionality.
4
-
5
- import { spawnSync } from "node:child_process";
6
- import * as fs from "node:fs";
7
- import * as path from "node:path";
8
- import { fileURLToPath } from "node:url";
9
-
10
- import { buildConductorCommand, conductorProcessEnv, loadConductorContext, parseConductorArgs } from "./lib/codex-conductor.ts";
11
- import { lifecyclePaths } from "./lib/codex-remote-control.ts";
12
-
13
- function main(): void {
14
- // Parse flags before config or filesystem access, then bind all scope from
15
- // the owned configuration and the dedicated writable scratch directory.
16
- const operation = parseConductorArgs(process.argv.slice(2));
17
- const checkoutRoot = fs.realpathSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."));
18
- const context = loadConductorContext({
19
- configPath: lifecyclePaths().configPath,
20
- cwd: process.cwd(),
21
- checkoutRoot,
22
- });
23
- const result = spawnSync(process.execPath, [
24
- "--experimental-strip-types",
25
- path.join(context.repoRoot, "scripts", "coms-cli.ts"),
26
- ...buildConductorCommand(context, operation),
27
- ], {
28
- cwd: context.conductorCwd,
29
- stdio: "inherit",
30
- env: conductorProcessEnv(context),
31
- });
32
- if (result.error) throw result.error;
33
- process.exitCode = result.status ?? 1;
34
- }
35
-
36
- try {
37
- main();
38
- } catch (error) {
39
- console.error(error instanceof Error ? error.message : String(error));
40
- process.exitCode = 1;
41
- }