@chankov/agent-fleet 2.2.3 → 2.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (783) hide show
  1. package/.pi/agents/model-profiles.yaml +3 -3
  2. package/.pi/agents/peers.yaml +2 -2
  3. package/.pi/agents/voices.yaml +2 -2
  4. package/.pi/harnesses/agent-hub/README.md +8 -1
  5. package/.pi/harnesses/agent-hub/access-approval.ts +20 -8
  6. package/.pi/harnesses/agent-hub/damage-guard-state.ts +5 -2
  7. package/.pi/harnesses/agent-hub/execution-trace.ts +1 -1
  8. package/.pi/harnesses/agent-hub/index.ts +26 -4
  9. package/.pi/harnesses/agent-hub/no-progress.ts +34 -2
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/permission-relay.ts +15 -6
  12. package/.pi/harnesses/agent-hub/process-obligations.ts +20 -0
  13. package/.pi/harnesses/agent-hub/spawn.ts +4 -0
  14. package/.pi/harnesses/agent-hub/task-continuation.ts +19 -2
  15. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +22 -5
  16. package/.pi/harnesses/agent-hub/tools/action-executors.ts +9 -3
  17. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +11 -6
  18. package/.pi/harnesses/coms/package.json +1 -1
  19. package/.pi/harnesses/damage-control-continue/README.md +15 -3
  20. package/.pi/harnesses/damage-control-continue/index.ts +100 -62
  21. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  22. package/.pi/harnesses/lib/bash-policy-analysis.ts +30 -18
  23. package/.pi/harnesses/lib/damage-control-shared.ts +6 -3
  24. package/.pi/harnesses/lib/exact-permission-port.ts +10 -3
  25. package/.versions/2.2.4/.pi/agent-fleet/hermes/README.md +347 -0
  26. package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  27. package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  28. package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  29. package/.versions/2.2.4/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  30. package/.versions/2.2.4/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  31. package/.versions/2.2.4/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  32. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  33. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  34. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  35. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  36. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  37. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  38. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  39. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  40. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  41. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  42. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  43. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  44. package/.versions/2.2.4/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  45. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  46. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  47. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  48. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  49. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  50. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  51. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  52. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  53. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  54. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  55. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  56. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  57. package/.versions/2.2.4/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  58. package/.versions/2.2.4/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  59. package/.versions/2.2.4/.pi/agent-fleet/hooks/coms-stop-hook.mjs +124 -0
  60. package/.versions/2.2.4/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  61. package/.versions/2.2.4/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  62. package/.versions/2.2.4/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  63. package/.versions/2.2.4/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  64. package/.versions/2.2.4/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  65. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/0.167-shared.json +1900 -0
  66. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/README.md +223 -0
  67. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/assessment.md +83 -0
  68. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile-0.167.json +5627 -0
  69. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile.md +43 -0
  70. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap.md +45 -0
  71. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture-profile.ts +53 -0
  72. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture.ts +102 -0
  73. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/catalog.md +91 -0
  74. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/channel.md +21 -0
  75. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurement.md +133 -0
  76. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurements.json +74 -0
  77. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/notification-profile-0.167.json +2679 -0
  78. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/observer.md +101 -0
  79. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/opaque-response.md +57 -0
  80. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/open-sent.md +68 -0
  81. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/probe-reader.md +51 -0
  82. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/profile.md +71 -0
  83. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/projection.md +147 -0
  84. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/reconnect.md +40 -0
  85. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/response-unions.md +74 -0
  86. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/semver.md +124 -0
  87. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/surface.md +73 -0
  88. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  89. package/.versions/2.2.4/.pi/agent-fleet/scripts/fixtures/response-fixture.ts +23 -0
  90. package/.versions/2.2.4/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  91. package/.versions/2.2.4/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +63 -0
  92. package/.versions/2.2.4/.pi/agent-fleet/scripts/fleet.ts +244 -0
  93. package/.versions/2.2.4/.pi/agent-fleet/scripts/flow.ts +166 -0
  94. package/.versions/2.2.4/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  95. package/.versions/2.2.4/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  96. package/.versions/2.2.4/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  97. package/.versions/2.2.4/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  98. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  99. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-bootstrap-files.ts +46 -0
  100. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-bootstrap-probe.ts +52 -0
  101. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-bootstrap-producer.ts +131 -0
  102. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-connection-history.ts +51 -0
  103. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-daemon-observer.ts +137 -0
  104. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-desktop-discovery.ts +84 -0
  105. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-desktop-preflight.ts +130 -0
  106. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +113 -0
  107. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-measurement.ts +218 -0
  108. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-native-presence.ts +61 -0
  109. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-probe-transcript.ts +135 -0
  110. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-send-lineage.ts +72 -0
  111. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +101 -0
  112. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  113. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  114. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +453 -0
  115. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  116. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  117. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  118. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-bootstrap.ts +207 -0
  119. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +76 -0
  120. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  121. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +132 -0
  122. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  123. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  124. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +175 -0
  125. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +435 -0
  126. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  127. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  128. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  129. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  130. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  131. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +44 -0
  132. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  133. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  134. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  135. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
  136. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
  137. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  138. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/fleet-command.ts +264 -0
  139. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  140. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +239 -0
  141. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  142. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  143. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  144. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  145. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  146. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  147. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  148. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  149. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  150. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  151. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  152. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  153. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  154. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  155. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  156. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  157. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  158. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/team-project.ts +176 -0
  159. package/.versions/2.2.4/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  160. package/.versions/2.2.4/.pi/agent-fleet/scripts/package-lock.json +57 -0
  161. package/.versions/2.2.4/.pi/agent-fleet/scripts/package.json +10 -0
  162. package/.versions/2.2.4/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  163. package/.versions/2.2.4/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  164. package/.versions/2.2.4/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  165. package/.versions/2.2.4/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  166. package/.versions/2.2.4/.pi/agent-fleet/scripts/team-up.ts +378 -0
  167. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  168. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  169. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  170. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  171. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  172. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  173. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/git.ts +108 -0
  174. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  175. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  176. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  177. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  178. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  179. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  180. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  181. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  182. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/quality.ts +78 -0
  183. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  184. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  185. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  186. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  187. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  188. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  189. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  190. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  191. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  192. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  193. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  194. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  195. package/.versions/2.2.4/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  196. package/.versions/2.2.4/.pi/agents/dispatch-policy.yaml +32 -0
  197. package/.versions/2.2.4/.pi/agents/model-profiles.yaml +132 -0
  198. package/.versions/2.2.4/.pi/agents/peers.yaml +147 -0
  199. package/.versions/2.2.4/.pi/agents/teams.yaml +41 -0
  200. package/.versions/2.2.4/.pi/agents/voices.yaml +13 -0
  201. package/.versions/2.2.4/.pi/damage-control-rules.yaml +297 -0
  202. package/.versions/2.2.4/.pi/extensions/btw/README.md +120 -0
  203. package/.versions/2.2.4/.pi/extensions/btw/index.ts +916 -0
  204. package/.versions/2.2.4/.pi/extensions/btw/package.json +6 -0
  205. package/.versions/2.2.4/.pi/extensions/btw/state.js +179 -0
  206. package/.versions/2.2.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  207. package/.versions/2.2.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  208. package/.versions/2.2.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  209. package/.versions/2.2.4/.pi/extensions/compact-and-continue/README.md +42 -0
  210. package/.versions/2.2.4/.pi/extensions/compact-and-continue/index.ts +136 -0
  211. package/.versions/2.2.4/.pi/extensions/compact-and-continue/package.json +6 -0
  212. package/.versions/2.2.4/.pi/extensions/mcp-bridge/README.md +46 -0
  213. package/.versions/2.2.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  214. package/.versions/2.2.4/.pi/extensions/mcp-bridge/package.json +6 -0
  215. package/.versions/2.2.4/.pi/extensions/package-lock.json +1175 -0
  216. package/.versions/2.2.4/.pi/extensions/package.json +9 -0
  217. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/README.md +224 -0
  218. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/config.ts +199 -0
  219. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  220. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  221. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  222. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  223. package/.versions/2.2.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  224. package/.versions/2.2.4/.pi/harnesses/agent-hub/README.md +1664 -0
  225. package/.versions/2.2.4/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  226. package/.versions/2.2.4/.pi/harnesses/agent-hub/access-approval.ts +278 -0
  227. package/.versions/2.2.4/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  228. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  229. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  230. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  231. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  232. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  233. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  234. package/.versions/2.2.4/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  235. package/.versions/2.2.4/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  236. package/.versions/2.2.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  237. package/.versions/2.2.4/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  238. package/.versions/2.2.4/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  239. package/.versions/2.2.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  240. package/.versions/2.2.4/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  241. package/.versions/2.2.4/.pi/harnesses/agent-hub/budget-recovery.ts +151 -0
  242. package/.versions/2.2.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  243. package/.versions/2.2.4/.pi/harnesses/agent-hub/capability-packs.ts +187 -0
  244. package/.versions/2.2.4/.pi/harnesses/agent-hub/codex-bootstrap.ts +117 -0
  245. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  246. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  247. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  248. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  249. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  250. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  251. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  252. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  253. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  254. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  255. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  256. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  257. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  258. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  259. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  260. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  261. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  262. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  263. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  264. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  265. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  266. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  267. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  268. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/recover.ts +81 -0
  269. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  270. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  271. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  272. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  273. package/.versions/2.2.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  274. package/.versions/2.2.4/.pi/harnesses/agent-hub/config/agents.ts +183 -0
  275. package/.versions/2.2.4/.pi/harnesses/agent-hub/config/model-profiles.ts +240 -0
  276. package/.versions/2.2.4/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  277. package/.versions/2.2.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  278. package/.versions/2.2.4/.pi/harnesses/agent-hub/context/assertion-journal.ts +133 -0
  279. package/.versions/2.2.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +234 -0
  280. package/.versions/2.2.4/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  281. package/.versions/2.2.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  282. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  283. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  284. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  285. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  286. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  287. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  288. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  289. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  290. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-compat.ts +45 -0
  291. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  292. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  293. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  294. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  295. package/.versions/2.2.4/.pi/harnesses/agent-hub/context-window.js +108 -0
  296. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  297. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  298. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  299. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  300. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  301. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  302. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  303. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-state.ts +46 -0
  304. package/.versions/2.2.4/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  305. package/.versions/2.2.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  306. package/.versions/2.2.4/.pi/harnesses/agent-hub/delegate.ts +478 -0
  307. package/.versions/2.2.4/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  308. package/.versions/2.2.4/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  309. package/.versions/2.2.4/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  310. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  311. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  312. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  313. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +318 -0
  314. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +264 -0
  315. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +297 -0
  316. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-native.ts +242 -0
  317. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  318. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  319. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  320. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  321. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  322. package/.versions/2.2.4/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  323. package/.versions/2.2.4/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  324. package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  325. package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  326. package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  327. package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  328. package/.versions/2.2.4/.pi/harnesses/agent-hub/drift-watchdog.js +344 -0
  329. package/.versions/2.2.4/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  330. package/.versions/2.2.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  331. package/.versions/2.2.4/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  332. package/.versions/2.2.4/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  333. package/.versions/2.2.4/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  334. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  335. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  336. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  337. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  338. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  339. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  340. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  341. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  342. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  343. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  344. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  345. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  346. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  347. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  348. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  349. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  350. package/.versions/2.2.4/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  351. package/.versions/2.2.4/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  352. package/.versions/2.2.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +69 -0
  353. package/.versions/2.2.4/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  354. package/.versions/2.2.4/.pi/harnesses/agent-hub/footer.ts +29 -0
  355. package/.versions/2.2.4/.pi/harnesses/agent-hub/helpers.ts +269 -0
  356. package/.versions/2.2.4/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  357. package/.versions/2.2.4/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  358. package/.versions/2.2.4/.pi/harnesses/agent-hub/index.ts +2827 -0
  359. package/.versions/2.2.4/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  360. package/.versions/2.2.4/.pi/harnesses/agent-hub/input/shortcuts.ts +16 -0
  361. package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  362. package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  363. package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  364. package/.versions/2.2.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  365. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  366. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  367. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  368. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  369. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  370. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  371. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  372. package/.versions/2.2.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  373. package/.versions/2.2.4/.pi/harnesses/agent-hub/no-progress.ts +773 -0
  374. package/.versions/2.2.4/.pi/harnesses/agent-hub/operator-current-state.ts +102 -0
  375. package/.versions/2.2.4/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  376. package/.versions/2.2.4/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  377. package/.versions/2.2.4/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  378. package/.versions/2.2.4/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  379. package/.versions/2.2.4/.pi/harnesses/agent-hub/package.json +7 -0
  380. package/.versions/2.2.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  381. package/.versions/2.2.4/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  382. package/.versions/2.2.4/.pi/harnesses/agent-hub/permission-relay.ts +93 -0
  383. package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  384. package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  385. package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  386. package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/roster.ts +103 -0
  387. package/.versions/2.2.4/.pi/harnesses/agent-hub/policy/work-mode.ts +104 -0
  388. package/.versions/2.2.4/.pi/harnesses/agent-hub/poll-command.ts +184 -0
  389. package/.versions/2.2.4/.pi/harnesses/agent-hub/presentation.ts +54 -0
  390. package/.versions/2.2.4/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  391. package/.versions/2.2.4/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  392. package/.versions/2.2.4/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  393. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  394. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  395. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  396. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  397. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  398. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  399. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  400. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  401. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  402. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  403. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  404. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  405. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-snapshot.ts +287 -0
  406. package/.versions/2.2.4/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  407. package/.versions/2.2.4/.pi/harnesses/agent-hub/process-obligations.ts +230 -0
  408. package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/context.ts +72 -0
  409. package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/fragments.ts +94 -0
  410. package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/session-start.ts +89 -0
  411. package/.versions/2.2.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +142 -0
  412. package/.versions/2.2.4/.pi/harnesses/agent-hub/provider-semaphore.js +143 -0
  413. package/.versions/2.2.4/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  414. package/.versions/2.2.4/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  415. package/.versions/2.2.4/.pi/harnesses/agent-hub/recover-state.ts +144 -0
  416. package/.versions/2.2.4/.pi/harnesses/agent-hub/recovery-continuation.ts +134 -0
  417. package/.versions/2.2.4/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  418. package/.versions/2.2.4/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  419. package/.versions/2.2.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  420. package/.versions/2.2.4/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  421. package/.versions/2.2.4/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  422. package/.versions/2.2.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  423. package/.versions/2.2.4/.pi/harnesses/agent-hub/return-contract.js +371 -0
  424. package/.versions/2.2.4/.pi/harnesses/agent-hub/return-extract.js +77 -0
  425. package/.versions/2.2.4/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  426. package/.versions/2.2.4/.pi/harnesses/agent-hub/review-continuity.ts +76 -0
  427. package/.versions/2.2.4/.pi/harnesses/agent-hub/review-findings.js +96 -0
  428. package/.versions/2.2.4/.pi/harnesses/agent-hub/review-reuse.ts +48 -0
  429. package/.versions/2.2.4/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  430. package/.versions/2.2.4/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  431. package/.versions/2.2.4/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  432. package/.versions/2.2.4/.pi/harnesses/agent-hub/run-budget.js +362 -0
  433. package/.versions/2.2.4/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  434. package/.versions/2.2.4/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  435. package/.versions/2.2.4/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  436. package/.versions/2.2.4/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  437. package/.versions/2.2.4/.pi/harnesses/agent-hub/scope-gate.js +271 -0
  438. package/.versions/2.2.4/.pi/harnesses/agent-hub/scope-overlap.ts +46 -0
  439. package/.versions/2.2.4/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  440. package/.versions/2.2.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  441. package/.versions/2.2.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  442. package/.versions/2.2.4/.pi/harnesses/agent-hub/spawn.ts +706 -0
  443. package/.versions/2.2.4/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  444. package/.versions/2.2.4/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  445. package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  446. package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  447. package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  448. package/.versions/2.2.4/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  449. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-brief.ts +98 -0
  450. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-continuation.ts +21 -0
  451. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  452. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-authorization.ts +187 -0
  453. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  454. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  455. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  456. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  457. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  458. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  459. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  460. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  461. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-runtime.ts +132 -0
  462. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  463. package/.versions/2.2.4/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  464. package/.versions/2.2.4/.pi/harnesses/agent-hub/timeline.ts +72 -0
  465. package/.versions/2.2.4/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +83 -0
  466. package/.versions/2.2.4/.pi/harnesses/agent-hub/tool-catalog-state.ts +125 -0
  467. package/.versions/2.2.4/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  468. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/action-executors.ts +243 -0
  469. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  470. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  471. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  472. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/context.ts +151 -0
  473. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +93 -0
  474. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +976 -0
  475. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  476. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +23 -0
  477. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  478. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  479. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/poll-panel-core.ts +30 -0
  480. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/poll-panel.ts +33 -0
  481. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/recover-task.ts +16 -0
  482. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/run-flow.ts +177 -0
  483. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  484. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  485. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  486. package/.versions/2.2.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  487. package/.versions/2.2.4/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  488. package/.versions/2.2.4/.pi/harnesses/agent-hub/types.ts +66 -0
  489. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  490. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  491. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  492. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  493. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +173 -0
  494. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  495. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  496. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  497. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  498. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  499. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  500. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  501. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  502. package/.versions/2.2.4/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  503. package/.versions/2.2.4/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  504. package/.versions/2.2.4/.pi/harnesses/agent-hub/verification-diagnostics.ts +23 -0
  505. package/.versions/2.2.4/.pi/harnesses/agent-hub/version.ts +42 -0
  506. package/.versions/2.2.4/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  507. package/.versions/2.2.4/.pi/harnesses/agent-hub/work-mode.ts +185 -0
  508. package/.versions/2.2.4/.pi/harnesses/agent-hub/write-isolation.ts +232 -0
  509. package/.versions/2.2.4/.pi/harnesses/ask-user-remote/README.md +59 -0
  510. package/.versions/2.2.4/.pi/harnesses/ask-user-remote/index.ts +571 -0
  511. package/.versions/2.2.4/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  512. package/.versions/2.2.4/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  513. package/.versions/2.2.4/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  514. package/.versions/2.2.4/.pi/harnesses/coms/README.md +105 -0
  515. package/.versions/2.2.4/.pi/harnesses/coms/index.ts +308 -0
  516. package/.versions/2.2.4/.pi/harnesses/coms/package.json +7 -0
  517. package/.versions/2.2.4/.pi/harnesses/coms/version.ts +42 -0
  518. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/README.md +173 -0
  519. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/index.ts +699 -0
  520. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  521. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  522. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  523. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  524. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  525. package/.versions/2.2.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  526. package/.versions/2.2.4/.pi/harnesses/lib/approval-wait.ts +17 -0
  527. package/.versions/2.2.4/.pi/harnesses/lib/bash-policy-analysis.ts +205 -0
  528. package/.versions/2.2.4/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  529. package/.versions/2.2.4/.pi/harnesses/lib/clarification-policy.ts +9 -0
  530. package/.versions/2.2.4/.pi/harnesses/lib/codex-compat.ts +97 -0
  531. package/.versions/2.2.4/.pi/harnesses/lib/codex-contract.ts +259 -0
  532. package/.versions/2.2.4/.pi/harnesses/lib/codex-notification-profile.ts +75 -0
  533. package/.versions/2.2.4/.pi/harnesses/lib/coms-core-io.ts +422 -0
  534. package/.versions/2.2.4/.pi/harnesses/lib/coms-core.ts +738 -0
  535. package/.versions/2.2.4/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  536. package/.versions/2.2.4/.pi/harnesses/lib/coms-observation.ts +74 -0
  537. package/.versions/2.2.4/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  538. package/.versions/2.2.4/.pi/harnesses/lib/coms-response-read.ts +107 -0
  539. package/.versions/2.2.4/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  540. package/.versions/2.2.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +124 -0
  541. package/.versions/2.2.4/.pi/harnesses/lib/context-budget-view.ts +112 -0
  542. package/.versions/2.2.4/.pi/harnesses/lib/context-budget.ts +114 -0
  543. package/.versions/2.2.4/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  544. package/.versions/2.2.4/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  545. package/.versions/2.2.4/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  546. package/.versions/2.2.4/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  547. package/.versions/2.2.4/.pi/harnesses/lib/damage-control-shared.ts +279 -0
  548. package/.versions/2.2.4/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  549. package/.versions/2.2.4/.pi/harnesses/lib/damage-policy.ts +35 -0
  550. package/.versions/2.2.4/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  551. package/.versions/2.2.4/.pi/harnesses/lib/damage-result-view.ts +16 -0
  552. package/.versions/2.2.4/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  553. package/.versions/2.2.4/.pi/harnesses/lib/exact-permission-port.ts +47 -0
  554. package/.versions/2.2.4/.pi/harnesses/lib/execution-trace.ts +45 -0
  555. package/.versions/2.2.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  556. package/.versions/2.2.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  557. package/.versions/2.2.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  558. package/.versions/2.2.4/.pi/harnesses/lib/fleet-bootstrap-channel.ts +148 -0
  559. package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-catalog.ts +30 -0
  560. package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-chat-view.ts +55 -0
  561. package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  562. package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-namespace.ts +2 -0
  563. package/.versions/2.2.4/.pi/harnesses/lib/fleet-codex-policy-snapshot.ts +10 -0
  564. package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  565. package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  566. package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  567. package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  568. package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  569. package/.versions/2.2.4/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  570. package/.versions/2.2.4/.pi/harnesses/lib/fleet-connection-control.ts +94 -0
  571. package/.versions/2.2.4/.pi/harnesses/lib/fleet-connection-diagnostics.ts +7 -0
  572. package/.versions/2.2.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  573. package/.versions/2.2.4/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  574. package/.versions/2.2.4/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  575. package/.versions/2.2.4/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  576. package/.versions/2.2.4/.pi/harnesses/lib/fleet-notification-admission.ts +32 -0
  577. package/.versions/2.2.4/.pi/harnesses/lib/fleet-notification-bootstrap.ts +172 -0
  578. package/.versions/2.2.4/.pi/harnesses/lib/fleet-notification-validation.ts +122 -0
  579. package/.versions/2.2.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  580. package/.versions/2.2.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  581. package/.versions/2.2.4/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  582. package/.versions/2.2.4/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  583. package/.versions/2.2.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  584. package/.versions/2.2.4/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  585. package/.versions/2.2.4/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  586. package/.versions/2.2.4/.pi/harnesses/lib/fleet-target-identity.ts +9 -0
  587. package/.versions/2.2.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  588. package/.versions/2.2.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  589. package/.versions/2.2.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  590. package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  591. package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  592. package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  593. package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  594. package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  595. package/.versions/2.2.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  596. package/.versions/2.2.4/.pi/harnesses/lib/identical-dialog.ts +27 -0
  597. package/.versions/2.2.4/.pi/harnesses/lib/installation-state.js +62 -0
  598. package/.versions/2.2.4/.pi/harnesses/lib/peer-target.ts +24 -0
  599. package/.versions/2.2.4/.pi/harnesses/lib/policy-roots.js +117 -0
  600. package/.versions/2.2.4/.pi/harnesses/lib/policy-roots.ts +32 -0
  601. package/.versions/2.2.4/.pi/harnesses/lib/process-shared.ts +9 -0
  602. package/.versions/2.2.4/.pi/harnesses/lib/resource-closure.js +26 -0
  603. package/.versions/2.2.4/.pi/harnesses/lib/safe-source-read.js +29 -0
  604. package/.versions/2.2.4/.pi/harnesses/lib/semantic-approval.ts +80 -0
  605. package/.versions/2.2.4/.pi/harnesses/lib/session-target.ts +62 -0
  606. package/.versions/2.2.4/.pi/harnesses/lib/spawned-peers.js +191 -0
  607. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  608. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  609. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  610. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  611. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-json.js +37 -0
  612. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-loader.js +53 -0
  613. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  614. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-triage.js +42 -0
  615. package/.versions/2.2.4/.pi/harnesses/lib/system1/config-v2.js +112 -0
  616. package/.versions/2.2.4/.pi/harnesses/lib/system1/config.js +50 -0
  617. package/.versions/2.2.4/.pi/harnesses/lib/system1/contracts.ts +154 -0
  618. package/.versions/2.2.4/.pi/harnesses/lib/system1/demo.ts +95 -0
  619. package/.versions/2.2.4/.pi/harnesses/lib/system1/jev.ts +503 -0
  620. package/.versions/2.2.4/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  621. package/.versions/2.2.4/.pi/harnesses/lib/system1/selection.js +11 -0
  622. package/.versions/2.2.4/.pi/harnesses/lib/system1/service.ts +245 -0
  623. package/.versions/2.2.4/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  624. package/.versions/2.2.4/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  625. package/.versions/2.2.4/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  626. package/.versions/2.2.4/.pi/harnesses/lib/target-capabilities.js +7 -0
  627. package/.versions/2.2.4/.pi/harnesses/lib/update-check.ts +227 -0
  628. package/.versions/2.2.4/.pi/harnesses/lib/workspace-context.js +115 -0
  629. package/.versions/2.2.4/.pi/harnesses/lib/workspace-context.ts +22 -0
  630. package/.versions/2.2.4/.pi/harnesses/package-lock.json +2121 -0
  631. package/.versions/2.2.4/.pi/harnesses/package.json +13 -0
  632. package/.versions/2.2.4/.pi/prompts/af-build.md +27 -0
  633. package/.versions/2.2.4/.pi/prompts/af-code-simplify.md +22 -0
  634. package/.versions/2.2.4/.pi/prompts/af-constraints.md +31 -0
  635. package/.versions/2.2.4/.pi/prompts/af-plan.md +17 -0
  636. package/.versions/2.2.4/.pi/prompts/af-review.md +16 -0
  637. package/.versions/2.2.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  638. package/.versions/2.2.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  639. package/.versions/2.2.4/.pi/prompts/af-setup-rules.md +20 -0
  640. package/.versions/2.2.4/.pi/prompts/af-ship.md +17 -0
  641. package/.versions/2.2.4/.pi/prompts/af-spec.md +15 -0
  642. package/.versions/2.2.4/.pi/prompts/af-test.md +19 -0
  643. package/.versions/2.2.4/.pi/skills/bowser/SKILL.md +145 -0
  644. package/.versions/2.2.4/.version +1 -0
  645. package/.versions/2.2.4/agents/architect.md +24 -0
  646. package/.versions/2.2.4/agents/bowser.md +28 -0
  647. package/.versions/2.2.4/agents/builder.md +55 -0
  648. package/.versions/2.2.4/agents/code-reviewer.md +209 -0
  649. package/.versions/2.2.4/agents/deep-researcher.md +32 -0
  650. package/.versions/2.2.4/agents/documenter.md +22 -0
  651. package/.versions/2.2.4/agents/plan-reviewer.md +83 -0
  652. package/.versions/2.2.4/agents/planner.md +107 -0
  653. package/.versions/2.2.4/agents/releaser.md +24 -0
  654. package/.versions/2.2.4/agents/researcher.md +30 -0
  655. package/.versions/2.2.4/agents/security-auditor.md +167 -0
  656. package/.versions/2.2.4/agents/test-engineer.md +153 -0
  657. package/.versions/2.2.4/agents/web-debugger.md +44 -0
  658. package/.versions/2.2.4/agents/web-performance-auditor.md +194 -0
  659. package/.versions/2.2.4/bin/catalog/harness-runtime-closure.json +85 -0
  660. package/.versions/2.2.4/docs/ARCHITECTURE.md +1291 -0
  661. package/.versions/2.2.4/docs/agent-fleet-setup.md +1161 -0
  662. package/.versions/2.2.4/docs/claude-code-coms-bridge.md +147 -0
  663. package/.versions/2.2.4/docs/codex-local-mcp.md +528 -0
  664. package/.versions/2.2.4/docs/codex-session-bridge.md +44 -0
  665. package/.versions/2.2.4/docs/codex-setup.md +183 -0
  666. package/.versions/2.2.4/docs/coms-hermes-bridge.md +188 -0
  667. package/.versions/2.2.4/docs/fleet-native-voice.md +151 -0
  668. package/.versions/2.2.4/docs/getting-started.md +126 -0
  669. package/.versions/2.2.4/docs/npm-install.md +535 -0
  670. package/.versions/2.2.4/docs/pi-extensions.md +450 -0
  671. package/.versions/2.2.4/docs/pi-setup.md +92 -0
  672. package/.versions/2.2.4/docs/skill-anatomy.md +150 -0
  673. package/.versions/2.2.4/install-manifest.json +3227 -0
  674. package/.versions/2.2.4/justfile +246 -0
  675. package/.versions/2.2.4/manifest-meta.json +1099 -0
  676. package/.versions/2.2.4/references/accessibility-checklist.md +160 -0
  677. package/.versions/2.2.4/references/communication-contract.md +26 -0
  678. package/.versions/2.2.4/references/definition-of-done.md +67 -0
  679. package/.versions/2.2.4/references/fleet-coordination-patterns.md +171 -0
  680. package/.versions/2.2.4/references/observability-checklist.md +92 -0
  681. package/.versions/2.2.4/references/orchestration-patterns.md +370 -0
  682. package/.versions/2.2.4/references/performance-checklist.md +236 -0
  683. package/.versions/2.2.4/references/prompting-patterns.md +380 -0
  684. package/.versions/2.2.4/references/security-checklist.md +245 -0
  685. package/.versions/2.2.4/references/testing-patterns.md +235 -0
  686. package/.versions/2.2.4/references/workflow-authoring.md +304 -0
  687. package/.versions/2.2.4/skills/_internal/grilling.md +59 -0
  688. package/.versions/2.2.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  689. package/.versions/2.2.4/skills/code-review-and-quality/SKILL.md +396 -0
  690. package/.versions/2.2.4/skills/compound-learning/SKILL.md +137 -0
  691. package/.versions/2.2.4/skills/constraint-driven-development/SKILL.md +338 -0
  692. package/.versions/2.2.4/skills/constraint-driven-development/references/floor-guard.md +99 -0
  693. package/.versions/2.2.4/skills/context-engineering/SKILL.md +341 -0
  694. package/.versions/2.2.4/skills/deprecation-and-migration/SKILL.md +247 -0
  695. package/.versions/2.2.4/skills/designing-agents/SKILL.md +394 -0
  696. package/.versions/2.2.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  697. package/.versions/2.2.4/skills/drafting-workflows/SKILL.md +143 -0
  698. package/.versions/2.2.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  699. package/.versions/2.2.4/skills/fleet-connect/SKILL.md +29 -0
  700. package/.versions/2.2.4/skills/fleet-connect.zip +0 -0
  701. package/.versions/2.2.4/skills/fleet-native-voice/SKILL.md +103 -0
  702. package/.versions/2.2.4/skills/fleet-native-voice/agents/openai.yaml +4 -0
  703. package/.versions/2.2.4/skills/fleet-native-voice.zip +0 -0
  704. package/.versions/2.2.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  705. package/.versions/2.2.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  706. package/.versions/2.2.4/skills/idea-refine/SKILL.md +182 -0
  707. package/.versions/2.2.4/skills/idea-refine/examples.md +238 -0
  708. package/.versions/2.2.4/skills/idea-refine/frameworks.md +99 -0
  709. package/.versions/2.2.4/skills/idea-refine/refinement-criteria.md +113 -0
  710. package/.versions/2.2.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  711. package/.versions/2.2.4/skills/incremental-implementation/SKILL.md +353 -0
  712. package/.versions/2.2.4/skills/incremental-implementation.zip +0 -0
  713. package/.versions/2.2.4/skills/interview-me/SKILL.md +226 -0
  714. package/.versions/2.2.4/skills/orchestration-verification/SKILL.md +182 -0
  715. package/.versions/2.2.4/skills/peer-coms/SKILL.md +90 -0
  716. package/.versions/2.2.4/skills/performance-optimization/SKILL.md +496 -0
  717. package/.versions/2.2.4/skills/planning-and-task-breakdown/SKILL.md +318 -0
  718. package/.versions/2.2.4/skills/planning-and-task-breakdown.zip +0 -0
  719. package/.versions/2.2.4/skills/repository-ai-setup/SKILL.md +135 -0
  720. package/.versions/2.2.4/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  721. package/.versions/2.2.4/skills/repository-ai-setup/references/apply-contract.md +74 -0
  722. package/.versions/2.2.4/skills/repository-ai-setup/references/provenance-template.md +16 -0
  723. package/.versions/2.2.4/skills/repository-ai-setup/references/setup-flow.md +108 -0
  724. package/.versions/2.2.4/skills/repository-ai-setup/references/verify-setup.md +20 -0
  725. package/.versions/2.2.4/skills/repository-ai-setup.zip +0 -0
  726. package/.versions/2.2.4/skills/security-and-hardening/SKILL.md +524 -0
  727. package/.versions/2.2.4/skills/spec-driven-development/SKILL.md +295 -0
  728. package/.versions/2.2.4/skills/spec-driven-development.zip +0 -0
  729. package/.versions/2.2.4/skills/using-agent-skills/SKILL.md +198 -0
  730. package/.versions/2.2.4/vendor/agent-skills-upstream/LICENSE +21 -0
  731. package/.versions/2.2.4/vendor/agent-skills-upstream/README.md +430 -0
  732. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  733. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  734. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  735. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  736. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  737. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  738. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  739. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  740. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  741. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  742. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  743. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  744. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  745. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  746. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  747. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  748. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  749. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  750. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  751. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  752. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  753. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  754. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  755. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  756. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  757. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  758. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  759. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  760. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  761. package/.versions/2.2.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  762. package/CHANGELOG.md +25 -0
  763. package/README.md +3 -3
  764. package/agents/architect.md +2 -2
  765. package/agents/bowser.md +1 -1
  766. package/agents/builder.md +2 -2
  767. package/agents/code-reviewer.md +2 -2
  768. package/agents/deep-researcher.md +1 -1
  769. package/agents/documenter.md +1 -1
  770. package/agents/plan-reviewer.md +2 -2
  771. package/agents/planner.md +5 -5
  772. package/agents/releaser.md +1 -1
  773. package/agents/researcher.md +1 -1
  774. package/agents/security-auditor.md +1 -1
  775. package/agents/test-engineer.md +2 -2
  776. package/agents/web-debugger.md +2 -2
  777. package/agents/web-performance-auditor.md +2 -2
  778. package/bin/force-patch-changesets.js +2 -3
  779. package/bin/snapshot-version.js +1 -1
  780. package/docs/agent-fleet-setup.md +3 -3
  781. package/docs/codex-local-mcp.md +13 -5
  782. package/install-manifest.json +1 -1
  783. package/package.json +1 -1
@@ -0,0 +1,180 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # Install one in-repo Hermes plugin into a Hermes profile.
4
+ #
5
+ # .pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr [--profile default]
6
+ # [--copy] [--uninstall] [--force] [--dry-run]
7
+ #
8
+ # A plugin has up to two halves, installed into the profile the same way:
9
+ #
10
+ # .pi/agent-fleet/hermes/plugins/<id>/ -> <profile>/plugins/<id> (backend, FastAPI)
11
+ # .pi/agent-fleet/hermes/desktop-plugins/<id>/ -> <profile>/desktop-plugins/<id> (Desktop pane, ESM)
12
+ #
13
+ # Symlinked at DIRECTORY level, never file by file: web_server.py requires the
14
+ # api file to resolve inside its own dashboard directory, so linking just
15
+ # `plugin_api.py` into a real directory makes the backend fail `relative_to`
16
+ # and be skipped in silence. `--copy` opts out of symlinks entirely.
17
+ #
18
+ # The script never restarts anything. The two halves have different reload
19
+ # rules — plugin.js is watched and hot-reloads, but routers are only included
20
+ # when the app is constructed — so it prints the exact steps and lets a human
21
+ # decide when the gateway goes down.
22
+
23
+ set -euo pipefail
24
+
25
+ PLUGIN_ID=""
26
+ PROFILE="${HERMES_PROFILE:-default}"
27
+ MODE="install"
28
+ LINK=1
29
+ FORCE=0
30
+ DRY_RUN=0
31
+
32
+ REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
33
+ HERMES_SOURCE="${HERMES_SOURCE:-$HOME/.hermes/hermes-agent}"
34
+
35
+ die() { printf 'error: %s\n' "$1" >&2; exit 1; }
36
+ note() { printf ' %s\n' "$1"; }
37
+ run() { if [ "$DRY_RUN" = 1 ]; then printf ' [dry-run] %s\n' "$*"; else "$@"; fi; }
38
+
39
+ usage() {
40
+ sed -n '3,22p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
41
+ exit "${1:-0}"
42
+ }
43
+
44
+ while [ $# -gt 0 ]; do
45
+ case "$1" in
46
+ --profile) PROFILE="${2:-}"; [ -n "$PROFILE" ] || die "--profile needs a name"; shift 2 ;;
47
+ --profile=*) PROFILE="${1#*=}"; shift ;;
48
+ --copy) LINK=0; shift ;;
49
+ --uninstall) MODE="uninstall"; shift ;;
50
+ --force) FORCE=1; shift ;;
51
+ --dry-run) DRY_RUN=1; shift ;;
52
+ -h|--help) usage 0 ;;
53
+ -*) die "unknown option: $1" ;;
54
+ *) [ -z "$PLUGIN_ID" ] || die "one plugin id at a time (got '$PLUGIN_ID' and '$1')"; PLUGIN_ID="$1"; shift ;;
55
+ esac
56
+ done
57
+
58
+ [ -n "$PLUGIN_ID" ] || usage 1
59
+ # The Desktop loader keys the plugin by its folder name, so an id with a path
60
+ # separator would install a plugin that can never load.
61
+ case "$PLUGIN_ID" in *[!A-Za-z0-9._-]*) die "unsafe plugin id: $PLUGIN_ID" ;; esac
62
+
63
+ command -v hermes >/dev/null 2>&1 || die "hermes CLI not found on PATH"
64
+
65
+ BACKEND_SRC="$REPO_ROOT/hermes/plugins/$PLUGIN_ID"
66
+ DESKTOP_SRC="$REPO_ROOT/hermes/desktop-plugins/$PLUGIN_ID"
67
+ [ -d "$BACKEND_SRC" ] || [ -d "$DESKTOP_SRC" ] || die "no such plugin in this repo: $PLUGIN_ID"
68
+
69
+ # `hermes profile show` is the only authority on where a profile lives; the
70
+ # Desktop loader reads the same path from gateway status as `hermes home`.
71
+ PROFILE_PATH="$(hermes profile show "$PROFILE" 2>/dev/null | sed -n 's/^Path:[[:space:]]*//p' | head -1)"
72
+ [ -n "$PROFILE_PATH" ] || die "cannot resolve Hermes profile '$PROFILE' (try: hermes profile list)"
73
+ [ -d "$PROFILE_PATH" ] || die "profile path does not exist: $PROFILE_PATH"
74
+
75
+ printf 'plugin %s\nprofile %s (%s)\nmode %s%s\n\n' \
76
+ "$PLUGIN_ID" "$PROFILE" "$PROFILE_PATH" "$MODE" "$([ "$LINK" = 1 ] && echo ' via symlink' || echo ' via copy')"
77
+
78
+ backup_config() {
79
+ local config="$PROFILE_PATH/config.yaml"
80
+ [ -f "$config" ] || { note "no config.yaml to back up"; return 0; }
81
+ local backup_dir="$PROFILE_PATH/backups/agent-fleet"
82
+ run mkdir -p "$backup_dir"
83
+ local backup="$backup_dir/config.yaml.$(date +%Y%m%dT%H%M%S)"
84
+ run cp -p "$config" "$backup"
85
+ note "backed up config.yaml -> $backup"
86
+ }
87
+
88
+ # One half of the plugin: repo directory -> profile directory.
89
+ install_half() {
90
+ local src="$1" dest_parent="$2" label="$3"
91
+ [ -d "$src" ] || { note "no $label half in this repo — skipped"; return 0; }
92
+ local dest="$dest_parent/$PLUGIN_ID"
93
+ run mkdir -p "$dest_parent"
94
+ if [ -L "$dest" ]; then
95
+ run rm "$dest"
96
+ elif [ -e "$dest" ]; then
97
+ [ "$FORCE" = 1 ] || die "$dest exists and is not a symlink; re-run with --force to replace it"
98
+ run rm -rf "$dest"
99
+ fi
100
+ if [ "$LINK" = 1 ]; then
101
+ run ln -s "$src" "$dest"
102
+ note "$label: $dest -> $src"
103
+ else
104
+ run cp -R "$src" "$dest"
105
+ note "$label: copied to $dest"
106
+ fi
107
+ }
108
+
109
+ uninstall_half() {
110
+ local dest_parent="$1" label="$2"
111
+ local dest="$dest_parent/$PLUGIN_ID"
112
+ if [ -L "$dest" ]; then
113
+ run rm "$dest"
114
+ note "$label: removed symlink $dest"
115
+ elif [ -d "$dest" ]; then
116
+ [ "$FORCE" = 1 ] || { note "$label: $dest is a real directory — left in place (use --force to delete)"; return 0; }
117
+ run rm -rf "$dest"
118
+ note "$label: removed $dest"
119
+ else
120
+ note "$label: nothing installed"
121
+ fi
122
+ }
123
+
124
+ # The acceptance check from the plan, run WITHOUT touching the live gateway:
125
+ # discovery must see the dashboard half with an api file, and the enable record
126
+ # must exist. Both are required — either one missing yields the same 404.
127
+ verify_backend() {
128
+ local python="$HERMES_SOURCE/venv/bin/python"
129
+ if [ ! -x "$python" ]; then
130
+ note "skipped backend verification: no interpreter at $python (set HERMES_SOURCE)"
131
+ return 0
132
+ fi
133
+ if [ "$DRY_RUN" = 1 ]; then
134
+ note "[dry-run] would verify discovery + enable record"
135
+ return 0
136
+ fi
137
+ HERMES_HOME="$PROFILE_PATH" HERMES_SOURCE="$HERMES_SOURCE" "$python" - "$PLUGIN_ID" <<'PY'
138
+ import os
139
+ import sys
140
+ sys.path.insert(0, os.environ["HERMES_SOURCE"])
141
+ from hermes_cli.plugins_cmd import _get_enabled_set
142
+ from hermes_cli.web_server import _discover_dashboard_plugins
143
+
144
+ name = sys.argv[1]
145
+ found = [p for p in _discover_dashboard_plugins() if p["name"] == name]
146
+ enabled = name in _get_enabled_set()
147
+ has_api = bool(found and found[0].get("has_api"))
148
+ print(f" discovery: {'ok' if has_api else 'MISSING'} (records={len(found)}, has_api={has_api})")
149
+ print(f" enabled: {'ok' if enabled else 'MISSING'}")
150
+ sys.exit(0 if has_api and enabled else 1)
151
+ PY
152
+ }
153
+
154
+ if [ "$MODE" = "install" ]; then
155
+ backup_config
156
+ install_half "$BACKEND_SRC" "$PROFILE_PATH/plugins" "backend"
157
+ install_half "$DESKTOP_SRC" "$PROFILE_PATH/desktop-plugins" "desktop"
158
+ if [ -d "$BACKEND_SRC" ]; then
159
+ # Without this record every request to /api/plugins/<id>/* is refused by
160
+ # middleware before routing — a 404 that looks exactly like "not mounted".
161
+ run hermes --profile "$PROFILE" plugins enable "$PLUGIN_ID" --no-allow-tool-override
162
+ verify_backend || die "backend not ready — see the two lines above"
163
+ fi
164
+ printf '\nNext (not done for you):\n'
165
+ if [ -d "$BACKEND_SRC" ]; then
166
+ # Two gateways: `hermes gateway restart` covers the user service (Telegram,
167
+ # TUI, web dashboard), but the Desktop pane calls the gateway that
168
+ # `hermes desktop` spawns for itself — and routers only mount at boot.
169
+ printf ' restart the Hermes Desktop app # its own gateway serves ctx.rest() for the pane\n'
170
+ printf ' hermes --profile %s gateway restart # only if the web dashboard / TUI needs the routes\n' "$PROFILE"
171
+ fi
172
+ if [ -d "$DESKTOP_SRC" ]; then printf ' plugin.js itself hot-reloads within ~5s — no restart needed for pane edits\n'; fi
173
+ else
174
+ run hermes --profile "$PROFILE" plugins disable "$PLUGIN_ID" || note "plugins disable reported an error — continuing"
175
+ uninstall_half "$PROFILE_PATH/plugins" "backend"
176
+ uninstall_half "$PROFILE_PATH/desktop-plugins" "desktop"
177
+ printf '\nNext (not done for you):\n'
178
+ printf ' restart the Hermes Desktop app # unmounts the routers the pane was using\n'
179
+ printf ' hermes --profile %s gateway restart # unmounts them in the service gateway too\n' "$PROFILE"
180
+ fi
@@ -0,0 +1,208 @@
1
+ // .pi/agent-fleet/scripts/lib/claude-bridge-core.ts
2
+ //
3
+ // Pure logic for the Claude Code coms bridge (.pi/agent-fleet/scripts/coms-claude-bridge.ts):
4
+ // prompt formatting, completion sentinels, hook-record parsing, reply
5
+ // extraction from pane text, and the serial prompt queue. No sockets, no fs,
6
+ // no herdr — everything here runs under node --test.
7
+
8
+ export const SENTINEL_PREFIX = "<<COMS_DONE:";
9
+
10
+ // ── reply-timeout and idle-wait policy ──
11
+ //
12
+ // Two field failures live here. First, the bridge only ever read its own
13
+ // --reply-timeout: a caller that asked for 1_800_000ms was still told "no reply
14
+ // within 600000ms", so a review that honestly takes more than ten minutes could
15
+ // not succeed at all. Second, a pane that was mid-turn threw instantly, which
16
+ // turned every busy moment into a hard error — ten of eighteen coms_await calls
17
+ // in one session died that way, the caller hot-retried every few seconds, and
18
+ // then fell back to reading the pane 127 times to watch progress by hand.
19
+
20
+ /** No caller may hold a pane hostage indefinitely. */
21
+ export const REPLY_TIMEOUT_HARD_CAP_MS = 3_600_000;
22
+
23
+ /** Backoff while waiting for a busy pane, in ms; the last step repeats. */
24
+ export const IDLE_WAIT_BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
25
+
26
+ /** Longest we will ever wait for a pane to go idle before giving up. */
27
+ export const IDLE_WAIT_CAP_MS = 120_000;
28
+
29
+ /** A bridge process starts before `claude` in the shared shell recipe. */
30
+ export const CLAUDE_STARTUP_REGISTRATION_SLACK_MS = 5_000;
31
+ export const CLAUDE_STARTUP_TIMEOUT_MS = 40_000;
32
+ export const CLAUDE_STARTUP_POLL_MS = 250;
33
+
34
+ export interface ClaudePaneState {
35
+ agent?: unknown;
36
+ agent_status?: unknown;
37
+ }
38
+
39
+ /** Registration is readiness only after Herdr has detected the Claude process. */
40
+ export function isClaudePaneReady(pane: ClaudePaneState): boolean {
41
+ const agent = String(pane.agent ?? "").toLowerCase();
42
+ const status = String(pane.agent_status ?? "unknown").toLowerCase();
43
+ return agent === "claude" && ["idle", "working", "blocked", "done"].includes(status);
44
+ }
45
+
46
+ export async function waitForClaudePaneReady(
47
+ probe: () => Promise<ClaudePaneState>,
48
+ options: {
49
+ timeoutMs?: number;
50
+ pollMs?: number;
51
+ now?: () => number;
52
+ sleep?: (ms: number) => Promise<void>;
53
+ } = {},
54
+ ): Promise<{ ready: boolean; waitedMs: number; last: ClaudePaneState | null }> {
55
+ const timeoutMs = Math.max(0, options.timeoutMs ?? CLAUDE_STARTUP_TIMEOUT_MS);
56
+ const pollMs = Math.max(1, options.pollMs ?? CLAUDE_STARTUP_POLL_MS);
57
+ const now = options.now ?? Date.now;
58
+ const sleep = options.sleep ?? ((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));
59
+ const startedAt = now();
60
+ let last: ClaudePaneState | null = null;
61
+ for (;;) {
62
+ try {
63
+ last = await probe();
64
+ if (isClaudePaneReady(last)) return { ready: true, waitedMs: now() - startedAt, last };
65
+ } catch {
66
+ // Herdr may briefly race pane creation; retry inside the bounded startup window.
67
+ }
68
+ const remaining = timeoutMs - (now() - startedAt);
69
+ if (remaining <= 0) return { ready: false, waitedMs: now() - startedAt, last };
70
+ await sleep(Math.min(pollMs, remaining));
71
+ }
72
+ }
73
+
74
+ /**
75
+ * The caller's own deadline wins — it knows how long the work takes — falling
76
+ * back to the bridge's configured timeout and always clamped to the hard cap.
77
+ */
78
+ export function resolveReplyTimeoutMs(requested: unknown, fallbackMs: number, capMs = REPLY_TIMEOUT_HARD_CAP_MS): number {
79
+ const asked = Number(requested);
80
+ const base = Number.isFinite(asked) && asked > 0 ? asked : fallbackMs;
81
+ return Math.max(1, Math.min(base, capMs));
82
+ }
83
+
84
+ /** One absolute deadline shared by idle waiting and reply collection. */
85
+ export function replyDeadlineAt(startedAtMs: number, timeoutMs: number): number {
86
+ return Number(startedAtMs) + Math.max(0, Number(timeoutMs) || 0);
87
+ }
88
+
89
+ /**
90
+ * The pane accepted the prompt but did not finish inside the caller's budget.
91
+ * This is deliberately not a response error: the work may still complete.
92
+ */
93
+ export class ReplyPendingError extends Error {
94
+ readonly pending = true;
95
+ constructor(message: string) {
96
+ super(message);
97
+ this.name = "ReplyPendingError";
98
+ }
99
+ }
100
+
101
+ export function isReplyPendingError(error: unknown): error is ReplyPendingError {
102
+ return error instanceof ReplyPendingError || Boolean((error as { pending?: unknown } | null)?.pending);
103
+ }
104
+
105
+ /** Backoff delay for the nth idle-wait attempt (0-based); the last step repeats. */
106
+ export function idleWaitDelayMs(attempt: number): number {
107
+ const i = Math.max(0, Math.min(Math.floor(attempt), IDLE_WAIT_BACKOFF_MS.length - 1));
108
+ return IDLE_WAIT_BACKOFF_MS[i];
109
+ }
110
+
111
+ /**
112
+ * How long to wait for a busy pane. Never more than half the caller's reply
113
+ * budget — waiting to start must not consume the time meant for the answer.
114
+ */
115
+ export function idleWaitBudgetMs(replyTimeoutMs: number, capMs = IDLE_WAIT_CAP_MS): number {
116
+ const half = Math.floor((Number(replyTimeoutMs) || 0) / 2);
117
+ return Math.max(0, Math.min(capMs, half));
118
+ }
119
+
120
+ export function completionSentinel(msgId: string): string {
121
+ return `${SENTINEL_PREFIX}${msgId}>>`;
122
+ }
123
+
124
+ // The prompt as typed into the Claude Code pane. Mirrors the pi side's
125
+ // "[from name @ cwd]" framing so Claude knows who is asking; in sentinel mode
126
+ // (no Stop hook seen yet) it also asks for the completion marker.
127
+ export function formatPanePrompt(
128
+ env: { prompt: string; sender_name: string; sender_cwd: string; msg_id: string },
129
+ sentinelMode: boolean,
130
+ requestBoundary?: string,
131
+ ): string {
132
+ const header = `[coms message from ${env.sender_name} @ ${env.sender_cwd}] `;
133
+ const sentinelNote = sentinelMode
134
+ ? `\n\nEnd your reply with this exact line so the bridge can capture it: ${completionSentinel(env.msg_id)}${requestBoundary ? ` ${requestBoundary}` : ""}`
135
+ : "";
136
+ return `${header}${env.prompt}${sentinelNote}`;
137
+ }
138
+
139
+ // Stop-hook record: the hook writes {text, session_id?, written_at} as JSON.
140
+ export interface HookRecord {
141
+ text: string;
142
+ written_at?: string;
143
+ [key: string]: unknown;
144
+ }
145
+
146
+ export function parseHookRecord(raw: string): HookRecord | null {
147
+ try {
148
+ const rec = JSON.parse(raw);
149
+ if (rec && typeof rec.text === "string") return rec as HookRecord;
150
+ return null;
151
+ } catch {
152
+ return null;
153
+ }
154
+ }
155
+
156
+ // Completion requires the unique boundary submitted for this request, not merely
157
+ // a matching marker in scrollback. Missing/truncated provenance stays pending.
158
+ export function extractSentinelReply(paneText: string, msgId: string, requestBoundary?: string): string | null {
159
+ if (!requestBoundary) return null;
160
+ const clean = paneText.replace(/\x1b\[[0-9;]*m/g, "");
161
+ const boundaryAt = clean.indexOf(requestBoundary);
162
+ if (boundaryAt < 0 || clean.indexOf(requestBoundary, boundaryAt + requestBoundary.length) >= 0) return null;
163
+ const region = clean.slice(boundaryAt + requestBoundary.length);
164
+ // Strip known Claude TUI prefixes, but preserve Markdown quote text (`>`).
165
+ const lines = region.split("\n").map(l => l.replace(/^[●❯\s]+/, "").trimEnd());
166
+ const sentinel = completionSentinel(msgId);
167
+ const end = lines.findIndex(l => l === sentinel);
168
+ if (end < 0 || lines.slice(end + 1).some(l => l.trim() && !/^[─━┏┗┃│]+/.test(l))) return null;
169
+ const reply = lines.slice(0, end).filter(l => l.trim() && !/^[─━┏┗┃│]+/.test(l));
170
+ if (reply.some(l => /<<COMS_(?:DONE|REQUEST):/.test(l)) || !reply.length) return null;
171
+ return reply.join("\n").trim() || null;
172
+ }
173
+
174
+ // ━━ Serial prompt queue ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
175
+ //
176
+ // One prompt at a time per pane; queue depth is reported in the agent card.
177
+
178
+ export interface QueuedPrompt<T> {
179
+ envelope: T;
180
+ enqueued_at: string;
181
+ }
182
+
183
+ export class PromptQueue<T> {
184
+ private items: Array<QueuedPrompt<T>> = [];
185
+ private active = false;
186
+
187
+ get depth(): number {
188
+ return this.items.length + (this.active ? 1 : 0);
189
+ }
190
+
191
+ push(envelope: T, now: () => string = () => new Date().toISOString()): void {
192
+ this.items.push({ envelope, enqueued_at: now() });
193
+ }
194
+
195
+ // Take the next prompt if none is being processed. Callers MUST call
196
+ // done() when processing finishes (success or failure).
197
+ take(): QueuedPrompt<T> | null {
198
+ if (this.active) return null;
199
+ const next = this.items.shift();
200
+ if (!next) return null;
201
+ this.active = true;
202
+ return next;
203
+ }
204
+
205
+ done(): void {
206
+ this.active = false;
207
+ }
208
+ }
@@ -0,0 +1,46 @@
1
+ import {constants,lstatSync,type Stats} from 'node:fs';
2
+ import {lstat,mkdir,open,rename,unlink,type FileHandle} from 'node:fs/promises';
3
+ import {isAbsolute,resolve,dirname,parse} from 'node:path';
4
+ import {randomUUID} from 'node:crypto';
5
+ export const privateFileIdentity=(s:Stats)=>[s.dev,s.ino,s.uid,s.mode,s.nlink,s.size,s.mtimeMs,s.ctimeMs].join(':');
6
+ const directoryIdentity=(s:Stats)=>[s.dev,s.ino,s.uid,s.mode].join(':');
7
+ const missing=(e:unknown)=>(e as any)?.code==='ENOENT';
8
+ export function canonicalPrivatePath(path:string){return typeof path==='string'&&path.length<=4096&&isAbsolute(path)&&resolve(path)===path&&!/[\u0000-\u001f\u007f]/.test(path);}
9
+ function check(signal?:AbortSignal,guard?:()=>void){if(signal?.aborted)throw Error('bootstrap_file_cancelled');guard?.();if(signal?.aborted)throw Error('bootstrap_file_cancelled');}
10
+ /** Explicit user-owned local POSIX directory; no mode repair or symlink walk. */
11
+ export async function privateDirectory(path:string,create=false){
12
+ if(!canonicalPrivatePath(path)||path===parse(path).root||typeof process.getuid!=='function')throw Error('bootstrap_directory_unsafe');
13
+ const chain:string[]=[];for(let p=path;;p=dirname(p)){chain.unshift(p);if(p===dirname(p))break;}
14
+ for(const p of chain){let s:Stats;try{s=await lstat(p);}catch(e){if(!create||!missing(e))throw e;try{await mkdir(p,{mode:0o700});}catch(x){if((x as any)?.code!=='EEXIST')throw x;}s=await lstat(p);}
15
+ if(!s.isDirectory()||s.isSymbolicLink()||(s.uid!==0&&s.uid!==process.getuid())||((s.mode&0o022)!==0&&!(s.uid===0&&(s.mode&0o1000)!==0))||(p===path&&(s.uid!==process.getuid()||(s.mode&0o077)!==0)))throw Error('bootstrap_directory_unsafe');
16
+ }
17
+ return directoryIdentity(await lstat(path));
18
+ }
19
+ export function directoryCurrent(path:string,expected:string){try{const s=lstatSync(path);return s.isDirectory()&&!s.isSymbolicLink()&&directoryIdentity(s)===expected;}catch{return false;}}
20
+ function safe(s:Stats,max:number){if(!s.isFile()||s.isSymbolicLink()||s.uid!==process.getuid?.()||s.nlink!==1||(s.mode&0o077)!==0||s.size<1||s.size>max)throw Error('bootstrap_file_unsafe');}
21
+ export async function readPrivateJson(path:string,max=32768,signal?:AbortSignal):Promise<{value:any;identity:string}|null>{
22
+ if(!canonicalPrivatePath(path)||!Number.isSafeInteger(max)||max<1||max>65536)throw Error('bootstrap_file_invalid');let file:FileHandle|undefined;
23
+ try{
24
+ check(signal);const parent=await privateDirectory(dirname(path)),before=await lstat(path);safe(before,max);file=await open(path,constants.O_RDONLY|constants.O_NOFOLLOW);const held=await file.stat();safe(held,max);if(privateFileIdentity(held)!==privateFileIdentity(before))throw Error('bootstrap_file_changed');
25
+ const bytes=Buffer.alloc(held.size+1);let offset=0;while(offset<bytes.length){check(signal);const read=await file.read(bytes,offset,bytes.length-offset,null);if(!read.bytesRead)break;offset+=read.bytesRead;}
26
+ if(offset!==held.size||privateFileIdentity(await file.stat())!==privateFileIdentity(held)||privateFileIdentity(await lstat(path))!==privateFileIdentity(held)||!directoryCurrent(dirname(path),parent))throw Error('bootstrap_file_changed');
27
+ const value=JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(bytes.subarray(0,offset)));await file.close();file=undefined;check(signal);return {value,identity:privateFileIdentity(held)};
28
+ }catch(e){if(missing(e))return null;throw e;}finally{await file?.close();}
29
+ }
30
+ /** Owned temporary file + CAS publication. Unknown after rename is not rollback.
31
+ * guard is trusted synchronous scope/epoch/lease validation immediately before
32
+ * publication, never a model boolean. No repair/foreign replacement cleanup. */
33
+ export async function writePrivateJson(path:string,value:unknown,options:{signal?:AbortSignal;guard?:()=>void;expected?:string|null;createParent?:boolean}={}){
34
+ const encoded=JSON.stringify(value);if(typeof encoded!=='string')throw Error('bootstrap_file_invalid');const bytes=Buffer.from(encoded+'\n');if(bytes.length>32768||!canonicalPrivatePath(path))throw Error('bootstrap_file_limit');
35
+ const {signal,guard,expected:requestedExpected,createParent}=options;check(signal,guard);const parent=await privateDirectory(dirname(path),createParent===true);check(signal,guard);
36
+ const at=async()=>{try{const s=await lstat(path);safe(s,32768);return privateFileIdentity(s);}catch(e){if(missing(e))return null;throw e;}};
37
+ const expected=requestedExpected===undefined?await at():requestedExpected,temp=path+'.tmp-'+randomUUID();let file:FileHandle|undefined,owned:Stats|undefined,staged:string|undefined,renamed=false;
38
+ try{
39
+ check(signal,guard);file=await open(temp,constants.O_WRONLY|constants.O_CREAT|constants.O_EXCL|constants.O_NOFOLLOW,0o600);owned=await file.stat();await file.writeFile(bytes);await file.sync();staged=privateFileIdentity(await file.stat());await file.close();file=undefined;
40
+ if(!directoryCurrent(dirname(path),parent)||await at()!==expected)throw Error('bootstrap_file_changed');check(signal,guard);
41
+ const pending=lstatSync(temp);safe(pending,32768);if(privateFileIdentity(pending)!==staged||!directoryCurrent(dirname(path),parent))throw Error('bootstrap_file_changed');
42
+ await rename(temp,path);renamed=true;const dir=await open(dirname(path),constants.O_RDONLY|constants.O_DIRECTORY);try{await dir.sync();}finally{await dir.close();}
43
+ check(signal,guard);if(!directoryCurrent(dirname(path),parent))throw Error('bootstrap_file_changed');const result=await readPrivateJson(path,32768,signal);if(!result||JSON.stringify(result.value)+'\n'!==bytes.toString('utf8'))throw Error('bootstrap_file_changed');check(signal,guard);return result.identity;
44
+ }catch(e){if(renamed)throw Error('bootstrap_file_publication_unknown');throw e;}
45
+ finally{try{await file?.close();}finally{if(!renamed&&owned){try{const s=await lstat(temp);if(s.dev!==owned.dev||s.ino!==owned.ino||!s.isFile()||s.uid!==process.getuid?.()||(staged!==undefined&&privateFileIdentity(s)!==staged))throw Error('bootstrap_file_cleanup_unsafe');await unlink(temp);}catch(e){if(!missing(e))throw e;}}}}
46
+ }
@@ -0,0 +1,52 @@
1
+ import {createHash} from 'node:crypto';
2
+ import type {BootstrapServices} from '../../../harnesses/lib/fleet-notification-bootstrap.ts';
3
+ import type {CodexUnixQueueRpc} from './codex-unix-queue-rpc.ts';
4
+ import type {CodexProbeTranscript,ProbeCheckpoint} from './codex-probe-transcript.ts';
5
+ const uuid=(v:unknown):v is string=>typeof v==='string'&&/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/.test(v);
6
+ const object=(v:unknown):v is Record<string,any>=>!!v&&typeof v==='object'&&!Array.isArray(v);
7
+ type Request=Parameters<BootstrapServices['probe']>[0];
8
+ /** One no-load probe. guard is TRUSTED server code rechecking exact native
9
+ * identity/read capability/owner/rights/context; never a model-supplied boolean.
10
+ * Metadata path comes only from pinned includeTurns:false response, not tool args.
11
+ * No fallback to thread load/resume, queue retry, or queue-ACK-as-delivery. */
12
+ export class CodexBootstrapProbe {
13
+ private readonly options:{rpc:Pick<CodexUnixQueueRpc,'request'>;reader:Pick<CodexProbeTranscript,'checkpoint'|'waitForAck'|'close'>;guard:(request:Request)=>void;progress?:(stage:'queue_submission'|'waiting_ack'|'validating_ack',deadline:number)=>void};
14
+ readonly #used=new Map<string,number>();
15
+ constructor(options:CodexBootstrapProbe['options']){this.options={...options};}
16
+ async run(input:Request,signal:AbortSignal):ReturnType<BootstrapServices['probe']>{
17
+ const request=structuredClone(input),{scope,assessment,probeId}=request;
18
+ if(!uuid(probeId)||!uuid(scope?.namespace?.threadId)||scope.binding.threadId!==scope.namespace.threadId||!['verified','contract_checked','contract_unverified'].includes(assessment.level)||!('context'in assessment))throw Error('bootstrap_probe_invalid');
19
+ const now=performance.now();for(const [id,until]of this.#used)if(until<=now)this.#used.delete(id);
20
+ if(this.#used.has(probeId)||this.#used.size>=128)throw Error('bootstrap_probe_not_replayable');this.#used.set(probeId,now+600000);
21
+ const deadline=now+120000,timeout=new AbortController(),scoped=AbortSignal.any([signal,timeout.signal]),timer=setTimeout(()=>timeout.abort(),120000);
22
+ const guard=()=>{if(scoped.aborted||performance.now()>=deadline||Date.now()>=scope.until)throw Error('bootstrap_probe_stale');this.options.guard(structuredClone(request));if(scoped.aborted||performance.now()>=deadline)throw Error('bootstrap_probe_stale');};
23
+ const pin={daemonVersion:assessment.context.daemonVersion,socketEpoch:assessment.context.socketEpoch};let checkpoint:ProbeCheckpoint|undefined,attempted=false;
24
+ const metadata=async()=>{guard();const raw=await this.options.rpc.request('thread/read',{threadId:scope.namespace.threadId,includeTurns:false},{signal:scoped,pin,beforeWrite:guard});guard();
25
+ if(!object(raw)||!object(raw.thread)||raw.thread.id!==scope.namespace.threadId||raw.thread.status?.type!=='notLoaded'||typeof raw.thread.path!=='string'||!raw.thread.path||raw.thread.path.length>4096)throw Error('bootstrap_probe_metadata_unavailable');return raw.thread.path as string;};
26
+ try{
27
+ const path=await metadata();checkpoint=await this.options.reader.checkpoint(path,scope.namespace.threadId,scoped);guard();
28
+ if(await metadata()!==path)throw Error('bootstrap_probe_path_changed');
29
+ if(deadline-performance.now()<=10000)throw Error('bootstrap_probe_budget_too_short');
30
+ const clientUserMessageId=createHash('sha256').update(JSON.stringify([scope.binding,assessment.context,probeId])).digest('hex');
31
+ const envelope={schema:'fleet-bootstrap-probe/v1',source:'fleet_machine',transportOrigin:'user_input',humanApproval:false,deliveryProbe:true,probeId,threadId:scope.namespace.threadId,bindingId:scope.binding.id,bindingEpoch:scope.binding.epoch,fleetOwner:scope.binding.fleetOwner,deadline:Math.floor(Math.min(scope.until,Date.now()+deadline-performance.now())),expectedReply:'FLEET_PROBE_ACK '+probeId};
32
+ const text='FLEET_BOOTSTRAP_PROBE_V1\n'+JSON.stringify(envelope)+'\nТова е само машинен тест за доставка, НЕ човешко одобрение или Fleet задача. Само ако thread/epoch/срокът съвпадат, отговори с единствен final_answer точно expectedReply, без инструменти, файлови промени, права или команди. При изтекъл/чужд probe не възстановявай разрешения.';
33
+ this.options.progress?.('queue_submission',envelope.deadline);
34
+ const result=await this.options.rpc.request('thread/queue/add',{threadId:scope.namespace.threadId,clientUserMessageId,input:[{type:'text',text,text_elements:[]}]},{signal:scoped,pin,beforeWrite:()=>{guard();attempted=true;}});
35
+ guard();if(!attempted)throw Error('bootstrap_probe_missing_prewrite_guard');const q=object(result)&&result.queuedSubmission;
36
+ if(!object(q)||typeof q.id!=='string'||!q.id||q.id.length>256||q.clientUserMessageId!==clientUserMessageId||!Array.isArray(q.input)||q.input.length!==1||q.input[0]?.type!=='text'||q.input[0]?.text!==text)throw Error('bootstrap_probe_enqueue_unknown');
37
+ this.options.progress?.('waiting_ack',envelope.deadline);
38
+ const ack=await this.options.reader.waitForAck(checkpoint,probeId,scoped);guard();
39
+ this.options.progress?.('validating_ack',envelope.deadline);
40
+ if(ack.source!=='local_codex_rollout_jsonl'||ack.readerVersion!=='codex-local-rollout-ack/v1'||ack.threadId!==scope.namespace.threadId||ack.probeId!==probeId||!/^rollout:[a-f0-9]{64}$/.test(ack.receiptId))throw Error('bootstrap_probe_ack_invalid');
41
+ if(await metadata()!==path)throw Error('bootstrap_probe_path_changed');guard();
42
+ const closing=checkpoint;checkpoint=undefined;await this.options.reader.close(closing);guard();
43
+ return {status:'acknowledged',source:'read_only_assistant_transcript',probeId,threadId:scope.namespace.threadId,hostInstance:scope.binding.hostInstance,...assessment.context,notLoadedBefore:true,notLoadedAfter:true,receiptId:ack.receiptId};
44
+ }catch(error){
45
+ // Only expose known diagnostic codes, never transport messages or payloads.
46
+ const known=new Set(['bootstrap_probe_stale','bootstrap_probe_path_changed','bootstrap_probe_enqueue_unknown','bootstrap_probe_ack_invalid','bootstrap_probe_metadata_unavailable','probe_reader_timeout','probe_reader_cancelled','probe_reader_changed']);
47
+ const cause=timeout.signal.aborted?'timeout':signal.aborted?'cancelled':error instanceof Error&&known.has(error.message)?error.message:undefined;
48
+ throw Error((attempted?'bootstrap_probe_unknown_no_replay':'bootstrap_probe_not_sent')+(cause?'_'+cause:''));
49
+ }
50
+ finally{clearTimeout(timer);timeout.abort();if(checkpoint)await this.options.reader.close(checkpoint);}
51
+ }
52
+ }
@@ -0,0 +1,131 @@
1
+ import {randomUUID} from 'node:crypto';
2
+ import {AllowedSessionsStore,StoreError,type StoreOptions,type StoreSnapshot} from './fleet-codex-allowlist-store.ts';
3
+ import type {ConversationKey,TargetEpoch,Right} from './fleet-codex-allowlist.ts';
4
+ import {PermissionTransport} from './fleet-codex-permission-transport.ts';
5
+ import type {NativePresenceDirectory} from './codex-native-presence.ts';
6
+ import {BootstrapChannelClient,namespaceKey,bootstrapNamespace,type BootstrapPresence} from '../../../harnesses/lib/fleet-bootstrap-channel.ts';
7
+ import {codexRightsSnapshot} from '../../../harnesses/lib/fleet-codex-policy-snapshot.ts';
8
+ import {targetKey,validInstructionTarget} from '../../../harnesses/lib/fleet-target-identity.ts';
9
+
10
+ type Candidate={target:TargetEpoch;current:TargetEpoch[]};
11
+ type Pending={context:string;owner:TargetEpoch;expires:number;link:BootstrapChannelClient;running?:Promise<any>;outcome?:any};
12
+ const object=(v:unknown):v is Record<string,any>=>!!v&&typeof v==='object'&&!Array.isArray(v);
13
+ const clone=<T>(v:T):T=>structuredClone(v);
14
+ const uuid=(v:unknown):v is string=>typeof v==='string'&&/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/.test(v);
15
+ const failure=(reason:string)=>({status:'blocked',reason,noChanges:true,activation:'not_performed'});
16
+
17
+ /** Native MCP process owns the writer; neither model arguments nor the AF
18
+ * process can call it directly. Server write frames are accepted only on the
19
+ * exact attached owner/namespace/host-instance channel after native Pi consent.
20
+ * Same-UID cooperative scope is NOT cryptographic human/host authentication. */
21
+ export class CodexBootstrapProducer {
22
+ readonly #links=new Map<string,BootstrapChannelClient>();readonly #opening=new Map<string,Promise<BootstrapChannelClient>>();readonly #pending=new Map<string,Pending>();readonly #writing=new Set<string>();readonly #stop=new AbortController();
23
+ readonly #contexts=new Map<string,{observation:BootstrapPresence;at:number;dirty:boolean;publishing?:Promise<void>}>();readonly #requests=new Set<string>();#polling=false;#timer?:ReturnType<typeof setInterval>;
24
+ readonly hostInstance=randomUUID();
25
+ private readonly options:{policyRoot:string;transport:Pick<PermissionTransport,'open'>;candidate:(c:ConversationKey,t:TargetEpoch)=>Promise<Candidate>;observation:()=>{protocolVersion:string;clientInfo:BootstrapPresence['clientInfo'];catalog:string[]}|null;storeOptions?:StoreOptions;now?:()=>number;monotonic?:()=>number;pendingBudget?:(context:string)=>{total:number;context:number};presence?:NativePresenceDirectory};
26
+ constructor(options:CodexBootstrapProducer['options']){this.options={...options};}
27
+ #now(){return (this.options.now??Date.now)();}#mono(){return (this.options.monotonic??(()=>performance.now()))();}
28
+ #store(c:ConversationKey){return new AllowedSessionsStore(this.options.policyRoot,c,{...this.options.storeOptions,now:this.options.now});}
29
+ async #state(c:ConversationKey):Promise<StoreSnapshot|null>{try{return await this.#store(c).open();}catch(e){if(e instanceof StoreError&&e.code==='STATE_MISSING')return null;throw e;}}
30
+ async #fresh(c:ConversationKey,owner:TargetEpoch,signal:AbortSignal){if(this.#stop.signal.aborted||signal.aborted)throw Error('bootstrap_cancelled');const selected=await this.options.candidate(clone(c),clone(owner));if(this.#stop.signal.aborted||signal.aborted||targetKey(selected.target)!==targetKey(owner))throw Error('bootstrap_owner_changed');return clone(selected);}
31
+ #linkKey(c:ConversationKey,t:TargetEpoch){return namespaceKey(c)+'/'+targetKey(t);}
32
+ /** Called only after validated native metadata, never from model identity args.
33
+ * Coalesced private publication has no rights, queue, probe or daemon effects. */
34
+ observe(c:ConversationKey){
35
+ if(!this.options.presence||this.#stop.signal.aborted||!bootstrapNamespace(c))return;const raw=this.options.observation();if(!raw)return;
36
+ const k=namespaceKey(c);let context=this.#contexts.get(k);if(!context){if(this.#contexts.size>=32)return;context={observation:{namespace:clone(c),hostInstance:this.hostInstance,...clone(raw)},at:this.#now(),dirty:true};this.#contexts.set(k,context);}else{context.observation={namespace:clone(c),hostInstance:this.hostInstance,...clone(raw)};context.at=this.#now();context.dirty=true;}
37
+ for(const [id,link]of this.#links)if(id.startsWith(k+'/')&&!link.signal.aborted)void link.refresh(context.observation,context.at).catch(()=>link.stop());
38
+ if(!context.publishing){const current=context;let work:Promise<void>;work=(async()=>{while(current.dirty&&!this.#stop.signal.aborted){current.dirty=false;try{await this.options.presence!.publish(clone(current.observation),this.#stop.signal);}catch{}}})().finally(()=>{if(current.publishing===work)current.publishing=undefined;});current.publishing=work;}
39
+ if(!this.#timer){this.#timer=setInterval(()=>{void this.#poll();},500);this.#timer.unref?.();}
40
+ }
41
+ async #published(c:ConversationKey,signal:AbortSignal){
42
+ const work=this.#contexts.get(namespaceKey(c))?.publishing;if(!work)return;let timer:ReturnType<typeof setTimeout>|undefined;const stop=AbortSignal.any([signal,this.#stop.signal]);let abort=()=>{};
43
+ try{await Promise.race([work,new Promise<never>((_,reject)=>{abort=()=>reject(Error('bootstrap_cancelled'));stop.addEventListener('abort',abort,{once:true});timer=setTimeout(()=>reject(Error('bootstrap_presence_unavailable')),2000);if(stop.aborted)abort();})]);}finally{clearTimeout(timer);stop.removeEventListener('abort',abort);}
44
+ }
45
+ async #poll(){
46
+ if(this.#polling||this.#stop.signal.aborted||!this.options.presence)return;this.#polling=true;
47
+ try{
48
+ for(const [k,c]of this.#contexts)if(this.#now()-c.at>=600000){this.#contexts.delete(k);void this.options.presence.remove(c.observation).catch(()=>{});}
49
+ if(!this.#contexts.size){clearInterval(this.#timer);this.#timer=undefined;return;}
50
+ for(const entry of await this.options.presence.requests(this.hostInstance,this.#stop.signal)){
51
+ if(this.#requests.has(entry.request.id))continue;if(this.#requests.size>=256)this.#requests.delete(this.#requests.values().next().value!);this.#requests.add(entry.request.id);
52
+ const c=this.#contexts.get(namespaceKey(entry.request.namespace));if(!c||this.#now()-c.at>=600000)continue;
53
+ try{await this.#fresh(entry.request.namespace,entry.request.owner,this.#stop.signal);await this.#link(entry.request.namespace,entry.request.owner,this.#stop.signal);}catch{}
54
+ finally{await this.options.presence.consume(entry.path,entry.identity).catch(()=>{});}
55
+ }
56
+ }catch{}finally{this.#polling=false;}
57
+ }
58
+ async #link(c:ConversationKey,owner:TargetEpoch,signal:AbortSignal){
59
+ const id=this.#linkKey(c,owner),existing=this.#links.get(id);if(existing&&!existing.signal.aborted){const at=this.#contexts.get(namespaceKey(c))?.at??this.#now(),raw=this.options.observation();if(raw)await existing.refresh({namespace:clone(c),hostInstance:this.hostInstance,...clone(raw)},at);return existing;}
60
+ const opening=this.#opening.get(id);if(opening)return opening;
61
+ const observation=this.options.observation();if(!bootstrapNamespace(c)||!validInstructionTarget(owner)||!observation||this.#stop.signal.aborted||this.#links.size+this.#opening.size>=32)throw Error('bootstrap_presence_unavailable');
62
+ const work=Promise.resolve().then(async()=>{
63
+ let link:BootstrapChannelClient|undefined;
64
+ try{const socket=await this.options.transport.open(owner,async()=>{await this.#fresh(c,owner,signal);},AbortSignal.any([signal,this.#stop.signal]));
65
+ if(this.#stop.signal.aborted||signal.aborted){socket.destroy();throw Error('bootstrap_cancelled');}
66
+ link=new BootstrapChannelClient({socket,owner,observation:{namespace:clone(c),hostInstance:this.hostInstance,...clone(observation)},writeRights:(command,s)=>this.#write(c,owner,command,s),signal:this.#stop.signal,observedAt:this.#contexts.get(namespaceKey(c))?.at??this.#now()});
67
+ await link.ready();await this.#fresh(c,owner,signal);if(link.signal.aborted)throw Error('bootstrap_presence_unavailable');this.#links.set(id,link);const active=link;
68
+ active.signal.addEventListener('abort',()=>{if(this.#links.get(id)===active)this.#links.delete(id);},{once:true});return active;
69
+ }catch(e){link?.stop();throw e;}finally{this.#opening.delete(id);}
70
+ });this.#opening.set(id,work);return work;
71
+ }
72
+ async #write(c:ConversationKey,owner:TargetEpoch,command:unknown,signal:AbortSignal){
73
+ const context=namespaceKey(c);
74
+ if(!object(command)||!object(command.scope)||!object(command.expected)||this.#writing.has(context))throw Error('bootstrap_writer_invalid');
75
+ const {scope,expected}=clone(command);
76
+ if(!bootstrapNamespace(scope.namespace)||namespaceKey(scope.namespace)!==context||!validInstructionTarget(scope.owner)||targetKey(scope.owner)!==targetKey(owner)
77
+ ||!object(scope.binding)||scope.binding.threadId!==c.threadId||scope.binding.hostInstance!==this.hostInstance||scope.binding.fleetOwner!==targetKey(owner)
78
+ ||!Number.isSafeInteger(scope.until)||scope.until<=this.#now()||scope.until-this.#now()>720*3600000||!Array.isArray(scope.rights)||scope.rights.length>3
79
+ ||JSON.stringify(scope.rights)!==JSON.stringify(['read',...(scope.rights.includes('send')?['send']:[]),...(scope.rights.includes('approve')?['approve']:[])]))throw Error('bootstrap_writer_scope_changed');
80
+ this.#writing.add(context);
81
+ try{
82
+ const selected=await this.#fresh(c,owner,signal),store=this.#store(c);let state=await this.#state(c);
83
+ if(JSON.stringify(codexRightsSnapshot(state,owner))!==JSON.stringify(expected))throw Error('bootstrap_rights_changed');
84
+ await this.#fresh(c,owner,signal);
85
+ if(!state){if(signal.aborted)throw Error('bootstrap_cancelled');state=await store.initialize();if(signal.aborted)throw Error('bootstrap_writer_unknown');}
86
+ const binding=state.bindings.find(b=>b.target.project===owner.project&&b.target.peer===owner.peer),rights=scope.rights as Right[];
87
+ const result=binding?await store.reconnect({alias:binding.alias,previousTarget:binding.target,target:owner,rights,expiresAt:scope.until},selected.current,state.revision,signal)
88
+ :await store.connect({alias:owner.project+':'+owner.peer,target:owner,rights,expiresAt:scope.until},selected.current,state.revision,signal);
89
+ if(signal.aborted)throw Error('bootstrap_writer_unknown');await this.#fresh(c,owner,signal);
90
+ return codexRightsSnapshot(result,owner);
91
+ }finally{this.#writing.delete(context);}
92
+ }
93
+ pendingCount(context?:string){for(const [id,p]of this.#pending)if((!p.running||p.outcome)&&p.expires<=this.#mono())this.#pending.delete(id);return context===undefined?this.#pending.size:[...this.#pending.values()].filter(p=>p.context===context).length;}
94
+ #capacity(c:ConversationKey){const other=this.options.pendingBudget?.(namespaceKey(c))??{total:0,context:0};return this.pendingCount()+other.total>=64||this.pendingCount(namespaceKey(c))+other.context>=16;}
95
+ async prepare(c:ConversationKey,a:any,signal=new AbortController().signal){
96
+ if(this.#capacity(c))return failure('bootstrap_capacity');this.observe(c);
97
+ try{
98
+ await this.#published(c,signal);
99
+ const selected=await this.#fresh(c,a.target,signal),link=await this.#link(clone(c),selected.target,signal),state=await this.#state(c);
100
+ const binding=state?.bindings.find(b=>b.target.project===a.target.project&&b.target.peer===a.target.peer);
101
+ const until=this.#now()+(a.durationHours??12)*3600000,rights=[...(a.rights??binding?.rights??['read'])];
102
+ const result=await link.request('prepare',{until,rights},signal);
103
+ if(result?.status==='prepared'&&uuid(result.proposalId)){
104
+ if(this.#capacity(c))return failure('bootstrap_capacity');
105
+ this.#pending.set(result.proposalId,{context:namespaceKey(c),owner:clone(selected.target),expires:this.#mono()+300000,link});
106
+ }
107
+ return {...clone(result),target:clone(selected.target),source:'native_pi_bootstrap',humanProvenance:'pending_native_pi_confirmation',delivery:'not_attempted'};
108
+ }catch{return failure('bootstrap_presence_or_control_unavailable');}
109
+ }
110
+ has(c:ConversationKey,id:string){return this.#pending.get(id)?.context===namespaceKey(c);}
111
+ /** Release the initiating model/tool turn before waiting for that same chat's
112
+ * terminal probe ACK. A handoff receipt never proves consent or effects. The
113
+ * normal MCP signal survives successful response; cancellation before handoff
114
+ * and producer shutdown still cancel the scoped operation. */
115
+ async beginCommit(c:ConversationKey,id:string,signal=new AbortController().signal){
116
+ const p=this.#pending.get(id);if(!p||p.context!==namespaceKey(c)||p.expires<=this.#mono())throw Error('bootstrap_proposal_unavailable');if(signal.aborted||this.#stop.signal.aborted)throw Error('bootstrap_cancelled');
117
+ if(p.outcome)return {...clone(p.outcome),cachedPreviousCommit:true,delivery:'not_established_by_receipt'};
118
+ if(!p.running)void this.commit(c,id,signal).catch(()=>{});
119
+ return {status:'pending',proposalId:id,source:'native_pi_bootstrap',humanProvenance:'not_established_by_handoff',activation:'not_established_by_handoff',rightsCommitted:'not_established_by_handoff',delivery:'not_established_by_handoff',startsDaemon:false,grantsApproveAutomatically:false};
120
+ }
121
+ async commit(c:ConversationKey,id:string,signal=new AbortController().signal){
122
+ const p=this.#pending.get(id);if(!p||p.context!==namespaceKey(c)||p.expires<=this.#mono())throw Error('bootstrap_proposal_unavailable');
123
+ if(p.outcome)return clone(p.outcome);if(p.running)return p.running.then(clone);
124
+ p.running=Promise.resolve().then(async()=>{try{await this.#fresh(c,p.owner,signal);p.outcome=await p.link.request('commit',{proposalId:id},signal);}catch{p.outcome={status:'failed_or_unknown',reason:'bootstrap_control_lost',replayAllowed:false,activation:'unknown'};}return clone(p.outcome);});return p.running.then(clone);
125
+ }
126
+ async status(c:ConversationKey,owner:TargetEpoch,signal=new AbortController().signal){
127
+ const link=this.#links.get(this.#linkKey(c,owner));if(!link||link.signal.aborted)return failure('bootstrap_presence_unavailable');
128
+ try{return await link.request('status',{},signal);}catch{return failure('bootstrap_control_unavailable');}
129
+ }
130
+ stop(){this.#stop.abort();clearInterval(this.#timer);for(const l of this.#links.values())l.stop();this.#links.clear();const contexts=[...this.#contexts.values()];this.#contexts.clear();if(this.options.presence)void Promise.allSettled(contexts.map(c=>c.publishing)).then(()=>Promise.allSettled(contexts.map(c=>this.options.presence!.remove(c.observation))));}
131
+ }