@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
@@ -40,12 +40,21 @@ export function validateAssertionBatch(input) {
40
40
  };
41
41
  }
42
42
 
43
- const assertions = batch.map((a) => ({
44
- id: str(a?.id),
45
- tag: str(a?.tag),
46
- text: str(a?.text),
47
- source: str(a?.source),
48
- }));
43
+ const assertions = batch.map((a) => {
44
+ const reference = str(a?.reference);
45
+ const criticalConditions = Array.isArray(a?.critical_conditions)
46
+ ? a.critical_conditions.map(str).filter(Boolean)
47
+ : Array.isArray(a?.criticalConditions) ? a.criticalConditions.map(str).filter(Boolean) : [];
48
+ return {
49
+ id: str(a?.id),
50
+ tag: str(a?.tag),
51
+ text: str(a?.text),
52
+ source: str(a?.source),
53
+ ...(reference ? { reference } : {}),
54
+ ...(str(a?.test_command) ? { testCommand: str(a.test_command) } : {}),
55
+ ...(criticalConditions.length ? { criticalConditions } : {}),
56
+ };
57
+ });
49
58
 
50
59
  const warning =
51
60
  assertions.length > MAX_OPEN_ASSERTIONS
@@ -0,0 +1,16 @@
1
+ import type { AssistFlags } from './config/model-profiles.ts';
2
+
3
+ export interface ResolvedAssistFlags {
4
+ 'deterministic-tools': boolean;
5
+ 'bounded-output': boolean;
6
+ 'write-isolation': boolean;
7
+ }
8
+
9
+ /** Resolves requested profile configuration only; feature producers apply it separately. */
10
+ export function resolveAssist(assist: AssistFlags = {}): ResolvedAssistFlags {
11
+ return {
12
+ 'deterministic-tools': assist['deterministic-tools'] === true,
13
+ 'bounded-output': assist['bounded-output'] === true,
14
+ 'write-isolation': assist['write-isolation'] === true,
15
+ };
16
+ }
@@ -0,0 +1,26 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { resolveAssist } from "./assist-profile.ts";
3
+ import { boundOutput } from "./deterministic-fs.ts";
4
+ import { readActiveProfile } from "./policy/profile-runtime.ts";
5
+
6
+ const BOUNDED_TOOLS = new Set(["read", "grep", "find", "ls"]);
7
+ export const BOUNDED_OUTPUT_DIR_ENV = "AGENT_FLEET_BOUNDED_OUTPUT_DIR";
8
+
9
+ export function boundedOutputEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
10
+ const active = readActiveProfile(env); const flags = resolveAssist(active?.profile.assist);
11
+ return flags["bounded-output"];
12
+ }
13
+
14
+ export function boundToolResult(event: any, retentionDir: string) {
15
+ if (!BOUNDED_TOOLS.has(String(event.toolName))) return undefined;
16
+ const text = (event.content ?? []).filter((item: any) => item?.type === "text" && typeof item.text === "string").map((item: any) => item.text).join("\n");
17
+ const bounded = boundOutput({ content: text, retentionDir, label: `${event.toolName}-${event.toolCallId || "result"}` });
18
+ if (!bounded.truncated) return undefined;
19
+ const nonText = (event.content ?? []).filter((item: any) => item?.type !== "text");
20
+ return { content: [{ type: "text", text: bounded.reply }, ...nonText], details: { ...(event.details && typeof event.details === "object" ? event.details : {}), boundedOutput: { truncated: true, totalBytes: bounded.totalBytes, handle: bounded.handle, contentPath: bounded.contentPath, sha256: bounded.hash } } };
21
+ }
22
+
23
+ export default function registerBoundedOutput(pi: ExtensionAPI): void {
24
+ if (!boundedOutputEnabled() || !process.env[BOUNDED_OUTPUT_DIR_ENV]) return;
25
+ pi.on("tool_result", (event: any) => boundToolResult(event, process.env[BOUNDED_OUTPUT_DIR_ENV]!));
26
+ }
@@ -4,9 +4,23 @@ import type { RuntimeQuestion } from "../ask-user-remote/runtime-ask.ts";
4
4
  import type { BudgetContinuationKind } from "./budget-continuation.ts";
5
5
 
6
6
  export type BudgetOperation = "dispatch" | "research";
7
+ export type RecoveryOperation = BudgetOperation | "retry" | "supersede";
8
+ const reservedActualTaskIds = new Set<string>();
9
+
10
+ /** Stable future task UUID reserved before the one-use supersession question. */
11
+ export function reserveActualTaskId(): string {
12
+ const id = randomUUID();
13
+ reservedActualTaskIds.add(id);
14
+ return id;
15
+ }
16
+
17
+ /** Consume a reserved id exactly once; refused if missing or already used. */
18
+ export function consumeReservedTaskId(id: string): boolean {
19
+ return reservedActualTaskIds.delete(id);
20
+ }
7
21
  export interface BudgetRefusal { kind: BudgetContinuationKind; reason: string; message: string; }
8
22
  export interface BudgetBlock { reason: string; message: string; }
9
- export interface BudgetCorrelation { taskId: string; tranche: number; requestId: string; }
23
+ export interface BudgetCorrelation { taskId: string; tranche: number; requestId: string; operation: RecoveryOperation; }
10
24
  export interface BudgetRecoveryPorts {
11
25
  check(operation: BudgetOperation): BudgetRefusal | null;
12
26
  language(): string;
@@ -18,21 +32,96 @@ export interface BudgetRecoveryPorts {
18
32
  export interface BudgetRecovery {
19
33
  ensure(operation: BudgetOperation, next: string, ctx: ExtensionContext, signal?: AbortSignal): Promise<BudgetBlock | null>;
20
34
  resume(ctx: ExtensionContext): Promise<BudgetBlock | null>;
35
+ adopt(id: string): void;
21
36
  reset(): void;
22
37
  }
23
38
 
24
- function isAffirmative(result: unknown, question: RuntimeQuestion): boolean {
25
- const value = result as { isError?: boolean; details?: { cancelled?: boolean; response?: { kind?: string; selections?: unknown[] } } } | null;
39
+ /** Keeps the approved identity scoped to one synchronous task-window reset. */
40
+ export function createReservedTaskIdentityReset(
41
+ budgetRecovery: Pick<BudgetRecovery, "adopt" | "reset">,
42
+ noProgress: { adopt(id: string): void; reset(): void },
43
+ ) {
44
+ let reservedId: string | undefined;
45
+ const rawBudgetReset = budgetRecovery.reset.bind(budgetRecovery);
46
+ const rawNoProgressReset = noProgress.reset.bind(noProgress);
47
+ budgetRecovery.reset = () => { if (reservedId) budgetRecovery.adopt(reservedId); else rawBudgetReset(); };
48
+ noProgress.reset = () => { if (reservedId) noProgress.adopt(reservedId); else rawNoProgressReset(); };
49
+ return {
50
+ run(id: string, resetTaskWindow: () => void) {
51
+ if (reservedId) throw new Error("A reserved task identity reset is already active.");
52
+ reservedId = id;
53
+ try { resetTaskWindow(); }
54
+ finally { reservedId = undefined; }
55
+ },
56
+ };
57
+ }
58
+
59
+ function isAffirmative(result: unknown, question: RuntimeQuestion, correlation: BudgetCorrelation): boolean {
60
+ const value = result as { isError?: boolean; details?: { cancelled?: boolean; runtimeAsk?: { requestId?: unknown }; response?: { kind?: string; selections?: unknown[] } } } | null;
26
61
  const response = value?.details?.response;
27
- return !value?.isError && value?.details?.cancelled !== true && response?.kind === "selection" &&
28
- response.selections?.length === 1 && response.selections[0] === question.options[0];
62
+ return !value?.isError && value?.details?.cancelled !== true && value?.details?.runtimeAsk?.requestId === correlation.requestId &&
63
+ response?.kind === "selection" && response.selections?.length === 1 && response.selections[0] === question.options[0];
64
+ }
65
+
66
+ export interface RetryAuthorizationPorts {
67
+ taskId(): string;
68
+ language(): string;
69
+ ask(id: string, params: RuntimeQuestion, ctx: ExtensionContext, signal: AbortSignal): Promise<unknown>;
70
+ startWait(id: string): void;
71
+ endWait(id: string, sameTask: boolean): void;
72
+ authorize(dispatchId: string): boolean;
73
+ }
74
+
75
+ /** Ask for the existing operator-cancellation permission; never retries or renews a budget. */
76
+ export async function confirmOneUseRetry(dispatchId: string, ctx: ExtensionContext, ports: RetryAuthorizationPorts, signal?: AbortSignal): Promise<{ authorized: boolean; reason: string; correlation: BudgetCorrelation }> {
77
+ const correlation: BudgetCorrelation = { taskId: ports.taskId(), tranche: 0, requestId: randomUUID(), operation: "retry" };
78
+ const controller = new AbortController();
79
+ const abort = () => controller.abort();
80
+ if (signal?.aborted) abort(); else signal?.addEventListener("abort", abort, { once: true });
81
+ const bg = /bulgarian|българ/i.test(ports.language());
82
+ const params: RuntimeQuestion = {
83
+ question: bg ? "Да разреша ли еднократно повторение след отмяна от оператор?" : "Authorize one retry after operator cancellation?",
84
+ context: `${bg ? "Отменено изпълнение" : "Cancelled run"}: ${dispatchId}\n${correlation.taskId} · ${correlation.operation} · ${correlation.requestId}`,
85
+ options: bg ? ["Да — разреши веднъж", "Не — не разрешавай"] : ["Yes — authorize once", "No — do not authorize"],
86
+ allowMultiple: false, allowFreeform: false, allowComment: false,
87
+ };
88
+ let result: unknown;
89
+ ports.startWait(correlation.requestId);
90
+ try { result = await ports.ask(correlation.requestId, params, ctx, controller.signal); }
91
+ catch { return { authorized: false, reason: "retry_confirmation_failed", correlation }; }
92
+ finally { ports.endWait(correlation.requestId, ports.taskId() === correlation.taskId); signal?.removeEventListener("abort", abort); }
93
+ if (controller.signal.aborted || ports.taskId() !== correlation.taskId || !isAffirmative(result, params, correlation)) return { authorized: false, reason: "retry_stale_or_denied", correlation };
94
+ return ports.authorize(dispatchId)
95
+ ? { authorized: true, reason: "retry_authorized_once", correlation }
96
+ : { authorized: false, reason: "retry_unknown_stale_or_duplicate", correlation };
97
+ }
98
+
99
+ export interface TaskSupersessionPorts {
100
+ language(): string;
101
+ ask(id: string, params: RuntimeQuestion, ctx: ExtensionContext, signal: AbortSignal): Promise<unknown>;
102
+ startWait(id: string): void;
103
+ endWait(id: string, sameTask: boolean): void;
104
+ currentTaskId(): string;
105
+ }
106
+
107
+ /** One-use operator decision bound to old/new task identities; callers mutate state only after true. */
108
+ export async function confirmTaskSupersession(input: { oldTaskId: string; newTaskId: string; reason: string }, ctx: ExtensionContext, ports: TaskSupersessionPorts, signal?: AbortSignal): Promise<boolean> {
109
+ const requestId = randomUUID(), controller = new AbortController(), abort = () => controller.abort();
110
+ if (signal?.aborted) abort(); else signal?.addEventListener("abort", abort, { once: true });
111
+ const bg = /bulgarian|българ/i.test(ports.language());
112
+ const question: RuntimeQuestion = { question: bg ? "Да изоставя ли еднократно отворените задължения на старата задача?" : "Authorize one-time abandonment of the old task's open obligations?", context: `${input.oldTaskId} → ${input.newTaskId}\n${input.reason}\noperation:supersede\n${requestId}`, options: bg ? ["Да — замени задачата", "Не — запази старата"] : ["Yes — supersede once", "No — keep old task"], allowMultiple: false, allowFreeform: false, allowComment: false };
113
+ ports.startWait(requestId); let result: unknown;
114
+ try { result = await ports.ask(requestId, question, ctx, controller.signal); } catch { return false; }
115
+ finally { ports.endWait(requestId, ports.currentTaskId() === input.oldTaskId); signal?.removeEventListener("abort", abort); }
116
+ const correlation: BudgetCorrelation = { taskId: input.oldTaskId, tranche: 0, requestId, operation: "supersede" };
117
+ return !controller.signal.aborted && ports.currentTaskId() === input.oldTaskId && isAffirmative(result, question, correlation);
29
118
  }
30
119
 
31
120
  /** Task-scoped, single-flight human authorization. Tool prose is never an input. */
32
121
  export function createBudgetRecovery(ports: BudgetRecoveryPorts): BudgetRecovery {
33
122
  let taskId = randomUUID(), tranche = 0;
34
- let stopped: { refusal: BudgetRefusal; next: string; block: BudgetBlock } | null = null;
35
- let pending: { controller: AbortController; result: Promise<BudgetBlock | null> } | null = null;
123
+ let stopped: { refusal: BudgetRefusal; operation: BudgetOperation; next: string; block: BudgetBlock } | null = null;
124
+ let pending: { controller: AbortController; operation: BudgetOperation; result: Promise<BudgetBlock | null> } | null = null;
36
125
  const block = (ctx: ExtensionContext, reason = "budget_stopped", detail = ""): BudgetBlock => {
37
126
  const message = /bulgarian|българ/i.test(ports.language())
38
127
  ? `Бюджетът не е разрешен. Изпълнението е спряно. Само човекът може да поиска ново потвърждение с /af-budget-continue.${detail ? ` ${detail}` : ""}`
@@ -41,21 +130,21 @@ export function createBudgetRecovery(ports: BudgetRecoveryPorts): BudgetRecovery
41
130
  ctx.abort();
42
131
  return { reason, message };
43
132
  };
44
- const confirm = (refusal: BudgetRefusal, next: string, ctx: ExtensionContext, signal?: AbortSignal) => {
133
+ const confirm = (refusal: BudgetRefusal, operation: BudgetOperation, next: string, ctx: ExtensionContext, signal?: AbortSignal) => {
45
134
  if (pending) return pending.result;
46
- const correlation = { taskId, tranche, requestId: randomUUID() };
135
+ const correlation = { taskId, tranche, requestId: randomUUID(), operation };
47
136
  const controller = new AbortController();
48
137
  const abort = () => controller.abort();
49
138
  if (signal?.aborted) abort(); else signal?.addEventListener("abort", abort, { once: true });
50
139
  const bg = /bulgarian|българ/i.test(ports.language());
51
140
  const params: RuntimeQuestion = {
52
141
  question: bg ? "Да разреша ли още един бюджетен прозорец за същата задача?" : "Authorize one more budget window for this same task?",
53
- context: `${refusal.message}\n${bg ? "Следваща операция" : "Next operation"}: ${next.slice(0, 500)}\n${refusal.kind} · ${correlation.taskId} · ${correlation.tranche} · ${correlation.requestId}`,
142
+ context: `${refusal.message}\n${bg ? "Следваща операция" : "Next operation"}: ${operation} · ${next.slice(0, 500)}\n${refusal.kind} · ${correlation.taskId} · ${correlation.tranche} · ${correlation.requestId}`,
54
143
  options: bg ? ["Да — продължи", "Не — спри"] : ["Yes — continue", "No — stop"],
55
144
  allowMultiple: false, allowFreeform: false, allowComment: false,
56
145
  };
57
146
  // Defer execution until the single-flight latch is installed.
58
- const current = { controller, result: Promise.resolve(null) as Promise<BudgetBlock | null> };
147
+ const current = { controller, operation, result: Promise.resolve(null) as Promise<BudgetBlock | null> };
59
148
  pending = current;
60
149
  current.result = Promise.resolve().then(async () => {
61
150
  let result: unknown, failure = "";
@@ -65,9 +154,9 @@ export function createBudgetRecovery(ports: BudgetRecoveryPorts): BudgetRecovery
65
154
  finally { ports.endWait(correlation.requestId, taskId === correlation.taskId); signal?.removeEventListener("abort", abort); }
66
155
  // Task reset, abort, or a replay can never authorize a different tranche.
67
156
  if (taskId !== correlation.taskId || tranche !== correlation.tranche) return { reason: "budget_stale", message: "Stale budget confirmation ignored; no operation authorized." };
68
- if (controller.signal.aborted || !isAffirmative(result, params)) {
157
+ if (controller.signal.aborted || !isAffirmative(result, params, correlation)) {
69
158
  const denied = block(ctx, failure ? "budget_confirmation_failed" : "budget_stopped", failure);
70
- stopped = { refusal, next, block: denied }; return denied;
159
+ stopped = { refusal, operation, next, block: denied }; return denied;
71
160
  }
72
161
  tranche++;
73
162
  ports.renew(refusal, correlation, ctx);
@@ -80,18 +169,23 @@ export function createBudgetRecovery(ports: BudgetRecoveryPorts): BudgetRecovery
80
169
  if (signal?.aborted) return { reason: "budget_stopped", message: "Operation cancelled before dispatch." };
81
170
  if (stopped) { ctx.abort(); return stopped.block; }
82
171
  if (pending) {
83
- const result = await pending.result;
84
- return signal?.aborted ? { reason: "budget_stopped", message: "Operation cancelled before dispatch." } : result;
172
+ const active = pending;
173
+ const result = await active.result;
174
+ if (signal?.aborted) return { reason: "budget_stopped", message: "Operation cancelled before dispatch." };
175
+ if (result || active.operation === operation) return result;
176
+ const refusal = ports.check(operation);
177
+ return refusal ? confirm(refusal, operation, next, ctx, signal) : null;
85
178
  }
86
179
  const refusal = ports.check(operation);
87
- return refusal ? confirm(refusal, next, ctx, signal) : null;
180
+ return refusal ? confirm(refusal, operation, next, ctx, signal) : null;
88
181
  },
89
182
  async resume(ctx) {
90
183
  if (pending) return pending.result;
91
184
  if (!stopped) return null;
92
185
  const previous = stopped; stopped = null;
93
- return confirm(previous.refusal, previous.next, ctx);
186
+ return confirm(previous.refusal, previous.operation, previous.next, ctx);
94
187
  },
95
- reset() { taskId = randomUUID(); tranche = 0; stopped = null; pending?.controller.abort(); pending = null; },
188
+ adopt(id: string) { taskId = id; tranche = 0; stopped = null; pending?.controller.abort(); pending = null; },
189
+ reset() { this.adopt(randomUUID()); },
96
190
  };
97
191
  }
@@ -110,7 +110,10 @@ function intentFor(text: string): Record<Exclude<CapabilityPack, "core">, boolea
110
110
  const normalized = text.toLowerCase();
111
111
  return {
112
112
  fleet: matches(normalized, /\b(dispatch|delegate|delegation|specialist|research(?:\s+helper)?|spawn\s+(?:an?\s+)?agent)\b/),
113
- verification: matches(normalized, /\b(verification|verify|acceptance\s+(?:criteria|gate|work)|assertions?|parity)\b/),
113
+ // Language is supplementary discovery only. Writable-operation acceptance is
114
+ // enforced independently by the dispatch task contract.
115
+ verification: matches(normalized, /\b(verification|verify|acceptance\s+(?:criteria|gate|work)|assertions?|parity)\b/)
116
+ || matches(normalized, /(?:провери|проверка|критери(?:и|ите)\s+за\s+приемане|приемателн(?:и|ите)\s+критерии|верификац)/),
114
117
  peer: matches(normalized, /\b(coms|existing\s+peer|peer\s+(?:message|reply|channel)|message\s+(?:the\s+)?peer)\b/),
115
118
  workspace: matches(normalized, /\b(herdr|(?:open|spawn)\s+(?:a\s+)?pane|watcher|notify|notification)\b/),
116
119
  compaction: matches(normalized, /\b(compaction|request_compaction|compact\s+(?:the\s+)?(?:context|conversation|session))\b/),
@@ -0,0 +1,9 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import type { CommandContext } from "./context.ts";
3
+
4
+ export function registerAudit(pi: ExtensionAPI, commandCtx: CommandContext): void {
5
+ pi.registerCommand("af-audit", {
6
+ description: "Show a read-only sanitized audit of this Hub session",
7
+ handler: async (_args, ctx) => commandCtx.handleAudit(ctx),
8
+ });
9
+ }
@@ -17,6 +17,7 @@ export interface CommandContext {
17
17
  handleAgentsKill(args: string, ctx: ExtensionContext): Promise<void>;
18
18
  handleAgentsRestart(args: string, ctx: ExtensionContext): Promise<void>;
19
19
  handleContext(args: string, ctx: ExtensionContext): Promise<void>;
20
+ handleAudit(ctx: ExtensionContext): Promise<void>;
20
21
  handleHubReport(args: string, ctx: ExtensionContext): Promise<void>;
21
22
  handleZoom(args: string, ctx: ExtensionContext): Promise<void>;
22
23
  handleDispatchPolicy(args: string, ctx: ExtensionContext): Promise<void>;
@@ -4,7 +4,7 @@ import type { CommandContext } from "./context.ts";
4
4
  /** Human-only, failure-ID-bound one-shot authorization. Never executes work. */
5
5
  export function registerRetry(pi: ExtensionAPI, commandCtx: CommandContext): void {
6
6
  pi.registerCommand("af-retry", {
7
- description: "Authorize one same-input retry of a failed dispatch; no budget renewal or automatic dispatch.",
7
+ description: "Authorize one retry after operator cancellation only; no budget renewal or automatic dispatch.",
8
8
  handler: async (args, ctx) => commandCtx.handleRetry(args, ctx),
9
9
  });
10
10
  }
@@ -97,6 +97,7 @@ export function parseAgentFile(filePath: string): AgentDef | null {
97
97
  }
98
98
  return {
99
99
  name: frontmatter.name, description: frontmatter.description || "", tools: frontmatter.tools || "read,grep,find,ls",
100
+ toolsExplicit: typeof frontmatter.tools === "string" && frontmatter.tools.trim().length > 0,
100
101
  model: frontmatter.model || undefined, models: lists.models, subagents, delegateDepth,
101
102
  warnings: warnings.length ? warnings : undefined, kind: frontmatter.kind || undefined,
102
103
  thinking: frontmatter.thinking || undefined, systemPrompt: match[2].trim(), file: filePath,
@@ -7,6 +7,11 @@ export interface ProfileVoice extends ModelSelection {
7
7
  name: string;
8
8
  integrator?: boolean;
9
9
  }
10
+ export interface AssistFlags {
11
+ 'deterministic-tools'?: boolean;
12
+ 'bounded-output'?: boolean;
13
+ 'write-isolation'?: boolean;
14
+ }
10
15
  export interface CompleteModelProfile {
11
16
  version: 2;
12
17
  defaults: ModelSelection;
@@ -21,6 +26,7 @@ export interface CompleteModelProfile {
21
26
  routing?: 'native' | 'configured';
22
27
  fallback?: 'none' | 'declared';
23
28
  'allowed-models'?: string[];
29
+ assist?: AssistFlags;
24
30
  }
25
31
  export type ModelProfile = Record<string, string> | CompleteModelProfile;
26
32
  export type ModelProfiles = Record<string, ModelProfile>;
@@ -65,10 +71,23 @@ function namedSelections(value: unknown, label: string): Record<string, ModelSel
65
71
  export function parseCompleteProfile(raw: unknown): CompleteModelProfile {
66
72
  if (!object(raw))
67
73
  throw new Error('profile: expected mapping');
68
- keys(raw, ['version', 'defaults', 'agents', 'subagents', 'dispatcher', 'services', 'panel', 'routing', 'fallback', 'allowed-models'], 'profile');
74
+ keys(raw, ['version', 'defaults', 'agents', 'subagents', 'dispatcher', 'services', 'panel', 'routing', 'fallback', 'allowed-models', 'assist'], 'profile');
69
75
  if (raw.version !== 2)
70
76
  throw new Error('profile: version must be 2');
71
77
  const p: CompleteModelProfile = { version: 2, defaults: selection(raw.defaults, 'defaults'), routing: 'native', fallback: 'none' };
78
+ if (raw.assist !== undefined) {
79
+ if (!object(raw.assist))
80
+ throw new Error('assist: expected mapping');
81
+ keys(raw.assist, ['deterministic-tools', 'bounded-output', 'write-isolation'], 'assist');
82
+ p.assist = {};
83
+ for (const key of ['deterministic-tools', 'bounded-output', 'write-isolation'] as const) {
84
+ if (raw.assist[key] !== undefined) {
85
+ if (typeof raw.assist[key] !== 'boolean')
86
+ throw new Error(`assist.${key}: expected boolean`);
87
+ p.assist[key] = raw.assist[key];
88
+ }
89
+ }
90
+ }
72
91
  if (raw.agents !== undefined)
73
92
  p.agents = namedSelections(raw.agents, 'agents');
74
93
  if (raw.subagents !== undefined) {
@@ -12,8 +12,13 @@ export interface Assertion {
12
12
  tag: string;
13
13
  text: string;
14
14
  source: string;
15
+ reference?: string;
16
+ criticalConditions?: string[];
17
+ testCommand?: string;
15
18
  status: AssertionStatus;
16
19
  evidence?: string;
20
+ evidenceTaskId?: string;
21
+ evidenceRevision?: string;
17
22
  }
18
23
 
19
24
  export interface InputArtifactPreview {
@@ -70,8 +75,11 @@ export function createAssertionsArtifactsContext(state: AssertionsArtifactsState
70
75
  };
71
76
  const renderAssertionLedgerLines = () => state.getAssertions().map(assertion => {
72
77
  const evidence = assertion.evidence ? ` — evidence: ${assertion.evidence}` : "";
73
- const source = assertion.source ? ` ⇐ ${assertion.source}` : "";
74
- return `${assertion.id} [${assertion.tag}] ${assertion.status.toUpperCase()}: ${assertion.text}${source}${evidence}`;
78
+ const origin = [assertion.source, assertion.reference].filter(Boolean).join(" · ");
79
+ const source = origin ? ` ⇐ ${origin}` : "";
80
+ const critical = assertion.criticalConditions?.length ? ` — critical: ${assertion.criticalConditions.join("; ")}` : "";
81
+ const binding = assertion.evidenceTaskId || assertion.evidenceRevision ? ` — bound: ${assertion.evidenceTaskId ?? "?"}@${assertion.evidenceRevision ?? "?"}` : "";
82
+ return `${assertion.id} [${assertion.tag}] ${assertion.status.toUpperCase()}: ${assertion.text}${source}${critical}${assertion.testCommand ? ` — test command: ${JSON.stringify(assertion.testCommand)}` : ""}${evidence}${binding}`;
75
83
  });
76
84
  const renderAssertionLedgerText = () => state.getAssertions().length === 0
77
85
  ? ""
@@ -39,6 +39,7 @@ export interface BudgetStatePorts {
39
39
  setTurnBudgetAskUserWaitMs(value: number): void;
40
40
  resetBudgetRecovery(): void;
41
41
  resetNoProgress(): void;
42
+ resetUnknownToolCounter(): void;
42
43
  getTaskContinuationCount(): number;
43
44
  setTaskContinuationCount(value: number): void;
44
45
  getTurnContinuationCount(): number;
@@ -157,6 +158,7 @@ export function createBudgetContext(state: BudgetStatePorts): BudgetContext {
157
158
  state.setTaskContinuationCount(0);
158
159
  state.resetBudgetRecovery();
159
160
  state.resetNoProgress();
161
+ state.resetUnknownToolCounter();
160
162
  state.setTaskLabel(label);
161
163
  state.setTaskTier(null);
162
164
  state.setTaskTierAssumed(false);
@@ -32,6 +32,9 @@
32
32
  */
33
33
 
34
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";
35
38
  import { Type } from "@sinclair/typebox";
36
39
  import { appendFileSync, mkdirSync, writeFileSync } from "fs";
37
40
  import type { ChildProcess } from "child_process";
@@ -75,6 +78,10 @@ export interface DelegateConfig {
75
78
  reconSearchTimeoutMs?: number | null;
76
79
  /** Whole-run deadline per delegate child (hub mode budget); null/absent = off. */
77
80
  turnDeadlineMs?: number | null;
81
+ boundedOutput?: boolean;
82
+ boundedOutputDir?: string;
83
+ deterministicTools?: boolean;
84
+ filesystemSessionDir?: string;
78
85
  cwd: string;
79
86
  }
80
87
 
@@ -259,7 +266,11 @@ export default function (pi: ExtensionAPI) {
259
266
  const childDepth = plan.childDepth;
260
267
  const childRemainingSpawns = plan.childRemainingSpawns;
261
268
  const childCanDelegate = plan.childCanDelegate;
262
- const childExtensions = plan.childExtensions;
269
+ const childExtensions = [
270
+ ...plan.childExtensions,
271
+ ...(config.boundedOutput ? [fileURLToPath(new URL("./bounded-output.ts", import.meta.url))] : []),
272
+ ...(config.deterministicTools ? [fileURLToPath(new URL("./filesystem-tool.ts", import.meta.url))] : []),
273
+ ];
263
274
  const childTools = plan.childTools;
264
275
  const childConfig: DelegateConfig | null = plan.includeDelegateConfig ? {
265
276
  ...config,
@@ -272,6 +283,7 @@ export default function (pi: ExtensionAPI) {
272
283
  const sessionsDir = safePathWithin(config.eventDir, "sessions");
273
284
  const resultsDir = safePathWithin(config.eventDir, "results");
274
285
  const childSessionFile = safePathWithin(sessionsDir, `${childId}.jsonl`);
286
+ const boundedOutputDir = config.boundedOutput ? safePathWithin(config.boundedOutputDir ?? config.eventDir, childId) : undefined;
275
287
  const childResultFile = safePathWithin(resultsDir, `${childId}.md`);
276
288
  try { mkdirSync(sessionsDir, { recursive: true }); } catch {}
277
289
  try { mkdirSync(resultsDir, { recursive: true }); } catch {}
@@ -336,7 +348,12 @@ export default function (pi: ExtensionAPI) {
336
348
  sessionFile: childSessionFile,
337
349
  prompt,
338
350
  extensions: childExtensions,
339
- env: childConfig ? { AGENT_HUB_DELEGATE_CONFIG: JSON.stringify(childConfig) } : undefined,
351
+ env: {
352
+ ...(childConfig ? { AGENT_HUB_DELEGATE_CONFIG: JSON.stringify(childConfig) } : {}),
353
+ ...(boundedOutputDir ? { [BOUNDED_OUTPUT_DIR_ENV]: boundedOutputDir } : {}),
354
+ ...(config.deterministicTools && config.filesystemSessionDir ? { [FILESYSTEM_SESSION_DIR_ENV]: config.filesystemSessionDir } : {}),
355
+ },
356
+ ...(boundedOutputDir ? { boundedOutputDir } : {}),
340
357
  cwd: config.cwd,
341
358
  // Each nested child owns its group. The SIGTERM trap above forwards
342
359
  // parent cancellation so detached children cannot become orphans.
@@ -0,0 +1,127 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } 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
+ function fileState(path: string, allowedRoot?: string) {
27
+ const checked = checkedExisting(path, allowedRoot);
28
+ if (!existsSync(checked) || !statSync(checked).isFile()) throw new Error(`Not a regular file: ${path}`);
29
+ const bytes = readFileSync(checked);
30
+ return { path: checked, bytes, hash: sha256(bytes) };
31
+ }
32
+ function directoryState(root: string) {
33
+ const checked = checkedExisting(root, root);
34
+ if (!statSync(checked).isDirectory()) throw new Error(`Not a directory: ${root}`);
35
+ const rootReal = realpathSync(checked);
36
+ const entries = readdirSync(checked, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name)).map(entry => {
37
+ const path = join(checked, entry.name), lst = lstatSync(path);
38
+ if (lst.isSymbolicLink()) {
39
+ try {
40
+ if (!within(rootReal, realpathSync(path))) return { name: entry.name, path, type: "symlink", bytes: null, denied: true, reason: "symlink-target-outside-root" };
41
+ } catch {
42
+ return { name: entry.name, path, type: "symlink", bytes: null, denied: true, reason: "symlink-target-unavailable" };
43
+ }
44
+ }
45
+ return { name: entry.name, path, type: entry.isDirectory() ? "directory" : entry.isFile() ? "file" : entry.isSymbolicLink() ? "symlink" : "other", bytes: entry.isFile() ? lst.size : null };
46
+ });
47
+ return { root: checked, entries, hash: sha256(JSON.stringify(entries)) };
48
+ }
49
+ function utf8Preview(bytes: Buffer, chars = PREVIEW_CHARS): string {
50
+ return [...bytes.toString("utf8")].slice(0, chars).join("");
51
+ }
52
+ function lineAt(bytes: Buffer, offset: number): number { return offset === 0 ? 1 : bytes.subarray(0, offset).toString("utf8").split("\n").length; }
53
+
54
+ export function inventory(input: { root: string; handle?: string; pageSize?: number; boundedOutput?: boolean; followSymlinkEscape?: boolean }) {
55
+ if (input.followSymlinkEscape) throw new Error("Symlink escape following is forbidden");
56
+ const state = directoryState(input.root);
57
+ let offset = 0;
58
+ if (input.handle) {
59
+ const handle = decode(input.handle);
60
+ if (handle.kind !== "inventory" || resolve(handle.path) !== state.root || handle.hash !== state.hash) throw new Error("Stale inventory handle");
61
+ offset = handle.offset;
62
+ }
63
+ const requested = input.pageSize ?? INVENTORY_PAGE_ENTRIES;
64
+ const pageSize = input.boundedOutput === false ? requested : Math.min(requested, INVENTORY_PAGE_ENTRIES);
65
+ const entries = state.entries.slice(offset, offset + pageSize), nextOffset = offset + entries.length;
66
+ const nextHandle = nextOffset < state.entries.length ? encode({ v: 1, kind: "inventory", path: state.root, hash: state.hash, offset: nextOffset }) : null;
67
+ 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 };
68
+ }
69
+
70
+ export function excerpt(input: { path: string; allowedRoot?: string; handle?: string; offset?: number; maxBytes?: number; previewChars?: number; boundedOutput?: boolean }) {
71
+ const state = fileState(input.path, input.allowedRoot);
72
+ let offset = input.offset ?? 0;
73
+ if (input.handle) {
74
+ const handle = decode(input.handle);
75
+ if (handle.kind !== "file" || resolve(handle.path) !== state.path || handle.hash !== state.hash) throw new Error("Stale file handle");
76
+ offset = handle.offset;
77
+ }
78
+ if (!Number.isSafeInteger(offset) || offset < 0 || offset > state.bytes.length) throw new Error("Invalid excerpt offset");
79
+ const requested = input.maxBytes ?? (input.boundedOutput === false ? state.bytes.length : CONTENT_REPLY_BYTES);
80
+ const maxBytes = input.boundedOutput === false ? requested : Math.min(requested, CONTENT_REPLY_BYTES);
81
+ const content = state.bytes.subarray(offset, Math.min(state.bytes.length, offset + maxBytes));
82
+ const nextOffset = offset + content.length, nextHandle = nextOffset < state.bytes.length ? encode({ v: 1, kind: "file", path: state.path, hash: state.hash, offset: nextOffset }) : null;
83
+ return { path: state.path, reference: `${state.path}:${lineAt(state.bytes, offset)}`, hash: state.hash, offset, content: Buffer.from(content), contentBytes: content.length, totalBytes: state.bytes.length, 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 };
84
+ }
85
+
86
+ export function readback(input: { handle: string; expectedHash?: string; allowedRoot?: string; maxBytes?: number; boundedOutput?: boolean }) {
87
+ const handle = decode(input.handle);
88
+ if (handle.kind !== "file") throw new Error("Readback requires a file handle");
89
+ const state = fileState(handle.path, input.allowedRoot);
90
+ if (state.hash !== handle.hash || (input.expectedHash && state.hash !== input.expectedHash)) throw new Error("Stale file handle: source bytes changed");
91
+ return excerpt({ path: state.path, allowedRoot: input.allowedRoot, offset: handle.offset, maxBytes: input.maxBytes, boundedOutput: input.boundedOutput });
92
+ }
93
+
94
+ export function snapshotSource(input: { origin: "file"; path: string; allowedRoot?: string; sessionDir?: string }) {
95
+ if (input.origin !== "file") throw new Error(`Unsupported origin ${String(input.origin)}: snapshots accept local files only and never fetch the network`);
96
+ const state = fileState(input.path, input.allowedRoot);
97
+ const sessionDir = resolve(input.sessionDir ?? join(dirname(state.path), ".snapshots"));
98
+ mkdirSync(sessionDir, { recursive: true, mode: 0o700 });
99
+ const root = checkedExisting(sessionDir, sessionDir);
100
+ const dir = join(root, "artifacts", "evidence", "snapshots"); mkdirSync(dir, { recursive: true, mode: 0o700 }); checkedExisting(dir, root);
101
+ const contentPath = join(dir, `${state.hash}-${basename(state.path)}`);
102
+ if (!existsSync(contentPath)) copyFileSync(state.path, contentPath);
103
+ else {
104
+ const existing = fileState(contentPath, root);
105
+ if (existing.hash !== state.hash) throw new Error(`Snapshot collision or stale target: ${contentPath}`);
106
+ }
107
+ const metadataPath = `${contentPath}.json`;
108
+ if (!existsSync(metadataPath)) writeFileSync(metadataPath, JSON.stringify({ source: { origin: "file", path: state.path, bytes: state.bytes.length }, sha256: state.hash, contentPath, untrusted: true, modelDelegated: false }, null, 2), { mode: 0o600 });
109
+ else checkedExisting(metadataPath, root);
110
+ return { source: { origin: "file" as const, path: state.path, bytes: state.bytes.length }, hash: state.hash, contentPath, metadataPath, handle: encode({ v: 1, kind: "file", path: contentPath, hash: state.hash, offset: 0 }), untrusted: true, modelDelegated: false };
111
+ }
112
+
113
+ function utf8Prefix(buffer: Buffer, maxBytes: number): Buffer {
114
+ let end = Math.min(maxBytes, buffer.length);
115
+ while (end > 0 && (buffer[end] & 0xc0) === 0x80) end--;
116
+ return buffer.subarray(0, end);
117
+ }
118
+ export function boundOutput(input: { content: string | Buffer; retentionDir: string; label?: string }) {
119
+ const bytes = Buffer.isBuffer(input.content) ? input.content : Buffer.from(input.content, "utf8");
120
+ const dir = resolve(input.retentionDir); mkdirSync(dir, { recursive: true, mode: 0o700 });
121
+ const hash = sha256(bytes), contentPath = join(dir, `${input.label ?? "output"}-${randomUUID()}`); writeFileSync(contentPath, bytes, { mode: 0o600 });
122
+ const handle = encode({ v: 1, kind: "file", path: contentPath, hash, offset: 0 });
123
+ if (bytes.length <= CONTENT_REPLY_BYTES) return { reply: bytes.toString("utf8"), contentPath, handle, hash, totalBytes: bytes.length, truncated: false };
124
+ const suffix = Buffer.from(`\n\n[truncated: ${bytes.length} bytes total; full output handle ${handle}; path ${contentPath}]`, "utf8");
125
+ const prefix = utf8Prefix(bytes, CONTENT_REPLY_BYTES - suffix.length);
126
+ return { reply: Buffer.concat([prefix, suffix]).toString("utf8"), contentPath, handle, hash, totalBytes: bytes.length, truncated: true };
127
+ }
@@ -0,0 +1,26 @@
1
+ // Compatibility library for historical benchmark imports. No extension factory or import-time effects.
2
+ export const DIAGNOSTIC_TRANSPORT_REFUSAL_EXIT = 73;
3
+
4
+ export type ProviderOutputCapField = "max_output_tokens" | "max_completion_tokens" | "max_tokens";
5
+ export interface ProviderModelIdentity { provider?: unknown; api?: unknown; compat?: { maxTokensField?: unknown } }
6
+
7
+ /** Apply only installed, reviewed provider/API semantics; body fields alone never select a mapping. */
8
+ export function applyProviderOutputTokenCap(payload: Record<string, unknown>, model: ProviderModelIdentity | undefined, limit: unknown): { payload: Record<string, unknown>; field: ProviderOutputCapField } {
9
+ if (limit !== 2048) throw new Error("approved output-token cap must be exactly 2048");
10
+ const provider = model?.provider;
11
+ const api = model?.api;
12
+ const hasResponsesShape = typeof payload.model === "string" && payload.model.length > 0 && Array.isArray(payload.input) && payload.input.length > 0 && payload.stream === true && !Object.prototype.hasOwnProperty.call(payload, "messages");
13
+ const hasCompletionsShape = typeof payload.model === "string" && payload.model.length > 0 && Array.isArray(payload.messages) && payload.messages.length > 0 && payload.stream === true && !Object.prototype.hasOwnProperty.call(payload, "input");
14
+ const capFields: ProviderOutputCapField[] = ["max_output_tokens", "max_completion_tokens", "max_tokens"];
15
+ let field: ProviderOutputCapField;
16
+ if (provider === "xai" && api === "openai-responses" && hasResponsesShape) field = "max_output_tokens";
17
+ else if (provider === "omlx" && api === "openai-completions" && hasCompletionsShape) {
18
+ const configured = model?.compat?.maxTokensField;
19
+ if (configured === undefined) field = "max_completion_tokens";
20
+ else if (configured === "max_completion_tokens" || configured === "max_tokens") field = configured;
21
+ else throw new Error("unsupported OMLX compat maxTokensField");
22
+ }
23
+ else throw new Error("unsupported provider/API output-cap semantics or payload shape");
24
+ if (capFields.some(candidate => candidate !== field && Object.prototype.hasOwnProperty.call(payload, candidate))) throw new Error("payload contains an output-cap field incompatible with provider/API semantics");
25
+ return { payload: { ...payload, [field]: limit }, field };
26
+ }