@chankov/agent-fleet 0.0.10 → 1.0.0

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 (690) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +29 -27
  3. package/.pi/extensions/btw/index.ts +80 -83
  4. package/.pi/extensions/pi-voice-stt/README.md +7 -3
  5. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  6. package/.pi/harnesses/agent-hub/README.md +109 -54
  7. package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
  8. package/.pi/harnesses/agent-hub/footer.ts +4 -0
  9. package/.pi/harnesses/agent-hub/helpers.ts +18 -0
  10. package/.pi/harnesses/agent-hub/index.ts +537 -369
  11. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  14. package/.pi/harnesses/agent-hub/posture.ts +103 -0
  15. package/.pi/harnesses/ask-user-remote/README.md +37 -3
  16. package/.pi/harnesses/ask-user-remote/index.ts +173 -17
  17. package/.pi/harnesses/coms/package.json +1 -1
  18. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  19. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  20. package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  22. package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  23. package/.pi/harnesses/lib/fleet-panel.ts +34 -0
  24. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  25. package/.pi/harnesses/lib/fleet-selection.ts +24 -0
  26. package/.pi/harnesses/package-lock.json +2011 -0
  27. package/.pi/harnesses/package.json +1 -0
  28. package/.versions/0.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  29. package/.versions/0.0.11/.pi/agents/model-profiles.yaml +27 -0
  30. package/.versions/0.0.11/.pi/agents/peers.yaml +142 -0
  31. package/.versions/0.0.11/.pi/agents/teams.yaml +41 -0
  32. package/.versions/0.0.11/.pi/damage-control-rules.yaml +297 -0
  33. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  34. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  35. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  36. package/.versions/0.0.11/.pi/extensions/btw/README.md +119 -0
  37. package/.versions/0.0.11/.pi/extensions/btw/index.ts +917 -0
  38. package/.versions/0.0.11/.pi/extensions/btw/package.json +6 -0
  39. package/.versions/0.0.11/.pi/extensions/btw/state.js +179 -0
  40. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  41. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  42. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  43. package/.versions/0.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  44. package/.versions/0.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  45. package/.versions/0.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  46. package/.versions/0.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  47. package/.versions/0.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  48. package/.versions/0.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  49. package/.versions/0.0.11/.pi/extensions/package-lock.json +1143 -0
  50. package/.versions/0.0.11/.pi/extensions/package.json +9 -0
  51. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +205 -0
  52. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  53. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  54. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  55. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  56. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  57. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  58. package/.versions/0.0.11/.pi/harnesses/agent-hub/README.md +1004 -0
  59. package/.versions/0.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  60. package/.versions/0.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  61. package/.versions/0.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  62. package/.versions/0.0.11/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  63. package/.versions/0.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  64. package/.versions/0.0.11/.pi/harnesses/agent-hub/delegate.ts +435 -0
  65. package/.versions/0.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  66. package/.versions/0.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  67. package/.versions/0.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  68. package/.versions/0.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  69. package/.versions/0.0.11/.pi/harnesses/agent-hub/footer.ts +31 -0
  70. package/.versions/0.0.11/.pi/harnesses/agent-hub/helpers.ts +248 -0
  71. package/.versions/0.0.11/.pi/harnesses/agent-hub/index.ts +9111 -0
  72. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  73. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  74. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  75. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  76. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  77. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  78. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  79. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  80. package/.versions/0.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  81. package/.versions/0.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  82. package/.versions/0.0.11/.pi/harnesses/agent-hub/research-retention.js +34 -0
  83. package/.versions/0.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  84. package/.versions/0.0.11/.pi/harnesses/agent-hub/return-contract.js +293 -0
  85. package/.versions/0.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  86. package/.versions/0.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  87. package/.versions/0.0.11/.pi/harnesses/agent-hub/run-budget.js +479 -0
  88. package/.versions/0.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  89. package/.versions/0.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  90. package/.versions/0.0.11/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  91. package/.versions/0.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  92. package/.versions/0.0.11/.pi/harnesses/agent-hub/spawn.ts +354 -0
  93. package/.versions/0.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  94. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +53 -0
  95. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +477 -0
  96. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  97. package/.versions/0.0.11/.pi/harnesses/coms/README.md +100 -0
  98. package/.versions/0.0.11/.pi/harnesses/coms/index.ts +1767 -0
  99. package/.versions/0.0.11/.pi/harnesses/coms/package.json +7 -0
  100. package/.versions/0.0.11/.pi/harnesses/coms/version.ts +42 -0
  101. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/README.md +124 -0
  102. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/index.ts +536 -0
  103. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  104. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  105. package/.versions/0.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  106. package/.versions/0.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  107. package/.versions/0.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  108. package/.versions/0.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  109. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  110. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  111. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  112. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  113. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  114. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  115. package/.versions/0.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  116. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2046 -0
  117. package/.versions/0.0.11/.pi/harnesses/package.json +10 -0
  118. package/.versions/0.0.11/.pi/prompts/af-build.md +24 -0
  119. package/{.claude/commands/code-simplify.md → .versions/0.0.11/.pi/prompts/af-code-simplify.md} +3 -3
  120. package/{.claude/commands/plan.md → .versions/0.0.11/.pi/prompts/af-plan.md} +1 -1
  121. package/{.claude/commands/review.md → .versions/0.0.11/.pi/prompts/af-review.md} +3 -3
  122. package/.versions/0.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  123. package/.versions/0.0.11/.pi/prompts/af-ship.md +17 -0
  124. package/{.claude/commands/spec.md → .versions/0.0.11/.pi/prompts/af-spec.md} +1 -1
  125. package/{.claude/commands/test.md → .versions/0.0.11/.pi/prompts/af-test.md} +2 -2
  126. package/.versions/0.0.11/.pi/skills/bowser/SKILL.md +145 -0
  127. package/.versions/0.0.11/.version +1 -0
  128. package/.versions/0.0.11/agents/architect.md +24 -0
  129. package/.versions/0.0.11/agents/bowser.md +27 -0
  130. package/.versions/0.0.11/agents/builder.md +54 -0
  131. package/.versions/0.0.11/agents/code-reviewer.md +208 -0
  132. package/.versions/0.0.11/agents/deep-researcher.md +32 -0
  133. package/.versions/0.0.11/agents/documenter.md +18 -0
  134. package/.versions/0.0.11/agents/orchestrator.md +72 -0
  135. package/.versions/0.0.11/agents/plan-reviewer.md +83 -0
  136. package/.versions/0.0.11/agents/planner.md +70 -0
  137. package/.versions/0.0.11/agents/releaser.md +24 -0
  138. package/.versions/0.0.11/agents/researcher.md +28 -0
  139. package/.versions/0.0.11/agents/security-auditor.md +167 -0
  140. package/.versions/0.0.11/agents/test-engineer.md +153 -0
  141. package/.versions/0.0.11/agents/web-debugger.md +43 -0
  142. package/.versions/0.0.11/agents/web-performance-auditor.md +193 -0
  143. package/.versions/0.0.11/codex/CONDUCTOR.md +148 -0
  144. package/.versions/0.0.11/docs/ARCHITECTURE.md +301 -0
  145. package/.versions/0.0.11/docs/agent-fleet-setup.md +351 -0
  146. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +127 -0
  147. package/.versions/0.0.11/docs/codex-remote-conductor.md +170 -0
  148. package/.versions/0.0.11/docs/coms-hermes-bridge.md +189 -0
  149. package/.versions/0.0.11/docs/getting-started.md +43 -0
  150. package/.versions/0.0.11/docs/npm-install.md +96 -0
  151. package/.versions/0.0.11/docs/pi-extensions.md +368 -0
  152. package/.versions/0.0.11/docs/pi-setup.md +57 -0
  153. package/.versions/0.0.11/docs/skill-anatomy.md +150 -0
  154. package/.versions/0.0.11/hermes/README.md +347 -0
  155. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  156. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  157. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  158. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  159. package/.versions/0.0.11/hermes/gates/gate-o-capability.md +8 -0
  160. package/.versions/0.0.11/hermes/gates/gate-o-validator-fixtures.json +1 -0
  161. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  162. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  163. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  164. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  165. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  166. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  167. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  168. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  169. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  170. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  171. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  172. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  173. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  174. package/.versions/0.0.11/hermes/skills/hub-conductor/SKILL.md +84 -0
  175. package/.versions/0.0.11/hermes/skills/hub-liaison/SKILL.md +84 -0
  176. package/.versions/0.0.11/hermes/skills/hub-watchdog/SKILL.md +76 -0
  177. package/.versions/0.0.11/hermes/skills/hub-watchdog/manifest.json +1 -0
  178. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  179. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  180. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  181. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  182. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  183. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  184. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  185. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  186. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  187. package/.versions/0.0.11/hermes/watchdog-tests/__init__.py +0 -0
  188. package/.versions/0.0.11/hooks/coms-stop-hook.mjs +84 -0
  189. package/.versions/0.0.11/install-manifest.json +2743 -0
  190. package/.versions/0.0.11/justfile +261 -0
  191. package/.versions/0.0.11/manifest-meta.json +881 -0
  192. package/.versions/0.0.11/references/accessibility-checklist.md +160 -0
  193. package/.versions/0.0.11/references/definition-of-done.md +67 -0
  194. package/.versions/0.0.11/references/fleet-coordination-patterns.md +151 -0
  195. package/.versions/0.0.11/references/observability-checklist.md +91 -0
  196. package/.versions/0.0.11/references/orchestration-patterns.md +370 -0
  197. package/.versions/0.0.11/references/performance-checklist.md +153 -0
  198. package/.versions/0.0.11/references/prompting-patterns.md +380 -0
  199. package/.versions/0.0.11/references/security-checklist.md +179 -0
  200. package/.versions/0.0.11/references/testing-patterns.md +236 -0
  201. package/.versions/0.0.11/scripts/codex-conductor.ts +41 -0
  202. package/.versions/0.0.11/scripts/codex-remote-control.ts +167 -0
  203. package/.versions/0.0.11/scripts/coms-claude-bridge.ts +401 -0
  204. package/.versions/0.0.11/scripts/coms-cli.ts +484 -0
  205. package/.versions/0.0.11/scripts/coms-hermes-bridge.ts +413 -0
  206. package/.versions/0.0.11/scripts/fleet.ts +168 -0
  207. package/.versions/0.0.11/scripts/hermes-monitor-capability-runner.ts +25 -0
  208. package/.versions/0.0.11/scripts/hermes-monitor-scenario.ts +474 -0
  209. package/.versions/0.0.11/scripts/hermes-watchdog-capability-probe.ts +45 -0
  210. package/.versions/0.0.11/scripts/install-hermes-plugin.sh +180 -0
  211. package/.versions/0.0.11/scripts/lib/claude-bridge-core.ts +165 -0
  212. package/.versions/0.0.11/scripts/lib/codex-conductor.ts +88 -0
  213. package/.versions/0.0.11/scripts/lib/codex-remote-control.ts +480 -0
  214. package/.versions/0.0.11/scripts/lib/coms-envelope.ts +582 -0
  215. package/.versions/0.0.11/scripts/lib/fake-herdr-server.ts +88 -0
  216. package/.versions/0.0.11/scripts/lib/fleet-command.ts +119 -0
  217. package/.versions/0.0.11/scripts/lib/herdr-layout.ts +281 -0
  218. package/.versions/0.0.11/scripts/lib/hermes-bridge-core.ts +241 -0
  219. package/.versions/0.0.11/scripts/lib/hermes-monitor-events.ts +1 -0
  220. package/.versions/0.0.11/scripts/lib/hermes-monitor-herdr.ts +2 -0
  221. package/.versions/0.0.11/scripts/lib/hermes-monitor-model.ts +3 -0
  222. package/.versions/0.0.11/scripts/lib/hermes-monitor-registry.ts +2 -0
  223. package/.versions/0.0.11/scripts/lib/hermes-monitor-socket.ts +2 -0
  224. package/.versions/0.0.11/scripts/lib/hermes-monitor-store.ts +2 -0
  225. package/.versions/0.0.11/scripts/lib/monitor-env.ts +146 -0
  226. package/.versions/0.0.11/scripts/lib/peer-launch.ts +314 -0
  227. package/.versions/0.0.11/scripts/lib/persona-banner.ts +62 -0
  228. package/.versions/0.0.11/scripts/lib/spawn-stagger.ts +101 -0
  229. package/.versions/0.0.11/scripts/lib/team-project.ts +193 -0
  230. package/.versions/0.0.11/scripts/lib/team-snapshot.ts +147 -0
  231. package/.versions/0.0.11/scripts/peer-banner.ts +40 -0
  232. package/.versions/0.0.11/scripts/peer-launch.ts +259 -0
  233. package/.versions/0.0.11/scripts/team-snapshot.ts +237 -0
  234. package/.versions/0.0.11/scripts/team-up.ts +360 -0
  235. package/.versions/0.0.11/skills/_internal/grilling.md +11 -0
  236. package/.versions/0.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  237. package/.versions/0.0.11/skills/code-review-and-quality/SKILL.md +381 -0
  238. package/.versions/0.0.11/skills/compound-learning/SKILL.md +137 -0
  239. package/.versions/0.0.11/skills/context-engineering/SKILL.md +291 -0
  240. package/.versions/0.0.11/skills/deprecation-and-migration/SKILL.md +206 -0
  241. package/.versions/0.0.11/skills/designing-agents/SKILL.md +394 -0
  242. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  243. package/.versions/0.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  244. package/.versions/0.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  245. package/.versions/0.0.11/skills/idea-refine/SKILL.md +182 -0
  246. package/.versions/0.0.11/skills/idea-refine/examples.md +238 -0
  247. package/.versions/0.0.11/skills/idea-refine/frameworks.md +99 -0
  248. package/.versions/0.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  249. package/.versions/0.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  250. package/.versions/0.0.11/skills/incremental-implementation/SKILL.md +287 -0
  251. package/.versions/0.0.11/skills/interview-me/SKILL.md +226 -0
  252. package/.versions/0.0.11/skills/orchestration-verification/SKILL.md +181 -0
  253. package/.versions/0.0.11/skills/peer-coms/SKILL.md +90 -0
  254. package/.versions/0.0.11/skills/performance-optimization/SKILL.md +350 -0
  255. package/.versions/0.0.11/skills/planning-and-task-breakdown/SKILL.md +254 -0
  256. package/.versions/0.0.11/skills/security-and-hardening/SKILL.md +461 -0
  257. package/.versions/0.0.11/skills/spec-driven-development/SKILL.md +257 -0
  258. package/.versions/0.0.11/skills/using-agent-skills/SKILL.md +199 -0
  259. package/.versions/0.0.11/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  260. package/.versions/0.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  261. package/.versions/0.0.11/vendor/agent-skills-upstream/README.md +11 -0
  262. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  263. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  264. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  265. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  266. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  267. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  268. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  269. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  270. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  271. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  272. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  273. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  274. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  275. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  276. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  277. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  278. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  279. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  280. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  281. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  282. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  283. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  284. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  285. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  286. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  287. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  288. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  289. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  290. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  291. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  292. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  293. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  294. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  295. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  296. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  297. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  298. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  299. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  300. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  301. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  302. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  303. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  304. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  305. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  306. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  307. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  308. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  309. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  310. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  311. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  312. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  313. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  314. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  315. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  316. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  317. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  318. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  319. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  320. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  321. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  322. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  323. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  324. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  325. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  326. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  327. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  328. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  329. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  330. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  331. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  332. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  333. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  334. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  335. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  336. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  337. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  338. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  339. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  340. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  341. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  342. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  343. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  344. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  345. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  346. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  347. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  348. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  349. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  350. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  351. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  352. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  353. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  354. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  355. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  356. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  357. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  358. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  359. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  360. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  361. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  362. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  363. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  364. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  365. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  366. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  367. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  368. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  369. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  370. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  371. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  372. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  373. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  374. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  375. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  376. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  377. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  378. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  379. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  380. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  381. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  382. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  383. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  384. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  385. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  386. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  387. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  388. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  389. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  390. package/.versions/1.0.0/.pi/prompts/af-code-simplify.md +22 -0
  391. package/.versions/1.0.0/.pi/prompts/af-plan.md +16 -0
  392. package/.versions/1.0.0/.pi/prompts/af-review.md +16 -0
  393. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  394. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  395. package/.versions/1.0.0/.pi/prompts/af-spec.md +15 -0
  396. package/.versions/1.0.0/.pi/prompts/af-test.md +19 -0
  397. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  398. package/.versions/1.0.0/.version +1 -0
  399. package/.versions/1.0.0/agents/architect.md +24 -0
  400. package/.versions/1.0.0/agents/bowser.md +27 -0
  401. package/.versions/1.0.0/agents/builder.md +54 -0
  402. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  403. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  404. package/.versions/1.0.0/agents/documenter.md +18 -0
  405. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  406. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  407. package/.versions/1.0.0/agents/planner.md +70 -0
  408. package/.versions/1.0.0/agents/releaser.md +24 -0
  409. package/.versions/1.0.0/agents/researcher.md +28 -0
  410. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  411. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  412. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  413. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  414. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  415. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  416. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  417. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  418. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  419. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  420. package/.versions/1.0.0/docs/getting-started.md +98 -0
  421. package/.versions/1.0.0/docs/npm-install.md +292 -0
  422. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  423. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  424. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  425. package/.versions/1.0.0/hermes/README.md +347 -0
  426. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  427. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  428. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  429. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  430. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  431. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  432. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  433. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  434. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  435. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  436. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  437. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  438. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  439. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  440. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  441. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  442. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  443. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  444. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  445. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  446. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  447. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  448. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  449. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  450. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  451. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  452. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  453. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  454. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  455. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  456. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  457. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  458. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  459. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  460. package/.versions/1.0.0/install-manifest.json +2745 -0
  461. package/.versions/1.0.0/justfile +272 -0
  462. package/.versions/1.0.0/manifest-meta.json +882 -0
  463. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  464. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  465. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  466. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  467. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  468. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  469. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  470. package/.versions/1.0.0/references/security-checklist.md +179 -0
  471. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  472. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  473. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  474. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  475. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  476. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  477. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  478. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  479. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  480. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  481. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  482. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  483. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  484. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  485. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  486. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  487. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  488. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  489. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  490. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  491. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  492. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  493. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  494. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  495. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  496. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  497. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  498. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  499. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  500. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  501. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  502. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  503. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  504. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  505. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  506. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  507. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  508. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  509. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  510. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  511. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  512. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  513. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  514. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  515. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  516. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  517. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  518. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  519. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  520. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  521. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  522. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  523. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  524. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  525. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  526. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  527. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  528. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  529. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  530. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  531. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  532. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  533. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  534. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  535. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  536. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  537. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  538. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  539. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  540. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  541. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  542. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  543. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  544. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  545. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  546. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  547. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  548. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  549. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  550. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  551. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  552. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  553. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  554. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  555. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  556. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  557. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  558. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  559. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  560. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  561. package/CHANGELOG.md +149 -0
  562. package/README.md +117 -79
  563. package/agents/orchestrator.md +1 -1
  564. package/{.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +2 -0
  565. package/bin/cli.js +289 -359
  566. package/bin/force-patch-changesets.js +18 -2
  567. package/bin/lib/apply.js +86 -32
  568. package/bin/lib/desired.js +87 -0
  569. package/bin/lib/detect-agent.js +22 -38
  570. package/bin/lib/doctor.js +283 -33
  571. package/bin/lib/features.js +78 -0
  572. package/bin/lib/manifest.js +127 -48
  573. package/bin/lib/overrides.js +35 -0
  574. package/bin/lib/personas.js +37 -0
  575. package/bin/lib/plan.js +18 -9
  576. package/bin/lib/purge.js +11 -0
  577. package/bin/lib/reconcile.js +68 -0
  578. package/bin/lib/scan.js +24 -0
  579. package/bin/lib/state.js +25 -1
  580. package/bin/lib/stt-wizard.js +33 -0
  581. package/bin/lib/transaction.js +149 -0
  582. package/bin/lib/tui.js +71 -0
  583. package/bin/lib/verify.js +9 -26
  584. package/bin/snapshot-version.js +3 -6
  585. package/docs/ARCHITECTURE.md +55 -21
  586. package/docs/MIGRATION-agent-fleet.md +222 -0
  587. package/docs/agent-fleet-setup.md +124 -64
  588. package/docs/claude-code-coms-bridge.md +21 -2
  589. package/docs/coms-hermes-bridge.md +1 -1
  590. package/docs/getting-started.md +61 -217
  591. package/docs/npm-install.md +207 -429
  592. package/docs/pi-extensions.md +90 -41
  593. package/docs/pi-setup.md +48 -545
  594. package/hermes/README.md +1 -1
  595. package/install-manifest.json +385 -1255
  596. package/justfile +45 -27
  597. package/manifest-meta.json +544 -134
  598. package/node_modules/pi-ask-user/README.md +43 -5
  599. package/node_modules/pi-ask-user/index.ts +630 -75
  600. package/node_modules/pi-ask-user/package.json +1 -1
  601. package/package.json +5 -11
  602. package/scripts/coms-claude-bridge.ts +10 -0
  603. package/scripts/fleet.ts +107 -90
  604. package/scripts/lib/claude-bridge-core.ts +45 -0
  605. package/scripts/lib/fleet-command.ts +170 -15
  606. package/scripts/lib/monitor-env.ts +27 -1
  607. package/scripts/lib/peer-launch.ts +6 -2
  608. package/scripts/lib/team-project.ts +24 -4
  609. package/scripts/team-up.ts +57 -11
  610. package/skills/designing-agents/SKILL.md +1 -1
  611. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  612. package/.claude/commands/build.md +0 -44
  613. package/.claude/commands/design-agent.md +0 -14
  614. package/.claude/commands/doctor-agent-fleet.md +0 -22
  615. package/.claude/commands/orchestrate.md +0 -112
  616. package/.claude/commands/prime.md +0 -22
  617. package/.claude/commands/set-hermes-watchdog.md +0 -6
  618. package/.claude/commands/setup-agent-fleet.md +0 -17
  619. package/.claude/commands/ship.md +0 -72
  620. package/.claude/commands/webperf.md +0 -32
  621. package/.claude/orchestrate-teams.yaml +0 -24
  622. package/.opencode/commands/af-build.md +0 -17
  623. package/.opencode/commands/af-code-simplify.md +0 -16
  624. package/.opencode/commands/af-compound.md +0 -16
  625. package/.opencode/commands/af-design-agent.md +0 -15
  626. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  627. package/.opencode/commands/af-orchestrate.md +0 -112
  628. package/.opencode/commands/af-plan.md +0 -16
  629. package/.opencode/commands/af-prime.md +0 -22
  630. package/.opencode/commands/af-review.md +0 -15
  631. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  632. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  633. package/.opencode/commands/af-ship.md +0 -16
  634. package/.opencode/commands/af-spec.md +0 -16
  635. package/.opencode/commands/af-test.md +0 -21
  636. package/.opencode/commands/af-webperf.md +0 -32
  637. package/.opencode/orchestrate-teams.yaml +0 -24
  638. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  639. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  640. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  641. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  642. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  643. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  644. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  645. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  646. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  647. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  648. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  649. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  650. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  651. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  652. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  653. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  654. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  655. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  656. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  657. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  658. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  659. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  660. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  661. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  662. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  663. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  664. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  665. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  666. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  667. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  668. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  669. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  670. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  671. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  672. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  673. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  674. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  675. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  676. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  677. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  678. package/bin/lib/bootstrap.js +0 -323
  679. package/bin/lib/transform-persona.js +0 -180
  680. package/docs/opencode-setup.md +0 -281
  681. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  682. package/hooks/hooks.json +0 -14
  683. package/hooks/session-start.sh +0 -74
  684. package/hooks/simplify-ignore.sh +0 -302
  685. package/skills/guided-workspace-setup/SKILL.md +0 -226
  686. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  687. /package/{.opencode/commands → .versions/0.0.11/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  688. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 0.0.11/bin/catalog/harness-runtime-closure.json} +0 -0
  689. /package/{.claude/commands/set-hermes-telegram.md → .versions/1.0.0/.pi/prompts/af-set-hermes-telegram.md} +0 -0
  690. /package/{skills/guided-workspace-setup/companion-manifest.json → .versions/1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
@@ -6,7 +6,7 @@ A pi extension that surfaces an "update available" banner once per session when
6
6
 
7
7
  On the first `agent_start` event of a pi session, the extension:
8
8
 
9
- 1. Reads `version:` from `.ai/agent-fleet-setup.md` in the current working directory. If the record is missing (workspace was never set up via `/af-setup-agent-fleet`), the check is skipped.
9
+ 1. Reads `version:` from `.ai/agent-fleet-setup.md` in the current working directory. If the record is missing (the deterministic lifecycle has not yet run), the check is skipped.
10
10
  2. Reads the cached latest version from `$XDG_CACHE_HOME/agent-fleet/latest-version.json` (falling back to `~/.cache/agent-fleet/`).
11
11
  3. If the cache is older than 24 hours or absent, fetches the latest version from the npm registry with a 3-second timeout.
12
12
  4. If the published version is greater than the recorded version, emits an `info`-level notification via `ctx.ui.notify`.
@@ -16,7 +16,7 @@ The check runs **once per session** and is bounded to a single network call. It
16
16
  ## When the banner fires
17
17
 
18
18
  ```
19
- agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest update" then /af-setup-agent-fleet to apply.
19
+ agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest setup" to reconcile the workspace.
20
20
  ```
21
21
 
22
22
  The banner appears in pi's UI notification area — the same surface used by other extensions for non-fatal status. It does not block, prompt, or modify any file. The user decides when to act on it.
@@ -33,7 +33,7 @@ Every error path silently aborts. Update checks must never disrupt a session.
33
33
 
34
34
  ## Install
35
35
 
36
- Offered by `/af-setup-agent-fleet` with the other pi extensions, and included in the `pi-fleet-core` profile. Directly:
36
+ Included by the deterministic Default/Full lifecycle selections when requested by their features, and available directly:
37
37
 
38
38
  ```bash
39
39
  npx @chankov/agent-fleet install --agent pi --items pi-extension:agent-fleet-update-check --yes
@@ -53,5 +53,5 @@ The check honours three environment variables (any of them disables it):
53
53
 
54
54
  - The check runs once per pi session; restarting pi triggers a new check.
55
55
  - The cache file is shared with the CLI (`agent-fleet check-update`) so both update paths benefit from a single fetch per 24h window.
56
- - If the install record is *pre-versioning* (no `version:` line), the check is skipped — there's no recorded baseline to compare against. Run `/af-setup-agent-fleet` once to stamp the current version.
56
+ - If the install record is *pre-versioning* (no `version:` line), the check is skipped — there's no recorded baseline to compare against. Run `npx @chankov/agent-fleet setup` once to stamp the current version.
57
57
  - The extension only reads; it never writes the install record itself.
@@ -2,12 +2,12 @@
2
2
 
3
3
  A pi extension that adds a single prompt command, `/af-btw`, plus an `Alt+'`
4
4
  shortcut, for spinning off a **side task** that inherits the full context of the
5
- current session and streams into a live modal — modeled on Claude Code's `/btw`.
5
+ current session and streams into a live full-screen panel — modeled on Claude Code's `/btw`.
6
6
 
7
7
  ## What it does
8
8
 
9
9
  `/af-btw <task>` forks the current session into an **in-process sub-session** and
10
- opens a modal over it:
10
+ opens its full-screen panel:
11
11
 
12
12
  1. **Forks the session** — `SessionManager.forkFrom` writes the current
13
13
  append-only JSONL into `.pi/btw-sessions/<...>.jsonl`. The sub-session starts with
@@ -18,9 +18,9 @@ opens a modal over it:
18
18
  active tool selection or custom tools. It is *not* a child `pi` process — there is
19
19
  no spawn, no JSON-stream parsing, no SIGTERM. It works in the same cwd as the main
20
20
  session.
21
- 3. **Opens a live modal** — a top-center overlay shows the sub-session's transcript
22
- as it streams (assistant text, tool calls, thinking), with a footer composer for
23
- follow-ups. The modal is the primary surface.
21
+ 3. **Opens a live full-screen panel** — a focused, capturing overlay shows the
22
+ sub-session's transcript as it streams (assistant text, tool calls, thinking), with
23
+ a footer composer for follow-ups. The panel is the primary surface.
24
24
  4. **Drops a compact card at idle** — when a turn finishes, the full answer is
25
25
  written to `.pi/btw-sessions/<id>.result.md` and a **compact** card (✓/✗ + task +
26
26
  elapsed + the first few lines + the artifact path) is queued for the main
@@ -28,46 +28,48 @@ opens a modal over it:
28
28
 
29
29
  ## Command & shortcut
30
30
 
31
- - **`/af-btw <task>`** — start a side task and open its modal.
32
- - **`/af-btw`** (no args) — reopen the modal on the last-viewed (or most recent) thread.
33
- - **`Alt+'`** — reopen the modal. (Chosen because it doesn't collide with a pi
34
- composer motion the way `Alt+B` does — that's the editor's cursor-word-left. Pick
35
- another binding in `index.ts` if your terminal swallows `Alt+'`.)
31
+ - **`/af-btw <task>`** — start a side task and open its full-screen panel.
32
+ - **`/af-btw`** (no args) — reopen the panel on the last-viewed (or most recent) thread.
33
+ - **`Alt+'`** — reopen the panel. (Chosen because it doesn't collide with a pi
34
+ composer motion the way `Alt+B` does — that's the editor's cursor-word-left.) On
35
+ macOS, configure the terminal to send Option as Meta; in Zed set
36
+ `terminal.option_as_meta` to `true`.
36
37
 
37
38
  Once any `/af-btw` command or `Alt+'` has run in a session, the **agent-hub** harness
38
- footer surfaces an `Alt+' btw` hint next to its `Alt+A view:` hint (via a
39
+ footer surfaces an `Alt+' btw` hint next to its `Alt+A fleet` hint (via a
39
40
  `globalThis.__btwActivated` flag).
40
41
 
41
- ### Modal keys
42
+ ### Panel keys
42
43
 
43
44
  - **Type + Enter** — send a follow-up. Mid-run it *steers* the active turn; when the
44
45
  task is idle it starts a fresh turn.
45
- - **Esc** — hide the modal. The task keeps running; you are returned to the main
46
- session. Reopen with `Alt+'` or `/af-btw`.
46
+ - **Esc** — close the panel and return to the main session. The task keeps running;
47
+ reopen it with `Alt+'` or `/af-btw`.
47
48
  - **↑ / ↓** — scroll the transcript (the selected entry expands; tail-follows the
48
49
  newest until you scroll up).
49
50
  - **← / →** — switch between concurrent threads (when more than one is running).
50
51
  - **Ctrl+C** — copy the selected transcript entry.
51
52
 
52
53
  `/af-btw` and `Alt+'` are the entire surface — no model-callable tool, no subcommands.
53
- The agent cannot trigger it; only you can.
54
+ The agent cannot trigger it; only you can. The panel captures input while open; its
55
+ follow-up composer is focused immediately.
54
56
 
55
57
  ## Design constraints (intentional)
56
58
 
57
59
  - **In-process, not a child process.** The side task is a real `AgentSession` forked
58
- from the current one, running in the same process. This is what lets the modal show
59
- a live transcript and accept follow-ups while the main session is mid-turn — the
60
- old child-`pi` model could only report back as a card once it finished.
60
+ from the current one, running in the same process. This is what lets the full-screen
61
+ panel show a live transcript and accept follow-ups while the main session is mid-turn
62
+ — the old child-`pi` model could only report back as a card once it finished.
61
63
  - **No extension runtime in the sub-session.** `createAgentSession` is given a
62
64
  resource loader with `noExtensions: true`, so the fork never loads (or re-runs) this
63
65
  or any other extension. No recursion, no double-bound MCP servers — the same
64
66
  guarantee the old `--no-extensions` child gave.
65
67
  - **Available even while the main agent is streaming.** pi executes extension
66
68
  commands immediately in `prompt()`, *before* the streaming queue, so `/af-btw` never
67
- waits for the current turn to finish, and the modal opens right away.
68
- - **Never steals the main session's focus.** The modal is a non-capturing overlay
69
- that you focus on open and release on `Esc`. Task completion only fires a toast — it
70
- never grabs focus or interrupts the main turn.
69
+ waits for the current turn to finish, and the panel opens right away.
70
+ - **Focused only while open.** The full-screen panel captures input and focuses its
71
+ follow-up composer when opened; `Esc` returns focus to the main session. Task
72
+ completion only fires a toast — it never reopens the panel or interrupts the main turn.
71
73
  - **The chat card stays out of the main agent's LLM context.** An `on("context")`
72
74
  filter strips `btw-result` cards from every LLM call. The card stays visible to you;
73
75
  the main agent never ingests it. The whole extension is UI/process code — it adds
@@ -90,13 +92,13 @@ packages, so no additional `npm install` is needed.
90
92
  - **Artifacts** for each run live in `.pi/btw-sessions/` (gitignored): the forked
91
93
  `<...>.jsonl` is the sub-session's context; `<id>.result.md` is the latest final
92
94
  answer and includes the session file path. Files older than 7 days are pruned on
93
- `session_start`; terminal thread history in the modal is retained only for the 12
95
+ `session_start`; terminal thread history in the panel is retained only for the 12
94
96
  newest terminal threads.
95
97
  - **Model.** The sub-session runs with the main session's current model and inherits
96
98
  its thinking level from the forked history.
97
99
  - **Follow-ups.** Each idle follow-up is its own turn and produces its own card; a
98
100
  mid-run follow-up steers the active turn and folds into that turn's single card.
99
- - **Transcript bounds.** Modal history is capped at 200 entries and 12,000 characters
101
+ - **Transcript bounds.** Panel history is capped at 200 entries and 12,000 characters
100
102
  per entry; the expanded selected entry is capped at 20,000 characters with a visible
101
103
  truncation marker. The compact chat card remains a short preview, while
102
104
  `<id>.result.md` keeps the full final assistant output for the turn.
@@ -105,14 +107,14 @@ packages, so no additional `npm install` is needed.
105
107
  - **Shutdown.** Running threads are `abort()`ed when the main pi session shuts down —
106
108
  side tasks do not outlive their parent.
107
109
  - **Concurrency.** Multiple `/af-btw` runs can be in flight at once; the footer shows
108
- `btw: N running` and `← / →` switches the modal between them.
110
+ `btw: N running` and `← / →` switches the panel between them.
109
111
  - **Shared process group.** In-process bash from a side task competes with the main
110
112
  session for CPU — heavy side tasks will be felt by the main turn.
111
113
 
112
114
  ## Focused smoke checklist
113
115
 
114
- - Start `/af-btw <task>`, confirm the modal opens immediately and elapsed time counts the current turn.
116
+ - Start `/af-btw <task>`, confirm the full-screen panel opens immediately and elapsed time counts the current turn.
115
117
  - Send a mid-run follow-up, confirm it steers the same turn and produces only one card.
116
118
  - After completion, send an idle follow-up, confirm elapsed time resets and a new card is produced.
117
119
  - Complete more than 12 side-task threads, confirm only terminal history is evicted and running threads remain.
118
- - Open a long transcript entry, confirm modal truncation is marked and the `.result.md` file keeps the full final output.
120
+ - Open a long transcript entry, confirm panel truncation is marked and the `.result.md` file keeps the full final output.
@@ -1,23 +1,23 @@
1
1
  /**
2
- * btw — in-process side tasks for pi with a live modal, modeled on Claude Code's `/af-btw`.
2
+ * btw — in-process side tasks for pi with a live full-screen panel.
3
3
  *
4
4
  * `/af-btw <task>` forks the CURRENT session into an in-process sub-session
5
5
  * (`createAgentSession`) that inherits the full conversation as context, works the
6
- * side task in the same cwd, and streams into a modal overlay with its own
6
+ * side task in the same cwd, and streams into a full-screen panel with its own
7
7
  * transcript + follow-up composer. A compact result card lands in the main
8
8
  * transcript when the session next goes idle.
9
9
  *
10
10
  * Design constraints (all intentional — see .pi/extensions/btw/README.md):
11
11
  * - Command-only surface. No model-callable tool, no subcommands. `/af-btw <task>`
12
- * starts a task and opens the modal; `/af-btw` (no args) or `Alt+'` reopens it.
12
+ * starts a task and opens the panel; `/af-btw` (no args) or `Alt+'` reopens it.
13
13
  * - In-process sub-session, NOT a child `pi` process. The fork is a real
14
14
  * `AgentSession` with fixed built-in tools and NO extensions/custom tools (the
15
15
  * sub-session loads no extension runtime → no recursion, mirroring the old
16
16
  * `--no-extensions` child).
17
- * - The modal is the primary surface: it opens immediately, streams the
18
- * sub-session live, and accepts follow-ups (mid-run follow-ups steer the active
19
- * run; idle follow-ups start a fresh turn). `Esc` hides it (the task keeps
20
- * running); completion only toasts — it never steals focus.
17
+ * - The full-screen panel is the primary surface: it opens immediately, streams
18
+ * the sub-session live, and accepts follow-ups (mid-run follow-ups steer the
19
+ * active run; idle follow-ups start a fresh turn). `Esc` returns to the main
20
+ * session while the task keeps running; completion only toasts.
21
21
  * - Each completed turn writes `.pi/btw-sessions/<id>.result.md` and queues a
22
22
  * COMPACT card (✓/✗ + note + elapsed + first lines + artifact path) for the
23
23
  * main transcript, delivered only when idle and kept OUT of the main agent's
@@ -56,6 +56,8 @@ import {
56
56
  } from "@mariozechner/pi-tui";
57
57
  import { mkdirSync, writeFileSync, existsSync, readdirSync, statSync, rmSync } from "node:fs";
58
58
  import { join } from "node:path";
59
+ import { FULLSCREEN_OVERLAY, bodyRows, fitToHeight } from "../../harnesses/lib/fleet-overlay.ts";
60
+ import { createPanelResources } from "../../harnesses/lib/fleet-panel.ts";
59
61
  import {
60
62
  MAX_RETAINED_TERMINAL_THREADS,
61
63
  appendTimelineDelta as appendTimelineDeltaState,
@@ -82,11 +84,8 @@ const STATUS_KEY = "btw";
82
84
  const CLEANUP_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;
83
85
  // Coding tools the sub-session runs with (matches pi's default built-in set).
84
86
  const SUBSESSION_TOOLS = ["read", "bash", "edit", "write"];
85
- // Modal sizing.
86
- const MODAL_WIDTH = "78%";
87
- const MODAL_MAX_HEIGHT = "80%";
88
- // Transcript body height budget inside the modal (rows). Keeps the composer visible.
89
- const BODY_ROWS = 20;
87
+ // Header, border, composer border/label, composer, and hint are fixed chrome.
88
+ const BTW_CHROME_ROWS = 6;
90
89
  // One entry in a thread's live transcript. Consecutive text/thinking deltas are
91
90
  // coalesced into the trailing entry of the same kind; each tool call and each
92
91
  // operator follow-up is its own entry.
@@ -98,7 +97,7 @@ interface TimelineEntry {
98
97
  toolCallId?: string;
99
98
  }
100
99
 
101
- // A running (or finished) btw side task. Multiple may run concurrently; the modal
100
+ // A running (or finished) btw side task. Multiple may run concurrently; the panel
102
101
  // binds to one at a time (`render` is set only while it is the shown thread).
103
102
  interface BtwThread {
104
103
  id: string;
@@ -131,7 +130,7 @@ interface PendingResult {
131
130
  details: BtwDetails;
132
131
  }
133
132
 
134
- interface CurrentModalHandle {
133
+ interface CurrentPanelHandle {
135
134
  show: (id: string) => void;
136
135
  currentId: () => string | undefined;
137
136
  timelinePruned: (id: string, prunedCount: number) => void;
@@ -146,13 +145,13 @@ export default function btwExtension(pi: ExtensionAPI) {
146
145
  // Compact result cards waiting for the session to go idle before they are shown.
147
146
  const pending: PendingResult[] = [];
148
147
  // Most-recent context, refreshed on every hook so deferred delivery, status, and
149
- // the modal always have a live handle after the original command returned.
148
+ // the panel always have a live handle after the original command returned.
150
149
  let latestCtx: ExtensionContext | undefined;
151
- // Modal lifecycle: guard against double-open, remember last-viewed thread, and
152
- // expose a handle so a fresh /af-btw can retarget an already-open modal.
153
- let modalOpen = false;
150
+ // Panel lifecycle: guard against double-open, remember last-viewed thread, and
151
+ // expose a handle so a fresh /af-btw can retarget an already-open panel.
152
+ let panelOpen = false;
154
153
  let lastViewedId: string | undefined;
155
- let currentModal: CurrentModalHandle | undefined;
154
+ let currentPanel: CurrentPanelHandle | undefined;
156
155
  // Set on session_shutdown so abort()-driven prompt rejections don't push cards.
157
156
  let shuttingDown = false;
158
157
 
@@ -248,12 +247,12 @@ export default function btwExtension(pi: ExtensionAPI) {
248
247
  }
249
248
 
250
249
  function reconcileThreadPointers(): void {
251
- const currentId = currentModal?.currentId();
250
+ const currentId = currentPanel?.currentId();
252
251
  const view = reconcileThreadView({ order, lastViewedId, currentId });
253
252
  lastViewedId = view.lastViewedId;
254
- if (!currentModal) return;
255
- if (view.currentId && view.currentId !== currentId) currentModal.show(view.currentId);
256
- else currentModal.clamp();
253
+ if (!currentPanel) return;
254
+ if (view.currentId && view.currentId !== currentId) currentPanel.show(view.currentId);
255
+ else currentPanel.clamp();
257
256
  }
258
257
 
259
258
  function enforceTerminalRetention(): void {
@@ -281,7 +280,7 @@ export default function btwExtension(pi: ExtensionAPI) {
281
280
 
282
281
  function applyTimelineResult(t: BtwThread, result: { timeline: TimelineEntry[]; prunedCount: number }): void {
283
282
  t.timeline = result.timeline;
284
- if (result.prunedCount > 0) currentModal?.timelinePruned(t.id, result.prunedCount);
283
+ if (result.prunedCount > 0) currentPanel?.timelinePruned(t.id, result.prunedCount);
285
284
  }
286
285
 
287
286
  function addTimelineEntry(t: BtwThread, entry: Omit<TimelineEntry, "timestamp"> & { timestamp?: number }): void {
@@ -289,13 +288,13 @@ export default function btwExtension(pi: ExtensionAPI) {
289
288
  }
290
289
 
291
290
  // Framing for the side task. Unlike the old child-process version there IS now an
292
- // interactive surface (the modal composer), so the "unattended" instruction is
291
+ // interactive surface (the panel composer), so the "unattended" instruction is
293
292
  // gone; the scoping + summary instructions stay.
294
293
  function framedTask(note: string): string {
295
294
  return [
296
295
  "You have been resumed into a copy of another pi session — the conversation",
297
296
  "history above is your full context. You are working a side task while the main",
298
- "session continues. An operator is watching this side task in a modal and can send",
297
+ "session continues. An operator is watching this side task in a panel and can send",
299
298
  "you follow-up messages, so ask a brief clarifying question only if you are truly",
300
299
  "blocked. Your file changes land in the same working directory as the main session,",
301
300
  "so keep them scoped to exactly what the task asks.",
@@ -309,7 +308,7 @@ export default function btwExtension(pi: ExtensionAPI) {
309
308
 
310
309
  // Coalesce a streaming text/thinking delta: extend the trailing entry when it is
311
310
  // the same kind, otherwise start a new one. The state helper caps entry content
312
- // and prunes old transcript entries before the modal sees the update.
311
+ // and prunes old transcript entries before the panel sees the update.
313
312
  function appendDelta(t: BtwThread, kind: "text" | "thinking", delta: string): void {
314
313
  applyTimelineResult(t, appendTimelineDeltaState(t.timeline, kind, delta, Date.now()));
315
314
  }
@@ -508,19 +507,20 @@ export default function btwExtension(pi: ExtensionAPI) {
508
507
  updateStatus(ctx);
509
508
  ctx.ui.notify(`btw started: ${note}`, "info");
510
509
 
511
- // Open the modal immediately on this thread, or retarget an open modal.
512
- if (modalOpen && currentModal) currentModal.show(id);
513
- else void openModal(ctx, id);
510
+ // Open the panel immediately on this thread, or retarget an open panel.
511
+ if (panelOpen && currentPanel) currentPanel.show(id);
512
+ else void openPanel(ctx, id);
514
513
  }
515
514
 
516
- // ── Modal overlay ────────────────────────────────
517
- // Top-center overlay with a live transcript (icons/markdown like agent-hub's
518
- // ZoomUI) and a follow-up composer. Read-only navigation keys are intercepted
515
+ // ── Full-screen panel ─────────────────────────────
516
+ // Full-screen overlay with a live transcript (icons/markdown like agent-hub's
517
+ // ZoomUI) and a follow-up composer. Navigation keys are intercepted
519
518
  // here; everything else feeds the composer.
520
- class BtwModal {
519
+ class BtwPanel {
521
520
  private selectedIndex = 0;
522
521
  private scrollOffset = 0;
523
522
  private followTail = true;
523
+ private contentHeight = bodyRows(undefined, BTW_CHROME_ROWS);
524
524
  readonly input = new Input();
525
525
 
526
526
  constructor(
@@ -554,7 +554,7 @@ export default function btwExtension(pi: ExtensionAPI) {
554
554
  clampModalView(
555
555
  { selectedIndex: this.selectedIndex, scrollOffset: this.scrollOffset, followTail: this.followTail },
556
556
  this.thread?.timeline.length ?? 0,
557
- BODY_ROWS,
557
+ this.contentHeight,
558
558
  ),
559
559
  );
560
560
  }
@@ -566,7 +566,7 @@ export default function btwExtension(pi: ExtensionAPI) {
566
566
  { selectedIndex: this.selectedIndex, scrollOffset: this.scrollOffset, followTail: this.followTail },
567
567
  prunedCount,
568
568
  this.thread?.timeline.length ?? 0,
569
- BODY_ROWS,
569
+ this.contentHeight,
570
570
  ),
571
571
  );
572
572
  }
@@ -660,7 +660,8 @@ export default function btwExtension(pi: ExtensionAPI) {
660
660
  return box.render(width);
661
661
  }
662
662
 
663
- render(width: number, theme: Theme): string[] {
663
+ render(width: number, terminalRows: number | undefined, theme: Theme): string[] {
664
+ this.contentHeight = bodyRows(terminalRows, BTW_CHROME_ROWS);
664
665
  const lines: string[] = [];
665
666
  const mdTheme = getMarkdownTheme();
666
667
  const t = this.thread;
@@ -691,36 +692,38 @@ export default function btwExtension(pi: ExtensionAPI) {
691
692
  const items = t?.timeline ?? [];
692
693
  this.clamp();
693
694
 
695
+ const composerLines = this.input.render(width);
696
+ // Input may wrap; borrow those extra rows from the transcript, never from
697
+ // the composer/hint chrome.
698
+ const transcriptHeight = Math.max(0, this.contentHeight - Math.max(0, composerLines.length - 1));
694
699
  const bodyLines: string[] = [];
695
700
  if (items.length === 0) {
696
701
  bodyLines.push(theme.fg("dim", " Working…"));
697
702
  } else {
698
703
  for (let i = this.scrollOffset; i < items.length; i++) {
699
704
  const card = this.renderEntry(items[i], i === this.selectedIndex, width, theme, mdTheme);
700
- if (bodyLines.length > 0 && bodyLines.length + card.length > BODY_ROWS) break;
705
+ if (bodyLines.length > 0 && bodyLines.length + card.length > transcriptHeight) break;
701
706
  bodyLines.push(...card);
702
707
  }
703
708
  }
704
- while (bodyLines.length < BODY_ROWS) bodyLines.push("");
705
- if (bodyLines.length > BODY_ROWS) bodyLines.length = BODY_ROWS;
706
- lines.push(...bodyLines);
709
+ lines.push(...fitToHeight(bodyLines, transcriptHeight));
707
710
 
708
711
  // ── Footer: composer + key hints ──
709
712
  const footer = new Container();
710
713
  footer.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
711
714
  footer.addChild(new Text(theme.fg("dim", " follow-up:"), 1, 0));
712
715
  lines.push(...footer.render(width));
713
- lines.push(...this.input.render(width));
716
+ lines.push(...composerLines);
714
717
  const switchHint = order.length >= 2 ? " · ←/→ switch" : "";
715
- lines.push(theme.fg("dim", ` Enter send · Esc hide · ↑/↓ scroll${switchHint} · Ctrl+C copy`));
718
+ lines.push(theme.fg("dim", ` Enter send · Esc return to main (task keeps running) · ↑/↓ scroll${switchHint} · Ctrl+C copy`));
716
719
 
717
- return lines;
720
+ return fitToHeight(lines, this.contentHeight + BTW_CHROME_ROWS);
718
721
  }
719
722
  }
720
723
 
721
- async function openModal(ctx: ExtensionContext, startId?: string): Promise<void> {
722
- if (modalOpen) {
723
- if (startId && currentModal) currentModal.show(startId);
724
+ async function openPanel(ctx: ExtensionContext, startId?: string): Promise<void> {
725
+ if (panelOpen) {
726
+ if (startId && currentPanel) currentPanel.show(startId);
724
727
  return;
725
728
  }
726
729
  const initial = resolveThreadId(startId, order) ?? mostRecentId();
@@ -728,15 +731,15 @@ export default function btwExtension(pi: ExtensionAPI) {
728
731
  ctx.ui.notify("No btw side tasks yet — /af-btw <task> to start one.", "info");
729
732
  return;
730
733
  }
731
- modalOpen = true;
734
+ panelOpen = true;
732
735
  lastViewedId = initial;
733
- let ticker: ReturnType<typeof setInterval> | undefined;
736
+ const resources = createPanelResources();
734
737
  try {
735
738
  await ctx.ui.custom<void>(
736
739
  (tui, theme, _kb, done) => {
737
- const modal = new BtwModal(
740
+ const panel = new BtwPanel(
738
741
  initial,
739
- (text) => submitFollowUp(modal.currentId, text),
742
+ (text) => submitFollowUp(panel.currentId, text),
740
743
  (m, type) => ctx.ui.notify(m, (type === "success" ? "info" : type) as "info" | "warning" | "error"),
741
744
  () => done(undefined),
742
745
  );
@@ -750,76 +753,70 @@ export default function btwExtension(pi: ExtensionAPI) {
750
753
  tui.requestRender();
751
754
  }
752
755
  };
753
- // Bind the render hook to whichever thread the modal currently shows.
756
+ // Bind the render hook to whichever thread the panel currently shows.
754
757
  const bindRender = () => {
755
758
  for (const th of threads.values()) th.render = undefined;
756
- const cur = threads.get(modal.currentId);
759
+ const cur = threads.get(panel.currentId);
757
760
  if (cur) cur.render = requestRender;
758
761
  };
759
762
  bindRender();
760
763
 
761
- // Let a fresh /af-btw retarget this open modal and keep selection valid when
764
+ // Let a fresh /af-btw retarget this open panel and keep selection valid when
762
765
  // retention/pruning changes the backing thread list.
763
- currentModal = {
766
+ currentPanel = {
764
767
  show: (id: string) => {
765
- modal.show(id);
768
+ panel.show(id);
766
769
  bindRender();
767
- lastViewedId = modal.currentId;
770
+ lastViewedId = panel.currentId;
768
771
  tui.requestRender();
769
772
  },
770
- currentId: () => modal.currentId,
773
+ currentId: () => panel.currentId,
771
774
  timelinePruned: (id: string, prunedCount: number) => {
772
- modal.timelinePruned(id, prunedCount);
775
+ panel.timelinePruned(id, prunedCount);
773
776
  tui.requestRender();
774
777
  },
775
778
  clamp: () => {
776
- modal.clamp();
779
+ panel.clamp();
777
780
  tui.requestRender();
778
781
  },
779
782
  };
780
783
 
781
784
  // Keep elapsed/spinner live even between stream events.
782
- ticker = setInterval(() => tui.requestRender(), 500);
785
+ resources.every(500, () => tui.requestRender());
783
786
 
784
787
  return {
785
- render: (w: number) => modal.render(w, theme as Theme),
788
+ render: (w: number) => panel.render(w, tui.terminal?.rows, theme as Theme),
786
789
  handleInput: (data: string) => {
787
- const before = modal.currentId;
788
- modal.handleInput(data, tui);
789
- if (modal.currentId !== before) {
790
+ const before = panel.currentId;
791
+ panel.handleInput(data, tui);
792
+ if (panel.currentId !== before) {
790
793
  bindRender();
791
- lastViewedId = modal.currentId;
794
+ lastViewedId = panel.currentId;
792
795
  }
793
796
  },
794
797
  invalidate: () => {},
795
- dispose: () => {
796
- if (ticker) clearInterval(ticker);
797
- },
798
+ dispose: () => resources.dispose(),
798
799
  };
799
800
  },
800
- {
801
- overlay: true,
802
- overlayOptions: { anchor: "top-center", width: MODAL_WIDTH, maxHeight: MODAL_MAX_HEIGHT, nonCapturing: true },
803
- onHandle: (h) => h.focus(),
804
- },
801
+ { ...FULLSCREEN_OVERLAY, onHandle: (h) => h.focus() },
805
802
  );
806
803
  } finally {
807
- if (ticker) clearInterval(ticker);
808
- currentModal = undefined;
804
+ resources.dispose();
805
+ currentPanel = undefined;
809
806
  for (const th of threads.values()) th.render = undefined;
810
- modalOpen = false;
807
+ panelOpen = false;
811
808
  }
812
809
  }
813
810
 
814
811
  pi.registerCommand("af-btw", {
815
- description: "Start a side task in a live modal (full session context), or reopen the modal. Usage: /af-btw [task]",
812
+ description: "Start a side task in a live panel (full session context), or reopen the panel. Usage: /af-btw [task]",
816
813
  handler: async (args: string, ctx: ExtensionCommandContext) => {
817
814
  latestCtx = ctx;
818
815
  markBtwActivated();
819
816
  const note = args.trim();
820
817
  if (!note) {
821
818
  if (threads.size > 0) {
822
- await openModal(ctx, lastViewedId);
819
+ await openPanel(ctx, lastViewedId);
823
820
  } else {
824
821
  ctx.ui.notify("Usage: /af-btw <task> — runs a side task with this session's full context.", "warning");
825
822
  }
@@ -829,11 +826,11 @@ export default function btwExtension(pi: ExtensionAPI) {
829
826
  },
830
827
  });
831
828
 
832
- // Alt+' reopens the modal. Chosen at the operator's request: unlike Alt+B (pi's
829
+ // Alt+' reopens the panel. Chosen at the operator's request: unlike Alt+B (pi's
833
830
  // editor cursor-word-left) it doesn't collide with a composer motion. Was
834
831
  // Alt+Shift+B → Alt+B → Alt+' — pick another binding here if your terminal eats it.
835
832
  pi.registerShortcut("alt+'", {
836
- description: "Open the btw side-task modal",
833
+ description: "Open the btw side-task panel",
837
834
  handler: async (ctx) => {
838
835
  latestCtx = ctx;
839
836
  markBtwActivated();
@@ -841,7 +838,7 @@ export default function btwExtension(pi: ExtensionAPI) {
841
838
  ctx.ui.notify("No btw side tasks yet — /af-btw <task> to start one.", "info");
842
839
  return;
843
840
  }
844
- await openModal(ctx, lastViewedId);
841
+ await openPanel(ctx, lastViewedId);
845
842
  },
846
843
  });
847
844
 
@@ -911,7 +908,7 @@ export default function btwExtension(pi: ExtensionAPI) {
911
908
  threads.clear();
912
909
  order.length = 0;
913
910
  lastViewedId = undefined;
914
- currentModal?.clamp();
911
+ currentPanel?.clamp();
915
912
  updateStatus(latestCtx);
916
913
  });
917
914
  }
@@ -39,7 +39,7 @@ it shows a moving `transcribing…` dot.
39
39
  Config is resolved in this order (first hit wins):
40
40
 
41
41
  1. `PI_STT_CONFIG` — inline JSON (starts with `{`) or a path to a JSON file
42
- 2. `<cwd>/.ai/stt.json` — project-local config (what guided setup writes)
42
+ 2. `<cwd>/.ai/stt.json` — project-local config (what deterministic setup writes)
43
43
  3. `~/.pi/agent/stt.json` — global config
44
44
  4. built-in defaults
45
45
 
@@ -47,8 +47,9 @@ Secrets are **never** stored in the file: the config names an environment variab
47
47
  key is read from the process environment — a gitignored `.env` at the repo root, auto-loaded by
48
48
  the `justfile`'s `dotenv-load`. See [`examples/stt.json`](examples/stt.json).
49
49
 
50
- > **Guided setup** can write the `.ai/stt.json` + `.env` for you — pick `pi-voice-stt` in
51
- > `/af-setup-agent-fleet` and answer the provider prompts. See
50
+ > **Deterministic setup** can write `.ai/stt.json` and append an empty `.env`
51
+ > placeholder — select the voice feature in `npx @chankov/agent-fleet setup` and answer
52
+ > the provider prompts. See
52
53
  > [docs/agent-fleet-setup.md](../../../docs/agent-fleet-setup.md).
53
54
 
54
55
  ### Option 1 — Generic OpenAI-compatible endpoint
@@ -178,6 +179,9 @@ can be raised.
178
179
 
179
180
  ## Troubleshooting
180
181
 
182
+ - **macOS: Option shortcuts type symbols instead of activating** — configure the terminal to send
183
+ Option as Meta. In Zed set `terminal.option_as_meta` to `true`; this is terminal-specific, not an
184
+ OS-wide shortcut change.
181
185
  - **`/af-stt doctor` says ffmpeg not found** — install ffmpeg or set `capture.ffmpegPath`.
182
186
  - **Linux: no audio** — ensure PulseAudio/PipeWire is running; try `capture.input` of a
183
187
  specific source name from `pactl list sources short`.
@@ -2,7 +2,7 @@
2
2
  //
3
3
  // Resolution order (first hit wins):
4
4
  // 1. PI_STT_CONFIG — inline JSON (starts with "{") or a path to a JSON file
5
- // 2. <cwd>/.ai/stt.json — project-local config (written by guided setup)
5
+ // 2. <cwd>/.ai/stt.json — project-local config (written by deterministic setup)
6
6
  // 3. ~/.pi/agent/stt.json — global config
7
7
  // 4. built-in defaults
8
8
  //