@chankov/agent-fleet 2.0.23 → 2.1.0

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 (816) hide show
  1. package/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  2. package/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  3. package/.pi/agent-fleet/scripts/fleet.ts +3 -0
  4. package/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +122 -0
  5. package/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  6. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +349 -0
  7. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  8. package/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +72 -0
  9. package/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  10. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +53 -0
  11. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +111 -0
  12. package/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  13. package/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  14. package/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  15. package/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +384 -0
  16. package/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  17. package/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  18. package/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  19. package/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  20. package/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  21. package/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  22. package/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +81 -0
  23. package/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  24. package/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  25. package/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  26. package/.pi/agent-fleet/scripts/lib/fleet-command.ts +2 -0
  27. package/.pi/agent-fleet/scripts/package-lock.json +22 -0
  28. package/.pi/agent-fleet/scripts/package.json +1 -0
  29. package/.pi/agents/voices.yaml +1 -1
  30. package/.pi/harnesses/agent-hub/README.md +61 -4
  31. package/.pi/harnesses/agent-hub/acceptance.ts +8 -4
  32. package/.pi/harnesses/agent-hub/access-approval.ts +146 -21
  33. package/.pi/harnesses/agent-hub/assertion-ledger.js +1 -0
  34. package/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  35. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  36. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +2 -2
  37. package/.pi/harnesses/agent-hub/damage-guard-approval.ts +41 -17
  38. package/.pi/harnesses/agent-hub/damage-guard-hub.ts +16 -9
  39. package/.pi/harnesses/agent-hub/damage-guard-state.ts +2 -2
  40. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +4 -1
  41. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +4 -1
  42. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -0
  43. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +1 -1
  44. package/.pi/harnesses/agent-hub/index.ts +73 -8
  45. package/.pi/harnesses/agent-hub/input/shortcuts.ts +3 -0
  46. package/.pi/harnesses/agent-hub/no-progress.ts +3 -3
  47. package/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  48. package/.pi/harnesses/agent-hub/orchestration-activation.ts +1 -1
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  51. package/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  52. package/.pi/harnesses/agent-hub/process-obligations.ts +8 -3
  53. package/.pi/harnesses/agent-hub/prompts/fragments.ts +1 -1
  54. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  55. package/.pi/harnesses/agent-hub/return-contract.js +24 -2
  56. package/.pi/harnesses/agent-hub/review-reuse.ts +3 -3
  57. package/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  58. package/.pi/harnesses/agent-hub/runtime-receipts.ts +60 -0
  59. package/.pi/harnesses/agent-hub/runtime-test-check.ts +11 -0
  60. package/.pi/harnesses/agent-hub/spawn.ts +50 -13
  61. package/.pi/harnesses/agent-hub/specialist-result.ts +15 -6
  62. package/.pi/harnesses/agent-hub/system1-communication-store.ts +8 -0
  63. package/.pi/harnesses/agent-hub/task-resume-contract.ts +5 -0
  64. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +36 -17
  65. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +4 -4
  66. package/.pi/harnesses/agent-hub/tools/context.ts +2 -1
  67. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +2 -0
  68. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +133 -40
  69. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +1 -0
  70. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +3 -1
  71. package/.pi/harnesses/agent-hub/work-mode.ts +3 -1
  72. package/.pi/harnesses/ask-user-remote/README.md +2 -2
  73. package/.pi/harnesses/ask-user-remote/questions.ts +49 -2
  74. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +13 -6
  75. package/.pi/harnesses/coms/README.md +5 -0
  76. package/.pi/harnesses/coms/index.ts +25 -2
  77. package/.pi/harnesses/coms/package.json +1 -1
  78. package/.pi/harnesses/damage-control-continue/index.ts +69 -31
  79. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  80. package/.pi/harnesses/lib/bash-policy-analysis.ts +1 -1
  81. package/.pi/harnesses/lib/coms-core-io.ts +8 -1
  82. package/.pi/harnesses/lib/coms-core.ts +42 -8
  83. package/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  84. package/.pi/harnesses/lib/coms-observation.ts +74 -0
  85. package/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  86. package/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  87. package/.pi/harnesses/lib/damage-control-shared.ts +46 -15
  88. package/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  89. package/.pi/harnesses/lib/fleet-codex-event-bridge.ts +81 -0
  90. package/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  91. package/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  92. package/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  93. package/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  94. package/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  95. package/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  96. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  97. package/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  98. package/.pi/harnesses/lib/update-check.ts +5 -0
  99. package/.versions/2.1.0/.pi/agent-fleet/hermes/README.md +347 -0
  100. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  101. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  102. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  103. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  104. package/.versions/2.1.0/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  105. package/.versions/2.1.0/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  106. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  107. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  108. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  109. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  110. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  111. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  112. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  113. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  114. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  115. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  116. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  117. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  118. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  119. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  120. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  121. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  122. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  123. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  124. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  125. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  126. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  127. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  128. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  129. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  130. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  131. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  132. package/.versions/2.1.0/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  133. package/.versions/2.1.0/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  134. package/.versions/2.1.0/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  135. package/.versions/2.1.0/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  136. package/.versions/2.1.0/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  137. package/.versions/2.1.0/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  138. package/.versions/2.1.0/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  139. package/.versions/2.1.0/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  140. package/.versions/2.1.0/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  141. package/.versions/2.1.0/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  142. package/.versions/2.1.0/.pi/agent-fleet/scripts/fleet.ts +248 -0
  143. package/.versions/2.1.0/.pi/agent-fleet/scripts/flow.ts +166 -0
  144. package/.versions/2.1.0/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  145. package/.versions/2.1.0/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  146. package/.versions/2.1.0/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  147. package/.versions/2.1.0/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  148. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  149. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +122 -0
  150. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  151. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  152. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  153. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +349 -0
  154. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  155. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +72 -0
  156. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  157. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +53 -0
  158. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +111 -0
  159. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  160. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  161. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  162. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +384 -0
  163. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  164. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  165. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  166. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  167. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  168. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  169. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +81 -0
  170. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  171. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  172. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  173. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-command.ts +268 -0
  174. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  175. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +238 -0
  176. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  177. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  178. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  179. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  180. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  181. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  182. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  183. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  184. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  185. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  186. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  187. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  188. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  189. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  190. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  191. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  192. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  193. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  194. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  195. package/.versions/2.1.0/.pi/agent-fleet/scripts/package-lock.json +57 -0
  196. package/.versions/2.1.0/.pi/agent-fleet/scripts/package.json +10 -0
  197. package/.versions/2.1.0/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  198. package/.versions/2.1.0/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  199. package/.versions/2.1.0/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  200. package/.versions/2.1.0/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  201. package/.versions/2.1.0/.pi/agent-fleet/scripts/team-up.ts +385 -0
  202. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  203. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  204. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  205. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  206. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  207. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  208. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/git.ts +99 -0
  209. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  210. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  211. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  212. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  213. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  214. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  215. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  216. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  217. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/quality.ts +65 -0
  218. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  219. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  220. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  221. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  222. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  223. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  224. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  225. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  226. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  227. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  228. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  229. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  230. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  231. package/.versions/2.1.0/.pi/agents/dispatch-policy.yaml +32 -0
  232. package/.versions/2.1.0/.pi/agents/model-profiles.yaml +134 -0
  233. package/.versions/2.1.0/.pi/agents/peers.yaml +147 -0
  234. package/.versions/2.1.0/.pi/agents/teams.yaml +41 -0
  235. package/.versions/2.1.0/.pi/agents/voices.yaml +13 -0
  236. package/.versions/2.1.0/.pi/damage-control-rules.yaml +297 -0
  237. package/.versions/2.1.0/.pi/extensions/btw/README.md +120 -0
  238. package/.versions/2.1.0/.pi/extensions/btw/index.ts +916 -0
  239. package/.versions/2.1.0/.pi/extensions/btw/package.json +6 -0
  240. package/.versions/2.1.0/.pi/extensions/btw/state.js +179 -0
  241. package/.versions/2.1.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  242. package/.versions/2.1.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  243. package/.versions/2.1.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  244. package/.versions/2.1.0/.pi/extensions/compact-and-continue/README.md +42 -0
  245. package/.versions/2.1.0/.pi/extensions/compact-and-continue/index.ts +136 -0
  246. package/.versions/2.1.0/.pi/extensions/compact-and-continue/package.json +6 -0
  247. package/.versions/2.1.0/.pi/extensions/mcp-bridge/README.md +46 -0
  248. package/.versions/2.1.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  249. package/.versions/2.1.0/.pi/extensions/mcp-bridge/package.json +6 -0
  250. package/.versions/2.1.0/.pi/extensions/package-lock.json +1175 -0
  251. package/.versions/2.1.0/.pi/extensions/package.json +9 -0
  252. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/README.md +224 -0
  253. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/config.ts +199 -0
  254. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  255. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  256. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  257. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  258. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  259. package/.versions/2.1.0/.pi/harnesses/agent-hub/README.md +1584 -0
  260. package/.versions/2.1.0/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  261. package/.versions/2.1.0/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  262. package/.versions/2.1.0/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  263. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  264. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  265. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  266. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  267. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  268. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  269. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  270. package/.versions/2.1.0/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  271. package/.versions/2.1.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  272. package/.versions/2.1.0/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  273. package/.versions/2.1.0/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  274. package/.versions/2.1.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  275. package/.versions/2.1.0/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  276. package/.versions/2.1.0/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  277. package/.versions/2.1.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  278. package/.versions/2.1.0/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  279. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  280. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  281. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  282. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  283. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  284. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  285. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  286. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  287. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  288. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  289. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  290. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  291. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  292. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  293. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  294. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  295. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  296. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  297. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  298. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  299. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  300. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  301. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  302. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  303. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  304. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  305. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  306. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  307. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  308. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  309. package/.versions/2.1.0/.pi/harnesses/agent-hub/config/agents.ts +181 -0
  310. package/.versions/2.1.0/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  311. package/.versions/2.1.0/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  312. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  313. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  314. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  315. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  316. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  317. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  318. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  319. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  320. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  321. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  322. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  323. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  324. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  325. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  326. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  327. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  328. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  329. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-window.js +108 -0
  330. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  331. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  332. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  333. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  334. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  335. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  336. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  337. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  338. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  339. package/.versions/2.1.0/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  340. package/.versions/2.1.0/.pi/harnesses/agent-hub/delegate.ts +478 -0
  341. package/.versions/2.1.0/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  342. package/.versions/2.1.0/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  343. package/.versions/2.1.0/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  344. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  345. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  346. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  347. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +298 -0
  348. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +260 -0
  349. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  350. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  351. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  352. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  353. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  354. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  355. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  356. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  357. package/.versions/2.1.0/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  358. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  359. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  360. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  361. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  362. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  363. package/.versions/2.1.0/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  364. package/.versions/2.1.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  365. package/.versions/2.1.0/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  366. package/.versions/2.1.0/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  367. package/.versions/2.1.0/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  368. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  369. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  370. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  371. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  372. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  373. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  374. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  375. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  376. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  377. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  378. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  379. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  380. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  381. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  382. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  383. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  384. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  385. package/.versions/2.1.0/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  386. package/.versions/2.1.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  387. package/.versions/2.1.0/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  388. package/.versions/2.1.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  389. package/.versions/2.1.0/.pi/harnesses/agent-hub/helpers.ts +270 -0
  390. package/.versions/2.1.0/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  391. package/.versions/2.1.0/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  392. package/.versions/2.1.0/.pi/harnesses/agent-hub/index.ts +2682 -0
  393. package/.versions/2.1.0/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  394. package/.versions/2.1.0/.pi/harnesses/agent-hub/input/shortcuts.ts +23 -0
  395. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  396. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  397. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +145 -0
  398. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  399. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  400. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  401. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  402. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  403. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  404. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  405. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  406. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  407. package/.versions/2.1.0/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  408. package/.versions/2.1.0/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  409. package/.versions/2.1.0/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  410. package/.versions/2.1.0/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  411. package/.versions/2.1.0/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  412. package/.versions/2.1.0/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  413. package/.versions/2.1.0/.pi/harnesses/agent-hub/package.json +7 -0
  414. package/.versions/2.1.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  415. package/.versions/2.1.0/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  416. package/.versions/2.1.0/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  417. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  418. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  419. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  420. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  421. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  422. package/.versions/2.1.0/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  423. package/.versions/2.1.0/.pi/harnesses/agent-hub/presentation.ts +54 -0
  424. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  425. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  426. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  427. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  428. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  429. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  430. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  431. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  432. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  433. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  434. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  435. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  436. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-snapshot.ts +279 -0
  437. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  438. package/.versions/2.1.0/.pi/harnesses/agent-hub/process-obligations.ts +164 -0
  439. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  440. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  441. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  442. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  443. package/.versions/2.1.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  444. package/.versions/2.1.0/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  445. package/.versions/2.1.0/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  446. package/.versions/2.1.0/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  447. package/.versions/2.1.0/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  448. package/.versions/2.1.0/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  449. package/.versions/2.1.0/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  450. package/.versions/2.1.0/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  451. package/.versions/2.1.0/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  452. package/.versions/2.1.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  453. package/.versions/2.1.0/.pi/harnesses/agent-hub/return-contract.js +371 -0
  454. package/.versions/2.1.0/.pi/harnesses/agent-hub/return-extract.js +77 -0
  455. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  456. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  457. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-findings.js +96 -0
  458. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  459. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  460. package/.versions/2.1.0/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  461. package/.versions/2.1.0/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  462. package/.versions/2.1.0/.pi/harnesses/agent-hub/run-budget.js +342 -0
  463. package/.versions/2.1.0/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  464. package/.versions/2.1.0/.pi/harnesses/agent-hub/runtime-receipts.ts +60 -0
  465. package/.versions/2.1.0/.pi/harnesses/agent-hub/runtime-test-check.ts +79 -0
  466. package/.versions/2.1.0/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  467. package/.versions/2.1.0/.pi/harnesses/agent-hub/scope-gate.js +233 -0
  468. package/.versions/2.1.0/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  469. package/.versions/2.1.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  470. package/.versions/2.1.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  471. package/.versions/2.1.0/.pi/harnesses/agent-hub/spawn.ts +702 -0
  472. package/.versions/2.1.0/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  473. package/.versions/2.1.0/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  474. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  475. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  476. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  477. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  478. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  479. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-resume-contract.ts +75 -0
  480. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  481. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  482. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  483. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  484. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  485. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  486. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  487. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  488. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  489. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  490. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  491. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  492. package/.versions/2.1.0/.pi/harnesses/agent-hub/timeline.ts +72 -0
  493. package/.versions/2.1.0/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  494. package/.versions/2.1.0/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  495. package/.versions/2.1.0/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  496. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  497. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  498. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  499. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  500. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/context.ts +145 -0
  501. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +90 -0
  502. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +734 -0
  503. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  504. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  505. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  506. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  507. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/run-flow.ts +146 -0
  508. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  509. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  510. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  511. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  512. package/.versions/2.1.0/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  513. package/.versions/2.1.0/.pi/harnesses/agent-hub/types.ts +66 -0
  514. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  515. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  516. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  517. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  518. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +157 -0
  519. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  520. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  521. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  522. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  523. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  524. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  525. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  526. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  527. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  528. package/.versions/2.1.0/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  529. package/.versions/2.1.0/.pi/harnesses/agent-hub/version.ts +42 -0
  530. package/.versions/2.1.0/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  531. package/.versions/2.1.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  532. package/.versions/2.1.0/.pi/harnesses/agent-hub/work-mode.ts +188 -0
  533. package/.versions/2.1.0/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  534. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/README.md +59 -0
  535. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/index.ts +571 -0
  536. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  537. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  538. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  539. package/.versions/2.1.0/.pi/harnesses/coms/README.md +105 -0
  540. package/.versions/2.1.0/.pi/harnesses/coms/index.ts +308 -0
  541. package/.versions/2.1.0/.pi/harnesses/coms/package.json +7 -0
  542. package/.versions/2.1.0/.pi/harnesses/coms/version.ts +42 -0
  543. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/README.md +161 -0
  544. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/index.ts +659 -0
  545. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  546. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  547. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  548. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  549. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  550. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  551. package/.versions/2.1.0/.pi/harnesses/lib/approval-wait.ts +17 -0
  552. package/.versions/2.1.0/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  553. package/.versions/2.1.0/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  554. package/.versions/2.1.0/.pi/harnesses/lib/clarification-policy.ts +9 -0
  555. package/.versions/2.1.0/.pi/harnesses/lib/coms-core-io.ts +422 -0
  556. package/.versions/2.1.0/.pi/harnesses/lib/coms-core.ts +720 -0
  557. package/.versions/2.1.0/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  558. package/.versions/2.1.0/.pi/harnesses/lib/coms-observation.ts +74 -0
  559. package/.versions/2.1.0/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  560. package/.versions/2.1.0/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  561. package/.versions/2.1.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  562. package/.versions/2.1.0/.pi/harnesses/lib/context-budget-view.ts +112 -0
  563. package/.versions/2.1.0/.pi/harnesses/lib/context-budget.ts +114 -0
  564. package/.versions/2.1.0/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  565. package/.versions/2.1.0/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  566. package/.versions/2.1.0/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  567. package/.versions/2.1.0/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  568. package/.versions/2.1.0/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  569. package/.versions/2.1.0/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  570. package/.versions/2.1.0/.pi/harnesses/lib/damage-policy.ts +35 -0
  571. package/.versions/2.1.0/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  572. package/.versions/2.1.0/.pi/harnesses/lib/damage-result-view.ts +16 -0
  573. package/.versions/2.1.0/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  574. package/.versions/2.1.0/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  575. package/.versions/2.1.0/.pi/harnesses/lib/execution-trace.ts +45 -0
  576. package/.versions/2.1.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  577. package/.versions/2.1.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  578. package/.versions/2.1.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  579. package/.versions/2.1.0/.pi/harnesses/lib/fleet-codex-event-bridge.ts +81 -0
  580. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  581. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  582. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  583. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  584. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  585. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  586. package/.versions/2.1.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  587. package/.versions/2.1.0/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  588. package/.versions/2.1.0/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  589. package/.versions/2.1.0/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  590. package/.versions/2.1.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  591. package/.versions/2.1.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  592. package/.versions/2.1.0/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  593. package/.versions/2.1.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  594. package/.versions/2.1.0/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  595. package/.versions/2.1.0/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  596. package/.versions/2.1.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  597. package/.versions/2.1.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  598. package/.versions/2.1.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  599. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  600. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  601. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  602. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  603. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  604. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  605. package/.versions/2.1.0/.pi/harnesses/lib/identical-dialog.ts +27 -0
  606. package/.versions/2.1.0/.pi/harnesses/lib/installation-state.js +62 -0
  607. package/.versions/2.1.0/.pi/harnesses/lib/peer-target.ts +24 -0
  608. package/.versions/2.1.0/.pi/harnesses/lib/policy-roots.js +117 -0
  609. package/.versions/2.1.0/.pi/harnesses/lib/policy-roots.ts +32 -0
  610. package/.versions/2.1.0/.pi/harnesses/lib/process-shared.ts +9 -0
  611. package/.versions/2.1.0/.pi/harnesses/lib/resource-closure.js +26 -0
  612. package/.versions/2.1.0/.pi/harnesses/lib/safe-source-read.js +29 -0
  613. package/.versions/2.1.0/.pi/harnesses/lib/semantic-approval.ts +80 -0
  614. package/.versions/2.1.0/.pi/harnesses/lib/session-target.ts +62 -0
  615. package/.versions/2.1.0/.pi/harnesses/lib/spawned-peers.js +191 -0
  616. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  617. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  618. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  619. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  620. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-json.js +37 -0
  621. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-loader.js +53 -0
  622. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  623. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-triage.js +42 -0
  624. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-v2.js +112 -0
  625. package/.versions/2.1.0/.pi/harnesses/lib/system1/config.js +50 -0
  626. package/.versions/2.1.0/.pi/harnesses/lib/system1/contracts.ts +154 -0
  627. package/.versions/2.1.0/.pi/harnesses/lib/system1/demo.ts +95 -0
  628. package/.versions/2.1.0/.pi/harnesses/lib/system1/jev.ts +503 -0
  629. package/.versions/2.1.0/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  630. package/.versions/2.1.0/.pi/harnesses/lib/system1/selection.js +11 -0
  631. package/.versions/2.1.0/.pi/harnesses/lib/system1/service.ts +245 -0
  632. package/.versions/2.1.0/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  633. package/.versions/2.1.0/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  634. package/.versions/2.1.0/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  635. package/.versions/2.1.0/.pi/harnesses/lib/target-capabilities.js +7 -0
  636. package/.versions/2.1.0/.pi/harnesses/lib/update-check.ts +227 -0
  637. package/.versions/2.1.0/.pi/harnesses/lib/workspace-context.js +115 -0
  638. package/.versions/2.1.0/.pi/harnesses/lib/workspace-context.ts +22 -0
  639. package/.versions/2.1.0/.pi/harnesses/package-lock.json +2121 -0
  640. package/.versions/2.1.0/.pi/harnesses/package.json +13 -0
  641. package/.versions/2.1.0/.pi/prompts/af-build.md +27 -0
  642. package/.versions/2.1.0/.pi/prompts/af-code-simplify.md +22 -0
  643. package/.versions/2.1.0/.pi/prompts/af-constraints.md +31 -0
  644. package/.versions/2.1.0/.pi/prompts/af-plan.md +17 -0
  645. package/.versions/2.1.0/.pi/prompts/af-review.md +16 -0
  646. package/.versions/2.1.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  647. package/.versions/2.1.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  648. package/.versions/2.1.0/.pi/prompts/af-setup-rules.md +20 -0
  649. package/.versions/2.1.0/.pi/prompts/af-ship.md +17 -0
  650. package/.versions/2.1.0/.pi/prompts/af-spec.md +15 -0
  651. package/.versions/2.1.0/.pi/prompts/af-test.md +19 -0
  652. package/.versions/2.1.0/.pi/skills/bowser/SKILL.md +145 -0
  653. package/.versions/2.1.0/.version +1 -0
  654. package/.versions/2.1.0/agents/architect.md +24 -0
  655. package/.versions/2.1.0/agents/bowser.md +28 -0
  656. package/.versions/2.1.0/agents/builder.md +55 -0
  657. package/.versions/2.1.0/agents/code-reviewer.md +209 -0
  658. package/.versions/2.1.0/agents/deep-researcher.md +32 -0
  659. package/.versions/2.1.0/agents/documenter.md +22 -0
  660. package/.versions/2.1.0/agents/orchestrator.md +22 -0
  661. package/.versions/2.1.0/agents/plan-reviewer.md +83 -0
  662. package/.versions/2.1.0/agents/planner.md +107 -0
  663. package/.versions/2.1.0/agents/releaser.md +24 -0
  664. package/.versions/2.1.0/agents/researcher.md +30 -0
  665. package/.versions/2.1.0/agents/security-auditor.md +167 -0
  666. package/.versions/2.1.0/agents/test-engineer.md +153 -0
  667. package/.versions/2.1.0/agents/web-debugger.md +44 -0
  668. package/.versions/2.1.0/agents/web-performance-auditor.md +194 -0
  669. package/.versions/2.1.0/bin/catalog/harness-runtime-closure.json +85 -0
  670. package/.versions/2.1.0/docs/ARCHITECTURE.md +1158 -0
  671. package/.versions/2.1.0/docs/agent-fleet-setup.md +1143 -0
  672. package/.versions/2.1.0/docs/claude-code-coms-bridge.md +147 -0
  673. package/.versions/2.1.0/docs/codex-local-mcp.md +434 -0
  674. package/.versions/2.1.0/docs/codex-session-bridge.md +44 -0
  675. package/.versions/2.1.0/docs/codex-setup.md +183 -0
  676. package/.versions/2.1.0/docs/coms-hermes-bridge.md +188 -0
  677. package/.versions/2.1.0/docs/fleet-native-voice.md +135 -0
  678. package/.versions/2.1.0/docs/getting-started.md +126 -0
  679. package/.versions/2.1.0/docs/npm-install.md +535 -0
  680. package/.versions/2.1.0/docs/pi-extensions.md +455 -0
  681. package/.versions/2.1.0/docs/pi-setup.md +92 -0
  682. package/.versions/2.1.0/docs/skill-anatomy.md +150 -0
  683. package/.versions/2.1.0/install-manifest.json +3216 -0
  684. package/.versions/2.1.0/justfile +247 -0
  685. package/.versions/2.1.0/manifest-meta.json +1086 -0
  686. package/.versions/2.1.0/references/accessibility-checklist.md +160 -0
  687. package/.versions/2.1.0/references/communication-contract.md +26 -0
  688. package/.versions/2.1.0/references/definition-of-done.md +67 -0
  689. package/.versions/2.1.0/references/fleet-coordination-patterns.md +171 -0
  690. package/.versions/2.1.0/references/observability-checklist.md +92 -0
  691. package/.versions/2.1.0/references/orchestration-patterns.md +370 -0
  692. package/.versions/2.1.0/references/performance-checklist.md +236 -0
  693. package/.versions/2.1.0/references/prompting-patterns.md +380 -0
  694. package/.versions/2.1.0/references/security-checklist.md +245 -0
  695. package/.versions/2.1.0/references/testing-patterns.md +235 -0
  696. package/.versions/2.1.0/references/workflow-authoring.md +304 -0
  697. package/.versions/2.1.0/skills/_internal/grilling.md +59 -0
  698. package/.versions/2.1.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  699. package/.versions/2.1.0/skills/code-review-and-quality/SKILL.md +396 -0
  700. package/.versions/2.1.0/skills/compound-learning/SKILL.md +137 -0
  701. package/.versions/2.1.0/skills/constraint-driven-development/SKILL.md +338 -0
  702. package/.versions/2.1.0/skills/constraint-driven-development/references/floor-guard.md +99 -0
  703. package/.versions/2.1.0/skills/context-engineering/SKILL.md +341 -0
  704. package/.versions/2.1.0/skills/deprecation-and-migration/SKILL.md +247 -0
  705. package/.versions/2.1.0/skills/designing-agents/SKILL.md +394 -0
  706. package/.versions/2.1.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  707. package/.versions/2.1.0/skills/drafting-workflows/SKILL.md +143 -0
  708. package/.versions/2.1.0/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  709. package/.versions/2.1.0/skills/fleet-native-voice/SKILL.md +73 -0
  710. package/.versions/2.1.0/skills/fleet-native-voice/agents/openai.yaml +4 -0
  711. package/.versions/2.1.0/skills/fleet-native-voice.zip +0 -0
  712. package/.versions/2.1.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  713. package/.versions/2.1.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  714. package/.versions/2.1.0/skills/idea-refine/SKILL.md +182 -0
  715. package/.versions/2.1.0/skills/idea-refine/examples.md +238 -0
  716. package/.versions/2.1.0/skills/idea-refine/frameworks.md +99 -0
  717. package/.versions/2.1.0/skills/idea-refine/refinement-criteria.md +113 -0
  718. package/.versions/2.1.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  719. package/.versions/2.1.0/skills/incremental-implementation/SKILL.md +353 -0
  720. package/.versions/2.1.0/skills/incremental-implementation.zip +0 -0
  721. package/.versions/2.1.0/skills/interview-me/SKILL.md +226 -0
  722. package/.versions/2.1.0/skills/orchestration-verification/SKILL.md +182 -0
  723. package/.versions/2.1.0/skills/peer-coms/SKILL.md +90 -0
  724. package/.versions/2.1.0/skills/performance-optimization/SKILL.md +496 -0
  725. package/.versions/2.1.0/skills/planning-and-task-breakdown/SKILL.md +318 -0
  726. package/.versions/2.1.0/skills/planning-and-task-breakdown.zip +0 -0
  727. package/.versions/2.1.0/skills/repository-ai-setup/SKILL.md +135 -0
  728. package/.versions/2.1.0/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  729. package/.versions/2.1.0/skills/repository-ai-setup/references/apply-contract.md +74 -0
  730. package/.versions/2.1.0/skills/repository-ai-setup/references/provenance-template.md +16 -0
  731. package/.versions/2.1.0/skills/repository-ai-setup/references/setup-flow.md +108 -0
  732. package/.versions/2.1.0/skills/repository-ai-setup/references/verify-setup.md +20 -0
  733. package/.versions/2.1.0/skills/repository-ai-setup.zip +0 -0
  734. package/.versions/2.1.0/skills/security-and-hardening/SKILL.md +524 -0
  735. package/.versions/2.1.0/skills/spec-driven-development/SKILL.md +295 -0
  736. package/.versions/2.1.0/skills/spec-driven-development.zip +0 -0
  737. package/.versions/2.1.0/skills/using-agent-skills/SKILL.md +198 -0
  738. package/.versions/2.1.0/vendor/agent-skills-upstream/LICENSE +21 -0
  739. package/.versions/2.1.0/vendor/agent-skills-upstream/README.md +430 -0
  740. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  741. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  742. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  743. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  744. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  745. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  746. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  747. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  748. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  749. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  750. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  751. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  752. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  753. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  754. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  755. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  756. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  757. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  758. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  759. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  760. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  761. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  762. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  763. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  764. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  765. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  766. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  767. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  768. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  769. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  770. package/CHANGELOG.md +21 -5
  771. package/README.md +12 -11
  772. package/agents/architect.md +1 -1
  773. package/agents/bowser.md +1 -1
  774. package/agents/builder.md +1 -1
  775. package/agents/code-reviewer.md +1 -1
  776. package/agents/plan-reviewer.md +1 -1
  777. package/agents/planner.md +1 -1
  778. package/agents/test-engineer.md +1 -1
  779. package/agents/web-debugger.md +1 -1
  780. package/agents/web-performance-auditor.md +1 -1
  781. package/bin/cli.js +115 -1
  782. package/bin/lib/apply.js +8 -1
  783. package/bin/lib/features.js +4 -1
  784. package/bin/lib/hermes-profile-artifact.js +21 -10
  785. package/bin/lib/inspect.js +103 -0
  786. package/bin/lib/mcp-probe.js +104 -0
  787. package/bin/lib/public-plan.js +2 -0
  788. package/bin/lib/repair-desired.js +1 -1
  789. package/bin/lib/set-codex-mcp.js +699 -0
  790. package/bin/lib/skill-zip.js +222 -0
  791. package/bin/snapshot-version.js +3 -1
  792. package/docs/ARCHITECTURE.md +147 -12
  793. package/docs/MIGRATION-agent-fleet.md +2 -2
  794. package/docs/agent-fleet-setup.md +39 -2
  795. package/docs/codex-local-mcp.md +434 -0
  796. package/docs/codex-session-bridge.md +28 -203
  797. package/docs/codex-setup.md +183 -0
  798. package/docs/fleet-native-voice.md +135 -0
  799. package/docs/npm-install.md +2 -2
  800. package/docs/session-worktree-targeting.md +79 -79
  801. package/docs/system1-agentic.md +1 -1
  802. package/docs/workflows.md +2 -2
  803. package/install-manifest.json +31 -66
  804. package/manifest-meta.json +47 -57
  805. package/package.json +12 -7
  806. package/skills/fleet-native-voice.zip +0 -0
  807. package/skills/incremental-implementation/SKILL.md +1 -1
  808. package/skills/incremental-implementation.zip +0 -0
  809. package/.pi/agent-fleet/scripts/fleet-codex-client.ts +0 -69
  810. package/.pi/agent-fleet/scripts/fleet-codex-read.py +0 -148
  811. package/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +0 -63
  812. package/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +0 -190
  813. package/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +0 -166
  814. package/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +0 -124
  815. package/codex/fleet-session-client/SKILL.md +0 -34
  816. package/codex/fleet-session-client.zip +0 -0
@@ -0,0 +1,147 @@
1
+ # Claude Code as a coms peer — the bridge
2
+
3
+ Makes an interactive Claude Code (terminal CLI) a **first-class, bidirectional peer** in
4
+ the local coms pool: pi agents reach it with plain `coms_send`/`coms_await`, and Claude
5
+ Code itself asks pi peers questions mid-task via `coms-cli`. Requires a running
6
+ [herdr](https://herdr.dev) server (the bridge drives the Claude pane through herdr's
7
+ socket API).
8
+
9
+ > **This is the only role Claude Code has in Agent Fleet.** It is not a coding-agent
10
+ > install target: deterministic `agent-fleet setup` targets pi and nothing else, there are no
11
+ > `.claude/` skills, commands, or personas, and no Claude Code plugin. What a bridged
12
+ > pane gets is what this page describes — the `peer-coms` skill and the Stop hook,
13
+ > both installed under the pi agent because the *fleet* is what needs them. A Claude
14
+ > Code peer contributes review, research, and analysis turns over coms; it does not run
15
+ > the lifecycle commands or orchestrate anything.
16
+
17
+ ```
18
+ pi hub ── coms envelope ──▶ coms-claude-bridge ── pane.send_text ──▶ Claude Code (pane)
19
+ pi hub ◀── response ─────── coms-claude-bridge ◀── Stop hook file ─── (turn ends)
20
+ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (outbound asks)
21
+ ```
22
+
23
+ ## Pieces
24
+
25
+ | Piece | File | Role |
26
+ |---|---|---|
27
+ | Bridge daemon | `.pi/agent-fleet/scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
28
+ | Envelope CLI | `.pi/agent-fleet/scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
29
+ | Stop hook | `.pi/agent-fleet/hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
30
+ | Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
31
+ | Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just fleet team` spawns the Claude CLI + its bridge in one pane (`_claude-peer` internally); `model:` maps to `claude --model`, and `just fleet resume` maps the Herdr-captured session id to `claude --resume`. |
32
+
33
+ ## Setup
34
+
35
+ The stable `claude-bridge` setup feature selects `peer-coms` and its
36
+ `coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
37
+ claude-bridge --yes` (or select it interactively); it puts both halves in place:
38
+ `.pi/skills/peer-coms/` and `.pi/agent-fleet/hooks/coms-stop-hook.mjs`. The hook ships with
39
+ the rest of the fleet runtime; Claude Code reaches it through `.claude/settings.json`,
40
+ which is the one place it looks for hooks.
41
+
42
+ **Registering the hook stays a manual step.** The installer writes the file; it does not
43
+ touch `.claude/settings.json`, because that file is the user's own Claude Code
44
+ configuration and merging into it is not something a pi install should decide.
45
+
46
+ 1. **Hook (recommended):** add to the project's (or user's) Claude Code `settings.json`:
47
+
48
+ ```json
49
+ {
50
+ "hooks": {
51
+ "Stop": [{ "hooks": [{ "type": "command",
52
+ "command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
53
+ }
54
+ }
55
+ ```
56
+
57
+ Without the hook the bridge falls back to asking Claude for a
58
+ `<<COMS_DONE:msg_id>>` sentinel and scraping the pane. Fallback extraction requires
59
+ a unique current-request boundary (message ID plus per-submission nonce), a nonempty
60
+ reply after that boundary, and an exact terminal current-ID marker. Prompt echoes,
61
+ stale/foreign markers, missing or ambiguous boundaries and truncated captures do
62
+ not prove completion. Replies can still carry TUI noise; the hook returns exact text.
63
+
64
+ 2. **Skill:** install `peer-coms` so the bridged session knows it is a peer and how to
65
+ use `coms-cli`. Point Claude Code at it the way you normally load project skills —
66
+ a `CLAUDE.md` reference to `.pi/skills/peer-coms/SKILL.md` is enough.
67
+
68
+ 3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
69
+ `just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
70
+
71
+ ```bash
72
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-claude-bridge.ts --name claude-main
73
+ # (inside the pane: HERDR_PANE_ID is inherited; or pass --pane <id>)
74
+ ```
75
+
76
+ ## Demo scenario (verified live)
77
+
78
+ ```bash
79
+ just fleet team docs --no-hub # Pi peers up
80
+ # pane with: bridge (claude-main) + claude
81
+ just fleet hub # in another pane: the orchestrator
82
+ # from the hub (or any shell):
83
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send claude-main \
84
+ "Summarize the failing test output in artifacts/test.log" --await --timeout 300000
85
+ ```
86
+
87
+ And the reverse — Claude Code, mid-task, asking a pi peer:
88
+
89
+ ```bash
90
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
91
+ "Where is the retry logic for webhooks? file:line" --await --timeout 300000
92
+ ```
93
+
94
+ ## Serving team dispatches (coms-backed dispatch)
95
+
96
+ A bridge peer that shares a name with an agent-hub team member (e.g. `code-reviewer`,
97
+ `plan-reviewer` in the shipped `peers.yaml`) can serve that member's `dispatch_agent`
98
+ calls transparently: `.pi/agents/dispatch-policy.yaml` marks the member `prefer: coms`,
99
+ and the hub routes the dispatch to the live peer instead of spawning a native subagent —
100
+ same return contract, ASK_USER handling, and history. The standing Claude session keeps
101
+ its context across review rounds, which is the point for code/plan review. See
102
+ "Coms-backed dispatch" in `.pi/harnesses/agent-hub/README.md`.
103
+
104
+ ## Migrating legacy CLI spools
105
+
106
+ Current releases isolate CLI queues by project at:
107
+
108
+ ```text
109
+ ~/.pi/coms/cli/projects/<project>/<name>/
110
+ ```
111
+
112
+ Older releases used the ambiguous name-only path `~/.pi/coms/cli/<name>/`. If that legacy directory exists, `send`, `await`, `reply`, and listener operations fail closed rather than assigning queued messages to whichever project runs first. Before upgrading, stop commands using that CLI identity, inspect its `pending`, `responses`, and `inbound` files, determine the owning project, and move the complete `<name>` directory to `cli/projects/<project>/<name>`. Do not merge two queues or delete pending data merely to clear the error. The name `projects` is reserved for the namespace and cannot be used as a coms identity.
113
+
114
+ ## Behavior notes
115
+
116
+ - **Executable preflight:** a standalone `fleet peer` requires `claude --version`
117
+ to succeed before it creates a pane, so a missing CLI or partial npm install
118
+ fails directly instead of surfacing as a 45-second registration timeout. Team
119
+ layouts and direct `_claude-peer` calls repeat the check inside each created
120
+ pane before starting its bridge; their failure remains visible in that pane.
121
+ - **Serialization:** one prompt at a time per pane; queue depth shows in the peer's
122
+ agent card and the herdr sidebar (`q<depth>`).
123
+ - **Presence:** the bridge annotates its pane through the shared `HerdrPresence`
124
+ (same dialect negotiation as pi peers — `tokens` on herdr >= 0.7.4, one latched
125
+ fallback to `custom_status`), so the pane carries `coms`/`proj` and the fleet panel
126
+ can join it to the registry entry. It writes the annotation ONLY, never
127
+ `pane.report_agent`: the pane's `agent_status` is herdr's own Claude detection and
128
+ the bridge polls it back as its turn-completion signal.
129
+ - **Blocked panes:** a Claude waiting on a permission prompt returns a readable error
130
+ envelope ("blocked on a permission prompt — a human must approve it") instead of
131
+ hanging until timeout.
132
+ - **Busy panes:** the bridge waits with bounded backoff before submitting; exhausting
133
+ that wait returns a mid-turn error without typing the prompt. One absolute reply
134
+ deadline covers both idle waiting and the reply, rather than extending the budget.
135
+ - **Pending versus completion:** after submission, exceeding the reply budget leaves
136
+ the original message pending. The bridge watches the same turn up to its hard
137
+ monitoring cap; a valid late reply resolves the original `msg_id` without resubmission.
138
+ At the cap it remains pending, not a fabricated successful or no-effects response.
139
+ Working→idle/done alone is insufficient: fallback also requires current reply provenance.
140
+ - **Hook freshness:** hook mode is latched once observed. The bridge snapshots hook
141
+ mtime immediately before submission (after any busy wait) and ignores unchanged or
142
+ malformed records. A newer valid record supports completion, but mtime is not
143
+ authenticated request identity: unrelated fresh hook traffic remains indistinguishable.
144
+ - **Restarts:** the bridge is bound to the pane id, not the Claude process — restart
145
+ Claude in the pane and the bridge keeps working.
146
+ - **Fleet safety:** the bridge and skill never create or close panes; herdr driving
147
+ stays with the orchestrator (see `.pi/damage-control-rules.yaml`).
@@ -0,0 +1,434 @@
1
+ # Native Codex MCP for Agent Fleet
2
+
3
+ Use the local `af-local-read` MCP server to work with **already running** Fleet/Pi sessions from one Codex conversation. Despite its historical name, the server supports permission-controlled observations, instructions, and human question answers across multiple explicitly selected targets.
4
+
5
+ This guide covers the current native interface. The [legacy CLI client](codex-session-bridge.md) is a separate interface with separate state; its selection and receipts are not imported automatically. The optional [native voice workflow](fleet-native-voice.md) uses the same MCP tools and permissions, not a different transport.
6
+
7
+ ## Requirements and support boundaries
8
+
9
+ - A local POSIX system with Unix-domain sockets and the same OS user running Codex and the Fleet/Pi sessions. The private policy store does not support Windows.
10
+ - Node.js **22.18 or newer** to run the TypeScript entrypoint directly. The package's general Node.js 18 engine requirement is not sufficient for this server.
11
+ - An Agent Fleet checkout or an unpacked/installed package containing `.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs` and its accompanying TypeScript runtime files. Keep the distribution intact; copying the entrypoint alone is insufficient. See [Fleet setup](agent-fleet-setup.md) for installing Fleet itself.
12
+ - Existing Fleet/Pi sessions publishing a local COMS registry. Observations, instruction receipts, and guarded question actions additionally require compatible receiver capabilities. A registry entry alone does not establish those capabilities.
13
+ - A Codex host that can launch a local STDIO MCP server and supplies its real conversation ID in each tool call's `params._meta.threadId`. This implementation requires a UUID thread ID; optional `sessionId` metadata must also be valid when supplied. Generic MCP support alone is not enough.
14
+
15
+ The server negotiates MCP protocol `2025-06-18`. Local Codex desktop use has been exercised, including a voice-to-agent handoff that performed discovery and read-policy checks. That does **not** establish support for every Codex build, another voice host, mobile access, or voice-driven mutations. Check the tools and results in your actual conversation before relying on them.
16
+
17
+ ## Configure the local server
18
+
19
+ Install and maintain the server with the deterministic command described in the [Codex MCP setup guide](codex-setup.md):
20
+
21
+ ```bash
22
+ agent-fleet set-codex-mcp status
23
+ agent-fleet set-codex-mcp install
24
+ ```
25
+
26
+ It registers `af-local-read` in the user-level Codex configuration through `codex mcp add`, installs the `fleet-native-voice` skill copy under `~/.agents/skills`, and records the decision behind the user-level default. The setup guide also holds the launcher flag reference and defaults, the manual project-local alternative and its shadowing rule, migration from a project-local table, and the removal order. Those steps are not repeated here.
27
+
28
+ After installation, verify in a **new** chat with `fleet_diagnostics {}` and `fleet_discover` as the setup guide describes. Registration exposes the tools in every chat and grants no access; a missing policy namespace or an access denial before enrollment is expected and is not a reason to invent metadata or copy another conversation's state. If tools or host identity are unavailable, stop and report that limitation. A shell invocation, a legacy CLI command, or another chat's identity is not a substitute for a native tool call.
29
+
30
+ ## Connect a target and manage permissions
31
+
32
+ A target is identified by `project`, `peer`, **and the exact `sessionId`/`startedAt` epoch**. Use the names returned by discovery; examples below use the illustrative project `my-project` and peer `orchestrator`. Resolve ambiguity and stale or partial discovery before granting access.
33
+
34
+ 1. Discover candidates:
35
+ ```json
36
+ {"project":"my-project","peer":"orchestrator"}
37
+ ```
38
+ Send this to `fleet_discover`. Registry presence is not task status, responsiveness, or completion.
39
+ 2. Prepare read enrollment with `fleet_binding_prepare`:
40
+ ```json
41
+ {"intent":"enroll_read","project":"my-project","peer":"orchestrator"}
42
+ ```
43
+ 3. Show the returned exact target, old and proposed rights, effects, and expiry to the user. Wait for their explicit confirmation **after** that preview.
44
+ 4. Call `fleet_binding_commit` with only the actual returned `proposalId` in the same chat. Never guess or reuse an unrelated proposal ID.
45
+ 5. Check with `fleet_check_read`, then request `fleet_observe` when an actual peer observation is needed. A successful policy check does not itself read a transcript or probe the receiver.
46
+
47
+ Each target requires its own reviewed binding. The server chooses the binding alias; `bindingAlias` can select an existing binding, not supply an arbitrary new friendly name. Conversational labels are conveniences, not authorization.
48
+
49
+ Other `fleet_binding_prepare` intents use the same preview/confirmation/commit sequence:
50
+
51
+ | Intent | Effect |
52
+ | --- | --- |
53
+ | `rebind_read` | Select a newly discovered exact epoch explicitly. It does not carry send permission forward. |
54
+ | `grant_send` | Add send permission to an existing current read binding. It sends nothing by itself. |
55
+ | `revoke_send` | Remove send permission while keeping read. |
56
+ | `forget` | Remove the binding's read and send rights. It does not stop Pi or undo work already accepted. |
57
+ | `initialize_empty` | Create a missing, empty policy namespace for the current chat, with no target or rights. This intent accepts **no** project, peer, or alias. It is optional, not a prerequisite to read enrollment, and refuses an existing namespace. |
58
+
59
+ `read` never implies `send`. A send grant never authorizes an invented human answer. After a target restart or replacement, do not silently retarget; use fresh discovery and an explicitly confirmed rebind. Policy checks can persistently mark stale local rights as downgraded.
60
+
61
+ Proposals expire after **300 seconds** and are held in server memory. A server restart loses pending proposals, not durable rights or receipts. After expiry, state change, or restart, prepare again and obtain a new confirmation. There are shared limits of 16 pending proposals per context, 64 per process, and eight active calls.
62
+
63
+ ## Observe one or more sessions
64
+
65
+ | Tool | Input and behavior |
66
+ | --- | --- |
67
+ | `fleet_discover` | Required `project`, optional `peer`; bounded registry candidates, without enrollment or peer reads. |
68
+ | `fleet_check_read` | `project`, `peer`; fresh registry-only exact-epoch policy check, potentially downgrading stale local rights. |
69
+ | `fleet_observe` | `project`, `peer`; bounded transcript, progress, and question projections from the authorized exact session. Channels can be unavailable or partial independently. |
70
+ | `fleet_overview` | `targets`: 1–4 explicit unique `{project,peer}` objects; separate bounded summaries and errors per target. |
71
+ | `fleet_resync` | Same target list; fresh observations plus durable **local** cursor/question-observation metadata updates. Reports continuity gaps and resets. |
72
+ | `fleet_watch` | Same target list and integer `durationSeconds` from 1–10; active bounded observation, at most six frames, with local cursor writes. |
73
+
74
+ For example, send this to `fleet_overview` or `fleet_resync`:
75
+
76
+ ```json
77
+ {"targets":[{"project":"frontend","peer":"orchestrator"},{"project":"backend","peer":"orchestrator"}]}
78
+ ```
79
+
80
+ These calls do not auto-enroll targets, answer questions, or write instructions to Pi. Resync and watch are not filesystem-read-only: they maintain local observation state. Watch ends; there is no background subscription, unsolicited notification, idle-model wake, or transcript mirror. Cancellation stops the observer, not Pi, and does not promise rollback of reads or local writes already started.
81
+
82
+ Treat `partial`, source timestamps, channel statuses, and gap reasons as part of the result. An unavailable question source does not mean there are no pending questions. Summary question previews are not sufficient for answering: use `fleet_observe` and the full question-action preview. Neither an idle registry entry nor a successful observation establishes whole-task completion.
83
+
84
+ ## Send an instruction
85
+
86
+ Both current read and send permission are required. Sending can trigger a Pi turn; it is not a promise of immediate steering or task completion. The receiver's canonical COMS/Herdr instruction route must also be available; a successful observation does not prove send readiness.
87
+
88
+ 1. Use a stable, unique `requestId` for the intended action and the exact current target. Call `fleet_instruction_prepare` with:
89
+ ```json
90
+ {
91
+ "requestId":"instruction-001",
92
+ "target":{"project":"my-project","peer":"orchestrator","sessionId":"<actual sessionId>","startedAt":"<actual startedAt>"},
93
+ "instruction":"<the user's exact instruction>"
94
+ }
95
+ ```
96
+ Replace every placeholder with real returned values; the example is not a ready-to-send request. Instructions are limited to 16,384 UTF-8 bytes.
97
+ 2. Present the complete returned payload, target, and effects. Obtain fresh explicit human confirmation, then call `fleet_instruction_commit` with its `proposalId`. Preparation does not deliver anything.
98
+ 3. Read `fleet_instruction_receipt` with the same `requestId`. Its default is local historical lookup. `refresh: true` performs a bounded read-only evidence lookup requiring current read permission and may update the local receipt.
99
+
100
+ The sender records durable intent before one delivery attempt. Exact duplicates return history; reuse of an action ID with a different target, operation, or payload conflicts. Do not resend, switch IDs, or switch transports to work around an uncertain outcome. `submitted`, queued work, and a correlated terminal response are different states; even a terminal response is not proof of semantic whole-task completion or human delivery.
101
+
102
+ ## Answer or refuse a Pi question
103
+
104
+ An actual human response, current read+send rights, and a compatible guarded question receiver are required. Native Pi questions are **not** Damage Control permission dialogs or general approval requests.
105
+
106
+ 1. Obtain the full pending question, options, effective flags, exact target, `questionId`, and `toolCallId`. Never select a response automatically or infer one from a general instruction to continue.
107
+ 2. Call `fleet_answer_prepare` with `requestId`, the exact `target`, `questionId`, `toolCallId`, `operation`, and `response`:
108
+ - Freeform: `operation: "answer"`, `response: {"kind":"freeform","text":"<actual human answer>"}`.
109
+ - Selection: `operation: "answer"`, `response: {"kind":"selection","selections":["<exact option>"],"comment":"<optional human comment>"}`. Include a comment or multiple selections only when allowed by the question.
110
+ - Explicit refusal: `operation: "refusal"`, `response: null`.
111
+ 3. Show the full prepared question, options/flags, normalized response, and effects. Obtain a **new** explicit human confirmation before `fleet_answer_commit {"proposalId":"<actual proposalId>"}`.
112
+ 4. Use `fleet_answer_receipt {"requestId":"<same requestId>"}` for historical metadata, or an explicitly requested `refresh: true` for current guarded evidence when authorized.
113
+
114
+ The receiver revalidates the exact question and uses first-winner arbitration. Changed, already resolved, expired, unsupported, or incompletely addressable questions are not redirected elsewhere. A refusal resolves only that question; it is **not** Pi-turn cancellation. Selecting an option named “Stop” is a selection, not the refusal operation.
115
+
116
+ Question and response JSON are each bounded to 16,000 bytes, with up to 64 options. Guarded receiver receipts are bounded and volatile; missing evidence after a restart or a capacity limit remains unknown, not permission to retry. Receipt metadata is not an archive of answer text.
117
+
118
+ ## Machine permission verification
119
+
120
+ Run `npm run test:damage-relay` for the no-network local relay regressions. It is
121
+ also included in `test:full`. It uses temporary stores/sockets and synthetic
122
+ decisions, not live approve grants or Desktop wake. The expanded checkpoint run
123
+ passed 360 regression tests plus 34 manifest tests; host acceptance remains open.
124
+
125
+ ## Machine Damage Control permissions (source checkpoint)
126
+
127
+ This is a separate channel from human questions. `send` is **not** `approve`.
128
+ New/read-only bindings have no machine approval right. Use the existing reviewed
129
+ `fleet_binding_prepare` / `fleet_binding_commit` flow with `grant_approve` (or
130
+ `revoke_approve`) only after an explicit binding decision. The preview declares
131
+ allowlist format v2 and old-writer quiescence; the first approve grant upgrades that
132
+ namespace without dropping existing read/send. V1-only writers refuse v2. Never
133
+ roll back state or silently restore approve after rebind/epoch changes. `forget`
134
+ removes all rights. No live grant or host reload is performed by source tests.
135
+
136
+ - `fleet_permissions {target, operation, snapshot}`: operation is `list`, `inspect`
137
+ or `receipt`. List requires `snapshot:null`; inspect/receipt use the exact
138
+ returned snapshot. Current read authority is required before and after the RPC.
139
+ Separate list avoids changing the old observation wire schema.
140
+ - `fleet_permission_receipt {requestId}`: read this native chat's durable local
141
+ attempt history without a snapshot, remote refresh or restored rights. A foreign
142
+ chat cannot inherit it. This is the safe lookup after a lost ACK or MCP restart.
143
+ - `fleet_permission_decide {requestId, snapshot, decision, reason}`: after inspecting
144
+ the full action, Codex independently assesses its connection and necessity for
145
+ the exact task/revision. Decision is only `allow_once` or `deny`. A nonempty,
146
+ specific reason and current separate `approve` authority are required. This
147
+ machine operation does not ask the human to reconfirm each scoped decision.
148
+ It never grants turn/session exemptions or answers a human-only question.
149
+
150
+ Pi races local human and machine decisions through one latch, then revalidates
151
+ its action/owner/task, policy, deadline and denial epoch before issuing/consuming
152
+ one-use authority. Machine provenance is `codex_machine`, never human consent.
153
+ The host-supplied native thread UUID is recorded; the Codex turn is **not attested**
154
+ and is explicitly `null`. The trust boundary remains cooperative same-UID routing,
155
+ not cryptographic host identity. An independently approved second binding is not
156
+ cryptographically excluded; this is not the Desktop event-routing proof.
157
+
158
+ `<policy-root>.permissions` is an isolated durable reservation namespace using the
159
+ existing atomic journal engine, not a migration or rewrite of instruction/answer
160
+ history. Remote attempt is marked before bytes are written. Repeated IDs return
161
+ historical state without replay, including after MCP restart; changed payloads
162
+ conflict. A reserved/unknown state is not failure or permission to issue another
163
+ ID. Query the Pi receipt read-only when still authorized. The protocol distinguishes
164
+ latch acceptance from `effect:consumed` (one-use authority, **not tool completion**),
165
+ `not_applied`, and a legacy child `response_queued_unconfirmed`. Pi receipts are
166
+ bounded/volatile; Pi restart or reset can leave unknown evidence.
167
+
168
+ Baseline path asks, destructive bash asks, D6, exact triage actions and new
169
+ exact-action child requests are wired to the shared one-winner permission latch. Children carry a per-spawn epoch;
170
+ stale children, changed task/revision, clipped/unsafe action presentation and
171
+ `zero_access` do not acquire machine authority. Existing local human scopes remain
172
+ available; machine decisions stay once-only. Material triage waivers remain human-only; exact triage actions can receive
173
+ explicit `codex_machine` allow-once/deny under the separate approve contract. Child machine denial is explicitly
174
+ reported as `machine_deny`, not user refusal; expiration/cancellation/staleness do
175
+ not populate a human-denial cache. Child effect receipt is only response queued,
176
+ not proof that its command ran.
177
+
178
+ The optional user-owned `.pi/damage-control-auto-policy.yaml` is not created or
179
+ managed by the installer. Missing/empty/invalid means no automatic policy grant.
180
+ It requires a safe, user-owned non-group/world-writable file and enclosing `.pi`
181
+ directory; no permissions are repaired automatically. Format is `{version:1,rules:[]}`.
182
+ Each explicit rule has `id,decision,source,category,tool,pattern,operation,expiresAt,reason`;
183
+ source is `damage_control_path`, decisions `deny|allow_once`, categories
184
+ `zero_access|read_only|no_delete`, tools `read|write|edit|bash`, operations
185
+ `read|write|delete`, and expiry a canonical UTC ISO timestamp. Zero-access allow is
186
+ forbidden. Only one static safe operand and one exact matching rule qualify.
187
+ Conservative/multi-path/truncated/secret presentation never qualifies. Policy
188
+ digest changes invalidate pending authority; D6 holds still run and cannot be
189
+ bypassed. Audit/UI label this distinct source `auto_policy`. No permissive rule is
190
+ shipped or activated.
191
+
192
+ Local tests exercise real temporary sockets, policy stores and enforcement gates,
193
+ not model inference or a loaded Desktop host. Production source hooks and a durable ingress/outbox are implemented but remain
194
+ explicitly disabled in the live host. The core's in-memory receipts alone are not
195
+ the durable outbox. No live activation is implied by passing fixtures.
196
+
197
+ ### Experimental opt-in Desktop queue adapter
198
+
199
+ `CodexUnixQueueRpc` and `CodexDesktopQueueHost` implement the externally
200
+ smoke-tested shared queue path, not a direct connection to the Desktop stdio
201
+ app-server. RPC connects only to an already running private Unix socket using
202
+ WebSocket Upgrade. The official private user-owned symlink alias is accepted only
203
+ for one hop to a separately checked canonical private socket; alias/target identity
204
+ is rechecked before initialization and addressed writes. No CLI fallback, daemon
205
+ start/resume, auth-file discovery, listener or automatic activation is provided.
206
+
207
+ The host must explicitly supply the exact binding/epoch, externally confirmed
208
+ loaded Desktop mapping, authority revision, bounded confirmation expiry, accepted
209
+ `user_input` transport, daemon/Desktop versions and schema hashes. Those are
210
+ host-supplied evidence, not cryptographic attestation or runtime binary discovery.
211
+ Tuple admission is exact: daemon `0.166.0` with Desktop `0.166.0-alpha.5.1`
212
+ or `0.166.0-alpha.6`, each requiring add-schema SHA256
213
+ `60f25b7d3e3357c215bef9d2fe7047200f545e030dca9e00527ac0620cd0c88f`
214
+ and response-schema SHA256
215
+ `c11b9772788427b19c9f9decf0765e2b41cbdead1aa9c3d39f42fdd70b339314`.
216
+ The alpha.6 addition has measured schema equality and offline unit/mocked admission
217
+ coverage only; it does not extend historical live smoke results or authorize M1.
218
+ For the exact Desktop `0.167.0-alpha.3.2` tuple the daemon pins above still
219
+ apply, and approval also requires `desktopAddSchema`
220
+ `f6466a8f06cd4e68ec1999d06a0d70a1ddc339c0cb1baf12ee966a999fead17c`
221
+ and `desktopResponseSchema`
222
+ `896a82716b432a8aa4d190591bcfa86adacdacb91ec5ec2c9c75ff6562561256`.
223
+ The measured schema delta adds an audio input variant. Fleet queue traffic
224
+ remains text only. This tuple has offline coverage and awaits live idle-wake
225
+ verification. Other versions are refused even if schemas match. `hostInstance` remains an
226
+ operator-supplied binding identifier, not a discovered runtime credential.
227
+ The daemon must report the target `notLoaded`; a known
228
+ daemon-loaded target is refused because that consumer might win instead. This
229
+ read cannot exclude a concurrent consumer or prove that Desktop remains loaded.
230
+ Do not refresh mapping confirmation merely because saved thread metadata exists.
231
+
232
+ Events carry only validated kind-specific `fleet:<kind>/...` references and a
233
+ fixed `fleet_machine` envelope, never raw commands/questions. They are visibly
234
+ machine-origin despite arriving as native **user** input; `humanApproval:false`
235
+ never supplies human consent or `approve`. Exact `fleet:probe/<eventId>` message
236
+ references request only `FLEET_PROBE_ACK <eventId>`, without tools or permissions.
237
+
238
+ The private `<stateRoot>.desktop-events` journal reserves an attempt before the
239
+ queue write. `queue_accepted` and `submissionId` mean server ACK, not model
240
+ observation/execution; cached ACKs carry `historical:true`. Lost ACKs remain
241
+ `unknown` across adapter restarts and are never resent. Read-only reconciliation
242
+ can establish presence in queue, never model delivery from an empty queue. The
243
+ backend client message ID is correlation, not an assumed idempotency guarantee.
244
+ Use the same persistent state root on restart; this journal does not persist
245
+ unaccepted producer events. Queued expired events are not automatically recalled;
246
+ Pi still validates the original permission deadline and action independently.
247
+
248
+ Remaining budgets of 10 seconds or less are unsupported. External marker artifacts
249
+ corroborate ~7.1s emission-to-input and ~9.3s emission-to-reply for one idle sample
250
+ (using the externally reported emission timestamp), and ~61.6s/~63.4s when queued
251
+ behind a busy turn containing an intentional `sleep 60`. Dispatch after the
252
+ previous turn ended was **55ms**; the ~61.6s is total wait, not pure channel latency.
253
+ Isolation in both directions was covered by that second external smoke. Neither a
254
+ 5s SLA nor general deadline reliability is established; queue wait remains inside
255
+ the original deadline.
256
+ These limited host samples do not establish installed adapter compatibility,
257
+ restart safety of the whole bridge, or real model permission decisions. No live
258
+ adapter message or grant is activated by the local tests.
259
+
260
+ A separate explicitly authorized **single** temporary adapter probe on 2026-11-04
261
+ passed: one queue/add, ACK at +26ms, correlated input in the exact control thread
262
+ at +1.418s, exact machine reply at +8.005s inside the original 30s deadline, and
263
+ zero model tool calls. No daemon startup/resume, real Fleet grant or persistent
264
+ bridge activation occurred. This establishes that concrete adapter/host round-trip,
265
+ not independent UI rendering, exclusive process identity, a 5s SLA or whole-bridge
266
+ restart/permission-decision acceptance. SDK saved-thread reads,
267
+ active-turn first-party delivery, MCP watch, CLI exit success and Voice alone
268
+ remain insufficient idle-wake proof.
269
+
270
+ ### Explicit production event ingress (disabled until approved)
271
+
272
+ Real producers publish only exact owner/source IDs, kind, original time/deadline
273
+ and content digests: COMS before prompt ACK/dispatch; questions after their reply
274
+ offer is installed; permissions before returning the hold. Question refs contain
275
+ both question ID and toolCallId, so a bounded observation page is not mistaken for
276
+ the complete set. `fleet_permissions` additionally accepts an optional list
277
+ `cursor`; follow `nextCursor`, use inspect for the full safe action. Independent
278
+ `permissionState` is visible in observe/overview/resync/watch. Missing capability
279
+ is `unsupported`, not zero pending. Existing v1 request shapes remain valid.
280
+
281
+ `/af-codex-events prepare /absolute/private/config.json` reads a user-owned,
282
+ regular, no-follow private file and produces readiness only: no socket contact,
283
+ journal write, daemon lifecycle or grant. `enable` is a **separate explicit user
284
+ activation**, not a recommendation to execute it during source verification;
285
+ `disable` stops the in-process consumer and aborts in-flight binding work.
286
+ No configuration is discovered or created by the installer. The bootstrap
287
+ rechecks that the private config is unchanged before ingress/host write. Changing
288
+ or removing it revokes notification work; it never auto-applies new authority.
289
+ Session reset also stops the runtime. Explicit re-prepare/enable is needed for a
290
+ new mapping; existing read/send/approve rights are not rewritten by this lifecycle.
291
+
292
+ Required config keys are exactly `optedIn`, `stateRoot`, `socketPath`, `approval`,
293
+ `loadedCatalog`, `messageBudgetMs`. `approval` is the exact typed Desktop mapping
294
+ (binding id/epoch/hostInstance/threadId/fleetOwner, target epoch, authority revision,
295
+ confirmation expiry, accepted user-input provenance, mapping evidence and pinned
296
+ versions/schemas). Message notifications with no source expiry use an explicitly
297
+ chosen 10001–60000ms notification budget; question/permission deadlines are never
298
+ extended. The question's own lifetime remains independently authoritative.
299
+
300
+ `loadedCatalog` is a normalized **actual** native diagnostics observation (tool
301
+ names, identity assurance, Node and protocol), not a copied source tool list.
302
+ The earlier observation of **21**, `host_context_validated`, Node 25.2.1 and
303
+ protocol 2025-06-18 is historical. On 2026-11-04 the human relayed new direct main
304
+ observations: **24/24**, completed receiver reload/rebind, and permissionState
305
+ available/complete/zero pending. The old main catalog blocker is closed; do not
306
+ request the same restart/reload again. Preserve/normalize the actual host result,
307
+ not the source list. Actual per-chat native identity, current mapping, rights and
308
+ journal formats still need their own evidence; the catalog count grants none.
309
+ `assessLoadedFleetCatalog` is a pure comparator; it never reloads.
310
+
311
+ `<stateRoot>.event-ingress` durably stores a versioned payload before source ACK,
312
+ with binding/authority revision, stable identity and digest conflict checks. It
313
+ uses the existing synchronous locked/fsync/rename/marker engine, isolated from
314
+ instruction/answer/permission stores. A synchronous validated ingress ACK is
315
+ mandatory; a Promise or void sink cannot claim durability. Startup validates the
316
+ whole journal and reconciles before accepting new source traffic. Only committed
317
+ **never-attempted** events may be re-admitted; attempted/unknown records call
318
+ `reconcile()` read-only, even when the queue is empty or a remote reservation is
319
+ absent. Attempt is marked before calling the host, conservatively before actual
320
+ bytes. Duplicate ingested and terminal/history states are distinct. Partial
321
+ unattempted payload slots are operator-visible and may only be filled by the
322
+ matching original source; attempted unknowns are never blindly repaired/resubmitted.
323
+
324
+ The state root must stay stable across restart. Capacity is bounded (256 intents
325
+ per namespace); unsafe/full/corrupt/changed state fails closed rather than rotating
326
+ or forgetting replay fences. With an explicitly active consumer, durable admission
327
+ failure refuses the source admission; disabled notifications retain prior source
328
+ behavior. Exactly one consumer is allowed for an owner: no cross-chat broadcast.
329
+ No production consumer, config, grant or daemon has been activated by this work.
330
+
331
+ The direct dependency remains pinned **ws@8.22.0**, already locally available. It
332
+ provides the tested Unix connection hook, early frame limits, UTF-8/fragment/close
333
+ handling and disabled redirects. The built-in browser-compatible WebSocket API
334
+ does not expose these same direct `socketPath/createConnection/maxPayload` controls;
335
+ an alternative dispatcher/transport would need its own equivalence/security proof.
336
+ This is a dependency choice, not a blanket vulnerability or host attestation.
337
+
338
+ ### Reply routing and prepared latency tests
339
+
340
+ `replyFleetEvent` checks the trusted current binding **and independent actual
341
+ native thread identity**, not fields copied from an event. A permission reply
342
+ lists/pages, fully inspects and rechecks the pending snapshot, then calls the
343
+ separate machine decision API. Every native API still checks its own rights and
344
+ freshness. No unknown tool result triggers an automatic retry. A normal message
345
+ produces a machine summary, never an implicit instruction/command.
346
+
347
+ Questions retain `fleet_answer_prepare/commit` and their human-confirmation
348
+ contract. The default reply path prepares only. Commit needs a separate genuine
349
+ host-controlled human interaction; a model-supplied boolean/notification is not
350
+ consent. Synthetic callback tests are not evidence of a real human. Permission
351
+ machine decisions do not acquire this human provenance, and human-only waivers
352
+ are not routed through the question API.
353
+
354
+ `RelayLatencyTrace`/`runLatencySeries` provide 20–200-sample drivers and metadata-only
355
+ phase records. Original source deadlines and monotonic local times are retained;
356
+ remote clock error must be explicit. Recorded host input/history is not model
357
+ awareness; ACK is not Pi applied. Pi receipt timings include decision and actual
358
+ one-use consume timestamps, not command completion; legacy child response-queued
359
+ has no fabricated applied timestamp. Local series are `fixture_no_model`.
360
+ Live series need a new coordinator approval callback for the exact profile/count.
361
+ All source remains uncommitted; commit/reload/grants/live runs remain user decisions.
362
+
363
+ ## Local diagnostics, snapshots, and legacy history
364
+
365
+ These operations do not launch a shell, contact another host, or deliver a Pi instruction:
366
+
367
+ | Tool | Behavior |
368
+ | --- | --- |
369
+ | `fleet_diagnostics {}` | Validates native host context and reports the Node runtime, protocol, available tool names/effects, and whether an archive root is configured. It does not probe registry, sockets, or peer capabilities. Use `fleet_check_read` and an authorized observation for those separate checks. |
370
+ | `fleet_receipts {offset?,limit?}` | Local current-chat instruction/question action history, including retained unknown results. Permission history uses `fleet_permission_receipt` separately. Offset is zero-based; limit is 1–8 (default 8). Follow `nextOffset` to enumerate. It does not refresh or replay actions. |
371
+ | `fleet_snapshot {project,peer}` | Explicitly observe one currently read-authorized exact target and retain its redacted report locally. Unlike ordinary observation, this requests content retention for later replay. It makes no peer write. |
372
+ | `fleet_replay {project,peer}` | Return the last explicitly saved snapshot, marked `historical_only`, with its original target and observation time. It performs no live permission/source check and remains local historical data after revocation. It is not evidence about the current target or a restored grant. |
373
+ | `fleet_legacy_history {section,offset?,limit?,sourceSha256?}` | Read the configured original CLI archive for this exact native conversation UUID. Section is `selection` or `runtime`; no model-selected paths, IDs, identities, roots, or grants are accepted. |
374
+
375
+ Snapshots are private files under `<policy-root>.reports`. Each saved report is bounded to 96 KiB; saving a new snapshot for the same chat/selector replaces its prior snapshot under an exclusive lock. There is no automatic snapshot on ordinary observe/resync. Revocation does not erase already retained historical data. Preserve snapshots on a capacity, unsafe-path, or uncertain-write error; do not interpret a replay as fresh progress.
376
+
377
+ ### Preserve existing CLI data without replaying it
378
+
379
+ If you have legacy data, configure the optional launcher pair `"--legacy-state-root", "/absolute/path/to/original/fleet-client"` after reviewing that archive location yourself. It must be a normalized, private, real directory separate from registry and native state roots. The reader does not discover `$CODEX_HOME` or read environment identity. Do not enable a second writer or mutate the archive during transfer. In-flight legacy writer locks block new native actions when this archive is configured.
380
+
381
+ The reader selects only `<actual-native-thread-uuid>.json` and its `.runtime` sibling. A detached old selection may be absent while its runtime history remains accessible. Original files, timestamps, digests, wire IDs, and unknown outcomes are not rewritten or imported into native action records. Stored CLI selection never creates native read/send rights. A legacy command or question-response ID reserves that ID against a new native send/answer when the archive is configured; a reserved ID must be inspected as history, not retried under another ID. Configure the archive **before** issuing potentially overlapping new actions. Omitting the option does not establish that legacy delivery history is empty.
382
+
383
+ Example: `fleet_legacy_history {"section":"runtime","offset":0,"limit":8192}` returns a redacted JSON fragment, `sourceSha256` for the original bytes, and `nextOffset`. For every continuation (`offset > 0`), pass the first page's `sourceSha256` along with `nextOffset`. Missing hashes are rejected; if the original changes or disappears, `HISTORY_STATE_CHANGED` stops pagination. Discard incomplete fragments and, if still needed, explicitly restart from offset zero. Never combine versions. Follow offsets until null and reconstruct the full text before interpreting a record. Offsets count string characters, not bytes. Inputs are bounded to 4 MiB per original file, 131,072 JSON nodes, and 8,192 characters per fragment. Sensitive keys are redacted; individual text values longer than 4,096 characters are wholly withheld rather than incompletely scrubbed. Raw originals remain intact. This is bounded historical access, not an assurance that arbitrary credentials have been identified or an immutable proof of remote delivery.
384
+
385
+ There is no automatic mapping between different native/legacy conversation IDs, profiles, or hosts. Keep those original archives untouched; cross-identity transfer needs a separate explicit mapping decision. Hosts lacking the required native MCP context are not supported by the replacement workflow. Archive access does not enable such a host, authenticate a human, or grant another conversation access.
386
+
387
+ ## Persistent state and journal upgrades
388
+
389
+ Native state is partitioned by configured host profile, principal, and host-supplied thread ID. It is separate from the legacy CLI. Other conversations do not inherit this chat's grants.
390
+
391
+ - `--policy-root`: bindings and revision-bound permissions.
392
+ - `<policy-root>.observations`: bounded local cursors and question-observation metadata, not a transcript archive or proof that a human saw an event.
393
+ - `<policy-root>.reports`: explicitly retained, redacted historical snapshots; separate from observation cursors and deduplication.
394
+ - `<policy-root>.permissions`: isolated machine-permission attempt reservations; no raw action text, no automatic replay and no tool-completion claim.
395
+ - `<policy-root>.instructions`: a shared action journal for instruction, answer, and refusal IDs. Historical receipts remain readable after revocation; remote refresh still requires current read rights.
396
+
397
+ Existing private state directories must be owned by the current user with mode `0700`; state files must be private, owned regular files with mode `0600`. Do not reuse an arbitrary shared directory or manually edit state files to bypass a refusal. Missing state is normally created through the reviewed binding workflow above, not by the installer.
398
+
399
+ The shared instruction/answer action journal is bounded to 256 total records and 8 MiB. There is no automatic purge, deduplication eviction, reset, or corrupt-state repair. Instruction bodies and full question/answer text are not archived there, but bounded instruction results can be retained. This is not a promise to remove content from Codex, chat logs, tool logs, or other systems.
400
+
401
+ An existing **native v1 action journal** is history-only until explicitly upgraded. It is not the legacy CLI journal. `INTENT_FORMAT_UPGRADE_REQUIRED` blocks new action writes and remote receipt refresh on that format.
402
+
403
+ To upgrade, stop old journal writers and in-flight mutating actions first. Call `fleet_journal_upgrade_prepare {}` in the actual native chat. Review the returned namespace, snapshot hash/revision, exact backup location, expiry, and rollback boundary. The operator must confirm writer quiescence; the server does not infer it from an idle pane or file lock. Obtain a fresh human confirmation, then call `fleet_journal_upgrade_commit` with that proposal's ID.
404
+
405
+ The upgrade preserves original receipts and makes an immutable raw backup before the same-file v2 transition. It grants no rights and makes no Pi call. A validated existing v2 journal is reported without another migration proposal. An uncertain commit must be reconciled, not replayed blindly. Old v1 binaries reject v2; safe rollback keeps a v2-capable reader/data or remains offline. **Never restore an old journal snapshot as a retry mechanism.**
406
+
407
+ ## Troubleshooting
408
+
409
+ | Symptom or code | What to check or do |
410
+ | --- | --- |
411
+ | Missing server/tools; `LOCAL_MCP_START_FAILED` | Run `agent-fleet set-codex-mcp status` ([setup guide](codex-setup.md#troubleshooting)): it reports the Node version, launcher paths, entry state, a project shadow, and refusals without dumping private state; `update` repairs the launcher after a Node change. For a manual project-local table, check the Node version, absolute executable/entrypoint paths, all four launcher flags, the intact runtime distribution, project trust, and any `enabled_tools` filter. Use only the host's supported user-controlled reload/reopen procedure. |
412
+ | `IDENTITY_REQUIRED`, `CONFLICTING_HOST_CONTEXT` | The host did not provide accepted per-call metadata or supplied conflicting context. Stop; do not fabricate a UUID, set `CODEX_THREAD_ID` as a substitute, or borrow another chat's identity. |
413
+ | `REGISTRY_MISSING`, stale/partial discovery, ambiguous candidates | Check the actual registry root and intended running project's COMS registration. Resolve ambiguity before binding; do not invent entries or select by working directory alone. |
414
+ | Partial discovery with `ENTRY_INVALID`, especially immediately after startup | A record is missing or has invalid required metadata; this code alone does not identify the field. Updated COMS publishes `heartbeat_at` on its first atomic registration, avoiding the old pre-heartbeat gap. Finite measured context above 100% is valid metadata, not an admission limit; do not clamp it or fabricate an entry. Preserve safe diagnostics and verify the loaded receiver version. Any user-controlled reload changes the epoch and requires explicit rebind; never reload or restore send rights automatically. |
415
+ | `STATE_MISSING` | This namespace has no usable policy state. For a genuinely new namespace, use reviewed enrollment or optional `initialize_empty`. If state was previously present, investigate missing data rather than resetting it. |
416
+ | `NOT_ALLOWED`, `REBIND_REQUIRED`, stale target | Check this chat's exact target and rights. Read does not imply send. A new epoch requires explicit rebind and a separate send grant if needed. Never grant automatically to clear an error. |
417
+ | Expired/missing proposal; `STATE_CHANGED`, `BUSY` | Discard stale previews. Once conflicting work finishes, prepare a new proposal and ask for a new confirmation. Do not bypass revision checks or delete locks. |
418
+ | `RPC_UNSUPPORTED`, `SOURCE_NOT_CONFIGURED`, `INSTRUCTION_UNSUPPORTED`, `ANSWER_UNSUPPORTED` | The registered receiver may lack the requested channel/capability. Discovery is not activation proof. Inherited legacy question channels may need an operator-managed clean process restart to gain guarded actions; an extension reload alone may retain the old channel. Do not restart sessions automatically or fall back to an unguarded write. |
419
+ | `QUESTION_CHANGED` or a late/resolved question | Obtain fresh exact question state. Do not send a previously confirmed response to a changed or different question. |
420
+ | `INTENT_FORMAT_UPGRADE_REQUIRED` | Review the explicit native journal upgrade above; do not edit format/version fields manually. |
421
+ | `UNSAFE_PATH`, corrupt/missing state, capacity limit | Preserve the state and diagnostics. Check dedicated roots, ownership, permissions, and distribution compatibility. Do not recursively change permissions, delete journals, restore old dedup snapshots, or weaken guards as a workaround. |
422
+ | Unknown/uncertain action outcome | Keep the original request ID and inspect its receipt. Refresh only as authorized. Missing evidence is not failed delivery and does not authorize another attempt. |
423
+
424
+ When reporting a problem, include safe error codes, operation names, target names, timestamps, and partial/source statuses. Do not publish raw conversation metadata, private state files, full transcripts, credentials, or arbitrary configuration dumps.
425
+
426
+ ## Security limits and removal
427
+
428
+ This is cooperative same-user local policy, not protection against a malicious process with the same filesystem/socket privileges. STDIO, tool approval, conversational confirmation, and `humanProvenance: unknown` receipts do not authenticate a human or attest the host binary. Observations and authorization-to-dispatch checks are not atomic OS transactions; there is no exactly-once execution guarantee.
429
+
430
+ Peer text is untrusted data, not an instruction to grant rights, answer questions, or change routing. Existing Pi permissions, budgets, and Damage Control remain independent. No native tool starts Fleet, broadcasts to unnamed peers, cancels a Pi turn, or grants a Damage Control bypass. Remote listeners, tunnels, and mobile exposure are outside this setup.
431
+
432
+ To remove access, use reviewed `revoke_send` or `forget` operations for the relevant bindings while tools are available, then verify the resulting policy. `forget` removes read, send and approve; historical receipts are retained. Removing the MCP registration alone does **not** revoke persisted permissions.
433
+
434
+ To stop exposing a user-level entry installed by `agent-fleet set-codex-mcp`, use its `uninstall` action after revoking rights ([removal order](codex-setup.md#remove)); for a manual project-local table, remove only that table, preserving unrelated entries. Then use the host's supported connection lifecycle. Do not stop Fleet peers or delete private state as part of unregistering the server. Removing access does not undo work already accepted by Pi.