@chankov/agent-fleet 2.0.10 → 2.0.11

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 (531) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +26 -8
  2. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
  3. package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  4. package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
  5. package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  6. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
  7. package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
  8. package/.pi/harnesses/agent-hub/README.md +53 -18
  9. package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
  10. package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
  11. package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  12. package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  13. package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
  14. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
  15. package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  17. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  18. package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
  19. package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
  20. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
  21. package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
  22. package/.pi/harnesses/agent-hub/delegate.ts +19 -2
  23. package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  24. package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  25. package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  26. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
  27. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
  28. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
  29. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
  30. package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
  31. package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  32. package/.pi/harnesses/agent-hub/helpers.ts +5 -1
  33. package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
  34. package/.pi/harnesses/agent-hub/index.ts +145 -14
  35. package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
  36. package/.pi/harnesses/agent-hub/package.json +1 -1
  37. package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
  38. package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  39. package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
  40. package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
  41. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
  42. package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  43. package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
  44. package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
  45. package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  46. package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  47. package/.pi/harnesses/agent-hub/spawn.ts +61 -7
  48. package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  49. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  50. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  51. package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  52. package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
  53. package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
  54. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  55. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +176 -26
  56. package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  57. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
  58. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
  59. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
  60. package/.pi/harnesses/agent-hub/types.ts +2 -0
  61. package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  62. package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
  63. package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  64. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
  65. package/.pi/harnesses/coms/package.json +1 -1
  66. package/.pi/harnesses/damage-control-continue/index.ts +9 -0
  67. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  68. package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  69. package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
  70. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  71. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  72. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  73. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  74. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  75. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  76. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  77. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  78. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  79. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  80. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  81. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  82. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  83. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  84. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  85. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  86. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  87. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  88. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  89. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  90. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  91. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  92. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  93. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  94. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  95. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  96. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  97. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  98. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  99. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  100. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  101. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  102. package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  103. package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  104. package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  105. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  106. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  107. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  108. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  109. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  110. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
  111. package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
  112. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  113. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  114. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  115. package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  116. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  117. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  118. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  119. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  120. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  121. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  122. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  123. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  124. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  125. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  126. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  127. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  128. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  129. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  130. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  131. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  132. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  133. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  134. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  135. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  136. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  137. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  138. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  139. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  140. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  141. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  142. package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
  143. package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
  144. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  145. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  146. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  147. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
  148. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  149. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  150. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  151. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  152. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  153. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  154. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  155. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  156. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  157. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  158. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  159. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  160. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  161. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  162. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  163. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  164. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  165. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  166. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  167. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  168. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  169. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  170. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  171. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  172. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  173. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  174. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  175. package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  176. package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
  177. package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
  178. package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
  179. package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
  180. package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
  181. package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
  182. package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
  183. package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
  184. package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
  185. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  186. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  187. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  188. package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  189. package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  190. package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  191. package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  192. package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  193. package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  194. package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
  195. package/.versions/2.0.11/.pi/extensions/package.json +9 -0
  196. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
  197. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  198. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  199. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  200. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  201. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  202. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  203. package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
  204. package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  205. package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  206. package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  207. package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  208. package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  209. package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  210. package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  211. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  212. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
  213. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  214. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
  215. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  216. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  217. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  218. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  219. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  220. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  221. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  222. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  223. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  224. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  225. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  226. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  227. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  228. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  229. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  230. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  231. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
  232. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  233. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  234. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  235. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  236. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  237. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  238. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  239. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  240. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  241. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  242. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  243. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  244. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  245. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  246. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  247. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  248. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  249. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  250. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  251. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  252. package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  253. package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
  254. package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  255. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  256. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  257. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  258. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  259. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
  260. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  261. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
  262. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
  263. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  264. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  265. package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  266. package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  267. package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  268. package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  269. package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  270. package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  271. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
  272. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  276. package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
  277. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  278. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  279. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  280. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  281. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  282. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  283. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  284. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  285. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  286. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  287. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  288. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  289. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  290. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  291. package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
  292. package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  293. package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  294. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  295. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  296. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  297. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  298. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  299. package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  300. package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
  301. package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  302. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  303. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  304. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  305. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  306. package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  307. package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  308. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  309. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  310. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  311. package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  312. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
  313. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  314. package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  315. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
  316. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  317. package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  318. package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  319. package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  320. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  321. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  322. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
  323. package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
  324. package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  325. package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
  326. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  327. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  328. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  329. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  330. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  331. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  332. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  333. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
  334. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  335. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  336. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  337. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  338. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  339. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  340. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  341. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  342. package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
  343. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  344. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  345. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  346. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  347. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  348. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  349. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  350. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  351. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  352. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  353. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  354. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  355. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  356. package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  357. package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  358. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  359. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  360. package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  361. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
  362. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
  363. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  364. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  365. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  366. package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
  367. package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
  368. package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
  369. package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
  370. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
  371. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
  372. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  373. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  374. package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  375. package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
  376. package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
  377. package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  378. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  379. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  380. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
  381. package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
  382. package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  383. package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  384. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  385. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  386. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  387. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  388. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  389. package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  390. package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  391. package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
  392. package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  393. package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
  394. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  395. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  396. package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  397. package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  398. package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  399. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  400. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  401. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  402. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  403. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  404. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  405. package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  406. package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
  407. package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
  408. package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
  409. package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
  410. package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
  411. package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
  412. package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
  413. package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
  414. package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  415. package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  416. package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
  417. package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
  418. package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
  419. package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
  420. package/.versions/2.0.11/.version +1 -0
  421. package/.versions/2.0.11/agents/architect.md +25 -0
  422. package/.versions/2.0.11/agents/bowser.md +28 -0
  423. package/.versions/2.0.11/agents/builder.md +56 -0
  424. package/.versions/2.0.11/agents/code-reviewer.md +210 -0
  425. package/.versions/2.0.11/agents/deep-researcher.md +33 -0
  426. package/.versions/2.0.11/agents/documenter.md +23 -0
  427. package/.versions/2.0.11/agents/orchestrator.md +23 -0
  428. package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
  429. package/.versions/2.0.11/agents/planner.md +106 -0
  430. package/.versions/2.0.11/agents/releaser.md +25 -0
  431. package/.versions/2.0.11/agents/researcher.md +31 -0
  432. package/.versions/2.0.11/agents/security-auditor.md +168 -0
  433. package/.versions/2.0.11/agents/test-engineer.md +154 -0
  434. package/.versions/2.0.11/agents/web-debugger.md +44 -0
  435. package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
  436. package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
  437. package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
  438. package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
  439. package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
  440. package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
  441. package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
  442. package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
  443. package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
  444. package/.versions/2.0.11/docs/getting-started.md +126 -0
  445. package/.versions/2.0.11/docs/npm-install.md +383 -0
  446. package/.versions/2.0.11/docs/pi-extensions.md +449 -0
  447. package/.versions/2.0.11/docs/pi-setup.md +92 -0
  448. package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
  449. package/.versions/2.0.11/install-manifest.json +3020 -0
  450. package/.versions/2.0.11/justfile +247 -0
  451. package/.versions/2.0.11/manifest-meta.json +970 -0
  452. package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
  453. package/.versions/2.0.11/references/communication-contract.md +26 -0
  454. package/.versions/2.0.11/references/definition-of-done.md +67 -0
  455. package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
  456. package/.versions/2.0.11/references/observability-checklist.md +92 -0
  457. package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
  458. package/.versions/2.0.11/references/performance-checklist.md +236 -0
  459. package/.versions/2.0.11/references/prompting-patterns.md +380 -0
  460. package/.versions/2.0.11/references/security-checklist.md +245 -0
  461. package/.versions/2.0.11/references/testing-patterns.md +235 -0
  462. package/.versions/2.0.11/references/workflow-authoring.md +304 -0
  463. package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
  464. package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  465. package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
  466. package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
  467. package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
  468. package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
  469. package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
  470. package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
  471. package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
  472. package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  473. package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
  474. package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  475. package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  476. package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  477. package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
  478. package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
  479. package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
  480. package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  481. package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  482. package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
  483. package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
  484. package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
  485. package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
  486. package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
  487. package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
  488. package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
  489. package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
  490. package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
  491. package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  492. package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
  493. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  494. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  495. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  496. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  497. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  498. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  499. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  500. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  501. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  502. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  503. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  504. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  505. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  506. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  507. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  508. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  509. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  510. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  511. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  512. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  513. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  514. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  515. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  516. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  517. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  518. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  519. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  520. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  521. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  522. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  523. package/CHANGELOG.md +8 -0
  524. package/README.md +1 -0
  525. package/bin/catalog/harness-runtime-closure.json +29 -0
  526. package/bin/cli.js +15 -4
  527. package/bin/lib/doctor.js +83 -1
  528. package/docs/ARCHITECTURE.md +181 -2
  529. package/docs/workflows.md +8 -2
  530. package/install-manifest.json +31 -2
  531. package/package.json +2 -2
@@ -0,0 +1,178 @@
1
+ import { closeSync, existsSync, fsyncSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
2
+ import { basename, dirname, join } from "node:path";
3
+ import { randomUUID } from "node:crypto";
4
+
5
+ export const COMPLETION_SERIES_BUDGET_SCHEMA = "agent-fleet.completion-series-budget/v2" as const;
6
+ export const COMPLETION_SERIES_BUDGET_V1_SCHEMA = "agent-fleet.completion-series-budget/v1" as const;
7
+ export const COMPLETION_SERIES_LOCK_SCHEMA = "agent-fleet.completion-series-lock/v1" as const;
8
+ export type CompletionSeriesStage = "diagnostic" | "benchmark";
9
+
10
+ export interface CompletionSeriesLimits {
11
+ seriesRequestLimit: 60;
12
+ stageRequestLimits: { diagnostic: 12; benchmark: 48 };
13
+ inputTokensPerRequest: 16384;
14
+ outputTokensPerRequest: 2048;
15
+ requestTimeoutMs: 180000;
16
+ maxActiveRequests: 1;
17
+ maxRequestsPerUnit: { diagnostic: 2; benchmark: 4 };
18
+ autoRetry: false;
19
+ fallback: false;
20
+ }
21
+ export interface CompletionReservation {
22
+ sequence: number; stage: CompletionSeriesStage; startedAt: string;
23
+ }
24
+ export interface CompletionSeriesState {
25
+ schema: typeof COMPLETION_SERIES_BUDGET_SCHEMA;
26
+ seriesId: string;
27
+ seriesRequestsStarted: number;
28
+ stages: { diagnostic: { requestsStarted: number }; benchmark: { requestsStarted: number } };
29
+ reservationHistory: CompletionReservation[];
30
+ cancelled: boolean;
31
+ limits: CompletionSeriesLimits;
32
+ }
33
+ export interface CompletionSeriesLock {
34
+ schema: typeof COMPLETION_SERIES_LOCK_SCHEMA; ownerId: string; pid: number; acquiredAt: string;
35
+ }
36
+ export interface CountingProvenance {
37
+ method: "serialized-provider-payload-utf8-bytes-times-2-plus-1024/v1";
38
+ count: number; serializedBytes: number; multiplier: 2; reservedTokens: 1024;
39
+ unit: "conservative-token-upper-bound"; cap: number; textOnly: true;
40
+ }
41
+
42
+ export class CompletionBudgetRefusal extends Error {
43
+ readonly reason: "cancelled" | "series-exhausted" | "stage-exhausted" | "probe-exhausted" | "lock-not-owned";
44
+ constructor(reason: CompletionBudgetRefusal["reason"], message: string) { super(message); this.name = "CompletionBudgetRefusal"; this.reason = reason; }
45
+ }
46
+ export class CompletionSeriesBusyError extends Error { constructor(message = "completion series is busy in another process") { super(message); this.name = "CompletionSeriesBusyError"; } }
47
+
48
+ export const T12_SERIES_LIMITS: CompletionSeriesLimits = Object.freeze({
49
+ seriesRequestLimit: 60,
50
+ stageRequestLimits: Object.freeze({ diagnostic: 12, benchmark: 48 }),
51
+ inputTokensPerRequest: 16384,
52
+ outputTokensPerRequest: 2048,
53
+ requestTimeoutMs: 180_000,
54
+ maxActiveRequests: 1,
55
+ maxRequestsPerUnit: Object.freeze({ diagnostic: 2, benchmark: 4 }),
56
+ autoRetry: false,
57
+ fallback: false,
58
+ });
59
+
60
+ export function sharedCompletionSeriesBudgetPath(sessionDir: string, seriesId: string): string {
61
+ if (!/^[A-Za-z0-9._-]{1,80}$/.test(seriesId)) throw new Error("invalid completion series identity");
62
+ const sessionsDir = dirname(sessionDir);
63
+ if (basename(sessionsDir) !== "sessions") throw new Error("managed session path is not under the runtime sessions directory");
64
+ return join(dirname(sessionsDir), "series", `${seriesId}-budget.json`);
65
+ }
66
+ export function completionSeriesLockPath(budgetPath: string): string { return `${budgetPath}.lock`; }
67
+ export function createCompletionSeriesState(seriesId: string, limits: CompletionSeriesLimits = T12_SERIES_LIMITS): CompletionSeriesState {
68
+ if (!seriesId.trim()) throw new Error("seriesId is required");
69
+ return { schema: COMPLETION_SERIES_BUDGET_SCHEMA, seriesId, seriesRequestsStarted: 0, stages: { diagnostic: { requestsStarted: 0 }, benchmark: { requestsStarted: 0 } }, reservationHistory: [], cancelled: false, limits: structuredClone(limits) };
70
+ }
71
+ function isStage(value: unknown): value is CompletionSeriesStage { return value === "diagnostic" || value === "benchmark"; }
72
+ function safeCount(value: unknown): value is number { return Number.isSafeInteger(value) && Number(value) >= 0; }
73
+ function validateV2(value: any): CompletionSeriesState {
74
+ if (value?.schema !== COMPLETION_SERIES_BUDGET_SCHEMA || typeof value.seriesId !== "string" || !safeCount(value.seriesRequestsStarted)
75
+ || !safeCount(value?.stages?.diagnostic?.requestsStarted) || !safeCount(value?.stages?.benchmark?.requestsStarted)
76
+ || !Array.isArray(value.reservationHistory) || typeof value.cancelled !== "boolean") throw new Error("invalid completion-series budget state");
77
+ if (value.stages.diagnostic.requestsStarted + value.stages.benchmark.requestsStarted !== value.seriesRequestsStarted) throw new Error("completion-series counters do not reconcile");
78
+ if (value.reservationHistory.length !== value.seriesRequestsStarted || value.reservationHistory.some((entry: any, index: number) => entry?.sequence !== index + 1 || !isStage(entry?.stage) || typeof entry?.startedAt !== "string")) throw new Error("completion-series reservation history does not reconcile");
79
+ return value;
80
+ }
81
+ export function readCompletionSeriesState(path: string): CompletionSeriesState {
82
+ return validateV2(JSON.parse(readFileSync(path, "utf8")));
83
+ }
84
+
85
+ /**
86
+ * Migrate only when every consumed request has explicit stage provenance.
87
+ * Old zero-use ledgers are unambiguous; nonzero aggregate-only v1 ledgers fail closed.
88
+ */
89
+ export function migrateCompletionSeriesBudget(path: string): CompletionSeriesState {
90
+ const raw = JSON.parse(readFileSync(path, "utf8"));
91
+ if (raw?.schema === COMPLETION_SERIES_BUDGET_SCHEMA) return validateV2(raw);
92
+ if (raw?.schema !== COMPLETION_SERIES_BUDGET_V1_SCHEMA || typeof raw.seriesId !== "string" || !safeCount(raw.seriesRequestsStarted) || !safeCount(raw.stageRequestsStarted)) throw new Error("invalid completion-series budget state");
93
+ const history = Array.isArray(raw.reservationHistory) ? raw.reservationHistory : [];
94
+ if (raw.seriesRequestsStarted !== raw.stageRequestsStarted) throw new Error("ambiguous v1 completion-series allocation; refusing migration");
95
+ if (raw.seriesRequestsStarted > 0 && (history.length !== raw.seriesRequestsStarted || history.some((entry: any) => !isStage(entry?.stage) || typeof entry?.startedAt !== "string"))) throw new Error("ambiguous v1 completion-series allocation; refusing migration");
96
+ const migrated = createCompletionSeriesState(raw.seriesId);
97
+ migrated.cancelled = raw.cancelled === true;
98
+ for (const [index, entry] of history.entries()) {
99
+ const stage = entry.stage as CompletionSeriesStage;
100
+ migrated.seriesRequestsStarted++;
101
+ migrated.stages[stage].requestsStarted++;
102
+ migrated.reservationHistory.push({ sequence: index + 1, stage, startedAt: entry.startedAt });
103
+ }
104
+ writeCompletionSeriesState(path, migrated);
105
+ return migrated;
106
+ }
107
+
108
+ /** Crash-safe replacement: a provider request is sent only after this durable rename completes. */
109
+ export function writeCompletionSeriesState(path: string, state: CompletionSeriesState): void {
110
+ const validated = validateV2(state);
111
+ const temporary = `${path}.tmp-${process.pid}-${randomUUID()}`;
112
+ let fd: number | undefined;
113
+ try {
114
+ fd = openSync(temporary, "wx", 0o600);
115
+ writeSync(fd, JSON.stringify(validated, null, 2)); fsyncSync(fd); closeSync(fd); fd = undefined;
116
+ renameSync(temporary, path);
117
+ try { const dirFd = openSync(dirname(path), "r"); try { fsyncSync(dirFd); } finally { closeSync(dirFd); } } catch {}
118
+ } finally { if (fd !== undefined) closeSync(fd); try { unlinkSync(temporary); } catch {} }
119
+ }
120
+
121
+ export function acquireCompletionSeriesLock(lockPath: string, ownerId = randomUUID()): CompletionSeriesLock {
122
+ const lock: CompletionSeriesLock = { schema: COMPLETION_SERIES_LOCK_SCHEMA, ownerId, pid: process.pid, acquiredAt: new Date().toISOString() };
123
+ let fd: number;
124
+ try { fd = openSync(lockPath, "wx", 0o600); }
125
+ catch (error: any) { if (error?.code === "EEXIST") throw new CompletionSeriesBusyError(); throw error; }
126
+ try { writeSync(fd, JSON.stringify(lock)); fsyncSync(fd); } catch (error) { try { unlinkSync(lockPath); } catch {} throw error; } finally { closeSync(fd); }
127
+ return lock;
128
+ }
129
+ export function readCompletionSeriesLock(lockPath: string): CompletionSeriesLock | null {
130
+ try { const value = JSON.parse(readFileSync(lockPath, "utf8")); return value?.schema === COMPLETION_SERIES_LOCK_SCHEMA && typeof value.ownerId === "string" && Number.isSafeInteger(value.pid) ? value : null; }
131
+ catch { return null; }
132
+ }
133
+ export function releaseOwnedCompletionSeriesLock(lockPath: string, ownerId: string): void {
134
+ const lock = readCompletionSeriesLock(lockPath);
135
+ if (!lock || lock.ownerId !== ownerId) throw new Error("completion-series lock ownership changed; refusing release");
136
+ unlinkSync(lockPath);
137
+ }
138
+ function processAlive(pid: number): boolean { try { process.kill(pid, 0); return true; } catch (error: any) { return error?.code !== "ESRCH"; } }
139
+ /** Human-only crash recovery. Never expires automatically and never releases a live owner. */
140
+ export function releaseCrashedCompletionSeriesLock(lockPath: string): "released" | "absent" {
141
+ if (!existsSync(lockPath)) return "absent";
142
+ const lock = readCompletionSeriesLock(lockPath);
143
+ if (lock && processAlive(lock.pid)) throw new CompletionSeriesBusyError(`completion series is owned by live pid ${lock.pid}`);
144
+ unlinkSync(lockPath); return "released";
145
+ }
146
+ function assertLockOwner(lockPath: string, ownerId: string): void {
147
+ const lock = readCompletionSeriesLock(lockPath);
148
+ if (!lock || lock.ownerId !== ownerId) throw new CompletionBudgetRefusal("lock-not-owned", "completion-series lock is not owned by this run");
149
+ }
150
+
151
+ /** Reserve durably immediately before provider transport. Failed started completions remain charged. */
152
+ export function reserveCompletionRequest(path: string, unitRequestsStarted: number, lockPath: string, ownerId: string, stage: CompletionSeriesStage): CompletionSeriesState {
153
+ assertLockOwner(lockPath, ownerId);
154
+ const state = readCompletionSeriesState(path);
155
+ if (state.cancelled) throw new CompletionBudgetRefusal("cancelled", "completion series is fenced after cancellation");
156
+ if (state.seriesRequestsStarted >= state.limits.seriesRequestLimit) throw new CompletionBudgetRefusal("series-exhausted", "whole-series provider request budget exhausted");
157
+ if (state.stages[stage].requestsStarted >= state.limits.stageRequestLimits[stage]) throw new CompletionBudgetRefusal("stage-exhausted", `${stage}-stage provider request budget exhausted`);
158
+ if (unitRequestsStarted >= state.limits.maxRequestsPerUnit[stage]) throw new CompletionBudgetRefusal("probe-exhausted", `${stage} unit provider request budget exhausted`);
159
+ const next = structuredClone(state);
160
+ next.seriesRequestsStarted++;
161
+ next.stages[stage].requestsStarted++;
162
+ next.reservationHistory.push({ sequence: next.seriesRequestsStarted, stage, startedAt: new Date().toISOString() });
163
+ writeCompletionSeriesState(path, next); return next;
164
+ }
165
+ export function fenceCompletionSeries(path: string, lockPath: string, ownerId: string): CompletionSeriesState {
166
+ assertLockOwner(lockPath, ownerId);
167
+ const state = readCompletionSeriesState(path), next = { ...state, cancelled: true };
168
+ writeCompletionSeriesState(path, next); return next;
169
+ }
170
+ export function conservativeTextInputPreflight(payload: unknown, cap: number): CountingProvenance {
171
+ const serialized = JSON.stringify(payload);
172
+ if (serialized === undefined) throw new Error("provider payload cannot be serialized for input preflight");
173
+ const serializedBytes = Buffer.byteLength(serialized, "utf8");
174
+ const count = serializedBytes * 2 + 1024;
175
+ const provenance: CountingProvenance = { method: "serialized-provider-payload-utf8-bytes-times-2-plus-1024/v1", count, serializedBytes, multiplier: 2, reservedTokens: 1024, unit: "conservative-token-upper-bound", cap, textOnly: true };
176
+ if (count > cap) throw new Error(`provider payload conservative upper bound ${count} exceeds ${cap} input-token cap`);
177
+ return provenance;
178
+ }
@@ -1,4 +1,6 @@
1
1
  import type { NativeDispatchResult, NativeExecutionDiagnostics, NativeSpawnOutcome, PreparedNativeRun } from "./dispatch-native-types.ts";
2
+ import { boundOutput } from "./deterministic-fs.ts";
3
+ import { safePathWithin } from "./helpers.ts";
2
4
 
3
5
  export async function completeNativeRun(run: PreparedNativeRun, outcome: NativeSpawnOutcome): Promise<NativeDispatchResult> {
4
6
  const { deps, state, ctx, histEntry, monitorStart, startTime, key, agentKey } = run;
@@ -12,14 +14,20 @@ export async function completeNativeRun(run: PreparedNativeRun, outcome: NativeS
12
14
  reason: res.spawnError ? "spawn_error" : res.termination?.reason ?? (state.killedByOperator ? "operator_cancelled" : res.assistantError ? "assistant_error" : res.exitCode !== 0 ? "exit_code" : null),
13
15
  processExitCode: res.exitCode,
14
16
  assistantError: res.assistantError ?? null, stderr: res.stderr, spawnError: res.spawnError ?? null,
15
- modelUsed: res.modelUsed ?? null, toolCallsStarted: res.toolCallsStarted ?? null,
17
+ modelUsed: res.modelUsed ?? null,
18
+ effectiveTools: run.effectiveTools.split(",").map(tool => tool.trim()).filter(Boolean),
19
+ toolCallsStarted: res.toolCallsStarted ?? null,
16
20
  termination: res.termination ?? null, modelFallback: res.modelFallback ?? null,
17
21
  };
18
22
  const diagnosticText = diagnostics.reason ? formatDiagnostics(diagnostics) : "";
19
- const finish = (result: NativeDispatchResult): NativeDispatchResult => ({
20
- ...result, dispatchId: run.dispatchId, transcriptPath: run.transcriptPath, diagnostics, sessionReset,
21
- output: result.output + diagnosticText,
22
- });
23
+ const finish = (result: NativeDispatchResult): NativeDispatchResult => {
24
+ const combined = result.output + diagnosticText;
25
+ const parent = res.boundedOutput ? boundOutput({ content: combined, retentionDir: safePathWithin(run.evidenceDir, "bounded-output", "parent"), label: "parent-summary" }) : null;
26
+ return {
27
+ ...result, runtimeTests: res.runtimeTests, toolEvents: res.toolEvents, writeIsolation: res.writeIsolation, dispatchId: run.dispatchId, transcriptPath: run.transcriptPath, diagnostics, sessionReset,
28
+ output: parent?.reply ?? combined,
29
+ };
30
+ };
23
31
  if (diagnosticText) deps.appendTimelineText(state, "text", diagnosticText);
24
32
  deps.flushTimelineStore(state);
25
33
 
@@ -110,6 +118,7 @@ export async function completeNativeRun(run: PreparedNativeRun, outcome: NativeS
110
118
  state.status = code === 0 ? "done" : "error";
111
119
  if (code === 0) {
112
120
  state.sessionFile = run.agentSessionFile;
121
+ state.resumeContract = run.resumeContract;
113
122
  state.runsSinceFresh++;
114
123
  }
115
124
  state.lastWork = (full || res.assistantError || res.stderr).split("\n").filter(line => line.trim()).pop() || "";
@@ -1,4 +1,7 @@
1
- import { profileFallback, profileChild } from './policy/profile-runtime.ts';
1
+ import { fileURLToPath } from "node:url";
2
+ import { profileFallback, profileChild, PROFILE_ENV } from './policy/profile-runtime.ts';
3
+ import { BOUNDED_OUTPUT_DIR_ENV } from './bounded-output.ts';
4
+ import { FILESYSTEM_SESSION_DIR_ENV } from './filesystem-tool.ts';
2
5
  import { chmodSync, mkdirSync, existsSync, copyFileSync, unlinkSync } from "node:fs";
3
6
  import { applyModelOverride, clampDelegateDepth, DELEGATE_TREE_SPAWN_BUDGET, fallbackModelFor, MAX_DELEGATE_DEPTH, safePathWithin } from "./helpers.ts";
4
7
  import { contextOverflowDiagnostic, shouldRecycleSession } from "./run-budget.js";
@@ -8,8 +11,10 @@ import { requireSafetyHarness } from "./safety-routing.ts";
8
11
  import { buildSpecialistContextManifest, nativeSpecialistSystemPrompt } from "../lib/context-budget-child-prompt.ts";
9
12
  import { extractAssertionIds } from "./return-contract.js";
10
13
  import type { NativeDispatchResult, NativeRunBase, PreparedNativeRun } from "./dispatch-native-types.ts";
14
+ import { bindResume, type TaskResumeInput } from "./task-resume-contract.ts";
15
+ import { confineNativeChild, type WriteIsolationRequest } from "./write-isolation.ts";
11
16
 
12
- export async function prepareNativeRun(base: NativeRunBase, preserveManifest: boolean): Promise<PreparedNativeRun | NativeDispatchResult> {
17
+ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: boolean, requestedContract?: Omit<TaskResumeInput, "previous">): Promise<PreparedNativeRun | NativeDispatchResult> {
13
18
  const { deps, state, ctx, task, inputArtifacts, scopeGlobs, personaKey, agentKey, runNumber } = base;
14
19
  const model = deps.resolvedModel(state.def)
15
20
  ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
@@ -17,7 +22,25 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
17
22
  const originalModelFallback = fallbackCandidate === model ? undefined : fallbackCandidate;
18
23
  const agentWindow = resolveContextWindow(model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
19
24
  const agentSessionFile = safePathWithin(base.evidenceDir, "session.json");
20
- if (state.sessionFile && existsSync(state.sessionFile)) copyFileSync(state.sessionFile, agentSessionFile);
25
+ const resumeContract = bindResume({
26
+ taskId: requestedContract?.taskId ?? task,
27
+ instructions: requestedContract?.instructions ?? task,
28
+ scope: requestedContract?.scope ?? scopeGlobs,
29
+ deliverables: requestedContract?.deliverables,
30
+ artifacts: requestedContract?.artifacts ?? inputArtifacts.map(artifact => artifact.path),
31
+ model: requestedContract?.model ?? model,
32
+ permissions: requestedContract?.permissions ?? state.def.tools,
33
+ previous: state.resumeContract,
34
+ });
35
+ let resumeAllowed = resumeContract.resumeAllowed && !!state.sessionFile && existsSync(state.sessionFile);
36
+ if (resumeAllowed) copyFileSync(state.sessionFile!, agentSessionFile);
37
+ else if (state.sessionFile) {
38
+ state.sessionFile = null;
39
+ state.specialistManifest = undefined;
40
+ state.runsSinceFresh = 0;
41
+ state.contextPct = 0;
42
+ state.contextTokens = 0;
43
+ }
21
44
  const turnBudget = deps.currentBudget();
22
45
  let sessionRecycled = false;
23
46
 
@@ -28,6 +51,7 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
28
51
  state.contextPct = 0;
29
52
  state.contextTokens = 0;
30
53
  sessionRecycled = true;
54
+ resumeAllowed = false;
31
55
  deps.bumpRecycle();
32
56
  ctx.ui.notify(`${deps.displayName(state.def.name)}: session recycled (stale context) — starting fresh`, "info");
33
57
  } else {
@@ -46,6 +70,7 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
46
70
  state.runsSinceFresh = 0;
47
71
  state.contextPct = 0;
48
72
  state.contextTokens = 0;
73
+ resumeAllowed = false;
49
74
  ctx.ui.notify(`${deps.displayName(state.def.name)}: unusable session file quarantined (${health.reason}) — starting fresh`, "warning");
50
75
  }
51
76
 
@@ -65,7 +90,14 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
65
90
  const safety = requireSafetyHarness(safetyHarnessPath);
66
91
  if (!safety.ok) return base.finishRun(safety.error, 1);
67
92
  const extensions = [...safety.extensions];
68
- let effectiveTools = state.def.tools;
93
+ const assist = base.assistSnapshot;
94
+ const boundedOutput = assist['bounded-output'];
95
+ const declaredTools = state.def.tools.split(",").map(tool => tool.trim()).filter(Boolean);
96
+ const deterministicTools = assist['deterministic-tools'] && (state.def.toolsExplicit !== true || declaredTools.includes("filesystem"));
97
+ if (boundedOutput) extensions.push(fileURLToPath(new URL("./bounded-output.ts", import.meta.url)));
98
+ if (deterministicTools) extensions.push(fileURLToPath(new URL("./filesystem-tool.ts", import.meta.url)));
99
+ if (declaredTools.includes("bash")) extensions.push(fileURLToPath(new URL("./runtime-test-check.ts", import.meta.url)));
100
+ let effectiveTools = deterministicTools && !declaredTools.includes("filesystem") ? `${state.def.tools},filesystem` : state.def.tools;
69
101
  let delegateEnv: Record<string, string> | undefined;
70
102
  if (delegationActive) {
71
103
  const delegationDir = safePathWithin(base.evidenceDir, "delegations");
@@ -81,20 +113,24 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
81
113
  depth: clampDelegateDepth(state.def.delegateDepth ?? MAX_DELEGATE_DEPTH),
82
114
  callBudget: DELEGATE_TREE_SPAWN_BUDGET,
83
115
  remainingSpawns: DELEGATE_TREE_SPAWN_BUDGET,
84
- parentTools: state.def.tools,
116
+ parentTools: effectiveTools,
85
117
  personaPrompt: state.def.systemPrompt,
86
118
  eventDir: delegationDir,
87
119
  damageControl: safetyHarnessPath || undefined,
88
120
  delegateExt: delegateExtPath,
89
121
  reconSearchTimeoutMs: deps.getReconSearchTimeoutMs(),
90
122
  turnDeadlineMs: turnBudget.agentTurnMs,
123
+ boundedOutput,
124
+ boundedOutputDir: safePathWithin(base.evidenceDir, "delegations", "bounded-output"),
125
+ deterministicTools,
126
+ filesystemSessionDir: base.sessionDir,
91
127
  cwd: ctx.cwd || process.cwd(),
92
128
  }),
93
129
  };
94
130
  deps.startDelegationWatch(state, delegationDir);
95
131
  }
96
132
 
97
- const manifest = preserveManifest && state.specialistManifest
133
+ const manifest = resumeAllowed && state.specialistManifest
98
134
  ? state.specialistManifest
99
135
  : buildSpecialistContextManifest({
100
136
  personaName: state.def.name,
@@ -113,6 +149,28 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
113
149
  const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
114
150
  const wantThinking = thinkingLevel !== "off";
115
151
  const runPrompt = deps.appendDeclaredScope(deps.appendInputArtifacts(task, inputArtifacts), scopeGlobs);
152
+ let writeIsolation: WriteIsolationRequest | undefined;
153
+ let writeIsolationPolicy;
154
+ if (assist['write-isolation']) {
155
+ const artifactRoot = safePathWithin(base.sessionDir, "artifacts");
156
+ const tempRoot = safePathWithin(base.evidenceDir, "runtime-tmp");
157
+ mkdirSync(artifactRoot, { recursive: true, mode: 0o700 });
158
+ mkdirSync(tempRoot, { recursive: true, mode: 0o700 });
159
+ writeIsolation = {
160
+ enabled: true,
161
+ cwd: ctx.cwd || process.cwd(),
162
+ allowlist: [...scopeGlobs],
163
+ runtimePaths: [base.evidenceDir],
164
+ artifactPaths: [artifactRoot],
165
+ tempPaths: [tempRoot],
166
+ };
167
+ writeIsolationPolicy = confineNativeChild(writeIsolation);
168
+ if (!writeIsolationPolicy.applied) return base.finishRun(`Write isolation refused: ${writeIsolationPolicy.reason ?? "native backend unavailable"}. No unsandboxed child was started.`, 1);
169
+ writeIsolation.backend = writeIsolationPolicy.mechanism;
170
+ writeIsolation.backendPath = writeIsolationPolicy.command;
171
+ delegateEnv = { ...delegateEnv, TMPDIR: tempRoot, TMP: tempRoot, TEMP: tempRoot };
172
+ }
173
+ if (base.activeProfileSnapshot) delegateEnv = { ...delegateEnv, [PROFILE_ENV]: JSON.stringify(base.activeProfileSnapshot) };
116
174
 
117
175
  if (state.sessionFile && !sessionRecycled) {
118
176
  const overflow = shouldRecycleBeforeSpawn({
@@ -127,6 +185,7 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
127
185
  state.contextPct = 0;
128
186
  state.contextTokens = 0;
129
187
  sessionRecycled = true;
188
+ resumeAllowed = false;
130
189
  deps.bumpRecycle();
131
190
  ctx.ui.notify(
132
191
  `${deps.displayName(state.def.name)}: session recycled before spawn — ${overflow.message}. ` +
@@ -147,9 +206,17 @@ export async function prepareNativeRun(base: NativeRunBase, preserveManifest: bo
147
206
  sessionReset,
148
207
  effectiveTools,
149
208
  extensions,
150
- delegateEnv,
209
+ delegateEnv: {
210
+ ...delegateEnv,
211
+ ...(boundedOutput ? { [BOUNDED_OUTPUT_DIR_ENV]: safePathWithin(base.evidenceDir, "bounded-output") } : {}),
212
+ ...(deterministicTools ? { [FILESYSTEM_SESSION_DIR_ENV]: base.sessionDir } : {}),
213
+ },
214
+ writeIsolation,
215
+ writeIsolationPolicy,
151
216
  thinkingLevel,
152
217
  wantThinking,
218
+ resumeContract,
219
+ resumeAllowed,
153
220
  replacementSystemPrompt,
154
221
  runPrompt,
155
222
  };
@@ -138,18 +138,22 @@ function createSpawnCallbacks(run: PreparedNativeRun, drift: DriftRuntime, usage
138
138
  export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeSpawnOutcome> {
139
139
  const { deps, state, ctx, model, effectiveTools, thinkingLevel, replacementSystemPrompt, agentSessionFile, runPrompt, extensions, delegateEnv, turnBudget, personaKey, originalModelFallback } = run;
140
140
  const spawnOptions: SpawnPiAgentOptions = {
141
+ runtimeTestObserver: extensions.some(path => path.endsWith("/runtime-test-check.ts")),
141
142
  model,
143
+ activeProfileSnapshot: run.activeProfileSnapshot,
144
+ writeIsolation: run.writeIsolation,
142
145
  tools: effectiveTools,
143
146
  thinking: thinkingLevel,
144
147
  systemPrompt: replacementSystemPrompt,
145
148
  noSkills: true,
146
149
  noContextFiles: true,
147
150
  sessionFile: agentSessionFile,
148
- resume: !!state.sessionFile,
151
+ resume: run.resumeAllowed,
149
152
  prompt: runPrompt,
150
153
  cwd: ctx.cwd || process.cwd(),
151
154
  extensions,
152
155
  env: { ...deps.guardrailEnv(run.agentKey), ...(delegateEnv || {}) },
156
+ ...(delegateEnv?.AGENT_FLEET_BOUNDED_OUTPUT_DIR ? { boundedOutputDir: delegateEnv.AGENT_FLEET_BOUNDED_OUTPUT_DIR } : {}),
153
157
  detached: true,
154
158
  ...(RESEARCHER_PERSONAS.has(personaKey) ? { toolWatchdog: { timeoutMs: deps.getReconSearchTimeoutMs() } } : {}),
155
159
  turnDeadlineMs: turnBudget.agentTurnMs,
@@ -8,6 +8,10 @@ import type { TimelineEntry } from "./ui/zoom.ts";
8
8
  import type { DelegationChild, DelegationObservableState } from "./dispatch-observability.ts";
9
9
  import type { ComsDispatchResult, DispatchInputArtifactPreview } from "./dispatch-coms.ts";
10
10
  import type { PiRunControl, SpawnPiAgentCallbacks, SpawnPiAgentOptions, SpawnPiAgentResult } from "./spawn.ts";
11
+ import type { TaskResumeContract } from "./task-resume-contract.ts";
12
+ import type { ResolvedAssistFlags } from "./assist-profile.ts";
13
+ import type { ActiveModelProfile } from "./policy/profile-runtime.ts";
14
+ import type { WriteIsolationRequest, WriteIsolationResult } from "./write-isolation.ts";
11
15
 
12
16
  export type NativeBackend = "auto" | "native" | "coms";
13
17
 
@@ -53,6 +57,7 @@ export interface NativeDispatchState extends NativeTimelineTarget, DelegationObs
53
57
  contextTokens: number;
54
58
  sessionFile: string | null;
55
59
  specialistManifest?: SpecialistContextManifest;
60
+ resumeContract?: TaskResumeContract;
56
61
  runCount: number;
57
62
  runsSinceFresh: number;
58
63
  timer?: ReturnType<typeof setInterval>;
@@ -74,12 +79,16 @@ export interface NativeExecutionDiagnostics {
74
79
  stderr: string;
75
80
  spawnError: string | null;
76
81
  modelUsed: string | null;
82
+ effectiveTools: string[];
77
83
  toolCallsStarted: number | null;
78
84
  termination: SpawnPiAgentResult["termination"] | null;
79
85
  modelFallback: SpawnPiAgentResult["modelFallback"] | null;
80
86
  }
81
87
 
82
88
  export interface NativeDispatchResult {
89
+ runtimeTests?: import("./runtime-test-check.ts").RuntimeTestRecord[];
90
+ writeIsolation?: Pick<WriteIsolationResult, "applied" | "failClosed" | "mechanism" | "permissionExpansion" | "rollsBackUserEdits" | "protectsConcurrentUserWrites">;
91
+ toolEvents?: import("./tool-protocol.ts").ToolExecutionEvent[];
83
92
  evidencePath?: string;
84
93
  sessionPath?: string;
85
94
  dispatchId?: string;
@@ -197,6 +206,8 @@ export interface NativeRunBase {
197
206
  monitorKey: string;
198
207
  monitorStart?: Promise<any>;
199
208
  startTime: number;
209
+ assistSnapshot: ResolvedAssistFlags;
210
+ activeProfileSnapshot?: ActiveModelProfile;
200
211
  finishRun(output: string, exitCode: number, options?: { idle?: boolean; pending?: boolean; notice?: string }): Promise<NativeDispatchResult>;
201
212
  }
202
213
 
@@ -211,8 +222,12 @@ export interface PreparedNativeRun extends NativeRunBase {
211
222
  effectiveTools: string;
212
223
  extensions: string[];
213
224
  delegateEnv?: Record<string, string>;
225
+ writeIsolation?: WriteIsolationRequest;
226
+ writeIsolationPolicy?: WriteIsolationResult;
214
227
  thinkingLevel: string;
215
228
  wantThinking: boolean;
229
+ resumeContract: TaskResumeContract;
230
+ resumeAllowed: boolean;
216
231
  replacementSystemPrompt: string;
217
232
  runPrompt: string;
218
233
  }
@@ -1,4 +1,5 @@
1
- import { profileForcesNativePeers, profilePeerGate } from './policy/profile-runtime.ts';
1
+ import { profileForcesNativePeers, profilePeerGate, readActiveProfile, type ActiveModelProfile } from './policy/profile-runtime.ts';
2
+ import { resolveAssist, type ResolvedAssistFlags } from "./assist-profile.ts";
2
3
  import { randomUUID } from "node:crypto";
3
4
  import { beginExecutionEvidence, finishExecutionEvidence } from "./execution-evidence.ts";
4
5
  import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
@@ -9,6 +10,7 @@ import { normalizeAgentInput, safeAgentKey, safePathWithin } from "./helpers.ts"
9
10
  import { prepareNativeRun } from "./dispatch-native-prepare.ts";
10
11
  import { runPreparedNative } from "./dispatch-native-spawn.ts";
11
12
  import { completeNativeRun } from "./dispatch-native-complete.ts";
13
+ import type { TaskResumeInput } from "./task-resume-contract.ts";
12
14
  import type {
13
15
  DispatchInputArtifactPreview,
14
16
  NativeBackend,
@@ -26,7 +28,10 @@ interface NativeDispatchArgs {
26
28
  scopeGlobs: string[];
27
29
  watchdogParam?: boolean;
28
30
  requestedBackend: NativeBackend;
29
- preserveManifest: boolean;
31
+ resumeRequested: boolean;
32
+ resumeContract?: Omit<TaskResumeInput, "previous">;
33
+ assistSnapshot: ResolvedAssistFlags;
34
+ activeProfileSnapshot?: ActiveModelProfile;
30
35
  }
31
36
 
32
37
  function missingOrRunning(deps: NativeDispatchDeps, agentName: string): NativeDispatchResult | NativeDispatchState {
@@ -40,7 +45,7 @@ function missingOrRunning(deps: NativeDispatchDeps, agentName: string): NativeDi
40
45
  }
41
46
  if (state.status === "running") {
42
47
  return {
43
- output: `Agent "${deps.displayName(state.def.name)}" is already running. Wait for it to finish.`,
48
+ output: `Busy refusal: agent "${deps.displayName(state.def.name)}" is already running. Nothing was started, queued, retried, or charged; re-invoke explicitly after it is idle.`,
44
49
  exitCode: 1,
45
50
  elapsed: 0,
46
51
  };
@@ -116,14 +121,19 @@ function beginNativeRun(deps: NativeDispatchDeps, state: NativeDispatchState, ar
116
121
  dispatchId, transcriptPath, sessionDir, evidenceDir, deps, state, ctx, task, inputArtifacts, scopeGlobs, watchdogParam,
117
122
  key: normalizeAgentInput(args.agentName),
118
123
  personaKey: state.def.name.toLowerCase(),
119
- agentKey, runNumber, histEntry, monitorKey, monitorStart, startTime, finishRun,
124
+ agentKey, runNumber, histEntry, monitorKey, monitorStart, startTime,
125
+ assistSnapshot: args.assistSnapshot,
126
+ activeProfileSnapshot: args.activeProfileSnapshot,
127
+ finishRun,
120
128
  };
121
129
  }
122
130
 
123
131
  async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend): Promise<NativeDispatchResult | null> {
124
132
  const { deps, state, task, ctx, inputArtifacts, scopeGlobs, personaKey, monitorKey, startTime, histEntry } = run;
125
133
  const livePeerNames = () => deps.isComsReady() && deps.getIdentity() ? deps.peersInScope().map(entry => entry.name) : [];
126
- const forceNative = profileForcesNativePeers();
134
+ const isolationRequired = run.assistSnapshot['write-isolation'];
135
+ const forceNative = isolationRequired || (run.activeProfileSnapshot ? profileForcesNativePeers(run.activeProfileSnapshot) : false);
136
+ if (isolationRequired && requestedBackend === "coms") return run.finishRun("Write isolation is native-only; coms dispatch refused because remote isolation cannot be claimed.", 1);
127
137
  if (forceNative && requestedBackend === 'coms') return run.finishRun('Active model profile requires native execution; coms dispatch refused.', 1);
128
138
  const dispatchPolicy = forceNative ? { default: 'native', grace_s: 0, substitutions: {} } : deps.getDispatchPolicy();
129
139
  let route: any = resolveDispatchBackend({ agentName: state.def.name, policy: dispatchPolicy, livePeerNames: livePeerNames(), requestedBackend });
@@ -146,7 +156,7 @@ async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend
146
156
  }
147
157
  if (route.backend === "coms") {
148
158
  const peer = deps.peersInScope().find(entry => entry.name.toLowerCase() === String(route.peerName).toLowerCase());
149
- const profileRefusal = profilePeerGate({ peerModel: peer?.model, targetResolved: !!peer });
159
+ const profileRefusal = run.activeProfileSnapshot ? profilePeerGate({ peerModel: peer?.model, targetResolved: !!peer }, run.activeProfileSnapshot) : null;
150
160
  if (profileRefusal) {
151
161
  const allowNativeFallback = !route.explicit && (dispatchPolicy.substitutions[personaKey]?.fallback ?? "native") !== "none";
152
162
  if (!allowNativeFallback) return run.finishRun(profileRefusal.content[0].text, 1);
@@ -178,14 +188,16 @@ async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend
178
188
  return null;
179
189
  }
180
190
 
181
- async function dispatchNative(deps: NativeDispatchDeps, args: NativeDispatchArgs): Promise<NativeDispatchResult> {
191
+ async function dispatchNative(deps: NativeDispatchDeps, args: Omit<NativeDispatchArgs, "assistSnapshot" | "activeProfileSnapshot">): Promise<NativeDispatchResult> {
192
+ const activeProfileSnapshot = readActiveProfile();
193
+ const effectiveArgs: NativeDispatchArgs = { ...args, activeProfileSnapshot, assistSnapshot: resolveAssist(activeProfileSnapshot?.profile.assist) };
182
194
  const found = missingOrRunning(deps, args.agentName);
183
195
  if (!("def" in found)) return found;
184
- const run = beginNativeRun(deps, found, args);
196
+ const run = beginNativeRun(deps, found, effectiveArgs);
185
197
  const execute = async () => {
186
198
  const routed = await routeDispatch(run, args.requestedBackend);
187
199
  if (routed) return routed;
188
- const prepared = await prepareNativeRun(run, args.preserveManifest);
200
+ const prepared = await prepareNativeRun(run, args.resumeRequested, args.resumeContract);
189
201
  if ("output" in prepared) return prepared;
190
202
  const outcome = await runPreparedNative(prepared);
191
203
  return { ...await completeNativeRun(prepared, outcome), sessionPath: prepared.agentSessionFile };
@@ -207,7 +219,8 @@ export function createDispatchNative(deps: NativeDispatchDeps) {
207
219
  scopeGlobs: string[] = [],
208
220
  watchdogParam?: boolean,
209
221
  requestedBackend: NativeBackend = "auto",
210
- preserveManifest = false,
211
- ) => dispatchNative(deps, { agentName, task, ctx, inputArtifacts, scopeGlobs, watchdogParam, requestedBackend, preserveManifest }),
222
+ resumeRequested = false,
223
+ resumeContract?: Omit<TaskResumeInput, "previous">,
224
+ ) => dispatchNative(deps, { agentName, task, ctx, inputArtifacts, scopeGlobs, watchdogParam, requestedBackend, resumeRequested, resumeContract }),
212
225
  };
213
226
  }
@@ -0,0 +1,73 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { existsSync, lstatSync, realpathSync } from "node:fs";
4
+ import { isAbsolute, relative, resolve } from "node:path";
5
+ import { excerpt, inventory, PathOutsideAllowedRootError, readback, snapshotSource } from "./deterministic-fs.ts";
6
+ import { readActiveProfile } from "./policy/profile-runtime.ts";
7
+ import { resolveAssist } from "./assist-profile.ts";
8
+
9
+ export const FILESYSTEM_SESSION_DIR_ENV = "AGENT_FLEET_FILESYSTEM_SESSION_DIR";
10
+
11
+ export interface FilesystemToolPorts { enabled(): boolean; sessionDir(): string }
12
+
13
+ function workspacePath(path: string, cwd: string): string {
14
+ const target=resolve(cwd,path), rel=relative(cwd,target);
15
+ if (rel.startsWith("..") || isAbsolute(rel)) throw new Error(`Path outside current workspace: ${path}`);
16
+ if (existsSync(target)) {
17
+ const realRel=relative(realpathSync(cwd),realpathSync(target));
18
+ if (realRel.startsWith("..") || isAbsolute(realRel)) throw new Error(`Symlink escape outside current workspace: ${path}`);
19
+ }
20
+ return target;
21
+ }
22
+
23
+ function result(value: any) {
24
+ const normalized = value?.content && Buffer.isBuffer(value.content)
25
+ ? { ...value, content: value.content.toString("utf8"), contentEncoding: "utf8", exactBytesOnDisk: value.path }
26
+ : value;
27
+ return { content: [{ type: "text" as const, text: JSON.stringify(normalized) }], details: { result: normalized } };
28
+ }
29
+
30
+ export function registerFilesystemTool(pi: ExtensionAPI, ports: FilesystemToolPorts): void {
31
+ pi.registerTool({
32
+ name: "filesystem",
33
+ label: "Deterministic Filesystem",
34
+ description: "Deterministically inventory or excerpt repository files, read back an opaque handle, or snapshot a local source into this session's managed untrusted artifacts. No network or model delegation.",
35
+ parameters: Type.Object({
36
+ operation: Type.Union([Type.Literal("inventory"),Type.Literal("excerpt"),Type.Literal("readback"),Type.Literal("snapshot")]),
37
+ path: Type.Optional(Type.String({description:"Local path inside the current workspace; required except for readback."})),
38
+ handle: Type.Optional(Type.String({description:"Opaque handle returned by inventory, excerpt, snapshot, or prior readback."})),
39
+ origin: Type.Optional(Type.Literal("file",{description:"Snapshots accept local file sources only."})),
40
+ page_size: Type.Optional(Type.Integer({minimum:1})),
41
+ max_bytes: Type.Optional(Type.Integer({minimum:1})),
42
+ }, { additionalProperties: false }),
43
+ async execute(_id, raw, _signal, _update, ctx) {
44
+ if (!ports.enabled()) throw new Error("filesystem is disabled by the effective profile; set assist.deterministic-tools=true");
45
+ const params=raw as any, cwd=resolve(ctx.cwd || process.cwd()), sessionValue=ports.sessionDir();
46
+ if (!sessionValue) throw new Error("filesystem requires a current managed session artifact root");
47
+ const session=resolve(sessionValue);
48
+ if (existsSync(session) && lstatSync(session).isSymbolicLink()) throw new Error("filesystem refuses a symlinked managed session root");
49
+ if (params.destination !== undefined) throw new Error("filesystem snapshot destination is managed and cannot be supplied");
50
+ switch(params.operation) {
51
+ case "inventory": if(!params.path) throw new Error("inventory requires path"); return result(inventory({root:workspacePath(params.path,cwd),handle:params.handle,pageSize:params.page_size,boundedOutput:true}));
52
+ case "excerpt": if(!params.path) throw new Error("excerpt requires path"); return result(excerpt({path:workspacePath(params.path,cwd),allowedRoot:cwd,handle:params.handle,maxBytes:params.max_bytes,boundedOutput:true}));
53
+ case "readback": {
54
+ if(!params.handle) throw new Error("readback requires handle");
55
+ try { return result(readback({handle:params.handle,allowedRoot:cwd,maxBytes:params.max_bytes,boundedOutput:true})); }
56
+ catch (error) {
57
+ if (!(error instanceof PathOutsideAllowedRootError)) throw error;
58
+ return result(readback({handle:params.handle,allowedRoot:session,maxBytes:params.max_bytes,boundedOutput:true}));
59
+ }
60
+ }
61
+ case "snapshot": if(params.origin!=="file" || !params.path) throw new Error("snapshot accepts a local file origin and path only"); return result(snapshotSource({origin:"file",path:workspacePath(params.path,cwd),allowedRoot:cwd,sessionDir:session}));
62
+ default: throw new Error("Unsupported filesystem operation");
63
+ }
64
+ },
65
+ });
66
+ }
67
+
68
+ export default function deterministicFilesystemExtension(pi: ExtensionAPI): void {
69
+ registerFilesystemTool(pi, {
70
+ enabled: () => resolveAssist(readActiveProfile()?.profile.assist)['deterministic-tools'],
71
+ sessionDir: () => process.env[FILESYSTEM_SESSION_DIR_ENV] || "",
72
+ });
73
+ }