@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,773 @@
1
+ """Source C — what a session is doing RIGHT NOW, from its own transcript.
2
+
3
+ The registry says a session exists; herdr says whether a pane looks busy. Neither
4
+ can say what the busy-ness IS. pi already writes every message it sends and
5
+ receives to `~/.pi/agent/sessions/<cwd-slug>/<ts>_<uuid>.jsonl`, whether or not
6
+ anybody is watching — which is why this source works for a `detached` session
7
+ that no pane hosts at all.
8
+
9
+ Three rules hold this module up.
10
+
11
+ **The mapping is authoritative through `boot`, never through the slug.** The
12
+ slug (`/home/x/repo` -> `--home-x-repo--`) only narrows the search; the match is
13
+ `coms-log/boot.session_id == registry.session_id`. A cwd routinely holds a dozen
14
+ transcripts — every resumed session, every restart, and a pi and a Claude Code
15
+ pane can share it exactly — so a slug-only rule would pick a stranger's file and
16
+ report its work as this agent's. Picking the wrong transcript is the failure
17
+ mode this whole module is shaped to avoid: it is not "no data", it is confident
18
+ fiction.
19
+
20
+ **Bounded reads only.** A long session's transcript is megabytes and it is being
21
+ appended to while we read it. The tail is capped, the reverse scan for `boot`
22
+ is capped, the candidate list is capped, and every parse is cached on
23
+ `(path, size, mtime)` so a 3s poll of an idle agent costs one `stat`.
24
+
25
+ **Projection, not forwarding.** A transcript holds everything the agent has ever
26
+ read — file contents, tool output, whatever the user pasted. Nothing is
27
+ forwarded wholesale. Each step becomes `{seq, at, kind, label, detail}` and a
28
+ tool's arguments pass a PER-TOOL allowlist: `bash` yields its command, `read`
29
+ yields a path, `dispatch_agent` yields the target agent. A tool nobody listed
30
+ yields its name and nothing else, which is the safe direction to be wrong in.
31
+
32
+ `seq` is the byte offset of the end of the line a step came from. It is monotone
33
+ within a file, survives the file growing under us, and needs no state on either
34
+ side — the cursor IS the position in the transcript.
35
+ """
36
+
37
+ import json
38
+ import re
39
+ from collections import OrderedDict
40
+ from datetime import datetime, timezone
41
+ from pathlib import Path
42
+
43
+ # The tail we are willing to read for steps. ~256 KB is several hundred messages
44
+ # — far more than a pane shows — and a hard ceiling on what a poll costs.
45
+ TAIL_BYTES = 256 * 1024
46
+
47
+ # Reload/resume appends another boot in the same file. Find the latest complete
48
+ # boot within a bounded suffix; never fall back to a superseded head identity.
49
+ # Older boots outside this window are unavailable until a new boot is visible.
50
+ BOOT_BYTES = 4 * 1024 * 1024
51
+
52
+ # Newest-first, by mtime. A cwd with more transcripts than this has older ones
53
+ # that cannot belong to a session the registry currently calls live.
54
+ MAX_CANDIDATES = 24
55
+
56
+ # Per step. Long enough for a git command to still be recognisable, short enough
57
+ # that a step is one line in a 300px pane.
58
+ DETAIL_CHARS = 140
59
+
60
+ DEFAULT_LIMIT = 50
61
+ MAX_LIMIT = 200
62
+
63
+ # Parsed tails and boot records, keyed so a changed file misses. Bounded because
64
+ # a gateway runs for days and every project the human touches lands here.
65
+ CACHE_ENTRIES = 32
66
+
67
+ # What each tool is allowed to say about itself. The KEY is the tool name and
68
+ # the VALUE is the ordered list of argument names that may be shown — everything
69
+ # else in the call is dropped. A tool that is not in this map is rendered by name
70
+ # alone: new tools appear all the time and the default must not be "spill it".
71
+ _TOOL_DETAIL = {
72
+ "bash": ("command",),
73
+ "read": ("path",),
74
+ "write": ("path",),
75
+ "edit": ("path",),
76
+ "ls": ("path",),
77
+ "glob": ("pattern",),
78
+ "grep": ("pattern",),
79
+ "find": ("pattern", "glob"),
80
+ "dispatch_agent": ("agent",),
81
+ "spawn_research": ("persona",),
82
+ "coms_send": ("target",),
83
+ "coms_await": ("target",),
84
+ "coms_list": (),
85
+ "herdr_read_pane": ("pane_id",),
86
+ "herdr_spawn_peer": ("name",),
87
+ "herdr_close_pane": ("pane_id",),
88
+ "ask_user": ("question",),
89
+ "set_task_tier": ("tier",),
90
+ "request_compaction": ("reason",),
91
+ }
92
+
93
+ # Tools whose whole point is that work left this agent — worth their own kind so
94
+ # a human reading the timeline can see the fan-out.
95
+ _DISPATCH_TOOLS = {"dispatch_agent", "spawn_research", "coms_send", "coms_await", "herdr_spawn_peer"}
96
+
97
+ # Tools that stop and wait for a human. The row's `blocked` state comes from
98
+ # herdr; this is the same fact from the other side, with the question attached.
99
+ _BLOCKED_TOOLS = {"ask_user"}
100
+
101
+ KIND_TOOL = "tool"
102
+ KIND_ASSISTANT = "assistant"
103
+ KIND_DISPATCH = "dispatch"
104
+ KIND_BLOCKED = "blocked"
105
+ KIND_DONE = "done"
106
+
107
+ # coms-log records worth a step, and the ONE field of each that may be shown.
108
+ # `inbound_prompt` carries a `sender` session id and `outbound_response` an
109
+ # error object; neither is offered, for the same reason `session_id` never
110
+ # leaves sessions.py.
111
+ _COMS_EVENT = {
112
+ "inbound_prompt": (KIND_DISPATCH, "prompt received", None),
113
+ "outbound_prompt": (KIND_DISPATCH, "prompt sent", "target"),
114
+ "outbound_response": (KIND_DISPATCH, "answered a peer", None),
115
+ "outbound_response_failed": (KIND_DISPATCH, "could not answer a peer", "reason"),
116
+ "shutdown": (KIND_DONE, "session shut down", None),
117
+ }
118
+
119
+ # What a turn ending is called. `toolUse` / `tool_use` is not here on purpose:
120
+ # it means the turn is CONTINUING, and announcing it as an end would make every
121
+ # working agent read as finished.
122
+ _STOP_LABEL = {
123
+ "stop": "finished the turn",
124
+ "error": "the turn failed",
125
+ "aborted": "the turn was aborted",
126
+ # Claude Code's dialect of the same field.
127
+ "end_turn": "finished the turn",
128
+ "max_tokens": "the turn ran out of room",
129
+ "refusal": "the turn was refused",
130
+ }
131
+
132
+ # ── the Claude Code dialect ────────────────────────────────────────────────
133
+ #
134
+ # A bridged Claude Code peer writes an ENTIRELY different file: the Anthropic
135
+ # message shape, `tool_use` instead of `toolCall`, `input` instead of
136
+ # `arguments`, PascalCase tool names, and the record type at the top level
137
+ # rather than under `type: "message"`. Two dialects, one projection — the panel
138
+ # must not care which agent it is watching.
139
+ _CLAUDE_TOOL_DETAIL = {
140
+ "Bash": ("command",),
141
+ "Read": ("file_path",),
142
+ "Write": ("file_path",),
143
+ "Edit": ("file_path",),
144
+ "NotebookEdit": ("notebook_path",),
145
+ "Glob": ("pattern",),
146
+ "Grep": ("pattern",),
147
+ "Task": ("subagent_type", "description"),
148
+ "Agent": ("subagent_type", "description"),
149
+ "SendMessage": ("agent_id",),
150
+ "WebFetch": ("url",),
151
+ "WebSearch": ("query",),
152
+ "Skill": ("skill",),
153
+ "AskUserQuestion": (),
154
+ "TodoWrite": (),
155
+ }
156
+
157
+ _CLAUDE_DISPATCH_TOOLS = {"Task", "Agent", "SendMessage"}
158
+ _CLAUDE_BLOCKED_TOOLS = {"AskUserQuestion", "ExitPlanMode"}
159
+
160
+ # Where the Stop hook leaves the only authoritative link between a coms peer and
161
+ # a Claude Code transcript. See `claude_transcript`.
162
+ BRIDGE_HOOK_BASENAME = "last-message.json"
163
+
164
+ # A Claude Code session id, strictly. It is interpolated into a path, so it may
165
+ # contain nothing that could climb out of one.
166
+ _CLAUDE_SESSION_RE = re.compile(r"^[0-9a-fA-F][0-9a-fA-F-]{7,63}$")
167
+
168
+ # What the bridge does to a herdr pane id before using it as a directory name
169
+ # (`hookWatchDir` in .pi/agent-fleet/scripts/coms-claude-bridge.ts). Copied rather than derived:
170
+ # it has to agree character for character with the writer.
171
+ _PANE_DIR_SAFE = re.compile(r"[^A-Za-z0-9_-]")
172
+
173
+ # The registry `model` a bridged Claude Code peer registers with
174
+ # (coms-claude-bridge.ts). It is the discriminator for which reader to use, and
175
+ # it is why a pi peer never pays for the herdr lookup this one needs.
176
+ CLAUDE_MODEL = "claude-code"
177
+
178
+
179
+ def sessions_root() -> Path:
180
+ return Path.home() / ".pi" / "agent" / "sessions"
181
+
182
+
183
+ def slug_for_cwd(cwd: str) -> str:
184
+ """`/home/x/repo` -> `--home-x-repo--`.
185
+
186
+ A port of the one line pi encodes with (`migrations.js:101`):
187
+ strip the leading separator, then `/`, `\\` and `:` all become `-`, wrapped
188
+ in a leading and trailing `--`. Every other character — dots included —
189
+ survives, which is why `agent-fleet.hermes-plugin` keeps its dot.
190
+ """
191
+ if not isinstance(cwd, str) or not cwd:
192
+ return ""
193
+ trimmed = cwd.lstrip("/\\")
194
+ flattened = trimmed.replace("/", "-").replace("\\", "-").replace(":", "-")
195
+ return f"--{flattened}--"
196
+
197
+
198
+ def candidate_paths(cwd: str, root: Path | None = None) -> list[Path]:
199
+ """Transcripts for this cwd, newest first. Never raises.
200
+
201
+ Newest first because the match usually lands on the first file, and the scan
202
+ stops as soon as `boot` agrees — so the common case scans one bounded file.
203
+ """
204
+ slug = slug_for_cwd(cwd)
205
+ if not slug:
206
+ return []
207
+ folder = (Path(root) if root is not None else sessions_root()) / slug
208
+ try:
209
+ files = [child for child in folder.iterdir() if child.suffix == ".jsonl" and child.is_file()]
210
+ except OSError:
211
+ return []
212
+ try:
213
+ files.sort(key=lambda path: path.stat().st_mtime, reverse=True)
214
+ except OSError:
215
+ files.sort(reverse=True)
216
+ return files[:MAX_CANDIDATES]
217
+
218
+
219
+ class _Cache(OrderedDict):
220
+ """Smallest possible LRU. Correctness lives in the key, not in here."""
221
+
222
+ def take(self, key):
223
+ value = self.get(key)
224
+ if value is not None:
225
+ self.move_to_end(key)
226
+ return value
227
+
228
+ def put(self, key, value):
229
+ self[key] = value
230
+ self.move_to_end(key)
231
+ while len(self) > CACHE_ENTRIES:
232
+ self.popitem(last=False)
233
+ return value
234
+
235
+
236
+ _boot_cache = _Cache()
237
+ _tail_cache = _Cache()
238
+
239
+
240
+ def _stat(path: Path):
241
+ try:
242
+ return path.stat()
243
+ except OSError:
244
+ return None
245
+
246
+
247
+ def boot_identity(path: Path) -> dict | None:
248
+ """`{session_id, name, project}` from the latest complete visible coms boot.
249
+
250
+ `None` when the bounded suffix has no boot. This includes sessions that never
251
+ joined coms and boots beyond the scan window; identity is never guessed.
252
+ """
253
+ info = _stat(path)
254
+ if info is None:
255
+ return None
256
+ # Appended reload boots and same-size replacements must invalidate identity.
257
+ key = (str(path), info.st_dev, info.st_ino, info.st_size, info.st_mtime_ns)
258
+ cached = _boot_cache.take(key)
259
+ if cached is not None:
260
+ return cached.get("identity")
261
+
262
+ identity = None
263
+ try:
264
+ with open(path, "rb") as handle:
265
+ start = max(0, info.st_size - BOOT_BYTES)
266
+ handle.seek(start)
267
+ data_bytes = handle.read(min(info.st_size, BOOT_BYTES))
268
+ if start:
269
+ cut = data_bytes.find(b"\n")
270
+ data_bytes = data_bytes[cut + 1:] if cut >= 0 else b""
271
+ except OSError:
272
+ data_bytes = b""
273
+ for line in reversed(data_bytes.split(b"\n")[:-1]):
274
+ try:
275
+ record = json.loads(line.decode("utf-8", "replace"))
276
+ except ValueError:
277
+ continue
278
+ if not isinstance(record, dict) or record.get("customType") != "coms-log":
279
+ continue
280
+ data = record.get("data")
281
+ if isinstance(data, dict) and data.get("event") == "boot" and data.get("session_id"):
282
+ identity = {
283
+ "session_id": str(data.get("session_id")),
284
+ "name": data.get("name"),
285
+ "project": data.get("project"),
286
+ }
287
+ break
288
+ _boot_cache.put(key, {"identity": identity})
289
+ return identity
290
+
291
+
292
+ def find_transcript(cwd: str, session_id: str, root: Path | None = None) -> Path | None:
293
+ """The transcript belonging to THIS coms session, or None.
294
+
295
+ The slug narrows; `boot` decides. A candidate whose boot names a different
296
+ session is skipped rather than used as a fallback — an approximate answer
297
+ here is a confident lie about what another agent is doing.
298
+ """
299
+ if not isinstance(session_id, str) or not session_id:
300
+ return None
301
+ for path in candidate_paths(cwd, root):
302
+ identity = boot_identity(path)
303
+ if identity is not None and identity.get("session_id") == session_id:
304
+ return path
305
+ return None
306
+
307
+
308
+ def claude_projects_root() -> Path:
309
+ return Path.home() / ".claude" / "projects"
310
+
311
+
312
+ def bridge_hook_root() -> Path:
313
+ """Where coms-claude-bridge.ts keeps its per-pane hook directories."""
314
+ return Path.home() / ".pi" / "coms" / "claude-bridge"
315
+
316
+
317
+ def bridge_hook_path(pane_id: str, root: Path | None = None) -> Path | None:
318
+ """`~/.pi/coms/claude-bridge/<pane>/last-message.json` for a herdr pane.
319
+
320
+ The pane id is sanitised exactly as `hookWatchDir()` in
321
+ .pi/agent-fleet/scripts/coms-claude-bridge.ts sanitises it — copied rather than derived,
322
+ because it has to agree with the writer character for character, and because
323
+ that same rule is what keeps a herdr-supplied string out of the filesystem.
324
+ """
325
+ if not isinstance(pane_id, str) or not pane_id:
326
+ return None
327
+ folder = _PANE_DIR_SAFE.sub("_", pane_id)
328
+ if not folder or folder.strip("_") == "":
329
+ return None
330
+ base = Path(root) if root is not None else bridge_hook_root()
331
+ return base / folder / BRIDGE_HOOK_BASENAME
332
+
333
+
334
+ def claude_transcript(pane_id: str, hook_root: Path | None = None, projects_root: Path | None = None) -> Path | None:
335
+ """The Claude Code transcript for a bridged peer, or None.
336
+
337
+ This is the whole reason the Stop hook writes `transcript_path`. The bridge
338
+ mints its OWN coms session id (`ulid()` in coms-claude-bridge.ts) and Claude
339
+ Code knows nothing about it, so there is no shared identifier anywhere on
340
+ disk except the one the hook puts there. Without it the only available rule
341
+ would be "newest transcript in this cwd" — and a cwd routinely holds a dozen,
342
+ which is exactly the guess this module refuses to make for pi sessions.
343
+
344
+ Two consequences worth stating. A peer whose Stop hook has never fired has
345
+ no link yet, and answers `available: false` rather than a guess. And the
346
+ chain runs through the herdr pane, so a `detached` Claude Code peer cannot be
347
+ matched at all — which is the opposite of the pi case, and honest.
348
+ """
349
+ hook = bridge_hook_path(pane_id, hook_root)
350
+ if hook is None:
351
+ return None
352
+ try:
353
+ record = json.loads(hook.read_text(encoding="utf-8"))
354
+ except (OSError, ValueError):
355
+ return None
356
+ if not isinstance(record, dict):
357
+ return None
358
+
359
+ root = Path(projects_root) if projects_root is not None else claude_projects_root()
360
+ # Preferred: the path Claude Code itself handed the hook. Confined to the
361
+ # transcript root before it is opened — it arrives from a file another
362
+ # process writes, so it is an input, not a fact.
363
+ claimed = record.get("transcript_path")
364
+ if isinstance(claimed, str) and claimed.endswith(".jsonl"):
365
+ candidate = Path(claimed)
366
+ try:
367
+ candidate.relative_to(root)
368
+ except ValueError:
369
+ candidate = None
370
+ if candidate is not None and candidate.is_file():
371
+ return candidate
372
+
373
+ # Fallback for a hook that predates `transcript_path`: the session id names
374
+ # the file. Searched rather than slugged — the id is unique across every
375
+ # project, so there is no encoding rule to get wrong.
376
+ session_id = record.get("session_id")
377
+ if not isinstance(session_id, str) or not _CLAUDE_SESSION_RE.match(session_id):
378
+ return None
379
+ try:
380
+ for folder in root.iterdir():
381
+ candidate = folder / f"{session_id}.jsonl"
382
+ if candidate.is_file():
383
+ return candidate
384
+ except OSError:
385
+ return None
386
+ return None
387
+
388
+
389
+ def _steps_from_claude(record: dict, seq: int) -> list[dict]:
390
+ """One line of a Claude Code transcript -> steps.
391
+
392
+ Same allowlist discipline as the pi reader, applied to a different shape:
393
+ `tool_use`/`input` rather than `toolCall`/`arguments`, and the record's own
394
+ `timestamp` because the inner message carries none at all.
395
+ """
396
+ if record.get("type") != "assistant":
397
+ return []
398
+ message = record.get("message")
399
+ if not isinstance(message, dict):
400
+ return []
401
+
402
+ at = record.get("timestamp") if isinstance(record.get("timestamp"), str) else None
403
+ steps: list[dict] = []
404
+ for item in message.get("content") or []:
405
+ if not isinstance(item, dict):
406
+ continue
407
+ if item.get("type") == "tool_use":
408
+ name = item.get("name") or "tool"
409
+ if name in _CLAUDE_BLOCKED_TOOLS:
410
+ kind = KIND_BLOCKED
411
+ elif name in _CLAUDE_DISPATCH_TOOLS:
412
+ kind = KIND_DISPATCH
413
+ else:
414
+ kind = KIND_TOOL
415
+ steps.append(
416
+ _step(seq, at, kind, str(name), tool_detail(name, item.get("input"), _CLAUDE_TOOL_DETAIL))
417
+ )
418
+ elif item.get("type") == "text" and isinstance(item.get("text"), str) and item["text"].strip():
419
+ steps.append(_step(seq, at, KIND_ASSISTANT, "said", _clip(item["text"])))
420
+
421
+ stop = message.get("stop_reason")
422
+ if stop in _STOP_LABEL:
423
+ steps.append(_step(seq, at, KIND_DONE, _STOP_LABEL[stop]))
424
+ return steps
425
+
426
+
427
+ def read_tail(path: Path, budget: int = TAIL_BYTES) -> list[tuple[int, str]]:
428
+ """The last `budget` bytes as `(end_offset, line)`, whole lines only.
429
+
430
+ Both ends are cut on purpose. The FIRST line is dropped whenever the read
431
+ started mid-file, because a byte budget lands in the middle of a JSON object
432
+ and half an object is not a smaller object. The LAST line is dropped unless
433
+ it ended in a newline, because pi is appending to this file as we read it and
434
+ a line without its terminator is a line still being written.
435
+ """
436
+ info = _stat(path)
437
+ if info is None:
438
+ return []
439
+ start = max(0, info.st_size - max(0, budget))
440
+ try:
441
+ with open(path, "rb") as handle:
442
+ handle.seek(start)
443
+ data = handle.read()
444
+ except OSError:
445
+ return []
446
+
447
+ offset = start
448
+ if start > 0:
449
+ cut = data.find(b"\n")
450
+ if cut < 0:
451
+ return []
452
+ offset = start + cut + 1
453
+ data = data[cut + 1 :]
454
+
455
+ rows: list[tuple[int, str]] = []
456
+ pieces = data.split(b"\n")
457
+ # `split` leaves the bytes after the final newline as the last element: empty
458
+ # when the file ends cleanly, a partial record when it does not. Either way
459
+ # it is not ours to parse.
460
+ for piece in pieces[:-1]:
461
+ offset += len(piece) + 1
462
+ text = piece.decode("utf-8", "replace").strip()
463
+ if text:
464
+ rows.append((offset, text))
465
+ return rows
466
+
467
+
468
+ def _clip(value) -> str:
469
+ """One line, bounded. Newlines become spaces so a step stays a step.
470
+
471
+ Only scalars render. A list or a dict where a string was expected is the
472
+ shape changing under us, and `str()` on one of those would paste an entire
473
+ nested structure — the exact thing the allowlist exists to prevent — so it
474
+ renders as nothing instead.
475
+ """
476
+ if isinstance(value, bool) or isinstance(value, (int, float)):
477
+ value = str(value)
478
+ if not isinstance(value, str):
479
+ return ""
480
+ collapsed = " ".join(value.split())
481
+ if len(collapsed) <= DETAIL_CHARS:
482
+ return collapsed
483
+ return collapsed[: DETAIL_CHARS - 1] + "…"
484
+
485
+
486
+ def tool_detail(name, arguments, allowlist=None) -> str:
487
+ """The allowlisted part of a tool call, or the empty string.
488
+
489
+ An unlisted tool gets nothing — not a truncated dump, not the first
490
+ argument. The allowlist is the security boundary and the default has to fail
491
+ closed, because the argument that is not on the list is exactly the one
492
+ holding a file's contents or somebody's token.
493
+
494
+ `allowlist` selects the dialect: pi's tools by default, Claude Code's when
495
+ the caller says so. They are separate maps rather than one merged map so a
496
+ name that exists in both cannot inherit the other one's fields.
497
+ """
498
+ fields = (allowlist if allowlist is not None else _TOOL_DETAIL).get(name if isinstance(name, str) else "")
499
+ if not fields or not isinstance(arguments, dict):
500
+ return ""
501
+ parts = [_clip(arguments.get(field)) for field in fields]
502
+ return _clip(" ".join(part for part in parts if part))
503
+
504
+
505
+ def _when(record: dict, message: dict | None = None) -> str | None:
506
+ """The ISO instant a record was appended, from whichever field carries one.
507
+
508
+ There are two timestamps in a pi message envelope and they are neither the
509
+ same clock nor the same encoding: the RECORD's is an ISO string written when
510
+ the line was appended, the MESSAGE's is epoch milliseconds stamped when the
511
+ turn was requested. The record's is both the one we want — "how long ago did
512
+ this happen" — and the one that already parses.
513
+ """
514
+ at = record.get("timestamp")
515
+ if isinstance(at, str) and at:
516
+ return at
517
+ at = (message or {}).get("timestamp")
518
+ if isinstance(at, str) and at:
519
+ return at
520
+ if isinstance(at, (int, float)) and not isinstance(at, bool):
521
+ return (
522
+ datetime.fromtimestamp(at / 1000, timezone.utc).isoformat(timespec="milliseconds").replace("+00:00", "Z")
523
+ )
524
+ return None
525
+
526
+
527
+ def _step(seq: int, at, kind: str, label: str, detail: str = "") -> dict:
528
+ return {
529
+ "seq": seq,
530
+ "at": at if isinstance(at, str) else None,
531
+ "kind": kind,
532
+ "label": label,
533
+ "detail": detail,
534
+ }
535
+
536
+
537
+ def _steps_from_message(record: dict, seq: int) -> list[dict]:
538
+ message = record.get("message") if isinstance(record.get("message"), dict) else record
539
+ if message.get("role") != "assistant":
540
+ # Deliberately only the assistant side. `user` content is arbitrary text
541
+ # the human pasted, and a `toolResult` is the OUTPUT of a call whose name
542
+ # the timeline already shows — the two largest ways to leak a transcript
543
+ # into a renderer, for the least gain.
544
+ return []
545
+
546
+ at = _when(record, message)
547
+ steps: list[dict] = []
548
+ for item in message.get("content") or []:
549
+ if not isinstance(item, dict):
550
+ continue
551
+ if item.get("type") == "toolCall":
552
+ name = item.get("name") or "tool"
553
+ if name in _BLOCKED_TOOLS:
554
+ kind = KIND_BLOCKED
555
+ elif name in _DISPATCH_TOOLS:
556
+ kind = KIND_DISPATCH
557
+ else:
558
+ kind = KIND_TOOL
559
+ steps.append(_step(seq, at, kind, str(name), tool_detail(name, item.get("arguments"))))
560
+ elif item.get("type") == "text" and isinstance(item.get("text"), str) and item["text"].strip():
561
+ steps.append(_step(seq, at, KIND_ASSISTANT, "said", _clip(item["text"])))
562
+ # `thinking` is skipped: it is the largest block in the file and the one
563
+ # the model was told nobody would read.
564
+
565
+ stop = message.get("stopReason")
566
+ if stop in _STOP_LABEL:
567
+ steps.append(_step(seq, at, KIND_DONE, _STOP_LABEL[stop]))
568
+ return steps
569
+
570
+
571
+ def _steps_from_custom(record: dict, seq: int) -> list[dict]:
572
+ if record.get("customType") != "coms-log":
573
+ return []
574
+ data = record.get("data")
575
+ if not isinstance(data, dict):
576
+ return []
577
+ mapped = _COMS_EVENT.get(data.get("event"))
578
+ if mapped is None:
579
+ return []
580
+ kind, label, field = mapped
581
+ return [_step(seq, _when(record), kind, label, _clip(data.get(field)) if field else "")]
582
+
583
+
584
+ def project_steps(rows: list[tuple[int, str]]) -> list[dict]:
585
+ """`(offset, line)` pairs -> the timeline, oldest first.
586
+
587
+ A line that will not parse is skipped without comment: at the head of a tail
588
+ it is a record we cut in half, and anywhere else it is one pi was still
589
+ writing. Neither is worth an error in a panel.
590
+ """
591
+ steps: list[dict] = []
592
+ for seq, text in rows:
593
+ try:
594
+ record = json.loads(text)
595
+ except ValueError:
596
+ continue
597
+ if not isinstance(record, dict):
598
+ continue
599
+ kind = record.get("type")
600
+ if kind == "message":
601
+ steps.extend(_steps_from_message(record, seq))
602
+ elif kind == "custom":
603
+ steps.extend(_steps_from_custom(record, seq))
604
+ elif kind == "assistant":
605
+ # The Claude Code dialect puts the role at the top level. The two
606
+ # never collide: pi writes `type: "message"` and nothing else.
607
+ steps.extend(_steps_from_claude(record, seq))
608
+ return steps
609
+
610
+
611
+ def steps_for_path(path: Path) -> list[dict]:
612
+ """The parsed tail, cached on `(path, size, mtime)`.
613
+
614
+ An idle agent's transcript does not change, and the pane polls it every 3
615
+ seconds; without this the panel would re-parse a quarter of a megabyte to
616
+ render the same list.
617
+ """
618
+ info = _stat(path)
619
+ if info is None:
620
+ return []
621
+ key = (str(path), info.st_size, info.st_mtime_ns)
622
+ cached = _tail_cache.take(key)
623
+ if cached is not None:
624
+ return cached["steps"]
625
+ steps = project_steps(read_tail(path))
626
+ _tail_cache.put(key, {"steps": steps})
627
+ return steps
628
+
629
+
630
+ def _age_s(value, now_ms: float) -> int | None:
631
+ parsed = None
632
+ if isinstance(value, str) and value:
633
+ try:
634
+ parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
635
+ except ValueError:
636
+ parsed = None
637
+ if parsed is None:
638
+ return None
639
+ if parsed.tzinfo is None:
640
+ parsed = parsed.replace(tzinfo=timezone.utc)
641
+ return max(0, int((now_ms - parsed.timestamp() * 1000) / 1000))
642
+
643
+
644
+ def unavailable(reason: str) -> dict:
645
+ """The honest answer, which is a 200. There is no error shape here.
646
+
647
+ A session with no transcript is the ordinary case — a Claude Code peer, a
648
+ session started before pi wrote sessions, a cwd that moved — and a panel that
649
+ turned that into a red box would be crying wolf several times a minute.
650
+ """
651
+ return {"available": False, "reason": reason, "steps": [], "current": None, "seq": 0}
652
+
653
+
654
+ def transcript_for_entry(entry: dict, pane_id=None, root: Path | None = None) -> tuple[Path | None, str]:
655
+ """The file to read for this peer, and — when there is none — why not.
656
+
657
+ Two agents, two dialects, two entirely different ways of being found. A pi
658
+ peer is matched through the `boot` record inside its own transcript, which
659
+ works whether or not anything is watching it. A bridged Claude Code peer has
660
+ no such record — the bridge invents its coms session id and Claude Code has
661
+ never heard of it — so the link runs through the herdr pane and the Stop
662
+ hook, and it exists only once that hook has fired.
663
+ """
664
+ if entry.get("model") == CLAUDE_MODEL:
665
+ if not pane_id:
666
+ return None, "no herdr pane hosts this bridged peer, so its transcript cannot be identified"
667
+ path = claude_transcript(str(pane_id))
668
+ if path is None:
669
+ return None, "no Claude Code transcript is linked yet — the Stop hook writes the link on its first turn"
670
+ return path, ""
671
+
672
+ session_id = entry.get("session_id")
673
+ cwd = entry.get("cwd")
674
+ if not session_id or not cwd:
675
+ return None, "this session predates the transcript link"
676
+ path = find_transcript(str(cwd), str(session_id), root)
677
+ if path is None:
678
+ return None, "no pi transcript matches this session"
679
+ return path, ""
680
+
681
+
682
+ def activity_for_entry(
683
+ entry: dict,
684
+ after: int = 0,
685
+ limit: int = DEFAULT_LIMIT,
686
+ root: Path | None = None,
687
+ now_ms: float | None = None,
688
+ pane_id=None,
689
+ ) -> dict:
690
+ """`{available, steps, current, seq}` for one registry entry.
691
+
692
+ `after` is a byte offset into the transcript, handed back as `seq`. Steps
693
+ from the same line share one `seq` and are therefore taken or skipped
694
+ together, which is why the limit is applied in whole lines: a cursor that
695
+ landed inside a line would silently drop the other tool calls in it.
696
+ """
697
+ path, reason = transcript_for_entry(entry, pane_id=pane_id, root=root)
698
+ if path is None:
699
+ return unavailable(reason)
700
+
701
+ now_ms = now_ms if now_ms is not None else datetime.now(timezone.utc).timestamp() * 1000
702
+ steps = steps_for_path(path)
703
+ # Computed before the cursor is applied: "what is it doing" is the last thing
704
+ # in the file, not the last thing this particular client has not seen yet.
705
+ last = steps[-1] if steps else None
706
+ current = None
707
+ if last is not None:
708
+ current = {
709
+ "kind": last["kind"],
710
+ "label": last["label"],
711
+ "detail": last["detail"],
712
+ "at": last["at"],
713
+ "since_s": _age_s(last["at"], now_ms),
714
+ }
715
+
716
+ limit = max(1, min(int(limit or DEFAULT_LIMIT), MAX_LIMIT))
717
+ fresh = [step for step in steps if step["seq"] > max(0, after)]
718
+ if len(fresh) > limit:
719
+ # Trimmed from the FRONT — the newest steps are the ones being asked
720
+ # about. A cut landing inside a line (an assistant turn with three tool
721
+ # calls shares one `seq`) is widened BACKWARDS to take the whole line:
722
+ # the next cursor is a byte offset, so a line returned in part could
723
+ # never be completed, and overshooting a soft budget by two steps is
724
+ # cheaper than losing them.
725
+ cut = len(fresh) - limit
726
+ boundary = fresh[cut]["seq"]
727
+ while cut > 0 and fresh[cut - 1]["seq"] == boundary:
728
+ cut -= 1
729
+ fresh = fresh[cut:]
730
+
731
+ return {
732
+ "available": True,
733
+ "reason": "",
734
+ "steps": fresh,
735
+ "current": current,
736
+ # The end of the file, not the end of what we returned: a client that
737
+ # asked for 50 steps out of 200 must not spend three round trips
738
+ # crawling forward through history it will never render.
739
+ "seq": steps[-1]["seq"] if steps else max(0, after),
740
+ }
741
+
742
+
743
+ def find_entry(projects: dict[str, list[dict]], project: str, name: str) -> dict | None:
744
+ for entry in projects.get(project) or []:
745
+ if entry.get("name") == name:
746
+ return entry
747
+ return None
748
+
749
+
750
+ def _main(argv: list[str]) -> int:
751
+ """`python3 activity.py <project> <name>` — what the panel would be shown.
752
+
753
+ The same question the pane asks, without a Desktop window: it is the fastest
754
+ way to tell "no transcript" from "the wrong transcript".
755
+ """
756
+ import coms_registry
757
+
758
+ if len(argv) != 2:
759
+ print("usage: activity.py <project> <name>")
760
+ return 2
761
+ project, name = argv
762
+ entry = find_entry(coms_registry.live_sessions_by_project(), project, name)
763
+ if entry is None:
764
+ print(json.dumps(unavailable(f"no live session {name!r} in project {project!r}"), indent=2))
765
+ return 1
766
+ print(json.dumps(activity_for_entry(entry), indent=2))
767
+ return 0
768
+
769
+
770
+ if __name__ == "__main__":
771
+ import sys
772
+
773
+ raise SystemExit(_main(sys.argv[1:]))