@chankov/agent-fleet 2.0.9 → 2.0.10

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 (465) hide show
  1. package/.pi/extensions/pi-voice-stt/README.md +24 -5
  2. package/.pi/extensions/pi-voice-stt/examples/stt.json +4 -4
  3. package/.pi/harnesses/agent-hub/package.json +1 -1
  4. package/.pi/harnesses/agent-hub/return-contract.js +34 -0
  5. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +80 -18
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  9. package/.versions/2.0.10/.pi/agent-fleet/hermes/README.md +347 -0
  10. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  11. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  12. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  13. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  14. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  15. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  16. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  17. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  18. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  19. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  20. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  21. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  22. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  23. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  24. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  25. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  26. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  27. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  28. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  29. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  30. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  31. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  32. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  33. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  34. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  35. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  36. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  37. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  38. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  39. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  40. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  41. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  42. package/.versions/2.0.10/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  43. package/.versions/2.0.10/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  44. package/.versions/2.0.10/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  45. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  46. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  47. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  48. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  49. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  50. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet.ts +216 -0
  51. package/.versions/2.0.10/.pi/agent-fleet/scripts/flow.ts +137 -0
  52. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  53. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  54. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  55. package/.versions/2.0.10/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  56. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  57. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  58. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  59. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  60. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  61. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  62. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  63. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  64. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  65. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  66. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  67. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  68. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  69. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  70. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  71. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  72. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  73. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  74. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  75. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  76. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  77. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  78. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  79. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  80. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  81. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  82. package/.versions/2.0.10/.pi/agent-fleet/scripts/package-lock.json +35 -0
  83. package/.versions/2.0.10/.pi/agent-fleet/scripts/package.json +9 -0
  84. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  85. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  86. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  87. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-up.ts +378 -0
  88. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  89. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  90. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  91. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  92. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  93. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  94. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  95. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  96. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  97. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  98. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  99. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  100. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  101. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  102. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  103. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  104. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  105. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  106. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  107. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  108. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  109. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  110. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  111. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  112. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  113. package/.versions/2.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  114. package/.versions/2.0.10/.pi/agents/model-profiles.yaml +83 -0
  115. package/.versions/2.0.10/.pi/agents/peers.yaml +147 -0
  116. package/.versions/2.0.10/.pi/agents/teams.yaml +41 -0
  117. package/.versions/2.0.10/.pi/agents/voices.yaml +13 -0
  118. package/.versions/2.0.10/.pi/damage-control-rules.yaml +297 -0
  119. package/.versions/2.0.10/.pi/extensions/btw/README.md +120 -0
  120. package/.versions/2.0.10/.pi/extensions/btw/index.ts +914 -0
  121. package/.versions/2.0.10/.pi/extensions/btw/package.json +6 -0
  122. package/.versions/2.0.10/.pi/extensions/btw/state.js +179 -0
  123. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  124. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  125. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  126. package/.versions/2.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  127. package/.versions/2.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  128. package/.versions/2.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  129. package/.versions/2.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  130. package/.versions/2.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  131. package/.versions/2.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  132. package/.versions/2.0.10/.pi/extensions/package-lock.json +1175 -0
  133. package/.versions/2.0.10/.pi/extensions/package.json +9 -0
  134. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/README.md +224 -0
  135. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  136. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  137. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  138. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  139. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  140. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  141. package/.versions/2.0.10/.pi/harnesses/agent-hub/README.md +1217 -0
  142. package/.versions/2.0.10/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  143. package/.versions/2.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  144. package/.versions/2.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  145. package/.versions/2.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  146. package/.versions/2.0.10/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  147. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  148. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  149. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  150. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  151. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  152. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  153. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  154. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  155. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  156. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  157. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  158. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  159. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  160. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  161. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  162. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  163. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  164. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  165. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  166. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  167. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  168. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  169. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  170. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  171. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  172. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  173. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  174. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  175. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  176. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  177. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  178. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  179. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  180. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  181. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  182. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  183. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  184. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  185. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  186. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  187. package/.versions/2.0.10/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  188. package/.versions/2.0.10/.pi/harnesses/agent-hub/delegate.ts +446 -0
  189. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  190. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  191. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  192. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  193. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  194. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  195. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  196. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  197. package/.versions/2.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  198. package/.versions/2.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  199. package/.versions/2.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  200. package/.versions/2.0.10/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  201. package/.versions/2.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  202. package/.versions/2.0.10/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  203. package/.versions/2.0.10/.pi/harnesses/agent-hub/footer.ts +30 -0
  204. package/.versions/2.0.10/.pi/harnesses/agent-hub/helpers.ts +266 -0
  205. package/.versions/2.0.10/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  206. package/.versions/2.0.10/.pi/harnesses/agent-hub/index.ts +2132 -0
  207. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  208. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  209. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  210. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  211. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  212. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  213. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  214. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  215. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  216. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  217. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  218. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  219. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  220. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  221. package/.versions/2.0.10/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  222. package/.versions/2.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  223. package/.versions/2.0.10/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  224. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  225. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  226. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  227. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  228. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  229. package/.versions/2.0.10/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  230. package/.versions/2.0.10/.pi/harnesses/agent-hub/presentation.ts +48 -0
  231. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  232. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  233. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  234. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  235. package/.versions/2.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  236. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  237. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  238. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  239. package/.versions/2.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  240. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-contract.js +327 -0
  241. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  242. package/.versions/2.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  243. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-budget.js +537 -0
  244. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  245. package/.versions/2.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  246. package/.versions/2.0.10/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  247. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  248. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-start.ts +42 -0
  249. package/.versions/2.0.10/.pi/harnesses/agent-hub/spawn.ts +404 -0
  250. package/.versions/2.0.10/.pi/harnesses/agent-hub/timeline.ts +54 -0
  251. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  252. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  253. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  254. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  255. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +335 -0
  256. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  257. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  258. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  259. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  260. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  261. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  262. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  263. package/.versions/2.0.10/.pi/harnesses/agent-hub/types.ts +63 -0
  264. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  265. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  266. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  267. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  268. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  269. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  270. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  271. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  272. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  273. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  274. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  275. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  276. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  277. package/.versions/2.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  278. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  279. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  280. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/README.md +59 -0
  281. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/index.ts +558 -0
  282. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  283. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  284. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  285. package/.versions/2.0.10/.pi/harnesses/coms/README.md +100 -0
  286. package/.versions/2.0.10/.pi/harnesses/coms/index.ts +282 -0
  287. package/.versions/2.0.10/.pi/harnesses/coms/package.json +7 -0
  288. package/.versions/2.0.10/.pi/harnesses/coms/version.ts +42 -0
  289. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/README.md +135 -0
  290. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/index.ts +541 -0
  291. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  292. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  293. package/.versions/2.0.10/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  294. package/.versions/2.0.10/.pi/harnesses/lib/coms-core-io.ts +385 -0
  295. package/.versions/2.0.10/.pi/harnesses/lib/coms-core.ts +577 -0
  296. package/.versions/2.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  297. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  298. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  299. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-view.ts +107 -0
  300. package/.versions/2.0.10/.pi/harnesses/lib/context-budget.ts +114 -0
  301. package/.versions/2.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  302. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  303. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  304. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  305. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  306. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  307. package/.versions/2.0.10/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  308. package/.versions/2.0.10/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  309. package/.versions/2.0.10/.pi/harnesses/lib/fleet-panel.ts +34 -0
  310. package/.versions/2.0.10/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  311. package/.versions/2.0.10/.pi/harnesses/lib/fleet-selection.ts +24 -0
  312. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  313. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  314. package/.versions/2.0.10/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  315. package/.versions/2.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  316. package/.versions/2.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  317. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  318. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  319. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  320. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  321. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  322. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  323. package/.versions/2.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  324. package/.versions/2.0.10/.pi/harnesses/lib/update-check.ts +222 -0
  325. package/.versions/2.0.10/.pi/harnesses/package-lock.json +2039 -0
  326. package/.versions/2.0.10/.pi/harnesses/package.json +10 -0
  327. package/.versions/2.0.10/.pi/prompts/af-build.md +24 -0
  328. package/.versions/2.0.10/.pi/prompts/af-code-simplify.md +22 -0
  329. package/.versions/2.0.10/.pi/prompts/af-constraints.md +31 -0
  330. package/.versions/2.0.10/.pi/prompts/af-plan.md +17 -0
  331. package/.versions/2.0.10/.pi/prompts/af-review.md +16 -0
  332. package/.versions/2.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  333. package/.versions/2.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  334. package/.versions/2.0.10/.pi/prompts/af-ship.md +17 -0
  335. package/.versions/2.0.10/.pi/prompts/af-spec.md +15 -0
  336. package/.versions/2.0.10/.pi/prompts/af-test.md +19 -0
  337. package/.versions/2.0.10/.pi/skills/bowser/SKILL.md +145 -0
  338. package/.versions/2.0.10/.version +1 -0
  339. package/.versions/2.0.10/agents/architect.md +25 -0
  340. package/.versions/2.0.10/agents/bowser.md +28 -0
  341. package/.versions/2.0.10/agents/builder.md +56 -0
  342. package/.versions/2.0.10/agents/code-reviewer.md +210 -0
  343. package/.versions/2.0.10/agents/deep-researcher.md +33 -0
  344. package/.versions/2.0.10/agents/documenter.md +23 -0
  345. package/.versions/2.0.10/agents/orchestrator.md +23 -0
  346. package/.versions/2.0.10/agents/plan-reviewer.md +84 -0
  347. package/.versions/2.0.10/agents/planner.md +106 -0
  348. package/.versions/2.0.10/agents/releaser.md +25 -0
  349. package/.versions/2.0.10/agents/researcher.md +31 -0
  350. package/.versions/2.0.10/agents/security-auditor.md +168 -0
  351. package/.versions/2.0.10/agents/test-engineer.md +154 -0
  352. package/.versions/2.0.10/agents/web-debugger.md +44 -0
  353. package/.versions/2.0.10/agents/web-performance-auditor.md +194 -0
  354. package/.versions/2.0.10/bin/catalog/harness-runtime-closure.json +32 -0
  355. package/.versions/2.0.10/codex/fleet-session-client/SKILL.md +34 -0
  356. package/.versions/2.0.10/codex/fleet-session-client.zip +0 -0
  357. package/.versions/2.0.10/docs/ARCHITECTURE.md +416 -0
  358. package/.versions/2.0.10/docs/agent-fleet-setup.md +586 -0
  359. package/.versions/2.0.10/docs/claude-code-coms-bridge.md +134 -0
  360. package/.versions/2.0.10/docs/codex-session-bridge.md +219 -0
  361. package/.versions/2.0.10/docs/coms-hermes-bridge.md +188 -0
  362. package/.versions/2.0.10/docs/getting-started.md +126 -0
  363. package/.versions/2.0.10/docs/npm-install.md +383 -0
  364. package/.versions/2.0.10/docs/pi-extensions.md +449 -0
  365. package/.versions/2.0.10/docs/pi-setup.md +92 -0
  366. package/.versions/2.0.10/docs/skill-anatomy.md +150 -0
  367. package/.versions/2.0.10/install-manifest.json +2991 -0
  368. package/.versions/2.0.10/justfile +247 -0
  369. package/.versions/2.0.10/manifest-meta.json +970 -0
  370. package/.versions/2.0.10/references/accessibility-checklist.md +160 -0
  371. package/.versions/2.0.10/references/communication-contract.md +26 -0
  372. package/.versions/2.0.10/references/definition-of-done.md +67 -0
  373. package/.versions/2.0.10/references/fleet-coordination-patterns.md +171 -0
  374. package/.versions/2.0.10/references/observability-checklist.md +92 -0
  375. package/.versions/2.0.10/references/orchestration-patterns.md +370 -0
  376. package/.versions/2.0.10/references/performance-checklist.md +236 -0
  377. package/.versions/2.0.10/references/prompting-patterns.md +380 -0
  378. package/.versions/2.0.10/references/security-checklist.md +245 -0
  379. package/.versions/2.0.10/references/testing-patterns.md +235 -0
  380. package/.versions/2.0.10/references/workflow-authoring.md +304 -0
  381. package/.versions/2.0.10/skills/_internal/grilling.md +59 -0
  382. package/.versions/2.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  383. package/.versions/2.0.10/skills/code-review-and-quality/SKILL.md +396 -0
  384. package/.versions/2.0.10/skills/compound-learning/SKILL.md +137 -0
  385. package/.versions/2.0.10/skills/constraint-driven-development/SKILL.md +338 -0
  386. package/.versions/2.0.10/skills/constraint-driven-development/references/floor-guard.md +99 -0
  387. package/.versions/2.0.10/skills/context-engineering/SKILL.md +341 -0
  388. package/.versions/2.0.10/skills/deprecation-and-migration/SKILL.md +247 -0
  389. package/.versions/2.0.10/skills/designing-agents/SKILL.md +394 -0
  390. package/.versions/2.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  391. package/.versions/2.0.10/skills/drafting-workflows/SKILL.md +143 -0
  392. package/.versions/2.0.10/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  393. package/.versions/2.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  394. package/.versions/2.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  395. package/.versions/2.0.10/skills/idea-refine/SKILL.md +182 -0
  396. package/.versions/2.0.10/skills/idea-refine/examples.md +238 -0
  397. package/.versions/2.0.10/skills/idea-refine/frameworks.md +99 -0
  398. package/.versions/2.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  399. package/.versions/2.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  400. package/.versions/2.0.10/skills/incremental-implementation/SKILL.md +302 -0
  401. package/.versions/2.0.10/skills/interview-me/SKILL.md +226 -0
  402. package/.versions/2.0.10/skills/orchestration-verification/SKILL.md +182 -0
  403. package/.versions/2.0.10/skills/peer-coms/SKILL.md +90 -0
  404. package/.versions/2.0.10/skills/performance-optimization/SKILL.md +496 -0
  405. package/.versions/2.0.10/skills/planning-and-task-breakdown/SKILL.md +289 -0
  406. package/.versions/2.0.10/skills/security-and-hardening/SKILL.md +524 -0
  407. package/.versions/2.0.10/skills/spec-driven-development/SKILL.md +295 -0
  408. package/.versions/2.0.10/skills/using-agent-skills/SKILL.md +198 -0
  409. package/.versions/2.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  410. package/.versions/2.0.10/vendor/agent-skills-upstream/README.md +430 -0
  411. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  412. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  413. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  414. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  415. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  416. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  417. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  418. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  419. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  420. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  421. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  422. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  423. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  424. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  425. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  426. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  427. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  428. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  429. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  430. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  431. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  432. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  433. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  434. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  435. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  436. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  437. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  438. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  439. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  440. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  441. package/CHANGELOG.md +11 -0
  442. package/agents/architect.md +1 -1
  443. package/agents/bowser.md +1 -1
  444. package/agents/builder.md +1 -1
  445. package/agents/code-reviewer.md +1 -1
  446. package/agents/deep-researcher.md +1 -1
  447. package/agents/documenter.md +1 -1
  448. package/agents/orchestrator.md +1 -1
  449. package/agents/plan-reviewer.md +1 -1
  450. package/agents/planner.md +1 -1
  451. package/agents/releaser.md +1 -1
  452. package/agents/researcher.md +1 -1
  453. package/agents/security-auditor.md +1 -1
  454. package/agents/test-engineer.md +1 -1
  455. package/agents/web-debugger.md +1 -1
  456. package/agents/web-performance-auditor.md +1 -1
  457. package/bin/cli.js +8 -5
  458. package/bin/lib/path-boundaries.js +5 -6
  459. package/bin/lib/stt-wizard.js +154 -23
  460. package/docs/agent-fleet-setup.md +26 -8
  461. package/docs/npm-install.md +29 -2
  462. package/docs/pi-setup.md +16 -0
  463. package/install-manifest.json +1 -1
  464. package/package.json +13 -3
  465. package/skills/orchestration-verification/SKILL.md +1 -0
@@ -4,7 +4,7 @@ Push-to-talk voice dictation for pi's terminal UI. Press a hotkey, speak, and th
4
4
  transcript is inserted into the prompt — or transcribed and sent in one step.
5
5
 
6
6
  A simplified, self-contained port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt),
7
- trimmed to **two** transcription backends and adapted to this repo's pi runtime.
7
+ trimmed to **three** transcription backends and adapted to this repo's pi runtime.
8
8
 
9
9
  ## How it works
10
10
 
@@ -47,15 +47,24 @@ Secrets are **never** stored in the file: the config names an environment variab
47
47
  key is read from the process environment — a gitignored `.env` at the repo root, auto-loaded by
48
48
  the `justfile`'s `dotenv-load`. See [`examples/stt.json`](examples/stt.json).
49
49
 
50
- > **Deterministic setup** can write `.ai/stt.json` and append an empty `.env`
51
- > placeholder — select the voice feature in `npx @chankov/agent-fleet setup` and answer
52
- > the provider prompts. See
50
+ > **Deterministic setup** uses the canonical nested `provider` format below. Its CLI aliases
51
+ > are `openai`, `groq`, `azure`, and `azure-openai`; these are not all runtime types. Setup can
52
+ > generate OpenAI defaults. For Groq, prepare complete nested JSON with runtime type
53
+ > `openai-compatible` and the actual Groq endpoint/model, then run setup without
54
+ > `--stt-provider groq`; other OpenAI-compatible services are not Groq. Azure Speech and Azure
55
+ > OpenAI also require complete prepared JSON when settings are missing. Setup does not guess
56
+ > provider-specific endpoints, models, deployments, or API versions. Existing supported flat
57
+ > legacy files are preserved with a runtime-compatibility warning and are not migrated
58
+ > automatically. See
53
59
  > [docs/agent-fleet-setup.md](../../../docs/agent-fleet-setup.md).
54
60
 
55
61
  ### Option 1 — Generic OpenAI-compatible endpoint
56
62
 
57
63
  Works with OpenAI Whisper, Groq, and local servers (`whisper.cpp`, `faster-whisper`) that
58
- expose `POST /v1/audio/transcriptions`.
64
+ expose `POST /v1/audio/transcriptions`. Use runtime type `openai` for the standard OpenAI
65
+ shape or `openai-compatible` to label a custom compatible service. The CLI alias `groq` does
66
+ not become a runtime `provider.type`; prepare the compatible service's real `baseUrl`, `model`,
67
+ and environment-variable name instead.
59
68
 
60
69
  ```json
61
70
  {
@@ -166,6 +175,16 @@ can be raised.
166
175
 
167
176
  ### All options
168
177
 
178
+ The canonical runtime types are `openai`, `openai-compatible`, `azure`, and `azure-openai`.
179
+ `azure` calls Azure Speech; it is not shorthand for Azure OpenAI.
180
+
181
+ Keep API keys and optional endpoint values in the workspace root's gitignored `.env`. The
182
+ config stores only names such as `apiKeyEnv` and `endpointEnv`. Deterministic setup recognizes
183
+ both `NAME=value` and `export NAME=value`, preserves existing declarations and values, and
184
+ adds only missing empty placeholders. A literal `provider.endpoint` needs no endpoint
185
+ placeholder. Setup validates the JSON shape and environment-variable names only: it neither
186
+ requires a credential to be set nor sends a request to validate one.
187
+
169
188
  | Key | Default | Notes |
170
189
  | --- | --- | --- |
171
190
  | `keybind` | `alt+s` | Any pi key id; override per-run with `PI_STT_KEYBIND` |
@@ -11,21 +11,21 @@
11
11
  "apiKeyEnv": "OPENAI_API_KEY"
12
12
  },
13
13
 
14
- "_azureExample": {
14
+ "_azureSpeechDocumentationExample": {
15
15
  "type": "azure",
16
- "endpoint": "https://fd-ai-credits.cognitiveservices.azure.com",
16
+ "endpoint": "https://<resource>.cognitiveservices.azure.com",
17
17
  "apiKeyEnv": "AZURE_SPEECH_KEY",
18
18
  "format": "detailed"
19
19
  },
20
20
 
21
- "_azureLanguageIdExample": {
21
+ "_azureSpeechLanguageIdDocumentationExample": {
22
22
  "type": "azure",
23
23
  "apiKeyEnv": "AZURE_SPEECH_KEY",
24
24
  "locales": ["bg-BG", "en-US"],
25
25
  "apiVersion": "2024-11-15"
26
26
  },
27
27
 
28
- "_azureOpenAIExample": {
28
+ "_azureOpenAIDocumentationExample": {
29
29
  "type": "azure-openai",
30
30
  "endpoint": "https://<resource>.openai.azure.com",
31
31
  "deployment": "gpt-4o-transcribe",
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.9"
6
+ "version": "2.0.10"
7
7
  }
@@ -102,6 +102,40 @@ export function crossCheck(parsed, dispatchedIds) {
102
102
  return notices;
103
103
  }
104
104
 
105
+ /**
106
+ * Runtime compiler facts outrank a specialist's raw claim, but only for ids in
107
+ * this dispatch and only when a completed, non-overlapped check found an error
108
+ * in an observed changed file. This returns a copy and never touches the ledger.
109
+ */
110
+ export function correctStructuredReturnForCompiler(parsed, dispatchedIds, compilerDiagnostics) {
111
+ if (!parsed || compilerDiagnostics?.status !== "completed" || compilerDiagnostics?.attribution !== "no_observed_overlap") {
112
+ return { parsed, demotedIds: [] };
113
+ }
114
+ const normalize = value => String(value || "").replace(/\\/g, "/").replace(/^\.\//, "");
115
+ const changed = new Set((compilerDiagnostics.changedFiles || []).map(normalize));
116
+ const hasChangedFileError = (compilerDiagnostics.projects || []).some(project =>
117
+ project?.status === "errors" && (project.diagnostics || []).some(diagnostic => diagnostic?.file && changed.has(normalize(diagnostic.file))),
118
+ );
119
+ if (!hasChangedFileError) return { parsed, demotedIds: [] };
120
+ const currentIds = new Set(dispatchedIds || []);
121
+ const demoted = (parsed.assertions_proven || [])
122
+ .filter(entry => entry?.id && currentIds.has(entry.id))
123
+ .map(entry => ({ ...entry, reason: "compiler_diagnostics" }));
124
+ if (!demoted.length) return { parsed, demotedIds: [] };
125
+ const demotedIds = new Set(demoted.map(entry => entry.id));
126
+ return {
127
+ parsed: {
128
+ ...parsed,
129
+ assertions_proven: (parsed.assertions_proven || []).filter(entry => !demotedIds.has(entry?.id)),
130
+ assertions_unproven: [
131
+ ...(parsed.assertions_unproven || []).filter(entry => !demotedIds.has(entry?.id)),
132
+ ...demoted,
133
+ ],
134
+ },
135
+ demotedIds: [...demotedIds],
136
+ };
137
+ }
138
+
105
139
  function fencedBlocks(text) {
106
140
  const blocks = [];
107
141
  const re = /```[^\n]*\n([\s\S]*?)```/g;
@@ -10,7 +10,8 @@ import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
10
10
  import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
11
11
  import type { BudgetRecovery } from "../budget-recovery.ts";
12
12
  import { checkScope, diffAgainst, snapshotWorktree } from "../scope-gate.js";
13
- import { crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
13
+ import { diagnoseChangedTypeScript, formatAdvisory, type DiagnosticsResult } from "../../lib/changed-file-diagnostics.ts";
14
+ import { correctStructuredReturnForCompiler, crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
14
15
  import { shouldExtractReturn } from "../return-extract.js";
15
16
  import { normalizeAgentInput, safeAgentKey, safePathWithin, taskFingerprint } from "../helpers.ts";
16
17
  import { MAX_AUTO_RESEARCH_QUESTIONS, MAX_AUTO_RESEARCH_ROUNDS, type ResearchAgentDef, type ResearchRuntime } from "../research/runtime.ts";
@@ -58,11 +59,13 @@ export interface DispatchExecutorDeps {
58
59
  extractAskUserQuestions(output: string): string[];
59
60
  contextPressure(percent: number): boolean;
60
61
  displayName(name: string): string;
62
+ diagnoseChangedTypeScript?: typeof diagnoseChangedTypeScript;
61
63
  }
62
64
 
63
65
  interface PreparedDispatch { taskToken: object; contract: DeliverableContract; sessionDir: string; agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
64
66
  interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; autoResearchTaskCapped: boolean; }
65
67
  interface Tracking { writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; }
68
+ interface WorktreeObservation { skipped: boolean; reason?: string; paths: string[]; concurrentWritableOverlap: boolean; }
66
69
 
67
70
  export function preflightGate(d: DispatchExecutorDeps, persona: string): Gate {
68
71
  const s = d.state;
@@ -140,7 +143,7 @@ function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx:
140
143
  tracking.concurrentAtStart = s.getActiveWritableDispatches() > 0;
141
144
  if (tracking.concurrentAtStart) s.setWritableOverlapCounter(s.getWritableOverlapCounter() + 1);
142
145
  s.setActiveWritableDispatches(s.getActiveWritableDispatches() + 1);
143
- if (prepared.scopeGlobs.length > 0) tracking.snapshot = snapshotWorktree(ctx.cwd || process.cwd());
146
+ tracking.snapshot = snapshotWorktree(ctx.cwd || process.cwd());
144
147
  }
145
148
  return tracking;
146
149
  }
@@ -168,36 +171,89 @@ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch,
168
171
  return { result, billed, out, researchRounds, autoResearchTaskCapped };
169
172
  }
170
173
 
171
- function scopeResult(d: DispatchExecutorDeps, p: PreparedDispatch, tracking: Tracking, ctx: ExtensionContext): any {
172
- if (!tracking.snapshot) return null; const diff = diffAgainst(tracking.snapshot, ctx.cwd || process.cwd());
174
+ function observeWorktree(d: DispatchExecutorDeps, tracking: Tracking, ctx: ExtensionContext): WorktreeObservation | null {
175
+ if (!tracking.snapshot) return null;
176
+ const diff = diffAgainst(tracking.snapshot, ctx.cwd || process.cwd());
173
177
  const concurrentWritableOverlap = tracking.concurrentAtStart || d.state.getWritableOverlapCounter() !== tracking.overlapBaseline;
174
- if (diff.skipped) return { skipped: true, reason: diff.reason, declaredScope: p.scopeGlobs, concurrentWritableOverlap };
175
- return { ...checkScope(diff.paths, p.scopeGlobs), changedPaths: diff.paths, declaredScope: p.scopeGlobs, concurrentWritableOverlap };
178
+ return diff.skipped
179
+ ? { skipped: true, reason: diff.reason, paths: [], concurrentWritableOverlap }
180
+ : { skipped: false, paths: diff.paths, concurrentWritableOverlap };
181
+ }
182
+
183
+ function scopeResult(p: PreparedDispatch, observation: WorktreeObservation | null): any {
184
+ if (!observation || p.scopeGlobs.length === 0) return null;
185
+ if (observation.skipped) return { skipped: true, reason: observation.reason, declaredScope: p.scopeGlobs, concurrentWritableOverlap: observation.concurrentWritableOverlap };
186
+ return { ...checkScope(observation.paths, p.scopeGlobs), changedPaths: observation.paths, declaredScope: p.scopeGlobs, concurrentWritableOverlap: observation.concurrentWritableOverlap };
187
+ }
188
+
189
+ function incompleteObservation(reason: string, overlap: boolean): DiagnosticsResult {
190
+ return { status: "incomplete", reason, changedFiles: [], attribution: overlap ? "uncertain" : "no_observed_overlap", projects: [], uncoveredFiles: [] };
176
191
  }
177
192
 
178
193
  async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
179
- const s = d.state; const { result, researchRounds } = run;
180
- const sameTask = p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir(); const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
181
- let { parsed: parsedReturn, notices: contractNotices } = parseDeliveredReturn(result.output, ids, disposition.delivered); const shouldUseDigest = ids.length > 0 || !!parsedReturn;
182
- const state = sameTask ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined; const key = safeAgentKey(state?.def.name ?? p.agent);
194
+ const s = d.state; const { result, researchRounds } = run; const cwd = ctx.cwd || process.cwd();
195
+ const sameTaskNow = () => p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir();
196
+ const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
197
+ // Observe immediately at logical child completion, before Hub-owned artifacts are written.
198
+ const observation = tracking.writable ? observeWorktree(d, tracking, ctx) : null;
199
+ const deliveredReturn = parseDeliveredReturn(result.output, ids, disposition.delivered);
200
+ let parsedReturn: any = deliveredReturn.parsed; let contractNotices: any[] = deliveredReturn.notices;
201
+ const shouldUseDigest = ids.length > 0 || !!parsedReturn; const state = sameTaskNow() ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined;
202
+ const key = safeAgentKey(state?.def.name ?? p.agent); const backendUsed = state?.lastBackend ?? null;
183
203
  const failureMetadata = { dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null,
184
204
  agent: p.agent, task: p.task, scope: p.scopeGlobs, exitCode: result.exitCode, diagnostics: result.diagnostics ?? null };
185
205
  const artifactOutput = disposition.delivered ? result.output
186
206
  : `# Dispatch failure\n\n\`\`\`json\n${JSON.stringify(failureMetadata, null, 2)}\n\`\`\`\n\n## Output\n\n${result.output}`;
187
- const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind, result.dispatchId, p.sessionDir) : null;
207
+ const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind as any, result.dispatchId, p.sessionDir) : null;
188
208
  const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
189
209
  if (returnPath && shouldExtractReturn(parsedReturn, ids)) {
190
210
  onUpdate?.({ content: [{ type: "text", text: `${p.agent} returned no structured block — extracting it from the report...` }], details: { agent: p.agent, task: p.task, status: "extracting_return" } });
191
- const recovered = await d.runReturnExtraction(returnPath, ids, ctx); if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
211
+ const recovered = await d.runReturnExtraction(returnPath, ids, ctx);
212
+ if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
213
+ }
214
+
215
+ // The one shared post-run delta feeds both scope reporting and compiler selection.
216
+ let compilerDiagnostics: DiagnosticsResult | null = null; let compilerEvidencePath: string | null = null; let compilerEvidenceError: string | null = null;
217
+ const eligibleForCompiler = disposition.delivered && tracking.writable && backendUsed === "native" && sameTaskNow();
218
+ if (eligibleForCompiler && observation?.skipped) {
219
+ compilerDiagnostics = incompleteObservation(`worktree observation unavailable: ${observation.reason ?? "unknown reason"}`, observation.concurrentWritableOverlap);
220
+ } else if (eligibleForCompiler && observation && observation.paths.some(path => /\.(?:ts|tsx|mts|cts)$/i.test(path))) {
221
+ try {
222
+ compilerDiagnostics = await (d.diagnoseChangedTypeScript ?? diagnoseChangedTypeScript)(observation.paths, {
223
+ cwd,
224
+ attribution: observation.concurrentWritableOverlap ? "uncertain" : "no_observed_overlap",
225
+ cacheLane: key,
226
+ runId: result.dispatchId ?? randomUUID(),
227
+ });
228
+ } catch (error) {
229
+ compilerDiagnostics = incompleteObservation(`compiler diagnostics failed safely: ${String(error)}`, observation.concurrentWritableOverlap);
230
+ }
231
+ }
232
+ if (observation) {
233
+ observation.concurrentWritableOverlap = observation.concurrentWritableOverlap || tracking.concurrentAtStart || s.getWritableOverlapCounter() !== tracking.overlapBaseline;
234
+ if (compilerDiagnostics && observation.concurrentWritableOverlap) compilerDiagnostics = { ...compilerDiagnostics, attribution: "uncertain" };
235
+ }
236
+ const sameTask = sameTaskNow();
237
+ if (sameTask && compilerDiagnostics) {
238
+ const correction = correctStructuredReturnForCompiler(parsedReturn, ids, compilerDiagnostics);
239
+ parsedReturn = correction.parsed;
240
+ contractNotices = [...crossCheck(parsedReturn, ids), ...correction.demotedIds.map(id => ({ type: "compiler_diagnostics", id }))];
192
241
  }
193
242
  const assessmentId = result.dispatchId ?? randomUUID();
194
- const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd: ctx.cwd || process.cwd(), sessionDir: p.sessionDir },
243
+ if (compilerDiagnostics && compilerDiagnostics.status !== "skipped") {
244
+ try {
245
+ compilerEvidencePath = d.artifacts.writeRunArtifact(`${key}-compiler`, state?.runCount ?? 0,
246
+ `# Compiler diagnostics\n\n\`\`\`json\n${JSON.stringify(compilerDiagnostics, null, 2)}\n\`\`\`\n`, "evidence", assessmentId, p.sessionDir);
247
+ } catch (error) { compilerEvidenceError = String(error); }
248
+ }
249
+ const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd, sessionDir: p.sessionDir },
195
250
  (index, bytes) => retainDeliverable(p.sessionDir, assessmentId, index, bytes));
196
251
  const deliverableFailed = readback.some(file => file.status !== "read");
197
252
  const executionStatus = disposition.pending ? "pending" : disposition.delivered ? "completed" : "failed";
198
253
  const status = disposition.delivered ? deliverableFailed ? "verification_failed" : "completed_unverified" : disposition.status;
199
254
  const acceptanceStatus = disposition.pending || !disposition.delivered ? "not_available" : deliverableFailed ? "deliverable_failed" : "needs_verification";
200
- const assessment = { executionStatus, acceptanceStatus, accepted: false, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots, assertions: ids };
255
+ const assessment = { executionStatus, acceptanceStatus, accepted: false, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots,
256
+ assertions: ids, structuredReturn: parsedReturn, contractNotices, compilerDiagnostics, compilerEvidencePath };
201
257
  const assessmentPath = disposition.pending ? null : d.artifacts.writeRunArtifact(`${key}-acceptance`, state?.runCount ?? 0, JSON.stringify(assessment, null, 2), "evidence", assessmentId, p.sessionDir);
202
258
  if (sameTask && [0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
203
259
  if (sameTask) { s.getTurnReport().dispatches.push({ agent: p.agent, status, elapsed: result.elapsed, billed: run.billed, out: run.out }); s.getSessionTotals().billed += run.billed; s.getSessionTotals().out += run.out; }
@@ -214,14 +270,20 @@ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, para
214
270
  if (returnPath) notices.push(`Full specialist output: ${returnPath}`);
215
271
  if (disposition.pending) notices.push("⏳ DELIVERY PENDING — no result or assertion evidence is available yet, and no return/failure artifact was written. Use the msg_id above with coms_get/coms_await; do not re-dispatch.");
216
272
  if (failurePath) notices.push(`⚠ DELIVERY FAILURE (exit ${result.exitCode}) — no specialist result was returned. The error output is at ${failurePath}; it is NOT a return and carries no assertion evidence. The work may or may not have happened — check the artifacts the task was supposed to produce before re-dispatching.`);
273
+ if (compilerDiagnostics && compilerDiagnostics.status !== "skipped") {
274
+ const advisory = formatAdvisory(compilerDiagnostics);
275
+ const evidence = compilerEvidencePath ? `Full compiler evidence: ${compilerEvidencePath}` : `Compiler evidence artifact unavailable: ${compilerEvidenceError ?? "unknown error"}`;
276
+ if (advisory) notices.push(`${advisory}\n${evidence}`);
277
+ else if (compilerDiagnostics.projects.length) notices.push(`Compiler diagnostics completed with no errors. ${evidence}`);
278
+ }
217
279
  const corrected = p.inputArtifacts.filter(a => a.resolvedFromKind); if (corrected.length) notices.push(`ℹ Artifact path corrected: ${corrected.map(a => `"${a.input}" → ${a.displayPath}`).join("; ")}. Use the corrected path from now on.`);
218
280
  if (state && d.contextPressure(state.contextPct)) notices.push(`⚠ ${d.displayName(state.def.name)} context at ${Math.ceil(state.contextPct)}% — consider /af-agents-restart ${state.def.name} (state lives in the artifacts/ledger, a restart is cheap).`);
219
- const scopeViolations = scopeResult(d, p, tracking, ctx); const scopeNotice = scopeNoticeText(scopeViolations); if (scopeNotice) notices.push(scopeNotice.trim());
281
+ const scopeViolations = scopeResult(p, observation); const scopeNotice = scopeNoticeText(scopeViolations); if (scopeNotice) notices.push(scopeNotice.trim());
220
282
  const finding = isReviewPersona(p.agent) ? findingBudgetNotice(p.agent, blockingFindingCap(s.getTaskTier()), countReviewFindings(result.output), s.getTaskReviewRounds(), reviewRoundCap(s.getTaskTier())) || "" : ""; if (finding) notices.push(finding.trim());
221
283
  const docs = docsLaneNotice(p.agent, p.scopeGlobs); if (docs) notices.push(docs);
222
284
  const contract = contractNoticeText(contractNotices); const extraction = returnExtracted ? "ℹ The specialist declared no structured return. The block below was EXTRACTED from its report by a cheap read-only pass — weaker than a declared return. Verify the named evidence before you gate on it." : "";
223
285
  const digest = shouldUseDigest ? [extraction, structuredReturnDigest(parsedReturn) || "Structured return: (none parsed)", contract].filter(Boolean).join("\n\n") : (result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output);
224
- return { content: [{ type: "text", text: `[${p.agent}] ${status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status, executionStatus, acceptanceStatus, accepted: false, staleTask: !sameTask, deliverableReadback: readback, scopeRoots: p.contract.scopeRoots, assessmentPath, backendRequested: params.backend ?? "auto", backendUsed: state?.lastBackend ?? null, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null, diagnostics: result.diagnostics ?? null, evidencePath: result.evidencePath ?? null, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
286
+ return { content: [{ type: "text", text: `[${p.agent}] ${status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status, executionStatus, acceptanceStatus, accepted: false, staleTask: !sameTask, deliverableReadback: readback, scopeRoots: p.contract.scopeRoots, assessmentPath, backendRequested: params.backend ?? "auto", backendUsed, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null, diagnostics: result.diagnostics ?? null, evidencePath: result.evidencePath ?? null, compilerDiagnostics, compilerEvidencePath, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
225
287
  }
226
288
 
227
289
  export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
@@ -269,5 +331,5 @@ export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<Sp
269
331
 
270
332
  function hasWriteCapability(tools: string): boolean { const set = new Set(String(tools || "").split(",").map(x => x.trim()).filter(Boolean)); return ["write", "edit", "bash"].some(x => set.has(x)); }
271
333
  function scopeNoticeText(v: any): string { if (!v) return ""; if (v.skipped) return `\n\n⚠ Scope gate skipped: ${v.reason || "not a git worktree"}.`; if (!v.outOfScope?.length) return ""; const overlap = v.concurrentWritableOverlap ? " Concurrent writable dispatches overlapped this run, so attribution is approximate." : ""; return `\n\n⚠ Scope advisory: changed outside declared scope: ${v.outOfScope.join(", ")}. Review these paths and decide whether to accept them or explicitly order cleanup; the hub did not revert anything.${overlap}`; }
272
- function structuredReturnDigest(parsed: any): string { if (!parsed) return ""; const lines = ["Structured return (parsed):"]; for (const key of ["assertions_proven", "assertions_unproven", "assertions_failed"]) { const entries = parsed[key] || []; if (!entries.length) continue; lines.push(`${key}:`); for (const entry of entries) { const evidence = entry.evidence ? ` — evidence: ${entry.evidence}` : ""; const note = entry.note || (entry.evidence ? "" : "(no note)"); lines.push(`- ${entry.id}${note ? `: ${note}` : ""}${evidence}`); } } for (const key of ["changed_files", "tests_run", "open_risks", "requires_user_decision"]) { const entries = parsed[key] || []; if (entries.length) lines.push(`${key}: ${entries.slice(0, 5).join("; ")}${entries.length > 5 ? " …" : ""}`); } return lines.join("\n"); }
273
- function contractNoticeText(notices: any[]): string { if (!notices?.length) return ""; const lines = ["⚠ Structured return contract notices:"]; const missing = notices.filter(n => n.type === "missing").map(n => n.id); const noStructured = notices.find(n => n.type === "no_structured_return"); if (noStructured) lines.push(`- no_structured_return: no parseable structured return for dispatched assertions ${(noStructured.ids || []).join(", ")} — treat all as unproven; full output is on disk.`); if (missing.length) lines.push(`- missing: return does not cover ${missing.join(", ")} — treat as unproven.`); for (const n of notices.filter(n => n.type === "proven_without_evidence")) lines.push(`- proven_without_evidence: ${n.id} claimed proven without named evidence — demoted to unproven.`); return lines.join("\n"); }
334
+ function structuredReturnDigest(parsed: any): string { if (!parsed) return ""; const lines = ["Structured return (parsed):"]; for (const key of ["assertions_proven", "assertions_unproven", "assertions_failed"]) { const entries = parsed[key] || []; if (!entries.length) continue; lines.push(`${key}:`); for (const entry of entries) { const evidence = entry.evidence ? ` — evidence: ${entry.evidence}` : ""; const reason = entry.reason ? ` — reason: ${entry.reason}` : ""; const note = entry.note || (entry.evidence ? "" : "(no note)"); lines.push(`- ${entry.id}${note ? `: ${note}` : ""}${evidence}${reason}`); } } for (const key of ["changed_files", "tests_run", "open_risks", "requires_user_decision"]) { const entries = parsed[key] || []; if (entries.length) lines.push(`${key}: ${entries.slice(0, 5).join("; ")}${entries.length > 5 ? " …" : ""}`); } return lines.join("\n"); }
335
+ function contractNoticeText(notices: any[]): string { if (!notices?.length) return ""; const lines = ["⚠ Structured return contract notices:"]; const missing = notices.filter(n => n.type === "missing").map(n => n.id); const noStructured = notices.find(n => n.type === "no_structured_return"); if (noStructured) lines.push(`- no_structured_return: no parseable structured return for dispatched assertions ${(noStructured.ids || []).join(", ")} — treat all as unproven; full output is on disk.`); if (missing.length) lines.push(`- missing: return does not cover ${missing.join(", ")} — treat as unproven.`); for (const n of notices.filter(n => n.type === "proven_without_evidence")) lines.push(`- proven_without_evidence: ${n.id} claimed proven without named evidence — demoted to unproven.`); for (const n of notices.filter(n => n.type === "compiler_diagnostics")) lines.push(`- compiler_diagnostics: ${n.id} was claimed proven but a completed compiler check found an error in an observed changed file — demoted to unproven with original evidence retained.`); return lines.join("\n"); }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.9"
6
+ "version": "2.0.10"
7
7
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.9"
6
+ "version": "2.0.10"
7
7
  }