@chankov/agent-fleet 2.0.12 → 2.0.13

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 (616) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +5 -3
  2. package/.pi/agent-fleet/scripts/lib/flow-command.ts +9 -4
  3. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +3 -1
  4. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  5. package/.pi/agents/model-profiles.yaml +80 -29
  6. package/.pi/agents/peers.yaml +18 -18
  7. package/.pi/agents/voices.yaml +2 -2
  8. package/.pi/harnesses/agent-hub/README.md +55 -4
  9. package/.pi/harnesses/agent-hub/commands/audit.ts +1 -1
  10. package/.pi/harnesses/agent-hub/commands/context.ts +1 -1
  11. package/.pi/harnesses/agent-hub/config/model-profiles.ts +1 -0
  12. package/.pi/harnesses/agent-hub/delegate.ts +5 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +27 -2
  14. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +29 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +6 -0
  16. package/.pi/harnesses/agent-hub/index.ts +75 -40
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +2 -2
  19. package/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  20. package/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  21. package/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  22. package/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  23. package/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  24. package/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  25. package/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  26. package/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  27. package/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  28. package/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  29. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  30. package/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  31. package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
  32. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -0
  33. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  34. package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -1
  35. package/.pi/harnesses/agent-hub/return-extract.js +1 -1
  36. package/.pi/harnesses/agent-hub/session-audit.ts +6 -5
  37. package/.pi/harnesses/agent-hub/system1-activity.ts +67 -0
  38. package/.pi/harnesses/agent-hub/system1-report.ts +142 -1
  39. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -0
  40. package/.pi/harnesses/agent-hub/tools/run-flow.ts +16 -2
  41. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +26 -5
  42. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +30 -5
  43. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +7 -2
  44. package/.pi/harnesses/agent-hub/ui/grid.ts +12 -7
  45. package/.pi/harnesses/coms/package.json +1 -1
  46. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  47. package/.pi/harnesses/lib/context-budget-child-prompt.ts +41 -2
  48. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +4 -2
  49. package/.pi/harnesses/lib/fleet-dashboard-view.ts +14 -3
  50. package/.pi/harnesses/lib/fleet-detail-view.ts +68 -7
  51. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  52. package/.pi/harnesses/lib/fleet-strip-view.ts +44 -9
  53. package/.pi/prompts/af-setup-rules.md +20 -0
  54. package/.versions/2.0.13/.pi/agent-fleet/hermes/README.md +347 -0
  55. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  56. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  57. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  58. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  59. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  60. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  61. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  62. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  63. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  64. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  65. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  66. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  67. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  68. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  69. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  70. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  71. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  72. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  73. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  74. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  75. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  76. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  77. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  78. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  79. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  80. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  81. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  82. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  83. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  84. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  85. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  86. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  87. package/.versions/2.0.13/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  88. package/.versions/2.0.13/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  89. package/.versions/2.0.13/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  90. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  91. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  92. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  93. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  94. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  95. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet.ts +216 -0
  96. package/.versions/2.0.13/.pi/agent-fleet/scripts/flow.ts +157 -0
  97. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  98. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  99. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  100. package/.versions/2.0.13/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  101. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  102. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  103. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  104. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  105. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  106. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  107. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  108. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  109. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  110. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  111. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  112. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  113. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  114. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  115. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  116. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  117. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  118. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  119. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  120. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  121. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  122. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  123. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  124. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  125. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  126. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  127. package/.versions/2.0.13/.pi/agent-fleet/scripts/package-lock.json +35 -0
  128. package/.versions/2.0.13/.pi/agent-fleet/scripts/package.json +9 -0
  129. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  130. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  131. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  132. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-up.ts +378 -0
  133. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  134. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  135. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  136. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  137. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  138. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  139. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  140. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  141. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  142. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  143. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  144. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  145. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  146. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  147. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  148. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  149. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  150. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  151. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  152. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  153. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  154. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  155. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  156. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  157. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  158. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  159. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  160. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  161. package/.versions/2.0.13/.pi/agents/dispatch-policy.yaml +32 -0
  162. package/.versions/2.0.13/.pi/agents/model-profiles.yaml +134 -0
  163. package/.versions/2.0.13/.pi/agents/peers.yaml +147 -0
  164. package/.versions/2.0.13/.pi/agents/teams.yaml +41 -0
  165. package/.versions/2.0.13/.pi/agents/voices.yaml +13 -0
  166. package/.versions/2.0.13/.pi/damage-control-rules.yaml +297 -0
  167. package/.versions/2.0.13/.pi/extensions/btw/README.md +120 -0
  168. package/.versions/2.0.13/.pi/extensions/btw/index.ts +914 -0
  169. package/.versions/2.0.13/.pi/extensions/btw/package.json +6 -0
  170. package/.versions/2.0.13/.pi/extensions/btw/state.js +179 -0
  171. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  172. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  173. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  174. package/.versions/2.0.13/.pi/extensions/compact-and-continue/README.md +42 -0
  175. package/.versions/2.0.13/.pi/extensions/compact-and-continue/index.ts +120 -0
  176. package/.versions/2.0.13/.pi/extensions/compact-and-continue/package.json +6 -0
  177. package/.versions/2.0.13/.pi/extensions/mcp-bridge/README.md +46 -0
  178. package/.versions/2.0.13/.pi/extensions/mcp-bridge/index.ts +206 -0
  179. package/.versions/2.0.13/.pi/extensions/mcp-bridge/package.json +6 -0
  180. package/.versions/2.0.13/.pi/extensions/package-lock.json +1175 -0
  181. package/.versions/2.0.13/.pi/extensions/package.json +9 -0
  182. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/README.md +224 -0
  183. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/config.ts +198 -0
  184. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  185. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/index.ts +248 -0
  186. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/package.json +6 -0
  187. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  188. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  189. package/.versions/2.0.13/.pi/harnesses/agent-hub/README.md +1360 -0
  190. package/.versions/2.0.13/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  191. package/.versions/2.0.13/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  192. package/.versions/2.0.13/.pi/harnesses/agent-hub/artifacts.js +146 -0
  193. package/.versions/2.0.13/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  194. package/.versions/2.0.13/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  195. package/.versions/2.0.13/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  196. package/.versions/2.0.13/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  197. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  198. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  199. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  200. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  201. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  202. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  203. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  204. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  205. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  206. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  207. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  208. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  209. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  210. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  211. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  212. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  213. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  214. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  215. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  216. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  217. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  218. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  219. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  220. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  221. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  222. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  223. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  224. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  225. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  226. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  227. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  228. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  229. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  230. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  231. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  232. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  233. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  234. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  235. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  236. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  237. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  238. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-window.js +108 -0
  239. package/.versions/2.0.13/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  240. package/.versions/2.0.13/.pi/harnesses/agent-hub/delegate.ts +467 -0
  241. package/.versions/2.0.13/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  242. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  243. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  244. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  245. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  246. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  247. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  248. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  249. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  250. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  251. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  252. package/.versions/2.0.13/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  253. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  254. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  255. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  256. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  257. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  258. package/.versions/2.0.13/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  259. package/.versions/2.0.13/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  260. package/.versions/2.0.13/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  261. package/.versions/2.0.13/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  262. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
  263. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  264. package/.versions/2.0.13/.pi/harnesses/agent-hub/footer.ts +30 -0
  265. package/.versions/2.0.13/.pi/harnesses/agent-hub/helpers.ts +270 -0
  266. package/.versions/2.0.13/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  267. package/.versions/2.0.13/.pi/harnesses/agent-hub/index.ts +2336 -0
  268. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  269. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  270. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  271. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  272. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  273. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  274. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  275. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  276. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  277. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  278. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  279. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  280. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  281. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  282. package/.versions/2.0.13/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  283. package/.versions/2.0.13/.pi/harnesses/agent-hub/package.json +7 -0
  284. package/.versions/2.0.13/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  285. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  286. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  287. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  288. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  289. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  290. package/.versions/2.0.13/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  291. package/.versions/2.0.13/.pi/harnesses/agent-hub/presentation.ts +48 -0
  292. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  293. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  294. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  295. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  296. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  297. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  298. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  299. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  300. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  301. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  302. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  303. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  304. package/.versions/2.0.13/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  305. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/context.ts +53 -0
  306. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  307. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  308. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/system-prompt.ts +115 -0
  309. package/.versions/2.0.13/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  310. package/.versions/2.0.13/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  311. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  312. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  313. package/.versions/2.0.13/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  314. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  315. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  316. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  317. package/.versions/2.0.13/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  318. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-contract.js +327 -0
  319. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-extract.js +77 -0
  320. package/.versions/2.0.13/.pi/harnesses/agent-hub/review-findings.js +104 -0
  321. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-budget.js +542 -0
  322. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  323. package/.versions/2.0.13/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  324. package/.versions/2.0.13/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  325. package/.versions/2.0.13/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  326. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  327. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-health.js +110 -0
  328. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-start.ts +42 -0
  329. package/.versions/2.0.13/.pi/harnesses/agent-hub/spawn.ts +526 -0
  330. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  331. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  332. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-runtime.ts +276 -0
  333. package/.versions/2.0.13/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  334. package/.versions/2.0.13/.pi/harnesses/agent-hub/timeline.ts +72 -0
  335. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  336. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  337. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  338. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  339. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  340. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  341. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  342. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  343. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  344. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  345. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  346. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  347. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  348. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  349. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  350. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  351. package/.versions/2.0.13/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  352. package/.versions/2.0.13/.pi/harnesses/agent-hub/types.ts +66 -0
  353. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  354. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  355. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  356. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  357. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +124 -0
  358. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  359. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  360. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  361. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  362. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  363. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  364. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  365. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  366. package/.versions/2.0.13/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  367. package/.versions/2.0.13/.pi/harnesses/agent-hub/version.ts +42 -0
  368. package/.versions/2.0.13/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  369. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  370. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  371. package/.versions/2.0.13/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  372. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/README.md +59 -0
  373. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/index.ts +558 -0
  374. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  375. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  376. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  377. package/.versions/2.0.13/.pi/harnesses/coms/README.md +100 -0
  378. package/.versions/2.0.13/.pi/harnesses/coms/index.ts +282 -0
  379. package/.versions/2.0.13/.pi/harnesses/coms/package.json +7 -0
  380. package/.versions/2.0.13/.pi/harnesses/coms/version.ts +42 -0
  381. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/README.md +135 -0
  382. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/index.ts +550 -0
  383. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/package.json +7 -0
  384. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/version.ts +42 -0
  385. package/.versions/2.0.13/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  386. package/.versions/2.0.13/.pi/harnesses/lib/coms-core-io.ts +385 -0
  387. package/.versions/2.0.13/.pi/harnesses/lib/coms-core.ts +577 -0
  388. package/.versions/2.0.13/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  389. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  390. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  391. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-view.ts +107 -0
  392. package/.versions/2.0.13/.pi/harnesses/lib/context-budget.ts +114 -0
  393. package/.versions/2.0.13/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  394. package/.versions/2.0.13/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  395. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  396. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  397. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  398. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  399. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  400. package/.versions/2.0.13/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  401. package/.versions/2.0.13/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  402. package/.versions/2.0.13/.pi/harnesses/lib/fleet-panel.ts +34 -0
  403. package/.versions/2.0.13/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  404. package/.versions/2.0.13/.pi/harnesses/lib/fleet-selection.ts +24 -0
  405. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  406. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  407. package/.versions/2.0.13/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  408. package/.versions/2.0.13/.pi/harnesses/lib/herdr-client.ts +472 -0
  409. package/.versions/2.0.13/.pi/harnesses/lib/herdr-presence.ts +399 -0
  410. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  411. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  412. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  413. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  414. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  415. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  416. package/.versions/2.0.13/.pi/harnesses/lib/spawned-peers.js +191 -0
  417. package/.versions/2.0.13/.pi/harnesses/lib/system1/config.js +61 -0
  418. package/.versions/2.0.13/.pi/harnesses/lib/system1/contracts.ts +152 -0
  419. package/.versions/2.0.13/.pi/harnesses/lib/system1/demo.ts +106 -0
  420. package/.versions/2.0.13/.pi/harnesses/lib/system1/jev.ts +503 -0
  421. package/.versions/2.0.13/.pi/harnesses/lib/system1/service.ts +245 -0
  422. package/.versions/2.0.13/.pi/harnesses/lib/update-check.ts +222 -0
  423. package/.versions/2.0.13/.pi/harnesses/package-lock.json +2039 -0
  424. package/.versions/2.0.13/.pi/harnesses/package.json +10 -0
  425. package/.versions/2.0.13/.pi/prompts/af-build.md +24 -0
  426. package/.versions/2.0.13/.pi/prompts/af-code-simplify.md +22 -0
  427. package/.versions/2.0.13/.pi/prompts/af-constraints.md +31 -0
  428. package/.versions/2.0.13/.pi/prompts/af-plan.md +17 -0
  429. package/.versions/2.0.13/.pi/prompts/af-review.md +16 -0
  430. package/.versions/2.0.13/.pi/prompts/af-set-hermes-telegram.md +15 -0
  431. package/.versions/2.0.13/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  432. package/.versions/2.0.13/.pi/prompts/af-setup-rules.md +20 -0
  433. package/.versions/2.0.13/.pi/prompts/af-ship.md +17 -0
  434. package/.versions/2.0.13/.pi/prompts/af-spec.md +15 -0
  435. package/.versions/2.0.13/.pi/prompts/af-test.md +19 -0
  436. package/.versions/2.0.13/.pi/skills/bowser/SKILL.md +145 -0
  437. package/.versions/2.0.13/.version +1 -0
  438. package/.versions/2.0.13/agents/architect.md +24 -0
  439. package/.versions/2.0.13/agents/bowser.md +28 -0
  440. package/.versions/2.0.13/agents/builder.md +55 -0
  441. package/.versions/2.0.13/agents/code-reviewer.md +209 -0
  442. package/.versions/2.0.13/agents/deep-researcher.md +32 -0
  443. package/.versions/2.0.13/agents/documenter.md +22 -0
  444. package/.versions/2.0.13/agents/orchestrator.md +22 -0
  445. package/.versions/2.0.13/agents/plan-reviewer.md +83 -0
  446. package/.versions/2.0.13/agents/planner.md +105 -0
  447. package/.versions/2.0.13/agents/releaser.md +24 -0
  448. package/.versions/2.0.13/agents/researcher.md +30 -0
  449. package/.versions/2.0.13/agents/security-auditor.md +167 -0
  450. package/.versions/2.0.13/agents/test-engineer.md +153 -0
  451. package/.versions/2.0.13/agents/web-debugger.md +44 -0
  452. package/.versions/2.0.13/agents/web-performance-auditor.md +194 -0
  453. package/.versions/2.0.13/bin/catalog/harness-runtime-closure.json +73 -0
  454. package/.versions/2.0.13/codex/fleet-session-client/SKILL.md +34 -0
  455. package/.versions/2.0.13/codex/fleet-session-client.zip +0 -0
  456. package/.versions/2.0.13/docs/ARCHITECTURE.md +753 -0
  457. package/.versions/2.0.13/docs/agent-fleet-setup.md +900 -0
  458. package/.versions/2.0.13/docs/claude-code-coms-bridge.md +134 -0
  459. package/.versions/2.0.13/docs/codex-session-bridge.md +219 -0
  460. package/.versions/2.0.13/docs/coms-hermes-bridge.md +188 -0
  461. package/.versions/2.0.13/docs/getting-started.md +126 -0
  462. package/.versions/2.0.13/docs/npm-install.md +468 -0
  463. package/.versions/2.0.13/docs/pi-extensions.md +454 -0
  464. package/.versions/2.0.13/docs/pi-setup.md +92 -0
  465. package/.versions/2.0.13/docs/skill-anatomy.md +150 -0
  466. package/.versions/2.0.13/install-manifest.json +3175 -0
  467. package/.versions/2.0.13/justfile +247 -0
  468. package/.versions/2.0.13/manifest-meta.json +1057 -0
  469. package/.versions/2.0.13/references/accessibility-checklist.md +160 -0
  470. package/.versions/2.0.13/references/communication-contract.md +26 -0
  471. package/.versions/2.0.13/references/definition-of-done.md +67 -0
  472. package/.versions/2.0.13/references/fleet-coordination-patterns.md +171 -0
  473. package/.versions/2.0.13/references/observability-checklist.md +92 -0
  474. package/.versions/2.0.13/references/orchestration-patterns.md +370 -0
  475. package/.versions/2.0.13/references/performance-checklist.md +236 -0
  476. package/.versions/2.0.13/references/prompting-patterns.md +380 -0
  477. package/.versions/2.0.13/references/security-checklist.md +245 -0
  478. package/.versions/2.0.13/references/testing-patterns.md +235 -0
  479. package/.versions/2.0.13/references/workflow-authoring.md +304 -0
  480. package/.versions/2.0.13/skills/_internal/grilling.md +59 -0
  481. package/.versions/2.0.13/skills/browser-testing-with-devtools/SKILL.md +351 -0
  482. package/.versions/2.0.13/skills/code-review-and-quality/SKILL.md +396 -0
  483. package/.versions/2.0.13/skills/compound-learning/SKILL.md +137 -0
  484. package/.versions/2.0.13/skills/constraint-driven-development/SKILL.md +338 -0
  485. package/.versions/2.0.13/skills/constraint-driven-development/references/floor-guard.md +99 -0
  486. package/.versions/2.0.13/skills/context-engineering/SKILL.md +341 -0
  487. package/.versions/2.0.13/skills/deprecation-and-migration/SKILL.md +247 -0
  488. package/.versions/2.0.13/skills/designing-agents/SKILL.md +394 -0
  489. package/.versions/2.0.13/skills/designing-agents/pi-harness-authoring.md +222 -0
  490. package/.versions/2.0.13/skills/drafting-workflows/SKILL.md +143 -0
  491. package/.versions/2.0.13/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  492. package/.versions/2.0.13/skills/frontend-ui-engineering/SKILL.md +328 -0
  493. package/.versions/2.0.13/skills/git-workflow-and-versioning/SKILL.md +316 -0
  494. package/.versions/2.0.13/skills/idea-refine/SKILL.md +182 -0
  495. package/.versions/2.0.13/skills/idea-refine/examples.md +238 -0
  496. package/.versions/2.0.13/skills/idea-refine/frameworks.md +99 -0
  497. package/.versions/2.0.13/skills/idea-refine/refinement-criteria.md +113 -0
  498. package/.versions/2.0.13/skills/idea-refine/scripts/idea-refine.sh +15 -0
  499. package/.versions/2.0.13/skills/incremental-implementation/SKILL.md +302 -0
  500. package/.versions/2.0.13/skills/interview-me/SKILL.md +226 -0
  501. package/.versions/2.0.13/skills/orchestration-verification/SKILL.md +182 -0
  502. package/.versions/2.0.13/skills/peer-coms/SKILL.md +90 -0
  503. package/.versions/2.0.13/skills/performance-optimization/SKILL.md +496 -0
  504. package/.versions/2.0.13/skills/planning-and-task-breakdown/SKILL.md +289 -0
  505. package/.versions/2.0.13/skills/repository-ai-setup/SKILL.md +117 -0
  506. package/.versions/2.0.13/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  507. package/.versions/2.0.13/skills/repository-ai-setup/references/apply-contract.md +74 -0
  508. package/.versions/2.0.13/skills/repository-ai-setup/references/provenance-template.md +16 -0
  509. package/.versions/2.0.13/skills/repository-ai-setup/references/setup-flow.md +108 -0
  510. package/.versions/2.0.13/skills/repository-ai-setup/references/verify-setup.md +20 -0
  511. package/.versions/2.0.13/skills/security-and-hardening/SKILL.md +524 -0
  512. package/.versions/2.0.13/skills/spec-driven-development/SKILL.md +295 -0
  513. package/.versions/2.0.13/skills/using-agent-skills/SKILL.md +198 -0
  514. package/.versions/2.0.13/vendor/agent-skills-upstream/LICENSE +21 -0
  515. package/.versions/2.0.13/vendor/agent-skills-upstream/README.md +430 -0
  516. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  517. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  518. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  519. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  520. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  521. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  522. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  523. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  524. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  525. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  526. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  527. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  528. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  529. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  530. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  531. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  532. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  533. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  534. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  535. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  536. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  537. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  538. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  539. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  540. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  541. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  542. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  543. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  544. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  545. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  546. package/CHANGELOG.md +10 -0
  547. package/README.md +3 -3
  548. package/agents/architect.md +2 -3
  549. package/agents/bowser.md +2 -2
  550. package/agents/builder.md +2 -3
  551. package/agents/code-reviewer.md +7 -8
  552. package/agents/deep-researcher.md +3 -4
  553. package/agents/documenter.md +2 -3
  554. package/agents/orchestrator.md +2 -3
  555. package/agents/plan-reviewer.md +5 -6
  556. package/agents/planner.md +5 -6
  557. package/agents/releaser.md +2 -3
  558. package/agents/researcher.md +4 -5
  559. package/agents/security-auditor.md +6 -7
  560. package/agents/test-engineer.md +3 -4
  561. package/agents/web-debugger.md +3 -3
  562. package/agents/web-performance-auditor.md +3 -3
  563. package/bin/catalog/harness-runtime-closure.json +30 -18
  564. package/bin/cli.js +47 -1
  565. package/bin/lib/apply.js +16 -0
  566. package/bin/lib/overrides.js +37 -1
  567. package/bin/lib/project-provenance.js +119 -0
  568. package/bin/lib/scan.js +1 -1
  569. package/bin/lib/transaction.js +1 -1
  570. package/bin/lib/validate-overrides.js +37 -3
  571. package/catalog/agent-prompts/README.md +12 -0
  572. package/catalog/agent-prompts/architecture-decision-author.md +24 -0
  573. package/catalog/agent-prompts/requirements-author.md +21 -0
  574. package/catalog/commands/README.md +13 -0
  575. package/catalog/commands/assess-change-impact.md +19 -0
  576. package/catalog/commands/audit-documentation.md +19 -0
  577. package/catalog/rules/README.md +33 -0
  578. package/catalog/rules/ai/policy-authoring.md +22 -0
  579. package/catalog/rules/architecture/behavior-preserving-refactoring.md +25 -0
  580. package/catalog/rules/architecture/public-contracts.md +22 -0
  581. package/catalog/rules/architecture/repository-boundaries.md +21 -0
  582. package/catalog/rules/architecture/structural-change-registration.md +25 -0
  583. package/catalog/rules/backend/notification-date-time.md +25 -0
  584. package/catalog/rules/bundles/README.md +16 -0
  585. package/catalog/rules/data/enum-semantics.md +25 -0
  586. package/catalog/rules/data/mixed-ownership-data.md +22 -0
  587. package/catalog/rules/data/reporting-queries.md +34 -0
  588. package/catalog/rules/docs/docs-maintenance.md +25 -0
  589. package/catalog/rules/frameworks/vue.md +25 -0
  590. package/catalog/rules/frontend/async-ui-states.md +26 -0
  591. package/catalog/rules/frontend/established-ui-primitives.md +25 -0
  592. package/catalog/rules/frontend/form-validation.md +26 -0
  593. package/catalog/rules/frontend/navigation-contracts.md +25 -0
  594. package/catalog/rules/languages/csharp.md +25 -0
  595. package/catalog/rules/languages/javascript.md +25 -0
  596. package/catalog/rules/languages/sql.md +24 -0
  597. package/catalog/rules/security/authorization-before-effects.md +26 -0
  598. package/catalog/rules/security/diagnostic-data-safety.md +22 -0
  599. package/catalog/rules/security/response-data-minimization.md +25 -0
  600. package/catalog/rules/security/trusted-tenant-scope.md +26 -0
  601. package/catalog/rules/testing/shared-package-consumers.md +25 -0
  602. package/catalog/rules/testing/verification-conventions.md +24 -0
  603. package/docs/ARCHITECTURE.md +50 -2
  604. package/docs/agent-fleet-setup.md +246 -28
  605. package/docs/codex-session-bridge.md +1 -1
  606. package/docs/pi-extensions.md +10 -5
  607. package/docs/workflows.md +4 -3
  608. package/install-manifest.json +125 -3
  609. package/manifest-meta.json +77 -15
  610. package/package.json +5 -3
  611. package/skills/repository-ai-setup/SKILL.md +117 -0
  612. package/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  613. package/skills/repository-ai-setup/references/apply-contract.md +74 -0
  614. package/skills/repository-ai-setup/references/provenance-template.md +16 -0
  615. package/skills/repository-ai-setup/references/setup-flow.md +108 -0
  616. package/skills/repository-ai-setup/references/verify-setup.md +20 -0
@@ -0,0 +1,411 @@
1
+ // .pi/agent-fleet/scripts/coms-claude-bridge.ts
2
+ //
3
+ // The Claude Code ↔ coms bridge: one bridge per Claude Code pane, launched
4
+ // next to it (the `_claude-peer` recipe backgrounds the bridge in the same
5
+ // herdr pane). It makes an interactive Claude Code a first-class coms peer:
6
+ //
7
+ // (a) binds a coms endpoint + registry entry under --name, so the Claude
8
+ // pane appears in every pool widget and is addressable via coms_send;
9
+ // (b) inbound prompt envelope → pane.send_text into the Claude pane
10
+ // (+ Enter as a separate send — spike quirk);
11
+ // (c) completion, primary path: the Claude Code Stop hook
12
+ // (.pi/agent-fleet/hooks/coms-stop-hook.mjs) writes the turn's last message to
13
+ // ~/.pi/coms/claude-bridge/<pane>/last-message.json; fallback when no
14
+ // hook has ever fired for this pane: a <<COMS_DONE:msg_id>> sentinel is
15
+ // requested in the prompt and scraped via pane.read after herdr reports
16
+ // the agent done;
17
+ // (d) sends the response envelope back to the sender;
18
+ // (e) a `blocked` agent status returns a readable error envelope instead of
19
+ // hanging until timeout;
20
+ // (f) prompts are strictly serialized per pane; queue depth is reported in
21
+ // the agent card + the pane's herdr peer annotation.
22
+ //
23
+ // usage: coms-claude-bridge.ts --name <peer-name> [--pane <pane_id>]
24
+ // [--project <p>] [--reply-timeout <ms>]
25
+ // --pane defaults to HERDR_PANE_ID (set inside every herdr pane).
26
+
27
+ import * as fs from "node:fs";
28
+ import * as os from "node:os";
29
+ import * as path from "node:path";
30
+ import { fileURLToPath } from "node:url";
31
+
32
+ import {
33
+ bindEndpoint,
34
+ ensureComsDirs,
35
+ isPromptEnvelope,
36
+ makeConnHandler,
37
+ makeEndpoint,
38
+ makeResponseEnvelope,
39
+ nowIso,
40
+ paneAgentStatusToPeerStatus,
41
+ removeRegistryEntry,
42
+ resolveUniqueName,
43
+ sendEnvelope,
44
+ ulid,
45
+ writeAck,
46
+ writeNack,
47
+ writeRegistryAtomic,
48
+ type AgentCard,
49
+ type PeerStatus,
50
+ type PromptEnvelope,
51
+ type RegistryEntry,
52
+ type SenderIdentity,
53
+ } from "./lib/coms-envelope.ts";
54
+ import {
55
+ extractSentinelReply,
56
+ formatPanePrompt,
57
+ idleWaitBudgetMs,
58
+ idleWaitDelayMs,
59
+ isReplyPendingError,
60
+ parseHookRecord,
61
+ PromptQueue,
62
+ REPLY_TIMEOUT_HARD_CAP_MS,
63
+ ReplyPendingError,
64
+ replyDeadlineAt,
65
+ resolveReplyTimeoutMs,
66
+ waitForClaudePaneReady,
67
+ } from "./lib/claude-bridge-core.ts";
68
+ import { herdr, requireHerdr, HerdrUnavailableError } from "../../../.pi/harnesses/lib/herdr-client.ts";
69
+ import { HerdrPresence } from "../../../.pi/harnesses/lib/herdr-presence.ts";
70
+ import { buildLiveRegistryEntry, type ComsIdentity } from "../../../.pi/harnesses/lib/coms-registry-entry.ts";
71
+
72
+ const KEEPALIVE_MS = 30_000;
73
+ const ENTER_DELAY_MS = 1_500;
74
+ const POLL_MS = 1_000;
75
+ // 30 minutes, matching coms_await's own default (PI_COMS_TIMEOUT_MS). The old
76
+ // 10-minute default silently truncated every longer request: a caller asking for
77
+ // 1_800_000ms was still failed at 600_000ms.
78
+ const DEFAULT_REPLY_TIMEOUT_MS = 1_800_000;
79
+ const COLOR = "#FF8B39";
80
+
81
+ function flagValue(argv: string[], flag: string): string | null {
82
+ const i = argv.indexOf(flag);
83
+ return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
84
+ }
85
+
86
+ function die(msg: string): never {
87
+ console.error(`coms-claude-bridge: ${msg}`);
88
+ process.exit(1);
89
+ }
90
+
91
+ export function hookWatchDir(paneId: string): string {
92
+ return path.join(os.homedir(), ".pi", "coms", "claude-bridge", paneId.replace(/[^A-Za-z0-9_-]/g, "_"));
93
+ }
94
+
95
+ // ── registry record ──
96
+ //
97
+ // Split in two on purpose. The identity is built ONCE, at registration, and
98
+ // holds `started_at`; the entry is rebuilt on every 30s keepalive from that
99
+ // same identity. The bridge used to rebuild the whole record inline with
100
+ // `started_at: nowIso()`, so the field never held the start of anything and
101
+ // every bridged Claude peer reported an uptime of at most one tick — the bug
102
+ // the pi harnesses fixed by centralising on buildLiveRegistryEntry. Reusing it
103
+ // here rather than keeping a third copy is the point.
104
+
105
+ export function bridgeRegistryIdentity(reg: {
106
+ sessionId: string;
107
+ name: string;
108
+ purpose: string;
109
+ endpoint: string;
110
+ cwd: string;
111
+ startedAt: string;
112
+ }): ComsIdentity {
113
+ return {
114
+ session_id: reg.sessionId,
115
+ name: reg.name,
116
+ purpose: reg.purpose,
117
+ // A bridged pane is Claude Code by construction — there is no live ctx to
118
+ // re-read a model from, so the registered one is the only one.
119
+ model: "claude-code",
120
+ color: COLOR,
121
+ endpoint: reg.endpoint,
122
+ cwd: reg.cwd,
123
+ explicit: false,
124
+ started_at: reg.startedAt,
125
+ };
126
+ }
127
+
128
+ export function bridgeRegistryEntry(
129
+ identity: ComsIdentity,
130
+ live: { now: string; pid: number; queueDepth: number },
131
+ ): RegistryEntry {
132
+ return buildLiveRegistryEntry(identity, {
133
+ now: live.now,
134
+ pid: live.pid,
135
+ // context_used_pct is not observable from outside a Claude pane; 0 is what
136
+ // the agent card and the herdr annotation carry too, so they all agree.
137
+ contextUsedPct: 0,
138
+ queueDepth: live.queueDepth,
139
+ });
140
+ }
141
+
142
+ async function main(): Promise<void> {
143
+ const argv = process.argv.slice(2);
144
+ const name = flagValue(argv, "--name") ?? die("--name <peer-name> is required");
145
+ const project = flagValue(argv, "--project") ?? "default";
146
+ const paneId = flagValue(argv, "--pane") ?? process.env.HERDR_PANE_ID ?? die("--pane <pane_id> required (or run inside a herdr pane)");
147
+ const replyTimeoutMs = Number(flagValue(argv, "--reply-timeout") ?? DEFAULT_REPLY_TIMEOUT_MS);
148
+
149
+ try {
150
+ await requireHerdr();
151
+ } catch (err) {
152
+ if (err instanceof HerdrUnavailableError) die(err.message);
153
+ throw err;
154
+ }
155
+
156
+ // `_claude-peer` backgrounds this bridge before the shell starts Claude Code.
157
+ // Do not publish a coms identity during that gap: Hub peer readiness is based
158
+ // on registration, and an immediate prompt typed into the still-booting pane
159
+ // is lost while the Claude TUI replaces the shell screen.
160
+ const startup = await waitForClaudePaneReady(async () => (await herdr.paneGet(paneId)).pane);
161
+ if (!startup.ready) {
162
+ die(`Claude Code was not detected as ready in pane ${paneId} after ${Math.round(startup.waitedMs / 1000)}s`);
163
+ }
164
+
165
+ // ── identity ──
166
+ ensureComsDirs(project);
167
+ const sessionId = ulid();
168
+ const uniqueName = resolveUniqueName(project, name);
169
+ const id: SenderIdentity = {
170
+ session_id: sessionId,
171
+ name: uniqueName,
172
+ endpoint: makeEndpoint(sessionId),
173
+ cwd: process.cwd(),
174
+ };
175
+ const queue = new PromptQueue<PromptEnvelope>();
176
+ const purpose = "Claude Code (bridged pane)";
177
+
178
+ // Built once — `started_at` is registration time and stays put across every
179
+ // keepalive rebuild below.
180
+ const registryIdentity = bridgeRegistryIdentity({
181
+ sessionId,
182
+ name: uniqueName,
183
+ purpose,
184
+ endpoint: id.endpoint,
185
+ cwd: id.cwd,
186
+ startedAt: nowIso(),
187
+ });
188
+
189
+ function registryEntry(): RegistryEntry {
190
+ return bridgeRegistryEntry(registryIdentity, {
191
+ now: nowIso(),
192
+ pid: process.pid,
193
+ queueDepth: queue.depth,
194
+ });
195
+ }
196
+
197
+ const hookDir = hookWatchDir(paneId);
198
+ fs.mkdirSync(hookDir, { recursive: true });
199
+ const hookFile = path.join(hookDir, "last-message.json");
200
+ // Hook mode flips on permanently the first time the Stop hook writes for
201
+ // this pane; until then prompts carry the sentinel instruction.
202
+ let hookSeen = fs.existsSync(hookFile);
203
+
204
+ // Latest known pane state. The ping handler is synchronous — a pool refresh
205
+ // must not block on a herdr round trip per peer — so it answers from this
206
+ // cache, which `paneStatus()` refreshes on the keepalive and on every poll
207
+ // during a turn. Starts at "booting": registered, nothing observed yet.
208
+ let lastPaneState: PeerStatus = "booting";
209
+ /** What this bridge reports to a sender: a queued prompt already means busy. */
210
+ const peerStatus = (): PeerStatus => (queue.depth > 0 ? "working" : lastPaneState);
211
+
212
+ // ── envelope server ──
213
+ const server = await bindEndpoint(
214
+ id.endpoint,
215
+ makeConnHandler((env, socket) => {
216
+ if (isPromptEnvelope(env)) {
217
+ if (env.hops >= 5) {
218
+ writeNack(socket, env.msg_id, "hops exceeded");
219
+ return;
220
+ }
221
+ queue.push(env);
222
+ writeAck(socket, env.msg_id);
223
+ void pump();
224
+ } else if ((env as { type?: string }).type === "ping") {
225
+ const card: AgentCard = {
226
+ name: uniqueName,
227
+ purpose,
228
+ model: "claude-code",
229
+ color: COLOR,
230
+ context_used_pct: 0,
231
+ queue_depth: queue.depth,
232
+ pane_id: paneId,
233
+ status: peerStatus(),
234
+ };
235
+ try {
236
+ socket.write(JSON.stringify({ type: "pong", msg_id: (env as { msg_id?: string }).msg_id ?? "", agent_card: card }) + "\n");
237
+ } catch { /* ignore */ }
238
+ try { socket.end(); } catch { /* ignore */ }
239
+ } else {
240
+ writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "bridge accepts prompts and pings");
241
+ }
242
+ }),
243
+ );
244
+ writeRegistryAtomic(registryEntry(), project);
245
+ console.error(`coms-claude-bridge: ${uniqueName}@${project} bridging pane ${paneId}`);
246
+
247
+ // ── presence ──
248
+ // Annotation ONLY, never pane.report_agent: this pane's `agent_status` is
249
+ // herdr's own Claude detection, and driveClaude() polls it back to decide a
250
+ // turn is over. A state we reported ourselves would be us answering our own
251
+ // question. Dialect negotiation (tokens on herdr >= 0.7.4, one latched
252
+ // fallback to custom_status) is HerdrPresence's job — a second copy here is
253
+ // how the bridge stayed on the removed field while the pi path was fixed.
254
+ const presence = new HerdrPresence({
255
+ paneId,
256
+ source: `coms-bridge:${sessionId}`,
257
+ agentLabel: "claude",
258
+ onError: (err, dialect) =>
259
+ console.error(`coms-claude-bridge: herdr rejected the ${dialect} annotation: ${err.message}`),
260
+ });
261
+ async function reportPresence(): Promise<void> {
262
+ // context_used_pct is not observable from outside a Claude pane; 0 is
263
+ // what the agent card carries too, so the sidebar and the card agree.
264
+ await presence.annotate({ name: uniqueName, project, contextUsedPct: 0, queueDepth: queue.depth });
265
+ }
266
+ const keepalive = setInterval(() => {
267
+ try {
268
+ writeRegistryAtomic(registryEntry(), project);
269
+ } catch { /* best-effort */ }
270
+ void reportPresence();
271
+ // Keep the ping cache warm between turns, so an idle pane is reported as
272
+ // idle rather than staying "booting" until someone sends to it.
273
+ void paneStatus();
274
+ }, KEEPALIVE_MS);
275
+ keepalive.unref?.();
276
+ void reportPresence();
277
+ void paneStatus();
278
+
279
+ // ── prompt processing (strictly serial) ──
280
+ async function pump(): Promise<void> {
281
+ const item = queue.take();
282
+ if (!item) return;
283
+ const env = item.envelope;
284
+ try {
285
+ const reply = await driveClaude(env);
286
+ await sendEnvelope(env.sender_endpoint, makeResponseEnvelope(id, env.msg_id, reply));
287
+ } catch (err) {
288
+ const message = err instanceof Error ? err.message : String(err);
289
+ if (isReplyPendingError(err)) {
290
+ // No response envelope: the sender's wait expires as `pending`, and may
291
+ // await/get again without treating unfinished work as a failed result.
292
+ console.error(`coms-claude-bridge: ${env.msg_id} remains pending: ${message}`);
293
+ } else {
294
+ try {
295
+ await sendEnvelope(env.sender_endpoint, makeResponseEnvelope(id, env.msg_id, null, message));
296
+ } catch {
297
+ console.error(`coms-claude-bridge: could not deliver error for ${env.msg_id}: ${message}`);
298
+ }
299
+ }
300
+ } finally {
301
+ queue.done();
302
+ void reportPresence();
303
+ void pump(); // next in line
304
+ }
305
+ }
306
+
307
+ async function paneStatus(): Promise<string> {
308
+ try {
309
+ const { pane } = await herdr.paneGet(paneId);
310
+ const status = (pane.agent_status as string) ?? "unknown";
311
+ lastPaneState = paneAgentStatusToPeerStatus(status);
312
+ return status;
313
+ } catch {
314
+ return "unknown";
315
+ }
316
+ }
317
+
318
+ async function driveClaude(env: PromptEnvelope): Promise<string> {
319
+ const sentinelMode = !hookSeen;
320
+ const hookMtimeBefore = fs.existsSync(hookFile) ? fs.statSync(hookFile).mtimeMs : 0;
321
+ // The caller's declared deadline wins over the bridge default (clamped).
322
+ // One absolute deadline covers BOTH idle waiting and the reply; otherwise a
323
+ // two-minute busy wait silently extends the caller's budget.
324
+ const effectiveTimeoutMs = resolveReplyTimeoutMs(env.reply_timeout_ms, replyTimeoutMs);
325
+ const startedAt = Date.now();
326
+ const replyDeadline = replyDeadlineAt(startedAt, effectiveTimeoutMs);
327
+
328
+ // Claude Code must be idle-ish before we type into its input box — but a busy
329
+ // pane is a wait, not a failure. Throwing here made every mid-turn moment a
330
+ // hard error and pushed callers into hot-retry loops.
331
+ const waitDeadline = Math.min(replyDeadline, startedAt + idleWaitBudgetMs(effectiveTimeoutMs));
332
+ const waitStarted = startedAt;
333
+ for (let attempt = 0; ; attempt++) {
334
+ if (await paneStatus() !== "working") break;
335
+ const remaining = waitDeadline - Date.now();
336
+ if (remaining <= 0) {
337
+ throw new Error(
338
+ `Claude Code in pane ${paneId} is still mid-turn after waiting ` +
339
+ `${Math.round((Date.now() - waitStarted) / 1000)}s — try again shortly`,
340
+ );
341
+ }
342
+ await new Promise((r) => setTimeout(r, Math.min(idleWaitDelayMs(attempt), remaining)));
343
+ }
344
+
345
+ await herdr.paneSendText(paneId, formatPanePrompt(env, sentinelMode));
346
+ await new Promise((r) => setTimeout(r, ENTER_DELAY_MS));
347
+ await herdr.paneSendKeys(paneId, ["enter"]);
348
+
349
+ // The sender's local await returns `pending` at replyDeadline, but the
350
+ // bridge keeps watching the already-running turn up to the hard cap so a
351
+ // late completion can still resolve the original msg_id.
352
+ const monitorDeadline = replyDeadlineAt(startedAt, REPLY_TIMEOUT_HARD_CAP_MS);
353
+ let pendingLogged = false;
354
+ let sawWorking = false;
355
+ while (Date.now() < monitorDeadline) {
356
+ await new Promise((r) => setTimeout(r, POLL_MS));
357
+ if (!pendingLogged && Date.now() >= replyDeadline) {
358
+ pendingLogged = true;
359
+ console.error(`coms-claude-bridge: ${env.msg_id} exceeded its reply budget and remains pending`);
360
+ }
361
+
362
+ // primary: Stop hook wrote a new record
363
+ if (fs.existsSync(hookFile)) {
364
+ const mtime = fs.statSync(hookFile).mtimeMs;
365
+ if (mtime > hookMtimeBefore) {
366
+ const rec = parseHookRecord(fs.readFileSync(hookFile, "utf-8"));
367
+ if (rec) {
368
+ hookSeen = true;
369
+ return rec.text;
370
+ }
371
+ }
372
+ }
373
+
374
+ const status = await paneStatus();
375
+ if (status === "working") sawWorking = true;
376
+ if (status === "blocked") {
377
+ throw new Error(
378
+ `Claude Code in pane ${paneId} is blocked on a permission prompt — a human must approve it in the pane`,
379
+ );
380
+ }
381
+ // fallback: turn ended without a hook record → scrape the sentinel
382
+ if (sentinelMode && sawWorking && (status === "done" || status === "idle")) {
383
+ const read = await herdr.paneRead({ pane_id: paneId, source: "recent", lines: 200 });
384
+ const reply = extractSentinelReply(read.read.text, env.msg_id);
385
+ if (reply) return reply;
386
+ // sentinel not visible yet — keep polling until deadline
387
+ }
388
+ }
389
+ throw new ReplyPendingError(
390
+ `no reply from Claude Code before the ${REPLY_TIMEOUT_HARD_CAP_MS}ms hard monitoring cap (requested ${effectiveTimeoutMs}ms)` +
391
+ (sentinelMode ? " (Stop hook not installed? see .pi/agent-fleet/hooks/coms-stop-hook.mjs)" : ""),
392
+ );
393
+ }
394
+
395
+ // ── shutdown ──
396
+ let shuttingDown = false;
397
+ function shutdown(): void {
398
+ if (shuttingDown) return;
399
+ shuttingDown = true;
400
+ clearInterval(keepalive);
401
+ try { server.close(); } catch { /* ignore */ }
402
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
403
+ removeRegistryEntry(project, uniqueName);
404
+ process.exit(0);
405
+ }
406
+ process.on("SIGTERM", shutdown);
407
+ process.on("SIGINT", shutdown);
408
+ }
409
+
410
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
411
+ if (isEntry) void main();