@chankov/agent-fleet 2.0.10 → 2.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (531) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +26 -8
  2. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
  3. package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  4. package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
  5. package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  6. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
  7. package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
  8. package/.pi/harnesses/agent-hub/README.md +53 -18
  9. package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
  10. package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
  11. package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  12. package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  13. package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
  14. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
  15. package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  17. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  18. package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
  19. package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
  20. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
  21. package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
  22. package/.pi/harnesses/agent-hub/delegate.ts +19 -2
  23. package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  24. package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  25. package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  26. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
  27. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
  28. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
  29. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
  30. package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
  31. package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  32. package/.pi/harnesses/agent-hub/helpers.ts +5 -1
  33. package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
  34. package/.pi/harnesses/agent-hub/index.ts +145 -14
  35. package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
  36. package/.pi/harnesses/agent-hub/package.json +1 -1
  37. package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
  38. package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  39. package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
  40. package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
  41. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
  42. package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  43. package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
  44. package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
  45. package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  46. package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  47. package/.pi/harnesses/agent-hub/spawn.ts +61 -7
  48. package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  49. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  50. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  51. package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  52. package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
  53. package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
  54. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  55. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +176 -26
  56. package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  57. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
  58. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
  59. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
  60. package/.pi/harnesses/agent-hub/types.ts +2 -0
  61. package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  62. package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
  63. package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  64. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
  65. package/.pi/harnesses/coms/package.json +1 -1
  66. package/.pi/harnesses/damage-control-continue/index.ts +9 -0
  67. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  68. package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  69. package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
  70. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  71. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  72. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  73. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  74. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  75. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  76. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  77. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  78. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  79. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  80. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  81. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  82. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  83. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  84. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  85. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  86. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  87. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  88. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  89. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  90. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  91. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  92. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  93. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  94. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  95. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  96. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  97. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  98. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  99. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  100. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  101. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  102. package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  103. package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  104. package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  105. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  106. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  107. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  108. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  109. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  110. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
  111. package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
  112. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  113. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  114. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  115. package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  116. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  117. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  118. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  119. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  120. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  121. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  122. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  123. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  124. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  125. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  126. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  127. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  128. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  129. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  130. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  131. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  132. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  133. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  134. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  135. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  136. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  137. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  138. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  139. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  140. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  141. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  142. package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
  143. package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
  144. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  145. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  146. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  147. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
  148. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  149. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  150. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  151. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  152. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  153. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  154. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  155. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  156. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  157. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  158. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  159. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  160. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  161. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  162. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  163. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  164. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  165. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  166. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  167. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  168. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  169. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  170. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  171. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  172. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  173. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  174. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  175. package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  176. package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
  177. package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
  178. package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
  179. package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
  180. package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
  181. package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
  182. package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
  183. package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
  184. package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
  185. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  186. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  187. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  188. package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  189. package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  190. package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  191. package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  192. package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  193. package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  194. package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
  195. package/.versions/2.0.11/.pi/extensions/package.json +9 -0
  196. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
  197. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  198. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  199. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  200. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  201. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  202. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  203. package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
  204. package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  205. package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  206. package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  207. package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  208. package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  209. package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  210. package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  211. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  212. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
  213. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  214. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
  215. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  216. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  217. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  218. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  219. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  220. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  221. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  222. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  223. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  224. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  225. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  226. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  227. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  228. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  229. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  230. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  231. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
  232. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  233. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  234. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  235. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  236. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  237. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  238. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  239. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  240. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  241. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  242. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  243. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  244. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  245. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  246. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  247. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  248. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  249. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  250. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  251. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  252. package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  253. package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
  254. package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  255. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  256. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  257. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  258. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  259. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
  260. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  261. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
  262. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
  263. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  264. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  265. package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  266. package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  267. package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  268. package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  269. package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  270. package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  271. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
  272. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  276. package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
  277. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  278. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  279. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  280. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  281. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  282. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  283. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  284. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  285. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  286. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  287. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  288. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  289. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  290. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  291. package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
  292. package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  293. package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  294. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  295. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  296. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  297. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  298. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  299. package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  300. package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
  301. package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  302. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  303. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  304. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  305. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  306. package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  307. package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  308. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  309. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  310. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  311. package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  312. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
  313. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  314. package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  315. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
  316. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  317. package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  318. package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  319. package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  320. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  321. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  322. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
  323. package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
  324. package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  325. package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
  326. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  327. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  328. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  329. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  330. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  331. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  332. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  333. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
  334. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  335. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  336. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  337. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  338. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  339. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  340. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  341. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  342. package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
  343. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  344. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  345. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  346. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  347. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  348. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  349. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  350. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  351. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  352. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  353. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  354. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  355. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  356. package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  357. package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  358. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  359. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  360. package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  361. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
  362. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
  363. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  364. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  365. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  366. package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
  367. package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
  368. package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
  369. package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
  370. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
  371. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
  372. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  373. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  374. package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  375. package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
  376. package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
  377. package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  378. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  379. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  380. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
  381. package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
  382. package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  383. package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  384. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  385. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  386. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  387. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  388. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  389. package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  390. package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  391. package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
  392. package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  393. package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
  394. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  395. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  396. package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  397. package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  398. package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  399. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  400. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  401. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  402. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  403. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  404. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  405. package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  406. package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
  407. package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
  408. package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
  409. package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
  410. package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
  411. package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
  412. package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
  413. package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
  414. package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  415. package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  416. package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
  417. package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
  418. package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
  419. package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
  420. package/.versions/2.0.11/.version +1 -0
  421. package/.versions/2.0.11/agents/architect.md +25 -0
  422. package/.versions/2.0.11/agents/bowser.md +28 -0
  423. package/.versions/2.0.11/agents/builder.md +56 -0
  424. package/.versions/2.0.11/agents/code-reviewer.md +210 -0
  425. package/.versions/2.0.11/agents/deep-researcher.md +33 -0
  426. package/.versions/2.0.11/agents/documenter.md +23 -0
  427. package/.versions/2.0.11/agents/orchestrator.md +23 -0
  428. package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
  429. package/.versions/2.0.11/agents/planner.md +106 -0
  430. package/.versions/2.0.11/agents/releaser.md +25 -0
  431. package/.versions/2.0.11/agents/researcher.md +31 -0
  432. package/.versions/2.0.11/agents/security-auditor.md +168 -0
  433. package/.versions/2.0.11/agents/test-engineer.md +154 -0
  434. package/.versions/2.0.11/agents/web-debugger.md +44 -0
  435. package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
  436. package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
  437. package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
  438. package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
  439. package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
  440. package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
  441. package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
  442. package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
  443. package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
  444. package/.versions/2.0.11/docs/getting-started.md +126 -0
  445. package/.versions/2.0.11/docs/npm-install.md +383 -0
  446. package/.versions/2.0.11/docs/pi-extensions.md +449 -0
  447. package/.versions/2.0.11/docs/pi-setup.md +92 -0
  448. package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
  449. package/.versions/2.0.11/install-manifest.json +3020 -0
  450. package/.versions/2.0.11/justfile +247 -0
  451. package/.versions/2.0.11/manifest-meta.json +970 -0
  452. package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
  453. package/.versions/2.0.11/references/communication-contract.md +26 -0
  454. package/.versions/2.0.11/references/definition-of-done.md +67 -0
  455. package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
  456. package/.versions/2.0.11/references/observability-checklist.md +92 -0
  457. package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
  458. package/.versions/2.0.11/references/performance-checklist.md +236 -0
  459. package/.versions/2.0.11/references/prompting-patterns.md +380 -0
  460. package/.versions/2.0.11/references/security-checklist.md +245 -0
  461. package/.versions/2.0.11/references/testing-patterns.md +235 -0
  462. package/.versions/2.0.11/references/workflow-authoring.md +304 -0
  463. package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
  464. package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  465. package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
  466. package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
  467. package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
  468. package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
  469. package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
  470. package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
  471. package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
  472. package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  473. package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
  474. package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  475. package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  476. package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  477. package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
  478. package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
  479. package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
  480. package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  481. package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  482. package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
  483. package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
  484. package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
  485. package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
  486. package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
  487. package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
  488. package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
  489. package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
  490. package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
  491. package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  492. package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
  493. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  494. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  495. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  496. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  497. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  498. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  499. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  500. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  501. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  502. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  503. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  504. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  505. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  506. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  507. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  508. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  509. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  510. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  511. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  512. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  513. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  514. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  515. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  516. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  517. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  518. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  519. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  520. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  521. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  522. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  523. package/CHANGELOG.md +8 -0
  524. package/README.md +1 -0
  525. package/bin/catalog/harness-runtime-closure.json +29 -0
  526. package/bin/cli.js +15 -4
  527. package/bin/lib/doctor.js +83 -1
  528. package/docs/ARCHITECTURE.md +181 -2
  529. package/docs/workflows.md +8 -2
  530. package/install-manifest.json +31 -2
  531. package/package.json +2 -2
@@ -0,0 +1,245 @@
1
+ import type { ChildProcess } from "node:child_process";
2
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
+ import type { RegistryEntry } from "../lib/coms-core.ts";
4
+ import type { FleetTranscriptStore } from "../lib/fleet-transcript-store.ts";
5
+ import type { SpecialistContextManifest } from "../lib/context-budget-child-prompt.ts";
6
+ import type { ExecutionHistoryStore, HistoryEntry, HistoryStatus } from "./ui/history-store.ts";
7
+ import type { TimelineEntry } from "./ui/zoom.ts";
8
+ import type { DelegationChild, DelegationObservableState } from "./dispatch-observability.ts";
9
+ import type { ComsDispatchResult, DispatchInputArtifactPreview } from "./dispatch-coms.ts";
10
+ import type { PiRunControl, SpawnPiAgentCallbacks, SpawnPiAgentOptions, SpawnPiAgentResult } from "./spawn.ts";
11
+ import type { TaskResumeContract } from "./task-resume-contract.ts";
12
+ import type { ResolvedAssistFlags } from "./assist-profile.ts";
13
+ import type { ActiveModelProfile } from "./policy/profile-runtime.ts";
14
+ import type { WriteIsolationRequest, WriteIsolationResult } from "./write-isolation.ts";
15
+
16
+ export type NativeBackend = "auto" | "native" | "coms";
17
+
18
+ export interface NativeSubagentRole {
19
+ model: string;
20
+ fallbackModel?: string;
21
+ tools?: string;
22
+ thinking?: string;
23
+ }
24
+
25
+ export interface NativeAgentDefinition {
26
+ name: string;
27
+ description: string;
28
+ tools: string;
29
+ model?: string;
30
+ fallbackModel?: string;
31
+ models?: string[];
32
+ subagents?: Record<string, NativeSubagentRole>;
33
+ delegateDepth?: number;
34
+ thinking?: string;
35
+ systemPrompt: string;
36
+ file: string;
37
+ }
38
+
39
+ export interface NativeTimelineTarget {
40
+ timeline: TimelineEntry[];
41
+ transcriptStore?: FleetTranscriptStore;
42
+ transcriptPending?: TimelineEntry;
43
+ transcriptFlushTimer?: ReturnType<typeof setTimeout>;
44
+ zoomRender?: (force?: boolean) => void;
45
+ }
46
+
47
+ export interface NativeDispatchState extends NativeTimelineTarget, DelegationObservableState {
48
+ dispatchId?: string;
49
+ def: NativeAgentDefinition;
50
+ status: "idle" | "running" | "done" | "error";
51
+ task: string;
52
+ toolCount: number;
53
+ messageCount: number;
54
+ elapsed: number;
55
+ lastWork: string;
56
+ contextPct: number;
57
+ contextTokens: number;
58
+ sessionFile: string | null;
59
+ specialistManifest?: SpecialistContextManifest;
60
+ resumeContract?: TaskResumeContract;
61
+ runCount: number;
62
+ runsSinceFresh: number;
63
+ timer?: ReturnType<typeof setInterval>;
64
+ delegations?: Map<string, DelegationChild>;
65
+ proc?: ChildProcess;
66
+ killedByOperator?: boolean;
67
+ restarting?: boolean;
68
+ onTerminate?: () => void;
69
+ lastBackend?: "native" | "coms";
70
+ comsPeerModel?: string;
71
+ comsAbort?: () => void;
72
+ histEntry?: HistoryEntry;
73
+ }
74
+
75
+ export interface NativeExecutionDiagnostics {
76
+ reason: string | null;
77
+ processExitCode: number | null;
78
+ assistantError: string | null;
79
+ stderr: string;
80
+ spawnError: string | null;
81
+ modelUsed: string | null;
82
+ effectiveTools: string[];
83
+ toolCallsStarted: number | null;
84
+ termination: SpawnPiAgentResult["termination"] | null;
85
+ modelFallback: SpawnPiAgentResult["modelFallback"] | null;
86
+ }
87
+
88
+ export interface NativeDispatchResult {
89
+ runtimeTests?: import("./runtime-test-check.ts").RuntimeTestRecord[];
90
+ writeIsolation?: Pick<WriteIsolationResult, "applied" | "failClosed" | "mechanism" | "permissionExpansion" | "rollsBackUserEdits" | "protectsConcurrentUserWrites">;
91
+ toolEvents?: import("./tool-protocol.ts").ToolExecutionEvent[];
92
+ evidencePath?: string;
93
+ sessionPath?: string;
94
+ dispatchId?: string;
95
+ transcriptPath?: string;
96
+ diagnostics?: NativeExecutionDiagnostics;
97
+ output: string;
98
+ exitCode: number;
99
+ elapsed: number;
100
+ billed?: number;
101
+ out?: number;
102
+ sessionReset?: NativeSessionReset | null;
103
+ pending?: boolean;
104
+ }
105
+
106
+ export interface NativeSessionReset {
107
+ reason: string;
108
+ quarantined: string | null;
109
+ retried: boolean;
110
+ }
111
+
112
+ export interface NativeDispatchPolicy {
113
+ default: string;
114
+ grace_s: number;
115
+ substitutions: Record<string, { prefer: string; fallback: string; timeout_s?: number }>;
116
+ }
117
+
118
+ export interface NativeProviderSemaphore {
119
+ run<T>(model: string, fn: () => Promise<T>): Promise<T>;
120
+ }
121
+
122
+ export interface NativeDispatchDeps {
123
+ getAgentState(key: string): NativeDispatchState | undefined;
124
+ listAgentStates(): NativeDispatchState[];
125
+ getSessionDir(): string;
126
+ getDispatchPolicy(): NativeDispatchPolicy;
127
+ isComsReady(): boolean;
128
+ getIdentity(): unknown | null;
129
+ peersInScope(): RegistryEntry[];
130
+ wasComsMissNotified(personaKey: string): boolean;
131
+ markComsMissNotified(personaKey: string): void;
132
+ startMonitorChild(input: Record<string, unknown>, env: NodeJS.ProcessEnv): Promise<any> | undefined;
133
+ finalizeMonitorChild(task: any, output: string, status: "blocked" | "completed" | "failed" | "cancelled"): Promise<unknown> | unknown;
134
+ registerMonitorWaitOnly(key: string, state: NativeDispatchState): Promise<unknown> | unknown;
135
+ registerMonitorProcess(task: any, proc: ChildProcess): Promise<unknown> | unknown;
136
+ appendMonitorOutput(task: any, delta: string): Promise<unknown> | unknown;
137
+ getContextWindow(): number;
138
+ currentBudget(): any;
139
+ bumpRecycle(): void;
140
+ bumpDriftStop(): void;
141
+ getSessionHealthIo(): any;
142
+ getSafetyHarnessPath(): string | null;
143
+ getDelegateExtensionPath(): string | null;
144
+ getReconSearchTimeoutMs(): number;
145
+ getProjectDocsPaths(): string[];
146
+ getUserLanguage(): string;
147
+ getWatchdogSetting(): any;
148
+ getWatchdogAgentOverride(key: string): any;
149
+ getWorkMode(): any;
150
+ providerSemaphore: NativeProviderSemaphore;
151
+ executionHistory: Pick<ExecutionHistoryStore, "start" | "end">;
152
+ displayName(name: string): string;
153
+ shortModel(model: string): string;
154
+ resolvedModel(def: NativeAgentDefinition): string | undefined;
155
+ resolvedThinking(def: NativeAgentDefinition): string | undefined;
156
+ resolveThinkingLevel(raw?: string): string;
157
+ resolvedSubagentModel(personaKey: string, role: string, model: string): string;
158
+ substitutedModel(model: string | undefined): string | undefined;
159
+ modelWindowLookup(ctx: ExtensionContext): (provider: string, modelId: string) => any;
160
+ specialistProjectPolicyPaths(cwd: string): string[];
161
+ guardrailEnv(agentKey: string): Record<string, string>;
162
+ appendInputArtifacts(task: string, artifacts: DispatchInputArtifactPreview[]): string;
163
+ appendDeclaredScope(task: string, scopeGlobs: string[]): string;
164
+ flushTimelineStore(target: NativeTimelineTarget): void;
165
+ appendTimelineText(target: NativeTimelineTarget, kind: "text" | "thinking", delta: string): void;
166
+ appendTimelineEvent(target: NativeTimelineTarget, event: TimelineEntry): TimelineEntry;
167
+ createTranscriptStore(path: string): FleetTranscriptStore;
168
+ updateWidget(): void;
169
+ startDelegationWatch(state: NativeDispatchState, dir: string): void;
170
+ dispatchViaComs(
171
+ state: NativeDispatchState,
172
+ task: string,
173
+ peerName: string,
174
+ timeoutMs: number,
175
+ allowNativeFallback: boolean,
176
+ ctx: ExtensionContext,
177
+ inputArtifacts: DispatchInputArtifactPreview[],
178
+ scopeGlobs: string[],
179
+ ): Promise<ComsDispatchResult | null>;
180
+ runDriftJudge(input: any, ctx: ExtensionContext): Promise<{ verdict: string; reason: string } | null>;
181
+ notifyProviderQueue(model: string, label: string, ctx: ExtensionContext): void;
182
+ spawnPiAgentWithModelFallback(
183
+ options: SpawnPiAgentOptions,
184
+ fallbackModel: string | undefined,
185
+ callbacks: SpawnPiAgentCallbacks,
186
+ ): Promise<SpawnPiAgentResult>;
187
+ }
188
+
189
+ export interface NativeRunBase {
190
+ readonly sessionDir: string;
191
+ readonly evidenceDir: string;
192
+ readonly dispatchId: string;
193
+ readonly transcriptPath: string;
194
+ deps: NativeDispatchDeps;
195
+ state: NativeDispatchState;
196
+ ctx: ExtensionContext;
197
+ task: string;
198
+ inputArtifacts: DispatchInputArtifactPreview[];
199
+ scopeGlobs: string[];
200
+ watchdogParam?: boolean;
201
+ key: string;
202
+ personaKey: string;
203
+ agentKey: string;
204
+ runNumber: number;
205
+ histEntry: HistoryEntry;
206
+ monitorKey: string;
207
+ monitorStart?: Promise<any>;
208
+ startTime: number;
209
+ assistSnapshot: ResolvedAssistFlags;
210
+ activeProfileSnapshot?: ActiveModelProfile;
211
+ finishRun(output: string, exitCode: number, options?: { idle?: boolean; pending?: boolean; notice?: string }): Promise<NativeDispatchResult>;
212
+ }
213
+
214
+ export interface PreparedNativeRun extends NativeRunBase {
215
+ model: string;
216
+ originalModelFallback?: string;
217
+ agentWindow: { window: number; source: string };
218
+ agentSessionFile: string;
219
+ turnBudget: any;
220
+ sessionRecycled: boolean;
221
+ sessionReset: NativeSessionReset | null;
222
+ effectiveTools: string;
223
+ extensions: string[];
224
+ delegateEnv?: Record<string, string>;
225
+ writeIsolation?: WriteIsolationRequest;
226
+ writeIsolationPolicy?: WriteIsolationResult;
227
+ thinkingLevel: string;
228
+ wantThinking: boolean;
229
+ resumeContract: TaskResumeContract;
230
+ resumeAllowed: boolean;
231
+ replacementSystemPrompt: string;
232
+ runPrompt: string;
233
+ }
234
+
235
+ export interface NativeSpawnOutcome {
236
+ res: SpawnPiAgentResult;
237
+ runBilled: number;
238
+ runOut: number;
239
+ sessionRecycled: boolean;
240
+ sessionReset: NativeSessionReset | null;
241
+ driftStop: { rule: string; detail: string; verdict: string; reason: string } | null;
242
+ driftAdvisories: Array<{ rule: string; detail: string; verdict: string; reason: string }>;
243
+ }
244
+
245
+ export type { DispatchInputArtifactPreview, HistoryStatus, PiRunControl, SpawnPiAgentCallbacks, SpawnPiAgentOptions };
@@ -0,0 +1,226 @@
1
+ import { profileForcesNativePeers, profilePeerGate, readActiveProfile, type ActiveModelProfile } from './policy/profile-runtime.ts';
2
+ import { resolveAssist, type ResolvedAssistFlags } from "./assist-profile.ts";
3
+ import { randomUUID } from "node:crypto";
4
+ import { beginExecutionEvidence, finishExecutionEvidence } from "./execution-evidence.ts";
5
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
6
+ import { TIMEOUT_MS } from "../lib/coms-core.ts";
7
+ import { comsRequiredRefusal, explicitComsRefusal, resolveDispatchBackend } from "./backend-policy.js";
8
+ import { monitorKeyForAgent } from "./monitor-control.ts";
9
+ import { normalizeAgentInput, safeAgentKey, safePathWithin } from "./helpers.ts";
10
+ import { prepareNativeRun } from "./dispatch-native-prepare.ts";
11
+ import { runPreparedNative } from "./dispatch-native-spawn.ts";
12
+ import { completeNativeRun } from "./dispatch-native-complete.ts";
13
+ import type { TaskResumeInput } from "./task-resume-contract.ts";
14
+ import type {
15
+ DispatchInputArtifactPreview,
16
+ NativeBackend,
17
+ NativeDispatchDeps,
18
+ NativeDispatchResult,
19
+ NativeDispatchState,
20
+ NativeRunBase,
21
+ } from "./dispatch-native-types.ts";
22
+
23
+ interface NativeDispatchArgs {
24
+ agentName: string;
25
+ task: string;
26
+ ctx: ExtensionContext;
27
+ inputArtifacts: DispatchInputArtifactPreview[];
28
+ scopeGlobs: string[];
29
+ watchdogParam?: boolean;
30
+ requestedBackend: NativeBackend;
31
+ resumeRequested: boolean;
32
+ resumeContract?: Omit<TaskResumeInput, "previous">;
33
+ assistSnapshot: ResolvedAssistFlags;
34
+ activeProfileSnapshot?: ActiveModelProfile;
35
+ }
36
+
37
+ function missingOrRunning(deps: NativeDispatchDeps, agentName: string): NativeDispatchResult | NativeDispatchState {
38
+ const state = deps.getAgentState(normalizeAgentInput(agentName));
39
+ if (!state) {
40
+ return {
41
+ output: `Agent "${agentName}" not found. Available: ${deps.listAgentStates().map(item => deps.displayName(item.def.name)).join(", ")}`,
42
+ exitCode: 1,
43
+ elapsed: 0,
44
+ };
45
+ }
46
+ if (state.status === "running") {
47
+ return {
48
+ output: `Busy refusal: agent "${deps.displayName(state.def.name)}" is already running. Nothing was started, queued, retried, or charged; re-invoke explicitly after it is idle.`,
49
+ exitCode: 1,
50
+ elapsed: 0,
51
+ };
52
+ }
53
+ return state;
54
+ }
55
+
56
+ function beginNativeRun(deps: NativeDispatchDeps, state: NativeDispatchState, args: NativeDispatchArgs): NativeRunBase {
57
+ const { task, ctx, inputArtifacts, scopeGlobs, watchdogParam } = args;
58
+ const dispatchId = randomUUID();
59
+ const sessionDir = deps.getSessionDir();
60
+ const evidenceDir = beginExecutionEvidence(sessionDir, dispatchId, { agent: state.def.name, task, scope: scopeGlobs, backendRequested: args.requestedBackend }, inputArtifacts);
61
+ state.status = "running";
62
+ state.task = task;
63
+ state.toolCount = 0;
64
+ state.messageCount = 0;
65
+ state.elapsed = 0;
66
+ state.lastWork = "";
67
+ state.lastBackend = undefined;
68
+ state.comsPeerModel = undefined;
69
+ state.runCount++;
70
+ state.killedByOperator = false;
71
+ state.restarting = false;
72
+ deps.flushTimelineStore(state);
73
+ state.timeline = [];
74
+ state.dispatchId = dispatchId;
75
+ const transcriptPath = safePathWithin(sessionDir, "transcripts", `${safeAgentKey(state.def.name)}-${dispatchId}.jsonl`);
76
+ state.transcriptStore = deps.createTranscriptStore(transcriptPath);
77
+ state.delegationsWatcher?.close();
78
+ state.delegationsWatcher = undefined;
79
+ state.delegations = undefined;
80
+ deps.updateWidget();
81
+
82
+ const histEntry = deps.executionHistory.start("agent", deps.displayName(state.def.name));
83
+ state.histEntry = histEntry;
84
+ const agentKey = safeAgentKey(state.def.name);
85
+ const runNumber = state.runCount;
86
+ const monitorKey = monitorKeyForAgent(state.def.name, dispatchId);
87
+ const monitorStart = deps.startMonitorChild({
88
+ key: monitorKey,
89
+ id: `run-${dispatchId}`,
90
+ generation: 1,
91
+ specialist: agentKey,
92
+ }, process.env);
93
+ const startTime = Date.now();
94
+ state.timer = setInterval(() => {
95
+ state.elapsed = Date.now() - startTime;
96
+ deps.updateWidget();
97
+ }, 1000);
98
+
99
+ const finishRun = async (output: string, exitCode: number, options?: { idle?: boolean; pending?: boolean; notice?: string }): Promise<NativeDispatchResult> => {
100
+ await monitorStart?.then(task => deps.finalizeMonitorChild(
101
+ task,
102
+ output,
103
+ options?.pending ? "blocked" : exitCode === 0 ? "completed" : "failed",
104
+ ));
105
+ clearInterval(state.timer);
106
+ state.elapsed = Date.now() - startTime;
107
+ state.status = options?.idle ? "idle" : exitCode === 0 ? "done" : "error";
108
+ state.lastWork = output.split("\n").filter(line => line.trim()).pop() || "";
109
+ if (output.trim()) deps.appendTimelineText(state, "text", output);
110
+ deps.updateWidget();
111
+ state.zoomRender?.(true);
112
+ deps.executionHistory.end(histEntry, state.status);
113
+ if (options?.notice) ctx.ui.notify(options.notice, state.status === "done" ? "success" : state.status === "idle" ? "info" : "error");
114
+ const onTerminate = state.onTerminate;
115
+ state.onTerminate = undefined;
116
+ onTerminate?.();
117
+ return { dispatchId, transcriptPath, output, exitCode, elapsed: state.elapsed, ...(options?.pending ? { pending: true } : {}) };
118
+ };
119
+
120
+ return {
121
+ dispatchId, transcriptPath, sessionDir, evidenceDir, deps, state, ctx, task, inputArtifacts, scopeGlobs, watchdogParam,
122
+ key: normalizeAgentInput(args.agentName),
123
+ personaKey: state.def.name.toLowerCase(),
124
+ agentKey, runNumber, histEntry, monitorKey, monitorStart, startTime,
125
+ assistSnapshot: args.assistSnapshot,
126
+ activeProfileSnapshot: args.activeProfileSnapshot,
127
+ finishRun,
128
+ };
129
+ }
130
+
131
+ async function routeDispatch(run: NativeRunBase, requestedBackend: NativeBackend): Promise<NativeDispatchResult | null> {
132
+ const { deps, state, task, ctx, inputArtifacts, scopeGlobs, personaKey, monitorKey, startTime, histEntry } = run;
133
+ const livePeerNames = () => deps.isComsReady() && deps.getIdentity() ? deps.peersInScope().map(entry => entry.name) : [];
134
+ const isolationRequired = run.assistSnapshot['write-isolation'];
135
+ const forceNative = isolationRequired || (run.activeProfileSnapshot ? profileForcesNativePeers(run.activeProfileSnapshot) : false);
136
+ if (isolationRequired && requestedBackend === "coms") return run.finishRun("Write isolation is native-only; coms dispatch refused because remote isolation cannot be claimed.", 1);
137
+ if (forceNative && requestedBackend === 'coms') return run.finishRun('Active model profile requires native execution; coms dispatch refused.', 1);
138
+ const dispatchPolicy = forceNative ? { default: 'native', grace_s: 0, substitutions: {} } : deps.getDispatchPolicy();
139
+ let route: any = resolveDispatchBackend({ agentName: state.def.name, policy: dispatchPolicy, livePeerNames: livePeerNames(), requestedBackend });
140
+ if (route.backend === "invalid") return run.finishRun(`Invalid dispatch backend "${route.requestedBackend}". Expected auto|native|coms.`, 1);
141
+ if (route.backend === "coms-unavailable") return run.finishRun(explicitComsRefusal(deps.displayName(state.def.name)), 1);
142
+ if (route.backend === "await-coms") {
143
+ const graceS = route.grace_s;
144
+ const deadline = Date.now() + graceS * 1000;
145
+ state.lastWork = `waiting for coms peer (≤${graceS}s)...`;
146
+ deps.updateWidget();
147
+ while (Date.now() < deadline && route.backend !== "coms") {
148
+ await new Promise(resolve => setTimeout(resolve, 1000));
149
+ route = resolveDispatchBackend({ agentName: state.def.name, policy: dispatchPolicy, livePeerNames: livePeerNames(), requestedBackend });
150
+ }
151
+ if (route.backend !== "coms") return run.finishRun(comsRequiredRefusal(deps.displayName(state.def.name), graceS), 1);
152
+ }
153
+ if (route.backend === "native" && route.comsMissedNotice && !deps.wasComsMissNotified(personaKey)) {
154
+ deps.markComsMissNotified(personaKey);
155
+ ctx.ui.notify(route.comsMissedNotice, "warning");
156
+ }
157
+ if (route.backend === "coms") {
158
+ const peer = deps.peersInScope().find(entry => entry.name.toLowerCase() === String(route.peerName).toLowerCase());
159
+ const profileRefusal = run.activeProfileSnapshot ? profilePeerGate({ peerModel: peer?.model, targetResolved: !!peer }, run.activeProfileSnapshot) : null;
160
+ if (profileRefusal) {
161
+ const allowNativeFallback = !route.explicit && (dispatchPolicy.substitutions[personaKey]?.fallback ?? "native") !== "none";
162
+ if (!allowNativeFallback) return run.finishRun(profileRefusal.content[0].text, 1);
163
+ if (!deps.wasComsMissNotified(personaKey)) {
164
+ deps.markComsMissNotified(personaKey);
165
+ ctx.ui.notify(profileRefusal.content[0].text, "warning");
166
+ }
167
+ } else {
168
+ void deps.registerMonitorWaitOnly(monitorKey, state);
169
+ const allowNativeFallback = !route.explicit && (dispatchPolicy.substitutions[personaKey]?.fallback ?? "native") !== "none";
170
+ const timeoutMs = route.timeout_s ? route.timeout_s * 1000 : TIMEOUT_MS;
171
+ const comsResult = await deps.dispatchViaComs(state, task, route.peerName, timeoutMs, allowNativeFallback, ctx, inputArtifacts, scopeGlobs);
172
+ if (comsResult) {
173
+ histEntry.name = `${deps.displayName(state.def.name)} (coms)`;
174
+ return run.finishRun(comsResult.output, comsResult.exitCode, {
175
+ idle: comsResult.abandoned || comsResult.pending,
176
+ pending: comsResult.pending,
177
+ notice: comsResult.abandoned
178
+ ? `${deps.displayName(state.def.name)} coms dispatch abandoned (the peer pane keeps running)`
179
+ : comsResult.pending
180
+ ? `${deps.displayName(state.def.name)} coms dispatch is pending (the peer pane keeps running)`
181
+ : `${deps.displayName(state.def.name)} ${comsResult.exitCode === 0 ? "done" : "error"} in ${Math.round((Date.now() - startTime) / 1000)}s (coms peer)`,
182
+ });
183
+ }
184
+ }
185
+ }
186
+ state.lastBackend = "native";
187
+ state.comsPeerModel = undefined;
188
+ return null;
189
+ }
190
+
191
+ async function dispatchNative(deps: NativeDispatchDeps, args: Omit<NativeDispatchArgs, "assistSnapshot" | "activeProfileSnapshot">): Promise<NativeDispatchResult> {
192
+ const activeProfileSnapshot = readActiveProfile();
193
+ const effectiveArgs: NativeDispatchArgs = { ...args, activeProfileSnapshot, assistSnapshot: resolveAssist(activeProfileSnapshot?.profile.assist) };
194
+ const found = missingOrRunning(deps, args.agentName);
195
+ if (!("def" in found)) return found;
196
+ const run = beginNativeRun(deps, found, effectiveArgs);
197
+ const execute = async () => {
198
+ const routed = await routeDispatch(run, args.requestedBackend);
199
+ if (routed) return routed;
200
+ const prepared = await prepareNativeRun(run, args.resumeRequested, args.resumeContract);
201
+ if ("output" in prepared) return prepared;
202
+ const outcome = await runPreparedNative(prepared);
203
+ return { ...await completeNativeRun(prepared, outcome), sessionPath: prepared.agentSessionFile };
204
+ };
205
+ let result: NativeDispatchResult;
206
+ try { result = await execute(); }
207
+ catch (error) { result = await run.finishRun(`Dispatch exception: ${error instanceof Error ? error.stack : String(error)}`, 1); }
208
+ deps.flushTimelineStore(run.state);
209
+ return finishExecutionEvidence(run.evidenceDir, result);
210
+ }
211
+
212
+ export function createDispatchNative(deps: NativeDispatchDeps) {
213
+ return {
214
+ dispatchAgent: (
215
+ agentName: string,
216
+ task: string,
217
+ ctx: ExtensionContext,
218
+ inputArtifacts: DispatchInputArtifactPreview[] = [],
219
+ scopeGlobs: string[] = [],
220
+ watchdogParam?: boolean,
221
+ requestedBackend: NativeBackend = "auto",
222
+ resumeRequested = false,
223
+ resumeContract?: Omit<TaskResumeInput, "previous">,
224
+ ) => dispatchNative(deps, { agentName, task, ctx, inputArtifacts, scopeGlobs, watchdogParam, requestedBackend, resumeRequested, resumeContract }),
225
+ };
226
+ }
@@ -0,0 +1,225 @@
1
+ import * as fs from "node:fs";
2
+ import { join } from "node:path";
3
+ import type { FleetTranscriptStore } from "../lib/fleet-transcript-store.ts";
4
+ import type { ExecutionHistoryStore, HistoryEntry } from "./ui/history-store.ts";
5
+ import type { TimelineEntry, Zoomable } from "./ui/zoom.ts";
6
+ import { bumpMessageCount } from "./ui/activity-dots.ts";
7
+
8
+ export interface DelegationChild extends Zoomable {
9
+ id: string;
10
+ parent: string;
11
+ role: string;
12
+ model: string;
13
+ tools: string;
14
+ status: "running" | "done" | "error";
15
+ toolCount: number;
16
+ messageCount: number;
17
+ tokens: number;
18
+ lastWork: string;
19
+ startedAt: number;
20
+ elapsed: number;
21
+ transcriptStore?: FleetTranscriptStore;
22
+ transcriptPending?: TimelineEntry;
23
+ transcriptFlushTimer?: ReturnType<typeof setTimeout>;
24
+ histEntry?: HistoryEntry;
25
+ }
26
+
27
+ export interface DelegationObservableState {
28
+ def: { name: string };
29
+ delegations?: Map<string, DelegationChild>;
30
+ delegationsWatcher?: { close(): void };
31
+ histEntry?: HistoryEntry;
32
+ }
33
+
34
+ interface TimelineTarget {
35
+ timeline: TimelineEntry[];
36
+ transcriptStore?: FleetTranscriptStore;
37
+ transcriptPending?: TimelineEntry;
38
+ transcriptFlushTimer?: ReturnType<typeof setTimeout>;
39
+ zoomRender?: (force?: boolean) => void;
40
+ }
41
+
42
+ export interface DispatchObservabilityDeps {
43
+ getSessionDir(): string;
44
+ getDelegatedTokens(): number;
45
+ setDelegatedTokens(value: number): void;
46
+ getWidgetContext(): { ui: { setStatus(name: string, value: string): void } } | null | undefined;
47
+ executionHistory: Pick<ExecutionHistoryStore, "start" | "end">;
48
+ displayName(name: string): string;
49
+ safeAgentKey(name: string): string;
50
+ safePathWithin(root: string, ...parts: string[]): string;
51
+ createTranscriptStore(path: string): FleetTranscriptStore;
52
+ appendTimelineText(target: TimelineTarget, kind: "text" | "thinking", delta: string): void;
53
+ appendTimelineEvent(target: TimelineTarget, event: TimelineEntry): TimelineEntry;
54
+ updateWidget(): void;
55
+ }
56
+
57
+ export interface DelegationEvent {
58
+ t?: string;
59
+ id?: string;
60
+ parent?: string;
61
+ role?: string;
62
+ model?: string;
63
+ tools?: string;
64
+ ts?: number;
65
+ kind?: string;
66
+ delta?: string;
67
+ from?: string;
68
+ to?: string;
69
+ reason?: string;
70
+ name?: string;
71
+ args?: string;
72
+ callId?: string;
73
+ output?: any;
74
+ isError?: boolean;
75
+ durationMs?: number;
76
+ input?: number;
77
+ code?: number;
78
+ elapsed?: number;
79
+ }
80
+
81
+ function formatTokens(n: number): string {
82
+ if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
83
+ if (n >= 1_000) return `${(n / 1_000).toFixed(1)}k`;
84
+ return `${n}`;
85
+ }
86
+
87
+ function updateDelegatedSpendStatus(deps: DispatchObservabilityDeps): void {
88
+ const widgetCtx = deps.getWidgetContext();
89
+ const delegatedTokens = deps.getDelegatedTokens();
90
+ if (!widgetCtx || delegatedTokens <= 0) return;
91
+ try { widgetCtx.ui.setStatus("delegated-spend", `Δ delegated: ${formatTokens(delegatedTokens)} tok`); } catch {}
92
+ }
93
+
94
+ function handleDelegationEvent(deps: DispatchObservabilityDeps, state: DelegationObservableState, e: DelegationEvent): void {
95
+ if (!state.delegations || typeof e?.id !== "string") return;
96
+ if (e.t === "spawn") {
97
+ const startedAt = e.ts || Date.now();
98
+ const parentId = typeof e.parent === "string" ? e.parent : "root";
99
+ const parentEntry = parentId !== "root"
100
+ ? state.delegations.get(parentId)?.histEntry ?? state.histEntry ?? null
101
+ : state.histEntry ?? null;
102
+ const histEntry = deps.executionHistory.start("delegate", deps.displayName(e.role || e.id), { parent: parentEntry, startedAt });
103
+ state.delegations.set(e.id, {
104
+ id: e.id,
105
+ parent: parentId,
106
+ role: e.role || e.id,
107
+ model: e.model || "",
108
+ tools: e.tools || "",
109
+ def: { name: e.id },
110
+ status: "running",
111
+ toolCount: 0,
112
+ messageCount: 0,
113
+ tokens: 0,
114
+ lastWork: "",
115
+ startedAt,
116
+ elapsed: 0,
117
+ timeline: [],
118
+ transcriptStore: deps.createTranscriptStore(deps.safePathWithin(deps.getSessionDir(), "transcripts", `${deps.safeAgentKey(state.def.name)}-${deps.safeAgentKey(e.id)}.jsonl`)),
119
+ histEntry,
120
+ });
121
+ return;
122
+ }
123
+ const child = state.delegations.get(e.id);
124
+ if (!child) return;
125
+ if (e.t === "timeline") {
126
+ const kind = e.kind === "thinking" ? "thinking" : "text";
127
+ bumpMessageCount(child, kind);
128
+ deps.appendTimelineText(child, kind, e.delta || "");
129
+ if (e.kind !== "thinking") {
130
+ const trailing = child.timeline[child.timeline.length - 1];
131
+ if (trailing?.kind === "text") child.lastWork = trailing.content.split("\n").filter(line => line.trim()).pop() || "";
132
+ }
133
+ child.zoomRender?.();
134
+ } else if (e.t === "model_fallback") {
135
+ child.model = e.to || child.model;
136
+ child.lastWork = `model fallback: ${e.from || "override"} → ${e.to || "original"}`;
137
+ deps.appendTimelineEvent(child, {
138
+ kind: "text",
139
+ title: "Model fallback",
140
+ content: `${e.from || "override"} failed before work began; retrying with ${e.to || "original"}. ${e.reason || ""}`.trim(),
141
+ timestamp: Date.now(),
142
+ });
143
+ child.zoomRender?.();
144
+ } else if (e.t === "tool" || e.t === "tool_start") {
145
+ child.toolCount++;
146
+ deps.appendTimelineEvent(child, {
147
+ kind: "tool-start",
148
+ title: `Tool: ${e.name || "tool"}`,
149
+ content: e.args || "",
150
+ timestamp: e.ts || Date.now(),
151
+ ...(e.callId ? { callId: e.callId } : {}),
152
+ });
153
+ child.zoomRender?.();
154
+ } else if (e.t === "tool_result") {
155
+ deps.appendTimelineEvent(child, {
156
+ kind: "tool-result",
157
+ title: `Result: ${e.name || "tool"}`,
158
+ content: e.output || "",
159
+ timestamp: e.ts || Date.now(),
160
+ ...(e.callId ? { callId: e.callId } : {}),
161
+ status: e.isError ? "error" : "success",
162
+ ...(typeof e.durationMs === "number" ? { durationMs: e.durationMs } : {}),
163
+ });
164
+ child.zoomRender?.();
165
+ } else if (e.t === "usage") {
166
+ const add = (e.input || 0) + (e.output || 0);
167
+ child.tokens += add;
168
+ deps.setDelegatedTokens(deps.getDelegatedTokens() + add);
169
+ updateDelegatedSpendStatus(deps);
170
+ } else if (e.t === "exit") {
171
+ child.status = e.code === 0 ? "done" : "error";
172
+ child.elapsed = e.elapsed || (Date.now() - child.startedAt);
173
+ if (child.histEntry) deps.executionHistory.end(child.histEntry, child.status, child.startedAt + child.elapsed);
174
+ child.zoomRender?.(true);
175
+ }
176
+ }
177
+
178
+ function startDelegationWatch(deps: DispatchObservabilityDeps, state: DelegationObservableState, dir: string): void {
179
+ state.delegations = new Map();
180
+ const eventsFile = join(dir, "events.jsonl");
181
+ let offset = 0;
182
+ let pending = "";
183
+ const drain = () => {
184
+ let size: number;
185
+ try { size = fs.statSync(eventsFile).size; } catch { return; }
186
+ if (size <= offset) return;
187
+ let chunk: string;
188
+ try {
189
+ const fd = fs.openSync(eventsFile, "r");
190
+ try {
191
+ const buf = Buffer.alloc(size - offset);
192
+ fs.readSync(fd, buf, 0, buf.length, offset);
193
+ chunk = buf.toString("utf-8");
194
+ } finally { fs.closeSync(fd); }
195
+ } catch { return; }
196
+ offset = size;
197
+ pending += chunk;
198
+ const lines = pending.split("\n");
199
+ pending = lines.pop() || "";
200
+ let dirty = false;
201
+ for (const line of lines) {
202
+ if (!line.trim()) continue;
203
+ try { handleDelegationEvent(deps, state, JSON.parse(line)); dirty = true; } catch {}
204
+ }
205
+ if (dirty) deps.updateWidget();
206
+ };
207
+ const timer = setInterval(drain, 2000);
208
+ try { (timer as any).unref?.(); } catch {}
209
+ let watcher: fs.FSWatcher | null = null;
210
+ try { watcher = fs.watch(dir, () => drain()); } catch {}
211
+ state.delegationsWatcher = {
212
+ close() {
213
+ clearInterval(timer);
214
+ try { watcher?.close(); } catch {}
215
+ drain();
216
+ },
217
+ };
218
+ }
219
+
220
+ export function createDispatchObservability(deps: DispatchObservabilityDeps) {
221
+ return {
222
+ handleDelegationEvent: (state: DelegationObservableState, event: DelegationEvent) => handleDelegationEvent(deps, state, event),
223
+ startDelegationWatch: (state: DelegationObservableState, dir: string) => startDelegationWatch(deps, state, dir),
224
+ };
225
+ }