@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,206 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { readFileSync } from "node:fs";
3
+ import { posix, resolve } from "node:path";
4
+ import { worktreeRevision } from "./scope-gate.js";
5
+ import { checkTaskBudget, checkTurnBudget } from "./run-budget.js";
6
+ import { recoveryCategoryFromDetails, recoveryDecision, type RecoveryCategory } from "./recovery-contract.ts";
7
+ import type { DispatchExecutorDeps } from "./tools/dispatch-execution.ts";
8
+ import type { ToolExecutor, DispatchAgentParams, SpawnResearchParams } from "./tools/context.ts";
9
+
10
+ interface Failure {
11
+ dispatchId: string;
12
+ reason: string;
13
+ category: RecoveryCategory;
14
+ evidencePath?: string;
15
+ effectsEstablished?: boolean;
16
+ catalogVersion?: string;
17
+ toolStateChanged?: boolean;
18
+ }
19
+ interface Ticket { allowed: boolean; key: string; executorKey: string; scope: string[]; generation: object; id: object; failure?: Failure; refusal?: "busy" | "recovery"; }
20
+ interface RecordedFailure { fingerprint: string; failure: Failure; authorized: boolean; }
21
+
22
+ export function createNoProgressGuard() {
23
+ let generation = {};
24
+ let taskId = randomUUID();
25
+ const pending = new Map<string, object>();
26
+ const pendingExecutors = new Map<string, object>();
27
+ const failures = new Map<string, RecordedFailure>();
28
+ const cancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
29
+ return {
30
+ taskToken: () => generation,
31
+ taskId: () => taskId,
32
+ begin(key: string, fingerprint: string, executorKey = key, scope: string[] = []): Ticket {
33
+ const cancelled = [...cancellations.values()].filter(item => item.executorKey === executorKey);
34
+ const old = cancelled.find(item => !item.entry.authorized)?.entry ?? cancelled[0]?.entry ?? failures.get(key), id = {};
35
+ if (pendingExecutors.has(executorKey)) return { allowed: false, key, executorKey, scope, generation, id, refusal: "busy" };
36
+ if (old) {
37
+ const category = old.failure.category ?? "indeterminate";
38
+ const changed = old.fingerprint !== fingerprint || (category === "unknown_tool" && old.failure.toolStateChanged === true);
39
+ const decision = recoveryDecision(category, {
40
+ explicitInvocation: true,
41
+ relevantConditionsChanged: changed || category === "busy",
42
+ freshOneUseAuthorization: old.authorized,
43
+ effectsEstablished: old.failure.effectsEstablished === true,
44
+ toolStateChanged: old.failure.toolStateChanged === true,
45
+ executorIdle: !pendingExecutors.has(executorKey),
46
+ });
47
+ if (!decision.allowed) return { allowed: false, key, executorKey, scope, generation, id, failure: { ...old.failure, category }, refusal: "recovery" };
48
+ }
49
+ for (const item of cancelled) { cancellations.delete(item.entry.failure.dispatchId); for (const [failedKey, entry] of failures) if (entry === item.entry) failures.delete(failedKey); }
50
+ failures.delete(key);
51
+ pending.set(key, id);
52
+ pendingExecutors.set(executorKey, id);
53
+ return { allowed: true, key, executorKey, scope, generation, id };
54
+ },
55
+ finish(ticket: Ticket, fingerprint: string, failure?: Failure) {
56
+ if (!ticket.allowed || ticket.generation !== generation || pending.get(ticket.key) !== ticket.id || pendingExecutors.get(ticket.executorKey) !== ticket.id) return;
57
+ pending.delete(ticket.key);
58
+ pendingExecutors.delete(ticket.executorKey);
59
+ if (failure) {
60
+ const entry = { fingerprint, failure, authorized: false };
61
+ failures.set(ticket.key, entry);
62
+ if (failure.category === "operator_cancelled") cancellations.set(failure.dispatchId, { executorKey: ticket.executorKey, scope: ticket.scope, entry });
63
+ }
64
+ },
65
+ /** Internal runtime port, not model input. Caller must retain an effects inspection artifact;
66
+ * unchanged conditions still cannot retry or replay observed effects. */
67
+ establishEffects(dispatchId: string, token: object, evidenceRef: string): boolean {
68
+ if (token !== generation || !evidenceRef.trim()) return false;
69
+ for (const entry of failures.values()) {
70
+ if (entry.failure.dispatchId !== dispatchId || entry.failure.category !== "tool_protocol_error") continue;
71
+ entry.failure.effectsEstablished = true;
72
+ entry.failure.evidencePath = evidenceRef;
73
+ return true;
74
+ }
75
+ return false;
76
+ },
77
+ establishToolStateChange(previousCatalogVersion: string, nextCatalogVersion: string, evidenceRef: string): number {
78
+ if (!previousCatalogVersion || !nextCatalogVersion || previousCatalogVersion === nextCatalogVersion || !evidenceRef.trim()) return 0;
79
+ let established = 0;
80
+ for (const entry of failures.values()) {
81
+ if (entry.failure.category !== "unknown_tool" || entry.failure.catalogVersion !== previousCatalogVersion) continue;
82
+ entry.failure.toolStateChanged = true;
83
+ entry.failure.evidencePath = evidenceRef;
84
+ established++;
85
+ }
86
+ return established;
87
+ },
88
+ authorize(dispatchId: string): boolean {
89
+ for (const { entry } of cancellations.values()) {
90
+ if (entry.failure.dispatchId !== dispatchId || entry.authorized || entry.failure.category !== "operator_cancelled") continue;
91
+ entry.authorized = true;
92
+ return true;
93
+ }
94
+ return false;
95
+ },
96
+ adopt(id: string) { generation = {}; taskId = id; pending.clear(); pendingExecutors.clear(); failures.clear(); },
97
+ reset() { this.adopt(randomUUID()); },
98
+ };
99
+ }
100
+ export type NoProgressGuard = ReturnType<typeof createNoProgressGuard>;
101
+
102
+ export interface ResearchContract {
103
+ readScope: string[];
104
+ goal?: string;
105
+ expectedResult?: string;
106
+ }
107
+
108
+ export function normalizePaths(paths: readonly string[] | undefined): string[] {
109
+ return [...new Set((paths ?? []).map(path => posix.normalize(String(path).trim().replace(/\\/g, "/")).replace(/\/+$/, "")).filter(Boolean))].sort();
110
+ }
111
+
112
+ export function normalizeResearchContract(params: Pick<SpawnResearchParams, "read_scope" | "goal" | "expected_result">): ResearchContract {
113
+ const text = (value: string | undefined) => value?.trim().replace(/\s+/g, " ") || undefined;
114
+ for (const path of (params.read_scope ?? []).map(value => value.trim().replace(/\\/g, "/"))) if (/^(?:\/|[A-Za-z]:)/.test(path) || path.split("/").includes("..")) throw new Error("read_scope must be repository-relative and cannot escape through ..");
115
+ const readScope = normalizePaths(params.read_scope);
116
+ return { readScope, goal: text(params.goal), expectedResult: text(params.expected_result) };
117
+ }
118
+
119
+ function canonical(value: unknown): string {
120
+ if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
121
+ if (value && typeof value === "object") return `{${Object.entries(value as Record<string, unknown>).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(",")}}`;
122
+ return JSON.stringify(value);
123
+ }
124
+
125
+ /** Wording and scope_mode are intentionally absent: neither can manufacture changed execution conditions. */
126
+ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchParams>(
127
+ d: Pick<DispatchExecutorDeps, "noProgress" | "artifacts"> & Partial<Pick<DispatchExecutorDeps, "budget" | "state" | "getToolCatalogVersion">>,
128
+ kind: "dispatch" | "research",
129
+ execute: ToolExecutor<P>,
130
+ executionConditions: (params: P, ctx: any, result?: any) => Record<string, unknown> = () => ({}),
131
+ ): ToolExecutor<P> {
132
+ return async (id, params, signal, onUpdate, ctx) => {
133
+ const cwd = ctx.cwd || process.cwd();
134
+ let research: ResearchContract | null;
135
+ try { research = "agent" in params ? null : normalizeResearchContract(params); }
136
+ catch (error) { return { content: [{ type: "text", text: String(error) }], details: { status: "invalid_input", recoveryCategory: "invalid_input", started: false, exitCode: 1 } }; }
137
+ const scope = "agent" in params ? normalizePaths(params.scope) : research!.readScope;
138
+ const actor = "agent" in params ? params.agent.trim().toLowerCase().replace(/[\s_]+/g, "-") : (params.persona ?? "research").trim().toLowerCase().replace(/[\s_]+/g, "-");
139
+ let inputs: { path: string }[];
140
+ try { inputs = d.artifacts.loadInputArtifacts(params.artifacts, ctx); }
141
+ catch { return execute(id, params, signal, onUpdate, ctx); }
142
+ const artifactRevision = () => inputs.map(input => {
143
+ try { return [input.path, createHash("sha256").update(readFileSync(input.path)).digest("hex")]; }
144
+ catch { return [input.path, "unreadable"]; }
145
+ }).sort(([a], [b]) => a.localeCompare(b));
146
+ const contractIdentity = "agent" in params ? normalizePaths(params.deliverables) : scope;
147
+ const key = canonical([kind, resolve(cwd), actor, scope, inputs.map(input => input.path).sort(), contractIdentity]);
148
+ const conditions = executionConditions(params, ctx);
149
+ const fingerprint = () => canonical({
150
+ worktree: worktreeRevision(cwd, scope),
151
+ artifacts: artifactRevision(),
152
+ structuredContract: research ? { readScope: research.readScope, goalDeclared: !!research.goal, expectedResultDeclared: !!research.expectedResult } : { scope, deliverables: contractIdentity },
153
+ conditions,
154
+ });
155
+ const executorKey = canonical([resolve(cwd), actor]);
156
+ const ticket = d.noProgress.begin(key, fingerprint(), executorKey, scope);
157
+ if (!ticket.allowed) {
158
+ if (ticket.refusal === "busy") {
159
+ const recovery = recoveryDecision("busy", { explicitInvocation: true, relevantConditionsChanged: false, executorIdle: false });
160
+ return { content: [{ type: "text", text: "Busy refusal: the same operation is already in flight. Nothing was queued or retried. Re-invoke explicitly only after the executor is evidenced idle; existing budgets still apply." }], details: { status: "busy", reason: "busy", recoveryCategory: "busy", recovery, exitCode: 1, started: false } };
161
+ }
162
+ const failure = ticket.failure!;
163
+ if (d.budget && d.state) {
164
+ const b = d.budget, s = d.state;
165
+ b.ensureTaskTier();
166
+ s.getTurnReport().refusals++; s.getSessionTotals().refusals++;
167
+ const block = checkTaskBudget(kind, b.taskCounters(), b.currentTaskBudget(), b.taskActiveElapsedMs(), s.getTaskTier())
168
+ ?? checkTurnBudget(kind, { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, b.currentBudget(), b.turnBudgetActiveElapsedMs(), s.getTaskTier());
169
+ if (block) return { content: [{ type: "text", text: block.message }], details: { status: "budget_refused", reason: block.reason, started: false, recoveryCategory: failure.category, exitCode: 1 } };
170
+ if (kind === "dispatch") { s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1); s.getTurnReport().dispatches.push({ agent: actor, status: "no_progress_refused", elapsed: 0, billed: 0, out: 0 }); }
171
+ else { s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; }
172
+ b.updateModeStatus();
173
+ }
174
+ const recovery = recoveryDecision(failure.category, { explicitInvocation: true });
175
+ const authorization = failure.category === "operator_cancelled"
176
+ ? `Fresh one-use authorization is required: /af-retry ${failure.dispatchId}. Scope mode, model, and prose changes are not authorization.`
177
+ : recovery.reason;
178
+ return { content: [{ type: "text", text: `No-progress refusal after ${failure.category}: ${failure.reason}. Previous attempt: ${failure.dispatchId}${failure.evidencePath ? ` (${failure.evidencePath})` : ""}. ${authorization} No automatic retry or waiting was performed.` }], details: { status: "no_progress_refused", reason: "unchanged_or_unauthorized", recoveryCategory: failure.category, recovery, exitCode: 1, previousDispatchId: failure.dispatchId, evidencePath: failure.evidencePath } };
179
+ }
180
+ let failure: Failure | undefined;
181
+ let result: any;
182
+ try {
183
+ result = await execute(id, params, signal, onUpdate, ctx);
184
+ const details = result.details as any;
185
+ const category = recoveryCategoryFromDetails(details);
186
+ // A busy refusal never started work, so it must not become no-progress history.
187
+ if (category && category !== "busy") failure = {
188
+ dispatchId: details.dispatchId ?? randomUUID(),
189
+ evidencePath: details.evidencePath ?? details.failurePath ?? details.protocolEvidencePath ?? undefined,
190
+ reason: details.diagnostics?.reason ?? details.reason ?? details.status ?? "execution_failure",
191
+ category,
192
+ catalogVersion: category === "unknown_tool" ? d.getToolCatalogVersion?.() : undefined,
193
+ };
194
+ return result;
195
+ } catch (error) {
196
+ failure = { dispatchId: randomUUID(), reason: "execution_exception", category: "indeterminate" };
197
+ throw error;
198
+ } finally {
199
+ d.noProgress.finish(ticket, fingerprint(), failure);
200
+ const effectsRef = (result?.details as any)?.protocolEffectsEvidenceRef;
201
+ if (failure?.category === "tool_protocol_error" && typeof effectsRef === "string") {
202
+ d.noProgress.establishEffects(failure.dispatchId, ticket.generation, effectsRef);
203
+ }
204
+ }
205
+ };
206
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "name": "agent-fleet-pi-agent-hub",
3
+ "private": true,
4
+ "type": "module",
5
+ "main": "index.ts",
6
+ "version": "2.0.11"
7
+ }
@@ -0,0 +1,116 @@
1
+ import {
2
+ buildPeerLaunchPlan,
3
+ type PeerLaunchContext,
4
+ type PeerLaunchPlan,
5
+ type PeerRunner,
6
+ } from "../../agent-fleet/scripts/lib/peer-launch.ts";
7
+ import { launchPeerInPane, peerReadyVerdict } from "../lib/spawned-peers.js";
8
+
9
+ export interface HubPeerSpawnRequest {
10
+ name: string;
11
+ runner?: PeerRunner;
12
+ persona?: string;
13
+ no_persona?: boolean;
14
+ model?: string;
15
+ extensions?: string;
16
+ browser?: boolean;
17
+ all_extensions?: boolean;
18
+ direction?: "right" | "down";
19
+ }
20
+
21
+ export interface HubPeerSpawnContext extends PeerLaunchContext {
22
+ /** The current Hub/coms project. The request cannot override it. */
23
+ project: string;
24
+ }
25
+
26
+ /**
27
+ * Constrained Agent Hub adapter for the canonical Fleet peer resolver.
28
+ * Project, placement, env-file source, and raw Pi argv are not LLM-controlled:
29
+ * the project comes from the Hub identity and envFile can only come back from
30
+ * a validated peers.yaml declaration inside buildPeerLaunchPlan().
31
+ */
32
+ export function buildHubPeerSpawnPlan(
33
+ request: HubPeerSpawnRequest,
34
+ context: HubPeerSpawnContext,
35
+ ): PeerLaunchPlan {
36
+ return buildPeerLaunchPlan(
37
+ {
38
+ name: request.name,
39
+ ...(request.runner ? { runner: request.runner } : {}),
40
+ ...(request.persona ? { persona: request.persona } : {}),
41
+ ...(request.no_persona ? { noPersona: true } : {}),
42
+ ...(request.model ? { model: request.model } : {}),
43
+ ...(request.extensions ? { extensions: request.extensions } : {}),
44
+ ...(request.browser ? { browser: true } : {}),
45
+ ...(request.all_extensions ? { allExtensions: true } : {}),
46
+ ...(request.direction ? { direction: request.direction } : {}),
47
+ project: context.project,
48
+ here: false,
49
+ },
50
+ context,
51
+ );
52
+ }
53
+
54
+ interface HubPeerPaneClient {
55
+ paneSplit(params: {
56
+ target_pane_id: string;
57
+ direction: "right" | "down";
58
+ cwd: string;
59
+ env?: Record<string, string>;
60
+ focus: boolean;
61
+ }): Promise<{ pane: { pane_id: string } }>;
62
+ paneRename(paneId: string, label: string): Promise<unknown>;
63
+ paneRead(params: { pane_id: string; lines: number }): Promise<{ read: { text?: string } }>;
64
+ paneSendText(paneId: string, text: string): Promise<unknown>;
65
+ paneSendKeys(paneId: string, keys: string[]): Promise<unknown>;
66
+ }
67
+
68
+ export interface HubPeerPaneLaunchOptions {
69
+ client: HubPeerPaneClient;
70
+ targetPaneId: string;
71
+ cwd: string;
72
+ env?: Record<string, string>;
73
+ waitForRegistration(name: string): Promise<{ found: boolean; waitedMs: number }>;
74
+ paneTail(paneId: string): Promise<string>;
75
+ onLaunched?(paneId: string): void;
76
+ }
77
+
78
+ /** Split next to the Hub, type the canonical argv, then return readiness proof. */
79
+ export async function launchHubPeerInPane(
80
+ plan: PeerLaunchPlan,
81
+ options: HubPeerPaneLaunchOptions,
82
+ ): Promise<{
83
+ paneId: string;
84
+ promptSeen: boolean;
85
+ promptWaitedMs: number;
86
+ verdict: ReturnType<typeof peerReadyVerdict>;
87
+ }> {
88
+ const env = options.env ?? {};
89
+ const { pane } = await options.client.paneSplit({
90
+ target_pane_id: options.targetPaneId,
91
+ direction: plan.direction,
92
+ cwd: options.cwd,
93
+ ...(Object.keys(env).length > 0 ? { env } : {}),
94
+ focus: false,
95
+ });
96
+ try {
97
+ await options.client.paneRename(pane.pane_id, plan.name);
98
+ } catch {
99
+ // A label is cosmetic; the pane id and coms identity remain authoritative.
100
+ }
101
+ const launch = await launchPeerInPane(options.client, pane.pane_id, plan.command);
102
+ options.onLaunched?.(pane.pane_id);
103
+ const readiness = await options.waitForRegistration(plan.name);
104
+ const tail = readiness.found ? undefined : await options.paneTail(pane.pane_id);
105
+ return {
106
+ paneId: pane.pane_id,
107
+ promptSeen: launch.promptSeen,
108
+ promptWaitedMs: launch.waitedMs,
109
+ verdict: peerReadyVerdict({
110
+ name: plan.name,
111
+ paneId: pane.pane_id,
112
+ ...readiness,
113
+ ...(tail === undefined ? {} : { paneTail: tail }),
114
+ }),
115
+ };
116
+ }
@@ -0,0 +1,153 @@
1
+ import { isCompleteProfile, parseCompleteProfile, validateProfile, agentSelection, childSelection, profileModels, type ModelProfile, type CompleteModelProfile } from '../config/model-profiles.ts';
2
+ import { assertProfileModel } from './profile-runtime.ts';
3
+ export interface ModelPolicyDef {
4
+ name: string;
5
+ model?: string;
6
+ fallbackModel?: string;
7
+ models?: string[];
8
+ thinking?: string;
9
+ subagents?: Record<string, { model: string; fallbackModel?: string }>;
10
+ }
11
+
12
+ export interface ModelPolicyPorts<TDef extends ModelPolicyDef> {
13
+ getAllDefs(): readonly TDef[];
14
+ getActiveDef(name: string): TDef | undefined;
15
+ getResearchDefs(): readonly TDef[];
16
+ refreshUi(): void;
17
+ }
18
+
19
+ export interface ModelSubstitutionUiPort {
20
+ loadAvailable(current?: string): Promise<readonly { spec: string }[] | null>;
21
+ notify(message: string, level: "error" | "info" | "success"): void;
22
+ }
23
+
24
+ export interface ModelPolicy<TDef extends ModelPolicyDef> {
25
+ allowedModels(def: TDef): string[];
26
+ substitutedModel(model: string | undefined): string | undefined;
27
+ resolvedModel(def: TDef): string | undefined;
28
+ resolvedSubagentModel(persona: string, role: string, declared: string): string;
29
+ resolvedThinking(def: TDef): string | undefined;
30
+ switchablePersonaDef(name: string): TDef | undefined;
31
+ allKnownModels(): string[];
32
+ getPersonaOverride(name: string): string | undefined;
33
+ setPersonaOverride(name: string, model: string | undefined): void;
34
+ getSubagentOverride(persona: string, role: string): string | undefined;
35
+ setSubagentOverride(persona: string, role: string, model: string | undefined): void;
36
+ setThinkingOverride(name: string, thinking: string | undefined): void;
37
+ getSubstitution(source: string): string | undefined;
38
+ substitutionEntries(): IterableIterator<[string, string]>;
39
+ applyProfile(profile: ModelProfile): string[];
40
+ applySessionSubstitution(source: string, target: string, ui: ModelSubstitutionUiPort): Promise<boolean>;
41
+ reset(): void;
42
+ }
43
+
44
+ export function createModelPolicy<TDef extends ModelPolicyDef>(ports: ModelPolicyPorts<TDef>): ModelPolicy<TDef> {
45
+ const personaOverrides = new Map<string, string>();
46
+ const substitutions = new Map<string, string>();
47
+ const thinkingOverrides = new Map<string, string>();
48
+ const subagentOverrides = new Map<string, string>();
49
+ let complete: CompleteModelProfile | undefined;
50
+ const maps = [personaOverrides, substitutions, thinkingOverrides, subagentOverrides];
51
+ let saved: Map<string,string>[] | undefined;
52
+ const assertAllowed = (model: string) => { if(complete) assertProfileModel(model,{name:'active',profile:complete}); };
53
+ const refresh = () => { try { ports.refreshUi(); } catch { /* presentation cannot invalidate a model switch */ } };
54
+ const key = (value: string) => value.toLowerCase();
55
+ const roleKey = (persona: string, role: string) => `${key(persona)}.${key(role)}`;
56
+
57
+ function allowedModels(def: TDef): string[] {
58
+ const out: string[] = [];
59
+ if (complete) return complete["allowed-models"] ?? profileModels(complete);
60
+ for (const model of [def.model, ...(def.models || [])]) if (model && !out.includes(model)) out.push(model);
61
+ return out;
62
+ }
63
+ function substitutedModel(model: string | undefined): string | undefined {
64
+ return model ? substitutions.get(model) ?? model : undefined;
65
+ }
66
+ function resolvedModel(def: TDef): string | undefined {
67
+ return substitutedModel(personaOverrides.get(key(def.name)) ?? (complete ? agentSelection(complete,def.name).model : def.model));
68
+ }
69
+ function resolvedSubagentModel(persona: string, role: string, declared: string): string {
70
+ return substitutedModel(subagentOverrides.get(roleKey(persona, role)) ?? (complete ? childSelection(complete,persona,role).model : declared)) ?? declared;
71
+ }
72
+ function resolvedThinking(def: TDef): string | undefined {
73
+ return thinkingOverrides.get(key(def.name)) ?? (complete ? agentSelection(complete,def.name).thinking : def.thinking);
74
+ }
75
+ function switchablePersonaDef(name: string): TDef | undefined {
76
+ return ports.getActiveDef(key(name)) ?? ports.getResearchDefs().find(def => key(def.name) === key(name));
77
+ }
78
+ function allKnownModels(): string[] {
79
+ const seen = new Set<string>();
80
+ const out: string[] = [];
81
+ const add = (model: string | undefined) => { if (model && !seen.has(model)) { seen.add(model); out.push(model); } };
82
+ for (const def of ports.getAllDefs()) {
83
+ add(def.model); add(def.fallbackModel);
84
+ for (const model of def.models ?? []) add(model);
85
+ for (const role of Object.values(def.subagents ?? {})) { add(role.model); add(role.fallbackModel); }
86
+ }
87
+ for (const model of personaOverrides.values()) add(model);
88
+ for (const model of subagentOverrides.values()) add(model);
89
+ for (const source of substitutions.keys()) add(source);
90
+ if(complete) for(const model of profileModels(complete)) add(model);
91
+ return out;
92
+ }
93
+ function setPersonaOverride(name: string, model: string | undefined): void {
94
+ if (model !== undefined) assertAllowed(model);
95
+ if (model === undefined) personaOverrides.delete(key(name)); else personaOverrides.set(key(name), model);
96
+ }
97
+ function setSubagentOverride(persona: string, role: string, model: string | undefined): void {
98
+ if (model !== undefined) assertAllowed(model);
99
+ const target = roleKey(persona, role);
100
+ if (model === undefined) subagentOverrides.delete(target); else subagentOverrides.set(target, model);
101
+ }
102
+ function applyProfile(profile: ModelProfile): string[] {
103
+ if(isCompleteProfile(profile)) {
104
+ const parsed = parseCompleteProfile(profile);
105
+ const errors = validateProfile(parsed, ports.getAllDefs());
106
+ if(errors.length) throw new Error(errors.join('\n'));
107
+ if(!saved) saved=maps.map(map=>new Map(map));
108
+ for(const map of maps) map.clear();
109
+ complete=parsed;
110
+ refresh();
111
+ return ports.getAllDefs().map(def=>key(def.name));
112
+ }
113
+ if(saved) {
114
+ maps.forEach((map,i)=>{map.clear();for(const [k,v] of saved![i]) map.set(k,v);});
115
+ saved=undefined;
116
+ }
117
+ complete=undefined;
118
+ const applied: string[] = [];
119
+ for (const [persona, model] of Object.entries(profile)) {
120
+ const def = ports.getAllDefs().find(candidate => key(candidate.name) === key(persona));
121
+ if (!def) continue;
122
+ setPersonaOverride(persona, model === def.model ? undefined : model);
123
+ applied.push(persona);
124
+ }
125
+ refresh();
126
+ return applied;
127
+ }
128
+ async function applySessionSubstitution(source: string, target: string, ui: ModelSubstitutionUiPort): Promise<boolean> {
129
+ try { assertAllowed(target); } catch(error) { ui.notify(String(error), "error"); return false; }
130
+ const known = allKnownModels();
131
+ if (!known.includes(source)) { ui.notify(`Unknown configured source model "${source}". Choose one of: ${known.join(", ") || "none"}.`, "error"); return false; }
132
+ const available = await ui.loadAvailable(substitutions.get(source));
133
+ if (!available) return false;
134
+ if (!available.some(choice => choice.spec === target)) { ui.notify(`Target model "${target}" is not currently available in Pi.`, "error"); return false; }
135
+ if (source === target) { ui.notify(`Source and target are the same (${source}); the session substitution was not changed.`, "info"); return false; }
136
+ const previous = substitutions.get(source);
137
+ if (previous === target) { ui.notify(`Substitution ${source} → ${target} is already active for this session.`, "info"); return false; }
138
+ substitutions.set(source, target);
139
+ const personas = ports.getAllDefs().filter(def => (personaOverrides.get(key(def.name)) ?? def.model) === source);
140
+ const roles = ports.getAllDefs().flatMap(def => Object.entries(def.subagents ?? {}).filter(([role, config]) => (subagentOverrides.get(roleKey(def.name, role)) ?? config.model) === source));
141
+ refresh();
142
+ ui.notify(`${previous ? "Updated" : "Saved"} session substitution ${source} → ${target}. ${personas.length} persona${personas.length === 1 ? "" : "s"} and ${roles.length} sub-role${roles.length === 1 ? "" : "s"} currently resolve through it; future agents spawned from the same configured source inherit it automatically. Current runs are not interrupted.`, "success");
143
+ return true;
144
+ }
145
+ return {
146
+ allowedModels, substitutedModel, resolvedModel, resolvedSubagentModel, resolvedThinking, switchablePersonaDef, allKnownModels,
147
+ getPersonaOverride: name => personaOverrides.get(key(name)), setPersonaOverride,
148
+ getSubagentOverride: (persona, role) => subagentOverrides.get(roleKey(persona, role)), setSubagentOverride,
149
+ setThinkingOverride: (name, thinking) => { if (thinking === undefined) thinkingOverrides.delete(key(name)); else thinkingOverrides.set(key(name), thinking); },
150
+ getSubstitution: source => substitutions.get(source), substitutionEntries: () => substitutions.entries(), applyProfile, applySessionSubstitution,
151
+ reset: () => { complete=undefined; saved=undefined; personaOverrides.clear(); substitutions.clear(); subagentOverrides.clear(); thinkingOverrides.clear(); },
152
+ };
153
+ }
@@ -0,0 +1,62 @@
1
+ import { isCompleteProfile, parseCompleteProfile, profileModels, dispatcherSelection, validateProfile, type ModelProfile, type ModelSelection, type ProfileAgentDef } from '../config/model-profiles.ts';
2
+ import { setActiveProfile } from './profile-runtime.ts';
3
+ export interface ProfileActivationPorts {
4
+ busy(): boolean;
5
+ defs(): readonly ProfileAgentDef[];
6
+ available(): Promise<readonly string[]>;
7
+ dispatcher(): ModelSelection | undefined;
8
+ setDispatcher(selection: ModelSelection): Promise<boolean>;
9
+ apply(profile: ModelProfile): string[];
10
+ env?: NodeJS.ProcessEnv;
11
+ }
12
+ export function createProfileActivation(ports: ProfileActivationPorts) {
13
+ let baseline: ModelSelection | undefined;
14
+ let completeActive = false;
15
+ let switching = false;
16
+ return {
17
+ switching: () => switching,
18
+ reset() { baseline = undefined; completeActive = false; setActiveProfile(undefined, ports.env); },
19
+ async activate(name: string, input: ModelProfile): Promise<string[]> {
20
+ if (switching || ports.busy())
21
+ throw new Error('Model profile switch refused: wait for the dispatcher, agents and workflows to finish.');
22
+ switching = true;
23
+ try {
24
+ const profile = isCompleteProfile(input) ? parseCompleteProfile(input) : input;
25
+ const errors = validateProfile(profile, ports.defs());
26
+ if (errors.length)
27
+ throw new Error(errors.join('\n'));
28
+ const target = isCompleteProfile(profile) ? dispatcherSelection(profile) : completeActive ? baseline : undefined;
29
+ const available = new Set(await ports.available());
30
+ const required = [...profileModels(profile), ...(target ? [target.model] : [])];
31
+ const missing = [...new Set(required.filter(model => !available.has(model)))];
32
+ if (missing.length)
33
+ throw new Error(`Profile "${name}" not activated; models unavailable in Pi: ${missing.join(', ')}. No settings changed.`);
34
+ if (ports.busy())
35
+ throw new Error('Model profile switch refused: work started during validation.');
36
+ const previous = ports.dispatcher();
37
+ if (target) {
38
+ try {
39
+ if (!await ports.setDispatcher(target))
40
+ throw new Error(`Could not select dispatcher model ${target.model}`);
41
+ }
42
+ catch (error) {
43
+ if (previous)
44
+ await ports.setDispatcher(previous);
45
+ throw error;
46
+ }
47
+ }
48
+ if (isCompleteProfile(profile) && !completeActive)
49
+ baseline = previous;
50
+ const applied = ports.apply(profile);
51
+ completeActive = isCompleteProfile(profile);
52
+ setActiveProfile(completeActive ? { name, profile: profile as any } : undefined, ports.env);
53
+ if (!completeActive)
54
+ baseline = undefined;
55
+ return applied;
56
+ }
57
+ finally {
58
+ switching = false;
59
+ }
60
+ },
61
+ };
62
+ }
@@ -0,0 +1,120 @@
1
+ import { parseCompleteProfile, agentSelection, childSelection, serviceSelection, type CompleteModelProfile } from '../config/model-profiles.ts';
2
+ export const PROFILE_ENV = 'AGENT_FLEET_ACTIVE_MODEL_PROFILE';
3
+ export interface ActiveModelProfile {
4
+ name: string;
5
+ profile: CompleteModelProfile;
6
+ }
7
+ let activeRuns = 0;
8
+ export function profileWorkInFlight(): number { return activeRuns; }
9
+ export async function withProfileWork<T>(run: () => Promise<T>): Promise<T> { activeRuns++; try {
10
+ return await run();
11
+ }
12
+ finally {
13
+ activeRuns--;
14
+ } }
15
+ export function readActiveProfile(env: NodeJS.ProcessEnv = process.env): ActiveModelProfile | undefined {
16
+ const raw = env[PROFILE_ENV];
17
+ if (!raw)
18
+ return undefined;
19
+ try {
20
+ const value = JSON.parse(raw);
21
+ if (typeof value.name !== 'string' || !value.name)
22
+ throw new Error('missing name');
23
+ return { name: value.name, profile: parseCompleteProfile(value.profile) };
24
+ }
25
+ catch (error) {
26
+ throw new Error(`Invalid active model profile: ${error instanceof Error ? error.message : String(error)}`);
27
+ }
28
+ }
29
+ export function setActiveProfile(active: ActiveModelProfile | undefined, env: NodeJS.ProcessEnv = process.env): void {
30
+ if (active)
31
+ env[PROFILE_ENV] = JSON.stringify(active);
32
+ else
33
+ delete env[PROFILE_ENV];
34
+ }
35
+ export function assertProfileModel(model: string, active = readActiveProfile()): void {
36
+ if (active?.profile['allowed-models'] && !active.profile['allowed-models'].includes(model))
37
+ throw new Error(`Profile "${active.name}" refuses model "${model}"; allowed-models: ${active.profile['allowed-models'].join(', ')}`);
38
+ }
39
+ export function profileFallback(candidate: string | undefined, active = readActiveProfile()): string | undefined {
40
+ if (active?.profile.fallback === 'none')
41
+ return undefined;
42
+ if (candidate)
43
+ assertProfileModel(candidate, active);
44
+ return candidate;
45
+ }
46
+ export function profileAgent(name: string, active = readActiveProfile()) { return active ? agentSelection(active.profile, name) : undefined; }
47
+ export function profileChild(parent: string, role: string, active = readActiveProfile()) { return active ? childSelection(active.profile, parent, role) : undefined; }
48
+ export function profileService(service: 'watchdog' | 'return-extractor', active = readActiveProfile()) { return active ? serviceSelection(active.profile, service) : undefined; }
49
+ export function profilePanel(name: string, active = readActiveProfile()) {
50
+ if (!active)
51
+ return undefined;
52
+ if (name !== active.name)
53
+ throw new Error(`Profile "${active.name}" owns the poll/debate panel; select --panel ${active.name}.`);
54
+ const voices = active.profile.panel ?? [
55
+ { name: 'first', model: active.profile.defaults.model, integrator: true },
56
+ { name: 'second', model: active.profile.defaults.model },
57
+ ];
58
+ return voices.map(v => ({ thinking: active.profile.defaults.thinking ?? 'off', ...v }));
59
+ }
60
+ export type ProfilePeerRefusal = {
61
+ isError: true;
62
+ content: [{ type: 'text'; text: string }];
63
+ details: { error: 'model-profile-native' | 'model-profile-allowlist' };
64
+ };
65
+
66
+ function refusal(text: string, error: ProfilePeerRefusal['details']['error']): ProfilePeerRefusal {
67
+ return { isError: true, content: [{ type: 'text', text }], details: { error } };
68
+ }
69
+
70
+ const BLANKET_NATIVE = 'Active model profile requires native agents; peer execution is disabled. Use dispatch_agent or leave this profile.';
71
+
72
+ /** True when native routing has no allowlist: standing peers are banned outright. */
73
+ export function profileForcesNativePeers(active = readActiveProfile()): boolean {
74
+ return !!active && active.profile.routing === 'native' && !active.profile['allowed-models']?.length;
75
+ }
76
+
77
+ /** Exact allowlist hit, or a unique provider-less suffix match. Ambiguous suffixes fail. */
78
+ export function modelAllowedByProfile(model: string, allowed: readonly string[]): boolean {
79
+ const value = model.trim();
80
+ if (!value || value === 'unknown')
81
+ return false;
82
+ if (allowed.includes(value))
83
+ return true;
84
+ if (value.includes('/'))
85
+ return false;
86
+ return allowed.filter(entry => entry.split('/').pop() === value).length === 1;
87
+ }
88
+
89
+ export function profilePeerGate(opts?: { peerModel?: string; targetResolved?: boolean }, active = readActiveProfile()): ProfilePeerRefusal | null {
90
+ if (!active || active.profile.routing !== 'native')
91
+ return null;
92
+ const allowed = active.profile['allowed-models'];
93
+ if (!allowed?.length)
94
+ return refusal(BLANKET_NATIVE, 'model-profile-native');
95
+ if (opts?.targetResolved === false)
96
+ return null;
97
+ const model = opts?.peerModel?.trim();
98
+ if (!model || model === 'unknown')
99
+ return refusal(`Active model profile "${active.name}" refuses unverified peers; advertised model is missing or unknown. Use a peer on allowed-models: ${allowed.join(', ')}, dispatch_agent native, or leave this profile.`, 'model-profile-allowlist');
100
+ if (modelAllowedByProfile(model, allowed))
101
+ return null;
102
+ return refusal(`Active model profile "${active.name}" refuses peer model "${model}"; allowed-models: ${allowed.join(', ')}. Use a peer on an allowed model, dispatch_agent native, or leave this profile.`, 'model-profile-allowlist');
103
+ }
104
+
105
+ export function profileSpawnPeerRefusal(plan: { runner: string; model?: string; persona?: string; name: string }, active = readActiveProfile()): ProfilePeerRefusal | null {
106
+ const early = profilePeerGate({ targetResolved: false }, active);
107
+ if (early)
108
+ return early;
109
+ if (!active || active.profile.routing !== 'native' || !active.profile['allowed-models']?.length)
110
+ return null;
111
+ if (plan.runner === 'claude-code')
112
+ return refusal(`Active model profile "${active.name}" refuses claude-code peers; allowed-models: ${active.profile['allowed-models'].join(', ')}. Spawn a pi peer on an allowed model or leave this profile.`, 'model-profile-allowlist');
113
+ const planned = plan.model ?? profileAgent(plan.persona ?? plan.name, active)?.model;
114
+ return profilePeerGate({ peerModel: planned, targetResolved: true }, active);
115
+ }
116
+
117
+ /** @deprecated Prefer profilePeerGate with the resolved peer model. */
118
+ export function profilePeerRefusal() {
119
+ return profilePeerGate();
120
+ }