@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,706 @@
1
+ import { resultFromToolEvent } from "./specialist-result-receipt.ts";
2
+ import type { SpecialistResult } from "./specialist-result.ts";
3
+ import { createContextContinuityBroker } from './context-continuity-broker.ts';
4
+ import { openContextOwner, revokeContextOwner } from './context-continuity-owners.ts';
5
+ import { CONTEXT_CHANNEL_ENV, parseContextChannel } from './context-continuity-client.ts';
6
+ import { fileURLToPath } from 'node:url';
7
+ let contextBroker: ReturnType<typeof createContextContinuityBroker> | undefined;
8
+ import { runtimeTestObservationFromResult, type RuntimeTestRecord } from "./runtime-test-check.ts";
9
+ import { createToolEventRecorder, type ToolExecutionEvent } from "./tool-protocol.ts";
10
+ import { readActiveProfile, assertProfileModel, profileFallback, withProfileWork, PROFILE_ENV, type ActiveModelProfile } from './policy/profile-runtime.ts';
11
+ import { DISCOVERY_CHILD_ENV_KEYS, openDiscoveryAttempt, type DiscoverySpawnRegistration } from './file-discovery/owners.ts';
12
+ import { realpathSync } from 'node:fs';
13
+ import { join,resolve } from 'node:path';
14
+ import { sessionRootsFromEnv,sessionGitEnv,validateSessionRoots } from '../lib/workspace-context.ts';
15
+ import { readDamagePolicy } from '../lib/damage-policy.ts';
16
+ import { resourceClosureGaps } from '../lib/resource-closure.js';
17
+ import { damageAssignmentEnv, type DamagePhysicalLease, type DamageSpawnRegistration } from './damage-guard-owners.ts';
18
+ import { SYSTEM1_API_KEY_ENV } from "../lib/system1/config.js";
19
+ import { confineNativeChild, type WriteIsolationRequest, type WriteIsolationResult } from "./write-isolation.ts";
20
+ /**
21
+ * spawnPiAgent — the ONE place agent-hub code spawns a headless `pi` child and
22
+ * parses its JSON event stream. Research helpers and read-only delegate children
23
+ * opt into the per-tool watchdog here, rather than trusting an agent-side timer.
24
+ */
25
+
26
+ import { spawn, type ChildProcess } from "child_process";
27
+ import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
28
+ import { boundOutput } from "./deterministic-fs.ts";
29
+
30
+ export interface PiUsage {
31
+ input?: number;
32
+ output?: number;
33
+ [k: string]: any;
34
+ }
35
+
36
+ export interface ToolTimeout {
37
+ toolCallId: string;
38
+ toolName: string;
39
+ args: string;
40
+ startedAt: number;
41
+ deadlineAt: number;
42
+ }
43
+
44
+ export interface Termination {
45
+ reason: "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled";
46
+ confirmed: boolean;
47
+ escalated: boolean;
48
+ tool?: ToolTimeout;
49
+ }
50
+
51
+ /** External run control handed to the caller via onControl (drift watchdog). */
52
+ export interface PiRunControl {
53
+ /** Terminate the child group with the given classification (default "drift_stop"). */
54
+ terminate(reason?: "drift_stop" | "cancelled"): void;
55
+ }
56
+
57
+ export interface ToolWatchdogOptions {
58
+ /** Per read-only tool call deadline. null disables the watchdog. */
59
+ timeoutMs: number | null;
60
+ /** Grace after SIGTERM, followed by SIGKILL. Kept injectable for focused tests. */
61
+ termGraceMs?: number;
62
+ /** Bound on final settlement; never wait forever for close or inherited pipes. */
63
+ settleGraceMs?: number;
64
+ /** Only these tool names are watched (research/delegate read-only surface). */
65
+ tools?: readonly string[];
66
+ }
67
+
68
+ export interface SpawnPiAgentOptions {
69
+ /** Trusted parent registration; a fresh lease is opened for EVERY physical launch. Never an env override. */
70
+ discoveryRegistration?: DiscoverySpawnRegistration;
71
+ /** Independent trusted D6 factory; never inherited or coupled to D9 readiness. */
72
+ damageRegistration?: DamageSpawnRegistration;
73
+ /** Enabled only by native preparation with the runtime observer extension. */
74
+ runtimeTestObserver?: boolean;
75
+ specialistResultTool?: boolean;
76
+ /** Snapshotted at dispatch start; presence prevents a mid-run profile switch changing this launch. */
77
+ activeProfileSnapshot?: ActiveModelProfile;
78
+ /** Native-only whole-process write boundary. Omission preserves the legacy launch. */
79
+ writeIsolation?: WriteIsolationRequest;
80
+ model: string;
81
+ tools: string;
82
+ thinking: string;
83
+ /** Replacement prompt; mutually exclusive with appendSystemPrompt when spawning. */
84
+ systemPrompt?: string;
85
+ /** Prompt appended to Pi's inherited prompt (legacy/default child policy). */
86
+ appendSystemPrompt?: string;
87
+ /** Disable automatic global skill discovery for a minimized child. */
88
+ noSkills?: boolean;
89
+ /** Disable AGENTS.md/CLAUDE.md and other automatic context-file discovery. */
90
+ noContextFiles?: boolean;
91
+ sessionFile: string;
92
+ resume?: boolean;
93
+ prompt: string;
94
+ extensions?: string[];
95
+ env?: Record<string, string>;
96
+ /** Own a process group. Required for a watchdog/cancellation kill cascade. */
97
+ detached?: boolean;
98
+ cwd?: string;
99
+ /** Parent tool cancellation; classified separately from a tool timeout. */
100
+ signal?: AbortSignal;
101
+ /** Distinguishes physical launches that share one callback object. Identity is owned by the lifecycle. */
102
+ physicalAttempt?: { generation: number };
103
+ /** Optional per-physical-spawn fence. Omission preserves every existing launcher. */
104
+ attemptLifecycle?: {
105
+ beforePhysicalSpawn(info: { generation: number }): { signal?: AbortSignal } | void;
106
+ afterPhysicalSpawn(info: { generation: number }): void;
107
+ };
108
+ toolWatchdog?: ToolWatchdogOptions;
109
+ /**
110
+ * Whole-run deadline: one timer from spawn start; on expiry the child group is
111
+ * terminated with reason "turn_timeout" (same SIGTERM→SIGKILL→settle cascade as
112
+ * the per-tool watchdog). null/undefined disables it. Unlike the tool watchdog
113
+ * this bounds the ENTIRE run, thinking and non-watched tools included.
114
+ */
115
+ turnDeadlineMs?: number | null;
116
+ /** Opt-in T5 transport bound; complete original output is retained under this directory. */
117
+ boundedOutputDir?: string;
118
+ }
119
+
120
+ export interface ModelFallbackNotice {
121
+ from: string;
122
+ to: string;
123
+ reason: string;
124
+ }
125
+
126
+ export interface SpawnPiAgentCallbacks {
127
+ onProcess?(proc: ChildProcess): void;
128
+ onModelFallback?(notice: ModelFallbackNotice): void;
129
+ /** Receives a terminate handle for parent-side classified stops (drift watchdog). */
130
+ onControl?(control: PiRunControl): void;
131
+ onTextDelta?(delta: string): void;
132
+ onThinkingDelta?(delta: string): void;
133
+ onToolStart?(toolName: string, argStr: string, toolCallId?: string): void;
134
+ /** Result text is the complete textual tool payload; duration is measured in the parent process. */
135
+ onToolEnd?(toolName: string, toolCallId?: string, isError?: boolean, resultText?: string, durationMs?: number): void;
136
+ onUsage?(usage: PiUsage, source: "message_end" | "agent_end"): void;
137
+ }
138
+
139
+ export interface SpawnPiAgentResult {
140
+ specialistResult?: SpecialistResult;
141
+ specialistResultTool?: boolean;
142
+ runtimeTests?: RuntimeTestRecord[];
143
+ toolEvents?: ToolExecutionEvent[];
144
+ output: string;
145
+ exitCode: number | null;
146
+ stderr: string;
147
+ spawnError?: string;
148
+ /** Assistant-level provider/model failure reported in Pi's JSON stream. */
149
+ assistantError?: string;
150
+ toolCallsStarted: number;
151
+ modelUsed: string;
152
+ modelFallback?: ModelFallbackNotice;
153
+ /** Present only when parent-side bounded termination was requested. */
154
+ termination?: Termination;
155
+ /** T3 runtime lifecycle facts: launched/close/termination are separate dimensions.
156
+ * Safety refusal and spawn failure never launched; timeout without close stays uncertain. */
157
+ lifecycle: { launched: boolean; closeSeen: boolean; /** Parent-observed tool stream integrity, independent of completed checks. */ runtimeCaptureIntegrity?: "complete" | "tainted" };
158
+ boundedOutput?: { truncated: boolean; totalBytes: number; handle: string; contentPath: string; sha256: string };
159
+ writeIsolation?: Pick<WriteIsolationResult, "applied" | "failClosed" | "mechanism" | "permissionExpansion" | "rollsBackUserEdits" | "protectsConcurrentUserWrites">;
160
+ }
161
+
162
+ const DEFAULT_TERM_GRACE_MS = 1_000;
163
+ const DEFAULT_SETTLE_GRACE_MS = 1_000;
164
+ const WATCHED_TOOLS = new Set(["read", "grep", "find", "ls"]);
165
+
166
+ /** Sandboxed children must not inherit writable descriptors outside the mount policy. */
167
+ export function assertSafeSandboxStdio(stdio: readonly unknown[]): void {
168
+ if (stdio.length !== 3) throw new Error("write isolation refuses extra inherited file descriptors");
169
+ if (stdio.some(value => value !== "pipe")) throw new Error("write isolation requires safe stdio pipes");
170
+ }
171
+
172
+ /** Credential names removed from the final native child environment. Parent env is never mutated. */
173
+ export const NATIVE_CHILD_STRIPPED_ENV_KEYS = [SYSTEM1_API_KEY_ENV, ...DISCOVERY_CHILD_ENV_KEYS] as const;
174
+
175
+ /** The sandbox helper may echo env. Never publish that echo on the spawn result. */
176
+ function isolationWithoutEnv<T extends { env?: Record<string, string> }>(isolation: T): Omit<T, "env"> {
177
+ const published = { ...isolation };
178
+ delete published.env;
179
+ return published;
180
+ }
181
+
182
+ /** Drop undefined entries so the sandbox helper receives a string env. */
183
+ function envRecord(env: NodeJS.ProcessEnv): Record<string, string> {
184
+ const record: Record<string, string> = {};
185
+ for (const [key, value] of Object.entries(env)) {
186
+ if (typeof value === "string") record[key] = value;
187
+ }
188
+ return record;
189
+ }
190
+
191
+ /** Merge parent + overrides, then strip System 1 credentials and inherited D9 assignments. */
192
+ export function nativeChildEnv(
193
+ base: NodeJS.ProcessEnv = process.env,
194
+ overrides?: Record<string, string | undefined> | NodeJS.ProcessEnv,
195
+ ): NodeJS.ProcessEnv {
196
+ for(const key of ['AF_SESSION_ROOTS','AF_TARGET_BASE_PROJECT','AF_TARGET_EFFECTIVE_PROJECT'])if(overrides&&Object.prototype.hasOwnProperty.call(overrides,key)&&overrides[key]!==base[key])throw Error(`child_session_context_override:${key}`);
197
+ const roots=sessionRootsFromEnv(base);
198
+ const merged: NodeJS.ProcessEnv = { ...base };
199
+ if (overrides) {
200
+ for (const [key, value] of Object.entries(overrides)) {
201
+ if (value === undefined) delete merged[key];
202
+ else merged[key] = value;
203
+ }
204
+ }
205
+ for (const key of Object.keys(merged)) if (key.startsWith('AF_D6') || key.startsWith('AF_D9_') || key.startsWith('AF_D7_') || (NATIVE_CHILD_STRIPPED_ENV_KEYS as readonly string[]).includes(key)) delete merged[key];
206
+ if(roots)merged.AF_SESSION_ROOTS=JSON.stringify(roots);
207
+ return roots?.mode==='targeted'?sessionGitEnv(merged):merged;
208
+ }
209
+
210
+ const discoveryProcessRevocations = new WeakMap<ChildProcess, () => void>();
211
+ /** Signal an explicitly owned process group, falling back only for legacy callers. */
212
+ export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM"): void {
213
+ discoveryProcessRevocations.get(proc)?.();
214
+ const pid = proc.pid;
215
+ if (pid == null) return;
216
+ try {
217
+ process.kill(-pid, signal);
218
+ } catch {
219
+ try { proc.kill(signal); } catch {}
220
+ }
221
+ }
222
+
223
+ export function spawnPiAgent(opts: SpawnPiAgentOptions, cbs: SpawnPiAgentCallbacks = {}): Promise<SpawnPiAgentResult> {
224
+ return withProfileWork(async () => {
225
+ try {
226
+ const active = Object.prototype.hasOwnProperty.call(opts, "activeProfileSnapshot")
227
+ ? opts.activeProfileSnapshot
228
+ : (readActiveProfile() ?? readActiveProfile(opts.env));
229
+ assertProfileModel(opts.model,active);
230
+ if(active) opts={...opts,env:{...opts.env,[PROFILE_ENV]:JSON.stringify(active)}};
231
+ return await spawnPiAgentUnchecked(opts,cbs);
232
+ } catch(error) {
233
+ return {output:'',stderr:String(error),exitCode:1,spawnError:String(error),modelUsed:opts.model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}};
234
+ }
235
+ });
236
+ }
237
+
238
+ async function spawnPiAgentUnchecked(
239
+ opts: SpawnPiAgentOptions,
240
+ cbs: SpawnPiAgentCallbacks = {},
241
+ ): Promise<SpawnPiAgentResult> {
242
+ const inherited=nativeChildEnv(process.env,opts.env),roots=sessionRootsFromEnv(inherited);
243
+ if(roots?.mode==='targeted'){
244
+ if(realpathSync(opts.cwd??process.cwd())!==roots.executionRoot)throw Error('native_child_target_mismatch');
245
+ const extensions=(opts.extensions??[]).map(path=>realpathSync(resolve(roots.workspaceRoot,path)));
246
+ if(extensions.some(path=>![roots.workspaceRoot,roots.resourceRoot].some(root=>path.startsWith(root+'/'))))throw Error('native_child_foreign_resource');
247
+ if(!extensions.includes(realpathSync(join(roots.workspaceRoot,'.pi/harnesses/damage-control-continue/index.ts'))))throw Error('native_child_missing_damage_control');
248
+ const closure=resourceClosureGaps(roots.resourceRoot,extensions,[roots.workspaceRoot]);if(closure.length)throw Error(`native_child_incomplete_resources:${closure.join(';')}`);
249
+ readDamagePolicy(roots.executionRoot,roots);
250
+ const session=resolve(opts.sessionFile);if(![join(roots.workspaceRoot,'.pi/agent-sessions'),join(roots.workspaceRoot,'.pi/flow-sessions')].some(base=>session.startsWith(base+'/')))throw Error('native_child_foreign_session_state');
251
+ opts={...opts,cwd:roots.executionRoot,extensions};
252
+ }
253
+ const promptArg = opts.systemPrompt !== undefined
254
+ ? ["--system-prompt", opts.systemPrompt]
255
+ : ["--append-system-prompt", opts.appendSystemPrompt ?? ""];
256
+ const args = [
257
+ "--mode", "json", "-p", "--no-extensions",
258
+ ...(opts.noSkills ? ["--no-skills"] : []),
259
+ ...(opts.noContextFiles ? ["--no-context-files"] : []),
260
+ ...(opts.extensions || []).flatMap(e => ["-e", e]),
261
+ "--model", opts.model, "--tools", opts.tools, "--thinking", opts.thinking,
262
+ ...promptArg, "--session", opts.sessionFile,
263
+ ];
264
+ if(roots?.mode==='targeted'){
265
+ args.push('--no-approve','--no-mcp','--no-themes','--no-skills','--no-prompt-templates');
266
+ if(!opts.noContextFiles)for(const name of ['AGENTS.md','CLAUDE.md']){const full=join(roots.workspaceRoot,name);if(existsSync(full)){const canonical=realpathSync(full);if(![roots.workspaceRoot,roots.resourceRoot].some(root=>canonical.startsWith(root+'/')))throw Error('native_child_foreign_instructions');args.push('--append-system-prompt',canonical);break;}}
267
+ if(!opts.noSkills)for(const path of ['.pi/skills','skills']){const full=join(roots.workspaceRoot,path);if(existsSync(full)){const canonical=realpathSync(full);if(![roots.workspaceRoot,roots.resourceRoot].some(root=>canonical.startsWith(root+'/')))throw Error('native_child_foreign_skills');args.push('--skill',canonical);}}
268
+ }
269
+ if (opts.resume) args.push("-c");
270
+
271
+ const generation = opts.physicalAttempt?.generation ?? 1;
272
+ let attemptSignal: AbortSignal | undefined;
273
+ let discoveryAttempt: ReturnType<typeof openDiscoveryAttempt> | undefined;
274
+ let damageLease: DamagePhysicalLease | undefined;
275
+ let damageEnv: Record<string,string> | undefined;
276
+ let damageRevoked = false;
277
+ const revokeDamage = () => {
278
+ if (damageRevoked || !damageLease) return;
279
+ damageRevoked = true; // Revocation can synchronously abort and re-enter kill.
280
+ damageLease.revoke();
281
+ };
282
+ const damageTools = opts.tools.split(',').map(t=>t.trim()).filter((t,i,all)=>['bash','write','edit','read','filesystem'].includes(t) && opts.damageRegistration?.tools.includes(t) && all.indexOf(t)===i);
283
+ const damageAssigned = damageTools.length > 0;
284
+ const checkTarget=()=>{if(sessionRootsFromEnv()?.targetId!==roots?.targetId)throw Error('native_child_target_changed');if(roots)validateSessionRoots(roots);};
285
+ const checkDamage = () => {
286
+ checkTarget();
287
+ if (!damageAssigned) return;
288
+ let valid = false;
289
+ try {
290
+ valid = opts.damageRegistration!.validate() === true && (!damageLease || (!damageRevoked && !damageLease.identity.signal.aborted && damageLease.validate() === true));
291
+ } catch { /* Lost authority is terminal, not optional inference unavailability. */ }
292
+ if (!valid) { revokeDamage(); throw Error('damage_physical_authority_unavailable'); }
293
+ };
294
+ let contextOwner: ReturnType<typeof openContextOwner> | undefined;
295
+ let contextAssignment: string | undefined;
296
+ let attemptEnded = false;
297
+ const endAttempt = () => {
298
+ if (attemptEnded) return;
299
+ attemptEnded = true;
300
+ revokeDamage();
301
+ discoveryAttempt?.revoke();
302
+ if(contextOwner) revokeContextOwner(contextOwner.attempt);
303
+ opts.attemptLifecycle?.afterPhysicalSpawn({ generation });
304
+ };
305
+ try {
306
+ attemptSignal = opts.attemptLifecycle?.beforePhysicalSpawn({ generation })?.signal;
307
+ if (!opts.signal?.aborted && !attemptSignal?.aborted && damageAssigned) {
308
+ checkDamage();
309
+ const cwd = realpathSync(opts.cwd ?? process.cwd());
310
+ try { damageLease = await opts.damageRegistration!.open({tools:damageTools,cwd}); }
311
+ catch { throw Error('damage_physical_registration_unavailable'); }
312
+ try {
313
+ if (!damageLease || typeof damageLease.revoke !== 'function' || typeof damageLease.validate !== 'function' || !damageLease.identity?.signal || !damageLease.identity.attempt || !damageLease.identity.owner || damageLease.identity.cwd !== cwd || damageLease.identity.tools.length !== damageTools.length || damageTools.some(t=>!damageLease!.identity.tools.includes(t))) throw Error();
314
+ damageEnv = damageAssignmentEnv(damageLease.assignment);
315
+ } catch { throw Error('damage_physical_lease_invalid'); }
316
+ checkDamage();
317
+ }
318
+ if (!opts.signal?.aborted && !attemptSignal?.aborted && opts.discoveryRegistration) {
319
+ // Do not let even a parent registration claim tools absent from the physical command.
320
+ const effectiveTools = opts.tools.split(',').map(t=>t.trim()).filter(t=>opts.discoveryRegistration!.owner.effectiveTools.includes(t));
321
+ try {
322
+ discoveryAttempt = openDiscoveryAttempt({...opts.discoveryRegistration,owner:{...opts.discoveryRegistration.owner,effectiveTools,cwd:opts.cwd??process.cwd()}});
323
+ if(opts.discoveryRegistration.extension){const extension=roots?.mode==='targeted'?realpathSync(opts.discoveryRegistration.extension):opts.discoveryRegistration.extension;if(roots?.mode==='targeted'&&!extension.startsWith(roots.resourceRoot+'/'))throw Error('native_child_foreign_discovery_resource');args.push('-e',extension);}
324
+ } catch(error) {
325
+ // D9 availability is advisory; authoritative launch admission still fails closed.
326
+ if(error instanceof Error&&['owner_admission_changed','native_child_foreign_discovery_resource'].includes(error.message))throw error;
327
+ opts={...opts,prompt:opts.prompt+'\n\nFile discovery physical attempt: unavailable (registration unavailable). Continue ordinary permitted discovery; original task, scope and gates remain authoritative.'};
328
+ }
329
+ }
330
+ if (opts.signal?.aborted || attemptSignal?.aborted || discoveryAttempt?.signal.aborted || damageLease?.identity?.signal?.aborted) {
331
+ endAttempt();
332
+ return Promise.resolve({
333
+ output: "", stderr: "", exitCode: null, modelUsed: opts.model, toolCallsStarted: 0,
334
+ termination: { reason: "cancelled", confirmed: false, escalated: false },
335
+ lifecycle: { launched: false, closeSeen: false },
336
+ });
337
+ }
338
+ checkDamage();
339
+ args.push('-e',roots?.mode==='targeted'?join(roots.resourceRoot,'.pi/harnesses/agent-hub/context-continuity-child.ts'):fileURLToPath(new URL('./context-continuity-child.ts',import.meta.url)));
340
+ try {
341
+ contextBroker ??= createContextContinuityBroker();
342
+ const broker=await contextBroker;
343
+ const parent=parseContextChannel(process.env[CONTEXT_CHANNEL_ENV]);
344
+ contextOwner=openContextOwner(opts.sessionFile,parent?.owner??null);
345
+ contextAssignment=JSON.stringify(broker.assignment(contextOwner));
346
+ } catch { contextBroker=undefined; } // Local child deterministic recovery does not depend on semantic inference.
347
+ if(opts.signal?.aborted || attemptSignal?.aborted || discoveryAttempt?.signal.aborted || damageLease?.identity?.signal?.aborted) {
348
+ endAttempt();return {output:"",stderr:"",exitCode:null,modelUsed:opts.model,toolCallsStarted:0,termination:{reason:"cancelled",confirmed:false,escalated:false},lifecycle:{launched:false,closeSeen:false}};
349
+ }
350
+ checkDamage();
351
+ const childEnv = {...nativeChildEnv(process.env, opts.env), ...discoveryAttempt?.env,...damageEnv,...(contextAssignment?{[CONTEXT_CHANNEL_ENV]:contextAssignment}:{})};
352
+ const isolation = opts.writeIsolation ? confineNativeChild({ ...opts.writeIsolation, command: "pi", args, env: envRecord(childEnv) }) : undefined;
353
+ const publishedIsolation = isolation ? isolationWithoutEnv(isolation) : undefined;
354
+ if (isolation && !isolation.applied) {
355
+ endAttempt();
356
+ return Promise.resolve({
357
+ output: "", stderr: isolation.reason ?? "write isolation unavailable", exitCode: 1,
358
+ spawnError: isolation.reason ?? "write isolation unavailable; unsandboxed execution refused",
359
+ modelUsed: opts.model, toolCallsStarted: 0, writeIsolation: publishedIsolation,
360
+ lifecycle: { launched: false, closeSeen: false },
361
+ });
362
+ }
363
+ const launchCommand = isolation?.command ?? "pi";
364
+ const launchArgs = isolation?.args ?? args;
365
+ const watchdog = opts.toolWatchdog;
366
+ const turnDeadlineMs = opts.turnDeadlineMs ?? null;
367
+ // A watchdog or deadline must own its group: group signalling remains valid even
368
+ // after the pi leader exits while an inherited-stdio descendant is still alive.
369
+ const ownsGroup = opts.detached === true || watchdog !== undefined || opts.signal !== undefined || attemptSignal !== undefined || discoveryAttempt !== undefined || damageLease !== undefined || turnDeadlineMs != null || cbs.onControl !== undefined;
370
+ const watchedTools = new Set(watchdog?.tools ?? WATCHED_TOOLS);
371
+ const timeoutMs = watchdog?.timeoutMs ?? null;
372
+ const termGraceMs = watchdog?.termGraceMs ?? DEFAULT_TERM_GRACE_MS;
373
+ const settleGraceMs = watchdog?.settleGraceMs ?? DEFAULT_SETTLE_GRACE_MS;
374
+
375
+ const textChunks: string[] = [];
376
+ const stderrChunks: string[] = [];
377
+ return await new Promise((resolve) => {
378
+ const stdio: ["pipe", "pipe", "pipe"] = ["pipe", "pipe", "pipe"];
379
+ if (isolation) assertSafeSandboxStdio(stdio);
380
+ checkDamage();
381
+ if (opts.signal?.aborted || attemptSignal?.aborted || discoveryAttempt?.signal.aborted || damageLease?.identity.signal.aborted) throw Error('physical_launch_aborted');
382
+ const proc = spawn(launchCommand, launchArgs, {
383
+ stdio,
384
+ env: childEnv,
385
+ ...(opts.cwd ? { cwd: opts.cwd } : {}),
386
+ ...(ownsGroup ? { detached: true } : {}),
387
+ });
388
+ discoveryProcessRevocations.set(proc,()=>{revokeDamage();discoveryAttempt?.revoke();if(contextOwner)revokeContextOwner(contextOwner.attempt);});
389
+ const originalKill=proc.kill.bind(proc);
390
+ proc.kill=(signal)=>{if(signal!==0){revokeDamage();discoveryAttempt?.revoke();if(contextOwner)revokeContextOwner(contextOwner.attempt);}return originalKill(signal);};
391
+
392
+ proc.stdin?.on("error", () => {});
393
+ proc.stdin?.end(opts.prompt);
394
+
395
+ let buffer = "";
396
+ let settled = false;
397
+ let closeSeen = false;
398
+ let termination: Termination | undefined;
399
+ let termTimer: ReturnType<typeof setTimeout> | undefined;
400
+ let settleTimer: ReturnType<typeof setTimeout> | undefined;
401
+ let deadlineTimer: ReturnType<typeof setTimeout> | undefined;
402
+ const calls = new Map<string, ToolTimeout & { timer: ReturnType<typeof setTimeout> }>();
403
+
404
+ const clearCalls = () => {
405
+ for (const call of calls.values()) clearTimeout(call.timer);
406
+ calls.clear();
407
+ };
408
+ const cleanup = () => {
409
+ clearCalls();
410
+ if (termTimer) clearTimeout(termTimer);
411
+ if (settleTimer) clearTimeout(settleTimer);
412
+ if (deadlineTimer) clearTimeout(deadlineTimer);
413
+ opts.signal?.removeEventListener("abort", onAbort);
414
+ attemptSignal?.removeEventListener("abort", onAbort);
415
+ discoveryAttempt?.signal.removeEventListener('abort', onAbort);
416
+ damageLease?.identity?.signal?.removeEventListener('abort', onAbort);
417
+ endAttempt();
418
+ };
419
+ let assistantError: string | undefined;
420
+ let pendingMessageSeparator = false;
421
+ let recoveryAbortEpisode: number | undefined;
422
+ let toolCallsStarted = 0;
423
+ const runtimeTests: RuntimeTestRecord[] = [];
424
+ let specialistResult: SpecialistResult | undefined;
425
+ const resultStarts = new Map<string,unknown>();
426
+ const runtimeTestStarts = new Map<string, string>();
427
+ const overlappedChecks = new Set<string>();
428
+ const seenToolIds = new Set<string>();
429
+ const toolNames = new Map<string,string>();
430
+ let malformedToolOrder = false;
431
+ const invalidateToolOrder = () => {
432
+ malformedToolOrder = true;
433
+ for (const record of runtimeTests) record.exclusive = false;
434
+ };
435
+ const toolEventRecorder = createToolEventRecorder();
436
+ const toolEvents: ToolExecutionEvent[] = toolEventRecorder.events;
437
+ const settle = (code: number | null, spawnError?: string) => {
438
+ if (settled) return;
439
+ settled = true;
440
+ if (toolStarts.size) invalidateToolOrder();
441
+ cleanup();
442
+ if (termination) termination.confirmed = closeSeen;
443
+ // A pipe held by a descendant must not hold the caller forever.
444
+ try { proc.stdin?.destroy(); } catch {}
445
+ try { proc.stdout?.destroy(); } catch {}
446
+ try { proc.stderr?.destroy(); } catch {}
447
+ const rawOutput = textChunks.join("");
448
+ const bounded = opts.boundedOutputDir ? boundOutput({ content: rawOutput, retentionDir: opts.boundedOutputDir, label: "assistant-reply" }) : null;
449
+ resolve({
450
+ output: bounded?.reply ?? rawOutput,
451
+ // Pi's headless process can exit 0 while the assistant message itself
452
+ // reports stopReason:error. Normalize that to a failed run so callers
453
+ // never mark a provider/model error as successful.
454
+ exitCode: assistantError && code === 0 ? 1 : code,
455
+ stderr: stderrChunks.join(""),
456
+ toolCallsStarted, runtimeTests: [...runtimeTests, ...[...runtimeTestStarts.values()].map(command => ({ producer: "agent-fleet.runtime-test/v1" as const, command, exitCode: null, beforeRevision: "unavailable", afterRevision: "unavailable", exclusive: false }))], toolEvents, specialistResult, specialistResultTool: opts.specialistResultTool,
457
+ modelUsed: opts.model,
458
+ // T3: explicit lifecycle facts travel with every settlement.
459
+ // Missing close or an unconfirmed process tree stays uncertain downstream.
460
+ lifecycle: { launched: true, closeSeen, runtimeCaptureIntegrity: malformedToolOrder ? "tainted" : "complete" },
461
+ ...(spawnError ? { spawnError } : {}),
462
+ ...(assistantError ? { assistantError } : {}),
463
+ ...(termination ? { termination } : {}),
464
+ ...(publishedIsolation ? { writeIsolation: publishedIsolation } : {}),
465
+ ...(bounded ? { boundedOutput: { truncated: bounded.truncated, totalBytes: bounded.totalBytes, handle: bounded.handle, contentPath: bounded.contentPath, sha256: bounded.hash } } : {}),
466
+ });
467
+ };
468
+ const terminate = (reason: Termination["reason"], tool?: ToolTimeout) => {
469
+ // The first classification wins; later cancellation/exit events keep it.
470
+ if (termination) return;
471
+ termination = { reason, confirmed: false, escalated: false, ...(tool ? { tool } : {}) };
472
+ revokeDamage();
473
+ discoveryAttempt?.revoke(); // fence replies immediately, not after kill/pipe settlement
474
+ clearCalls();
475
+ killPiTree(proc, "SIGTERM");
476
+ termTimer = setTimeout(() => {
477
+ if (settled) return;
478
+ termination!.escalated = true;
479
+ killPiTree(proc, "SIGKILL");
480
+ }, termGraceMs);
481
+ settleTimer = setTimeout(() => settle(null), termGraceMs + settleGraceMs);
482
+ };
483
+ const onAbort = () => terminate("cancelled");
484
+ const watchAbort = (signal?: AbortSignal) => {
485
+ if (!signal) return;
486
+ if (signal.aborted) onAbort();
487
+ else signal.addEventListener("abort", onAbort, { once: true });
488
+ };
489
+ watchAbort(opts.signal);
490
+ watchAbort(attemptSignal);
491
+ watchAbort(discoveryAttempt?.signal);
492
+ watchAbort(damageLease?.identity.signal);
493
+ // External classified stop (drift watchdog): same first-classification-wins
494
+ // cascade as every other termination path; harmless after settle.
495
+
496
+ if (turnDeadlineMs != null) {
497
+ deadlineTimer = setTimeout(() => terminate("turn_timeout"), turnDeadlineMs);
498
+ }
499
+
500
+ const toolStarts = new Map<string, number>();
501
+ const toolId = (event: any) => {
502
+ const id = event.toolCallId ?? event.tool_call_id ?? event.id;
503
+ return typeof id === "string" && id.trim() ? id : "";
504
+ };
505
+ const toolResultText = (result: any): string => {
506
+ const content = result?.content ?? result;
507
+ if (typeof content === "string") return content;
508
+ if (!Array.isArray(content)) {
509
+ try { return content == null ? "" : JSON.stringify(content); } catch { return String(content ?? ""); }
510
+ }
511
+ return content.map((item: any) => {
512
+ if (typeof item === "string") return item;
513
+ if (item?.type === "text" && typeof item.text === "string") return item.text;
514
+ try { return JSON.stringify(item); } catch { return String(item ?? ""); }
515
+ }).filter(Boolean).join("\n");
516
+ };
517
+ const handleEvent = (event: any) => {
518
+ try{checkTarget();}catch{terminate('cancelled');return;}
519
+ // The last assistant message decides the run. Pi retries a transient provider error (overloaded, network
520
+ // reset) and continues after a compaction abort inside the same process; a later clean final answer means
521
+ // the earlier failed attempt was recovered, so it must not turn exit 0 into a failed dispatch.
522
+ if(event.type==='message_end' && event.message?.role==='assistant' && event.message.stopReason==='stop' && !event.message.errorMessage) {assistantError=undefined;recoveryAbortEpisode=undefined;}
523
+ if(event.type==='message_end' && event.message?.role==='assistant' && event.message.stopReason==='stop' && recoveryAbortEpisode!==undefined && contextOwner?.status.phase==='continued' && contextOwner.status.episode===recoveryAbortEpisode+1) {assistantError=undefined;recoveryAbortEpisode=undefined;}
524
+ if (event.type === "message_update") {
525
+ const delta = event.assistantMessageEvent;
526
+ if (delta?.type === "text_delta") {
527
+ if (delta.delta && pendingMessageSeparator) textChunks.push("\n");
528
+ if (delta.delta) pendingMessageSeparator = false;
529
+ textChunks.push(delta.delta || ""); cbs.onTextDelta?.(delta.delta || "");
530
+ }
531
+ else if (delta?.type === "thinking_delta") cbs.onThinkingDelta?.(delta.delta || "");
532
+ } else if (event.type === "tool_execution_start") {
533
+ toolCallsStarted++;
534
+ let argStr = "";
535
+ try { argStr = event.args != null ? JSON.stringify(event.args) : ""; } catch {}
536
+ const id = toolId(event);
537
+ const name = event.toolName || "tool";
538
+ if (typeof event.toolName !== "string" || !event.toolName || (event.toolName === "bash" && typeof event.args?.command !== "string")) invalidateToolOrder();
539
+ if (!id || seenToolIds.has(id)) invalidateToolOrder();
540
+ if (id && !seenToolIds.has(id)) {
541
+ seenToolIds.add(id);
542
+ toolStarts.set(id, Date.now());
543
+ toolNames.set(id, name);
544
+ }
545
+ const protocolArgs = event.args && typeof event.args === "object"
546
+ ? JSON.stringify(Object.fromEntries(["path", "file", "filePath"].filter(key => typeof event.args[key] === "string").map(key => [key, event.args[key]])))
547
+ : "{}";
548
+ toolEventRecorder.start(name, protocolArgs, id || undefined);
549
+ if (opts.runtimeTestObserver && (toolStarts.size > 1 || !id)) {
550
+ for (const checkId of runtimeTestStarts.keys()) overlappedChecks.add(checkId);
551
+ if (id) overlappedChecks.add(id);
552
+ }
553
+ if(opts.specialistResultTool){specialistResult=undefined;resultStarts.clear();} // Further or overlapping tool work invalidates the handoff.
554
+ if(opts.specialistResultTool && event.toolName==="submit_result" && id && toolStarts.size===1)resultStarts.set(id,event.args);
555
+ if (opts.runtimeTestObserver && event.toolName === "bash" && typeof event.args?.command === "string" && toolId(event)) runtimeTestStarts.set(toolId(event), event.args.command);
556
+ cbs.onToolStart?.(name, argStr, id || undefined);
557
+ if (timeoutMs != null && id && watchedTools.has(name) && !calls.has(id)) {
558
+ const startedAt = Date.now();
559
+ const call: ToolTimeout = { toolCallId: id, toolName: name, args: argStr, startedAt, deadlineAt: startedAt + timeoutMs };
560
+ calls.set(id, { ...call, timer: setTimeout(() => terminate("tool_timeout", call), timeoutMs) });
561
+ }
562
+ } else if (event.type === "tool_execution_end") {
563
+ const id = toolId(event);
564
+ if (id) {
565
+ const call = calls.get(id);
566
+ if (call) { clearTimeout(call.timer); calls.delete(id); }
567
+ }
568
+ const rawIsError = event.isError ?? event.is_error ?? event.result?.isError ?? event.result?.is_error;
569
+ toolEventRecorder.end(id || undefined, typeof rawIsError === "boolean" ? rawIsError : undefined);
570
+ if (!id || !toolStarts.has(id) || toolNames.get(id) !== event.toolName) invalidateToolOrder();
571
+ const startedCommand = id ? runtimeTestStarts.get(id) : undefined;
572
+ if (id) runtimeTestStarts.delete(id);
573
+ const submitted=resultFromToolEvent(opts.specialistResultTool,resultStarts.get(id),event.toolName,event.result,rawIsError);
574
+ if(submitted)specialistResult=submitted;
575
+ resultStarts.delete(id);
576
+ const check = runtimeTestObservationFromResult(opts.runtimeTestObserver, startedCommand, event.toolName, event.result);
577
+ if (check) runtimeTests.push({ ...check, startedAt: toolStarts.get(id), finishedAt: Date.now(), ...(malformedToolOrder || overlappedChecks.has(id) ? { exclusive: false } : {}) });
578
+ const startedAt = id ? toolStarts.get(id) : undefined;
579
+ if (id) { toolStarts.delete(id); toolNames.delete(id); }
580
+ cbs.onToolEnd?.(
581
+ event.toolName || "tool",
582
+ id || undefined,
583
+ typeof rawIsError === "boolean" ? rawIsError : undefined,
584
+ toolResultText(event.result),
585
+ startedAt == null ? undefined : Math.max(0, Date.now() - startedAt),
586
+ );
587
+ } else if (event.type === "message_end") {
588
+ // Defer the seam until more text arrives; preserve the final message bytes.
589
+ if (event.message?.role === "assistant") pendingMessageSeparator = textChunks.length > 0 && !textChunks.join("").endsWith("\n");
590
+ if (event.message?.role === "assistant"
591
+ && (event.message.stopReason === "error" || event.message.stopReason === "aborted")) {
592
+ recoveryAbortEpisode=(event.message.stopReason==='aborted' || event.message.errorMessage==='This operation was aborted') && contextOwner?.status.phase==='pending' ? contextOwner.status.episode : undefined;
593
+ assistantError = String(event.message.errorMessage
594
+ || (event.message.stopReason === "aborted" ? "assistant model request aborted" : "assistant model run failed"));
595
+ }
596
+ if (event.message?.usage) cbs.onUsage?.(event.message.usage, "message_end");
597
+ } else if (event.type === "agent_end") {
598
+ const last = [...(event.messages || [])].reverse().find((m: any) => m.role === "assistant");
599
+ if (last?.usage) cbs.onUsage?.(last.usage, "agent_end");
600
+ }
601
+ };
602
+
603
+ // An unparseable stdout line may have carried a tool event: the capture is no longer trustworthy (fail closed).
604
+ // Valid events are handled exactly as before; a handler exception still does not abort the stream.
605
+ const ingestLine = (line: string) => {
606
+ let event: unknown;
607
+ try { event = JSON.parse(line); } catch { invalidateToolOrder(); return; }
608
+ try { handleEvent(event); } catch {}
609
+ };
610
+ proc.stdout!.setEncoding("utf-8");
611
+ proc.stdout!.on("data", (chunk: string) => {
612
+ buffer += chunk;
613
+ const lines = buffer.split("\n");
614
+ buffer = lines.pop() || "";
615
+ for (const line of lines) if (line.trim()) ingestLine(line);
616
+ });
617
+ proc.stderr!.setEncoding("utf-8");
618
+ proc.stderr!.on("data", (chunk: string) => stderrChunks.push(chunk));
619
+ proc.once('exit', () => { discoveryAttempt?.signal.removeEventListener('abort', onAbort); damageLease?.identity.signal.removeEventListener('abort', onAbort); revokeDamage(); discoveryAttempt?.revoke(); });
620
+ proc.on("close", (code) => {
621
+ closeSeen = true;
622
+ if (buffer.trim()) ingestLine(buffer);
623
+ settle(code);
624
+ });
625
+ proc.on("error", (err) => settle(1, err.message));
626
+ try { cbs.onProcess?.(proc); cbs.onControl?.({ terminate: (reason = 'drift_stop') => { if (!settled) terminate(reason); } }); } catch { terminate('cancelled'); }
627
+ });
628
+ } finally { endAttempt(); }
629
+ }
630
+
631
+ const PROVIDER_FAILURE_RE = /\b(provider unavailable|service unavailable|overloaded|rate limit|too many requests|out of memory|oom|memory limit|resource exhausted|econn(?:reset|refused)|connection (?:reset|refused)|fetch failed|network error|gateway timeout|http\s*5\d\d|\b429\b)\b/i;
632
+
633
+ function modelFallbackReason(result: SpawnPiAgentResult, midRun = false): string | null {
634
+ // A terminated run (watchdog, deadline, cancellation) is a verdict on the
635
+ // work, not a provider outage — never retry it. A spawn failure never
636
+ // reached a provider at all.
637
+ if (result.spawnError || result.termination) return null;
638
+ const workStarted = result.toolCallsStarted > 0 || Boolean(result.output.trim());
639
+ if (!midRun && workStarted) return null;
640
+ const reason = result.assistantError
641
+ ? result.assistantError.slice(-500)
642
+ : result.exitCode !== 0
643
+ ? (result.stderr.trim().slice(-500) || `pi exited with code ${result.exitCode ?? "unknown"}`)
644
+ : null;
645
+ if (!reason) return null;
646
+ // Once work began, only a recognizable provider/transport failure is safe to
647
+ // route to another model. Deterministic session/configuration/harness errors
648
+ // must remain visible instead of being masked by an expensive second run.
649
+ if (midRun && workStarted && !PROVIDER_FAILURE_RE.test(reason)) return null;
650
+ return reason;
651
+ }
652
+
653
+ export interface ModelFallbackOptions {
654
+ /**
655
+ * Retry even when the failed attempt had already started tools or emitted
656
+ * text. Only pass this for a run that holds NO write-capable tools: the
657
+ * retry re-executes whatever the first attempt did, which is harmless for a
658
+ * reader and duplicates edits for a writer. Use `isReadOnlyToolList` on the
659
+ * effective tool list rather than assuming.
660
+ */
661
+ midRun?: boolean;
662
+ }
663
+
664
+ /**
665
+ * Run an overridden model and retry once on the original persona model when the
666
+ * first attempt failed for a provider-level reason. By default that means
667
+ * "failed before producing text or starting a tool"; `midRun` extends it to
668
+ * read-only runs, where a provider dying halfway through would otherwise throw
669
+ * the whole run away — and those are exactly the children that exist to protect
670
+ * their parent's context. The session file is restored before the retry so the
671
+ * failed turn never enters the resumable conversation.
672
+ */
673
+ export async function spawnPiAgentWithModelFallback(
674
+ opts: SpawnPiAgentOptions,
675
+ fallbackModel?: string,
676
+ cbs: SpawnPiAgentCallbacks = {},
677
+ fallbackOptions: ModelFallbackOptions = {},
678
+ ): Promise<SpawnPiAgentResult> {
679
+ try { fallbackModel=profileFallback(fallbackModel,readActiveProfile()??readActiveProfile(opts.env)); }
680
+ catch(error) { return {output:'',stderr:String(error),exitCode:1,spawnError:String(error),modelUsed:opts.model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}}; }
681
+ if (!fallbackModel || fallbackModel === opts.model) return spawnPiAgent(opts, cbs);
682
+
683
+ const sessionExisted = existsSync(opts.sessionFile);
684
+ let sessionSnapshot: Buffer | undefined;
685
+ if (sessionExisted) {
686
+ try { sessionSnapshot = readFileSync(opts.sessionFile); } catch {}
687
+ }
688
+
689
+ const primary = await spawnPiAgent(opts, cbs);
690
+ const reason = modelFallbackReason(primary, fallbackOptions.midRun === true);
691
+ // If an existing resumable session could not be snapshotted, fail closed:
692
+ // retrying would preserve the failed turn and could duplicate the prompt.
693
+ if (!reason || (sessionExisted && !sessionSnapshot)) return primary;
694
+
695
+ try {
696
+ if (sessionExisted && sessionSnapshot) writeFileSync(opts.sessionFile, sessionSnapshot);
697
+ else unlinkSync(opts.sessionFile);
698
+ } catch (error: any) {
699
+ if (error?.code !== "ENOENT") return primary;
700
+ }
701
+
702
+ const notice: ModelFallbackNotice = { from: opts.model, to: fallbackModel, reason };
703
+ cbs.onModelFallback?.(notice);
704
+ const fallback = await spawnPiAgent({ ...opts, model: fallbackModel }, cbs);
705
+ return { ...fallback, modelFallback: notice };
706
+ }