@chankov/agent-fleet 1.0.2 → 1.0.3

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 (325) hide show
  1. package/.pi/harnesses/agent-hub/README.md +60 -60
  2. package/.pi/harnesses/agent-hub/context-window.js +1 -1
  3. package/.pi/harnesses/agent-hub/drift-watchdog.js +11 -4
  4. package/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  5. package/.pi/harnesses/agent-hub/footer.ts +3 -2
  6. package/.pi/harnesses/agent-hub/hub-state-audit.js +0 -14
  7. package/.pi/harnesses/agent-hub/index.ts +351 -261
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  10. package/.pi/harnesses/agent-hub/run-budget.js +67 -69
  11. package/.pi/harnesses/coms/package.json +1 -1
  12. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  13. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  14. package/.pi/harnesses/lib/fleet-detail-view.ts +39 -4
  15. package/.versions/1.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  16. package/.versions/1.0.3/.pi/agents/model-profiles.yaml +27 -0
  17. package/.versions/1.0.3/.pi/agents/peers.yaml +142 -0
  18. package/.versions/1.0.3/.pi/agents/teams.yaml +41 -0
  19. package/.versions/1.0.3/.pi/damage-control-rules.yaml +297 -0
  20. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  21. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  22. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  23. package/.versions/1.0.3/.pi/extensions/btw/README.md +120 -0
  24. package/.versions/1.0.3/.pi/extensions/btw/index.ts +914 -0
  25. package/.versions/1.0.3/.pi/extensions/btw/package.json +6 -0
  26. package/.versions/1.0.3/.pi/extensions/btw/state.js +179 -0
  27. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  28. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  29. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  30. package/.versions/1.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  31. package/.versions/1.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  32. package/.versions/1.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  33. package/.versions/1.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  34. package/.versions/1.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  35. package/.versions/1.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  36. package/.versions/1.0.3/.pi/extensions/package-lock.json +1175 -0
  37. package/.versions/1.0.3/.pi/extensions/package.json +9 -0
  38. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  39. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  40. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  41. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  42. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  43. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  44. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  45. package/.versions/1.0.3/.pi/harnesses/agent-hub/README.md +1156 -0
  46. package/.versions/1.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  47. package/.versions/1.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  48. package/.versions/1.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  49. package/.versions/1.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  50. package/.versions/1.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  51. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  52. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  53. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  54. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  55. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  56. package/.versions/1.0.3/.pi/harnesses/agent-hub/delegate.ts +435 -0
  57. package/.versions/1.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  58. package/.versions/1.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  59. package/.versions/1.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  60. package/.versions/1.0.3/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  61. package/.versions/1.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  62. package/.versions/1.0.3/.pi/harnesses/agent-hub/footer.ts +36 -0
  63. package/.versions/1.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  64. package/.versions/1.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  65. package/.versions/1.0.3/.pi/harnesses/agent-hub/index.ts +9999 -0
  66. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  67. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  68. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  69. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  70. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  71. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  72. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  73. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  74. package/.versions/1.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  75. package/.versions/1.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  76. package/.versions/1.0.3/.pi/harnesses/agent-hub/posture.ts +158 -0
  77. package/.versions/1.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  78. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-retention.js +34 -0
  79. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  80. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  81. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  82. package/.versions/1.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  83. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  84. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  85. package/.versions/1.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  86. package/.versions/1.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  87. package/.versions/1.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  88. package/.versions/1.0.3/.pi/harnesses/agent-hub/spawn.ts +366 -0
  89. package/.versions/1.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  90. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  91. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  92. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  93. package/.versions/1.0.3/.pi/harnesses/coms/README.md +100 -0
  94. package/.versions/1.0.3/.pi/harnesses/coms/index.ts +1767 -0
  95. package/.versions/1.0.3/.pi/harnesses/coms/package.json +7 -0
  96. package/.versions/1.0.3/.pi/harnesses/coms/version.ts +42 -0
  97. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  98. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  99. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  100. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  101. package/.versions/1.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  102. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  103. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  104. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  105. package/.versions/1.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  106. package/.versions/1.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  107. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  108. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  109. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  110. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  111. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  112. package/.versions/1.0.3/.pi/harnesses/lib/fleet-detail-view.ts +168 -0
  113. package/.versions/1.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  114. package/.versions/1.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  115. package/.versions/1.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  116. package/.versions/1.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  117. package/.versions/1.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  118. package/.versions/1.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  119. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  120. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  121. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  122. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  123. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  124. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  125. package/.versions/1.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  126. package/.versions/1.0.3/.pi/harnesses/package-lock.json +2039 -0
  127. package/.versions/1.0.3/.pi/harnesses/package.json +10 -0
  128. package/.versions/1.0.3/.pi/prompts/af-build.md +24 -0
  129. package/.versions/1.0.3/.pi/prompts/af-code-simplify.md +22 -0
  130. package/.versions/1.0.3/.pi/prompts/af-plan.md +16 -0
  131. package/.versions/1.0.3/.pi/prompts/af-review.md +16 -0
  132. package/.versions/1.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  133. package/.versions/1.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  134. package/.versions/1.0.3/.pi/prompts/af-ship.md +17 -0
  135. package/.versions/1.0.3/.pi/prompts/af-spec.md +15 -0
  136. package/.versions/1.0.3/.pi/prompts/af-test.md +19 -0
  137. package/.versions/1.0.3/.pi/skills/bowser/SKILL.md +145 -0
  138. package/.versions/1.0.3/.version +1 -0
  139. package/.versions/1.0.3/agents/architect.md +25 -0
  140. package/.versions/1.0.3/agents/bowser.md +28 -0
  141. package/.versions/1.0.3/agents/builder.md +55 -0
  142. package/.versions/1.0.3/agents/code-reviewer.md +209 -0
  143. package/.versions/1.0.3/agents/deep-researcher.md +33 -0
  144. package/.versions/1.0.3/agents/documenter.md +19 -0
  145. package/.versions/1.0.3/agents/orchestrator.md +21 -0
  146. package/.versions/1.0.3/agents/plan-reviewer.md +84 -0
  147. package/.versions/1.0.3/agents/planner.md +71 -0
  148. package/.versions/1.0.3/agents/releaser.md +25 -0
  149. package/.versions/1.0.3/agents/researcher.md +29 -0
  150. package/.versions/1.0.3/agents/security-auditor.md +168 -0
  151. package/.versions/1.0.3/agents/test-engineer.md +154 -0
  152. package/.versions/1.0.3/agents/web-debugger.md +44 -0
  153. package/.versions/1.0.3/agents/web-performance-auditor.md +194 -0
  154. package/.versions/1.0.3/bin/catalog/harness-runtime-closure.json +38 -0
  155. package/.versions/1.0.3/codex/CONDUCTOR.md +148 -0
  156. package/.versions/1.0.3/docs/ARCHITECTURE.md +375 -0
  157. package/.versions/1.0.3/docs/agent-fleet-setup.md +468 -0
  158. package/.versions/1.0.3/docs/claude-code-coms-bridge.md +128 -0
  159. package/.versions/1.0.3/docs/codex-remote-conductor.md +170 -0
  160. package/.versions/1.0.3/docs/coms-hermes-bridge.md +189 -0
  161. package/.versions/1.0.3/docs/getting-started.md +98 -0
  162. package/.versions/1.0.3/docs/npm-install.md +292 -0
  163. package/.versions/1.0.3/docs/pi-extensions.md +441 -0
  164. package/.versions/1.0.3/docs/pi-setup.md +74 -0
  165. package/.versions/1.0.3/docs/skill-anatomy.md +150 -0
  166. package/.versions/1.0.3/hermes/README.md +347 -0
  167. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  168. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  169. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  170. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  171. package/.versions/1.0.3/hermes/gates/gate-o-capability.md +8 -0
  172. package/.versions/1.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  173. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  174. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  175. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  176. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  177. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  178. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  179. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  180. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  181. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  182. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  183. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  184. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  185. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  186. package/.versions/1.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  187. package/.versions/1.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  188. package/.versions/1.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  189. package/.versions/1.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  190. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  191. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  192. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  193. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  194. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  195. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  196. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  197. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  198. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  199. package/.versions/1.0.3/hermes/watchdog-tests/__init__.py +0 -0
  200. package/.versions/1.0.3/hooks/coms-stop-hook.mjs +84 -0
  201. package/.versions/1.0.3/install-manifest.json +2745 -0
  202. package/.versions/1.0.3/justfile +272 -0
  203. package/.versions/1.0.3/manifest-meta.json +882 -0
  204. package/.versions/1.0.3/references/accessibility-checklist.md +160 -0
  205. package/.versions/1.0.3/references/definition-of-done.md +67 -0
  206. package/.versions/1.0.3/references/fleet-coordination-patterns.md +151 -0
  207. package/.versions/1.0.3/references/observability-checklist.md +91 -0
  208. package/.versions/1.0.3/references/orchestration-patterns.md +370 -0
  209. package/.versions/1.0.3/references/performance-checklist.md +153 -0
  210. package/.versions/1.0.3/references/prompting-patterns.md +380 -0
  211. package/.versions/1.0.3/references/security-checklist.md +179 -0
  212. package/.versions/1.0.3/references/testing-patterns.md +236 -0
  213. package/.versions/1.0.3/scripts/codex-conductor.ts +41 -0
  214. package/.versions/1.0.3/scripts/codex-remote-control.ts +167 -0
  215. package/.versions/1.0.3/scripts/coms-claude-bridge.ts +411 -0
  216. package/.versions/1.0.3/scripts/coms-cli.ts +484 -0
  217. package/.versions/1.0.3/scripts/coms-hermes-bridge.ts +413 -0
  218. package/.versions/1.0.3/scripts/fleet.ts +185 -0
  219. package/.versions/1.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  220. package/.versions/1.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  221. package/.versions/1.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  222. package/.versions/1.0.3/scripts/install-hermes-plugin.sh +180 -0
  223. package/.versions/1.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  224. package/.versions/1.0.3/scripts/lib/codex-conductor.ts +88 -0
  225. package/.versions/1.0.3/scripts/lib/codex-remote-control.ts +480 -0
  226. package/.versions/1.0.3/scripts/lib/coms-envelope.ts +582 -0
  227. package/.versions/1.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  228. package/.versions/1.0.3/scripts/lib/fleet-command.ts +266 -0
  229. package/.versions/1.0.3/scripts/lib/herdr-layout.ts +281 -0
  230. package/.versions/1.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  231. package/.versions/1.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  232. package/.versions/1.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  233. package/.versions/1.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  234. package/.versions/1.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  235. package/.versions/1.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  236. package/.versions/1.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  237. package/.versions/1.0.3/scripts/lib/monitor-env.ts +146 -0
  238. package/.versions/1.0.3/scripts/lib/peer-launch.ts +318 -0
  239. package/.versions/1.0.3/scripts/lib/persona-banner.ts +62 -0
  240. package/.versions/1.0.3/scripts/lib/spawn-stagger.ts +101 -0
  241. package/.versions/1.0.3/scripts/lib/team-project.ts +213 -0
  242. package/.versions/1.0.3/scripts/lib/team-snapshot.ts +147 -0
  243. package/.versions/1.0.3/scripts/peer-banner.ts +40 -0
  244. package/.versions/1.0.3/scripts/peer-launch.ts +259 -0
  245. package/.versions/1.0.3/scripts/team-snapshot.ts +237 -0
  246. package/.versions/1.0.3/scripts/team-up.ts +406 -0
  247. package/.versions/1.0.3/skills/_internal/grilling.md +11 -0
  248. package/.versions/1.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  249. package/.versions/1.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  250. package/.versions/1.0.3/skills/compound-learning/SKILL.md +137 -0
  251. package/.versions/1.0.3/skills/context-engineering/SKILL.md +291 -0
  252. package/.versions/1.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  253. package/.versions/1.0.3/skills/designing-agents/SKILL.md +394 -0
  254. package/.versions/1.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  255. package/.versions/1.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  256. package/.versions/1.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  257. package/.versions/1.0.3/skills/idea-refine/SKILL.md +182 -0
  258. package/.versions/1.0.3/skills/idea-refine/examples.md +238 -0
  259. package/.versions/1.0.3/skills/idea-refine/frameworks.md +99 -0
  260. package/.versions/1.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  261. package/.versions/1.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  262. package/.versions/1.0.3/skills/incremental-implementation/SKILL.md +287 -0
  263. package/.versions/1.0.3/skills/interview-me/SKILL.md +226 -0
  264. package/.versions/1.0.3/skills/orchestration-verification/SKILL.md +181 -0
  265. package/.versions/1.0.3/skills/peer-coms/SKILL.md +90 -0
  266. package/.versions/1.0.3/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/1.0.3/skills/planning-and-task-breakdown/SKILL.md +254 -0
  268. package/.versions/1.0.3/skills/security-and-hardening/SKILL.md +461 -0
  269. package/.versions/1.0.3/skills/spec-driven-development/SKILL.md +257 -0
  270. package/.versions/1.0.3/skills/using-agent-skills/SKILL.md +199 -0
  271. package/.versions/1.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  272. package/.versions/1.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  273. package/.versions/1.0.3/vendor/agent-skills-upstream/README.md +11 -0
  274. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  275. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  276. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  277. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  278. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  279. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  280. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  281. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  282. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  283. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  284. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  285. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  286. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  287. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  288. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  289. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  290. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  291. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  292. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  293. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  294. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  295. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  296. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  297. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  298. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  299. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  300. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  301. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  302. package/CHANGELOG.md +6 -0
  303. package/README.md +5 -4
  304. package/agents/architect.md +1 -0
  305. package/agents/bowser.md +1 -0
  306. package/agents/builder.md +1 -0
  307. package/agents/code-reviewer.md +1 -0
  308. package/agents/deep-researcher.md +1 -0
  309. package/agents/documenter.md +1 -0
  310. package/agents/orchestrator.md +1 -0
  311. package/agents/plan-reviewer.md +1 -0
  312. package/agents/planner.md +1 -0
  313. package/agents/releaser.md +1 -0
  314. package/agents/researcher.md +1 -0
  315. package/agents/security-auditor.md +1 -0
  316. package/agents/test-engineer.md +1 -0
  317. package/agents/web-debugger.md +1 -0
  318. package/agents/web-performance-auditor.md +1 -0
  319. package/bin/lib/validate-overrides.js +1 -1
  320. package/docs/ARCHITECTURE.md +25 -19
  321. package/docs/agent-fleet-setup.md +8 -8
  322. package/docs/pi-extensions.md +4 -2
  323. package/install-manifest.json +1 -1
  324. package/package.json +2 -2
  325. package/scripts/fleet.ts +1 -1
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "1.0.2"
6
+ "version": "1.0.3"
7
7
  }
@@ -18,7 +18,7 @@
18
18
  /** Only the local endpoint is capped by default; hosted providers scale on their side. */
19
19
  export const DEFAULT_PROVIDER_LIMITS = Object.freeze({ custom: 2 });
20
20
 
21
- /** "custom/Qwen3.6-35B-A3B-4bit" → "custom"; the part before the first slash. */
21
+ /** "custom/Qwen3.8-27B-Uncensored-MLX-4bit" → "custom"; the part before the first slash. */
22
22
  export function providerKey(model) {
23
23
  const spec = String(model ?? "").trim().toLowerCase();
24
24
  const slash = spec.indexOf("/");
@@ -1,18 +1,15 @@
1
- // Execution modes & per-turn budgets — the pure policy core behind the hub's
2
- // runaway-orchestration guardrails. Budgets are PER USER TURN: a new user
3
- // message opens a fresh window, so "budget exhausted" naturally means "stop,
4
- // summarize, ask the user". Everything here is data + pure functions so the
5
- // policy is unit-testable away from the 7k-line harness.
1
+ // Task-tier budgets — the pure policy core behind the hub's runaway-orchestration
2
+ // guardrails. Budgets are PER USER TURN: a new user message opens a fresh window,
3
+ // so "budget exhausted" naturally means "stop, summarize, ask the user". Everything
4
+ // here is data + pure functions so the policy is unit-testable away from the
5
+ // 7k-line harness.
6
6
  //
7
- // A budget value of `null` means "off"/unlimited for that axis.
7
+ // A budget value of `null` means "off"/unlimited for that axis. Live envelopes
8
+ // never use null: every tier has explicit numbers. Override `off` cannot lift a
9
+ // tier cap — it stays bounded by the tier.
8
10
 
9
- export const HUB_MODES = ["fast", "standard", "strict"];
10
- export const DEFAULT_HUB_MODE = "standard";
11
-
12
- // Task tiers — the dispatcher's per-turn complexity triage. Tier caps only
13
- // lower the dispatch/research axes (min with the mode budget): a trivial ask
14
- // must not burn a standard-mode budget on ceremony, while `project` defers
15
- // entirely to the mode. Unset tier is treated as "feature".
11
+ // Task tiers — the dispatcher's complexity triage AND the budget envelope.
12
+ // Unset/junk tier is treated as DEFAULT_TASK_TIER (`small`).
16
13
  export const TASK_TIERS = ["trivial", "small", "feature", "project"];
17
14
  // The tier ASSUMED when the dispatcher never called set_task_tier. It is
18
15
  // deliberately not the middle of the range: the tier is task-scoped, so a skipped
@@ -24,13 +21,6 @@ export const TASK_TIERS = ["trivial", "small", "feature", "project"];
24
21
  // reason) when the work really is bigger, which is the cheap direction to be wrong in.
25
22
  export const DEFAULT_TASK_TIER = "small";
26
23
 
27
- export const TIER_CAPS = {
28
- trivial: { maxDispatches: 1, maxResearch: 1 },
29
- small: { maxDispatches: 2, maxResearch: 2 },
30
- feature: { maxDispatches: 6, maxResearch: 4 },
31
- project: { maxDispatches: null, maxResearch: null },
32
- };
33
-
34
24
  /** "Small", " TRIVIAL " → canonical tier name, or null when unrecognized. */
35
25
  export function normalizeTaskTier(value) {
36
26
  const v = String(value ?? "").trim().toLowerCase();
@@ -48,16 +38,24 @@ export const RECYCLE_CONTEXT_PCT = 60;
48
38
  // still being consulted as if it were advisory.
49
39
  export const HARD_RECYCLE_CONTEXT_PCT = 100;
50
40
 
51
- export const MODE_BUDGETS = {
52
- fast: {
53
- maxDispatches: 2,
41
+ export const TIER_BUDGETS = {
42
+ trivial: {
43
+ maxDispatches: 1,
54
44
  maxResearch: 1,
55
45
  wallMs: 15 * 60_000,
56
46
  agentTurnMs: 10 * 60_000,
57
47
  recycleRuns: 3,
58
48
  delegation: false,
59
49
  },
60
- standard: {
50
+ small: {
51
+ maxDispatches: 2,
52
+ maxResearch: 2,
53
+ wallMs: 15 * 60_000,
54
+ agentTurnMs: 10 * 60_000,
55
+ recycleRuns: 3,
56
+ delegation: false,
57
+ },
58
+ feature: {
61
59
  maxDispatches: 8,
62
60
  maxResearch: 4,
63
61
  wallMs: 60 * 60_000,
@@ -65,57 +63,56 @@ export const MODE_BUDGETS = {
65
63
  recycleRuns: 5,
66
64
  delegation: true,
67
65
  },
68
- strict: {
69
- maxDispatches: 24,
70
- maxResearch: 12,
71
- wallMs: 240 * 60_000,
72
- agentTurnMs: null,
66
+ project: {
67
+ maxDispatches: 12,
68
+ maxResearch: 6,
69
+ wallMs: 90 * 60_000,
70
+ agentTurnMs: 30 * 60_000,
73
71
  recycleRuns: 5,
74
72
  delegation: true,
75
73
  },
76
74
  };
77
75
 
78
- /** "Fast", " STRICT " → canonical mode name, or null when unrecognized. */
79
- export function normalizeHubMode(value) {
80
- const v = String(value ?? "").trim().toLowerCase();
81
- return HUB_MODES.includes(v) ? v : null;
82
- }
76
+ /** Dispatch/research slice of TIER_BUDGETS — kept for callers that only need caps. */
77
+ export const TIER_CAPS = Object.fromEntries(
78
+ TASK_TIERS.map((tier) => [tier, {
79
+ maxDispatches: TIER_BUDGETS[tier].maxDispatches,
80
+ maxResearch: TIER_BUDGETS[tier].maxResearch,
81
+ }]),
82
+ );
83
83
 
84
84
  /**
85
- * Effective budget for a mode with per-project overrides applied.
85
+ * Effective budget for a task tier with per-project overrides applied as a ceiling.
86
86
  * Override fields (all optional): maxDispatches, maxResearch, wallMs,
87
- * agentTurnMs, recycleRuns — a number replaces the mode default, `null` turns
88
- * the axis off, `undefined` keeps the default. `delegation` is mode-owned.
89
- * A declared `tier` (task tier) then LOWERS the dispatch and research caps to
90
- * the tier cap — overrides raise/disable the mode side, but the tier keeps a
91
- * simple ask from spending the whole envelope. No tier (null/undefined) means
92
- * no tier caps: the caller decides when to assume DEFAULT_TASK_TIER.
87
+ * agentTurnMs, recycleRuns — a number is min()'d with the tier; `null`/`off`
88
+ * stays bounded by the tier; `undefined` keeps the tier default. `delegation`
89
+ * is tier-owned and never overridable. Unset/junk tier → DEFAULT_TASK_TIER.
93
90
  */
94
- export function resolveTurnBudget(mode, overrides = {}, tier = undefined) {
95
- const base = MODE_BUDGETS[normalizeHubMode(mode) ?? DEFAULT_HUB_MODE];
96
- const pick = (key) => (overrides[key] === undefined ? base[key] : overrides[key]);
97
- const caps = TIER_CAPS[normalizeTaskTier(tier)] ?? { maxDispatches: null, maxResearch: null };
98
- const lower = (value, cap) => {
99
- if (cap == null) return value;
100
- if (value == null) return cap;
101
- return Math.min(value, cap);
91
+ export function resolveTurnBudget(tier, overrides = {}) {
92
+ const base = TIER_BUDGETS[normalizeTaskTier(tier) ?? DEFAULT_TASK_TIER];
93
+ const ceiling = (key) => {
94
+ const override = overrides[key];
95
+ if (override === undefined || override === null) return base[key];
96
+ if (base[key] == null) return override;
97
+ return Math.min(base[key], override);
102
98
  };
103
99
  return {
104
- maxDispatches: lower(pick("maxDispatches"), caps.maxDispatches),
105
- maxResearch: lower(pick("maxResearch"), caps.maxResearch),
106
- wallMs: pick("wallMs"),
107
- agentTurnMs: pick("agentTurnMs"),
108
- recycleRuns: pick("recycleRuns"),
100
+ maxDispatches: ceiling("maxDispatches"),
101
+ maxResearch: ceiling("maxResearch"),
102
+ wallMs: ceiling("wallMs"),
103
+ agentTurnMs: ceiling("agentTurnMs"),
104
+ recycleRuns: ceiling("recycleRuns"),
109
105
  delegation: base.delegation,
110
106
  };
111
107
  }
112
108
 
113
- function refusalTail(mode) {
109
+ function refusalTail(tier) {
110
+ const label = normalizeTaskTier(tier) ?? DEFAULT_TASK_TIER;
114
111
  return "Do NOT retry this call before human confirmation. Summarize progress so far (including " +
115
112
  "unproven assertions and artifact paths), then use the Hub's one-click budget continuation " +
116
- "confirmation. Do not ask for a typed continue message or a slash command. The user can widen " +
117
- `future budgets with /af-hub-mode (current: ${mode}) or the max-*-per-turn / turn-wall-time-s keys ` +
118
- "in .ai/agent-fleet-overrides.md.";
113
+ "confirmation. Do not ask for a typed continue message or a slash command. Raise the task " +
114
+ `tier with set_task_tier when the work outgrew "${label}", or tighten/widen future ceilings ` +
115
+ "with the max-*-per-turn / turn-wall-time-s keys in .ai/agent-fleet-overrides.md.";
119
116
  }
120
117
 
121
118
  /**
@@ -123,26 +120,27 @@ function refusalTail(mode) {
123
120
  * kind: "dispatch" | "research"; counters: { dispatches, research } — calls
124
121
  * already made this turn. Returns null when allowed, else { reason, message }.
125
122
  */
126
- export function checkTurnBudget(kind, counters, budget, elapsedWallMs, mode = DEFAULT_HUB_MODE) {
123
+ export function checkTurnBudget(kind, counters, budget, elapsedWallMs, tier = DEFAULT_TASK_TIER) {
124
+ const label = normalizeTaskTier(tier) ?? DEFAULT_TASK_TIER;
127
125
  if (budget.wallMs != null && elapsedWallMs >= budget.wallMs) {
128
126
  return {
129
127
  reason: "wall",
130
128
  message: `⚠ Turn budget exhausted: wall clock at ${Math.round(elapsedWallMs / 60_000)} min ` +
131
- `(limit ${Math.round(budget.wallMs / 60_000)} min in ${mode} mode). ${refusalTail(mode)}`,
129
+ `(limit ${Math.round(budget.wallMs / 60_000)} min at tier ${label}). ${refusalTail(label)}`,
132
130
  };
133
131
  }
134
132
  if (kind === "dispatch" && budget.maxDispatches != null && counters.dispatches >= budget.maxDispatches) {
135
133
  return {
136
134
  reason: "dispatches",
137
135
  message: `⚠ Turn budget exhausted: ${counters.dispatches} of ${budget.maxDispatches} ` +
138
- `dispatch_agent calls used in ${mode} mode. ${refusalTail(mode)}`,
136
+ `dispatch_agent calls used at tier ${label}. ${refusalTail(label)}`,
139
137
  };
140
138
  }
141
139
  if (kind === "research" && budget.maxResearch != null && counters.research >= budget.maxResearch) {
142
140
  return {
143
141
  reason: "research",
144
142
  message: `⚠ Turn budget exhausted: ${counters.research} of ${budget.maxResearch} ` +
145
- `spawn_research calls used in ${mode} mode. ${refusalTail(mode)}`,
143
+ `spawn_research calls used at tier ${label}. ${refusalTail(label)}`,
146
144
  };
147
145
  }
148
146
  return null;
@@ -180,14 +178,14 @@ export function contextOverflowDiagnostic(runsSinceFresh, contextPct, { agent =
180
178
  );
181
179
  }
182
180
 
183
- /** One-line status chip: "Mode: standard·small · 1/2 disp · 0/2 res · task 4/6". */
184
- export function budgetStatusLine(mode, counters, budget, tier = null, task = null) {
181
+ /** One-line status chip: "Tier: small · 1/2 disp · 0/2 res · task 4/6". */
182
+ export function budgetStatusLine(counters, budget, tier = null, task = null) {
185
183
  const cap = (n) => (n == null ? "∞" : String(n));
186
- const tierSuffix = tier ? `·${tier}` : "";
184
+ const tierLabel = tier || DEFAULT_TASK_TIER;
187
185
  const taskSuffix = task
188
186
  ? ` · task ${task.counters.dispatches}/${cap(task.budget.maxDispatches)}`
189
187
  : "";
190
- return `Mode: ${mode}${tierSuffix} · ${counters.dispatches}/${cap(budget.maxDispatches)} disp · ` +
188
+ return `Tier: ${tierLabel} · ${counters.dispatches}/${cap(budget.maxDispatches)} disp · ` +
191
189
  `${counters.research}/${cap(budget.maxResearch)} res${taskSuffix}`;
192
190
  }
193
191
 
@@ -293,7 +291,7 @@ function taskRefusalTail() {
293
291
  *
294
292
  * The task clock must never charge for human time. A task's wall clock spans
295
293
  * every message on it, so a lunch break, an overnight pause, or a long `ask_user`
296
- * answer would all count as budget — and at `fast` mode's 45-minute task wall a
294
+ * answer would all count as budget — and at `small` tier's 45-minute task wall a
297
295
  * single coffee break would hard-stop a task with two dispatches spent. That is a
298
296
  * false positive that teaches people to reset the task window reflexively, which
299
297
  * costs more than the guardrail buys. Dispatch/research counts stay the honest
@@ -432,8 +430,8 @@ const GATED_TIERS = new Set(["trivial", "small"]);
432
430
 
433
431
  /**
434
432
  * Refuse a heavy persona at a low tier. Returns null when allowed, else
435
- * { reason, message }. Unknown/absent tier never gates (strict mode leaves the
436
- * tier unset on purpose).
433
+ * { reason, message }. Unknown/absent tier never gates here; the harness assumes
434
+ * DEFAULT_TASK_TIER before calling.
437
435
  */
438
436
  export function checkTierPersonaGate(tier, persona) {
439
437
  const t = normalizeTaskTier(tier);
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "1.0.2"
6
+ "version": "1.0.3"
7
7
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "1.0.2"
6
+ "version": "1.0.3"
7
7
  }
@@ -60,7 +60,7 @@ export function renderFleetDashboard(vm: FleetViewModel, width: number, bodyHeig
60
60
  }
61
61
  }
62
62
  lines.push(theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"));
63
- lines.push(ellipsis(theme.fg("dim", vm.confirmation ?? "↑↓ select · Enter open · x kill · r restart · c continue · f filter · a all · q close"), w));
63
+ lines.push(ellipsis(theme.fg("dim", vm.confirmation ?? "↑↓ select · Enter open · m substitute · x kill · r restart · c continue · f filter · a all · q close"), w));
64
64
  return lines.slice(0, body + FLEET_CHROME_ROWS).concat(Array(Math.max(0, body + FLEET_CHROME_ROWS - lines.length)).fill(""));
65
65
  }
66
66
 
@@ -76,6 +76,7 @@ export interface DashboardControllerState {
76
76
  export type DashboardIntent =
77
77
  | null
78
78
  | "close"
79
+ | "substitute"
79
80
  | { open: string }
80
81
  | { kill: string }
81
82
  | { restart: string };
@@ -124,6 +125,7 @@ export function dashboardTransition(
124
125
  state.showFinished = !state.showFinished;
125
126
  return null;
126
127
  }
128
+ if (input === "m" || input === "M") return "substitute";
127
129
  if (input === "\r" && selected) return { open: selected.key };
128
130
  if (input === "x" || input === "r") {
129
131
  if (!selected) return null;
@@ -25,8 +25,9 @@ export function fleetModelChoices(models: readonly PiModelSummary[], current?: s
25
25
  }
26
26
 
27
27
  /** Render the model picker in the same full-screen layer as Fleet Detail. */
28
- export function renderFleetModelPicker(
29
- title: string,
28
+ function renderChoicePicker(
29
+ heading: string,
30
+ footer: string,
30
31
  choices: readonly FleetModelChoice[],
31
32
  state: FleetModelPickerState,
32
33
  width: number,
@@ -42,16 +43,50 @@ export function renderFleetModelPicker(
42
43
  return selected ? theme.fg("accent", theme.bold(line)) : line;
43
44
  });
44
45
  const lines = [
45
- theme.bold(trim(` Model for ${title} · next run · ${choices.length} available`, w)),
46
+ theme.bold(trim(heading, w)),
46
47
  theme.fg("dim", "╭" + "─".repeat(Math.max(0, w - 2)) + "╮"),
47
48
  ...rows,
48
49
  ...Array(Math.max(0, body - rows.length)).fill(""),
49
50
  theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"),
50
- theme.fg("dim", "↑↓ select · PgUp/PgDn page · Home/End · Enter apply · Esc cancel"),
51
+ theme.fg("dim", footer),
51
52
  ];
52
53
  return lines.slice(0, body + DETAIL_CHROME_ROWS).concat(Array(Math.max(0, body + DETAIL_CHROME_ROWS - lines.length)).fill(""));
53
54
  }
54
55
 
56
+ export function renderFleetModelPicker(
57
+ title: string,
58
+ choices: readonly FleetModelChoice[],
59
+ state: FleetModelPickerState,
60
+ width: number,
61
+ bodyHeight: number,
62
+ theme: ThemeLike,
63
+ ): string[] {
64
+ return renderChoicePicker(
65
+ ` Model for ${title} · next run · ${choices.length} available`,
66
+ "↑↓ select · PgUp/PgDn page · Home/End · Enter apply · Esc cancel",
67
+ choices, state, width, bodyHeight, theme,
68
+ );
69
+ }
70
+
71
+ /** Render either step of the session-wide source → target substitution flow. */
72
+ export function renderFleetSubstitutionPicker(
73
+ stage: "source" | "target",
74
+ source: string | undefined,
75
+ choices: readonly FleetModelChoice[],
76
+ state: FleetModelPickerState,
77
+ width: number,
78
+ bodyHeight: number,
79
+ theme: ThemeLike,
80
+ ): string[] {
81
+ const heading = stage === "source"
82
+ ? ` Substitute model · 1/2 choose configured source · ${choices.length} known`
83
+ : ` Substitute ${source ?? "model"} · 2/2 choose available target · ${choices.length} available`;
84
+ const footer = stage === "source"
85
+ ? "↑↓ select · PgUp/PgDn page · Home/End · Enter next · Esc cancel"
86
+ : "↑↓ select · PgUp/PgDn page · Home/End · Enter apply · Esc back";
87
+ return renderChoicePicker(heading, footer, choices, state, width, bodyHeight, theme);
88
+ }
89
+
55
90
  export type FleetDetailKey = "up" | "down" | "pageUp" | "pageDown" | "home" | "end" | "enter" | "escape" | "copy";
56
91
 
57
92
  /** Convert a key identified by Pi's matcher into the detail controller's stable input. */
@@ -0,0 +1,32 @@
1
+ # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
+ # DISPATCH time, never at team activation — the hub and its peers boot in
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
+ # after the session starts.
5
+ #
6
+ # default: native | coms — coms substitutes ANY active-team member that has
7
+ # a live same-name peer in the coms pool
8
+ # grace_s: <seconds> — how long a `fallback: none` member polls the pool
9
+ # for its peer before the dispatch is refused
10
+ # substitutions:
11
+ # <member>: — team-member/persona name (case-insensitive)
12
+ # prefer: native|coms — bare member block defaults to coms
13
+ # fallback: native|none — none = coms-required (refuse when no live peer)
14
+ # timeout_s: <seconds> — per-member reply timeout (default PI_COMS_TIMEOUT_MS)
15
+ #
16
+ # Missing file = everything native (no behavior change). This file is an
17
+ # orchestration decision; HOW each peer runs (model, runner: claude-code, env)
18
+ # stays in peers.yaml.
19
+
20
+ default: native
21
+ grace_s: 30
22
+
23
+ substitutions:
24
+ plan-reviewer:
25
+ prefer: coms
26
+ fallback: native
27
+ code-reviewer:
28
+ prefer: coms
29
+ fallback: native
30
+ documenter:
31
+ prefer: coms
32
+ fallback: native
@@ -0,0 +1,27 @@
1
+ # Named model profiles for /models — each entry must be one of the persona's
2
+ # declared candidates (frontmatter `model:` + `models:` list). A profile with
3
+ # any invalid entry is dropped whole at session start, with an error notify.
4
+ #
5
+ # Profiles only switch the personas they list; everyone else keeps their
6
+ # current model. They never touch delegate-children (`subagents:`) models.
7
+ mix-max:
8
+ code-reviewer: github-copilot/claude-opus-5
9
+ builder: openai-codex/gpt-5.6-sol
10
+ planner: github-copilot/claude-fable-5
11
+ plan-reviewer: openai-codex/gpt-5.6-sol
12
+ security-auditor: xai/grok-4.6
13
+ test-engineer: xai/grok-4.6
14
+ sol:
15
+ code-reviewer: openai-codex/gpt-5.6-sol
16
+ builder: openai-codex/gpt-5.6-sol
17
+ planner: openai-codex/gpt-5.6-sol
18
+ plan-reviewer: openai-codex/gpt-5.6-sol
19
+ security-auditor: openai-codex/gpt-5.6-sol
20
+ test-engineer: openai-codex/gpt-5.6-sol
21
+ terra:
22
+ code-reviewer: openai-codex/gpt-5.6-terra
23
+ builder: openai-codex/gpt-5.6-terra
24
+ planner: openai-codex/gpt-5.6-terra
25
+ plan-reviewer: openai-codex/gpt-5.6-terra
26
+ security-auditor: openai-codex/gpt-5.6-terra
27
+ test-engineer: openai-codex/gpt-5.6-terra
@@ -0,0 +1,142 @@
1
+ # Reusable coms peers, grouped into named teams (parallels teams.yaml).
2
+ #
3
+ # `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
4
+ # (requires a running herdr server — https://herdr.dev),
5
+ # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
+ #
7
+ # A team is NOT required to launch a single peer: `just fleet peer <name>` puts
8
+ # one peer (pi or `--runner claude-code`) in its own pane — splitting the current
9
+ # pane inside Herdr, else creating a one-pane workspace, or `--here` for the
10
+ # calling terminal. A name declared below keeps its runner/model/extensions/
11
+ # env_file; an undeclared name works too.
12
+ #
13
+ # Each peer entry:
14
+ # name — coms identity (the addressable peer name); overrides persona frontmatter
15
+ # persona — file under agents/ (without .md); its body is the role, its
16
+ # frontmatter `description`/`color` become the coms purpose/color
17
+ # model — optional pi --model spec (e.g. anthropic/claude-opus-4-7); omit to
18
+ # inherit pi's default model
19
+ # extensions — optional comma-separated extension names under .pi/extensions/ to
20
+ # load into this peer (routes it through `_peer-plus`). Use for a
21
+ # chrome-devtools-mcp browser-debug peer whose `chrome_devtools__*`
22
+ # tools a --no-extensions subagent could not get.
23
+ # env_file — optional repo-relative KEY=VALUE file (no shell evaluation) injected
24
+ # into the peer's pane env by herdr before the command runs. Must exist
25
+ # at spawn or team-up refuses. Values are redacted in --dry-run output.
26
+ # Pair with the gitignored `.env` convention from guided setup
27
+ # (docs/agent-fleet-setup.md).
28
+ # runner — optional; "claude-code" spawns interactive Claude Code + its coms
29
+ # bridge in the pane instead of a pi peer (persona not required;
30
+ # model maps to `claude --model`). Example:
31
+ # - name: claude-main
32
+ # runner: claude-code
33
+ # model: opus
34
+
35
+ # Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
36
+ # workspace containing only the guarded hub, with no reusable coms peer panes.
37
+ base:
38
+
39
+ full:
40
+ - name: web-debugger
41
+ persona: web-debugger
42
+ model: openai-codex/gpt-5.6-terra
43
+ extensions: chrome-devtools-mcp
44
+ - name: documenter
45
+ persona: documenter
46
+ model: openai-codex/gpt-5.6-terra
47
+ - name: researcher
48
+ persona: researcher
49
+ model: openai-codex/gpt-5.6-luna
50
+
51
+ web:
52
+ - name: web-debugger
53
+ persona: web-debugger
54
+ model: openai-codex/gpt-5.6-terra
55
+ extensions: chrome-devtools-mcp
56
+
57
+ docs:
58
+ - name: documenter
59
+ persona: documenter
60
+ model: openai-codex/gpt-5.6-terra
61
+ - name: researcher
62
+ persona: researcher
63
+ model: openai-codex/gpt-5.6-luna
64
+
65
+ # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
66
+ default:
67
+ - name: code-reviewer
68
+ runner: claude-code
69
+ - name: web-debugger
70
+ persona: web-debugger
71
+ model: openai-codex/gpt-5.6-terra
72
+ extensions: chrome-devtools-mcp
73
+
74
+ debug:
75
+ - name: test-engineer
76
+ persona: test-engineer
77
+ model: openai-codex/gpt-5.6-terra
78
+ - name: builder
79
+ persona: builder
80
+ model: openai-codex/gpt-5.6-terra
81
+ - name: code-reviewer
82
+ runner: claude-code
83
+
84
+ frontend:
85
+ - name: planner
86
+ persona: planner
87
+ model: openai-codex/gpt-5.6-sol
88
+ - name: builder
89
+ persona: builder
90
+ model: openai-codex/gpt-5.6-terra
91
+ - name: bowser
92
+ persona: bowser
93
+ model: openai-codex/gpt-5.6-luna
94
+ - name: code-reviewer
95
+ runner: claude-code
96
+
97
+ security:
98
+ - name: security-auditor
99
+ persona: security-auditor
100
+ model: openai-codex/gpt-5.6-sol
101
+ - name: builder
102
+ persona: builder
103
+ model: openai-codex/gpt-5.6-terra
104
+ - name: test-engineer
105
+ persona: test-engineer
106
+ model: openai-codex/gpt-5.6-terra
107
+ - name: code-reviewer
108
+ runner: claude-code
109
+
110
+ hotfix:
111
+ - name: builder
112
+ persona: builder
113
+ model: openai-codex/gpt-5.6-terra
114
+ - name: code-reviewer
115
+ runner: claude-code
116
+
117
+ release:
118
+ - name: releaser
119
+ persona: releaser
120
+ model: openai-codex/gpt-5.6-terra
121
+ - name: documenter
122
+ persona: documenter
123
+ model: openai-codex/gpt-5.6-terra
124
+
125
+ info:
126
+ - name: documenter
127
+ persona: documenter
128
+ model: openai-codex/gpt-5.3-codex-spark
129
+ - name: code-reviewer
130
+ runner: claude-code
131
+
132
+ review:
133
+ - name: plan-reviewer
134
+ runner: claude-code
135
+ - name: code-reviewer
136
+ runner: claude-code
137
+
138
+ plan:
139
+ - name: planner
140
+ runner: claude-code
141
+ - name: code-reviewer
142
+ runner: claude-code
@@ -0,0 +1,41 @@
1
+ # The first team is activated at startup. Switch with: /agents-team
2
+ # researcher / deep-researcher are not listed — they are always available through spawn_research.
3
+
4
+ default:
5
+ - builder
6
+ - test-engineer
7
+ - code-reviewer
8
+ - documenter
9
+
10
+ plan:
11
+ - planner
12
+ - plan-reviewer
13
+
14
+ debug:
15
+ - test-engineer
16
+ - builder
17
+ - code-reviewer
18
+
19
+ frontend:
20
+ - planner
21
+ - builder
22
+ - bowser
23
+ - code-reviewer
24
+
25
+ security:
26
+ - security-auditor
27
+ - builder
28
+ - test-engineer
29
+ - code-reviewer
30
+
31
+ hotfix:
32
+ - builder
33
+ - code-reviewer
34
+
35
+ release:
36
+ - releaser
37
+ - documenter
38
+
39
+ info:
40
+ - documenter
41
+ - code-reviewer