@chankov/agent-fleet 2.0.17 → 2.0.18

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 (662) hide show
  1. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +75 -49
  2. package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +18 -20
  3. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +3 -1
  4. package/.pi/agents/model-profiles.yaml +5 -5
  5. package/.pi/agents/peers.yaml +3 -3
  6. package/.pi/agents/voices.yaml +1 -1
  7. package/.pi/harnesses/agent-hub/README.md +35 -8
  8. package/.pi/harnesses/agent-hub/agentic-sources.ts +29 -5
  9. package/.pi/harnesses/agent-hub/config/overrides.ts +13 -3
  10. package/.pi/harnesses/agent-hub/delegate.ts +16 -5
  11. package/.pi/harnesses/agent-hub/deterministic-fs.ts +7 -4
  12. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +13 -2
  13. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +7 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
  16. package/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  17. package/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  18. package/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  19. package/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  20. package/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  21. package/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  22. package/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  23. package/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  24. package/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  25. package/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  26. package/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  27. package/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  28. package/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  29. package/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  30. package/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  31. package/.pi/harnesses/agent-hub/filesystem-tool.ts +74 -26
  32. package/.pi/harnesses/agent-hub/index.ts +23 -5
  33. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +3 -2
  34. package/.pi/harnesses/agent-hub/no-progress.ts +45 -15
  35. package/.pi/harnesses/agent-hub/package.json +1 -1
  36. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  37. package/.pi/harnesses/agent-hub/proactive-config.ts +8 -3
  38. package/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
  39. package/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
  40. package/.pi/harnesses/agent-hub/proactive-local.ts +25 -7
  41. package/.pi/harnesses/agent-hub/proactive-observer.ts +2 -1
  42. package/.pi/harnesses/agent-hub/proactive-rules.ts +39 -11
  43. package/.pi/harnesses/agent-hub/proactive-runtime.ts +8 -6
  44. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +32 -2
  45. package/.pi/harnesses/agent-hub/proactive-types.ts +5 -1
  46. package/.pi/harnesses/agent-hub/prompts/fragments.ts +21 -49
  47. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +2 -1
  48. package/.pi/harnesses/agent-hub/research/runtime.ts +7 -3
  49. package/.pi/harnesses/agent-hub/research/spawn-run.ts +17 -6
  50. package/.pi/harnesses/agent-hub/spawn.ts +38 -9
  51. package/.pi/harnesses/agent-hub/system1-communication-store.ts +39 -0
  52. package/.pi/harnesses/agent-hub/tools/action-executors.ts +6 -1
  53. package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  54. package/.pi/harnesses/agent-hub/tools/ask-system1.ts +1 -1
  55. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +4 -4
  56. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +4 -2
  57. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +3 -3
  58. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +3 -1
  59. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  60. package/.pi/harnesses/agent-hub/work-mode.ts +3 -0
  61. package/.pi/harnesses/coms/package.json +1 -1
  62. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  63. package/.pi/harnesses/lib/context-budget-child-prompt.ts +3 -2
  64. package/.pi/harnesses/lib/deterministic-handle-path.ts +2 -0
  65. package/.pi/harnesses/lib/policy-roots.ts +142 -0
  66. package/.pi/harnesses/lib/system1/config-agentic.js +2 -1
  67. package/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  68. package/.pi/harnesses/lib/system1/config-proactive.js +13 -2
  69. package/.pi/harnesses/lib/system1/config-v2.js +8 -5
  70. package/.versions/2.0.18/.pi/agent-fleet/hermes/README.md +347 -0
  71. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  72. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  73. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  74. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  75. package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  76. package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  77. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  78. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  79. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  80. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  81. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  82. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  83. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  84. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  85. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  86. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  87. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  88. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  89. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  90. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  91. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  92. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  93. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  94. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  95. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  96. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  97. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  98. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  99. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  100. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  101. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  102. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  103. package/.versions/2.0.18/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  104. package/.versions/2.0.18/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  105. package/.versions/2.0.18/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  106. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  107. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  108. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  109. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  110. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  111. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet.ts +217 -0
  112. package/.versions/2.0.18/.pi/agent-fleet/scripts/flow.ts +157 -0
  113. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  114. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  115. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  116. package/.versions/2.0.18/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  117. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  118. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  119. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  120. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  121. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  122. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  123. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  124. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  125. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  126. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  127. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  128. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  129. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  130. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  131. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  132. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  133. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  134. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  135. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  136. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  137. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  138. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  139. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  140. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  141. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  142. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  143. package/.versions/2.0.18/.pi/agent-fleet/scripts/package-lock.json +35 -0
  144. package/.versions/2.0.18/.pi/agent-fleet/scripts/package.json +9 -0
  145. package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  146. package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  147. package/.versions/2.0.18/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  148. package/.versions/2.0.18/.pi/agent-fleet/scripts/team-up.ts +378 -0
  149. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  150. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  151. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  152. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  153. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  154. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  155. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  156. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  157. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  158. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  159. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  160. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  161. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  162. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  163. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  164. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  165. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  166. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  167. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  168. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  169. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  170. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  171. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  172. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  173. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  174. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  175. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  176. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  177. package/.versions/2.0.18/.pi/agents/dispatch-policy.yaml +32 -0
  178. package/.versions/2.0.18/.pi/agents/model-profiles.yaml +134 -0
  179. package/.versions/2.0.18/.pi/agents/peers.yaml +147 -0
  180. package/.versions/2.0.18/.pi/agents/teams.yaml +41 -0
  181. package/.versions/2.0.18/.pi/agents/voices.yaml +13 -0
  182. package/.versions/2.0.18/.pi/damage-control-rules.yaml +297 -0
  183. package/.versions/2.0.18/.pi/extensions/btw/README.md +120 -0
  184. package/.versions/2.0.18/.pi/extensions/btw/index.ts +914 -0
  185. package/.versions/2.0.18/.pi/extensions/btw/package.json +6 -0
  186. package/.versions/2.0.18/.pi/extensions/btw/state.js +179 -0
  187. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  188. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  189. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  190. package/.versions/2.0.18/.pi/extensions/compact-and-continue/README.md +42 -0
  191. package/.versions/2.0.18/.pi/extensions/compact-and-continue/index.ts +120 -0
  192. package/.versions/2.0.18/.pi/extensions/compact-and-continue/package.json +6 -0
  193. package/.versions/2.0.18/.pi/extensions/mcp-bridge/README.md +46 -0
  194. package/.versions/2.0.18/.pi/extensions/mcp-bridge/index.ts +206 -0
  195. package/.versions/2.0.18/.pi/extensions/mcp-bridge/package.json +6 -0
  196. package/.versions/2.0.18/.pi/extensions/package-lock.json +1175 -0
  197. package/.versions/2.0.18/.pi/extensions/package.json +9 -0
  198. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/README.md +224 -0
  199. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/config.ts +198 -0
  200. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  201. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/index.ts +248 -0
  202. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/package.json +6 -0
  203. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  204. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  205. package/.versions/2.0.18/.pi/harnesses/agent-hub/README.md +1483 -0
  206. package/.versions/2.0.18/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  207. package/.versions/2.0.18/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  208. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  209. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  210. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  211. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  212. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  213. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  214. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  215. package/.versions/2.0.18/.pi/harnesses/agent-hub/artifacts.js +146 -0
  216. package/.versions/2.0.18/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  217. package/.versions/2.0.18/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  218. package/.versions/2.0.18/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  219. package/.versions/2.0.18/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  220. package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  221. package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  222. package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  223. package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  224. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  225. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  226. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  227. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  228. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  229. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  230. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  231. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  232. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  233. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  234. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  235. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  236. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  237. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  238. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  239. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  240. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  241. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  242. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  243. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  244. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  245. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  246. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  247. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  248. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  249. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  250. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  251. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  252. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  253. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  254. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  255. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  256. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  257. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  258. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  259. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  260. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  261. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  262. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  263. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-window.js +108 -0
  264. package/.versions/2.0.18/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  265. package/.versions/2.0.18/.pi/harnesses/agent-hub/delegate.ts +478 -0
  266. package/.versions/2.0.18/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
  267. package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  268. package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  269. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  270. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  271. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  272. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
  273. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
  274. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
  275. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  276. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  277. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  278. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  279. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  280. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  281. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  282. package/.versions/2.0.18/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  283. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  284. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  285. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  286. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  287. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  288. package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  289. package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  290. package/.versions/2.0.18/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  291. package/.versions/2.0.18/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  292. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  293. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  294. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  295. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  296. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  297. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  298. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  299. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  300. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  301. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  302. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
  303. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  304. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  305. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  306. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  307. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  308. package/.versions/2.0.18/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
  309. package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
  310. package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  311. package/.versions/2.0.18/.pi/harnesses/agent-hub/footer.ts +30 -0
  312. package/.versions/2.0.18/.pi/harnesses/agent-hub/helpers.ts +270 -0
  313. package/.versions/2.0.18/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  314. package/.versions/2.0.18/.pi/harnesses/agent-hub/index.ts +2625 -0
  315. package/.versions/2.0.18/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  316. package/.versions/2.0.18/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  317. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  318. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  319. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  320. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  321. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  322. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  323. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  324. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  325. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  326. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  327. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  328. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  329. package/.versions/2.0.18/.pi/harnesses/agent-hub/no-progress.ts +593 -0
  330. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  331. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  332. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  333. package/.versions/2.0.18/.pi/harnesses/agent-hub/package.json +7 -0
  334. package/.versions/2.0.18/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  335. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  336. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  337. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  338. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  339. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
  340. package/.versions/2.0.18/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  341. package/.versions/2.0.18/.pi/harnesses/agent-hub/presentation.ts +48 -0
  342. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  343. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  344. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
  345. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
  346. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  347. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  348. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  349. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  350. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  351. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  352. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  353. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  354. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot.ts +258 -0
  355. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  356. package/.versions/2.0.18/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  357. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
  358. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
  359. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  360. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  361. package/.versions/2.0.18/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  362. package/.versions/2.0.18/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  363. package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  364. package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  365. package/.versions/2.0.18/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  366. package/.versions/2.0.18/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  367. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  368. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
  369. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
  370. package/.versions/2.0.18/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  371. package/.versions/2.0.18/.pi/harnesses/agent-hub/return-contract.js +349 -0
  372. package/.versions/2.0.18/.pi/harnesses/agent-hub/return-extract.js +77 -0
  373. package/.versions/2.0.18/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  374. package/.versions/2.0.18/.pi/harnesses/agent-hub/review-findings.js +104 -0
  375. package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  376. package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  377. package/.versions/2.0.18/.pi/harnesses/agent-hub/run-budget.js +554 -0
  378. package/.versions/2.0.18/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  379. package/.versions/2.0.18/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  380. package/.versions/2.0.18/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  381. package/.versions/2.0.18/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  382. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  383. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-health.js +110 -0
  384. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-start.ts +42 -0
  385. package/.versions/2.0.18/.pi/harnesses/agent-hub/spawn.ts +563 -0
  386. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  387. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
  388. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  389. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  390. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  391. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  392. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  393. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  394. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  395. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  396. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  397. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  398. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  399. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  400. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  401. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  402. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  403. package/.versions/2.0.18/.pi/harnesses/agent-hub/timeline.ts +72 -0
  404. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  405. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  406. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  407. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
  408. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  409. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  410. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  411. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  412. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  413. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
  414. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  415. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  416. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  417. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  418. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  419. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  420. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  421. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  422. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  423. package/.versions/2.0.18/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  424. package/.versions/2.0.18/.pi/harnesses/agent-hub/types.ts +66 -0
  425. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  426. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  427. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  428. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  429. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  430. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  431. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  432. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  433. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  434. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  435. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  436. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  437. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  438. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  439. package/.versions/2.0.18/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  440. package/.versions/2.0.18/.pi/harnesses/agent-hub/version.ts +42 -0
  441. package/.versions/2.0.18/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  442. package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  443. package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode.ts +187 -0
  444. package/.versions/2.0.18/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  445. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/README.md +59 -0
  446. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/index.ts +558 -0
  447. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  448. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  449. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  450. package/.versions/2.0.18/.pi/harnesses/coms/README.md +100 -0
  451. package/.versions/2.0.18/.pi/harnesses/coms/index.ts +282 -0
  452. package/.versions/2.0.18/.pi/harnesses/coms/package.json +7 -0
  453. package/.versions/2.0.18/.pi/harnesses/coms/version.ts +42 -0
  454. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/README.md +135 -0
  455. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/index.ts +533 -0
  456. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/package.json +7 -0
  457. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/version.ts +42 -0
  458. package/.versions/2.0.18/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  459. package/.versions/2.0.18/.pi/harnesses/lib/coms-core-io.ts +385 -0
  460. package/.versions/2.0.18/.pi/harnesses/lib/coms-core.ts +577 -0
  461. package/.versions/2.0.18/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  462. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
  463. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  464. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-view.ts +107 -0
  465. package/.versions/2.0.18/.pi/harnesses/lib/context-budget.ts +114 -0
  466. package/.versions/2.0.18/.pi/harnesses/lib/damage-control-shared.ts +226 -0
  467. package/.versions/2.0.18/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  468. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  469. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  470. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  471. package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  472. package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  473. package/.versions/2.0.18/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  474. package/.versions/2.0.18/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  475. package/.versions/2.0.18/.pi/harnesses/lib/fleet-panel.ts +34 -0
  476. package/.versions/2.0.18/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  477. package/.versions/2.0.18/.pi/harnesses/lib/fleet-selection.ts +24 -0
  478. package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  479. package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  480. package/.versions/2.0.18/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  481. package/.versions/2.0.18/.pi/harnesses/lib/herdr-client.ts +472 -0
  482. package/.versions/2.0.18/.pi/harnesses/lib/herdr-presence.ts +399 -0
  483. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  484. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  485. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  486. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  487. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  488. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  489. package/.versions/2.0.18/.pi/harnesses/lib/policy-roots.ts +142 -0
  490. package/.versions/2.0.18/.pi/harnesses/lib/safe-source-read.js +29 -0
  491. package/.versions/2.0.18/.pi/harnesses/lib/spawned-peers.js +191 -0
  492. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  493. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  494. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-json.js +37 -0
  495. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-loader.js +44 -0
  496. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  497. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-triage.js +42 -0
  498. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-v2.js +106 -0
  499. package/.versions/2.0.18/.pi/harnesses/lib/system1/config.js +50 -0
  500. package/.versions/2.0.18/.pi/harnesses/lib/system1/contracts.ts +154 -0
  501. package/.versions/2.0.18/.pi/harnesses/lib/system1/demo.ts +95 -0
  502. package/.versions/2.0.18/.pi/harnesses/lib/system1/jev.ts +503 -0
  503. package/.versions/2.0.18/.pi/harnesses/lib/system1/selection.js +11 -0
  504. package/.versions/2.0.18/.pi/harnesses/lib/system1/service.ts +245 -0
  505. package/.versions/2.0.18/.pi/harnesses/lib/update-check.ts +222 -0
  506. package/.versions/2.0.18/.pi/harnesses/package-lock.json +2039 -0
  507. package/.versions/2.0.18/.pi/harnesses/package.json +10 -0
  508. package/.versions/2.0.18/.pi/prompts/af-build.md +27 -0
  509. package/.versions/2.0.18/.pi/prompts/af-code-simplify.md +22 -0
  510. package/.versions/2.0.18/.pi/prompts/af-constraints.md +31 -0
  511. package/.versions/2.0.18/.pi/prompts/af-plan.md +17 -0
  512. package/.versions/2.0.18/.pi/prompts/af-review.md +16 -0
  513. package/.versions/2.0.18/.pi/prompts/af-set-hermes-telegram.md +15 -0
  514. package/.versions/2.0.18/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  515. package/.versions/2.0.18/.pi/prompts/af-setup-rules.md +20 -0
  516. package/.versions/2.0.18/.pi/prompts/af-ship.md +17 -0
  517. package/.versions/2.0.18/.pi/prompts/af-spec.md +15 -0
  518. package/.versions/2.0.18/.pi/prompts/af-test.md +19 -0
  519. package/.versions/2.0.18/.pi/skills/bowser/SKILL.md +145 -0
  520. package/.versions/2.0.18/.version +1 -0
  521. package/.versions/2.0.18/agents/architect.md +24 -0
  522. package/.versions/2.0.18/agents/bowser.md +28 -0
  523. package/.versions/2.0.18/agents/builder.md +55 -0
  524. package/.versions/2.0.18/agents/code-reviewer.md +209 -0
  525. package/.versions/2.0.18/agents/deep-researcher.md +32 -0
  526. package/.versions/2.0.18/agents/documenter.md +22 -0
  527. package/.versions/2.0.18/agents/orchestrator.md +22 -0
  528. package/.versions/2.0.18/agents/plan-reviewer.md +83 -0
  529. package/.versions/2.0.18/agents/planner.md +105 -0
  530. package/.versions/2.0.18/agents/releaser.md +24 -0
  531. package/.versions/2.0.18/agents/researcher.md +30 -0
  532. package/.versions/2.0.18/agents/security-auditor.md +167 -0
  533. package/.versions/2.0.18/agents/test-engineer.md +153 -0
  534. package/.versions/2.0.18/agents/web-debugger.md +44 -0
  535. package/.versions/2.0.18/agents/web-performance-auditor.md +194 -0
  536. package/.versions/2.0.18/bin/catalog/harness-runtime-closure.json +73 -0
  537. package/.versions/2.0.18/codex/fleet-session-client/SKILL.md +34 -0
  538. package/.versions/2.0.18/codex/fleet-session-client.zip +0 -0
  539. package/.versions/2.0.18/docs/ARCHITECTURE.md +874 -0
  540. package/.versions/2.0.18/docs/agent-fleet-setup.md +1101 -0
  541. package/.versions/2.0.18/docs/claude-code-coms-bridge.md +147 -0
  542. package/.versions/2.0.18/docs/codex-session-bridge.md +219 -0
  543. package/.versions/2.0.18/docs/coms-hermes-bridge.md +188 -0
  544. package/.versions/2.0.18/docs/getting-started.md +126 -0
  545. package/.versions/2.0.18/docs/npm-install.md +535 -0
  546. package/.versions/2.0.18/docs/pi-extensions.md +454 -0
  547. package/.versions/2.0.18/docs/pi-setup.md +92 -0
  548. package/.versions/2.0.18/docs/skill-anatomy.md +150 -0
  549. package/.versions/2.0.18/install-manifest.json +3193 -0
  550. package/.versions/2.0.18/justfile +247 -0
  551. package/.versions/2.0.18/manifest-meta.json +1071 -0
  552. package/.versions/2.0.18/references/accessibility-checklist.md +160 -0
  553. package/.versions/2.0.18/references/communication-contract.md +26 -0
  554. package/.versions/2.0.18/references/definition-of-done.md +67 -0
  555. package/.versions/2.0.18/references/fleet-coordination-patterns.md +171 -0
  556. package/.versions/2.0.18/references/observability-checklist.md +92 -0
  557. package/.versions/2.0.18/references/orchestration-patterns.md +370 -0
  558. package/.versions/2.0.18/references/performance-checklist.md +236 -0
  559. package/.versions/2.0.18/references/prompting-patterns.md +380 -0
  560. package/.versions/2.0.18/references/security-checklist.md +245 -0
  561. package/.versions/2.0.18/references/testing-patterns.md +235 -0
  562. package/.versions/2.0.18/references/workflow-authoring.md +304 -0
  563. package/.versions/2.0.18/skills/_internal/grilling.md +59 -0
  564. package/.versions/2.0.18/skills/browser-testing-with-devtools/SKILL.md +351 -0
  565. package/.versions/2.0.18/skills/code-review-and-quality/SKILL.md +396 -0
  566. package/.versions/2.0.18/skills/compound-learning/SKILL.md +137 -0
  567. package/.versions/2.0.18/skills/constraint-driven-development/SKILL.md +338 -0
  568. package/.versions/2.0.18/skills/constraint-driven-development/references/floor-guard.md +99 -0
  569. package/.versions/2.0.18/skills/context-engineering/SKILL.md +341 -0
  570. package/.versions/2.0.18/skills/deprecation-and-migration/SKILL.md +247 -0
  571. package/.versions/2.0.18/skills/designing-agents/SKILL.md +394 -0
  572. package/.versions/2.0.18/skills/designing-agents/pi-harness-authoring.md +222 -0
  573. package/.versions/2.0.18/skills/drafting-workflows/SKILL.md +143 -0
  574. package/.versions/2.0.18/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  575. package/.versions/2.0.18/skills/frontend-ui-engineering/SKILL.md +328 -0
  576. package/.versions/2.0.18/skills/git-workflow-and-versioning/SKILL.md +316 -0
  577. package/.versions/2.0.18/skills/idea-refine/SKILL.md +182 -0
  578. package/.versions/2.0.18/skills/idea-refine/examples.md +238 -0
  579. package/.versions/2.0.18/skills/idea-refine/frameworks.md +99 -0
  580. package/.versions/2.0.18/skills/idea-refine/refinement-criteria.md +113 -0
  581. package/.versions/2.0.18/skills/idea-refine/scripts/idea-refine.sh +15 -0
  582. package/.versions/2.0.18/skills/incremental-implementation/SKILL.md +353 -0
  583. package/.versions/2.0.18/skills/interview-me/SKILL.md +226 -0
  584. package/.versions/2.0.18/skills/orchestration-verification/SKILL.md +182 -0
  585. package/.versions/2.0.18/skills/peer-coms/SKILL.md +90 -0
  586. package/.versions/2.0.18/skills/performance-optimization/SKILL.md +496 -0
  587. package/.versions/2.0.18/skills/planning-and-task-breakdown/SKILL.md +318 -0
  588. package/.versions/2.0.18/skills/repository-ai-setup/SKILL.md +135 -0
  589. package/.versions/2.0.18/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  590. package/.versions/2.0.18/skills/repository-ai-setup/references/apply-contract.md +74 -0
  591. package/.versions/2.0.18/skills/repository-ai-setup/references/provenance-template.md +16 -0
  592. package/.versions/2.0.18/skills/repository-ai-setup/references/setup-flow.md +108 -0
  593. package/.versions/2.0.18/skills/repository-ai-setup/references/verify-setup.md +20 -0
  594. package/.versions/2.0.18/skills/repository-ai-setup.zip +0 -0
  595. package/.versions/2.0.18/skills/security-and-hardening/SKILL.md +524 -0
  596. package/.versions/2.0.18/skills/spec-driven-development/SKILL.md +295 -0
  597. package/.versions/2.0.18/skills/using-agent-skills/SKILL.md +198 -0
  598. package/.versions/2.0.18/vendor/agent-skills-upstream/LICENSE +21 -0
  599. package/.versions/2.0.18/vendor/agent-skills-upstream/README.md +430 -0
  600. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  601. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  602. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  603. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  604. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  605. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  606. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  607. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  608. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  609. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  610. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  611. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  612. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  613. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  614. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  615. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  616. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  617. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  618. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  619. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  620. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  621. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  622. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  623. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  624. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  625. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  626. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  627. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  628. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  629. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  630. package/CHANGELOG.md +6 -0
  631. package/README.md +2 -2
  632. package/agents/architect.md +2 -2
  633. package/agents/bowser.md +1 -1
  634. package/agents/builder.md +5 -5
  635. package/agents/code-reviewer.md +2 -2
  636. package/agents/deep-researcher.md +2 -2
  637. package/agents/documenter.md +3 -3
  638. package/agents/orchestrator.md +2 -2
  639. package/agents/plan-reviewer.md +2 -2
  640. package/agents/planner.md +4 -4
  641. package/agents/releaser.md +2 -2
  642. package/agents/researcher.md +2 -2
  643. package/agents/security-auditor.md +2 -2
  644. package/agents/test-engineer.md +4 -4
  645. package/agents/web-debugger.md +2 -2
  646. package/agents/web-performance-auditor.md +2 -2
  647. package/bin/cli.js +2 -2
  648. package/bin/lib/external-content.js +33 -0
  649. package/bin/lib/project-provenance.js +19 -13
  650. package/bin/lib/transaction.js +32 -1
  651. package/docs/ARCHITECTURE.md +42 -2
  652. package/docs/agent-fleet-setup.md +4 -4
  653. package/docs/claude-code-coms-bridge.md +17 -4
  654. package/docs/external-project-ai-content.md +48 -0
  655. package/docs/npm-install.md +5 -0
  656. package/docs/system1-agentic.md +27 -0
  657. package/docs/system1-config.md +23 -1
  658. package/docs/system1-file-discovery.md +220 -0
  659. package/install-manifest.json +1 -1
  660. package/package.json +15 -6
  661. package/skills/repository-ai-setup/SKILL.md +18 -0
  662. package/skills/repository-ai-setup.zip +0 -0
@@ -1,3 +1,4 @@
1
+ import {appendDiscoveryContext} from './file-discovery/native-context.ts';
1
2
  import { fileURLToPath } from "node:url";
2
3
  import { isCaptureEnabled } from "./proactive-config.ts";
3
4
  import type { ProactiveConfig } from "./proactive-types.ts";
@@ -25,6 +26,7 @@ export function sessionObserverAssignment(config: ProactiveConfig | null | undef
25
26
 
26
27
  export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: boolean, requestedContract?: Omit<TaskResumeInput, "previous">): Promise<PreparedNativeRun | NativeDispatchResult> {
27
28
  const { deps, state, ctx, task, inputArtifacts, scopeGlobs, personaKey, agentKey, runNumber } = base;
29
+ const admittedTools=state.def.tools;
28
30
  const model = deps.resolvedModel(state.def)
29
31
  ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
30
32
  const fallbackCandidate = profileFallback(deps.substitutedModel(fallbackModelFor(state.def, model)));
@@ -113,7 +115,7 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
113
115
  const root = ctx.cwd || process.cwd();
114
116
  const directory = safePathWithin(base.evidenceDir, "proactive-turns");
115
117
  const context = deps.getProactiveCapture?.()?.nativeContext(base.sessionDir, agentKey, base.dispatchId, task);
116
- if (context) proactiveAssignment = sessionObserverAssignment(config, personaKey, { root, directory, session: base.sessionDir, owner: agentKey, attempt: base.dispatchId, context });
118
+ if (context) proactiveAssignment = sessionObserverAssignment(config, personaKey, { root, directory, session: base.sessionDir, owner: agentKey, attempt: base.dispatchId, context, policyRoots:deps.getPolicyRoots?.() });
117
119
  if (proactiveAssignment) extensions.push(fileURLToPath(new URL("./proactive-observer.ts", import.meta.url)));
118
120
  }
119
121
  const assist = base.assistSnapshot;
@@ -182,7 +184,7 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
182
184
  + (stageConfirmation ? "\n\nActive exact-action confirmation: this stage run has inspection tools only. Return the full plan/review in your final response; the Hub saves that response as the stage artifact. Do not use bash, write, edit, delegate or remote execution. No stage result authorizes a later effect." : "");
183
185
  const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
184
186
  const wantThinking = thinkingLevel !== "off";
185
- const runPrompt = deps.appendDeclaredScope(deps.appendInputArtifacts(task, inputArtifacts), scopeGlobs);
187
+ let runPrompt = deps.appendDeclaredScope(deps.appendInputArtifacts(task, inputArtifacts), scopeGlobs);
186
188
  let writeIsolation: WriteIsolationRequest | undefined;
187
189
  let writeIsolationPolicy;
188
190
  if (assist['write-isolation']) {
@@ -206,6 +208,14 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
206
208
  }
207
209
  if (base.activeProfileSnapshot) delegateEnv = { ...delegateEnv, [PROFILE_ENV]: JSON.stringify(base.activeProfileSnapshot) };
208
210
 
211
+ const admitted=()=>state.def.tools===admittedTools&&!state.killedByOperator&&!state.restarting&&deps.getAgentState(base.key)===state&&state.dispatchId===base.dispatchId&&deps.getSessionDir()===base.sessionDir&&base.launchIdentity===deps.launchIdentity?.()&&deps.nativeAdmission?.(personaKey)!==false;
212
+ const admissionRefused=async()=>({...await base.finishRun('Native admission cancelled or changed during discovery preparation; no child started.',143),lifecycle:{launched:false,closeSeen:false}});
213
+ if(!admitted())return admissionRefused();
214
+ const discoveryContext=await deps.prepareDiscovery?.({ownerId:base.dispatchId,task:requestedContract?.instructions??task,query:JSON.stringify([requestedContract?.instructions??task,scopeGlobs]),scope:scopeGlobs,tools:effectiveTools.split(',').map(t=>t.trim()),cwd:ctx.cwd||process.cwd()});
215
+ if(!admitted()||discoveryContext?.current()===false)return admissionRefused();
216
+ runPrompt=appendDiscoveryContext(runPrompt,discoveryContext);
217
+ const discoveryAdmitted=()=>admitted()&&discoveryContext?.current()!==false;
218
+
209
219
  if (state.sessionFile && !sessionRecycled) {
210
220
  const overflow = shouldRecycleBeforeSpawn({
211
221
  priorTokens: state.contextTokens,
@@ -231,6 +241,7 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
231
241
 
232
242
  return {
233
243
  ...base,
244
+ discoveryContext,discoveryAdmitted,
234
245
  model,
235
246
  originalModelFallback,
236
247
  agentWindow,
@@ -156,6 +156,7 @@ export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeS
156
156
  }
157
157
  state.driftFence = drift.fence;
158
158
  const spawnOptions: SpawnPiAgentOptions = {
159
+ discoveryRegistration:run.discoveryContext?.registration?{...run.discoveryContext.registration,admit:run.discoveryAdmitted}:undefined,
159
160
  runtimeTestObserver: extensions.some(path => path.endsWith("/runtime-test-check.ts")),
160
161
  model,
161
162
  activeProfileSnapshot: run.activeProfileSnapshot,
@@ -183,6 +184,7 @@ export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeS
183
184
  let sessionReset = run.sessionReset;
184
185
  try {
185
186
  const res = await deps.providerSemaphore.run(model, async () => {
187
+ if(run.discoveryAdmitted?.()===false)return {output:'Native admission changed while queued; no child started.',stderr:'',exitCode:143,modelUsed:model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}};
186
188
  let result = await deps.spawnPiAgentWithModelFallback(spawnOptions, originalModelFallback, callbacks);
187
189
  if (!result.spawnError && isCorruptSessionExit({ code: result.exitCode, output: result.output, stderr: result.stderr })) {
188
190
  const quarantine = forceQuarantineSession(agentSessionFile, deps.getSessionHealthIo());
@@ -127,6 +127,9 @@ export interface NativeProviderSemaphore {
127
127
  }
128
128
 
129
129
  export interface NativeDispatchDeps {
130
+ prepareDiscovery?:import('./file-discovery/native-context.ts').PrepareNativeDiscovery;
131
+ launchIdentity?():unknown;
132
+ nativeAdmission?(personaKey:string):boolean;
130
133
  getAgentState(key: string): NativeDispatchState | undefined;
131
134
  getProcessState?(): import("./process-obligations.ts").ProcessObligationState;
132
135
  listAgentStates(): NativeDispatchState[];
@@ -159,6 +162,7 @@ export interface NativeDispatchDeps {
159
162
  getProactiveRuntime?(): ReturnType<typeof import("./proactive-runtime.ts").createProactiveRuntime> | null;
160
163
  getProactiveConfig?(): ProactiveConfig | null;
161
164
  getProactiveCapture?(): ReturnType<typeof import("./proactive-runtime.ts").createHubCapture> | null;
165
+ getPolicyRoots?(): import("../lib/policy-roots.ts").PolicyRootTable | undefined;
162
166
  getWorkMode(): any;
163
167
  providerSemaphore: NativeProviderSemaphore;
164
168
  executionHistory: Pick<ExecutionHistoryStore, "start" | "end">;
@@ -202,6 +206,7 @@ export interface NativeDispatchDeps {
202
206
 
203
207
  export interface NativeRunBase {
204
208
  readonly sessionDir: string;
209
+ readonly launchIdentity?:unknown;
205
210
  readonly evidenceDir: string;
206
211
  readonly dispatchId: string;
207
212
  readonly transcriptPath: string;
@@ -226,6 +231,8 @@ export interface NativeRunBase {
226
231
  }
227
232
 
228
233
  export interface PreparedNativeRun extends NativeRunBase {
234
+ discoveryContext?:import('./file-discovery/native-context.ts').NativeDiscoveryContext|null;
235
+ discoveryAdmitted?():boolean;
229
236
  model: string;
230
237
  originalModelFallback?: string;
231
238
  agentWindow: { window: number; source: string };
@@ -119,7 +119,7 @@ function beginNativeRun(deps: NativeDispatchDeps, state: NativeDispatchState, ar
119
119
  };
120
120
 
121
121
  return {
122
- dispatchId, transcriptPath, sessionDir, evidenceDir, deps, state, ctx, task, inputArtifacts, scopeGlobs, watchdogParam,
122
+ dispatchId, transcriptPath, sessionDir, evidenceDir, deps, state, ctx, task, inputArtifacts, scopeGlobs, watchdogParam, launchIdentity:deps.launchIdentity?.(),
123
123
  key: normalizeAgentInput(args.agentName),
124
124
  personaKey: state.def.name.toLowerCase(),
125
125
  agentKey, runNumber, histEntry, monitorKey, monitorStart, startTime,
@@ -0,0 +1,82 @@
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='0.84.2';
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(!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
+ if(args.operation!=='inventory')return refused('unsupported_operation');
34
+ const value=result?.details?.result;
35
+ if(!value||value.root!==search||!Array.isArray(value.entries)||typeof value.truncated!=='boolean'||!Number.isSafeInteger(value.totalEntries))return refused('unknown_shape');
36
+ complete=!value.truncated;
37
+ for(const entry of value.entries){
38
+ 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');
39
+ if(entry.type==='file'&&!entry.denied)add(entry.path);
40
+ }
41
+ }else{
42
+ if(!Array.isArray(result?.content)||result.content.length!==1||result.content[0].type!=='text'||typeof result.content[0].text!=='string')return refused('unknown_shape');
43
+ const details=result.details??{};
44
+ const allowed=tool==='find'?['resultLimitReached','truncation']:tool==='ls'?['entryLimitReached','truncation']:['matchLimitReached','truncation','linesTruncated'];
45
+ if(Object.keys(details).some(k=>!allowed.includes(k)))return refused('unknown_shape');
46
+ const limitKey=allowed[0],limit=details[limitKey],truncated=details.truncation?.truncated===true;
47
+ if(limit!==undefined&&(!Number.isSafeInteger(limit)||limit<=0)||details.truncation&&typeof details.truncation.truncated!=='boolean')return refused('unknown_shape');
48
+ complete=!limit&&!truncated;
49
+ let text:string=result.content[0].text;
50
+ const notices:string[]=[];
51
+ 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`);
52
+ if(truncated)notices.push('50.0KB limit reached');
53
+ if(tool==='grep'&&details.linesTruncated)notices.push('Some lines truncated to 500 chars. Use read tool to see full lines');
54
+ if(notices.length){const suffix=`\n\n[${notices.join('. ')}]`;if(!text.endsWith(suffix))return refused('unknown_shape');text=text.slice(0,-suffix.length);}
55
+ const empty=tool==='find'?'No files found matching pattern':tool==='ls'?'(empty directory)':'No matches found';
56
+ if(text===empty){
57
+ if(tool!=='grep'){try{lstatSync(resolve(search,empty));return refused('ambiguous_filename');}catch{}}
58
+ return {paths:[],discoveryComplete:complete,remaining:complete?0:'unknown'};
59
+ }
60
+ const lines=text.split('\n'); // Pinned Pi truncateHead retains only complete lines.
61
+ for(const line of lines){
62
+ if(!line||/[\x00-\x1f\x7f]/.test(line))return refused('ambiguous_filename');
63
+ let name=line;
64
+ if(tool==='grep'){
65
+ const match=/^([^:]+):(\d+): /.exec(line),context=/^([^:]+?)-(\d+)- /.exec(line);
66
+ if(match&&context)return refused('ambiguous_filename');
67
+ if(!match&&!context)return refused('unknown_shape');
68
+ name=(match??context)![1];
69
+ if(!Number.isSafeInteger(Number((match??context)![2]))||Number((match??context)![2])<1)return refused('unknown_shape');
70
+ if(name.includes(':'))return refused('ambiguous_filename');
71
+ }
72
+ if(isAbsolute(name)||name.includes('\\')||name.trim()!==name||name.replace(/\/$/,'').split('/').some(p=>p==='.'||p==='..'||!p))return refused('ambiguous_filename');
73
+ if(name.endsWith('/')){if(tool==='grep')return refused('unknown_shape');continue;}
74
+ let isFile=false;try{isFile=tool==='grep'&&lstatSync(search).isFile();}catch{return refused('invalid_search_root');}
75
+ const full=isFile?search:resolve(search,name);
76
+ if(isFile&&basename(search)!==name)return refused('unknown_shape');
77
+ try{checkedSourcePath(root,full);if(!unambiguous(full,tool==='grep'))return refused('ambiguous_filename');}catch{complete=false;continue;}
78
+ add(full);
79
+ }
80
+ }
81
+ return {paths:[...new Set(candidates)].sort(),discoveryComplete:complete,remaining:complete?0:'unknown',excluded};
82
+ }
@@ -0,0 +1,56 @@
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 {BROKER_LIMITS,type BrokerReply} from './broker.ts';
6
+ export function rankDiscovery(assignment:DiscoveryAssignment,input:{paths:readonly string[];discovery:{complete:boolean;reason?:string}},signal?:AbortSignal,timeoutMs:number=BROKER_LIMITS.requestMs):Promise<BrokerReply> {
7
+ return discoveryRequest(assignment,{type:'rank_discovery',paths:input.paths,discovery:input.discovery},signal,timeoutMs);
8
+ }
9
+ export function registerDescendant(assignment:DiscoveryAssignment,input:{childId:string;task:string;query:string;tools:readonly string[]},signal?:AbortSignal):Promise<BrokerReply> {
10
+ return discoveryRequest(assignment,{type:'register_descendant',...input},signal);
11
+ }
12
+ export function revokeDiscoveryAttempt(assignment:DiscoveryAssignment):Promise<BrokerReply> {
13
+ return discoveryRequest(assignment,{type:'revoke_attempt'},undefined,1000);
14
+ }
15
+ async function discoveryRequest(assignment:DiscoveryAssignment,payload:Record<string,unknown>,signal?:AbortSignal,timeoutMs:number=BROKER_LIMITS.requestMs):Promise<BrokerReply> {
16
+ if(signal?.aborted)return {ok:false,error:'cancelled'};
17
+ if(process.platform==='win32')return {ok:false,error:'unsupported_platform'};
18
+ if(!assignment||typeof assignment.endpoint!=='string'||!assignment.endpoint.startsWith('/')||!Number.isSafeInteger(timeoutMs)||timeoutMs<1||timeoutMs>BROKER_LIMITS.requestMs)return {ok:false,error:'channel_unavailable'};
19
+ const {endpoint,...identity}=assignment;
20
+ const requestId=randomUUID(),body=JSON.stringify({...payload,...identity,requestId})+'\n';
21
+ const terminal=payload.type==='rank_discovery'?JSON.stringify({type:'rank_deadline',...identity,requestId})+'\n':'';
22
+ // Reserve room for the only allowed terminal control within the existing cap.
23
+ if(Buffer.byteLength(body)+Buffer.byteLength(terminal)>BROKER_LIMITS.frameBytes)return {ok:false,error:'request_too_large'};
24
+ return new Promise(resolve=>{
25
+ const socket=createConnection(endpoint);let buffer=Buffer.alloc(0),done=false,connected=false,awaitingDeadline=false;
26
+ let cleanupTimer:ReturnType<typeof setTimeout>|undefined;
27
+ const settle=(result:BrokerReply)=>{if(done)return;done=true;clearTimeout(timer);clearTimeout(cleanupTimer);signal?.removeEventListener('abort',abort);resolve(result);};
28
+ const finish=(result:BrokerReply)=>{if(done)return;settle(result);socket.destroy();};
29
+ const abort=()=>{if(!awaitingDeadline)finish({ok:false,error:'cancelled'});};
30
+ const timer=setTimeout(()=>{
31
+ if(!terminal){finish({ok:false,error:'deadline'});return;}
32
+ if(!connected||socket.destroyed||!socket.writable){finish({ok:false,error:'channel_unavailable'});return;}
33
+ // The local deadline wins over later caller abort, but delivery needs the
34
+ // broker's reply on this request connection after it latches the typed cause.
35
+ awaitingDeadline=true;
36
+ cleanupTimer=setTimeout(()=>finish({ok:false,error:'channel_unavailable'}),BROKER_LIMITS.partialFrameMs);
37
+ try{socket.end(terminal);}catch{finish({ok:false,error:'channel_unavailable'});}
38
+ },timeoutMs);
39
+ signal?.addEventListener('abort',abort,{once:true});if(signal?.aborted)abort();
40
+ socket.on('error',()=>finish({ok:false,error:'channel_unavailable'}));socket.on('close',()=>{clearTimeout(cleanupTimer);finish({ok:false,error:'channel_unavailable'});});
41
+ socket.on('end',()=>finish({ok:false,error:'channel_unavailable'}));
42
+ socket.once('connect',()=>{connected=true;if(!done)socket.write(body);});
43
+ socket.on('data',chunk=>{
44
+ if(done)return;
45
+ if(buffer.length+chunk.length>BROKER_LIMITS.responseBytes){finish({ok:false,error:'response_too_large'});return;}
46
+ buffer=Buffer.concat([buffer,chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
47
+ try{
48
+ if(newline!==buffer.length-1)throw Error();
49
+ const reply=JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(buffer.subarray(0,newline)));
50
+ 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();
51
+ if(awaitingDeadline&&(reply.ok||reply.error!=='deadline')){finish({ok:false,error:'channel_unavailable'});return;}
52
+ finish(reply.ok?{ok:true,result:reply.result}:{ok:false,error:reply.error});
53
+ }catch{finish({ok:false,error:'malformed_response'});}
54
+ });
55
+ });
56
+ }
@@ -0,0 +1,125 @@
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 type {DiscoveryResult} from './results.ts';
8
+ import type {DiscoveryOwners,OwnerLease} from './owners.ts';
9
+ export const BROKER_LIMITS=Object.freeze({frameBytes:65536,responseBytes:65536,connections:16,partialFrameMs:1000,requestMs:20000,maxCandidates:1024});
10
+ export interface RankDiscoveryRequest {type:'rank_discovery';capability:string;sessionId:string;taskId:string;ownerId:string;attemptId:string;queryHash:string;requestId:string;paths:string[];discovery:{complete:boolean;reason?:string}}
11
+ export interface RankDeadlineRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'rank_deadline'}
12
+ const requestIdentity=['capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId'] as const;
13
+ function validRankDeadline(value:any,request:RankDiscoveryRequest):value is RankDeadlineRequest {
14
+ 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]);
15
+ }
16
+ export type BrokerReply={ok:true;result:unknown}|{ok:false;error:string};
17
+ export interface DescendantRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'register_descendant';childId:string;task:string;query:string;tools:string[]}
18
+ export interface RevokeDiscoveryRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'revoke_attempt'}
19
+ function validControlRequest(value:any):value is DescendantRequest|RevokeDiscoveryRequest {
20
+ if(!value||typeof value!=='object'||Array.isArray(value)||!['register_descendant','revoke_attempt'].includes(value.type))return false;
21
+ const {type,childId,task,query,tools,...identity}=value;
22
+ if(!validBrokerRequest({...identity,type:'rank_discovery',paths:[],discovery:{complete:true}}))return false;
23
+ if(type==='revoke_attempt')return Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId'].includes(k));
24
+ 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;
25
+ }
26
+ export function validBrokerRequest(value:any):value is RankDiscoveryRequest {
27
+ const record=(v:any)=>v&&typeof v==='object'&&!Array.isArray(v);
28
+ return record(value)&&Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId','paths','discovery'].includes(k))&&value.type==='rank_discovery'&&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));
29
+ }
30
+ 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>>}) {
31
+ if(process.platform==='win32')throw Error('unsupported_platform');
32
+ const limits={...BROKER_LIMITS,...options.limits};
33
+ 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');
34
+ // Short private namespace, unrelated to the session's writable artifact roots.
35
+ const directory=mkdtempSync(join(realpathSync(tmpdir()),'d9-'));chmodSync(directory,0o700);const endpoint=join(directory,'s');
36
+ const root=realpathSync(options.root),sockets=new Set<Socket>();let closed=false;
37
+ const server=createServer({allowHalfOpen:true},socket=>{
38
+ if(closed||sockets.size>=limits.connections){socket.destroy();return;}
39
+ sockets.add(socket);const controller=new AbortController();let buffer=Buffer.alloc(0),bytes=0,handled=false,responded=false,terminalReceived=false,rankRequest:RankDiscoveryRequest|undefined;
40
+ const abort=(reason?:unknown)=>controller.abort(reason);let revoke:(()=>void)|undefined,lease:OwnerLease|undefined;
41
+ let timer=setTimeout(()=>{abort();socket.destroy();},limits.partialFrameMs);let requestTimer:ReturnType<typeof setTimeout>|undefined;
42
+ socket.on('error',()=>{});
43
+ socket.once('close',()=>{abort();clearTimeout(timer);clearTimeout(requestTimer);if(revoke)lease?.signal.removeEventListener('abort',revoke);sockets.delete(socket);});
44
+ // A valid request-bound terminal frame latches its cause before FIN/close.
45
+ // Bare FIN remains cancellation; it is never evidence of a deadline.
46
+ socket.once('end',()=>{if(!isDiscoveryDeadline(controller.signal.reason)){abort();socket.destroy();}});
47
+ const reply=(value:BrokerReply)=>{
48
+ if(responded||socket.destroyed)return;responded=true;
49
+ let body=JSON.stringify(value)+'\n';if(Buffer.byteLength(body)>limits.responseBytes)body=JSON.stringify({ok:false,error:'response_too_large'})+'\n';
50
+ socket.end(body,()=>socket.destroy());clearTimeout(requestTimer);
51
+ };
52
+ const rejectFrame=()=>{abort();socket.destroy();};
53
+ const decode=(frame:Buffer):unknown=>JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(frame));
54
+ const terminal=(value:unknown)=>{
55
+ if(!rankRequest||terminalReceived||responded||!validRankDeadline(value,rankRequest)){rejectFrame();return;}
56
+ terminalReceived=true;clearTimeout(timer);
57
+ if(!controller.signal.aborted){abort(DISCOVERY_DEADLINE);reply({ok:false,error:'deadline'});}
58
+ };
59
+ const handle=(request:RankDiscoveryRequest|DescendantRequest|RevokeDiscoveryRequest)=>{
60
+ // Authenticated self-revocation only may clean up an expired advisory lease.
61
+ // It cannot register descendants or collect any sources.
62
+ lease=options.owners.authorize(request,request.type==='rank_discovery',request.type==='revoke_attempt')??undefined;
63
+ if(!lease){reply({ok:false,error:'unauthorized'});return;}
64
+ const owner=lease;
65
+ if(request.type==='revoke_attempt'){options.owners.revoke(owner.capability);reply({ok:true,result:{revoked:true}});return;}
66
+ if(request.type==='register_descendant'){
67
+ let child:OwnerLease|undefined;
68
+ try{
69
+ child=options.owners.registerDescendant(owner,request);
70
+ 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}};
71
+ if(Buffer.byteLength(JSON.stringify(response)+'\n')>limits.responseBytes){options.owners.revoke(child.capability);reply({ok:false,error:'response_too_large'});}
72
+ else reply(response);
73
+ }catch{if(child)options.owners.revoke(child.capability);reply({ok:false,error:'descendant_registration_denied'});}return;
74
+ }
75
+ // Registry supplies query/cwd/effective permissions. Reject unknown/cross-scope identities BEFORE any source collection, including cache hits.
76
+ const paths=[...new Set(request.paths)];
77
+ if(paths.some(p=>!options.owners.allows(owner,p,false))){reply({ok:false,error:'source_denied'});return;}
78
+ const canonical=paths.map(p=>relative(root,resolve(owner.cwd,p)).split('\\').join('/'));
79
+ if(canonical.some(p=>isAbsolute(p)||p==='..'||p.startsWith('../')||!p)){reply({ok:false,error:'source_denied'});return;}
80
+ const fromWorkspace=(p:string)=>relative(owner.cwd,p).split('\\').join('/');
81
+ const permission=()=>JSON.stringify([owner.effectiveTools,owner.readRoots,owner.exportRoots,owner.permissionIdentity(),paths.map(p=>options.owners.allows(owner,p,true))]);
82
+ revoke=()=>{if(!controller.signal.aborted){abort();reply({ok:false,error:'revoked'});}};owner.signal.addEventListener('abort',revoke,{once:true});if(owner.signal.aborted)revoke();
83
+ if(controller.signal.aborted)return;
84
+ rankRequest=request;
85
+ requestTimer=setTimeout(()=>{if(!controller.signal.aborted){abort(DISCOVERY_DEADLINE);reply({ok:false,error:'deadline'});}},limits.requestMs);
86
+ // A child's immutable bound query survives same-task Hub followups. Authority
87
+ // and permission checks still fence every job before reads and after awaits.
88
+ void options.runtime.rank({owner:owner.ownerId,attempt:owner.attemptId,trigger:'native',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=>{
89
+ if(controller.signal.aborted){reply({ok:false,error:isDiscoveryDeadline(controller.signal.reason)?'deadline':'revoked'});return;}
90
+ if(!options.owners.current(owner)){reply({ok:false,error:'revoked'});return;}
91
+ reply({ok:true,result:options.publish?.(result,owner)??result});
92
+ }).catch(()=>reply({ok:false,error:'unavailable'}));
93
+ };
94
+ socket.on('data',chunk=>{
95
+ bytes+=chunk.length;if(bytes>limits.frameBytes){rejectFrame();return;}
96
+ // The combined rank + optional terminal input retains the original byte cap.
97
+ if(handled&&!buffer.length){clearTimeout(timer);timer=setTimeout(rejectFrame,limits.partialFrameMs);}
98
+ buffer=Buffer.concat([buffer,chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
99
+ let value:unknown;try{value=decode(buffer.subarray(0,newline));}catch{if(handled)rejectFrame();else reply({ok:false,error:'malformed_request'});return;}
100
+ buffer=buffer.subarray(newline+1);
101
+ if(handled){if(buffer.length)rejectFrame();else terminal(value);return;}
102
+ if(!validBrokerRequest(value)&&!validControlRequest(value)){reply({ok:false,error:'unsupported_request'});return;}
103
+ // Validate a coalesced second frame BEFORE dispatching any rank. A second
104
+ // rank, foreign control or duplicate terminal cannot cause source collection.
105
+ const next=buffer.indexOf(10);let control:unknown;
106
+ if(buffer.length&&value.type!=='rank_discovery'){rejectFrame();return;}
107
+ if(next>=0){
108
+ try{control=decode(buffer.subarray(0,next));}catch{rejectFrame();return;}
109
+ if(next!==buffer.length-1||value.type!=='rank_discovery'||!validRankDeadline(control,value)){rejectFrame();return;}
110
+ buffer=Buffer.alloc(0);
111
+ }
112
+ handled=true;clearTimeout(timer);handle(value);
113
+ if(next>=0)terminal(control);
114
+ else if(buffer.length)timer=setTimeout(rejectFrame,limits.partialFrameMs);
115
+ });
116
+ });
117
+ try{await new Promise<void>((resolveListen,reject)=>{server.once('error',reject);server.listen(endpoint,()=>{server.off('error',reject);chmodSync(endpoint,0o600);resolveListen();});});}
118
+ catch(error){server.close();rmSync(directory,{recursive:true,force:true});throw error;}
119
+ return {endpoint,directory,get connections(){return sockets.size;},async close(){
120
+ if(closed)return;closed=true;options.owners.dispose();
121
+ const connections=[...sockets].map(socket=>new Promise<void>(resolveClose=>{socket.once('close',()=>resolveClose());socket.destroy();}));
122
+ await Promise.all([new Promise<void>(resolveClose=>server.close(()=>resolveClose())),...connections]);rmSync(directory,{recursive:true,force:true});
123
+ }};
124
+ }
125
+ export type DiscoveryBroker=Awaited<ReturnType<typeof createDiscoveryBroker>>;
@@ -0,0 +1,33 @@
1
+ import type {ExtensionAPI} from '@mariozechner/pi-coding-agent';
2
+ import {safeSourceRead} from '../../lib/safe-source-read.js';
3
+ import {sourceHash} from '../agentic-sources.ts';
4
+ import {adaptDiscovery} from './adapters.ts';
5
+ import {rankDiscovery} from './broker-client.ts';
6
+ import type {DiscoveryAssignment} from './owners.ts';
7
+
8
+ /** Explicitly loaded by the trusted common spawn registration; registers no tools. */
9
+ export default function registerDiscoveryChild(pi:ExtensionAPI):void {
10
+ if(process.env.AF_D9_REGISTERED!=='1')return;
11
+ const root=process.env.AF_D9_ROOT;
12
+ let include:string[];try{include=JSON.parse(process.env.AF_D9_READ_ROOTS??'');if(!Array.isArray(include)||!include.every(p=>typeof p==='string'))return;}catch{return;}
13
+ const assignment:DiscoveryAssignment={endpoint:process.env.AF_D9_ENDPOINT!,capability:process.env.AF_D9_CAPABILITY!,sessionId:process.env.AF_D9_SESSION_ID!,taskId:process.env.AF_D9_TASK_ID!,ownerId:process.env.AF_D9_OWNER_ID!,attemptId:process.env.AF_D9_ATTEMPT_ID!,queryHash:process.env.AF_D9_QUERY_HASH!};
14
+ if(!root||!assignment.endpoint||!assignment.capability)return;
15
+ let controller=new AbortController();const pending=new Map<string,Promise<any>>();
16
+ const abort=()=>{controller.abort();pending.clear();};
17
+ pi.on('session_shutdown',abort);pi.on('session_before_switch',abort);
18
+ pi.on('tool_result',async(event,ctx)=>{
19
+ if(!['find','ls','grep','filesystem'].includes(event.toolName)||event.toolName==='filesystem'&&(event.input as any)?.operation!=='inventory')return;
20
+ const reply=(advice:unknown)=>({content:[...event.content,{type:'text' as const,text:'File discovery advice: '+JSON.stringify(advice)}],details:{...(event.details&&typeof event.details==='object'?event.details:{}),fileDiscovery:advice}});
21
+ if(controller.signal.aborted)return reply({status:'cancelled'});
22
+ const key=JSON.stringify([event.toolCallId,event.toolName,event.input,sourceHash(JSON.stringify(event.content))]);if(pending.has(key))return pending.get(key);
23
+ const work=(async()=>{
24
+ let result:any=event;const bounded=(event.details as any)?.boundedOutput;
25
+ if(bounded){try{const body=safeSourceRead(root,bounded.contentPath,262144);if(sourceHash(body)!==bounded.sha256)throw Error();const {boundedOutput:_b,...details}=event.details as any;result={...event,content:[{type:'text',text:body.toString('utf8')}],details};}catch{return reply({status:'skipped',reason:'bounded_evidence_unavailable'});}}
26
+ const candidates=adaptDiscovery({tool:event.toolName,args:event.input as any,result,cwd:ctx.cwd,root,include});
27
+ if(candidates.paths.length<2)return reply({status:'skipped',reason:candidates.reason??'fewer_than_two_candidates',discoveryComplete:candidates.discoveryComplete});
28
+ const response=await rankDiscovery(assignment,{paths:candidates.paths,discovery:{complete:candidates.discoveryComplete,...(!candidates.discoveryComplete?{reason:'truncated'}:{})}},controller.signal);
29
+ if(controller.signal.aborted)return reply({status:'cancelled'});
30
+ return reply(response.ok?response.result:{status:response.error==='cancelled'?'cancelled':'unavailable',reason:response.error,fallback:'Original discovery evidence is retained; continue ordinary permitted reads.'});
31
+ })();pending.set(key,work);try{return await work;}finally{pending.delete(key);}
32
+ });
33
+ }
@@ -0,0 +1,63 @@
1
+ import {existsSync,readFileSync,writeFileSync,unlinkSync} from 'node:fs';
2
+ import {fileURLToPath} from 'node:url';
3
+ import {spawnPiAgent,spawnPiAgentWithModelFallback,type SpawnPiAgentOptions,type SpawnPiAgentCallbacks,type ModelFallbackOptions,type SpawnPiAgentResult} from '../spawn.ts';
4
+ import {profileFallback,readActiveProfile} from '../policy/profile-runtime.ts';
5
+ import {discoveryAssignmentFromEnv,type DiscoveryAssignment,type DiscoverySpawnRegistration} from './owners.ts';
6
+ import {registerDescendant,rankDiscovery,revokeDiscoveryAttempt} from './broker-client.ts';
7
+
8
+ /** Called only by delegate.ts after its synchronous role/depth/tree/tool reservation.
9
+ * Broker grants inference ownership, not launch authority. Channel failure keeps the
10
+ * ordinary delegate path and its exact permissions; cancellation never retries.
11
+ */
12
+ export async function spawnDiscoveryDescendant(opts:SpawnPiAgentOptions,fallbackModel:string|undefined,cbs:SpawnPiAgentCallbacks,fallbackOptions:ModelFallbackOptions,input:{childId:string;task:string;query:string;admit():boolean}):Promise<SpawnPiAgentResult> {
13
+ const parent=discoveryAssignmentFromEnv();
14
+ if(!parent)return spawnPiAgentWithModelFallback(opts,fallbackModel,cbs,fallbackOptions);
15
+ try{fallbackModel=profileFallback(fallbackModel,readActiveProfile()??readActiveProfile(opts.env));}
16
+ catch(error){return {output:'',stderr:String(error),exitCode:1,spawnError:String(error),modelUsed:opts.model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}};}
17
+ const run=async(model:string)=>{
18
+ const controller=new AbortController();let assignment:DiscoveryAssignment|undefined,revokeWork:Promise<unknown>|undefined;
19
+ const revoke=()=>{if(assignment&&!revokeWork)revokeWork=revokeDiscoveryAttempt(assignment);};
20
+ const abort=()=>{controller.abort();revoke();};opts.signal?.addEventListener('abort',abort,{once:true});
21
+ let manifest:unknown={status:'unavailable',reason:'channel_unavailable',fallback:'Continue ordinary permitted discovery.'};
22
+ let registration:DiscoverySpawnRegistration|undefined;
23
+ try{
24
+ if(opts.signal?.aborted||!input.admit())controller.abort();
25
+ if(!controller.signal.aborted){
26
+ try {
27
+ const response=await registerDescendant(parent,{childId:input.childId,task:input.task,query:input.query,tools:opts.tools.split(',').map(t=>t.trim()).filter(Boolean)},controller.signal);
28
+ if(response.ok){
29
+ const result=response.result as {assignment:DiscoveryAssignment;cwd:string;readRoots:string[];exportRoots:string[];initialPaths:string[];discoveryComplete:boolean};
30
+ const candidate=result.assignment;
31
+ // The broker is trusted, but never reuse a parent's identity even on a bad reply.
32
+ if(!candidate||candidate.capability===parent.capability||candidate.ownerId===parent.ownerId||candidate.attemptId===parent.attemptId)throw Error('invalid_descendant_assignment');
33
+ assignment=candidate;
34
+ if(controller.signal.aborted||!input.admit())abort();
35
+ else {
36
+ const initial=await rankDiscovery(assignment,{paths:result.initialPaths??[],discovery:{complete:result.discoveryComplete}},controller.signal);
37
+ manifest=initial.ok?initial.result:{status:'unavailable',reason:initial.error,fallback:'Continue ordinary permitted discovery.'};
38
+ if(controller.signal.aborted||!input.admit())abort();
39
+ else registration={endpoint:assignment.endpoint,owner:{taskId:assignment.taskId,ownerId:assignment.ownerId,cwd:result.cwd,task:input.task,query:input.query,effectiveTools:opts.tools.split(','),readRoots:result.readRoots,exportRoots:result.exportRoots,canRead:()=>false,canDisplay:()=>false,permissionIdentity:()=>''},extension:fileURLToPath(new URL('./child-extension.ts',import.meta.url)),remoteAttempt:{assignment,signal:controller.signal,revoke}};
40
+ }
41
+ }else manifest={status:response.error==='cancelled'?'cancelled':'unavailable',reason:response.error,fallback:'Continue ordinary permitted discovery.'};
42
+ }catch{revoke();registration=undefined;manifest={status:'unavailable',reason:'channel_unavailable',fallback:'Continue ordinary permitted discovery.'};}
43
+ }
44
+ if(!input.admit()||opts.signal?.aborted)abort();
45
+ return await spawnPiAgent({...opts,model,signal:controller.signal,discoveryRegistration:registration,prompt:opts.prompt+'\n\n## File discovery context (advisory, separate from task/policy/scope/evidence)\n'+JSON.stringify(manifest)},cbs);
46
+ }finally{opts.signal?.removeEventListener('abort',abort);revoke();await revokeWork;}
47
+ };
48
+ // Same fallback semantics as spawn.ts, but registration must be awaited before
49
+ // EACH physical command (the common spawn seam itself is synchronous). Retain
50
+ // session restoration, read-only replay policy and active-profile admission.
51
+ const sessionExisted=existsSync(opts.sessionFile);let snapshot:Buffer|undefined;
52
+ if(sessionExisted){try{snapshot=readFileSync(opts.sessionFile);}catch{}}
53
+ const primary=await run(opts.model);
54
+ if(!fallbackModel||fallbackModel===opts.model||primary.spawnError||primary.termination)return primary;
55
+ const workStarted=primary.toolCallsStarted>0||Boolean(primary.output.trim());
56
+ if(workStarted&&!fallbackOptions.midRun)return primary;
57
+ const reason=primary.assistantError?primary.assistantError.slice(-500):primary.exitCode!==0?(primary.stderr.trim().slice(-500)||`pi exited with code ${primary.exitCode??'unknown'}`):null;
58
+ const providerFailure=/\b(provider unavailable|service unavailable|overloaded|rate limit|too many requests|out of memory|oom|memory limit|resource exhausted|econn(?:reset|refused)|connection (?:reset|refused)|fetch failed|network error|gateway timeout|http\s*5\d\d|\b429\b)\b/i;
59
+ if(!reason||workStarted&&!providerFailure.test(reason)||sessionExisted&&!snapshot)return primary;
60
+ try{if(sessionExisted&&snapshot)writeFileSync(opts.sessionFile,snapshot);else unlinkSync(opts.sessionFile);}catch(error:any){if(error?.code!=='ENOENT')return primary;}
61
+ const notice={from:opts.model,to:fallbackModel,reason};cbs.onModelFallback?.(notice);
62
+ return {...await run(fallbackModel),modelFallback:notice};
63
+ }
@@ -0,0 +1,15 @@
1
+ // Actual pinned Pi find/ls, isolated from the parent environment. No custom traversal or installer.
2
+ import {readFileSync} from 'node:fs';
3
+ const entry=import.meta.resolve('@earendil-works/pi-coding-agent');
4
+ const pkg=JSON.parse(readFileSync(new URL('../package.json',entry),'utf8'));
5
+ if(pkg.version!=='0.84.2')throw Error('unsupported_pi_version');
6
+ const {createFindToolDefinition}=await import(new URL('./core/tools/find.js',entry));
7
+ const {createLsToolDefinition}=await import(new URL('./core/tools/ls.js',entry));
8
+ let input='';for await(const chunk of process.stdin){input+=chunk;if(Buffer.byteLength(input)>32768)throw Error('request_too_large');}
9
+ const {cwd,requests}=JSON.parse(input),controller=new AbortController();
10
+ process.on('SIGTERM',()=>controller.abort());
11
+ for(const args of requests){
12
+ try {const tool=args.tool==='ls'?createLsToolDefinition(cwd):createFindToolDefinition(cwd);const result=await tool.execute('d9-discovery',args,controller.signal);process.stdout.write(JSON.stringify({args,ok:true,result})+'\n');}
13
+ catch(error){process.stdout.write(JSON.stringify({args,ok:false,reason:controller.signal.aborted?'cancelled':String(error.message).includes('fd is not available')?'missing_executable':'unavailable'})+'\n');break;}
14
+ if(controller.signal.aborted)break;
15
+ }