@chankov/agent-fleet 2.0.20 → 2.0.21

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 (626) hide show
  1. package/.pi/harnesses/agent-hub/README.md +3 -2
  2. package/.pi/harnesses/agent-hub/index.ts +7 -5
  3. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +26 -10
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/coms/index.ts +13 -10
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/coms-core-io.ts +29 -2
  9. package/.pi/harnesses/lib/coms-core.ts +144 -42
  10. package/.versions/2.0.21/.pi/agent-fleet/hermes/README.md +347 -0
  11. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  12. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  13. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  14. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  15. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  16. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  17. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  18. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  19. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  20. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  21. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  22. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  23. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  24. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  25. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  26. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  27. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  28. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  29. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  30. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  31. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  32. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  33. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  34. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  35. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  36. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  37. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  38. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  39. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  40. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  41. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  42. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  43. package/.versions/2.0.21/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  44. package/.versions/2.0.21/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  45. package/.versions/2.0.21/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  46. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  47. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  48. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  49. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  50. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  51. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet.ts +217 -0
  52. package/.versions/2.0.21/.pi/agent-fleet/scripts/flow.ts +157 -0
  53. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  54. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  55. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  56. package/.versions/2.0.21/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  57. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  58. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  59. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  60. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  61. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  62. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  63. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  64. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  65. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  66. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  67. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  68. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  69. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  70. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  71. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  72. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  73. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  74. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  75. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  76. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  77. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  78. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  79. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  80. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  81. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  82. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  83. package/.versions/2.0.21/.pi/agent-fleet/scripts/package-lock.json +35 -0
  84. package/.versions/2.0.21/.pi/agent-fleet/scripts/package.json +9 -0
  85. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  86. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  87. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  88. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-up.ts +378 -0
  89. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  90. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  91. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  92. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  93. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  94. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  95. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  96. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  97. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  98. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  99. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  100. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  101. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  102. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  103. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  104. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  105. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  106. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  107. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  108. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  109. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  110. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  111. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  112. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  113. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  114. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  115. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  116. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  117. package/.versions/2.0.21/.pi/agents/dispatch-policy.yaml +32 -0
  118. package/.versions/2.0.21/.pi/agents/model-profiles.yaml +134 -0
  119. package/.versions/2.0.21/.pi/agents/peers.yaml +147 -0
  120. package/.versions/2.0.21/.pi/agents/teams.yaml +41 -0
  121. package/.versions/2.0.21/.pi/agents/voices.yaml +13 -0
  122. package/.versions/2.0.21/.pi/damage-control-rules.yaml +297 -0
  123. package/.versions/2.0.21/.pi/extensions/btw/README.md +120 -0
  124. package/.versions/2.0.21/.pi/extensions/btw/index.ts +914 -0
  125. package/.versions/2.0.21/.pi/extensions/btw/package.json +6 -0
  126. package/.versions/2.0.21/.pi/extensions/btw/state.js +179 -0
  127. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  128. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  129. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  130. package/.versions/2.0.21/.pi/extensions/compact-and-continue/README.md +42 -0
  131. package/.versions/2.0.21/.pi/extensions/compact-and-continue/index.ts +136 -0
  132. package/.versions/2.0.21/.pi/extensions/compact-and-continue/package.json +6 -0
  133. package/.versions/2.0.21/.pi/extensions/mcp-bridge/README.md +46 -0
  134. package/.versions/2.0.21/.pi/extensions/mcp-bridge/index.ts +206 -0
  135. package/.versions/2.0.21/.pi/extensions/mcp-bridge/package.json +6 -0
  136. package/.versions/2.0.21/.pi/extensions/package-lock.json +1175 -0
  137. package/.versions/2.0.21/.pi/extensions/package.json +9 -0
  138. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/README.md +224 -0
  139. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/config.ts +198 -0
  140. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  141. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/index.ts +248 -0
  142. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/package.json +6 -0
  143. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  144. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  145. package/.versions/2.0.21/.pi/harnesses/agent-hub/README.md +1517 -0
  146. package/.versions/2.0.21/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  147. package/.versions/2.0.21/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  148. package/.versions/2.0.21/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  149. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  150. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  151. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  152. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  153. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  154. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  155. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  156. package/.versions/2.0.21/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  157. package/.versions/2.0.21/.pi/harnesses/agent-hub/artifacts.js +146 -0
  158. package/.versions/2.0.21/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  159. package/.versions/2.0.21/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  160. package/.versions/2.0.21/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  161. package/.versions/2.0.21/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  162. package/.versions/2.0.21/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  163. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  164. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  165. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  166. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  167. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  168. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  169. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  170. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  171. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  172. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  173. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  174. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  175. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  176. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  177. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  178. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  179. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  180. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  181. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  182. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  183. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  184. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  185. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  186. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  187. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  188. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  189. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  190. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  191. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  192. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  193. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  194. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  195. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  196. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  197. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  198. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  199. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  200. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  201. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  202. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  203. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  204. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  205. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  206. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  207. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  208. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  209. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  210. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  211. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  212. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  213. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  214. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-window.js +108 -0
  215. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  216. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  217. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  218. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  219. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  220. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  221. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  222. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  223. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  224. package/.versions/2.0.21/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  225. package/.versions/2.0.21/.pi/harnesses/agent-hub/delegate.ts +478 -0
  226. package/.versions/2.0.21/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  227. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  228. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  229. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  230. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  231. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  232. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  233. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +253 -0
  234. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  235. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  236. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  237. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  238. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  239. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  240. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  241. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  242. package/.versions/2.0.21/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  243. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  244. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  245. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  246. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  247. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  248. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  249. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  250. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  251. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  252. package/.versions/2.0.21/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  253. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  254. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  255. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  256. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  257. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  258. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  259. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  260. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  261. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  262. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  263. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  264. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  265. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  266. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  267. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  268. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  269. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  270. package/.versions/2.0.21/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  271. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  272. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.21/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.21/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.21/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  276. package/.versions/2.0.21/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  277. package/.versions/2.0.21/.pi/harnesses/agent-hub/index.ts +2616 -0
  278. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  279. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  280. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  281. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  282. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  283. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  284. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  285. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  286. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  287. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  288. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  289. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  290. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  291. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  292. package/.versions/2.0.21/.pi/harnesses/agent-hub/no-progress.ts +620 -0
  293. package/.versions/2.0.21/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  294. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  295. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  296. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  297. package/.versions/2.0.21/.pi/harnesses/agent-hub/package.json +7 -0
  298. package/.versions/2.0.21/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  299. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  300. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  301. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  302. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  303. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  304. package/.versions/2.0.21/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  305. package/.versions/2.0.21/.pi/harnesses/agent-hub/presentation.ts +48 -0
  306. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  307. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  308. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  309. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  310. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  311. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  312. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  313. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  314. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  315. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  316. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  317. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  318. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  319. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  320. package/.versions/2.0.21/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  321. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  322. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  323. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  324. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  325. package/.versions/2.0.21/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  326. package/.versions/2.0.21/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  327. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  328. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  329. package/.versions/2.0.21/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  330. package/.versions/2.0.21/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  331. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  332. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  333. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  334. package/.versions/2.0.21/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  335. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-contract.js +349 -0
  336. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-extract.js +77 -0
  337. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  338. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  339. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-findings.js +96 -0
  340. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  341. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  342. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  343. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-budget.js +342 -0
  344. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  345. package/.versions/2.0.21/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  346. package/.versions/2.0.21/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  347. package/.versions/2.0.21/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  348. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  349. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-health.js +110 -0
  350. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-start.ts +42 -0
  351. package/.versions/2.0.21/.pi/harnesses/agent-hub/spawn.ts +639 -0
  352. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  353. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  354. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  355. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  356. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  357. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  358. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  359. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  360. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  361. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  362. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  363. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  364. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  365. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  366. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  367. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  368. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  369. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  370. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  371. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  372. package/.versions/2.0.21/.pi/harnesses/agent-hub/timeline.ts +72 -0
  373. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  374. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  375. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  376. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  377. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  378. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  379. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  380. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  381. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  382. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +640 -0
  383. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  384. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  385. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  386. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  387. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  388. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  389. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  390. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  391. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  392. package/.versions/2.0.21/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  393. package/.versions/2.0.21/.pi/harnesses/agent-hub/types.ts +66 -0
  394. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  395. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  396. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  397. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  398. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  399. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  400. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  401. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  402. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  403. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  404. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  405. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  406. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  407. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  408. package/.versions/2.0.21/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  409. package/.versions/2.0.21/.pi/harnesses/agent-hub/version.ts +42 -0
  410. package/.versions/2.0.21/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  411. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  412. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  413. package/.versions/2.0.21/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  414. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/README.md +59 -0
  415. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/index.ts +569 -0
  416. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  417. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  418. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  419. package/.versions/2.0.21/.pi/harnesses/coms/README.md +100 -0
  420. package/.versions/2.0.21/.pi/harnesses/coms/index.ts +285 -0
  421. package/.versions/2.0.21/.pi/harnesses/coms/package.json +7 -0
  422. package/.versions/2.0.21/.pi/harnesses/coms/version.ts +42 -0
  423. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/README.md +161 -0
  424. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/index.ts +600 -0
  425. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/package.json +7 -0
  426. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  427. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  428. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  429. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  430. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/version.ts +42 -0
  431. package/.versions/2.0.21/.pi/harnesses/lib/approval-wait.ts +17 -0
  432. package/.versions/2.0.21/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  433. package/.versions/2.0.21/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  434. package/.versions/2.0.21/.pi/harnesses/lib/clarification-policy.ts +9 -0
  435. package/.versions/2.0.21/.pi/harnesses/lib/coms-core-io.ts +413 -0
  436. package/.versions/2.0.21/.pi/harnesses/lib/coms-core.ts +680 -0
  437. package/.versions/2.0.21/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  438. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  439. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  440. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-view.ts +112 -0
  441. package/.versions/2.0.21/.pi/harnesses/lib/context-budget.ts +114 -0
  442. package/.versions/2.0.21/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  443. package/.versions/2.0.21/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  444. package/.versions/2.0.21/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  445. package/.versions/2.0.21/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  446. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  447. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-view.ts +16 -0
  448. package/.versions/2.0.21/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  449. package/.versions/2.0.21/.pi/harnesses/lib/execution-trace.ts +45 -0
  450. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  451. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  452. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  453. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  454. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  455. package/.versions/2.0.21/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  456. package/.versions/2.0.21/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  457. package/.versions/2.0.21/.pi/harnesses/lib/fleet-panel.ts +34 -0
  458. package/.versions/2.0.21/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  459. package/.versions/2.0.21/.pi/harnesses/lib/fleet-selection.ts +24 -0
  460. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  461. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  462. package/.versions/2.0.21/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  463. package/.versions/2.0.21/.pi/harnesses/lib/herdr-client.ts +472 -0
  464. package/.versions/2.0.21/.pi/harnesses/lib/herdr-presence.ts +399 -0
  465. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  466. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  467. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  468. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  469. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  470. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  471. package/.versions/2.0.21/.pi/harnesses/lib/identical-dialog.ts +27 -0
  472. package/.versions/2.0.21/.pi/harnesses/lib/installation-state.js +62 -0
  473. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.js +106 -0
  474. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.ts +31 -0
  475. package/.versions/2.0.21/.pi/harnesses/lib/process-shared.ts +9 -0
  476. package/.versions/2.0.21/.pi/harnesses/lib/safe-source-read.js +29 -0
  477. package/.versions/2.0.21/.pi/harnesses/lib/semantic-approval.ts +80 -0
  478. package/.versions/2.0.21/.pi/harnesses/lib/spawned-peers.js +191 -0
  479. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  480. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  481. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  482. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  483. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-json.js +37 -0
  484. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-loader.js +44 -0
  485. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  486. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-triage.js +42 -0
  487. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-v2.js +112 -0
  488. package/.versions/2.0.21/.pi/harnesses/lib/system1/config.js +50 -0
  489. package/.versions/2.0.21/.pi/harnesses/lib/system1/contracts.ts +154 -0
  490. package/.versions/2.0.21/.pi/harnesses/lib/system1/demo.ts +95 -0
  491. package/.versions/2.0.21/.pi/harnesses/lib/system1/jev.ts +503 -0
  492. package/.versions/2.0.21/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  493. package/.versions/2.0.21/.pi/harnesses/lib/system1/selection.js +11 -0
  494. package/.versions/2.0.21/.pi/harnesses/lib/system1/service.ts +245 -0
  495. package/.versions/2.0.21/.pi/harnesses/lib/update-check.ts +222 -0
  496. package/.versions/2.0.21/.pi/harnesses/package-lock.json +2121 -0
  497. package/.versions/2.0.21/.pi/harnesses/package.json +13 -0
  498. package/.versions/2.0.21/.pi/prompts/af-build.md +27 -0
  499. package/.versions/2.0.21/.pi/prompts/af-code-simplify.md +22 -0
  500. package/.versions/2.0.21/.pi/prompts/af-constraints.md +31 -0
  501. package/.versions/2.0.21/.pi/prompts/af-plan.md +17 -0
  502. package/.versions/2.0.21/.pi/prompts/af-review.md +16 -0
  503. package/.versions/2.0.21/.pi/prompts/af-set-hermes-telegram.md +15 -0
  504. package/.versions/2.0.21/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  505. package/.versions/2.0.21/.pi/prompts/af-setup-rules.md +20 -0
  506. package/.versions/2.0.21/.pi/prompts/af-ship.md +17 -0
  507. package/.versions/2.0.21/.pi/prompts/af-spec.md +15 -0
  508. package/.versions/2.0.21/.pi/prompts/af-test.md +19 -0
  509. package/.versions/2.0.21/.pi/skills/bowser/SKILL.md +145 -0
  510. package/.versions/2.0.21/.version +1 -0
  511. package/.versions/2.0.21/agents/architect.md +24 -0
  512. package/.versions/2.0.21/agents/bowser.md +28 -0
  513. package/.versions/2.0.21/agents/builder.md +55 -0
  514. package/.versions/2.0.21/agents/code-reviewer.md +209 -0
  515. package/.versions/2.0.21/agents/deep-researcher.md +32 -0
  516. package/.versions/2.0.21/agents/documenter.md +22 -0
  517. package/.versions/2.0.21/agents/orchestrator.md +22 -0
  518. package/.versions/2.0.21/agents/plan-reviewer.md +83 -0
  519. package/.versions/2.0.21/agents/planner.md +107 -0
  520. package/.versions/2.0.21/agents/releaser.md +24 -0
  521. package/.versions/2.0.21/agents/researcher.md +30 -0
  522. package/.versions/2.0.21/agents/security-auditor.md +167 -0
  523. package/.versions/2.0.21/agents/test-engineer.md +153 -0
  524. package/.versions/2.0.21/agents/web-debugger.md +44 -0
  525. package/.versions/2.0.21/agents/web-performance-auditor.md +194 -0
  526. package/.versions/2.0.21/bin/catalog/harness-runtime-closure.json +73 -0
  527. package/.versions/2.0.21/codex/fleet-session-client/SKILL.md +34 -0
  528. package/.versions/2.0.21/codex/fleet-session-client.zip +0 -0
  529. package/.versions/2.0.21/docs/ARCHITECTURE.md +979 -0
  530. package/.versions/2.0.21/docs/agent-fleet-setup.md +1103 -0
  531. package/.versions/2.0.21/docs/claude-code-coms-bridge.md +147 -0
  532. package/.versions/2.0.21/docs/codex-session-bridge.md +219 -0
  533. package/.versions/2.0.21/docs/coms-hermes-bridge.md +188 -0
  534. package/.versions/2.0.21/docs/getting-started.md +126 -0
  535. package/.versions/2.0.21/docs/npm-install.md +535 -0
  536. package/.versions/2.0.21/docs/pi-extensions.md +455 -0
  537. package/.versions/2.0.21/docs/pi-setup.md +92 -0
  538. package/.versions/2.0.21/docs/skill-anatomy.md +150 -0
  539. package/.versions/2.0.21/install-manifest.json +3210 -0
  540. package/.versions/2.0.21/justfile +247 -0
  541. package/.versions/2.0.21/manifest-meta.json +1088 -0
  542. package/.versions/2.0.21/references/accessibility-checklist.md +160 -0
  543. package/.versions/2.0.21/references/communication-contract.md +26 -0
  544. package/.versions/2.0.21/references/definition-of-done.md +67 -0
  545. package/.versions/2.0.21/references/fleet-coordination-patterns.md +171 -0
  546. package/.versions/2.0.21/references/observability-checklist.md +92 -0
  547. package/.versions/2.0.21/references/orchestration-patterns.md +370 -0
  548. package/.versions/2.0.21/references/performance-checklist.md +236 -0
  549. package/.versions/2.0.21/references/prompting-patterns.md +380 -0
  550. package/.versions/2.0.21/references/security-checklist.md +245 -0
  551. package/.versions/2.0.21/references/testing-patterns.md +235 -0
  552. package/.versions/2.0.21/references/workflow-authoring.md +304 -0
  553. package/.versions/2.0.21/skills/_internal/grilling.md +59 -0
  554. package/.versions/2.0.21/skills/browser-testing-with-devtools/SKILL.md +351 -0
  555. package/.versions/2.0.21/skills/code-review-and-quality/SKILL.md +396 -0
  556. package/.versions/2.0.21/skills/compound-learning/SKILL.md +137 -0
  557. package/.versions/2.0.21/skills/constraint-driven-development/SKILL.md +338 -0
  558. package/.versions/2.0.21/skills/constraint-driven-development/references/floor-guard.md +99 -0
  559. package/.versions/2.0.21/skills/context-engineering/SKILL.md +341 -0
  560. package/.versions/2.0.21/skills/deprecation-and-migration/SKILL.md +247 -0
  561. package/.versions/2.0.21/skills/designing-agents/SKILL.md +394 -0
  562. package/.versions/2.0.21/skills/designing-agents/pi-harness-authoring.md +222 -0
  563. package/.versions/2.0.21/skills/drafting-workflows/SKILL.md +143 -0
  564. package/.versions/2.0.21/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  565. package/.versions/2.0.21/skills/frontend-ui-engineering/SKILL.md +328 -0
  566. package/.versions/2.0.21/skills/git-workflow-and-versioning/SKILL.md +316 -0
  567. package/.versions/2.0.21/skills/idea-refine/SKILL.md +182 -0
  568. package/.versions/2.0.21/skills/idea-refine/examples.md +238 -0
  569. package/.versions/2.0.21/skills/idea-refine/frameworks.md +99 -0
  570. package/.versions/2.0.21/skills/idea-refine/refinement-criteria.md +113 -0
  571. package/.versions/2.0.21/skills/idea-refine/scripts/idea-refine.sh +15 -0
  572. package/.versions/2.0.21/skills/incremental-implementation/SKILL.md +353 -0
  573. package/.versions/2.0.21/skills/incremental-implementation.zip +0 -0
  574. package/.versions/2.0.21/skills/interview-me/SKILL.md +226 -0
  575. package/.versions/2.0.21/skills/orchestration-verification/SKILL.md +182 -0
  576. package/.versions/2.0.21/skills/peer-coms/SKILL.md +90 -0
  577. package/.versions/2.0.21/skills/performance-optimization/SKILL.md +496 -0
  578. package/.versions/2.0.21/skills/planning-and-task-breakdown/SKILL.md +318 -0
  579. package/.versions/2.0.21/skills/planning-and-task-breakdown.zip +0 -0
  580. package/.versions/2.0.21/skills/repository-ai-setup/SKILL.md +135 -0
  581. package/.versions/2.0.21/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  582. package/.versions/2.0.21/skills/repository-ai-setup/references/apply-contract.md +74 -0
  583. package/.versions/2.0.21/skills/repository-ai-setup/references/provenance-template.md +16 -0
  584. package/.versions/2.0.21/skills/repository-ai-setup/references/setup-flow.md +108 -0
  585. package/.versions/2.0.21/skills/repository-ai-setup/references/verify-setup.md +20 -0
  586. package/.versions/2.0.21/skills/repository-ai-setup.zip +0 -0
  587. package/.versions/2.0.21/skills/security-and-hardening/SKILL.md +524 -0
  588. package/.versions/2.0.21/skills/spec-driven-development/SKILL.md +295 -0
  589. package/.versions/2.0.21/skills/spec-driven-development.zip +0 -0
  590. package/.versions/2.0.21/skills/using-agent-skills/SKILL.md +198 -0
  591. package/.versions/2.0.21/vendor/agent-skills-upstream/LICENSE +21 -0
  592. package/.versions/2.0.21/vendor/agent-skills-upstream/README.md +430 -0
  593. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  594. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  595. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  596. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  597. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  598. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  599. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  600. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  601. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  602. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  603. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  604. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  605. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  606. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  607. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  608. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  609. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  610. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  611. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  612. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  613. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  614. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  615. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  616. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  617. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  618. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  619. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  620. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  621. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  622. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  623. package/CHANGELOG.md +6 -0
  624. package/docs/ARCHITECTURE.md +4 -2
  625. package/install-manifest.json +1 -1
  626. package/package.json +1 -1
@@ -0,0 +1,241 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
3
+ import { EXECUTION_TRACE_CHANNEL, policyTraceReason, type TraceEnvelope, type TraceEnd, type TraceKind, type TraceSource, type TraceStart, type TraceStatus } from "../lib/execution-trace.ts";
4
+
5
+ export const EXECUTION_TRACE_ENTRY = "agent-hub-execution-trace";
6
+ // v2 journals one row per finished span (start time, end time and outcome together);
7
+ // only long-lived turn/child spans also journal their start, so a crash still shows
8
+ // what was in flight. v1 rows (separate start/end) from older sessions remain readable.
9
+ const SCHEMA = "agent-fleet.execution-trace/v2";
10
+ const LEGACY_SCHEMA = "agent-fleet.execution-trace/v1";
11
+ const JOURNALED_STARTS = new Set<TraceKind>(["turn", "child"]);
12
+ const MAX_ROWS = 5000;
13
+ const kinds = new Set<TraceKind>(["input", "turn", "model", "tool", "policy", "approval", "queue", "child"]);
14
+ const sources = new Set<TraceSource>(["runtime", "native", "process", "task-triage", "damage-control", "damage-guard", "access-escalation"]);
15
+ const statuses = new Set<TraceStatus>(["pending", "completed", "failed", "allowed", "denied", "blocked", "cancelled", "interrupted", "unavailable", "reused", "not_started", "busy"]);
16
+ const reasons = new Set(["zero_access", "read_only", "no_delete", "authority_changed", "human_denial", "policy_rule", "task_transition_pending", "process_state_corrupt", "risk_required", "action_confirmation_unsupported", "approval_queue"]);
17
+ const actors = new Set(["operator", "specialist", "builder", "planner", "plan-reviewer", "code-reviewer", "security-auditor", "test-engineer", "researcher", "deep-researcher", "architect", "documenter", "debugger"]);
18
+ const tools = new Set(["bash", "read", "write", "edit", "grep", "find", "ls", "filesystem", "ask_user", "dispatch_agent", "spawn_research", "set_task_tier", "set_assertions", "update_assertion", "get_assertions", "coms_send", "coms_get", "coms_await", "delegate"]);
19
+ const hash = (value: string) => createHash("sha256").update(value).digest("hex");
20
+ const millis = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value >= 0;
21
+ const digest = (value: unknown): value is string => typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
22
+
23
+ export interface ExecutionTraceRow {
24
+ schema: typeof SCHEMA | typeof LEGACY_SCHEMA; instanceId: string; sequence: number; atMs: number;
25
+ /** Present on a v2 finished-span row; atMs is then the span's start. */
26
+ endAtMs?: number;
27
+ spanId: string; parentSpanId: string | null; ownerIdHash: string; taskIdHash: string; inputRevisionHash: string;
28
+ kind: TraceKind; source: TraceSource; phase: "start" | "end" | "span"; status: TraceStatus;
29
+ tool?: string; ruleId?: string; fingerprint?: string; childIdHash?: string; durationMs?: number;
30
+ decision?: TraceEnd["decision"];
31
+ reason?: string;
32
+ actor: string; analysis?: TraceEnd["analysis"];
33
+ }
34
+ export interface ExecutionTraceSnapshot { rows: ExecutionTraceRow[]; persistenceFailures: number; droppedRows: number; open?: ExecutionTraceRow[]; }
35
+
36
+ export function createExecutionTrace(ports: { identity(): { taskId: string; inputRevision: string }; persist(row: ExecutionTraceRow): void; now?(): number }) {
37
+ let instanceId = randomUUID(), sequence = 0, persistenceFailures = 0, droppedRows = 0;
38
+ const active = new Map<string, { row: ExecutionTraceRow; finish: (end: TraceEnd) => void }>();
39
+ const rows: ExecutionTraceRow[] = [];
40
+ const now = ports.now ?? Date.now;
41
+ const key = (kind: TraceKind, id: string, owner = "hub") => JSON.stringify([kind, owner, id]);
42
+ const spanId = (kind: TraceKind, id: string, owner = "hub") => hash(JSON.stringify([instanceId, kind, owner, id]));
43
+ const record = (row: ExecutionTraceRow) => {
44
+ rows.push(row); if (rows.length > MAX_ROWS) { rows.shift(); droppedRows++; }
45
+ try { ports.persist(row); } catch { persistenceFailures++; }
46
+ };
47
+ const start = (input: TraceStart, capturedIdentity?: ReturnType<typeof ports.identity>): ((end: TraceEnd) => void) => {
48
+ if (!input || !kinds.has(input.kind) || typeof input.id !== "string" || !input.id || input.id.length > 512) return () => {};
49
+ const binding = key(input.kind, input.id, input.owner), prior = active.get(binding);
50
+ if (prior) return prior.finish;
51
+ const identity = capturedIdentity ?? ports.identity(), epoch = instanceId;
52
+ const parent=input.parentId?active.get(key(input.parentKind??"tool",input.parentId,input.owner))?.row:undefined;
53
+ const child=input.owner?active.get(key("child",input.owner,input.owner))?.row:undefined;
54
+ const row: ExecutionTraceRow = {
55
+ schema: SCHEMA, instanceId, sequence: ++sequence, atMs: now(),
56
+ spanId: spanId(input.kind, input.id, input.owner),
57
+ parentSpanId: input.parentId ? spanId(input.parentKind ?? "tool", input.parentId, input.owner) : null,
58
+ ownerIdHash: hash(input.owner ?? "hub"), taskIdHash: parent?.taskIdHash??child?.taskIdHash??hash(identity.taskId), inputRevisionHash: parent?.inputRevisionHash??child?.inputRevisionHash??hash(identity.inputRevision),
59
+ actor: input.actor&&actors.has(input.actor)?input.actor:parent?.actor??child?.actor??(!input.owner||input.owner==="hub"?"operator":"specialist"),
60
+ kind: input.kind, source: input.source && sources.has(input.source) ? input.source : "runtime", phase: "start", status: "pending",
61
+ ...(input.tool ? { tool: tools.has(input.tool) ? input.tool : "other" } : {}),
62
+ ...(input.rule ? { ruleId: hash(input.rule) } : {}), ...(input.fingerprint ? { fingerprint: hash(input.fingerprint) } : {}),
63
+ ...(input.reason && reasons.has(input.reason) ? { reason: input.reason } : {}),
64
+ };
65
+ const finish = (end: TraceEnd) => {
66
+ if (instanceId !== epoch || active.get(binding)?.row !== row || !end || !statuses.has(end.status)) return;
67
+ active.delete(binding);
68
+ record({ ...row, sequence: ++sequence, endAtMs: Math.max(row.atMs, now()), phase: "span", status: end.status,
69
+ ...(millis(end.durationMs) ? { durationMs: end.durationMs } : {}), ...(end.childId ? { childIdHash: hash(end.childId) } : {}),
70
+ ...(end.rule ? { ruleId: hash(end.rule) } : {}), ...(end.reason && reasons.has(end.reason) ? { reason: end.reason } : {}),
71
+ ...(end.analysis && ["static_operands","conservative_text"].includes(end.analysis) ? {analysis:end.analysis} : {}),
72
+ ...(end.decision && ["selected_first", "selected_second", "freeform", "multiple", "none"].includes(end.decision) ? { decision: end.decision } : {}) });
73
+ };
74
+ active.set(binding, { row, finish }); if (JOURNALED_STARTS.has(row.kind)) record(row); return finish;
75
+ };
76
+ const close = () => { for (const item of [...active.values()]) item.finish({ status: "interrupted" }); };
77
+ return {
78
+ start: (input:TraceStart) => start(input),
79
+ endTool(id: string, end: TraceEnd, owner = "hub") { active.get(key("tool", id, owner))?.finish(end); },
80
+ input(id: string) { start({ kind: "input", id })({ status: "completed" }); },
81
+ close,
82
+ reset() { close(); instanceId = randomUUID(); sequence = 0; rows.length = 0; persistenceFailures = 0; droppedRows = 0; },
83
+ snapshot: (): ExecutionTraceSnapshot => ({ rows: [...rows], persistenceFailures, droppedRows, open: [...active.values()].map(item => item.row) }),
84
+ forOwner(owner: string) {
85
+ const epoch=instanceId,identity=ports.identity();
86
+ return {
87
+ start: (input:TraceStart) => instanceId===epoch ? start({...input,owner},identity) : (_end:TraceEnd)=>{},
88
+ endTool: (id:string,end:TraceEnd) => { if(instanceId===epoch)active.get(key("tool",id,owner))?.finish(end); },
89
+ close: () => { if(instanceId===epoch)for(const item of [...active.values()])if(item.row.ownerIdHash===hash(owner))item.finish({status:"interrupted"}); },
90
+ };
91
+ },
92
+ };
93
+ }
94
+ export type ExecutionTrace = ReturnType<typeof createExecutionTrace>;
95
+
96
+ /** Native callbacks already transport tool metadata; no new child transport. */
97
+ export function createNativeExecutionTrace(trace:ExecutionTrace,owner:string,actor?:string) {
98
+ const scope=trace.forOwner(owner),finish=scope.start({kind:"child",id:owner,actor});
99
+ let closed=false;
100
+ return {
101
+ toolStart(tool:string,args:string,id?:string) { if(id&&!closed)scope.start({kind:"tool",id,parentId:owner,parentKind:"child",tool,source:"native",fingerprint:args}); },
102
+ toolEnd(tool:string,id?:string,isError?:boolean,resultText?:string,durationMs?:number) {
103
+ if(!id||closed)return;
104
+ // An allowlisted marker explains refusal; it is never proof or permission.
105
+ const blocked=isError&&durationMs===undefined&&/Damage-Control:/.test(resultText??"");
106
+ if(blocked)scope.start({kind:"policy",id:`baseline:${id}`,parentId:id,source:"damage-control",tool,rule:(resultText??"").split("\n",1)[0],reason:policyTraceReason(resultText??"")})({status:"blocked"});
107
+ scope.endTool(id,{status:blocked?"blocked":isError?"failed":"completed",durationMs});
108
+ },
109
+ finish(result:{exitCode:number;pending?:boolean}) { closed=true;finish({status:result.pending?"pending":result.exitCode===0?"completed":"failed"});scope.close(); },
110
+ };
111
+ }
112
+
113
+ function normalizeRow(raw: unknown): ExecutionTraceRow | null {
114
+ if (!raw || typeof raw !== "object") return null;
115
+ const row = raw as ExecutionTraceRow;
116
+ const phases = row.schema === SCHEMA ? ["start", "span"] : row.schema === LEGACY_SCHEMA ? ["start", "end"] : [];
117
+ if (!/^[a-f0-9-]{36}$/.test(row.instanceId) || !Number.isSafeInteger(row.sequence) || row.sequence < 1 || !millis(row.atMs)
118
+ || !digest(row.spanId) || row.parentSpanId !== null && !digest(row.parentSpanId) || ![row.ownerIdHash, row.taskIdHash, row.inputRevisionHash].every(digest)
119
+ || !kinds.has(row.kind) || !sources.has(row.source) || !phases.includes(row.phase) || !statuses.has(row.status)
120
+ || row.phase === "span" && !(millis(row.endAtMs) && row.endAtMs >= row.atMs)) return null;
121
+ return { schema: row.schema, instanceId: row.instanceId, sequence: row.sequence, atMs: row.atMs, ...(row.phase === "span" ? { endAtMs: row.endAtMs } : {}), spanId: row.spanId, parentSpanId: row.parentSpanId,
122
+ ownerIdHash: row.ownerIdHash, taskIdHash: row.taskIdHash, inputRevisionHash: row.inputRevisionHash, kind: row.kind, source: row.source, phase: row.phase, status: row.status,
123
+ actor: actors.has(row.actor)?row.actor:"specialist",...(row.analysis&&["static_operands","conservative_text"].includes(row.analysis)?{analysis:row.analysis}:{}),
124
+ ...(row.tool && (tools.has(row.tool) || row.tool === "other") ? { tool: row.tool } : {}),
125
+ ...(digest(row.ruleId) ? { ruleId: row.ruleId } : {}), ...(digest(row.fingerprint) ? { fingerprint: row.fingerprint } : {}),
126
+ ...(digest(row.childIdHash) ? { childIdHash: row.childIdHash } : {}), ...(millis(row.durationMs) ? { durationMs: row.durationMs } : {}),
127
+ ...(row.decision && ["selected_first", "selected_second", "freeform", "multiple", "none"].includes(row.decision) ? { decision: row.decision } : {}),
128
+ ...(row.reason && reasons.has(row.reason) ? { reason: row.reason } : {}),
129
+ };
130
+ }
131
+ type Interval = [number, number];
132
+ function union(intervals: Interval[]): Interval[] {
133
+ const merged: Interval[] = [];
134
+ for (const [start, end] of intervals.sort((a, b) => a[0] - b[0])) {
135
+ const last = merged.at(-1);
136
+ if (last && start <= last[1]) last[1] = Math.max(last[1], end); else merged.push([start, end]);
137
+ }
138
+ return merged;
139
+ }
140
+ const length = (intervals: Interval[]) => union(intervals).reduce((sum, [a, b]) => sum + Math.max(0, b - a), 0);
141
+ const intersections = (left: Interval[], right: Interval[]) => left.flatMap(([a, b]) => right.map(([c, d]): Interval => [Math.max(a, c), Math.max(Math.max(a, c), Math.min(b, d))]));
142
+
143
+ export function projectExecutionTrace(entries: readonly unknown[], live?: ExecutionTraceSnapshot) {
144
+ let invalidRecords = 0, duplicateRecords = 0, droppedRows = 0;
145
+ const retained = new Map<string, ExecutionTraceRow>();
146
+ for (const entry of entries) {
147
+ const value = entry as { customType?: unknown; data?: unknown };
148
+ if (value?.customType !== EXECUTION_TRACE_ENTRY) continue;
149
+ const row = normalizeRow(value.data); if (!row) { invalidRecords++; continue; }
150
+ const key = `${row.instanceId}:${row.sequence}`, previous = retained.get(key);
151
+ if (previous) { duplicateRecords++; if (JSON.stringify(previous) !== JSON.stringify(row)) invalidRecords++; }
152
+ else retained.set(key, row);
153
+ }
154
+ if (live?.persistenceFailures) for (const raw of live.rows) { const row = normalizeRow(raw); if (row) retained.set(`${row.instanceId}:${row.sequence}`, row); }
155
+ // Unfinished spans are journaled only for turn/child; the live view still shows the rest.
156
+ for (const raw of live?.open ?? []) { const row = normalizeRow(raw); if (row) retained.set(`${row.instanceId}:${row.sequence}`, row); }
157
+ const all = [...retained.values()].sort((a, b) => a.atMs - b.atMs || a.sequence - b.sequence);
158
+ if (all.length > MAX_ROWS) droppedRows += all.length - MAX_ROWS;
159
+ const events = all.slice(-MAX_ROWS), grouped = new Map<string, { start?: ExecutionTraceRow; end?: ExecutionTraceRow }>();
160
+ for (const row of events) {
161
+ const item = grouped.get(row.spanId) ?? {};
162
+ if (row.phase === "span") { item.start ??= row; item.end = { ...row, atMs: row.endAtMs! }; } else item[row.phase] = row;
163
+ grouped.set(row.spanId, item);
164
+ }
165
+ const spans = [...grouped].map(([spanId, { start, end }]) => {
166
+ const row = start ?? end!;
167
+ return { spanId, instanceId: row.instanceId, parentSpanId: row.parentSpanId, ownerIdHash: row.ownerIdHash, taskIdHash: row.taskIdHash, inputRevisionHash: row.inputRevisionHash,
168
+ kind: row.kind, source: row.source, actor:row.actor, tool: row.tool, ruleId: end?.ruleId ?? row.ruleId, reason: end?.reason ?? row.reason, analysis:end?.analysis, fingerprint: row.fingerprint, childIdHash: end?.childIdHash, decision: end?.decision,
169
+ startedAt: start?.atMs ?? null, endedAt: end?.atMs ?? null, status: end?.status ?? "open", elapsedMs: start && end ? Math.max(0, end.atMs - start.atMs) : null,
170
+ executionMs: end?.durationMs ?? null, humanWaitMs: 0, executionWithoutHumanMs: null as number | null, repeatOf: null as string | null,
171
+ correlation: row.parentSpanId ? "direct" : null as string | null };
172
+ });
173
+ const byId = new Map(spans.map(s => [s.spanId, s]));
174
+ for (const child of spans.filter(s => s.kind === "child" && !s.parentSpanId)) {
175
+ const parents = spans.filter(s => s.kind === "tool" && s.instanceId === child.instanceId && s.childIdHash === child.ownerIdHash);
176
+ if (parents.length === 1) { child.parentSpanId = parents[0].spanId; child.correlation = "runtime_child"; }
177
+ }
178
+ // The existing child broker has its own request id. Join only one exact input
179
+ // observation from the same owner and time range; ambiguous calls stay unlinked.
180
+ for(const policy of spans.filter(s=>s.kind==="policy"&&!s.parentSpanId&&s.fingerprint&&s.source==="damage-guard")){
181
+ const candidates=spans.filter(s=>s.kind==="tool"&&s.instanceId===policy.instanceId&&s.ownerIdHash===policy.ownerIdHash&&s.tool===policy.tool&&s.fingerprint===policy.fingerprint
182
+ &&s.startedAt!==null&&policy.startedAt!==null&&s.startedAt<=policy.startedAt&&(s.endedAt===null||policy.endedAt!==null&&s.endedAt>=policy.endedAt));
183
+ if(candidates.length===1){policy.parentSpanId=candidates[0].spanId;policy.correlation="exact_input_unique";}
184
+ }
185
+ const below = (span: typeof spans[number], ancestor: typeof spans[number]) => {
186
+ const seen = new Set<string>(); let parent = span.parentSpanId;
187
+ while (parent && !seen.has(parent)) { if (parent === ancestor.spanId) return true; seen.add(parent); parent = byId.get(parent)?.parentSpanId ?? null; }
188
+ return false;
189
+ };
190
+ const interval = (s: typeof spans[number]): Interval[] => s.startedAt === null || s.endedAt === null ? [] : [[s.startedAt, s.endedAt]];
191
+ const waits = spans.filter(s => s.kind === "approval" && s.status !== "reused").flatMap(interval);
192
+ const repeats = new Map<string, string>();
193
+ for (const tool of spans.filter(s => s.kind === "tool")) {
194
+ const ownWaits = spans.filter(s => s.kind === "approval" && s.status !== "reused" && below(s, tool)).flatMap(interval);
195
+ tool.humanWaitMs = length(ownWaits);
196
+ if (tool.executionMs !== null && tool.endedAt !== null) {
197
+ const execution: Interval[] = [[Math.max(tool.startedAt ?? 0, tool.endedAt - tool.executionMs), tool.endedAt]];
198
+ tool.executionWithoutHumanMs = Math.max(0, tool.executionMs - length(intersections(execution, ownWaits)));
199
+ }
200
+ if (tool.status === "failed" && tool.executionMs === null && spans.some(s => s.kind === "policy" && s.parentSpanId === tool.spanId && s.status === "blocked")) tool.status = "blocked";
201
+ if (tool.fingerprint) { const key = JSON.stringify([tool.instanceId, tool.ownerIdHash, tool.taskIdHash, tool.inputRevisionHash, tool.tool, tool.fingerprint]); tool.repeatOf = repeats.get(key) ?? null; repeats.set(key, tool.spanId); }
202
+ }
203
+ const executions: Interval[] = spans.filter(s => s.kind === "tool" && s.executionMs !== null && s.endedAt !== null).map(s => [Math.max(s.startedAt ?? 0, s.endedAt! - s.executionMs!), s.endedAt!]);
204
+ return { schema: SCHEMA, diagnosticOnly: true,
205
+ coverage: { availability: live?.persistenceFailures ? "live_degraded" : events.length ? "recorded" : "not_recorded", persistenceFailures: live?.persistenceFailures ?? 0,
206
+ invalidRecords, duplicateRecords, droppedRows, liveDroppedRows: live?.droppedRows ?? 0, openSpans: spans.filter(s => s.status === "open").length,
207
+ incompleteSpans: spans.filter(s => s.startedAt === null || s.endedAt === null || ["interrupted","pending"].includes(s.status)).length,
208
+ unlinkedSpans: spans.filter(s=>s.parentSpanId&&!byId.has(s.parentSpanId)||s.kind==="policy"&&s.source==="damage-guard"&&!s.parentSpanId).length },
209
+ totals: { scope:"retained_trace_window", observedWallMs: events.length ? Math.max(0, Math.max(...events.map(row => row.endAtMs ?? row.atMs)) - events[0].atMs) : null,
210
+ toolActivityMs: events.length?length(spans.filter(s => s.kind === "tool").flatMap(interval)):null, humanWaitMs: events.length?length(waits):null,
211
+ queueWaitMs: events.length?length(spans.filter(s=>s.kind==="queue").flatMap(interval)):null, modelRoundMs: events.length?length(spans.filter(s=>s.kind==="model").flatMap(interval)):null,
212
+ executionMs: events.length?length(executions):null, executionWithoutHumanMs: events.length?Math.max(0, length(executions) - length(intersections(executions, waits))):null,
213
+ repeatedTools: spans.filter(s => s.repeatOf).length, blockedTools: spans.filter(s => s.kind === "tool" && s.status === "blocked").length },
214
+ spans, events,
215
+ };
216
+ }
217
+
218
+ export function registerExecutionTrace(pi: Pick<ExtensionAPI, "on" | "events">, trace: ExecutionTrace): void {
219
+ const receive = (value: unknown) => {
220
+ const envelope = value as TraceEnvelope;
221
+ if (envelope?.start) envelope.finish = trace.start(envelope.start);
222
+ };
223
+ let unsubscribe: (() => void) | undefined = pi.events.on(EXECUTION_TRACE_CHANNEL, receive);
224
+ pi.on("session_start", async () => { trace.reset(); unsubscribe ??= pi.events.on(EXECUTION_TRACE_CHANNEL, receive); });
225
+ // before_switch is only a proposal: another extension may cancel it.
226
+ pi.on("session_shutdown", async () => { trace.close(); unsubscribe?.(); unsubscribe = undefined; });
227
+ let finishTurn: ((end: TraceEnd) => void) | undefined;
228
+ let finishModel: ((end: TraceEnd) => void) | undefined;
229
+ pi.on("agent_start", async () => { finishTurn = trace.start({ kind: "turn", id: randomUUID() }); });
230
+ pi.on("agent_end", async () => { finishTurn?.({ status: "completed" }); trace.close(); });
231
+ pi.on("turn_start",async()=>{finishModel=trace.start({kind:"model",id:randomUUID()});});
232
+ pi.on("message_end",async event=>{if(event.message.role==="assistant")finishModel?.({status:event.message.stopReason==="error"?"failed":event.message.stopReason==="aborted"?"cancelled":"completed"});});
233
+ pi.on("tool_execution_start", async event => {
234
+ trace.start({ kind: "tool", id: event.toolCallId, tool: event.toolName, fingerprint: JSON.stringify(event.args ?? {}) });
235
+ });
236
+ pi.on("tool_execution_end", async event => {
237
+ const details = event.result?.details as Record<string, unknown> | undefined;
238
+ const status: TraceStatus = details?.status === "review_reused" ? "reused" : details?.status === "busy" ? "busy" : details?.started === false ? "not_started" : event.isError ? "failed" : "completed";
239
+ trace.endTool(event.toolCallId, { status, durationMs: (event as typeof event & { durationMs?: number }).durationMs, childId: typeof details?.dispatchId === "string" ? details.dispatchId : undefined });
240
+ });
241
+ }
@@ -0,0 +1,85 @@
1
+ // External-blocker circuit breaker — the pure policy core behind "stop when the
2
+ // thing you need is not yours to get".
3
+ //
4
+ // The observed failure: a runtime-telemetry assertion could not be proven
5
+ // because the correlation destination did not exist outside the fleet. Nothing
6
+ // stopped the line, so the run kept substituting internal work for the missing
7
+ // external fact — building manifests, fixtures, and diagnostic packets — for
8
+ // hours, and the assertion ended UNPROVEN anyway. An external blocker is not a
9
+ // harder version of the task; it is the end of what delegation can buy.
10
+ //
11
+ // Protocol: a specialist that cannot proceed without something outside the
12
+ // fleet's reach emits `EXTERNAL_BLOCKED: <what is missing and who owns it>`.
13
+ // The hub records it and refuses the NEXT dispatch/research until the human has
14
+ // been addressed — the escalation is the deliverable at that point.
15
+
16
+ /** Pull `EXTERNAL_BLOCKED: …` markers out of a specialist's output. */
17
+ export function extractExternalBlockers(output) {
18
+ const blockers = [];
19
+ for (const rawLine of String(output || "").split("\n")) {
20
+ const line = rawLine.trim();
21
+ const match = line.match(/^EXTERNAL_BLOCKED\s*:\s*(.+)$/i);
22
+ if (match) {
23
+ const what = match[1].trim();
24
+ if (what && !blockers.includes(what)) blockers.push(what);
25
+ }
26
+ }
27
+ return blockers;
28
+ }
29
+
30
+ /**
31
+ * Gate the next dispatcher call while an external blocker is unacknowledged.
32
+ *
33
+ * state: {
34
+ * blockers: [{ agent, what }], // recorded, newest last
35
+ * acknowledged: boolean, // human addressed (ask_user called, or new user turn)
36
+ * askUserAvailable: boolean, // whether this session has the ask_user tool
37
+ * refusedOnce: boolean, // a refusal was already issued for this blocker set
38
+ * }
39
+ *
40
+ * Returns null when allowed, else { reason, message }. Without ask_user the gate
41
+ * fires exactly once: a session that cannot reach the human must still be able
42
+ * to finish and report, and an unbreakable gate there is a deadlock, not a stop.
43
+ */
44
+ export function checkExternalBlockerGate(state) {
45
+ const blockers = state?.blockers || [];
46
+ if (blockers.length === 0) return null;
47
+ if (state?.acknowledged) return null;
48
+ if (!state?.askUserAvailable && state?.refusedOnce) return null;
49
+
50
+ const list = blockers.map((b) => ` - ${b.what}${b.agent ? ` (reported by ${b.agent})` : ""}`).join("\n");
51
+ const escalation = state?.askUserAvailable
52
+ ? "Call `ask_user` with the packet below. The gate opens as soon as you do."
53
+ : "`ask_user` is unavailable in this session: put the packet below in your reply to the human and stop " +
54
+ "this line of work. (This gate fires once; further dispatches are allowed so you can finish and report.)";
55
+
56
+ return {
57
+ reason: "external_blocked",
58
+ message: `⛔ EXTERNAL BLOCKER — dispatch refused and NOT counted against any budget.\n\n` +
59
+ `A specialist reported that it needs something outside the fleet's reach:\n${list}\n\n` +
60
+ `Do NOT route around this. Substituting internal work for a missing external fact — building ` +
61
+ `scripts, manifests, fixtures, or diagnostic packets to approximate it — is how a blocked ` +
62
+ `assertion turns into hours of work that still ends UNPROVEN.\n\n` +
63
+ `${escalation}\n\n` +
64
+ `Owner escalation packet (one message, no dispatches):\n` +
65
+ ` 1. WHAT is missing and who owns it.\n` +
66
+ ` 2. WHICH assertions/tasks are blocked on it, by id.\n` +
67
+ ` 3. WHAT is already proven and where the evidence lives (artifact paths).\n` +
68
+ ` 4. The concrete OPTIONS for the human: provide the missing access, waive the assertion as ` +
69
+ `UNPROVEN (a waiver is not a PASS), or drop the item from scope.\n` +
70
+ ` 5. What you will do while it is blocked — normally: the unrelated remaining work, or nothing.`,
71
+ };
72
+ }
73
+
74
+ /** The protocol paragraph injected into every specialist's system prompt. */
75
+ export function externalBlockedProtocol() {
76
+ return [
77
+ "- External blocker: if you cannot proceed because something OUTSIDE this repo and outside your",
78
+ " tools is missing — an account, a permission, a deployment credential, a telemetry/monitoring",
79
+ " destination, a third-party service, a human-only console action — do NOT build a substitute for",
80
+ " it and do NOT keep trying alternatives. Emit a line of the form",
81
+ " `EXTERNAL_BLOCKED: <what is missing, who owns it, and what it blocks>`, report what you DID",
82
+ " prove, and stop. The dispatcher escalates it to the human; approximating the missing fact with",
83
+ " extra scripts, fixtures, or manifests is the failure this protocol exists to prevent.",
84
+ ].join("\n");
85
+ }
@@ -0,0 +1,88 @@
1
+ import {basename,dirname,isAbsolute,relative,resolve} from 'node:path';
2
+ import {lstatSync,readdirSync,realpathSync} from 'node:fs';
3
+ import {checkedSourcePath} from '../../lib/safe-source-read.js';
4
+ import {exportPathAllowed} from '../agentic-sources.ts';
5
+ export const PINNED_PI_VERSION='1.1.0';
6
+ export interface CandidateSet {paths:string[];discoveryComplete:boolean;remaining:0|'unknown';reason?:string;hidden?:number;excluded?:number}
7
+ const refused=(reason:string):CandidateSet=>({paths:[],discoveryComplete:false,remaining:'unknown',reason});
8
+ export function canonicalCandidate(root:string,path:string,include:readonly string[]):string|undefined {
9
+ try{
10
+ const full=checkedSourcePath(root,resolve(root,path)),rel=relative(realpathSync(root),full).split('\\').join('/');
11
+ if(/(?:^|\/)file-discovery-[0-9a-f-]{36}\/page-\d+\.json$/.test(rel)||!lstatSync(full).isFile()||!exportPathAllowed(rel,include))return;
12
+ return rel;
13
+ }catch{return;}
14
+ }
15
+ function unambiguous(full:string,grep=false){
16
+ // Pi's fd formatter trims whitespace and newline-delimits names. Never guess their identity.
17
+ return !readdirSync(dirname(full)).some(n=>/[\x00-\x1f\x7f]/.test(n)||n.trim()!==n||grep&&(n.includes(':')||/-\d+-/.test(n)));
18
+ }
19
+ export function adaptDiscovery(options:{tool:string;args:Record<string,unknown>;result:any;cwd:string;root:string;include:readonly string[];piVersion?:string}):CandidateSet {
20
+ const {tool,args,result,root,include}=options;
21
+ if(options.piVersion!==undefined&&options.piVersion!==PINNED_PI_VERSION)return refused('unsupported_pi_version');
22
+ if(result?.isError)return refused('tool_error');
23
+ if(!['find','ls','grep','filesystem'].includes(tool))return refused('unsupported_tool');
24
+ let search:string;
25
+ try{
26
+ search=resolve(options.cwd,typeof args.path==='string'?args.path:'.');
27
+ if(search!==realpathSync(root))checkedSourcePath(root,search);
28
+ const rel=relative(realpathSync(root),search);if(isAbsolute(rel)||rel==='..'||rel.startsWith('../'))return refused('outside_workspace');
29
+ }catch{return refused('invalid_search_root');}
30
+ let complete=true,excluded=0;const candidates:string[]=[];
31
+ const add=(path:string)=>{const candidate=canonicalCandidate(root,path,include);if(candidate)candidates.push(candidate);else {try{if(lstatSync(checkedSourcePath(root,path)).isFile())excluded++;}catch{}}};
32
+ if(tool==='filesystem'){
33
+ const value=result?.details?.result;
34
+ if(args.operation==='stat'){
35
+ if(!value||value.path!==search||!['file','directory','other'].includes(value.type)||typeof value.selfRead!=='boolean'||!Number.isSafeInteger(value.limitBytes))return refused('unknown_shape');
36
+ if(value.type!=='file')return refused('not_file');
37
+ if(!Number.isSafeInteger(value.bytes)||value.bytes<0)return refused('unknown_shape');
38
+ add(search);return {paths:[...new Set(candidates)],discoveryComplete:true,remaining:0,excluded};
39
+ }
40
+ if(args.operation!=='inventory')return refused('unsupported_operation');
41
+ if(!value||value.root!==search||!Array.isArray(value.entries)||typeof value.truncated!=='boolean'||!Number.isSafeInteger(value.totalEntries))return refused('unknown_shape');
42
+ complete=!value.truncated;
43
+ for(const entry of value.entries){
44
+ if(typeof entry.name!=='string'||entry.name.includes('/')||/[\\\x00-\x1f\x7f]/.test(entry.name)||entry.path!==resolve(search,entry.name)||!['file','directory','symlink','other'].includes(entry.type))return refused('unknown_shape');
45
+ if(entry.type==='file'&&!entry.denied)add(entry.path);
46
+ }
47
+ }else{
48
+ if(!Array.isArray(result?.content)||result.content.length!==1||result.content[0].type!=='text'||typeof result.content[0].text!=='string')return refused('unknown_shape');
49
+ const details=result.details??{};
50
+ const allowed=tool==='find'?['resultLimitReached','truncation']:tool==='ls'?['entryLimitReached','truncation']:['matchLimitReached','truncation','linesTruncated'];
51
+ if(Object.keys(details).some(k=>!allowed.includes(k)))return refused('unknown_shape');
52
+ const limitKey=allowed[0],limit=details[limitKey],truncated=details.truncation?.truncated===true;
53
+ if(limit!==undefined&&(!Number.isSafeInteger(limit)||limit<=0)||details.truncation&&typeof details.truncation.truncated!=='boolean')return refused('unknown_shape');
54
+ complete=!limit&&!truncated;
55
+ let text:string=result.content[0].text;
56
+ const notices:string[]=[];
57
+ if(limit)notices.push(tool==='find'?`${limit} results limit reached. Use limit=${limit*2} for more, or refine pattern`:tool==='ls'?`${limit} entries limit reached. Use limit=${limit*2} for more`:`${limit} matches limit reached. Use limit=${limit*2} for more, or refine pattern`);
58
+ if(truncated)notices.push('50.0KB limit reached');
59
+ if(tool==='grep'&&details.linesTruncated)notices.push('Some lines truncated to 500 chars. Use read tool to see full lines');
60
+ if(notices.length){const suffix=`\n\n[${notices.join('. ')}]`;if(!text.endsWith(suffix))return refused('unknown_shape');text=text.slice(0,-suffix.length);}
61
+ const empty=tool==='find'?'No files found matching pattern':tool==='ls'?'(empty directory)':'No matches found';
62
+ if(text===empty){
63
+ if(tool!=='grep'){try{lstatSync(resolve(search,empty));return refused('ambiguous_filename');}catch{}}
64
+ return {paths:[],discoveryComplete:complete,remaining:complete?0:'unknown'};
65
+ }
66
+ const lines=text.split('\n'); // Pinned Pi truncateHead retains only complete lines.
67
+ for(const line of lines){
68
+ if(!line||/[\x00-\x1f\x7f]/.test(line))return refused('ambiguous_filename');
69
+ let name=line;
70
+ if(tool==='grep'){
71
+ const match=/^([^:]+):(\d+): /.exec(line),context=/^([^:]+?)-(\d+)- /.exec(line);
72
+ if(match&&context)return refused('ambiguous_filename');
73
+ if(!match&&!context)return refused('unknown_shape');
74
+ name=(match??context)![1];
75
+ if(!Number.isSafeInteger(Number((match??context)![2]))||Number((match??context)![2])<1)return refused('unknown_shape');
76
+ if(name.includes(':'))return refused('ambiguous_filename');
77
+ }
78
+ if(isAbsolute(name)||name.includes('\\')||name.trim()!==name||name.replace(/\/$/,'').split('/').some(p=>p==='.'||p==='..'||!p))return refused('ambiguous_filename');
79
+ if(name.endsWith('/')){if(tool==='grep')return refused('unknown_shape');continue;}
80
+ let isFile=false;try{isFile=tool==='grep'&&lstatSync(search).isFile();}catch{return refused('invalid_search_root');}
81
+ const full=isFile?search:resolve(search,name);
82
+ if(isFile&&basename(search)!==name)return refused('unknown_shape');
83
+ try{checkedSourcePath(root,full);if(!unambiguous(full,tool==='grep'))return refused('ambiguous_filename');}catch{complete=false;continue;}
84
+ add(full);
85
+ }
86
+ }
87
+ return {paths:[...new Set(candidates)].sort(),discoveryComplete:complete,remaining:complete?0:'unknown',excluded};
88
+ }
@@ -0,0 +1,62 @@
1
+ import {createConnection} from 'node:net';
2
+ import {randomUUID} from 'node:crypto';
3
+ import {TextDecoder} from 'node:util';
4
+ import type {DiscoveryAssignment} from './owners.ts';
5
+ import {FOREGROUND_MS} from './semantic-profiles.ts';
6
+ import {BROKER_LIMITS,type BrokerReply} from './broker.ts';
7
+ export function rankDiscovery(assignment:DiscoveryAssignment,input:{paths:readonly string[];foreground?:boolean;discovery:{complete:boolean;reason?:string}},signal?:AbortSignal,timeoutMs:number=BROKER_LIMITS.requestMs):Promise<BrokerReply> {
8
+ return discoveryRequest(assignment,{type:'rank_discovery',paths:input.paths,discovery:input.discovery,...(input.foreground?{foreground:true}:{})},signal,input.foreground?Math.min(timeoutMs,FOREGROUND_MS):timeoutMs);
9
+ }
10
+ export function registerDescendant(assignment:DiscoveryAssignment,input:{childId:string;task:string;query:string;tools:readonly string[]},signal?:AbortSignal):Promise<BrokerReply> {
11
+ return discoveryRequest(assignment,{type:'register_descendant',...input},signal);
12
+ }
13
+ export function revokeDiscoveryAttempt(assignment:DiscoveryAssignment):Promise<BrokerReply> {
14
+ return discoveryRequest(assignment,{type:'revoke_attempt'},undefined,1000);
15
+ }
16
+ async function discoveryRequest(assignment:DiscoveryAssignment,payload:Record<string,unknown>,signal?:AbortSignal,timeoutMs:number=BROKER_LIMITS.requestMs):Promise<BrokerReply> {
17
+ if(signal?.aborted)return {ok:false,error:'cancelled'};
18
+ if(process.platform==='win32')return {ok:false,error:'unsupported_platform'};
19
+ if(!assignment||typeof assignment.endpoint!=='string'||!assignment.endpoint.startsWith('/')||!Number.isSafeInteger(timeoutMs)||timeoutMs<1||timeoutMs>BROKER_LIMITS.requestMs)return {ok:false,error:'channel_unavailable'};
20
+ const {endpoint,...identity}=assignment;
21
+ const requestId=randomUUID(),body=JSON.stringify({...payload,...identity,requestId})+'\n';
22
+ const terminal=payload.type==='rank_discovery'?JSON.stringify({type:'rank_deadline',...identity,requestId})+'\n':'';
23
+ // Reserve room for the only allowed terminal control within the existing cap.
24
+ if(Buffer.byteLength(body)+Buffer.byteLength(terminal)>BROKER_LIMITS.frameBytes)return {ok:false,error:'request_too_large'};
25
+ return new Promise(resolve=>{
26
+ const socket=createConnection(endpoint);let buffer=Buffer.alloc(0),done=false,connected=false,awaitingDeadline=false;
27
+ let cleanupTimer:ReturnType<typeof setTimeout>|undefined;
28
+ const settle=(result:BrokerReply)=>{if(done)return;done=true;clearTimeout(timer);clearTimeout(cleanupTimer);signal?.removeEventListener('abort',abort);resolve(result);};
29
+ const finish=(result:BrokerReply)=>{if(done)return;settle(result);socket.destroy();};
30
+ const abort=()=>{if(payload.foreground===true||!awaitingDeadline)finish({ok:false,error:'cancelled'});};
31
+ const timer=setTimeout(()=>{
32
+ if(!terminal){finish({ok:false,error:'deadline'});return;}
33
+ if(!connected||socket.destroyed||!socket.writable){finish({ok:false,error:'channel_unavailable'});return;}
34
+ // The local deadline wins over later caller abort, but delivery needs the
35
+ // broker's reply on this request connection after it latches the typed cause.
36
+ awaitingDeadline=true;
37
+ if(payload.foreground===true){
38
+ // Caller deadline includes IPC/ACK cleanup. Latch the cause, then detach locally.
39
+ try{socket.end(terminal);}catch{/* channel is already unavailable */}
40
+ settle({ok:false,error:'deadline'});setTimeout(()=>socket.destroy(),BROKER_LIMITS.partialFrameMs).unref();return;
41
+ }
42
+ cleanupTimer=setTimeout(()=>finish({ok:false,error:'channel_unavailable'}),BROKER_LIMITS.partialFrameMs);
43
+ try{socket.end(terminal);}catch{finish({ok:false,error:'channel_unavailable'});}
44
+ },timeoutMs);
45
+ signal?.addEventListener('abort',abort,{once:true});if(signal?.aborted)abort();
46
+ socket.on('error',()=>finish({ok:false,error:'channel_unavailable'}));socket.on('close',()=>{clearTimeout(cleanupTimer);finish({ok:false,error:'channel_unavailable'});});
47
+ socket.on('end',()=>finish({ok:false,error:'channel_unavailable'}));
48
+ socket.once('connect',()=>{connected=true;if(!done)socket.write(body);});
49
+ socket.on('data',chunk=>{
50
+ if(done)return;
51
+ if(buffer.length+chunk.length>BROKER_LIMITS.responseBytes){finish({ok:false,error:'response_too_large'});return;}
52
+ buffer=Buffer.concat([buffer,typeof chunk==='string'?Buffer.from(chunk):chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
53
+ try{
54
+ if(newline!==buffer.length-1)throw Error();
55
+ const reply=JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(buffer.subarray(0,newline)));
56
+ if(!reply||typeof reply.ok!=='boolean'||reply.ok&&!Object.hasOwn(reply,'result')||!reply.ok&&(typeof reply.error!=='string'||!/^[a-z_]{1,64}$/.test(reply.error)))throw Error();
57
+ if(awaitingDeadline&&(reply.ok||reply.error!=='deadline')){finish({ok:false,error:'channel_unavailable'});return;}
58
+ finish(reply.ok?{ok:true,result:reply.result}:{ok:false,error:reply.error});
59
+ }catch{finish({ok:false,error:'malformed_response'});}
60
+ });
61
+ });
62
+ }
@@ -0,0 +1,128 @@
1
+ import {mkdtempSync,chmodSync,rmSync,realpathSync} from 'node:fs';
2
+ import {tmpdir} from 'node:os';
3
+ import {join,resolve,relative,isAbsolute} from 'node:path';
4
+ import {createServer,type Socket} from 'node:net';
5
+ import {TextDecoder} from 'node:util';
6
+ import {DISCOVERY_DEADLINE,isDiscoveryDeadline,type DiscoveryRuntime} from './runtime.ts';
7
+ import {FOREGROUND_MS} from './semantic-profiles.ts';
8
+ import type {DiscoveryResult} from './results.ts';
9
+ import type {DiscoveryOwners,OwnerLease} from './owners.ts';
10
+ export const BROKER_LIMITS=Object.freeze({frameBytes:65536,responseBytes:65536,connections:16,partialFrameMs:1000,requestMs:20000,maxCandidates:1024});
11
+ export interface RankDiscoveryRequest {type:'rank_discovery';capability:string;sessionId:string;taskId:string;ownerId:string;attemptId:string;queryHash:string;requestId:string;paths:string[];foreground?:boolean;discovery:{complete:boolean;reason?:string}}
12
+ export interface RankDeadlineRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'rank_deadline'}
13
+ const requestIdentity=['capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId'] as const;
14
+ function validRankDeadline(value:any,request:RankDiscoveryRequest):value is RankDeadlineRequest {
15
+ return !!value&&typeof value==='object'&&!Array.isArray(value)&&value.type==='rank_deadline'&&Object.keys(value).length===requestIdentity.length+1&&Object.keys(value).every(k=>k==='type'||requestIdentity.some(field=>field===k))&&requestIdentity.every(k=>value[k]===request[k]);
16
+ }
17
+ export type BrokerReply={ok:true;result:unknown}|{ok:false;error:string};
18
+ export interface DescendantRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'register_descendant';childId:string;task:string;query:string;tools:string[]}
19
+ export interface RevokeDiscoveryRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'revoke_attempt'}
20
+ function validControlRequest(value:any):value is DescendantRequest|RevokeDiscoveryRequest {
21
+ if(!value||typeof value!=='object'||Array.isArray(value)||!['register_descendant','revoke_attempt'].includes(value.type))return false;
22
+ const {type,childId,task,query,tools,...identity}=value;
23
+ if(!validBrokerRequest({...identity,type:'rank_discovery',paths:[],discovery:{complete:true}}))return false;
24
+ if(type==='revoke_attempt')return Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId'].includes(k));
25
+ return Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId','childId','task','query','tools'].includes(k))&&typeof childId==='string'&&childId.length<=128&&typeof task==='string'&&task.length<=16384&&typeof query==='string'&&query.length<=32768&&Array.isArray(tools)&&tools.length<=32&&tools.every(t=>typeof t==='string'&&/^[a-z_]{1,64}$/.test(t))&&new Set(tools).size===tools.length;
26
+ }
27
+ export function validBrokerRequest(value:any):value is RankDiscoveryRequest {
28
+ const record=(v:any)=>v&&typeof v==='object'&&!Array.isArray(v);
29
+ return record(value)&&Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId','paths','discovery','foreground'].includes(k))&&value.type==='rank_discovery'&&(value.foreground===undefined||typeof value.foreground==='boolean')&&typeof value.capability==='string'&&/^[0-9a-f]{64}$/.test(value.capability)&&typeof value.queryHash==='string'&&/^[0-9a-f]{64}$/.test(value.queryHash)&&['sessionId','taskId','ownerId','attemptId','requestId'].every(k=>typeof value[k]==='string'&&/^[A-Za-z0-9._:-]{1,128}$/.test(value[k]))&&Array.isArray(value.paths)&&value.paths.length<=BROKER_LIMITS.maxCandidates&&value.paths.every((p:any)=>typeof p==='string'&&p.length<=1024&&p.length>0&&!/[\\\x00-\x1f\x7f]/.test(p)&&!p.startsWith('/')&&p.split('/').every((s:string)=>s&&s!=='.'&&s!=='..'))&&record(value.discovery)&&Object.keys(value.discovery).every(k=>['complete','reason'].includes(k))&&typeof value.discovery.complete==='boolean'&&(value.discovery.reason===undefined||['candidate_limit','deadline','truncated','unavailable'].includes(value.discovery.reason));
30
+ }
31
+ export async function createDiscoveryBroker(options:{root:string;runtime:DiscoveryRuntime;owners:DiscoveryOwners;publish?(result:DiscoveryResult,lease:OwnerLease):unknown;limits?:Partial<Record<keyof typeof BROKER_LIMITS,number>>}) {
32
+ if(process.platform==='win32')throw Error('unsupported_platform');
33
+ const limits={...BROKER_LIMITS,...options.limits};
34
+ for(const key of Object.keys(BROKER_LIMITS) as (keyof typeof BROKER_LIMITS)[])if(!Number.isSafeInteger(limits[key])||limits[key]<1||limits[key]>BROKER_LIMITS[key])throw Error('invalid_broker_limits');
35
+ // Short private namespace, unrelated to the session's writable artifact roots.
36
+ const directory=mkdtempSync(join(realpathSync(tmpdir()),'d9-'));chmodSync(directory,0o700);const endpoint=join(directory,'s');
37
+ const root=realpathSync(options.root),sockets=new Set<Socket>();let closed=false;
38
+ const server=createServer({allowHalfOpen:true},socket=>{
39
+ if(closed||sockets.size>=limits.connections){socket.destroy();return;}
40
+ sockets.add(socket);const controller=new AbortController();let buffer=Buffer.alloc(0),bytes=0,handled=false,responded=false,terminalReceived=false,rankRequest:RankDiscoveryRequest|undefined;
41
+ const abort=(reason?:unknown)=>controller.abort(reason);let revoke:(()=>void)|undefined,lease:OwnerLease|undefined;
42
+ let timer=setTimeout(()=>{abort();socket.destroy();},limits.partialFrameMs);let requestTimer:ReturnType<typeof setTimeout>|undefined;
43
+ socket.on('error',()=>{});
44
+ socket.once('close',()=>{abort();clearTimeout(timer);clearTimeout(requestTimer);if(revoke)lease?.signal.removeEventListener('abort',revoke);sockets.delete(socket);});
45
+ // A valid request-bound terminal frame latches its cause before FIN/close.
46
+ // Bare FIN remains cancellation; it is never evidence of a deadline.
47
+ socket.once('end',()=>{if(!isDiscoveryDeadline(controller.signal.reason)){abort();socket.destroy();}});
48
+ const reply=(value:BrokerReply)=>{
49
+ if(responded||socket.destroyed)return;responded=true;
50
+ let body=JSON.stringify(value)+'\n';if(Buffer.byteLength(body)>limits.responseBytes)body=JSON.stringify({ok:false,error:'response_too_large'})+'\n';
51
+ socket.end(body,()=>socket.destroy());clearTimeout(requestTimer);
52
+ };
53
+ const rejectFrame=()=>{abort();socket.destroy();};
54
+ const decode=(frame:Buffer):unknown=>JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(frame));
55
+ const terminal=(value:unknown)=>{
56
+ if(!rankRequest||terminalReceived||responded||!validRankDeadline(value,rankRequest)){rejectFrame();return;}
57
+ terminalReceived=true;clearTimeout(timer);
58
+ if(!controller.signal.aborted){abort(DISCOVERY_DEADLINE);reply({ok:false,error:'deadline'});}
59
+ };
60
+ const handle=(request:RankDiscoveryRequest|DescendantRequest|RevokeDiscoveryRequest)=>{
61
+ // Authenticated self-revocation only may clean up an expired advisory lease.
62
+ // It cannot register descendants or collect any sources.
63
+ lease=options.owners.authorize(request,request.type==='rank_discovery',request.type==='revoke_attempt')??undefined;
64
+ if(!lease){reply({ok:false,error:'unauthorized'});return;}
65
+ const owner=lease;
66
+ if(request.type==='revoke_attempt'){options.owners.revoke(owner.capability);reply({ok:true,result:{revoked:true}});return;}
67
+ if(request.type==='register_descendant'){
68
+ let child:OwnerLease|undefined;
69
+ try{
70
+ child=options.owners.registerDescendant(owner,request);
71
+ const response:BrokerReply={ok:true,result:{assignment:options.owners.assignment(child,endpoint),cwd:child.cwd,readRoots:child.readRoots,exportRoots:child.exportRoots,initialPaths:child.initialPaths,discoveryComplete:child.discoveryComplete??true}};
72
+ if(Buffer.byteLength(JSON.stringify(response)+'\n')>limits.responseBytes){options.owners.revoke(child.capability);reply({ok:false,error:'response_too_large'});}
73
+ else reply(response);
74
+ }catch{if(child)options.owners.revoke(child.capability);reply({ok:false,error:'descendant_registration_denied'});}return;
75
+ }
76
+ // Registry supplies query/cwd/effective permissions. Reject unknown/cross-scope identities BEFORE any source collection, including cache hits.
77
+ const paths=[...new Set(request.paths)];
78
+ const foreground=request.foreground===true&&paths.length===1&&options.runtime.semanticEnabled;
79
+ if(request.foreground&&!foreground){reply({ok:false,error:'consumer_off'});return;}
80
+ if(paths.some(p=>!options.owners.allows(owner,p,false))){reply({ok:false,error:'source_denied'});return;}
81
+ const canonical=paths.map(p=>relative(root,resolve(owner.cwd,p)).split('\\').join('/'));
82
+ if(canonical.some(p=>isAbsolute(p)||p==='..'||p.startsWith('../')||!p)){reply({ok:false,error:'source_denied'});return;}
83
+ const fromWorkspace=(p:string)=>relative(owner.cwd,p).split('\\').join('/');
84
+ const permission=()=>JSON.stringify([owner.effectiveTools,owner.readRoots,owner.exportRoots,owner.permissionIdentity(),paths.map(p=>options.owners.allows(owner,p,true))]);
85
+ revoke=()=>{if(!controller.signal.aborted){abort();reply({ok:false,error:'revoked'});}};owner.signal.addEventListener('abort',revoke,{once:true});if(owner.signal.aborted)revoke();
86
+ if(controller.signal.aborted)return;
87
+ rankRequest=request;
88
+ requestTimer=setTimeout(()=>{if(!controller.signal.aborted){abort(DISCOVERY_DEADLINE);reply({ok:false,error:'deadline'});}},foreground?Math.min(FOREGROUND_MS,limits.requestMs):limits.requestMs);
89
+ // A child's immutable bound query survives same-task Hub followups. Authority
90
+ // and permission checks still fence every job before reads and after awaits.
91
+ void options.runtime.rank({owner:owner.ownerId,attempt:owner.attemptId,trigger:'native',foreground,task:owner.task,query:owner.query,context:()=>options.owners.current(owner)?owner.taskId+':'+owner.queryHash:'revoked',paths:canonical,discoveryComplete:request.discovery.complete,signal:controller.signal,permissionIdentity:permission,canDisplay:p=>options.owners.allows(owner,fromWorkspace(p),false),canRead:p=>options.owners.allows(owner,fromWorkspace(p),true)}).then(result=>{
92
+ if(controller.signal.aborted){reply({ok:false,error:isDiscoveryDeadline(controller.signal.reason)?'deadline':'revoked'});return;}
93
+ if(!options.owners.current(owner)){reply({ok:false,error:'revoked'});return;}
94
+ reply({ok:true,result:options.publish?.(result,owner)??result});
95
+ }).catch(()=>reply({ok:false,error:'unavailable'}));
96
+ };
97
+ socket.on('data',chunk=>{
98
+ bytes+=chunk.length;if(bytes>limits.frameBytes){rejectFrame();return;}
99
+ // The combined rank + optional terminal input retains the original byte cap.
100
+ if(handled&&!buffer.length){clearTimeout(timer);timer=setTimeout(rejectFrame,limits.partialFrameMs);}
101
+ buffer=Buffer.concat([buffer,typeof chunk==='string'?Buffer.from(chunk):chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
102
+ let value:unknown;try{value=decode(buffer.subarray(0,newline));}catch{if(handled)rejectFrame();else reply({ok:false,error:'malformed_request'});return;}
103
+ buffer=buffer.subarray(newline+1);
104
+ if(handled){if(buffer.length)rejectFrame();else terminal(value);return;}
105
+ if(!validBrokerRequest(value)&&!validControlRequest(value)){reply({ok:false,error:'unsupported_request'});return;}
106
+ // Validate a coalesced second frame BEFORE dispatching any rank. A second
107
+ // rank, foreign control or duplicate terminal cannot cause source collection.
108
+ const next=buffer.indexOf(10);let control:unknown;
109
+ if(buffer.length&&value.type!=='rank_discovery'){rejectFrame();return;}
110
+ if(next>=0){
111
+ try{control=decode(buffer.subarray(0,next));}catch{rejectFrame();return;}
112
+ if(next!==buffer.length-1||value.type!=='rank_discovery'||!validRankDeadline(control,value)){rejectFrame();return;}
113
+ buffer=Buffer.alloc(0);
114
+ }
115
+ handled=true;clearTimeout(timer);handle(value);
116
+ if(next>=0)terminal(control);
117
+ else if(buffer.length)timer=setTimeout(rejectFrame,limits.partialFrameMs);
118
+ });
119
+ });
120
+ try{await new Promise<void>((resolveListen,reject)=>{server.once('error',reject);server.listen(endpoint,()=>{server.off('error',reject);chmodSync(endpoint,0o600);resolveListen();});});}
121
+ catch(error){server.close();rmSync(directory,{recursive:true,force:true});throw error;}
122
+ return {endpoint,directory,get connections(){return sockets.size;},async close(){
123
+ if(closed)return;closed=true;options.owners.dispose();
124
+ const connections=[...sockets].map(socket=>new Promise<void>(resolveClose=>{socket.once('close',()=>resolveClose());socket.destroy();}));
125
+ await Promise.all([new Promise<void>(resolveClose=>server.close(()=>resolveClose())),...connections]);rmSync(directory,{recursive:true,force:true});
126
+ }};
127
+ }
128
+ export type DiscoveryBroker=Awaited<ReturnType<typeof createDiscoveryBroker>>;