@chankov/agent-fleet 2.0.20 → 2.0.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (626) hide show
  1. package/.pi/harnesses/agent-hub/README.md +3 -2
  2. package/.pi/harnesses/agent-hub/index.ts +7 -5
  3. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +26 -10
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/coms/index.ts +13 -10
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/coms-core-io.ts +29 -2
  9. package/.pi/harnesses/lib/coms-core.ts +144 -42
  10. package/.versions/2.0.21/.pi/agent-fleet/hermes/README.md +347 -0
  11. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  12. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  13. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  14. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  15. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  16. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  17. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  18. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  19. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  20. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  21. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  22. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  23. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  24. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  25. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  26. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  27. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  28. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  29. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  30. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  31. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  32. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  33. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  34. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  35. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  36. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  37. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  38. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  39. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  40. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  41. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  42. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  43. package/.versions/2.0.21/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  44. package/.versions/2.0.21/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  45. package/.versions/2.0.21/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  46. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  47. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  48. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  49. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  50. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  51. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet.ts +217 -0
  52. package/.versions/2.0.21/.pi/agent-fleet/scripts/flow.ts +157 -0
  53. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  54. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  55. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  56. package/.versions/2.0.21/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  57. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  58. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  59. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  60. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  61. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  62. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  63. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  64. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  65. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  66. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  67. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  68. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  69. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  70. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  71. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  72. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  73. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  74. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  75. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  76. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  77. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  78. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  79. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  80. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  81. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  82. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  83. package/.versions/2.0.21/.pi/agent-fleet/scripts/package-lock.json +35 -0
  84. package/.versions/2.0.21/.pi/agent-fleet/scripts/package.json +9 -0
  85. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  86. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  87. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  88. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-up.ts +378 -0
  89. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  90. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  91. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  92. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  93. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  94. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  95. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  96. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  97. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  98. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  99. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  100. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  101. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  102. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  103. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  104. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  105. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  106. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  107. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  108. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  109. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  110. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  111. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  112. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  113. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  114. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  115. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  116. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  117. package/.versions/2.0.21/.pi/agents/dispatch-policy.yaml +32 -0
  118. package/.versions/2.0.21/.pi/agents/model-profiles.yaml +134 -0
  119. package/.versions/2.0.21/.pi/agents/peers.yaml +147 -0
  120. package/.versions/2.0.21/.pi/agents/teams.yaml +41 -0
  121. package/.versions/2.0.21/.pi/agents/voices.yaml +13 -0
  122. package/.versions/2.0.21/.pi/damage-control-rules.yaml +297 -0
  123. package/.versions/2.0.21/.pi/extensions/btw/README.md +120 -0
  124. package/.versions/2.0.21/.pi/extensions/btw/index.ts +914 -0
  125. package/.versions/2.0.21/.pi/extensions/btw/package.json +6 -0
  126. package/.versions/2.0.21/.pi/extensions/btw/state.js +179 -0
  127. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  128. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  129. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  130. package/.versions/2.0.21/.pi/extensions/compact-and-continue/README.md +42 -0
  131. package/.versions/2.0.21/.pi/extensions/compact-and-continue/index.ts +136 -0
  132. package/.versions/2.0.21/.pi/extensions/compact-and-continue/package.json +6 -0
  133. package/.versions/2.0.21/.pi/extensions/mcp-bridge/README.md +46 -0
  134. package/.versions/2.0.21/.pi/extensions/mcp-bridge/index.ts +206 -0
  135. package/.versions/2.0.21/.pi/extensions/mcp-bridge/package.json +6 -0
  136. package/.versions/2.0.21/.pi/extensions/package-lock.json +1175 -0
  137. package/.versions/2.0.21/.pi/extensions/package.json +9 -0
  138. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/README.md +224 -0
  139. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/config.ts +198 -0
  140. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  141. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/index.ts +248 -0
  142. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/package.json +6 -0
  143. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  144. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  145. package/.versions/2.0.21/.pi/harnesses/agent-hub/README.md +1517 -0
  146. package/.versions/2.0.21/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  147. package/.versions/2.0.21/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  148. package/.versions/2.0.21/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  149. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  150. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  151. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  152. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  153. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  154. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  155. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  156. package/.versions/2.0.21/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  157. package/.versions/2.0.21/.pi/harnesses/agent-hub/artifacts.js +146 -0
  158. package/.versions/2.0.21/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  159. package/.versions/2.0.21/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  160. package/.versions/2.0.21/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  161. package/.versions/2.0.21/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  162. package/.versions/2.0.21/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  163. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  164. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  165. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  166. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  167. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  168. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  169. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  170. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  171. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  172. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  173. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  174. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  175. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  176. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  177. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  178. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  179. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  180. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  181. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  182. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  183. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  184. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  185. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  186. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  187. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  188. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  189. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  190. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  191. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  192. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  193. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  194. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  195. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  196. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  197. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  198. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  199. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  200. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  201. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  202. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  203. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  204. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  205. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  206. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  207. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  208. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  209. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  210. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  211. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  212. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  213. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  214. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-window.js +108 -0
  215. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  216. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  217. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  218. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  219. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  220. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  221. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  222. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  223. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  224. package/.versions/2.0.21/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  225. package/.versions/2.0.21/.pi/harnesses/agent-hub/delegate.ts +478 -0
  226. package/.versions/2.0.21/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  227. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  228. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  229. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  230. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  231. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  232. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  233. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +253 -0
  234. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  235. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  236. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  237. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  238. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  239. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  240. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  241. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  242. package/.versions/2.0.21/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  243. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  244. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  245. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  246. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  247. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  248. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  249. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  250. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  251. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  252. package/.versions/2.0.21/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  253. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  254. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  255. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  256. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  257. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  258. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  259. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  260. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  261. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  262. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  263. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  264. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  265. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  266. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  267. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  268. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  269. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  270. package/.versions/2.0.21/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  271. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  272. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.21/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.21/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.21/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  276. package/.versions/2.0.21/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  277. package/.versions/2.0.21/.pi/harnesses/agent-hub/index.ts +2616 -0
  278. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  279. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  280. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  281. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  282. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  283. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  284. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  285. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  286. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  287. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  288. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  289. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  290. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  291. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  292. package/.versions/2.0.21/.pi/harnesses/agent-hub/no-progress.ts +620 -0
  293. package/.versions/2.0.21/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  294. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  295. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  296. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  297. package/.versions/2.0.21/.pi/harnesses/agent-hub/package.json +7 -0
  298. package/.versions/2.0.21/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  299. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  300. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  301. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  302. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  303. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  304. package/.versions/2.0.21/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  305. package/.versions/2.0.21/.pi/harnesses/agent-hub/presentation.ts +48 -0
  306. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  307. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  308. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  309. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  310. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  311. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  312. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  313. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  314. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  315. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  316. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  317. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  318. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  319. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  320. package/.versions/2.0.21/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  321. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  322. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  323. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  324. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  325. package/.versions/2.0.21/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  326. package/.versions/2.0.21/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  327. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  328. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  329. package/.versions/2.0.21/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  330. package/.versions/2.0.21/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  331. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  332. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  333. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  334. package/.versions/2.0.21/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  335. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-contract.js +349 -0
  336. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-extract.js +77 -0
  337. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  338. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  339. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-findings.js +96 -0
  340. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  341. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  342. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  343. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-budget.js +342 -0
  344. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  345. package/.versions/2.0.21/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  346. package/.versions/2.0.21/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  347. package/.versions/2.0.21/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  348. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  349. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-health.js +110 -0
  350. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-start.ts +42 -0
  351. package/.versions/2.0.21/.pi/harnesses/agent-hub/spawn.ts +639 -0
  352. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  353. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  354. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  355. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  356. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  357. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  358. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  359. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  360. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  361. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  362. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  363. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  364. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  365. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  366. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  367. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  368. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  369. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  370. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  371. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  372. package/.versions/2.0.21/.pi/harnesses/agent-hub/timeline.ts +72 -0
  373. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  374. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  375. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  376. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  377. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  378. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  379. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  380. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  381. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  382. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +640 -0
  383. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  384. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  385. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  386. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  387. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  388. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  389. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  390. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  391. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  392. package/.versions/2.0.21/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  393. package/.versions/2.0.21/.pi/harnesses/agent-hub/types.ts +66 -0
  394. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  395. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  396. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  397. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  398. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  399. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  400. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  401. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  402. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  403. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  404. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  405. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  406. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  407. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  408. package/.versions/2.0.21/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  409. package/.versions/2.0.21/.pi/harnesses/agent-hub/version.ts +42 -0
  410. package/.versions/2.0.21/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  411. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  412. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  413. package/.versions/2.0.21/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  414. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/README.md +59 -0
  415. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/index.ts +569 -0
  416. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  417. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  418. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  419. package/.versions/2.0.21/.pi/harnesses/coms/README.md +100 -0
  420. package/.versions/2.0.21/.pi/harnesses/coms/index.ts +285 -0
  421. package/.versions/2.0.21/.pi/harnesses/coms/package.json +7 -0
  422. package/.versions/2.0.21/.pi/harnesses/coms/version.ts +42 -0
  423. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/README.md +161 -0
  424. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/index.ts +600 -0
  425. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/package.json +7 -0
  426. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  427. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  428. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  429. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  430. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/version.ts +42 -0
  431. package/.versions/2.0.21/.pi/harnesses/lib/approval-wait.ts +17 -0
  432. package/.versions/2.0.21/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  433. package/.versions/2.0.21/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  434. package/.versions/2.0.21/.pi/harnesses/lib/clarification-policy.ts +9 -0
  435. package/.versions/2.0.21/.pi/harnesses/lib/coms-core-io.ts +413 -0
  436. package/.versions/2.0.21/.pi/harnesses/lib/coms-core.ts +680 -0
  437. package/.versions/2.0.21/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  438. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  439. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  440. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-view.ts +112 -0
  441. package/.versions/2.0.21/.pi/harnesses/lib/context-budget.ts +114 -0
  442. package/.versions/2.0.21/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  443. package/.versions/2.0.21/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  444. package/.versions/2.0.21/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  445. package/.versions/2.0.21/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  446. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  447. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-view.ts +16 -0
  448. package/.versions/2.0.21/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  449. package/.versions/2.0.21/.pi/harnesses/lib/execution-trace.ts +45 -0
  450. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  451. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  452. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  453. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  454. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  455. package/.versions/2.0.21/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  456. package/.versions/2.0.21/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  457. package/.versions/2.0.21/.pi/harnesses/lib/fleet-panel.ts +34 -0
  458. package/.versions/2.0.21/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  459. package/.versions/2.0.21/.pi/harnesses/lib/fleet-selection.ts +24 -0
  460. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  461. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  462. package/.versions/2.0.21/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  463. package/.versions/2.0.21/.pi/harnesses/lib/herdr-client.ts +472 -0
  464. package/.versions/2.0.21/.pi/harnesses/lib/herdr-presence.ts +399 -0
  465. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  466. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  467. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  468. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  469. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  470. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  471. package/.versions/2.0.21/.pi/harnesses/lib/identical-dialog.ts +27 -0
  472. package/.versions/2.0.21/.pi/harnesses/lib/installation-state.js +62 -0
  473. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.js +106 -0
  474. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.ts +31 -0
  475. package/.versions/2.0.21/.pi/harnesses/lib/process-shared.ts +9 -0
  476. package/.versions/2.0.21/.pi/harnesses/lib/safe-source-read.js +29 -0
  477. package/.versions/2.0.21/.pi/harnesses/lib/semantic-approval.ts +80 -0
  478. package/.versions/2.0.21/.pi/harnesses/lib/spawned-peers.js +191 -0
  479. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  480. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  481. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  482. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  483. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-json.js +37 -0
  484. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-loader.js +44 -0
  485. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  486. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-triage.js +42 -0
  487. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-v2.js +112 -0
  488. package/.versions/2.0.21/.pi/harnesses/lib/system1/config.js +50 -0
  489. package/.versions/2.0.21/.pi/harnesses/lib/system1/contracts.ts +154 -0
  490. package/.versions/2.0.21/.pi/harnesses/lib/system1/demo.ts +95 -0
  491. package/.versions/2.0.21/.pi/harnesses/lib/system1/jev.ts +503 -0
  492. package/.versions/2.0.21/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  493. package/.versions/2.0.21/.pi/harnesses/lib/system1/selection.js +11 -0
  494. package/.versions/2.0.21/.pi/harnesses/lib/system1/service.ts +245 -0
  495. package/.versions/2.0.21/.pi/harnesses/lib/update-check.ts +222 -0
  496. package/.versions/2.0.21/.pi/harnesses/package-lock.json +2121 -0
  497. package/.versions/2.0.21/.pi/harnesses/package.json +13 -0
  498. package/.versions/2.0.21/.pi/prompts/af-build.md +27 -0
  499. package/.versions/2.0.21/.pi/prompts/af-code-simplify.md +22 -0
  500. package/.versions/2.0.21/.pi/prompts/af-constraints.md +31 -0
  501. package/.versions/2.0.21/.pi/prompts/af-plan.md +17 -0
  502. package/.versions/2.0.21/.pi/prompts/af-review.md +16 -0
  503. package/.versions/2.0.21/.pi/prompts/af-set-hermes-telegram.md +15 -0
  504. package/.versions/2.0.21/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  505. package/.versions/2.0.21/.pi/prompts/af-setup-rules.md +20 -0
  506. package/.versions/2.0.21/.pi/prompts/af-ship.md +17 -0
  507. package/.versions/2.0.21/.pi/prompts/af-spec.md +15 -0
  508. package/.versions/2.0.21/.pi/prompts/af-test.md +19 -0
  509. package/.versions/2.0.21/.pi/skills/bowser/SKILL.md +145 -0
  510. package/.versions/2.0.21/.version +1 -0
  511. package/.versions/2.0.21/agents/architect.md +24 -0
  512. package/.versions/2.0.21/agents/bowser.md +28 -0
  513. package/.versions/2.0.21/agents/builder.md +55 -0
  514. package/.versions/2.0.21/agents/code-reviewer.md +209 -0
  515. package/.versions/2.0.21/agents/deep-researcher.md +32 -0
  516. package/.versions/2.0.21/agents/documenter.md +22 -0
  517. package/.versions/2.0.21/agents/orchestrator.md +22 -0
  518. package/.versions/2.0.21/agents/plan-reviewer.md +83 -0
  519. package/.versions/2.0.21/agents/planner.md +107 -0
  520. package/.versions/2.0.21/agents/releaser.md +24 -0
  521. package/.versions/2.0.21/agents/researcher.md +30 -0
  522. package/.versions/2.0.21/agents/security-auditor.md +167 -0
  523. package/.versions/2.0.21/agents/test-engineer.md +153 -0
  524. package/.versions/2.0.21/agents/web-debugger.md +44 -0
  525. package/.versions/2.0.21/agents/web-performance-auditor.md +194 -0
  526. package/.versions/2.0.21/bin/catalog/harness-runtime-closure.json +73 -0
  527. package/.versions/2.0.21/codex/fleet-session-client/SKILL.md +34 -0
  528. package/.versions/2.0.21/codex/fleet-session-client.zip +0 -0
  529. package/.versions/2.0.21/docs/ARCHITECTURE.md +979 -0
  530. package/.versions/2.0.21/docs/agent-fleet-setup.md +1103 -0
  531. package/.versions/2.0.21/docs/claude-code-coms-bridge.md +147 -0
  532. package/.versions/2.0.21/docs/codex-session-bridge.md +219 -0
  533. package/.versions/2.0.21/docs/coms-hermes-bridge.md +188 -0
  534. package/.versions/2.0.21/docs/getting-started.md +126 -0
  535. package/.versions/2.0.21/docs/npm-install.md +535 -0
  536. package/.versions/2.0.21/docs/pi-extensions.md +455 -0
  537. package/.versions/2.0.21/docs/pi-setup.md +92 -0
  538. package/.versions/2.0.21/docs/skill-anatomy.md +150 -0
  539. package/.versions/2.0.21/install-manifest.json +3210 -0
  540. package/.versions/2.0.21/justfile +247 -0
  541. package/.versions/2.0.21/manifest-meta.json +1088 -0
  542. package/.versions/2.0.21/references/accessibility-checklist.md +160 -0
  543. package/.versions/2.0.21/references/communication-contract.md +26 -0
  544. package/.versions/2.0.21/references/definition-of-done.md +67 -0
  545. package/.versions/2.0.21/references/fleet-coordination-patterns.md +171 -0
  546. package/.versions/2.0.21/references/observability-checklist.md +92 -0
  547. package/.versions/2.0.21/references/orchestration-patterns.md +370 -0
  548. package/.versions/2.0.21/references/performance-checklist.md +236 -0
  549. package/.versions/2.0.21/references/prompting-patterns.md +380 -0
  550. package/.versions/2.0.21/references/security-checklist.md +245 -0
  551. package/.versions/2.0.21/references/testing-patterns.md +235 -0
  552. package/.versions/2.0.21/references/workflow-authoring.md +304 -0
  553. package/.versions/2.0.21/skills/_internal/grilling.md +59 -0
  554. package/.versions/2.0.21/skills/browser-testing-with-devtools/SKILL.md +351 -0
  555. package/.versions/2.0.21/skills/code-review-and-quality/SKILL.md +396 -0
  556. package/.versions/2.0.21/skills/compound-learning/SKILL.md +137 -0
  557. package/.versions/2.0.21/skills/constraint-driven-development/SKILL.md +338 -0
  558. package/.versions/2.0.21/skills/constraint-driven-development/references/floor-guard.md +99 -0
  559. package/.versions/2.0.21/skills/context-engineering/SKILL.md +341 -0
  560. package/.versions/2.0.21/skills/deprecation-and-migration/SKILL.md +247 -0
  561. package/.versions/2.0.21/skills/designing-agents/SKILL.md +394 -0
  562. package/.versions/2.0.21/skills/designing-agents/pi-harness-authoring.md +222 -0
  563. package/.versions/2.0.21/skills/drafting-workflows/SKILL.md +143 -0
  564. package/.versions/2.0.21/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  565. package/.versions/2.0.21/skills/frontend-ui-engineering/SKILL.md +328 -0
  566. package/.versions/2.0.21/skills/git-workflow-and-versioning/SKILL.md +316 -0
  567. package/.versions/2.0.21/skills/idea-refine/SKILL.md +182 -0
  568. package/.versions/2.0.21/skills/idea-refine/examples.md +238 -0
  569. package/.versions/2.0.21/skills/idea-refine/frameworks.md +99 -0
  570. package/.versions/2.0.21/skills/idea-refine/refinement-criteria.md +113 -0
  571. package/.versions/2.0.21/skills/idea-refine/scripts/idea-refine.sh +15 -0
  572. package/.versions/2.0.21/skills/incremental-implementation/SKILL.md +353 -0
  573. package/.versions/2.0.21/skills/incremental-implementation.zip +0 -0
  574. package/.versions/2.0.21/skills/interview-me/SKILL.md +226 -0
  575. package/.versions/2.0.21/skills/orchestration-verification/SKILL.md +182 -0
  576. package/.versions/2.0.21/skills/peer-coms/SKILL.md +90 -0
  577. package/.versions/2.0.21/skills/performance-optimization/SKILL.md +496 -0
  578. package/.versions/2.0.21/skills/planning-and-task-breakdown/SKILL.md +318 -0
  579. package/.versions/2.0.21/skills/planning-and-task-breakdown.zip +0 -0
  580. package/.versions/2.0.21/skills/repository-ai-setup/SKILL.md +135 -0
  581. package/.versions/2.0.21/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  582. package/.versions/2.0.21/skills/repository-ai-setup/references/apply-contract.md +74 -0
  583. package/.versions/2.0.21/skills/repository-ai-setup/references/provenance-template.md +16 -0
  584. package/.versions/2.0.21/skills/repository-ai-setup/references/setup-flow.md +108 -0
  585. package/.versions/2.0.21/skills/repository-ai-setup/references/verify-setup.md +20 -0
  586. package/.versions/2.0.21/skills/repository-ai-setup.zip +0 -0
  587. package/.versions/2.0.21/skills/security-and-hardening/SKILL.md +524 -0
  588. package/.versions/2.0.21/skills/spec-driven-development/SKILL.md +295 -0
  589. package/.versions/2.0.21/skills/spec-driven-development.zip +0 -0
  590. package/.versions/2.0.21/skills/using-agent-skills/SKILL.md +198 -0
  591. package/.versions/2.0.21/vendor/agent-skills-upstream/LICENSE +21 -0
  592. package/.versions/2.0.21/vendor/agent-skills-upstream/README.md +430 -0
  593. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  594. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  595. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  596. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  597. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  598. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  599. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  600. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  601. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  602. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  603. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  604. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  605. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  606. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  607. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  608. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  609. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  610. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  611. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  612. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  613. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  614. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  615. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  616. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  617. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  618. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  619. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  620. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  621. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  622. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  623. package/CHANGELOG.md +6 -0
  624. package/docs/ARCHITECTURE.md +4 -2
  625. package/install-manifest.json +1 -1
  626. package/package.json +1 -1
@@ -0,0 +1,478 @@
1
+ /**
2
+ * delegate — the injected extension that gives an agent-hub specialist a
3
+ * mid-turn `delegate(role, instruction, context?, allow_write?)` tool.
4
+ *
5
+ * The hub adds `-e delegate.ts` (plus `delegate` in the child's `--tools`
6
+ * allowlist — pi's allowlist applies to extension tools too) when a dispatched
7
+ * persona declares `subagents:` in its frontmatter. Everything this extension
8
+ * may spawn comes from AGENT_HUB_DELEGATE_CONFIG (JSON, serialized by the
9
+ * hub): the declared sub-roles and their models, the remaining depth budget,
10
+ * the tree-wide remaining spawn budget, and the event directory. The child
11
+ * process NEVER re-parses persona files — model choice is configuration, not
12
+ * the LLM's whim.
13
+ *
14
+ * Budgets (readable refusals, never silent):
15
+ * - tree-wide spawn budget: at most 4 delegate children per dispatch
16
+ * - depth budget: each child receives `depth − 1`; the hub normally omits
17
+ * delegate tooling from children at remaining depth 0, so a persona with
18
+ * `delegate_depth: 1` (the default and max) can spawn terminal children
19
+ *
20
+ * Write safety: a child is read-only (read,grep,find,ls) unless it is the ONLY
21
+ * live child and the parent passed `allow_write: true` — then it inherits the
22
+ * parent's tools, intersected with the role's declared `tools:` cap when one
23
+ * exists. Concurrent children are always forced read-only (two agents editing
24
+ * the same files is not solvable with guardrails).
25
+ *
26
+ * Observability: every spawn/timeline/usage/exit is appended as JSONL to
27
+ * `<eventDir>/events.jsonl`. The hub watches that file and renders children as
28
+ * nested rows under the parent's grid card (openable via /af-zoom). Kill cascade:
29
+ * children are spawned in THIS process's group (the hub spawns specialists
30
+ * detached), so `/af-agents-kill` on the parent SIGTERMs the whole tree; a
31
+ * SIGTERM trap forwards to live children as a fallback.
32
+ */
33
+
34
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
35
+ import { fileURLToPath } from "node:url";
36
+ import { BOUNDED_OUTPUT_DIR_ENV } from "./bounded-output.ts";
37
+ import { FILESYSTEM_SESSION_DIR_ENV } from "./filesystem-tool.ts";
38
+ import { Type } from "@sinclair/typebox";
39
+ import { appendFileSync, mkdirSync, writeFileSync } from "fs";
40
+ import type { ChildProcess } from "child_process";
41
+ import { killPiTree } from "./spawn.ts";
42
+ import { spawnDamageDescendant } from "./damage-guard-descendant.ts";
43
+ import { redactSecrets } from "../lib/fleet-transcript-store.ts";
44
+ import { buildProjectDocsProtocol, buildProjectRulesProtocol } from "../lib/context-budget-child-prompt.ts";
45
+ import { DEFAULT_PROVIDER_LIMITS, createProviderSemaphore, parseProviderLimits } from "./provider-semaphore.js";
46
+ import {
47
+ delegateBudgetRefusal,
48
+ DELEGATE_TREE_SPAWN_BUDGET,
49
+ isReadOnlyToolList,
50
+ normalizeDelegateRuntimeBudgets,
51
+ planDelegateSpawn,
52
+ resolveDelegateTools,
53
+ safeAgentKey,
54
+ safePathWithin,
55
+ } from "./helpers.ts";
56
+
57
+ const DEFAULT_CALL_BUDGET = DELEGATE_TREE_SPAWN_BUDGET;
58
+ const RESULT_CAP = 2000;
59
+ const DIGEST_MAX_LINES = 30;
60
+ // How often buffered text/thinking deltas are flushed into the event file.
61
+ const TIMELINE_FLUSH_MS = 700;
62
+
63
+ // Serialized by the hub into AGENT_HUB_DELEGATE_CONFIG. `tag` is this
64
+ // process's node id in the delegation tree ("root" for the specialist itself);
65
+ // nested delegate.ts instances get their child id as tag, so every event line
66
+ // carries an unambiguous parent chain.
67
+ export interface DelegateConfig {
68
+ persona: string;
69
+ tag: string;
70
+ roles: Record<string, { model: string; tools?: string; fallbackModel?: string; thinking?: string }>;
71
+ depth: number;
72
+ callBudget: number;
73
+ remainingSpawns?: number;
74
+ parentTools: string;
75
+ personaPrompt: string;
76
+ eventDir: string;
77
+ damageControl?: string;
78
+ delegateExt: string;
79
+ /** Parent-side per-tool deadline inherited by every terminal child. */
80
+ reconSearchTimeoutMs?: number | null;
81
+ /** Whole-run deadline per delegate child (hub mode budget); null/absent = off. */
82
+ turnDeadlineMs?: number | null;
83
+ boundedOutput?: boolean;
84
+ boundedOutputDir?: string;
85
+ deterministicTools?: boolean;
86
+ filesystemSessionDir?: string;
87
+ cwd: string;
88
+ projectPolicy?: { rulesPaths: string[]; docsPaths: string[] };
89
+ }
90
+
91
+ // Appended to every child's system prompt so it knows its place in the tree
92
+ // and reports tersely (its full report returns through the tool result, which
93
+ // lands in the parent's context).
94
+ function subagentProtocol(persona: string, role: string, canDelegate: boolean, projectPolicy?: DelegateConfig["projectPolicy"]): string {
95
+ return buildProjectRulesProtocol(projectPolicy?.rulesPaths ?? []) + buildProjectDocsProtocol(projectPolicy?.docsPaths ?? []) + `
96
+
97
+ ## You are the "${role}" sub-agent of a ${persona} specialist
98
+ Your parent delegated ONE specific task to you. Do exactly that task — do not
99
+ widen scope, do not start unrelated work. Your full output is written to a result
100
+ file, but your parent receives only a compact digest. End your final message with
101
+ a \`DIGEST:\` section of no more than 30 lines, self-contained, with path:line
102
+ citations where relevant. Put the most important findings and next actions there.${canDelegate ? `
103
+ You may delegate narrow sub-tasks further via your own delegate tool, within
104
+ its declared roles and remaining tree budget.` : `
105
+ You CANNOT delegate further — your remaining depth is 0, so this child has no
106
+ delegate tooling. Do the work yourself with the tools you have.`}`;
107
+ }
108
+
109
+ function childResultDigest(output: string, resultPath: string): { text: string; hasDigest: boolean } {
110
+ const lines = String(output || "").split(/\r?\n/);
111
+ const marker = lines.map(l => l.trim()).findIndex(l => /^DIGEST:\s*$/i.test(l));
112
+ if (marker >= 0) {
113
+ const digestLines = lines.slice(marker, marker + DIGEST_MAX_LINES);
114
+ return {
115
+ text: capInline(`${digestLines.join("\n")}\n\nFull output: ${resultPath}\nRead the result file only if this digest is insufficient.`),
116
+ hasDigest: true,
117
+ };
118
+ }
119
+ const fallback = lines.slice(0, DIGEST_MAX_LINES).join("\n");
120
+ return {
121
+ text: capInline(`${fallback}\n\n[no DIGEST section — full output at ${resultPath}]`),
122
+ hasDigest: false,
123
+ };
124
+ }
125
+
126
+ function capInline(text: string): string {
127
+ return text.length > RESULT_CAP ? text.slice(0, RESULT_CAP) + "\n... [digest truncated]" : text;
128
+ }
129
+
130
+ export default function (pi: ExtensionAPI) {
131
+ let cfg: DelegateConfig | null = null;
132
+ try {
133
+ cfg = JSON.parse(process.env.AGENT_HUB_DELEGATE_CONFIG || "");
134
+ } catch {
135
+ cfg = null;
136
+ }
137
+ // Misconfigured (or launched outside the hub): register nothing — the
138
+ // parent simply has no delegate tool.
139
+ if (!cfg || !cfg.roles || !cfg.eventDir) return;
140
+ const config = cfg;
141
+ const budgets = normalizeDelegateRuntimeBudgets(config, DEFAULT_CALL_BUDGET);
142
+ config.depth = budgets.depth;
143
+ config.callBudget = budgets.callBudget;
144
+ config.remainingSpawns = budgets.remainingSpawns;
145
+
146
+ let callCount = 0;
147
+ let childSeq = 0;
148
+ // Synchronous reservation counter for the write-safety gate. Incremented at
149
+ // the gate (before any await), so two parallel delegate calls can never both
150
+ // observe "I am the only child" — do NOT replace this with liveChildren.size,
151
+ // which only grows once the child process actually spawns.
152
+ let liveCount = 0;
153
+ const liveChildren = new Set<ChildProcess>();
154
+
155
+ // Per-provider concurrency. Four read-only children fanning out at once is a
156
+ // feature against a hosted provider and a mid-run OOM against the local one,
157
+ // so `custom/*` queues past 2 in flight. Queued children still run — they
158
+ // just wait for a permit instead of racing for the same GPU.
159
+ const providerSemaphore = createProviderSemaphore({
160
+ ...DEFAULT_PROVIDER_LIMITS,
161
+ ...parseProviderLimits(process.env.AGENT_HUB_PROVIDER_LIMITS),
162
+ });
163
+
164
+ // Fallback cascade: the primary kill path is the process group (the hub
165
+ // signals the specialist's negative PID), but if only this process is
166
+ // terminated, forward the signal to any live children.
167
+ const treeController = new AbortController();
168
+ const cancelTree = () => {
169
+ treeController.abort();
170
+ for (const child of liveChildren) killPiTree(child, "SIGTERM");
171
+ };
172
+ process.on("SIGTERM", cancelTree);
173
+ pi.on?.("session_shutdown", cancelTree);
174
+ pi.on?.("session_before_switch", cancelTree);
175
+
176
+ const redactValue = (value: unknown): unknown => {
177
+ if (typeof value === "string") return redactSecrets(value);
178
+ if (Array.isArray(value)) return value.map(redactValue);
179
+ if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, nested]) => [key, redactValue(nested)]));
180
+ return value;
181
+ };
182
+ const emit = (event: Record<string, unknown>) => {
183
+ try {
184
+ appendFileSync(safePathWithin(config.eventDir, "events.jsonl"), JSON.stringify(redactValue(event)) + "\n", { encoding: "utf-8", mode: 0o600 });
185
+ } catch {}
186
+ };
187
+
188
+ const roleNames = Object.keys(config.roles).filter((name) => {
189
+ try { safeAgentKey(name); return true; } catch { return false; }
190
+ });
191
+ if (roleNames.length === 0) return;
192
+
193
+ pi.registerTool({
194
+ name: "delegate",
195
+ label: "Delegate",
196
+ description:
197
+ `Spawn one of your declared sub-agents on its pre-configured model and wait for its report. ` +
198
+ `Declared roles: ${roleNames.join(", ")}. Use it to fan out scoped sub-tasks (reviews, scans, ` +
199
+ `doc checks) instead of doing everything yourself; at most ${DELEGATE_TREE_SPAWN_BUDGET} ` +
200
+ `children may be spawned per dispatch, and parallel children are forced read-only. The child ` +
201
+ `does not share your context — pass everything it needs in \`instruction\`/\`context\`.`,
202
+ parameters: Type.Object({
203
+ role: Type.String({ description: `Declared sub-role to spawn. One of: ${roleNames.join(", ")}` }),
204
+ instruction: Type.String({ description: "The specific, self-contained task for the sub-agent." }),
205
+ context: Type.Optional(Type.String({
206
+ description: "Optional background brief pasted above the instruction (the child shares none of " +
207
+ "your context). The keyword 'fork' (full context fork) is accepted but treated as a summary " +
208
+ "brief in v1 — write the brief out.",
209
+ })),
210
+ allow_write: Type.Optional(Type.Boolean({
211
+ description: "Let the child inherit your tools (including write access). Honored only while it " +
212
+ "is your ONLY live child; concurrent children are always read-only. A role-level tools cap " +
213
+ "still wins and refuses delegation if it leaves no tools.",
214
+ })),
215
+ }),
216
+
217
+ async execute(_toolCallId, params, _signal, onUpdate) {
218
+ const { role, instruction, context, allow_write } = params as {
219
+ role: string; instruction: string; context?: string; allow_write?: boolean;
220
+ };
221
+
222
+ // Readable refusals — budget exhaustion is an answer, not a mystery.
223
+ const budgetRefusal = delegateBudgetRefusal({
224
+ depth: config.depth,
225
+ callBudget: config.callBudget,
226
+ remainingSpawns: config.remainingSpawns ?? 0,
227
+ callCount,
228
+ });
229
+ if (budgetRefusal) {
230
+ return { content: [{ type: "text" as const, text: budgetRefusal }], details: { status: "refused", reason: "budget" } };
231
+ }
232
+ const roleKey = roleNames.find(r => r.toLowerCase() === role.toLowerCase());
233
+ if (!roleKey) {
234
+ return {
235
+ content: [{ type: "text" as const, text:
236
+ `Delegation refused: "${role}" is not a declared sub-role. Declared roles: ` +
237
+ `${roleNames.join(", ")}.` }],
238
+ details: { status: "refused", reason: "unknown_role" },
239
+ };
240
+ }
241
+ const roleDef = config.roles[roleKey];
242
+
243
+ // Write safety: read-only unless this is the only live child AND the
244
+ // parent explicitly granted write. The role's tools cap always wins.
245
+ const tools = resolveDelegateTools({
246
+ parentTools: config.parentTools,
247
+ roleTools: roleDef.tools,
248
+ allowWrite: allow_write === true,
249
+ concurrent: liveCount > 0,
250
+ });
251
+ if (tools.refused) {
252
+ return {
253
+ content: [{ type: "text" as const, text:
254
+ `Delegation refused: role "${roleKey}" declares tools "${roleDef.tools}" but none are ` +
255
+ `available under the current parent/concurrency tool policy.` }],
256
+ details: { status: "refused", reason: "tools_unavailable" },
257
+ };
258
+ }
259
+ const signal = _signal ? AbortSignal.any([_signal, treeController.signal]) : treeController.signal;
260
+ if (signal.aborted) return { content: [{ type: "text" as const, text: "Delegation cancelled before launch." }], details: { status: "cancelled" } };
261
+ const effectiveTools = tools.effectiveTools;
262
+ const writeDowngraded = tools.writeDowngraded;
263
+
264
+ callCount++;
265
+ childSeq++;
266
+ const plan = planDelegateSpawn({
267
+ tag: config.tag,
268
+ roleKey,
269
+ childSeq,
270
+ depth: config.depth,
271
+ remainingSpawns: config.remainingSpawns ?? 0,
272
+ effectiveTools,
273
+ damageControl: config.damageControl,
274
+ delegateExt: config.delegateExt,
275
+ });
276
+ config.remainingSpawns = plan.nextRemainingSpawns;
277
+ const childId = plan.childId;
278
+ const childDepth = plan.childDepth;
279
+ const childRemainingSpawns = plan.childRemainingSpawns;
280
+ const childCanDelegate = plan.childCanDelegate;
281
+ const childExtensions = [
282
+ ...plan.childExtensions,
283
+ ...(config.boundedOutput ? [fileURLToPath(new URL("./bounded-output.ts", import.meta.url))] : []),
284
+ ...(config.deterministicTools ? [fileURLToPath(new URL("./filesystem-tool.ts", import.meta.url))] : []),
285
+ ];
286
+ const childTools = plan.childTools;
287
+ const childConfig: DelegateConfig | null = plan.includeDelegateConfig ? {
288
+ ...config,
289
+ tag: childId,
290
+ depth: childDepth,
291
+ remainingSpawns: childRemainingSpawns,
292
+ parentTools: effectiveTools,
293
+ } : null;
294
+
295
+ const sessionsDir = safePathWithin(config.eventDir, "sessions");
296
+ const resultsDir = safePathWithin(config.eventDir, "results");
297
+ const childSessionFile = safePathWithin(sessionsDir, `${childId}.jsonl`);
298
+ const boundedOutputDir = config.boundedOutput ? safePathWithin(config.boundedOutputDir ?? config.eventDir, childId) : undefined;
299
+ const childResultFile = safePathWithin(resultsDir, `${childId}.md`);
300
+ try { mkdirSync(sessionsDir, { recursive: true }); } catch {}
301
+ try { mkdirSync(resultsDir, { recursive: true }); } catch {}
302
+
303
+ emit({
304
+ t: "spawn", id: childId, parent: config.tag, role: roleKey,
305
+ model: roleDef.model, tools: effectiveTools, remainingSpawns: childRemainingSpawns, ts: Date.now(),
306
+ });
307
+ onUpdate?.({
308
+ content: [{ type: "text", text: `Delegating to ${roleKey} (${roleDef.model})...` }],
309
+ details: { id: childId, role: roleKey, model: roleDef.model, status: "running" },
310
+ });
311
+
312
+ // Buffered timeline streaming: coalesce text/thinking deltas and flush
313
+ // them into the event file on an interval (and on tool/exit), so the
314
+ // hub can render a live /af-zoom timeline without an event per token.
315
+ let pendingKind: "text" | "thinking" | null = null;
316
+ let pendingDelta = "";
317
+ const flushTimeline = () => {
318
+ if (!pendingKind || !pendingDelta) return;
319
+ emit({ t: "timeline", id: childId, kind: pendingKind, delta: pendingDelta });
320
+ pendingDelta = "";
321
+ };
322
+ const queueDelta = (kind: "text" | "thinking", delta: string) => {
323
+ if (pendingKind !== kind) flushTimeline();
324
+ pendingKind = kind;
325
+ pendingDelta += delta;
326
+ };
327
+ const flushTimer = setInterval(flushTimeline, TIMELINE_FLUSH_MS);
328
+
329
+ const startTime = Date.now();
330
+ // Time spent waiting for a provider permit, reported alongside `elapsed`
331
+ // so a queued child is never mistaken for a slow one (the run deadline is
332
+ // measured from the spawn, not from here).
333
+ let queuedMs = 0;
334
+ let childProc: ChildProcess | null = null;
335
+ const mode = context?.trim().toLowerCase();
336
+ const brief = context && mode !== "summary" && mode !== "fork" ? context : undefined;
337
+ const prompt = brief
338
+ ? `## Context from your parent\n${brief}\n\n## Your task\n${instruction}`
339
+ : instruction;
340
+
341
+ let res;
342
+ liveCount++;
343
+ try {
344
+ const providerCap = providerSemaphore.limitFor(roleDef.model);
345
+ if (providerCap != null && providerSemaphore.inFlight(roleDef.model) >= providerCap) {
346
+ const ahead = providerSemaphore.queued(roleDef.model) + 1;
347
+ emit({ t: "queued", id: childId, model: roleDef.model, ahead, ts: Date.now() });
348
+ onUpdate?.({
349
+ content: [{ type: "text", text: `${roleKey} queued — ${providerCap} requests already in flight on this provider (${ahead} waiting)...` }],
350
+ details: { id: childId, role: roleKey, model: roleDef.model, status: "queued" },
351
+ });
352
+ }
353
+ res = await providerSemaphore.run(roleDef.model, () => {
354
+ queuedMs = Date.now() - startTime;
355
+ return spawnDamageDescendant({
356
+ model: roleDef.model,
357
+ tools: childTools,
358
+ thinking: roleDef.thinking ?? "off",
359
+ appendSystemPrompt: subagentProtocol(config.persona, roleKey, childCanDelegate, config.projectPolicy),
360
+ sessionFile: childSessionFile,
361
+ prompt,
362
+ extensions: childExtensions,
363
+ env: {
364
+ AGENT_HUB_DELEGATE_CONFIG: childConfig ? JSON.stringify(childConfig) : "",
365
+ ...(boundedOutputDir ? { [BOUNDED_OUTPUT_DIR_ENV]: boundedOutputDir } : {}),
366
+ ...(config.deterministicTools && config.filesystemSessionDir ? { [FILESYSTEM_SESSION_DIR_ENV]: config.filesystemSessionDir } : {}),
367
+ },
368
+ ...(boundedOutputDir ? { boundedOutputDir } : {}),
369
+ cwd: config.cwd,
370
+ // Each nested child owns its group. The SIGTERM trap above forwards
371
+ // parent cancellation so detached children cannot become orphans.
372
+ detached: true,
373
+ signal,
374
+ // `null` is the explicit `off` override; preserve it rather than
375
+ // silently restoring the default for terminal children.
376
+ toolWatchdog: { timeoutMs: config.reconSearchTimeoutMs === undefined ? 120_000 : config.reconSearchTimeoutMs },
377
+ // Whole-run bound from the hub's mode budget: a hung delegate (the
378
+ // 92-minute conventions scout) must not hold its parent hostage.
379
+ turnDeadlineMs: config.turnDeadlineMs === undefined ? null : config.turnDeadlineMs,
380
+ }, roleDef.fallbackModel, {
381
+ onProcess: (p) => {
382
+ if (childProc) liveChildren.delete(childProc);
383
+ childProc = p;
384
+ liveChildren.add(p);
385
+ },
386
+ onModelFallback: (notice) => {
387
+ emit({ t: "model_fallback", id: childId, ...notice, ts: Date.now() });
388
+ onUpdate?.({
389
+ content: [{ type: "text", text: `Override ${notice.from} failed before work began; retrying ${roleKey} with ${notice.to}...` }],
390
+ details: { id: childId, role: roleKey, model: notice.to, fallback: notice, status: "running" },
391
+ });
392
+ },
393
+ onTextDelta: (delta) => queueDelta("text", delta),
394
+ onThinkingDelta: (delta) => queueDelta("thinking", delta),
395
+ onToolStart: (toolName, argStr, callId) => {
396
+ flushTimeline();
397
+ emit({ t: "tool_start", id: childId, name: toolName, args: argStr, callId, ts: Date.now() });
398
+ },
399
+ onToolEnd: (toolName, callId, isError, resultText, durationMs) => {
400
+ flushTimeline();
401
+ emit({ t: "tool_result", id: childId, name: toolName, output: resultText ?? "", callId, isError: isError === true, durationMs, ts: Date.now() });
402
+ },
403
+ onUsage: (usage, source) => {
404
+ if (source === "message_end") {
405
+ emit({ t: "usage", id: childId, input: usage.input ?? null, output: usage.output ?? null, cacheRead:usage.cacheRead??null,cacheWrite:usage.cacheWrite??null,contextWindow:usage.contextWindow??null });
406
+ }
407
+ },
408
+ }, {
409
+ // A child holding only read tools can be re-run safely, so a
410
+ // provider dying halfway through is recoverable rather than a
411
+ // discarded run. A write-capable child keeps the strict rule:
412
+ // a retry there could duplicate edits. A child that can delegate
413
+ // carries `delegate` in its tool list and so reads as non-read-only
414
+ // here — deliberately: retrying it would re-spawn its grandchildren.
415
+ midRun: isReadOnlyToolList(childTools),
416
+ }, {
417
+ childId, task: instruction, query: JSON.stringify([instruction, brief ?? ""]),
418
+ admit: () => !signal.aborted && config.roles[roleKey] === roleDef && config.depth > childDepth,
419
+ });
420
+ });
421
+ } finally {
422
+ liveCount--;
423
+ clearInterval(flushTimer);
424
+ if (childProc) liveChildren.delete(childProc);
425
+ }
426
+
427
+ flushTimeline();
428
+ const elapsed = Date.now() - startTime;
429
+ const code = res.spawnError ? 1 : (res.termination ? (res.termination.reason === "cancelled" ? 130 : res.termination.reason === "drift_stop" ? 125 : 124) : (res.exitCode ?? 1));
430
+ emit({ t: "exit", id: childId, code, elapsed, ...(queuedMs > 0 ? { queuedMs } : {}), termination: res.termination, ts: Date.now() });
431
+
432
+ if (res.spawnError) {
433
+ const spawnFailure = `Delegate ${childId} failed to spawn: ${res.spawnError}`;
434
+ try { writeFileSync(childResultFile, spawnFailure + "\n", "utf-8"); } catch {}
435
+ return {
436
+ content: [{ type: "text" as const, text: `${spawnFailure}\n\nFull output: ${childResultFile}` }],
437
+ details: { id: childId, role: roleKey, status: "error", resultPath: childResultFile },
438
+ };
439
+ }
440
+
441
+ let output = res.output;
442
+ if (res.termination) {
443
+ const reason = res.termination.reason;
444
+ const tool = res.termination.tool;
445
+ const explanation = reason === "tool_timeout"
446
+ ? `exceeded its per-tool watchdog on ${tool?.toolName || "tool"} (${tool?.toolCallId || "unknown"})`
447
+ : reason === "turn_timeout"
448
+ ? "exceeded the per-run deadline (mode budget / agent-turn-timeout-s)"
449
+ : reason === "drift_stop"
450
+ ? "was stopped by the drift watchdog"
451
+ : "was cancelled by its caller";
452
+ output = `${reason}: delegate ${childId} ${explanation}; terminationConfirmed=${res.termination.confirmed}.`;
453
+ } else if (code !== 0) {
454
+ const errTail = res.stderr.trim().slice(-1000);
455
+ output = output
456
+ ? `${output}\n\n[stderr]\n${errTail}`
457
+ : `Delegate ${childId} exited with code ${code} and produced no output.\n\n[stderr]\n${errTail}`;
458
+ }
459
+ try { writeFileSync(childResultFile, output, "utf-8"); } catch {}
460
+ const digest = childResultDigest(output, childResultFile);
461
+
462
+ const notes: string[] = [];
463
+ if (writeDowngraded) notes.push("allow_write ignored — other children were live, so it ran read-only");
464
+ if (mode === "fork") notes.push("context: fork is not supported in v1 — the child started fresh from your instruction");
465
+ const noteBlock = notes.length > 0 ? `\n[note: ${notes.join("; ")}]` : "";
466
+
467
+ const fallbackNote = res.modelFallback
468
+ ? `\n[note: overridden model ${res.modelFallback.from} failed before work; retried once with original ${res.modelFallback.to}]`
469
+ : "";
470
+ return {
471
+ content: [{ type: "text" as const, text:
472
+ `[delegate ${childId} · ${res.modelUsed} · ${effectiveTools}] ${res.termination ? res.termination.reason : code === 0 ? "done" : "error"} ` +
473
+ `in ${Math.round(elapsed / 1000)}s${noteBlock}${fallbackNote}\n\n${digest.text}` }],
474
+ details: { id: childId, role: roleKey, model: res.modelUsed, fallback: res.modelFallback, status: res.termination ? res.termination.reason : code === 0 ? "done" : "error", elapsed, resultPath: childResultFile, digestFound: digest.hasDigest, termination: res.termination },
475
+ };
476
+ },
477
+ });
478
+ }
@@ -0,0 +1,195 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { closeSync, copyFileSync, existsSync, fstatSync, lstatSync, mkdirSync, openSync, readSync, readdirSync, realpathSync, statSync, writeFileSync, type BigIntStats } from "node:fs";
3
+ import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
4
+ import { decodeDeterministicHandle } from "../lib/deterministic-handle-path.ts";
5
+ export { deterministicHandlePath } from "../lib/deterministic-handle-path.ts";
6
+
7
+ export const INVENTORY_PAGE_ENTRIES = 500;
8
+ export const CONTENT_REPLY_BYTES = 64 * 1024;
9
+ export const PREVIEW_CHARS = 180;
10
+
11
+ type Handle = { v: 1; kind: "file" | "inventory"; path: string; hash: string; offset: number };
12
+ export class PathOutsideAllowedRootError extends Error {}
13
+ const sha256 = (bytes: Buffer | string) => createHash("sha256").update(bytes).digest("hex");
14
+ const within = (root: string, target: string) => { const rel = relative(resolve(root), resolve(target)); return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel)); };
15
+ const encode = (value: Handle) => `t5:${Buffer.from(JSON.stringify(value)).toString("base64url")}`;
16
+ const decode = decodeDeterministicHandle;
17
+ function checkedExisting(path: string, allowedRoot = dirname(resolve(path))): string {
18
+ const lexical = resolve(path), root = resolve(allowedRoot);
19
+ if (!within(root, lexical)) throw new PathOutsideAllowedRootError(`Path outside allowed root: ${path}`);
20
+ let cursor = lexical;
21
+ while (!existsSync(cursor) && dirname(cursor) !== cursor) cursor = dirname(cursor);
22
+ const rootReal = realpathSync(root), cursorReal = realpathSync(cursor);
23
+ if (!within(rootReal, cursorReal)) throw new Error(`Symlink escape outside allowed root: ${path}`);
24
+ return lexical;
25
+ }
26
+ // Paging through a large file must not rehash it, or rescan it for a line number, on
27
+ // every page. A digest is reused only for the same device, inode, size and nanosecond
28
+ // mtime/ctime, and never for a file changed within the last two seconds: a coarse
29
+ // filesystem clock could not yet distinguish a same-size rewrite there.
30
+ const DIGEST_ENTRIES = 64, LINE_MARKS = 256, SETTLED_MS = 2_000;
31
+ const digests = new Map<string, { hash: string; lines: Map<number, number> }>();
32
+ export function digestCacheKey(stat: Pick<BigIntStats, "dev" | "ino" | "size" | "mtimeNs" | "ctimeNs">, now = Date.now()): string | null {
33
+ const changedMs = Number((stat.mtimeNs > stat.ctimeNs ? stat.mtimeNs : stat.ctimeNs) / 1_000_000n);
34
+ return now - changedMs > SETTLED_MS ? `${stat.dev}:${stat.ino}:${stat.size}:${stat.mtimeNs}:${stat.ctimeNs}` : null;
35
+ }
36
+ function hashAndSize(path: string): { size: number; hash: string; key: string | null } {
37
+ const fd = openSync(path, "r");
38
+ try {
39
+ const stat = fstatSync(fd, { bigint: true }), size = Number(stat.size), key = digestCacheKey(stat);
40
+ const cached = key ? digests.get(key) : undefined;
41
+ if (cached) { digests.delete(key!); digests.set(key!, cached); return { size, hash: cached.hash, key }; }
42
+ const hash = createHash("sha256"), chunk = Buffer.alloc(64 * 1024);
43
+ let offset = 0;
44
+ while (offset < size) {
45
+ const n = readSync(fd, chunk, 0, Math.min(chunk.length, size - offset), offset);
46
+ if (n <= 0) break;
47
+ hash.update(chunk.subarray(0, n));
48
+ offset += n;
49
+ }
50
+ const digest = hash.digest("hex");
51
+ if (key) { digests.set(key, { hash: digest, lines: new Map() }); if (digests.size > DIGEST_ENTRIES) digests.delete(digests.keys().next().value!); }
52
+ return { size, hash: digest, key };
53
+ } finally { closeSync(fd); }
54
+ }
55
+ function markLine(key: string | null, offset: number, line: number) {
56
+ const marks = key ? digests.get(key)?.lines : undefined;
57
+ if (!marks || marks.has(offset)) return;
58
+ marks.set(offset, line); if (marks.size > LINE_MARKS) marks.delete(marks.keys().next().value!);
59
+ }
60
+ function readWindow(path: string, offset: number, length: number): Buffer {
61
+ const fd = openSync(path, "r");
62
+ try {
63
+ const buf = Buffer.alloc(length);
64
+ let filled = 0;
65
+ while (filled < length) {
66
+ const n = readSync(fd, buf, filled, length - filled, offset + filled);
67
+ if (n <= 0) break;
68
+ filled += n;
69
+ }
70
+ return buf.subarray(0, filled);
71
+ } finally { closeSync(fd); }
72
+ }
73
+ function lineAtFile(path: string, offset: number, key: string | null = null): number {
74
+ if (offset <= 0) return 1;
75
+ let seen = 0, lines = 1;
76
+ for (const [at, line] of (key ? digests.get(key)?.lines : undefined) ?? []) if (at <= offset && at > seen) { seen = at; lines = line; }
77
+ if (seen === offset) return lines;
78
+ const fd = openSync(path, "r");
79
+ try {
80
+ const chunk = Buffer.alloc(64 * 1024);
81
+ while (seen < offset) {
82
+ const n = readSync(fd, chunk, 0, Math.min(chunk.length, offset - seen), seen);
83
+ if (n <= 0) break;
84
+ for (let i = 0; i < n; i++) if (chunk[i] === 10) lines++;
85
+ seen += n;
86
+ }
87
+ markLine(key, offset, lines);
88
+ return lines;
89
+ } finally { closeSync(fd); }
90
+ }
91
+ const newlines = (bytes: Buffer) => { let count = 0; for (let index = bytes.indexOf(10); index >= 0; index = bytes.indexOf(10, index + 1)) count++; return count; };
92
+ function fileState(path: string, allowedRoot?: string) {
93
+ const checked = checkedExisting(path, allowedRoot);
94
+ if (!existsSync(checked) || !statSync(checked).isFile()) throw new Error(`Not a regular file: ${path}`);
95
+ return { path: checked, ...hashAndSize(checked) };
96
+ }
97
+ function directoryState(root: string, authorizePath?: (path: string) => void) {
98
+ const checked = checkedExisting(root, root);
99
+ if (!statSync(checked).isDirectory()) throw new Error(`Not a directory: ${root}`);
100
+ const rootReal = realpathSync(checked);
101
+ const entries = readdirSync(checked, { withFileTypes: true }).filter(entry => {
102
+ if (!authorizePath) return true;
103
+ try { authorizePath(join(checked, entry.name)); return true; } catch { return false; }
104
+ }).sort((a, b) => a.name.localeCompare(b.name)).map(entry => {
105
+ const path = join(checked, entry.name), lst = lstatSync(path);
106
+ if (lst.isSymbolicLink()) {
107
+ try {
108
+ if (!within(rootReal, realpathSync(path))) return { name: entry.name, path, type: "symlink", bytes: null, denied: true, reason: "symlink-target-outside-root" };
109
+ } catch {
110
+ return { name: entry.name, path, type: "symlink", bytes: null, denied: true, reason: "symlink-target-unavailable" };
111
+ }
112
+ }
113
+ return { name: entry.name, path, type: entry.isDirectory() ? "directory" : entry.isFile() ? "file" : entry.isSymbolicLink() ? "symlink" : "other", bytes: entry.isFile() ? lst.size : null };
114
+ });
115
+ return { root: checked, entries, hash: sha256(JSON.stringify(entries)) };
116
+ }
117
+ function utf8Preview(bytes: Buffer, chars = PREVIEW_CHARS): string {
118
+ return [...bytes.toString("utf8")].slice(0, chars).join("");
119
+ }
120
+ export function inventory(input: { root: string; handle?: string; pageSize?: number; boundedOutput?: boolean; followSymlinkEscape?: boolean; authorizePath?: (path: string) => void }) {
121
+ if (input.followSymlinkEscape) throw new Error("Symlink escape following is forbidden");
122
+ const state = directoryState(input.root, input.authorizePath);
123
+ let offset = 0;
124
+ if (input.handle) {
125
+ const handle = decode(input.handle);
126
+ if (handle.kind !== "inventory" || resolve(handle.path) !== state.root || handle.hash !== state.hash) throw new Error("Stale inventory handle");
127
+ offset = handle.offset;
128
+ }
129
+ const requested = input.pageSize ?? INVENTORY_PAGE_ENTRIES;
130
+ const pageSize = input.boundedOutput === false ? requested : Math.min(requested, INVENTORY_PAGE_ENTRIES);
131
+ const entries = state.entries.slice(offset, offset + pageSize), nextOffset = offset + entries.length;
132
+ const nextHandle = nextOffset < state.entries.length ? encode({ v: 1, kind: "inventory", path: state.root, hash: state.hash, offset: nextOffset }) : null;
133
+ return { root: state.root, totalEntries: state.entries.length, entries, handle: input.handle ?? encode({ v: 1, kind: "inventory", path: state.root, hash: state.hash, offset }), nextHandle, truncated: nextHandle !== null, untrusted: true, modelDelegated: false };
134
+ }
135
+
136
+ export function excerpt(input: { path: string; allowedRoot?: string; handle?: string; offset?: number; maxBytes?: number; previewChars?: number; boundedOutput?: boolean }) {
137
+ const state = fileState(input.path, input.allowedRoot);
138
+ let offset = input.offset ?? 0;
139
+ if (input.handle) {
140
+ const handle = decode(input.handle);
141
+ if (handle.kind !== "file" || resolve(handle.path) !== state.path || handle.hash !== state.hash) throw new Error("Stale file handle");
142
+ offset = handle.offset;
143
+ }
144
+ if (!Number.isSafeInteger(offset) || offset < 0 || offset > state.size) throw new Error("Invalid excerpt offset");
145
+ const requested = input.maxBytes ?? (input.boundedOutput === false ? state.size : CONTENT_REPLY_BYTES);
146
+ const maxBytes = input.boundedOutput === false ? requested : Math.min(requested, CONTENT_REPLY_BYTES);
147
+ const content = readWindow(state.path, offset, Math.min(maxBytes, state.size - offset));
148
+ const nextOffset = offset + content.length, nextHandle = nextOffset < state.size ? encode({ v: 1, kind: "file", path: state.path, hash: state.hash, offset: nextOffset }) : null;
149
+ const line = lineAtFile(state.path, offset, state.key);
150
+ if (nextHandle) markLine(state.key, nextOffset, line + newlines(content));
151
+ return { path: state.path, reference: `${state.path}:${line}`, hash: state.hash, offset, content: Buffer.from(content), contentBytes: content.length, totalBytes: state.size, preview: utf8Preview(content, Math.min(input.previewChars ?? PREVIEW_CHARS, PREVIEW_CHARS)), onDiskHandle: encode({ v: 1, kind: "file", path: state.path, hash: state.hash, offset }), nextHandle, truncated: nextHandle !== null, untrusted: true, modelDelegated: false };
152
+ }
153
+
154
+ export function readback(input: { handle: string; expectedHash?: string; allowedRoot?: string; maxBytes?: number; boundedOutput?: boolean }) {
155
+ const handle = decode(input.handle);
156
+ if (handle.kind !== "file") throw new Error("Readback requires a file handle");
157
+ const state = fileState(handle.path, input.allowedRoot);
158
+ if (state.hash !== handle.hash || (input.expectedHash && state.hash !== input.expectedHash)) throw new Error("Stale file handle: source bytes changed");
159
+ return excerpt({ path: state.path, allowedRoot: input.allowedRoot, offset: handle.offset, maxBytes: input.maxBytes, boundedOutput: input.boundedOutput });
160
+ }
161
+
162
+ export function snapshotSource(input: { origin: "file"; path: string; allowedRoot?: string; sessionDir?: string }) {
163
+ if (input.origin !== "file") throw new Error(`Unsupported origin ${String(input.origin)}: snapshots accept local files only and never fetch the network`);
164
+ const state = fileState(input.path, input.allowedRoot);
165
+ const sessionDir = resolve(input.sessionDir ?? join(dirname(state.path), ".snapshots"));
166
+ mkdirSync(sessionDir, { recursive: true, mode: 0o700 });
167
+ const root = checkedExisting(sessionDir, sessionDir);
168
+ const dir = join(root, "artifacts", "evidence", "snapshots"); mkdirSync(dir, { recursive: true, mode: 0o700 }); checkedExisting(dir, root);
169
+ const contentPath = join(dir, `${state.hash}-${basename(state.path)}`);
170
+ if (!existsSync(contentPath)) copyFileSync(state.path, contentPath);
171
+ else {
172
+ const existing = fileState(contentPath, root);
173
+ if (existing.hash !== state.hash) throw new Error(`Snapshot collision or stale target: ${contentPath}`);
174
+ }
175
+ const metadataPath = `${contentPath}.json`;
176
+ if (!existsSync(metadataPath)) writeFileSync(metadataPath, JSON.stringify({ source: { origin: "file", path: state.path, bytes: state.size }, sha256: state.hash, contentPath, untrusted: true, modelDelegated: false }, null, 2), { mode: 0o600 });
177
+ else checkedExisting(metadataPath, root);
178
+ return { source: { origin: "file" as const, path: state.path, bytes: state.size }, hash: state.hash, contentPath, metadataPath, handle: encode({ v: 1, kind: "file", path: contentPath, hash: state.hash, offset: 0 }), untrusted: true, modelDelegated: false };
179
+ }
180
+
181
+ function utf8Prefix(buffer: Buffer, maxBytes: number): Buffer {
182
+ let end = Math.min(maxBytes, buffer.length);
183
+ while (end > 0 && (buffer[end] & 0xc0) === 0x80) end--;
184
+ return buffer.subarray(0, end);
185
+ }
186
+ export function boundOutput(input: { content: string | Buffer; retentionDir: string; label?: string }) {
187
+ const bytes = Buffer.isBuffer(input.content) ? input.content : Buffer.from(input.content, "utf8");
188
+ const dir = resolve(input.retentionDir); mkdirSync(dir, { recursive: true, mode: 0o700 });
189
+ const hash = sha256(bytes), contentPath = join(dir, `${input.label ?? "output"}-${randomUUID()}`); writeFileSync(contentPath, bytes, { mode: 0o600 });
190
+ const handle = encode({ v: 1, kind: "file", path: contentPath, hash, offset: 0 });
191
+ if (bytes.length <= CONTENT_REPLY_BYTES) return { reply: bytes.toString("utf8"), contentPath, handle, hash, totalBytes: bytes.length, truncated: false };
192
+ const suffix = Buffer.from(`\n\n[truncated: ${bytes.length} bytes total; full output handle ${handle}; path ${contentPath}]`, "utf8");
193
+ const prefix = utf8Prefix(bytes, CONTENT_REPLY_BYTES - suffix.length);
194
+ return { reply: Buffer.concat([prefix, suffix]).toString("utf8"), contentPath, handle, hash, totalBytes: bytes.length, truncated: true };
195
+ }