@chankov/agent-fleet 2.0.10 → 2.0.12

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 (1058) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +26 -8
  2. package/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +1 -1
  3. package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +3 -3
  4. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
  5. package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  6. package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
  7. package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  8. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
  9. package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
  10. package/.pi/harnesses/agent-hub/README.md +113 -21
  11. package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
  12. package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
  13. package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  14. package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  15. package/.pi/harnesses/agent-hub/budget-recovery.ts +136 -19
  16. package/.pi/harnesses/agent-hub/capability-packs.ts +6 -2
  17. package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  18. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  19. package/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  20. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  21. package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
  22. package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
  23. package/.pi/harnesses/agent-hub/config/overrides.ts +8 -1
  24. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
  25. package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
  26. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +1 -1
  27. package/.pi/harnesses/agent-hub/context-window.js +2 -0
  28. package/.pi/harnesses/agent-hub/delegate.ts +22 -3
  29. package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  30. package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  31. package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  32. package/.pi/harnesses/agent-hub/dispatch-coms.ts +20 -5
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +23 -8
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +61 -52
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +23 -2
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +25 -12
  38. package/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  39. package/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  40. package/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  41. package/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  42. package/.pi/harnesses/agent-hub/drift-watchdog.js +140 -9
  43. package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  44. package/.pi/harnesses/agent-hub/helpers.ts +5 -1
  45. package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
  46. package/.pi/harnesses/agent-hub/index.ts +208 -39
  47. package/.pi/harnesses/agent-hub/input/completions.ts +8 -2
  48. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +4 -2
  49. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
  50. package/.pi/harnesses/agent-hub/no-progress.ts +348 -65
  51. package/.pi/harnesses/agent-hub/package.json +1 -1
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +12 -5
  53. package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +5 -1
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -2
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
  58. package/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  59. package/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  60. package/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  61. package/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  62. package/.pi/harnesses/agent-hub/research/controls.ts +1 -1
  63. package/.pi/harnesses/agent-hub/research/runtime.ts +2 -1
  64. package/.pi/harnesses/agent-hub/research/spawn-run.ts +21 -6
  65. package/.pi/harnesses/agent-hub/return-extract.js +3 -1
  66. package/.pi/harnesses/agent-hub/review-findings.js +2 -0
  67. package/.pi/harnesses/agent-hub/run-budget.js +6 -1
  68. package/.pi/harnesses/agent-hub/run-namespace.js +6 -0
  69. package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  70. package/.pi/harnesses/agent-hub/session-audit.ts +226 -0
  71. package/.pi/harnesses/agent-hub/spawn.ts +133 -11
  72. package/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
  73. package/.pi/harnesses/agent-hub/system1-report.ts +84 -0
  74. package/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
  75. package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  76. package/.pi/harnesses/agent-hub/timeline.ts +23 -5
  77. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  78. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  79. package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  80. package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
  81. package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
  82. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  83. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +189 -26
  84. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
  85. package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  86. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
  87. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
  88. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
  89. package/.pi/harnesses/agent-hub/types.ts +3 -0
  90. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +12 -3
  91. package/.pi/harnesses/agent-hub/ui/context-budget.ts +4 -3
  92. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +11 -18
  93. package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +3 -1
  94. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +2 -2
  95. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +14 -1
  96. package/.pi/harnesses/agent-hub/ui/grid.ts +6 -6
  97. package/.pi/harnesses/agent-hub/ui/pool.ts +1 -1
  98. package/.pi/harnesses/agent-hub/ui/zoom.ts +5 -3
  99. package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  100. package/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  101. package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
  102. package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  103. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
  104. package/.pi/harnesses/coms/package.json +1 -1
  105. package/.pi/harnesses/damage-control-continue/index.ts +9 -0
  106. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  107. package/.pi/harnesses/lib/coms-core.ts +1 -1
  108. package/.pi/harnesses/lib/context-budget.ts +1 -1
  109. package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  110. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  111. package/.pi/harnesses/lib/fleet-detail-view.ts +35 -4
  112. package/.pi/harnesses/lib/fleet-read-model.ts +206 -14
  113. package/.pi/harnesses/lib/fleet-strip-view.ts +17 -5
  114. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  115. package/.pi/harnesses/lib/spawned-peers.js +1 -0
  116. package/.pi/harnesses/lib/system1/config.js +61 -0
  117. package/.pi/harnesses/lib/system1/contracts.ts +152 -0
  118. package/.pi/harnesses/lib/system1/demo.ts +106 -0
  119. package/.pi/harnesses/lib/system1/jev.ts +503 -0
  120. package/.pi/harnesses/lib/system1/service.ts +245 -0
  121. package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
  122. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  123. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  124. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  125. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  126. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  127. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  128. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  129. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  130. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  131. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  132. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  133. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  134. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  135. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  136. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  137. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  138. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  139. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  140. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  141. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  142. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  143. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  144. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  145. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  146. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  147. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  148. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  149. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  150. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  151. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  152. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  153. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  154. package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  155. package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  156. package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  157. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  158. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  159. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  160. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  161. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  162. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
  163. package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
  164. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  165. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  166. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  167. package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  168. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  169. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  170. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  171. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  172. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  173. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  174. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  175. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  176. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  177. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  178. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  179. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  180. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  181. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  182. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  183. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  184. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  185. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  186. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  187. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  188. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  189. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  190. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  191. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  192. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  193. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  194. package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
  195. package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
  196. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  197. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  198. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  199. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
  200. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  201. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  202. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  203. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  204. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  205. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  206. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  207. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  208. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  209. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  210. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  211. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  212. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  213. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  214. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  215. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  216. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  217. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  218. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  219. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  220. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  221. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  222. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  223. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  224. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  225. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  226. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  227. package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  228. package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
  229. package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
  230. package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
  231. package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
  232. package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
  233. package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
  234. package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
  235. package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
  236. package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
  237. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  238. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  239. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  240. package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  241. package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  242. package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  243. package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  244. package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  245. package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  246. package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
  247. package/.versions/2.0.11/.pi/extensions/package.json +9 -0
  248. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
  249. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  250. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  251. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  252. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  253. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  254. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  255. package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
  256. package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  257. package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  258. package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  259. package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  260. package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  261. package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  262. package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  263. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  264. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
  265. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  266. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
  267. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  268. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  269. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  270. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  271. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  272. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  273. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  274. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  275. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  276. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  277. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  278. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  279. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  280. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  281. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  282. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  283. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
  284. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  285. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  286. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  287. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  288. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  289. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  290. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  291. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  292. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  293. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  294. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  295. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  296. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  297. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  298. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  299. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  300. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  301. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  302. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  303. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  304. package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  305. package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
  306. package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  307. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  308. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  309. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  310. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  311. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
  312. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  313. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
  314. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
  315. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  316. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  317. package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  318. package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  319. package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  320. package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  321. package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  322. package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  323. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
  324. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  325. package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
  326. package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
  327. package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  328. package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
  329. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  330. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  331. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  332. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  333. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  334. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  335. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  336. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  337. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  338. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  339. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  340. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  341. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  342. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  343. package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
  344. package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  345. package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  346. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  347. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  348. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  349. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  350. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  351. package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  352. package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
  353. package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  354. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  355. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  356. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  357. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  358. package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  359. package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  360. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  361. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  362. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  363. package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  364. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
  365. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  366. package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  367. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
  368. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  369. package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  370. package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  371. package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  372. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  373. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  374. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
  375. package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
  376. package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  377. package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
  378. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  379. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  380. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  381. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  382. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  383. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  384. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  385. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
  386. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  387. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  388. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  389. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  390. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  391. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  392. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  393. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  394. package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
  395. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  396. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  397. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  398. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  399. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  400. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  401. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  402. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  403. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  404. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  405. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  406. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  407. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  408. package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  409. package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  410. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  411. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  412. package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  413. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
  414. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
  415. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  416. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  417. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  418. package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
  419. package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
  420. package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
  421. package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
  422. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
  423. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
  424. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  425. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  426. package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  427. package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
  428. package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
  429. package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  430. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  431. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  432. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
  433. package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
  434. package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  435. package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  436. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  437. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  438. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  439. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  440. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  441. package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  442. package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  443. package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
  444. package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  445. package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
  446. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  447. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  448. package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  449. package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  450. package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  451. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  452. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  453. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  454. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  455. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  456. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  457. package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  458. package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
  459. package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
  460. package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
  461. package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
  462. package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
  463. package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
  464. package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
  465. package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
  466. package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  467. package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  468. package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
  469. package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
  470. package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
  471. package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
  472. package/.versions/2.0.11/.version +1 -0
  473. package/.versions/2.0.11/agents/architect.md +25 -0
  474. package/.versions/2.0.11/agents/bowser.md +28 -0
  475. package/.versions/2.0.11/agents/builder.md +56 -0
  476. package/.versions/2.0.11/agents/code-reviewer.md +210 -0
  477. package/.versions/2.0.11/agents/deep-researcher.md +33 -0
  478. package/.versions/2.0.11/agents/documenter.md +23 -0
  479. package/.versions/2.0.11/agents/orchestrator.md +23 -0
  480. package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
  481. package/.versions/2.0.11/agents/planner.md +106 -0
  482. package/.versions/2.0.11/agents/releaser.md +25 -0
  483. package/.versions/2.0.11/agents/researcher.md +31 -0
  484. package/.versions/2.0.11/agents/security-auditor.md +168 -0
  485. package/.versions/2.0.11/agents/test-engineer.md +154 -0
  486. package/.versions/2.0.11/agents/web-debugger.md +44 -0
  487. package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
  488. package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
  489. package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
  490. package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
  491. package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
  492. package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
  493. package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
  494. package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
  495. package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
  496. package/.versions/2.0.11/docs/getting-started.md +126 -0
  497. package/.versions/2.0.11/docs/npm-install.md +383 -0
  498. package/.versions/2.0.11/docs/pi-extensions.md +449 -0
  499. package/.versions/2.0.11/docs/pi-setup.md +92 -0
  500. package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
  501. package/.versions/2.0.11/install-manifest.json +3020 -0
  502. package/.versions/2.0.11/justfile +247 -0
  503. package/.versions/2.0.11/manifest-meta.json +970 -0
  504. package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
  505. package/.versions/2.0.11/references/communication-contract.md +26 -0
  506. package/.versions/2.0.11/references/definition-of-done.md +67 -0
  507. package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
  508. package/.versions/2.0.11/references/observability-checklist.md +92 -0
  509. package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
  510. package/.versions/2.0.11/references/performance-checklist.md +236 -0
  511. package/.versions/2.0.11/references/prompting-patterns.md +380 -0
  512. package/.versions/2.0.11/references/security-checklist.md +245 -0
  513. package/.versions/2.0.11/references/testing-patterns.md +235 -0
  514. package/.versions/2.0.11/references/workflow-authoring.md +304 -0
  515. package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
  516. package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  517. package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
  518. package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
  519. package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
  520. package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
  521. package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
  522. package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
  523. package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
  524. package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  525. package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
  526. package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  527. package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  528. package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  529. package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
  530. package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
  531. package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
  532. package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  533. package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  534. package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
  535. package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
  536. package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
  537. package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
  538. package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
  539. package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
  540. package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
  541. package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
  542. package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
  543. package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  544. package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
  545. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  546. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  547. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  548. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  549. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  550. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  551. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  552. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  553. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  554. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  555. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  556. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  557. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  558. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  559. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  560. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  561. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  562. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  563. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  564. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  565. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  566. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  567. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  568. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  569. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  570. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  571. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  572. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  573. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  574. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  575. package/.versions/2.0.12/.pi/agent-fleet/hermes/README.md +347 -0
  576. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  577. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  578. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  579. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  580. package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  581. package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  582. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  583. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  584. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  585. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  586. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  587. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  588. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  589. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  590. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  591. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  592. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  593. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  594. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  595. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  596. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  597. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  598. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  599. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  600. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  601. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  602. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  603. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  604. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  605. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  606. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  607. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  608. package/.versions/2.0.12/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  609. package/.versions/2.0.12/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  610. package/.versions/2.0.12/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  611. package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  612. package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  613. package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  614. package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  615. package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  616. package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet.ts +216 -0
  617. package/.versions/2.0.12/.pi/agent-fleet/scripts/flow.ts +155 -0
  618. package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  619. package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  620. package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  621. package/.versions/2.0.12/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  622. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  623. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  624. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  625. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  626. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  627. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  628. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  629. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  630. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  631. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  632. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  633. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  634. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  635. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  636. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  637. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  638. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  639. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  640. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  641. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  642. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  643. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  644. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  645. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  646. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  647. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  648. package/.versions/2.0.12/.pi/agent-fleet/scripts/package-lock.json +35 -0
  649. package/.versions/2.0.12/.pi/agent-fleet/scripts/package.json +9 -0
  650. package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  651. package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  652. package/.versions/2.0.12/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  653. package/.versions/2.0.12/.pi/agent-fleet/scripts/team-up.ts +378 -0
  654. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  655. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  656. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  657. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  658. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  659. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  660. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  661. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  662. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  663. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  664. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  665. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  666. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  667. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  668. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  669. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  670. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  671. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  672. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  673. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  674. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  675. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  676. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  677. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  678. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  679. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  680. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  681. package/.versions/2.0.12/.pi/agents/dispatch-policy.yaml +32 -0
  682. package/.versions/2.0.12/.pi/agents/model-profiles.yaml +83 -0
  683. package/.versions/2.0.12/.pi/agents/peers.yaml +147 -0
  684. package/.versions/2.0.12/.pi/agents/teams.yaml +41 -0
  685. package/.versions/2.0.12/.pi/agents/voices.yaml +13 -0
  686. package/.versions/2.0.12/.pi/damage-control-rules.yaml +297 -0
  687. package/.versions/2.0.12/.pi/extensions/btw/README.md +120 -0
  688. package/.versions/2.0.12/.pi/extensions/btw/index.ts +914 -0
  689. package/.versions/2.0.12/.pi/extensions/btw/package.json +6 -0
  690. package/.versions/2.0.12/.pi/extensions/btw/state.js +179 -0
  691. package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  692. package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  693. package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  694. package/.versions/2.0.12/.pi/extensions/compact-and-continue/README.md +42 -0
  695. package/.versions/2.0.12/.pi/extensions/compact-and-continue/index.ts +120 -0
  696. package/.versions/2.0.12/.pi/extensions/compact-and-continue/package.json +6 -0
  697. package/.versions/2.0.12/.pi/extensions/mcp-bridge/README.md +46 -0
  698. package/.versions/2.0.12/.pi/extensions/mcp-bridge/index.ts +206 -0
  699. package/.versions/2.0.12/.pi/extensions/mcp-bridge/package.json +6 -0
  700. package/.versions/2.0.12/.pi/extensions/package-lock.json +1175 -0
  701. package/.versions/2.0.12/.pi/extensions/package.json +9 -0
  702. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/README.md +224 -0
  703. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/config.ts +198 -0
  704. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  705. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/index.ts +248 -0
  706. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/package.json +6 -0
  707. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  708. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  709. package/.versions/2.0.12/.pi/harnesses/agent-hub/README.md +1309 -0
  710. package/.versions/2.0.12/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  711. package/.versions/2.0.12/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  712. package/.versions/2.0.12/.pi/harnesses/agent-hub/artifacts.js +146 -0
  713. package/.versions/2.0.12/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  714. package/.versions/2.0.12/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  715. package/.versions/2.0.12/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  716. package/.versions/2.0.12/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  717. package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  718. package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  719. package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  720. package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  721. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  722. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  723. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  724. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  725. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  726. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  727. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  728. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  729. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  730. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  731. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  732. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  733. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  734. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  735. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  736. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  737. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  738. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  739. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  740. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  741. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  742. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  743. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  744. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  745. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  746. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  747. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  748. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  749. package/.versions/2.0.12/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  750. package/.versions/2.0.12/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  751. package/.versions/2.0.12/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  752. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  753. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  754. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  755. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  756. package/.versions/2.0.12/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  757. package/.versions/2.0.12/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  758. package/.versions/2.0.12/.pi/harnesses/agent-hub/context-window.js +108 -0
  759. package/.versions/2.0.12/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  760. package/.versions/2.0.12/.pi/harnesses/agent-hub/delegate.ts +465 -0
  761. package/.versions/2.0.12/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  762. package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  763. package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  764. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  765. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  766. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  767. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  768. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +202 -0
  769. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-types.ts +251 -0
  770. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  771. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  772. package/.versions/2.0.12/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  773. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  774. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  775. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  776. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  777. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  778. package/.versions/2.0.12/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  779. package/.versions/2.0.12/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  780. package/.versions/2.0.12/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  781. package/.versions/2.0.12/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  782. package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
  783. package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  784. package/.versions/2.0.12/.pi/harnesses/agent-hub/footer.ts +30 -0
  785. package/.versions/2.0.12/.pi/harnesses/agent-hub/helpers.ts +270 -0
  786. package/.versions/2.0.12/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  787. package/.versions/2.0.12/.pi/harnesses/agent-hub/index.ts +2301 -0
  788. package/.versions/2.0.12/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  789. package/.versions/2.0.12/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  790. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  791. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  792. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  793. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  794. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  795. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  796. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  797. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  798. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  799. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  800. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  801. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  802. package/.versions/2.0.12/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  803. package/.versions/2.0.12/.pi/harnesses/agent-hub/package.json +7 -0
  804. package/.versions/2.0.12/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  805. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  806. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  807. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  808. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  809. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  810. package/.versions/2.0.12/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  811. package/.versions/2.0.12/.pi/harnesses/agent-hub/presentation.ts +48 -0
  812. package/.versions/2.0.12/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  813. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  814. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  815. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  816. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  817. package/.versions/2.0.12/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  818. package/.versions/2.0.12/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  819. package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  820. package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  821. package/.versions/2.0.12/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  822. package/.versions/2.0.12/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  823. package/.versions/2.0.12/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  824. package/.versions/2.0.12/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  825. package/.versions/2.0.12/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  826. package/.versions/2.0.12/.pi/harnesses/agent-hub/return-contract.js +327 -0
  827. package/.versions/2.0.12/.pi/harnesses/agent-hub/return-extract.js +77 -0
  828. package/.versions/2.0.12/.pi/harnesses/agent-hub/review-findings.js +104 -0
  829. package/.versions/2.0.12/.pi/harnesses/agent-hub/run-budget.js +542 -0
  830. package/.versions/2.0.12/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  831. package/.versions/2.0.12/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  832. package/.versions/2.0.12/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  833. package/.versions/2.0.12/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  834. package/.versions/2.0.12/.pi/harnesses/agent-hub/session-audit.ts +226 -0
  835. package/.versions/2.0.12/.pi/harnesses/agent-hub/session-health.js +110 -0
  836. package/.versions/2.0.12/.pi/harnesses/agent-hub/session-start.ts +42 -0
  837. package/.versions/2.0.12/.pi/harnesses/agent-hub/spawn.ts +526 -0
  838. package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
  839. package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-report.ts +84 -0
  840. package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
  841. package/.versions/2.0.12/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  842. package/.versions/2.0.12/.pi/harnesses/agent-hub/timeline.ts +72 -0
  843. package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  844. package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  845. package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  846. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  847. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  848. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  849. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  850. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  851. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  852. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  853. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  854. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  855. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  856. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  857. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  858. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  859. package/.versions/2.0.12/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  860. package/.versions/2.0.12/.pi/harnesses/agent-hub/types.ts +66 -0
  861. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  862. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  863. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/detail-panel.ts +171 -0
  864. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  865. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  866. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  867. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-source.ts +170 -0
  868. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  869. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  870. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  871. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  872. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  873. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  874. package/.versions/2.0.12/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  875. package/.versions/2.0.12/.pi/harnesses/agent-hub/version.ts +42 -0
  876. package/.versions/2.0.12/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  877. package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  878. package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  879. package/.versions/2.0.12/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  880. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/README.md +59 -0
  881. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/index.ts +558 -0
  882. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  883. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  884. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  885. package/.versions/2.0.12/.pi/harnesses/coms/README.md +100 -0
  886. package/.versions/2.0.12/.pi/harnesses/coms/index.ts +282 -0
  887. package/.versions/2.0.12/.pi/harnesses/coms/package.json +7 -0
  888. package/.versions/2.0.12/.pi/harnesses/coms/version.ts +42 -0
  889. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/README.md +135 -0
  890. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/index.ts +550 -0
  891. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/package.json +7 -0
  892. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/version.ts +42 -0
  893. package/.versions/2.0.12/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  894. package/.versions/2.0.12/.pi/harnesses/lib/coms-core-io.ts +385 -0
  895. package/.versions/2.0.12/.pi/harnesses/lib/coms-core.ts +577 -0
  896. package/.versions/2.0.12/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  897. package/.versions/2.0.12/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  898. package/.versions/2.0.12/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  899. package/.versions/2.0.12/.pi/harnesses/lib/context-budget-view.ts +107 -0
  900. package/.versions/2.0.12/.pi/harnesses/lib/context-budget.ts +114 -0
  901. package/.versions/2.0.12/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  902. package/.versions/2.0.12/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  903. package/.versions/2.0.12/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  904. package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  905. package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  906. package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  907. package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-view.ts +136 -0
  908. package/.versions/2.0.12/.pi/harnesses/lib/fleet-detail-view.ts +278 -0
  909. package/.versions/2.0.12/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  910. package/.versions/2.0.12/.pi/harnesses/lib/fleet-panel.ts +34 -0
  911. package/.versions/2.0.12/.pi/harnesses/lib/fleet-read-model.ts +405 -0
  912. package/.versions/2.0.12/.pi/harnesses/lib/fleet-selection.ts +24 -0
  913. package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  914. package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-view.ts +144 -0
  915. package/.versions/2.0.12/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  916. package/.versions/2.0.12/.pi/harnesses/lib/herdr-client.ts +472 -0
  917. package/.versions/2.0.12/.pi/harnesses/lib/herdr-presence.ts +399 -0
  918. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  919. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  920. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  921. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  922. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  923. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  924. package/.versions/2.0.12/.pi/harnesses/lib/spawned-peers.js +191 -0
  925. package/.versions/2.0.12/.pi/harnesses/lib/system1/config.js +61 -0
  926. package/.versions/2.0.12/.pi/harnesses/lib/system1/contracts.ts +152 -0
  927. package/.versions/2.0.12/.pi/harnesses/lib/system1/demo.ts +106 -0
  928. package/.versions/2.0.12/.pi/harnesses/lib/system1/jev.ts +503 -0
  929. package/.versions/2.0.12/.pi/harnesses/lib/system1/service.ts +245 -0
  930. package/.versions/2.0.12/.pi/harnesses/lib/update-check.ts +222 -0
  931. package/.versions/2.0.12/.pi/harnesses/package-lock.json +2039 -0
  932. package/.versions/2.0.12/.pi/harnesses/package.json +10 -0
  933. package/.versions/2.0.12/.pi/prompts/af-build.md +24 -0
  934. package/.versions/2.0.12/.pi/prompts/af-code-simplify.md +22 -0
  935. package/.versions/2.0.12/.pi/prompts/af-constraints.md +31 -0
  936. package/.versions/2.0.12/.pi/prompts/af-plan.md +17 -0
  937. package/.versions/2.0.12/.pi/prompts/af-review.md +16 -0
  938. package/.versions/2.0.12/.pi/prompts/af-set-hermes-telegram.md +15 -0
  939. package/.versions/2.0.12/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  940. package/.versions/2.0.12/.pi/prompts/af-ship.md +17 -0
  941. package/.versions/2.0.12/.pi/prompts/af-spec.md +15 -0
  942. package/.versions/2.0.12/.pi/prompts/af-test.md +19 -0
  943. package/.versions/2.0.12/.pi/skills/bowser/SKILL.md +145 -0
  944. package/.versions/2.0.12/.version +1 -0
  945. package/.versions/2.0.12/agents/architect.md +25 -0
  946. package/.versions/2.0.12/agents/bowser.md +28 -0
  947. package/.versions/2.0.12/agents/builder.md +56 -0
  948. package/.versions/2.0.12/agents/code-reviewer.md +210 -0
  949. package/.versions/2.0.12/agents/deep-researcher.md +33 -0
  950. package/.versions/2.0.12/agents/documenter.md +23 -0
  951. package/.versions/2.0.12/agents/orchestrator.md +23 -0
  952. package/.versions/2.0.12/agents/plan-reviewer.md +84 -0
  953. package/.versions/2.0.12/agents/planner.md +106 -0
  954. package/.versions/2.0.12/agents/releaser.md +25 -0
  955. package/.versions/2.0.12/agents/researcher.md +31 -0
  956. package/.versions/2.0.12/agents/security-auditor.md +168 -0
  957. package/.versions/2.0.12/agents/test-engineer.md +154 -0
  958. package/.versions/2.0.12/agents/web-debugger.md +44 -0
  959. package/.versions/2.0.12/agents/web-performance-auditor.md +194 -0
  960. package/.versions/2.0.12/bin/catalog/harness-runtime-closure.json +61 -0
  961. package/.versions/2.0.12/codex/fleet-session-client/SKILL.md +34 -0
  962. package/.versions/2.0.12/codex/fleet-session-client.zip +0 -0
  963. package/.versions/2.0.12/docs/ARCHITECTURE.md +705 -0
  964. package/.versions/2.0.12/docs/agent-fleet-setup.md +682 -0
  965. package/.versions/2.0.12/docs/claude-code-coms-bridge.md +134 -0
  966. package/.versions/2.0.12/docs/codex-session-bridge.md +219 -0
  967. package/.versions/2.0.12/docs/coms-hermes-bridge.md +188 -0
  968. package/.versions/2.0.12/docs/getting-started.md +126 -0
  969. package/.versions/2.0.12/docs/npm-install.md +468 -0
  970. package/.versions/2.0.12/docs/pi-extensions.md +449 -0
  971. package/.versions/2.0.12/docs/pi-setup.md +92 -0
  972. package/.versions/2.0.12/docs/skill-anatomy.md +150 -0
  973. package/.versions/2.0.12/install-manifest.json +3053 -0
  974. package/.versions/2.0.12/justfile +247 -0
  975. package/.versions/2.0.12/manifest-meta.json +995 -0
  976. package/.versions/2.0.12/references/accessibility-checklist.md +160 -0
  977. package/.versions/2.0.12/references/communication-contract.md +26 -0
  978. package/.versions/2.0.12/references/definition-of-done.md +67 -0
  979. package/.versions/2.0.12/references/fleet-coordination-patterns.md +171 -0
  980. package/.versions/2.0.12/references/observability-checklist.md +92 -0
  981. package/.versions/2.0.12/references/orchestration-patterns.md +370 -0
  982. package/.versions/2.0.12/references/performance-checklist.md +236 -0
  983. package/.versions/2.0.12/references/prompting-patterns.md +380 -0
  984. package/.versions/2.0.12/references/security-checklist.md +245 -0
  985. package/.versions/2.0.12/references/testing-patterns.md +235 -0
  986. package/.versions/2.0.12/references/workflow-authoring.md +304 -0
  987. package/.versions/2.0.12/skills/_internal/grilling.md +59 -0
  988. package/.versions/2.0.12/skills/browser-testing-with-devtools/SKILL.md +351 -0
  989. package/.versions/2.0.12/skills/code-review-and-quality/SKILL.md +396 -0
  990. package/.versions/2.0.12/skills/compound-learning/SKILL.md +137 -0
  991. package/.versions/2.0.12/skills/constraint-driven-development/SKILL.md +338 -0
  992. package/.versions/2.0.12/skills/constraint-driven-development/references/floor-guard.md +99 -0
  993. package/.versions/2.0.12/skills/context-engineering/SKILL.md +341 -0
  994. package/.versions/2.0.12/skills/deprecation-and-migration/SKILL.md +247 -0
  995. package/.versions/2.0.12/skills/designing-agents/SKILL.md +394 -0
  996. package/.versions/2.0.12/skills/designing-agents/pi-harness-authoring.md +222 -0
  997. package/.versions/2.0.12/skills/drafting-workflows/SKILL.md +143 -0
  998. package/.versions/2.0.12/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  999. package/.versions/2.0.12/skills/frontend-ui-engineering/SKILL.md +328 -0
  1000. package/.versions/2.0.12/skills/git-workflow-and-versioning/SKILL.md +316 -0
  1001. package/.versions/2.0.12/skills/idea-refine/SKILL.md +182 -0
  1002. package/.versions/2.0.12/skills/idea-refine/examples.md +238 -0
  1003. package/.versions/2.0.12/skills/idea-refine/frameworks.md +99 -0
  1004. package/.versions/2.0.12/skills/idea-refine/refinement-criteria.md +113 -0
  1005. package/.versions/2.0.12/skills/idea-refine/scripts/idea-refine.sh +15 -0
  1006. package/.versions/2.0.12/skills/incremental-implementation/SKILL.md +302 -0
  1007. package/.versions/2.0.12/skills/interview-me/SKILL.md +226 -0
  1008. package/.versions/2.0.12/skills/orchestration-verification/SKILL.md +182 -0
  1009. package/.versions/2.0.12/skills/peer-coms/SKILL.md +90 -0
  1010. package/.versions/2.0.12/skills/performance-optimization/SKILL.md +496 -0
  1011. package/.versions/2.0.12/skills/planning-and-task-breakdown/SKILL.md +289 -0
  1012. package/.versions/2.0.12/skills/security-and-hardening/SKILL.md +524 -0
  1013. package/.versions/2.0.12/skills/spec-driven-development/SKILL.md +295 -0
  1014. package/.versions/2.0.12/skills/using-agent-skills/SKILL.md +198 -0
  1015. package/.versions/2.0.12/vendor/agent-skills-upstream/LICENSE +21 -0
  1016. package/.versions/2.0.12/vendor/agent-skills-upstream/README.md +430 -0
  1017. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  1018. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  1019. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  1020. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  1021. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  1022. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  1023. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  1024. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  1025. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  1026. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  1027. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  1028. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  1029. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  1030. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  1031. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  1032. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  1033. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  1034. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  1035. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  1036. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  1037. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  1038. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  1039. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  1040. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  1041. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  1042. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  1043. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  1044. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  1045. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  1046. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  1047. package/CHANGELOG.md +18 -0
  1048. package/README.md +1 -0
  1049. package/bin/catalog/harness-runtime-closure.json +29 -0
  1050. package/bin/cli.js +18 -7
  1051. package/bin/lib/doctor.js +146 -2
  1052. package/docs/ARCHITECTURE.md +292 -3
  1053. package/docs/agent-fleet-setup.md +96 -0
  1054. package/docs/npm-install.md +87 -2
  1055. package/docs/workflows.md +8 -2
  1056. package/install-manifest.json +64 -2
  1057. package/manifest-meta.json +25 -0
  1058. package/package.json +6 -2
@@ -0,0 +1,682 @@
1
+ # Agent Fleet — Project Files
2
+
3
+ agent-fleet keeps a few small files in a project's `.ai/` directory. They have
4
+ different readers and different lifetimes, so they are kept separate.
5
+
6
+ | File | Read by | When |
7
+ |------|---------|------|
8
+ | `.ai/agent-fleet-overrides.md` | `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`, `git-workflow-and-versioning`, `compound-learning` (the `rules:`/`docs:` keys of `## agent-hub`), `agent-hub` pi harness | Every run of those skills / every session start of the harness |
9
+ | `.ai/agent-fleet.json` | the deterministic `agent-fleet` lifecycle (`setup`) — human-owned desired state (preset/features); intended to be committed | Every setup plan; created/updated when setup persists desired state or migrates legacy installs |
10
+ | `.ai/agent-fleet-state.json` | the deterministic `agent-fleet` lifecycle (`setup`, `doctor`, `uninstall`) | Every lifecycle plan and apply |
11
+ | `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
12
+ | `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
13
+ | `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
14
+ | `.ai/system1.json` *(optional)* | System 1 shared runtime and doctor | When the experimental `system1` feature is explicitly selected |
15
+
16
+ The `.ai/system1.json` file is human-owned, non-secret provider configuration.
17
+ Setup prints its required shape but does not create or overwrite it. Its
18
+ `apiKeyEnv` field names a caller-environment variable; it never contains the
19
+ credential itself. See [System 1 configuration](#system-1-configuration).
20
+
21
+ The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
22
+ extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
23
+ **no secrets** — it names the env vars (`apiKeyEnv`, plus the Azure endpoint var) whose values
24
+ live in a gitignored root `.env`. See [pi-voice-stt config](#ai-sttjson) below.
25
+
26
+ Keep them split: the overrides file is loaded into context constantly, so it
27
+ must stay minimal; the install record is read only by the CLI, so it can be
28
+ large.
29
+
30
+ ## Unified Fleet runtime configuration
31
+
32
+ A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
33
+ plus Agent Hub in **operator** work mode, in the current terminal, with no native
34
+ specialists active:
35
+
36
+ ```bash
37
+ just fleet
38
+ just fleet --project af
39
+ ```
40
+
41
+ Work mode, native roster, and peer topology are separate controls:
42
+
43
+ ```bash
44
+ # Direct tools plus an available native roster.
45
+ just fleet --work-mode operator --agents frontend --project af
46
+
47
+ # A roster implies orchestrator when work mode is not explicit.
48
+ just fleet --agents frontend --project af
49
+
50
+ # Herdr Hub-only and Hub-plus-peer topologies.
51
+ just fleet --herdr --project af
52
+ just fleet --agents frontend --peers frontend --project af
53
+ ```
54
+
55
+ Startup precedence is deterministic: explicit `--work-mode` wins; otherwise an
56
+ explicit `--agents` roster implies `orchestrator`; otherwise work mode is
57
+ `operator`. An orchestrator startup must name a roster. `--herdr` affects only
58
+ placement, while `--peers <preset>` implies Herdr and starts the selected peer
59
+ preset. Neither topology option selects a native roster.
60
+
61
+ `--project <name>` selects one coms namespace for the Hub and every standing or
62
+ dynamically spawned peer. Dynamic peer tools deliberately expose no project
63
+ override, so an agent cannot cross that boundary. The default project is
64
+ `default`; use an explicit project when multiple fleets share a machine.
65
+
66
+ The configuration files have distinct ownership:
67
+
68
+ | File | Controls |
69
+ | --- | --- |
70
+ | `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
71
+ | `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
72
+ | `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
73
+ | `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budget ceilings, watchdog, and related execution policy. It does not choose startup work mode or topology. |
74
+
75
+ For deterministic routing, `backend: "native"` always starts the local Pi
76
+ specialist even if a same-name peer is visible. `backend: "coms"` requires a
77
+ visible same-name peer and refuses without native fallback. The default
78
+ `backend: "auto"` follows `dispatch-policy.yaml` and preserves its configured
79
+ fallback behavior.
80
+
81
+ Capability packs load automatically—do not run an activation command. Explicit task intent activates the matching ready surface; readiness alone never exposes coms or Herdr tools to the model. Ambiguous fleet/peer/workspace intent gets one confirmation before its first side effect, and active task packs persist until the explicit `set_task_tier(new_task: true)` reset.
82
+
83
+ Capability flags and runtime gates fail closed:
84
+
85
+ - `--no-coms` keeps operator direct tools and native dispatch available, but
86
+ peer dispatch, `coms_send`/`coms_await`, and `/af-handoff` refuse actionably.
87
+ - `--herdr` and `--peers` require a running [Herdr](https://herdr.dev) server.
88
+ Without Herdr, bare Fleet still works and dynamic pane tools stay inactive.
89
+ - `--browser` adds the browser extension surface and `--all-extensions` opts
90
+ into the complete approved extension set. Missing optional dependencies do
91
+ not grant tools merely because a flag was supplied.
92
+ - Hub-owned slash commands remain registered in both work modes. A missing coms
93
+ runtime, Herdr connection, target peer, or native roster produces a
94
+ capability refusal rather than a missing command.
95
+
96
+ During the migration release, `just fleet hub`, `just fleet team <preset>`,
97
+ `just fleet team <preset> --no-hub`, and `--solo` remain accepted and print a
98
+ canonical replacement. New automation should use `just fleet` with
99
+ `--agents`, `--peers`, `--herdr`, and `--no-coms`; compatibility does not imply
100
+ that the deprecated grammar will remain indefinitely.
101
+
102
+ ### Resume and recovery
103
+
104
+ The Hub distinguishes the **pre-turn surface** (stable replacement prompt, volatile state capsule,
105
+ and active tool schemas) from **intra-turn pressure** (conversation and tool results accumulated in
106
+ the live model window). `/af-context` shows both. At 80% live usage the Hub warns and transiently makes
107
+ compaction support available; at 90% it blocks the next provider continuation and requests a
108
+ single automatic compaction after the current result is persisted. A prompt submitted during
109
+ startup/recovery is retained in memory and replayed once after success.
110
+
111
+ If automatic recovery fails, the prompt remains retained. Pi's built-in command is the bare-runtime
112
+ fallback:
113
+
114
+ ```text
115
+ /compact Preserve the current goal, decisions, modified files, pending operations, blockers, and next step.
116
+ ```
117
+
118
+ You can also switch to a larger-context model. Do not try to make room by editing the session file.
119
+ The JSONL shown by `/session` under `~/.pi/agent/sessions/` is Pi's authoritative append-only record;
120
+ resume with `/resume`, `pi -c`, or `pi --session <path|id>`. Never edit, truncate, reorder, or add
121
+ synthetic entries to recover from context pressure.
122
+
123
+ A resumed orchestrator session may instead be blocked because its persisted team name no longer
124
+ resolves against the current `.pi/agents/teams.yaml` and persona files. This is a fail-closed roster
125
+ recovery gate: orchestrator work mode and its direct-tool restrictions remain in force. Choose a valid
126
+ team with `/af-agents-team`, restart publicly with `just fleet --agents <name>`, or explicitly choose
127
+ operator work mode with `/af-work-mode operator` / `just fleet --work-mode operator`. Direct Pi launches
128
+ use `--agent-team <name>` or `--work-mode operator`. Explicit startup flags win over persisted state;
129
+ fix missing or renamed team/persona declarations before selecting them.
130
+
131
+ ## System 1 configuration
132
+
133
+ System 1 is an experimental named feature and is excluded from automatic
134
+ Default/Full selection. Select it explicitly and persist that desired state when
135
+ needed:
136
+
137
+ ```bash
138
+ npx @chankov/agent-fleet@latest setup \
139
+ --preset default --features system1 --save-desired --yes
140
+ ```
141
+
142
+ Then create the human-owned `.ai/system1.json` with exactly these version-1
143
+ fields and values:
144
+
145
+ ```json
146
+ {
147
+ "version": 1,
148
+ "mode": "auto",
149
+ "provider": "typesafe",
150
+ "model": "jev-1.13.0",
151
+ "apiKeyEnv": "TYPESAFE_API_KEY"
152
+ }
153
+ ```
154
+
155
+ `mode: "off"` disables the service even when a key exists. Selection plus
156
+ `mode: "auto"` still requires the valid configuration and a nonempty
157
+ `TYPESAFE_API_KEY` in the caller environment. Key presence alone never enables
158
+ System 1. The runtime does not execute `.env`: the managed `just` launcher can
159
+ load the root `.env`, while a direct Node invocation must receive an exported or
160
+ otherwise injected variable.
161
+
162
+ `agent-fleet doctor` reads the desired state and configuration as data. Its
163
+ System 1 result is advisory and read-only, including with `--fix`; it performs
164
+ no provider request and does not validate the key. A declaration in `.env` is
165
+ reported separately from a value present in doctor's current environment.
166
+
167
+ The installed demo is offline unless `--live` is supplied. Both forms require a
168
+ Node runtime supporting `--experimental-strip-types`:
169
+
170
+ ```bash
171
+ # Readiness only; no provider call.
172
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
173
+ .pi/harnesses/lib/system1/demo.ts
174
+
175
+ # Explicit live request using only embedded synthetic Bulgarian/English data.
176
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
177
+ .pi/harnesses/lib/system1/demo.ts --live
178
+ ```
179
+
180
+ The only phase-0 production provider/model is TypeSafe Jev `jev-1.13.0` at its
181
+ fixed official endpoint. No local model is installed and no fallback model is
182
+ selected. Outputs preserve available uncertainty but do not establish truth,
183
+ action authority, or calibration for a particular domain/language. The native specialist drift watchdog has a separate **consumer opt-in**:
184
+ `watchdog-system1: off|shadow|active` in `## agent-hub` (default `off`).
185
+ It also requires an armed watchdog, explicit feature selection, valid shared
186
+ configuration and a key. `off` makes no System 1 evaluation. `shadow` runs the
187
+ LLM judge immediately and System 1 in parallel; only the LLM can stop a child.
188
+ `active` is an **uncalibrated, explicitly opted-in experiment**: only the
189
+ advisory `scope` rule may skip LLM when Jev `jev-1.13.0` returns provider
190
+ `on_track` with confidence and on-track distribution ≥0.95 and all three
191
+ contradiction probabilities ≤0.05. Terminal `loop`, `failures`, and `toolcap`
192
+ always use LLM. `/af-watchdog` labels this `experimental: scope only; G2 not
193
+ validated`. This can miss a scope advisory; it is not G2 approval. Missing or
194
+ mismatched provider/config returns to LLM; default consumer mode remains off. Restart Hub to apply a
195
+ consumer mode/config snapshot; `/af-watchdog on|off|auto` changes Layer 1 arming,
196
+ not the System 1 consumer mode. For rollback set `watchdog-system1: off` for the
197
+ next session (cancel the current run if needed).
198
+
199
+ **System 1 outbound state** is limited to a redacted task, normalized relative
200
+ scope/paths, 40 structured tool events without commands, bodies, arguments or
201
+ outputs, rule facts, coverage and counters (32 KiB maximum). This does **not**
202
+ limit the existing parallel LLM judge prompt: it includes the original task,
203
+ scope and a recent trail with up to 120 characters of raw tool arguments per
204
+ call. Both paths can reveal data. For a future pilot, review the tasks, files
205
+ and likely tool arguments; never use client/production data or secrets. Manual
206
+ review cannot guarantee that an agent will not produce unexpected arguments.
207
+ The final native spawn env removes `TYPESAFE_API_KEY`; this does not protect
208
+ against file reads or other launchers. Trace (`<sessionDir>/artifacts/watchdog/events.jsonl`)
209
+ records only allowlisted metadata. `/af-watchdog` shows readiness/checks, the
210
+ strip under chat and `/af-agents` show owner badges and detail history;
211
+ `/af-hub-report` counts evaluations/LLM attempts separately; `/af-audit`
212
+ shows read-only decision status including `judge_unavailable`. Missing usage
213
+ is unknown, not zero. A failed judge gets one live, revalidated retry after 5 s
214
+ rather than the 90 s success cooldown. Offline report code and mock tests are
215
+ not a real shadow pilot. G1 requires manual/outbound review; G2 additionally
216
+ requires independent human labels identifying the snapshot **and LLM attempt**,
217
+ held-out session evaluation and an explicit maintainer-approved profile. Older
218
+ labels without an LLM attempt ID cannot qualify. No gate is inferred from doctor readiness.
219
+
220
+ ## The overrides file — `.ai/agent-fleet-overrides.md`
221
+
222
+ Some skills and pi harnesses need facts specific to each project — where specs
223
+ and plans are saved, how to start a dev server, whether the agent may create
224
+ branches, or which user-facing language a dispatcher should use. Each reader
225
+ ships a sensible **default**; a project that needs something different declares
226
+ it here, and the reader picks it up.
227
+
228
+ - **Location:** `.ai/agent-fleet-overrides.md` at the project root.
229
+ - **Format:** Markdown. One `## <section-name>` section per skill or harness reader, with terse
230
+ `key: value` lines. Block values use the `key: |` multi-line form. No prose
231
+ and no install detail — readers parse it by key and load it on every run/session start.
232
+ - **Commit it.** Shared project configuration belongs in version control. Make
233
+ sure no `.gitignore` rule (for example a broad `.env*` pattern) excludes it.
234
+ - **No secrets.** For anything sensitive (test-account credentials), reference
235
+ the **name** of an environment variable; the real value lives in a gitignored
236
+ `.env`.
237
+ - If the file is absent, or a reader has no section in it, that reader uses its
238
+ built-in default.
239
+ - **Validation.** Because an unknown section or key silently falls back to the
240
+ default, typos are invisible at runtime. `agent-fleet doctor` (and the
241
+ runtime's Agent Fleet doctor command) validates the file — unknown sections,
242
+ unknown keys in known sections, invalid values for the mechanically parsed
243
+ `agent-hub` keys, missing `rules:` folders, missing `append-prompt:` files,
244
+ unknown `poll-panel:` names, and unset `## env` vars — as
245
+ **advisory, warn-only findings**; it never edits the file.
246
+
247
+ ### `spec-driven-development`
248
+
249
+ | Key | Default | Meaning |
250
+ |-----|---------|---------|
251
+ | `spec-dir` | `docs/prds/{area}` | Directory specs are written to |
252
+ | `naming` | `PRD{n}-{topic}` | File name pattern; `{n}` = next free PRD number, `{topic}` = kebab-case slug |
253
+
254
+ Default output: `docs/prds/{area}/PRD{n}-{topic}.md`.
255
+
256
+ ### `planning-and-task-breakdown`
257
+
258
+ | Key | Default | Meaning |
259
+ |-----|---------|---------|
260
+ | `plan-dir` | `docs/plans/{area}` | Directory plans are written to |
261
+ | `naming` | `PLAN-{prd-name}-{phase}` | File name pattern; `{phase}` suffix only when a plan spans multiple files |
262
+ | `todo` | `embedded` | `embedded` keeps the task list inside the plan; `separate` writes a standalone `todo.md` |
263
+
264
+ Default output: `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, task list embedded.
265
+
266
+ ### `browser-testing-with-devtools`
267
+
268
+ This skill has **no default** — the section is required for browser testing,
269
+ because dev-server commands and login flows cannot be guessed.
270
+
271
+ | Key | Meaning |
272
+ |-----|---------|
273
+ | `dev-server` | Command to start the local dev server |
274
+ | `ready-check` | How to confirm the server is up |
275
+ | `base-url` | Root URL for navigation |
276
+ | `auth-flow` | Steps to log in (multi-line `|` block) |
277
+ | `roles` | Test account per privilege level, referenced by env-var name |
278
+ | `notes` | Anything else the agent should know (certs, seed data, ...) |
279
+
280
+ ### `git-workflow-and-versioning`
281
+
282
+ | Key | Default | Meaning |
283
+ |-----|---------|---------|
284
+ | `branching` | `never` | `never` = agent works in the current branch and never creates or switches branches; `allow` = agent may create feature branches |
285
+
286
+ ### `agent-hub`
287
+
288
+ Read by the `.pi/harnesses/agent-hub/` pi harness on every session start. The canonical
289
+ section name is `## agent-hub`; the harness also accepts the legacy `## agent-team` name
290
+ (from before the standalone `agent-team` harness was retired), so existing project
291
+ override files keep working unchanged. When both sections are present their keys merge,
292
+ with later lines winning.
293
+
294
+ The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
295
+ skill (and the `/af-compound` agent-hub command built on it) resolves them as the
296
+ targets an end-of-session compound pass writes lessons to.
297
+
298
+ | Key | Default | Meaning |
299
+ |-----|---------|---------|
300
+ | `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
301
+ | `persona-gate` | — | **Removed.** Ignored with a doctor warning; dispatcher flavor is no longer selectable. Use `/af-work-mode` for operator vs orchestrator. Delete the key. |
302
+ | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). If the override reports a model/provider error or aborted request before producing text or starting a tool (including a local-model memory-limit failure), agent-hub restores the child session and retries once with the original frontmatter model; it does not fallback after work starts, cancellation, timeout, drift stop, or process-spawn failure. |
303
+ | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
304
+ | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
305
+ | `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>][, thinking=<off\|minimal\|low\|medium\|high\|xhigh>]`. Other declared roles keep their frontmatter values. Existing roles retain their original frontmatter model as the same one-shot, pre-work-only runtime fallback; model-only overrides retain the declared tool cap. An invalid `thinking=` value is ignored with a session-start warning and the role stays at `off` unless frontmatter already set a valid level. |
306
+ | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
307
+ | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
308
+ | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
309
+ | `research-keep` | — | **Removed.** Ignored with a session-start warning; live research helpers disappear from the Fleet Dashboard (`Alt+A`) on every terminal outcome. Session, transcript, and findings files plus `/af-agents-history` records remain. Delete the key. |
310
+ | `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
311
+ | `mode` | — | **Removed.** Ignored with a warning; budgets follow task tier. Delete the key. |
312
+ | `max-dispatches-per-turn` | tier default (1/2/8/12) | Ceiling on `dispatch_agent` calls per user turn (`min` with the task-tier envelope). Positive integer or `off` (stays at the tier). |
313
+ | `max-research-per-turn` | tier default (1/2/4/6) | Ceiling on dispatcher-initiated `spawn_research` calls per user turn. The automatic `NEEDS_RESEARCH:` pipe is exempt from the turn budget but still counts against the task research envelope. Positive integer or `off` (stays at the tier). |
314
+ | `turn-wall-time-s` | tier default (900/900/3600/5400) | Active-time ceiling, in seconds, per user turn; time blocked in `ask_user` is excluded. Once exceeded, further dispatch/research calls refuse until the one-click continuation is accepted or a new user turn begins. Positive integer or `off` (stays at the tier). |
315
+ | `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
316
+ | `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
317
+ | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
318
+ | `watchdog-system1` | `off` | Native specialist consumer only: `off`, `shadow`, or explicitly opted-in experimental `active` for advisory `scope` only (0.95/0.05; not G2-validated). Requires the separate selected feature and shared config; no automatic outbound request from setup/doctor. |
319
+ | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
320
+ | `poll-panel` | none | Default panel name for `/af-poll` when `--panel` is omitted. Must match a panel in `.pi/agents/voices.yaml` when that file exists. Missing `--panel` and missing this key is a refusal. |
321
+ | `append-prompt` | none | Comma-separated repo-relative files appended to the system prompt of every dispatched persona. Listed files must exist. Enable the communication contract with `append-prompt: references/communication-contract.md`. |
322
+
323
+ Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
324
+ code-reviewer's thinking level, move the code-reviewer's docs sub-reviewer to a
325
+ different model, and point the team at the project's rule folders and doc entry
326
+ points:
327
+
328
+ ```markdown
329
+ ## agent-hub
330
+ language: Bulgarian
331
+ model.builder: github-copilot/claude-sonnet-4.6
332
+ models.builder: github-copilot/claude-sonnet-4.6, github-copilot/claude-haiku-4.5
333
+ thinking.code-reviewer: xhigh
334
+ subagents.code-reviewer.docs: github-copilot/claude-sonnet-4.6, tools=read,grep, thinking=medium
335
+ delegate-depth.code-reviewer: 1
336
+ recon-search-timeout-s: 120 # or off to disable the per-tool watchdog
337
+ poll-panel: default
338
+ append-prompt: references/communication-contract.md
339
+ rules: docs/rules, .ai/rules
340
+ docs: Docs/AGENTS.md, Docs/architecture/ARCHITECTURE_OVERVIEW.md
341
+ ```
342
+
343
+ ### `env` (optional, read by the doctor)
344
+
345
+ The overrides file references environment variables by **name** — test-account
346
+ credentials for `browser-testing-with-devtools`, the `pi-voice-stt` API key —
347
+ while the values live in a gitignored root `.env`. The optional `## env`
348
+ section declares which names the project's readers expect, so a fresh clone
349
+ can find out what's missing *before* a skill fails mid-run:
350
+
351
+ | Key | Meaning |
352
+ |-----|---------|
353
+ | `required` | Comma-separated env-var **names** (never values) the project's sections reference |
354
+
355
+ ```markdown
356
+ ## env
357
+ required: APP_TEST_ADMIN_USER, APP_TEST_ADMIN_PASS, AZURE_SPEECH_KEY
358
+ ```
359
+
360
+ No skill or harness loads this section. Its only reader is `agent-fleet doctor`
361
+ (and the runtime's Agent Fleet doctor command), which warns when a declared name is neither set in
362
+ the environment nor declared in the workspace root `.env`.
363
+
364
+ ### Per-peer env files (`env_file:` in peers.yaml)
365
+
366
+ Fleet peers spawned through `--peers`, `just fleet peer`, or the Hub's
367
+ constrained dynamic peer tool can carry their own environment: an `env_file:`
368
+ entry in `.pi/agents/peers.yaml` names a
369
+ **repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
370
+ that herdr injects into the peer's pane before the command runs — no `source`,
371
+ no leaking into sibling panes. The file must exist at spawn (team-up refuses
372
+ otherwise, never mid-run), and its **values never appear in `--dry-run`
373
+ output** — only the path. Keep these files gitignored exactly like the root
374
+ `.env` this section describes.
375
+
376
+ ## The install record — `.ai/agent-fleet-state.json` and `.ai/agent-fleet-setup.md`
377
+
378
+ Two files, one source of truth. `.ai/agent-fleet-state.json` is what the
379
+ installer writes and the only thing it reads back: agent, method, package
380
+ version, source root, and one entry per installed item with a per-file sha256
381
+ (or, in symlink mode, the resolved link target). `.ai/agent-fleet-setup.md` is
382
+ **rendered from it** on every apply and never parsed back, so the two cannot
383
+ disagree — it exists for humans and for older readers that still look for
384
+ `version:` and `agent:`.
385
+
386
+ Ownership is the point of the state file. An entry means "agent-fleet installed
387
+ this"; anything not listed is never removed or overwritten. That lookup is what
388
+ replaced the prose ownership rule the setup skill used to carry.
389
+
390
+ | State-file field | Meaning |
391
+ |---|---|
392
+ | `agent`, `method`, `sourceRoot` | How and from where this workspace was installed |
393
+ | `packageVersion` | The version that performed the last apply — provenance for reconciliation and legacy three-way compatibility |
394
+ | `items` | One entry per installed artifact: strategy, method, files with hashes, JSON key paths |
395
+ | `externalPackages` | Packages the user was told to install; recorded, never installed for them |
396
+ | `events` | Last few applies (verb, version, action count, conflicts) |
397
+
398
+ **No secrets, ever.** Only env-var *names* may appear — for example in the
399
+ `pi-voice-stt` record. A test asserts nothing value-shaped is persisted.
400
+
401
+ ### The recorded version and the three-way merge
402
+
403
+ The recorded `packageVersion` gives every comparison a baseline. For each
404
+ recorded artifact, the engine compares *source@recorded* from the package's
405
+ `.versions/<x.y.z>/` snapshot tree, the installed copy on disk, and
406
+ *source@current*. Deterministic `setup` is the public reconciliation command.
407
+
408
+ | Outcome | What `setup` does |
409
+ |---|---|
410
+ | Neither moved | Kept |
411
+ | Only the source moved | Clean refresh |
412
+ | Only your copy moved | **Refreshed — your edit is overwritten.** Reported in the plan as *"locally modified — selecting it overwrites your edits"*, so `--dry-run` shows it before it happens |
413
+ | Both moved, to different content | **Conflict**: the run exits `3` before writing anything. Resolve with `--on-conflict theirs` or `--on-conflict ours` |
414
+ | Retired upstream | Kept by `setup`; the deprecated `upgrade` proposes removal by name, subject to the ownership rule |
415
+
416
+ Reconciling toward the package is the point of `setup`: the workspace is meant
417
+ to match the version it records. That is why editing a shipped artifact in place
418
+ is not a supported customization route — use `.ai/agent-fleet-overrides.md`, add
419
+ artifacts under names Agent Fleet does not ship, or leave the item out of the
420
+ selection (`setup` never removes what it does not select, so an unselected item
421
+ stays installed and frozen). The deprecated `upgrade` verb preserves local edits
422
+ instead of overwriting them; if you have relied on that, it is the behavioural
423
+ difference to plan for.
424
+
425
+ If the snapshot is missing (an unpublished local build, or a version older than
426
+ `.versions/` retention), the comparison degrades to two-way, the installed copy
427
+ is treated as canonical, and the read-only auxiliary `verify` command reports it
428
+ as an advisory finding rather than pretending a diff exists.
429
+
430
+ ### Pre-engine workspaces
431
+
432
+ A workspace with only `.ai/agent-fleet-setup.md` and no state file predates the
433
+ installer engine. `setup --migrate --dry-run` previews what it can infer from
434
+ that markdown (`agent:`, `version:`) without adopting unrecorded paths. To
435
+ mutate a legacy workspace, use `setup --migrate` with an explicit preset,
436
+ features, and `--yes`. A workspace with no `version:` at all has no recorded
437
+ baseline, so no three-way merge is attempted.
438
+
439
+ Commit these files if the team should share install state — keep paths relative
440
+ so they stay portable. A self-referencing checkout (agent-fleet itself) may
441
+ instead `.gitignore` them, since their recorded paths are local to one machine.
442
+
443
+ ## Coms-backed team members
444
+
445
+ A team member the `agent-hub` harness dispatches (`.pi/agents/teams.yaml`) can be
446
+ served by a live coms peer of the same name instead of a freshly spawned native
447
+ subagent. With the default `backend: "auto"`,
448
+ `.pi/agents/dispatch-policy.yaml` decides that per member at dispatch time;
449
+ explicit `native` bypasses substitution, while explicit `coms` requires the
450
+ peer and never falls back. `.pi/agents/peers.yaml` decides *how* each peer runs.
451
+ A peer with `runner: claude-code` is an interactive Claude Code pane plus its
452
+ bridge — the one way Claude Code takes part in a fleet. See
453
+ [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
454
+
455
+ Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
456
+ is what gives a bridged pane exact turn text instead of scraped output.
457
+ The hook installs to `.pi/agent-fleet/hooks/coms-stop-hook.mjs` with the rest
458
+ of the fleet runtime. Registering it in `.claude/settings.json` stays the
459
+ user's step — the installer writes files, and another tool's settings file is
460
+ not its to merge. `setup` prints this snippet when the hook is applied:
461
+
462
+ ```json
463
+ { "hooks": { "Stop": [{ "hooks": [{ "type": "command",
464
+ "command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }] } }
465
+ ```
466
+
467
+ ## Templates
468
+
469
+ ### `.ai/agent-fleet-overrides.md`
470
+
471
+ Copy this in and delete the sections you don't need — anything absent falls
472
+ back to that reader's default.
473
+
474
+ ```markdown
475
+ # Agent Fleet — Project Overrides
476
+ #
477
+ # Each section is applied ON TOP of the skill's built-in defaults.
478
+ # Keys not listed keep the default. Absent file/section → pure defaults.
479
+
480
+ ## spec-driven-development
481
+ spec-dir: docs/prds/{area}
482
+ naming: PRD{n}-{topic}
483
+
484
+ ## planning-and-task-breakdown
485
+ plan-dir: docs/plans/{area}
486
+ naming: PLAN-{prd-name}-{phase}
487
+ todo: embedded
488
+
489
+ ## browser-testing-with-devtools
490
+ dev-server: <command to start the local dev server>
491
+ ready-check: <url or check that confirms the server is up>
492
+ base-url: <root url>
493
+ auth-flow: |
494
+ 1. Navigate to <login url>
495
+ 2. Submit credentials for the role needed by the screen under test
496
+ roles:
497
+ admin: env APP_TEST_ADMIN_USER / APP_TEST_ADMIN_PASS
498
+ player: env APP_TEST_PLAYER_USER / APP_TEST_PLAYER_PASS
499
+ notes: |
500
+ <anything else: self-signed certs, required seed data, ...>
501
+
502
+ ## git-workflow-and-versioning
503
+ branching: never
504
+
505
+ # Optional for pi agent-hub; omit this section to keep default English.
506
+ # (`## agent-team` is still accepted as a legacy alias for this section.)
507
+ ## agent-hub
508
+ language: <language name>
509
+ rules: <repo-relative rule folder>[, <another folder>]
510
+ docs: <repo-relative doc entry point>[, <another file or folder>]
511
+
512
+ # Optional; names (never values) of env vars the sections above reference.
513
+ # Only `agent-fleet doctor` reads this — it warns when one is unset.
514
+ ## env
515
+ required: <ENV_VAR_NAME>[, <ANOTHER_NAME>]
516
+ ```
517
+
518
+ ### `.ai/agent-fleet-setup.md`
519
+
520
+ Rendered from `.ai/agent-fleet-state.json` by every apply, for humans to read.
521
+ Edit the workspace, not this file — the next apply overwrites it.
522
+
523
+ ```markdown
524
+ # Agent Fleet — Workspace Setup
525
+ #
526
+ # Generated from .ai/agent-fleet-state.json by `agent-fleet setup`.
527
+ # Edit the workspace, not this file: it is rewritten on every apply.
528
+
529
+ ## workspace-summary
530
+ agent: pi
531
+ method: copy
532
+ version: 1.4.2
533
+ source: /home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet
534
+
535
+ ## install-status
536
+ skills: [spec-driven-development, test-driven-development, code-review-and-quality]
537
+ commands: [spec, plan, build]
538
+ personas: [code-reviewer]
539
+ extensions: []
540
+ harnesses: []
541
+ companions: [skills-internal-grilling]
542
+ external: []
543
+ updated: 2026-05-22
544
+
545
+ ## verification
546
+ - 21 item(s) recorded; run `agent-fleet doctor` for diagnostics.
547
+ - No secrets are stored in this file or in .ai/agent-fleet-state.json.
548
+ ```
549
+
550
+ ### `.ai/stt.json`
551
+
552
+ Optional. Present only when the `pi-voice-stt` extension is installed and configured. Read by
553
+ the extension on every pi session start, ahead of the global `~/.pi/agent/stt.json`. The
554
+ canonical format has a nested `provider` object. Runtime `provider.type` values are `openai`,
555
+ `openai-compatible`, `azure` (Azure Speech), and `azure-openai` (Azure OpenAI Whisper):
556
+
557
+ ```json
558
+ {
559
+ "language": "bg-BG",
560
+ "provider": {
561
+ "type": "azure",
562
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
563
+ "locales": ["bg-BG", "en-US"]
564
+ }
565
+ }
566
+ ```
567
+
568
+ The setup CLI accepts the aliases `openai`, `groq`, `azure`, and `azure-openai`. These are
569
+ installer selections, not interchangeable runtime types: in particular, `groq` is not a
570
+ `provider.type`, and `azure` means Azure Speech rather than Azure OpenAI. Setup can generate
571
+ the OpenAI configuration from runtime defaults. For Groq, create a complete nested
572
+ `.ai/stt.json` with runtime type `openai-compatible` and the actual Groq endpoint/model, then
573
+ run setup without `--stt-provider groq`; the alias does not identify the prepared runtime type.
574
+ Other OpenAI-compatible services are not Groq and use their own endpoint/model. For Azure
575
+ Speech or Azure OpenAI in a workspace without STT settings, create complete nested JSON with
576
+ the provider-specific endpoint/deployment settings before setup. Setup does not guess them.
577
+
578
+ Existing valid nested files are preserved. Supported legacy flat files are also preserved and
579
+ produce a warning that runtime compatibility is not guaranteed; setup does not migrate them
580
+ automatically. Provider migration or replacement requires a separate explicit action.
581
+
582
+ The JSON stores only environment-variable names, never credential values. Put values in the
583
+ gitignored `.env` at the workspace root, which the managed justfile loads:
584
+
585
+ ```sh
586
+ export AZURE_SPEECH_ENDPOINT=https://<resource>.cognitiveservices.azure.com
587
+ export AZURE_SPEECH_KEY=<your-resource-key>
588
+ ```
589
+
590
+ Setup preserves existing `.env` declarations and values, including `export NAME=...` syntax,
591
+ and appends only missing empty placeholders. A direct `provider.endpoint` needs no endpoint
592
+ environment variable. Setup validates JSON structure and environment-variable names, but it
593
+ does not validate credentials or contact the provider. Full schema and provider examples:
594
+ [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
595
+
596
+ ### Complete model profiles
597
+
598
+ `/af-models <name>` reads `.pi/agents/model-profiles.yaml`. Flat persona-to-model
599
+ maps remain supported and keep their declared-candidate validation. A `version: 2`
600
+ profile declares the whole execution model set independently of
601
+ `.ai/agent-fleet-overrides.md`:
602
+
603
+ ```yaml
604
+ local-duo:
605
+ version: 2
606
+ defaults:
607
+ model: &qwen36 omlx/Qwen3.6-35B-A3B-4bit
608
+ thinking: off
609
+ allowed-models:
610
+ - *qwen36
611
+ - &qwen omlx/Qwen3.8-9B-heretic-uncensored-5bit-MLX
612
+ fallback: none
613
+ routing: native
614
+ dispatcher: *qwen36
615
+ agents:
616
+ documenter: *qwen
617
+ # all other shipped personas inherit *qwen36 (see .pi/agents/model-profiles.yaml)
618
+ subagents:
619
+ code-reviewer:
620
+ docs: *qwen
621
+ plan-reviewer:
622
+ deps: *qwen
623
+ planner:
624
+ voice-2: *qwen
625
+ test-engineer:
626
+ conventions: *qwen
627
+ # recon, preflight, feasibility, scout, rules, sweeps, coverage stay on *qwen36
628
+ services:
629
+ watchdog: *qwen36
630
+ return-extractor: *qwen
631
+ panel:
632
+ - { name: qwen36, model: *qwen36, integrator: true }
633
+ - { name: qwen, model: *qwen }
634
+ ```
635
+
636
+ - `defaults` supplies **every persona and every declared child**, including future
637
+ personas, research helpers and team changes. `agents` and `subagents` contain
638
+ exceptions. Each selection accepts a model string or `{model, thinking}`.
639
+ Unspecified thinking inherits defaults, then `off`. Tool caps and delegation
640
+ depth remain unchanged. Unknown persona/child names are rejected.
641
+ - `dispatcher` changes the current Pi session's model and thinking. It defaults
642
+ to `defaults`; an `orchestrator` persona entry alone is not the live dispatcher.
643
+ - `services` sets the watchdog and structured-return extractor independently;
644
+ unspecified services use defaults. `panel` supplies 2–5 poll/debate voices and
645
+ an optional single integrator. `/af-poll` and `/af-debate` select the active
646
+ profile's panel automatically. Explicit other panel names are refused while
647
+ the complete profile is active. Without `panel`, two default-model voices are used.
648
+ - `routing: native` (default) keeps Hub-owned work on native Pi subprocesses.
649
+ Without `allowed-models` it still refuses explicit coms dispatch, handoff,
650
+ `coms_send` and peer spawning. With `allowed-models`, those peer actions are
651
+ allowed only when the peer's advertised or planned model is on the list
652
+ (exact `provider/model`, or a unique provider-less suffix match); a foreign,
653
+ missing, or `unknown` model is refused, and `claude-code` peers are refused
654
+ because their models cannot be allowlisted. Existing peer processes are not
655
+ reconfigured or stopped. `routing: configured` opts into the existing dispatch
656
+ policy and cannot be combined with `allowed-models`, since a peer's nested
657
+ children cannot be verified by this hub.
658
+ - `fallback: none` (default) disables automatic original-model fallback, including
659
+ nested children and workflows. `declared` retains it. Optional `allowed-models`
660
+ is an exact provider/model allowlist checked before actual child spawns and
661
+ fallback attempts. Manual model pickers and session substitutions respect it.
662
+ This governs Fleet model execution; it is not an OS/network sandbox for arbitrary
663
+ shell commands or unrelated applications.
664
+
665
+ Activation validates the complete profile and Pi availability of its referenced
666
+ models before changing settings. Missing models leave the previous configuration
667
+ in place. Busy dispatchers, agents and poll/debate runs refuse switching: wait for
668
+ completion first. On leaving a complete profile, the previous dispatcher, thinking
669
+ and manual model/sub-role/substitution settings are restored before applying the
670
+ next profile. A fresh Pi session clears the active profile; select it again there.
671
+
672
+ The profile is passed through the owned process tree. Workflow commands started
673
+ from that session inherit its persona models, thinking, panel and fallback policy.
674
+ Separately started fleet sessions/standing peers retain their own configuration.
675
+ The bundled `local-duo` profile explicitly covers all shipped child roles and needs
676
+ no project model overrides. The 35B Qwen is the default (dispatcher, specialists,
677
+ recon/sweeps, watchdog). The 9B Qwen is reserved for narrow helpers: `documenter`,
678
+ `code-reviewer.docs`, `plan-reviewer.deps`, `test-engineer.conventions`,
679
+ `planner.voice-2`, and `return-extractor`. Both exact model IDs must be registered
680
+ in Pi and served locally by oMLX. Selecting a profile does not download or register
681
+ models. The `omlx` provider has a default concurrency limit of two per Pi process;
682
+ `AGENT_HUB_PROVIDER_LIMITS` can override it if both weights should run in parallel.