@chankov/agent-fleet 1.0.1 → 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 (625) hide show
  1. package/.pi/extensions/package-lock.json +77 -45
  2. package/.pi/harnesses/agent-hub/README.md +167 -76
  3. package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  4. package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  5. package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  6. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  7. package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  8. package/.pi/harnesses/agent-hub/context-window.js +1 -1
  9. package/.pi/harnesses/agent-hub/drift-watchdog.js +11 -4
  10. package/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  11. package/.pi/harnesses/agent-hub/footer.ts +3 -2
  12. package/.pi/harnesses/agent-hub/hub-state-audit.js +14 -10
  13. package/.pi/harnesses/agent-hub/index.ts +1316 -660
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  16. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  17. package/.pi/harnesses/agent-hub/run-budget.js +77 -80
  18. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  19. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  20. package/.pi/harnesses/coms/package.json +1 -1
  21. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  22. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  23. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  24. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  25. package/.pi/harnesses/lib/context-budget.ts +114 -0
  26. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  27. package/.pi/harnesses/lib/fleet-detail-view.ts +127 -2
  28. package/.pi/harnesses/package-lock.json +73 -80
  29. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  30. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  31. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  32. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  33. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  34. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  35. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  36. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  37. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  38. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  39. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  40. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  41. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  42. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  43. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  44. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  45. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  46. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  47. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  48. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  49. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  50. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  51. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  52. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  53. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  54. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  55. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  56. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  57. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  58. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  59. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  60. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  61. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  62. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  63. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  64. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  65. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  66. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  67. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  68. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  69. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  70. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  71. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  72. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  73. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  74. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  75. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  76. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  77. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  78. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  79. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  80. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  81. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  82. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  83. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  84. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  85. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  86. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  87. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  88. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  89. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  90. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  91. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  92. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  93. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  94. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  95. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  96. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  97. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  98. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  99. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  100. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  101. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  102. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  103. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  104. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  105. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  106. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  107. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  108. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  109. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  110. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  111. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  112. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  113. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  114. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  115. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  116. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  117. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  118. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  119. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  120. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  121. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  122. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  123. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  124. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  125. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  126. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  127. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  128. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  129. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  130. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  131. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  132. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  133. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  134. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  135. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  136. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  137. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  138. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  139. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  140. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  141. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  142. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  143. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  144. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  145. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  146. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  147. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  148. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  149. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  150. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  151. package/.versions/1.0.2/.version +1 -0
  152. package/.versions/1.0.2/agents/architect.md +24 -0
  153. package/.versions/1.0.2/agents/bowser.md +27 -0
  154. package/.versions/1.0.2/agents/builder.md +54 -0
  155. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  156. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  157. package/.versions/1.0.2/agents/documenter.md +18 -0
  158. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  159. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  160. package/.versions/1.0.2/agents/planner.md +70 -0
  161. package/.versions/1.0.2/agents/releaser.md +24 -0
  162. package/.versions/1.0.2/agents/researcher.md +28 -0
  163. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  164. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  165. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  166. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  167. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  168. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  169. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  170. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  171. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  172. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  173. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  174. package/.versions/1.0.2/docs/getting-started.md +98 -0
  175. package/.versions/1.0.2/docs/npm-install.md +292 -0
  176. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  177. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  178. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  179. package/.versions/1.0.2/hermes/README.md +347 -0
  180. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  181. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  182. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  183. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  184. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  185. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  186. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  187. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  188. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  189. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  190. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  191. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  192. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  193. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  194. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  195. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  196. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  197. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  198. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  199. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  200. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  201. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  202. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  203. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  204. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  205. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  206. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  207. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  208. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  209. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  210. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  211. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  212. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  213. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  214. package/.versions/1.0.2/install-manifest.json +2745 -0
  215. package/.versions/1.0.2/justfile +272 -0
  216. package/.versions/1.0.2/manifest-meta.json +882 -0
  217. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  218. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  219. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  220. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  221. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  222. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  223. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  224. package/.versions/1.0.2/references/security-checklist.md +179 -0
  225. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  226. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  227. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  228. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  229. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  230. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  231. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  232. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  233. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  234. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  235. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  236. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  237. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  238. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  239. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  240. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  241. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  242. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  243. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  244. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  245. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  246. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  247. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  248. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  249. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  250. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  251. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  252. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  253. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  254. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  255. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  256. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  257. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  258. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  259. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  260. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  261. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  262. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  263. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  264. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  265. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  266. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  267. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  268. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  269. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  270. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  271. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  272. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  273. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  274. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  275. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  276. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  277. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  278. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  279. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  280. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  281. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  282. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  283. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  284. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  285. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  286. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  287. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  288. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  289. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  290. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  291. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  292. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  293. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  294. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  295. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  296. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  297. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  298. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  299. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  300. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  301. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  302. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  303. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  304. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  305. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  306. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  307. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  308. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  309. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  310. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  311. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  312. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  313. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  314. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  315. package/.versions/1.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  316. package/.versions/1.0.3/.pi/agents/model-profiles.yaml +27 -0
  317. package/.versions/1.0.3/.pi/agents/peers.yaml +142 -0
  318. package/.versions/1.0.3/.pi/agents/teams.yaml +41 -0
  319. package/.versions/1.0.3/.pi/damage-control-rules.yaml +297 -0
  320. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  321. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  322. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  323. package/.versions/1.0.3/.pi/extensions/btw/README.md +120 -0
  324. package/.versions/1.0.3/.pi/extensions/btw/index.ts +914 -0
  325. package/.versions/1.0.3/.pi/extensions/btw/package.json +6 -0
  326. package/.versions/1.0.3/.pi/extensions/btw/state.js +179 -0
  327. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  328. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  329. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  330. package/.versions/1.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  331. package/.versions/1.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  332. package/.versions/1.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  333. package/.versions/1.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  334. package/.versions/1.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  335. package/.versions/1.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  336. package/.versions/1.0.3/.pi/extensions/package-lock.json +1175 -0
  337. package/.versions/1.0.3/.pi/extensions/package.json +9 -0
  338. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  339. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  340. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  341. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  342. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  343. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  344. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  345. package/.versions/1.0.3/.pi/harnesses/agent-hub/README.md +1156 -0
  346. package/.versions/1.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  347. package/.versions/1.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  348. package/.versions/1.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  349. package/.versions/1.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  350. package/.versions/1.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  351. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  352. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  353. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  354. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  355. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  356. package/.versions/1.0.3/.pi/harnesses/agent-hub/delegate.ts +435 -0
  357. package/.versions/1.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  358. package/.versions/1.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  359. package/.versions/1.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  360. package/.versions/1.0.3/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  361. package/.versions/1.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  362. package/.versions/1.0.3/.pi/harnesses/agent-hub/footer.ts +36 -0
  363. package/.versions/1.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  364. package/.versions/1.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  365. package/.versions/1.0.3/.pi/harnesses/agent-hub/index.ts +9999 -0
  366. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  367. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  368. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  369. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  370. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  371. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  372. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  373. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  374. package/.versions/1.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  375. package/.versions/1.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  376. package/.versions/1.0.3/.pi/harnesses/agent-hub/posture.ts +158 -0
  377. package/.versions/1.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  378. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-retention.js +34 -0
  379. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  380. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  381. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  382. package/.versions/1.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  383. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  384. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  385. package/.versions/1.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  386. package/.versions/1.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  387. package/.versions/1.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  388. package/.versions/1.0.3/.pi/harnesses/agent-hub/spawn.ts +366 -0
  389. package/.versions/1.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  390. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  391. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  392. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  393. package/.versions/1.0.3/.pi/harnesses/coms/README.md +100 -0
  394. package/.versions/1.0.3/.pi/harnesses/coms/index.ts +1767 -0
  395. package/.versions/1.0.3/.pi/harnesses/coms/package.json +7 -0
  396. package/.versions/1.0.3/.pi/harnesses/coms/version.ts +42 -0
  397. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  398. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  399. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  400. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  401. package/.versions/1.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  402. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  403. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  404. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  405. package/.versions/1.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  406. package/.versions/1.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  407. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  408. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  409. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  410. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  411. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  412. package/.versions/1.0.3/.pi/harnesses/lib/fleet-detail-view.ts +168 -0
  413. package/.versions/1.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  414. package/.versions/1.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  415. package/.versions/1.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  416. package/.versions/1.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  417. package/.versions/1.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  418. package/.versions/1.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  419. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  420. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  421. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  422. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  423. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  424. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  425. package/.versions/1.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  426. package/.versions/1.0.3/.pi/harnesses/package-lock.json +2039 -0
  427. package/.versions/1.0.3/.pi/harnesses/package.json +10 -0
  428. package/.versions/1.0.3/.pi/prompts/af-build.md +24 -0
  429. package/.versions/1.0.3/.pi/prompts/af-code-simplify.md +22 -0
  430. package/.versions/1.0.3/.pi/prompts/af-plan.md +16 -0
  431. package/.versions/1.0.3/.pi/prompts/af-review.md +16 -0
  432. package/.versions/1.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  433. package/.versions/1.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  434. package/.versions/1.0.3/.pi/prompts/af-ship.md +17 -0
  435. package/.versions/1.0.3/.pi/prompts/af-spec.md +15 -0
  436. package/.versions/1.0.3/.pi/prompts/af-test.md +19 -0
  437. package/.versions/1.0.3/.pi/skills/bowser/SKILL.md +145 -0
  438. package/.versions/1.0.3/.version +1 -0
  439. package/.versions/1.0.3/agents/architect.md +25 -0
  440. package/.versions/1.0.3/agents/bowser.md +28 -0
  441. package/.versions/1.0.3/agents/builder.md +55 -0
  442. package/.versions/1.0.3/agents/code-reviewer.md +209 -0
  443. package/.versions/1.0.3/agents/deep-researcher.md +33 -0
  444. package/.versions/1.0.3/agents/documenter.md +19 -0
  445. package/.versions/1.0.3/agents/orchestrator.md +21 -0
  446. package/.versions/1.0.3/agents/plan-reviewer.md +84 -0
  447. package/.versions/1.0.3/agents/planner.md +71 -0
  448. package/.versions/1.0.3/agents/releaser.md +25 -0
  449. package/.versions/1.0.3/agents/researcher.md +29 -0
  450. package/.versions/1.0.3/agents/security-auditor.md +168 -0
  451. package/.versions/1.0.3/agents/test-engineer.md +154 -0
  452. package/.versions/1.0.3/agents/web-debugger.md +44 -0
  453. package/.versions/1.0.3/agents/web-performance-auditor.md +194 -0
  454. package/.versions/1.0.3/bin/catalog/harness-runtime-closure.json +38 -0
  455. package/.versions/1.0.3/codex/CONDUCTOR.md +148 -0
  456. package/.versions/1.0.3/docs/ARCHITECTURE.md +375 -0
  457. package/.versions/1.0.3/docs/agent-fleet-setup.md +468 -0
  458. package/.versions/1.0.3/docs/claude-code-coms-bridge.md +128 -0
  459. package/.versions/1.0.3/docs/codex-remote-conductor.md +170 -0
  460. package/.versions/1.0.3/docs/coms-hermes-bridge.md +189 -0
  461. package/.versions/1.0.3/docs/getting-started.md +98 -0
  462. package/.versions/1.0.3/docs/npm-install.md +292 -0
  463. package/.versions/1.0.3/docs/pi-extensions.md +441 -0
  464. package/.versions/1.0.3/docs/pi-setup.md +74 -0
  465. package/.versions/1.0.3/docs/skill-anatomy.md +150 -0
  466. package/.versions/1.0.3/hermes/README.md +347 -0
  467. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  468. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  469. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  470. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  471. package/.versions/1.0.3/hermes/gates/gate-o-capability.md +8 -0
  472. package/.versions/1.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  473. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  474. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  475. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  476. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  477. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  478. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  479. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  480. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  481. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  482. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  483. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  484. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  485. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  486. package/.versions/1.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  487. package/.versions/1.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  488. package/.versions/1.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  489. package/.versions/1.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  490. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  491. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  492. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  493. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  494. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  495. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  496. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  497. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  498. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  499. package/.versions/1.0.3/hermes/watchdog-tests/__init__.py +0 -0
  500. package/.versions/1.0.3/hooks/coms-stop-hook.mjs +84 -0
  501. package/.versions/1.0.3/install-manifest.json +2745 -0
  502. package/.versions/1.0.3/justfile +272 -0
  503. package/.versions/1.0.3/manifest-meta.json +882 -0
  504. package/.versions/1.0.3/references/accessibility-checklist.md +160 -0
  505. package/.versions/1.0.3/references/definition-of-done.md +67 -0
  506. package/.versions/1.0.3/references/fleet-coordination-patterns.md +151 -0
  507. package/.versions/1.0.3/references/observability-checklist.md +91 -0
  508. package/.versions/1.0.3/references/orchestration-patterns.md +370 -0
  509. package/.versions/1.0.3/references/performance-checklist.md +153 -0
  510. package/.versions/1.0.3/references/prompting-patterns.md +380 -0
  511. package/.versions/1.0.3/references/security-checklist.md +179 -0
  512. package/.versions/1.0.3/references/testing-patterns.md +236 -0
  513. package/.versions/1.0.3/scripts/codex-conductor.ts +41 -0
  514. package/.versions/1.0.3/scripts/codex-remote-control.ts +167 -0
  515. package/.versions/1.0.3/scripts/coms-claude-bridge.ts +411 -0
  516. package/.versions/1.0.3/scripts/coms-cli.ts +484 -0
  517. package/.versions/1.0.3/scripts/coms-hermes-bridge.ts +413 -0
  518. package/.versions/1.0.3/scripts/fleet.ts +185 -0
  519. package/.versions/1.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  520. package/.versions/1.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  521. package/.versions/1.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  522. package/.versions/1.0.3/scripts/install-hermes-plugin.sh +180 -0
  523. package/.versions/1.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  524. package/.versions/1.0.3/scripts/lib/codex-conductor.ts +88 -0
  525. package/.versions/1.0.3/scripts/lib/codex-remote-control.ts +480 -0
  526. package/.versions/1.0.3/scripts/lib/coms-envelope.ts +582 -0
  527. package/.versions/1.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  528. package/.versions/1.0.3/scripts/lib/fleet-command.ts +266 -0
  529. package/.versions/1.0.3/scripts/lib/herdr-layout.ts +281 -0
  530. package/.versions/1.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  531. package/.versions/1.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  532. package/.versions/1.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  533. package/.versions/1.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  534. package/.versions/1.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  535. package/.versions/1.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  536. package/.versions/1.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  537. package/.versions/1.0.3/scripts/lib/monitor-env.ts +146 -0
  538. package/.versions/1.0.3/scripts/lib/peer-launch.ts +318 -0
  539. package/.versions/1.0.3/scripts/lib/persona-banner.ts +62 -0
  540. package/.versions/1.0.3/scripts/lib/spawn-stagger.ts +101 -0
  541. package/.versions/1.0.3/scripts/lib/team-project.ts +213 -0
  542. package/.versions/1.0.3/scripts/lib/team-snapshot.ts +147 -0
  543. package/.versions/1.0.3/scripts/peer-banner.ts +40 -0
  544. package/.versions/1.0.3/scripts/peer-launch.ts +259 -0
  545. package/.versions/1.0.3/scripts/team-snapshot.ts +237 -0
  546. package/.versions/1.0.3/scripts/team-up.ts +406 -0
  547. package/.versions/1.0.3/skills/_internal/grilling.md +11 -0
  548. package/.versions/1.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  549. package/.versions/1.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  550. package/.versions/1.0.3/skills/compound-learning/SKILL.md +137 -0
  551. package/.versions/1.0.3/skills/context-engineering/SKILL.md +291 -0
  552. package/.versions/1.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  553. package/.versions/1.0.3/skills/designing-agents/SKILL.md +394 -0
  554. package/.versions/1.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  555. package/.versions/1.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  556. package/.versions/1.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  557. package/.versions/1.0.3/skills/idea-refine/SKILL.md +182 -0
  558. package/.versions/1.0.3/skills/idea-refine/examples.md +238 -0
  559. package/.versions/1.0.3/skills/idea-refine/frameworks.md +99 -0
  560. package/.versions/1.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  561. package/.versions/1.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  562. package/.versions/1.0.3/skills/incremental-implementation/SKILL.md +287 -0
  563. package/.versions/1.0.3/skills/interview-me/SKILL.md +226 -0
  564. package/.versions/1.0.3/skills/orchestration-verification/SKILL.md +181 -0
  565. package/.versions/1.0.3/skills/peer-coms/SKILL.md +90 -0
  566. package/.versions/1.0.3/skills/performance-optimization/SKILL.md +350 -0
  567. package/.versions/1.0.3/skills/planning-and-task-breakdown/SKILL.md +254 -0
  568. package/.versions/1.0.3/skills/security-and-hardening/SKILL.md +461 -0
  569. package/.versions/1.0.3/skills/spec-driven-development/SKILL.md +257 -0
  570. package/.versions/1.0.3/skills/using-agent-skills/SKILL.md +199 -0
  571. package/.versions/1.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  572. package/.versions/1.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  573. package/.versions/1.0.3/vendor/agent-skills-upstream/README.md +11 -0
  574. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  575. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  576. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  577. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  578. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  579. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  580. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  581. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  582. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  583. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  584. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  585. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  586. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  587. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  588. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  589. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  590. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  591. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  592. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  593. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  594. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  595. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  596. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  597. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  598. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  599. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  600. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  601. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  602. package/CHANGELOG.md +15 -0
  603. package/README.md +8 -5
  604. package/agents/architect.md +1 -0
  605. package/agents/bowser.md +1 -0
  606. package/agents/builder.md +1 -0
  607. package/agents/code-reviewer.md +1 -0
  608. package/agents/deep-researcher.md +1 -0
  609. package/agents/documenter.md +1 -0
  610. package/agents/orchestrator.md +5 -56
  611. package/agents/plan-reviewer.md +1 -0
  612. package/agents/planner.md +1 -0
  613. package/agents/releaser.md +1 -0
  614. package/agents/researcher.md +1 -0
  615. package/agents/security-auditor.md +1 -0
  616. package/agents/test-engineer.md +1 -0
  617. package/agents/web-debugger.md +1 -0
  618. package/agents/web-performance-auditor.md +1 -0
  619. package/bin/lib/validate-overrides.js +1 -1
  620. package/docs/ARCHITECTURE.md +72 -34
  621. package/docs/agent-fleet-setup.md +39 -8
  622. package/docs/pi-extensions.md +33 -4
  623. package/install-manifest.json +2 -2
  624. package/package.json +2 -2
  625. 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.1"
6
+ "version": "1.0.3"
7
7
  }
@@ -1,15 +1,10 @@
1
1
  export const POSTURES = ["operator", "orchestrator"] as const;
2
2
  export type Posture = (typeof POSTURES)[number];
3
3
 
4
- export const ORCHESTRATION_TOOLS = [
5
- "dispatch_agent",
6
- "spawn_research",
7
- "set_task_tier",
8
- "team_adjust",
9
- "set_assertions",
10
- "update_assertion",
11
- "get_assertions",
12
- ] as const;
4
+ export const FLEET_TOOLS = ["dispatch_agent", "spawn_research", "set_task_tier", "team_adjust"] as const;
5
+ export const VERIFICATION_TOOLS = ["set_assertions", "update_assertion", "get_assertions"] as const;
6
+ /** Compatibility export for callers that need every orchestration-owned tool. */
7
+ export const ORCHESTRATION_TOOLS = [...FLEET_TOOLS, ...VERIFICATION_TOOLS] as const;
13
8
 
14
9
  export const COMS_TOOLS = ["coms_list", "coms_send", "coms_get", "coms_await"] as const;
15
10
 
@@ -21,7 +16,7 @@ export const HERDR_TOOLS = [
21
16
  "herdr_notify",
22
17
  ] as const;
23
18
 
24
- const CONDITIONAL_TOOLS = new Set<string>([...COMS_TOOLS, ...HERDR_TOOLS, "ask_user"]);
19
+ const CONDITIONAL_TOOLS = new Set<string>([...COMS_TOOLS, ...HERDR_TOOLS, "ask_user", "request_compaction"]);
25
20
  const HUB_OWNED_TOOLS = new Set<string>([
26
21
  ...ORCHESTRATION_TOOLS,
27
22
  ...CONDITIONAL_TOOLS,
@@ -67,6 +62,62 @@ export function resolveSessionPosture(options: {
67
62
  ?? resolveStartupPosture({ hasExplicitRoster: options.hasExplicitRoster });
68
63
  }
69
64
 
65
+ export const NATIVE_ROSTER_STATE_VERSION = 1 as const;
66
+ export const NATIVE_ROSTER_ENTRY_TYPE = "agent-hub-native-roster";
67
+
68
+ export function persistedNativeRosterState(team: string): { version: 1; team: string } {
69
+ const normalized = String(team ?? "").trim();
70
+ if (!normalized) throw new Error("Native roster team name cannot be empty.");
71
+ return { version: NATIVE_ROSTER_STATE_VERSION, team: normalized };
72
+ }
73
+
74
+ export function latestPersistedNativeRoster(entries: readonly unknown[]): string | null {
75
+ for (let index = entries.length - 1; index >= 0; index--) {
76
+ const entry = entries[index] as { type?: unknown; customType?: unknown; data?: { version?: unknown; team?: unknown } } | null;
77
+ if (entry?.type !== "custom" || entry.customType !== NATIVE_ROSTER_ENTRY_TYPE) continue;
78
+ if (entry.data?.version !== NATIVE_ROSTER_STATE_VERSION || typeof entry.data.team !== "string") continue;
79
+ const team = entry.data.team.trim();
80
+ if (team) return team;
81
+ }
82
+ return null;
83
+ }
84
+
85
+ export interface SessionRosterResolution {
86
+ source: "none" | "explicit" | "persisted";
87
+ roster: { name: string; members: string[] } | null;
88
+ diagnostic: string | null;
89
+ }
90
+
91
+ export function resolveSessionRoster(options: {
92
+ teams: Readonly<Record<string, readonly string[]>>;
93
+ entries: readonly unknown[];
94
+ explicitRoster?: unknown;
95
+ availablePersonas: readonly string[];
96
+ includePersisted?: boolean;
97
+ }): SessionRosterResolution {
98
+ const explicit = typeof options.explicitRoster === "string" ? options.explicitRoster.trim() : "";
99
+ const persisted = options.includePersisted === false ? null : latestPersistedNativeRoster(options.entries);
100
+ const requested = explicit || persisted;
101
+ const source: SessionRosterResolution["source"] = explicit ? "explicit" : persisted ? "persisted" : "none";
102
+ if (!requested) return { source, roster: null, diagnostic: null };
103
+
104
+ const name = Object.keys(options.teams).find(candidate => candidate.toLowerCase() === requested.toLowerCase());
105
+ if (!name) {
106
+ const available = Object.keys(options.teams).sort().join(", ") || "(none)";
107
+ return { source, roster: null, diagnostic: `Native roster "${requested}" is unavailable. Select one of: ${available}.` };
108
+ }
109
+ const members = [...options.teams[name]];
110
+ if (members.length === 0) {
111
+ return { source, roster: null, diagnostic: `Native roster "${name}" has no specialists.` };
112
+ }
113
+ const available = new Set(options.availablePersonas.map(persona => persona.toLowerCase()));
114
+ const missing = members.filter(member => !available.has(member.toLowerCase()));
115
+ if (missing.length > 0) {
116
+ return { source, roster: null, diagnostic: `Native roster "${name}" references missing personas: ${missing.join(", ")}.` };
117
+ }
118
+ return { source, roster: { name, members }, diagnostic: null };
119
+ }
120
+
70
121
  export function posturePrompt(posture: Posture): { intro: string; hardRules: string } {
71
122
  if (posture === "operator") {
72
123
  return {
@@ -79,8 +130,7 @@ export function posturePrompt(posture: Posture): { intro: string; hardRules: str
79
130
  return {
80
131
  intro: "You are a dispatcher agent — an orchestrator. You coordinate specialist agents to accomplish tasks. You do NOT have direct access to the codebase.",
81
132
  hardRules: `- NEVER try to read, write, or execute code directly — you have no such tools.
82
- - ALWAYS use \`dispatch_agent\` to get implementation work done; use \`spawn_research\` for read-only recon.
83
- - \`herdr_spawn_pane\` is only for auxiliary processes such as watchers or servers; NEVER use it to bypass delegation by reading, editing, testing, or implementing code in a raw pane.`,
133
+ - ALWAYS use \`dispatch_agent\` to get implementation work done; use \`spawn_research\` for read-only recon.`,
84
134
  };
85
135
  }
86
136
 
@@ -90,14 +140,19 @@ export function resolvePostureTools(options: {
90
140
  comsReady: boolean;
91
141
  herdrReady: boolean;
92
142
  askUserAvailable: boolean;
143
+ /** Active and provisional packs; omitted only for legacy callers. */
144
+ capabilityPacks?: readonly ("core" | "fleet" | "verification" | "peer" | "workspace" | "compaction")[];
93
145
  }): string[] {
94
- const tools = options.posture === "operator"
146
+ const packs = new Set(options.capabilityPacks ?? ["core", "fleet", "verification", "peer", "workspace"]);
147
+ const tools = options.posture === "operator" && packs.has("core")
95
148
  ? options.baselineTools.filter(name => !HUB_OWNED_TOOLS.has(name))
96
149
  : [];
97
150
 
98
- tools.push(...ORCHESTRATION_TOOLS);
99
- if (options.comsReady) tools.push(...COMS_TOOLS);
100
- if (options.askUserAvailable) tools.push("ask_user");
101
- if (options.herdrReady) tools.push(...HERDR_TOOLS);
151
+ if (packs.has("fleet")) tools.push(...FLEET_TOOLS);
152
+ if (packs.has("verification")) tools.push(...VERIFICATION_TOOLS);
153
+ if (packs.has("peer") && options.comsReady) tools.push(...COMS_TOOLS);
154
+ if (packs.has("workspace") && options.herdrReady) tools.push(...HERDR_TOOLS);
155
+ if (packs.has("core") && options.askUserAvailable) tools.push("ask_user");
156
+ if (packs.has("compaction")) tools.push("request_compaction");
102
157
  return [...new Set(tools)];
103
158
  }
@@ -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) {
114
- return "Do NOT retry this call in this turn. Summarize progress so far (including " +
115
- "unproven assertions and artifact paths), then ask the user whether to continue — " +
116
- "the next user message starts a fresh budget window. The user can widen budgets " +
117
- `with /af-hub-mode (current: ${mode}) or the max-*-per-turn / turn-wall-time-s keys ` +
118
- "in .ai/agent-fleet-overrides.md.";
109
+ function refusalTail(tier) {
110
+ const label = normalizeTaskTier(tier) ?? DEFAULT_TASK_TIER;
111
+ return "Do NOT retry this call before human confirmation. Summarize progress so far (including " +
112
+ "unproven assertions and artifact paths), then use the Hub's one-click budget continuation " +
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
 
@@ -203,8 +201,7 @@ export function budgetStatusLine(mode, counters, budget, tier = null, task = nul
203
201
  //
204
202
  // The tier now survives the turn and moves by ratchet: DOWN is free (cheap and
205
203
  // self-limiting), UP costs an explicit reason that is recorded and shown. Only
206
- // an explicit new task (set_task_tier `new_task: true`, or /af-new-task) clears
207
- // it.
204
+ // an explicit new task (`set_task_tier` with `new_task: true`) clears it.
208
205
 
209
206
  export const TIER_RANK = { trivial: 0, small: 1, feature: 2, project: 3 };
210
207
 
@@ -265,9 +262,9 @@ export function applyTierChange(current, next, reason = "") {
265
262
  // Turn budgets are a per-message allowance, and a per-message allowance cannot
266
263
  // bound a task: the observed 47-hour run never hit one, because every steering
267
264
  // message opened a fresh window of 8 dispatches and 60 minutes. The task budget
268
- // is the same envelope multiplied once and NOT reset by a user message — only
269
- // by an explicit new task. Exhaustion is a hard stop, not a "summarize and ask":
270
- // continuing requires the human to open a new task window.
265
+ // is the same envelope multiplied once and NOT reset by a user message.
266
+ // Exhaustion is a hard stop until the human accepts one audited continuation
267
+ // tranche; opening a genuinely new task remains a separate lifecycle action.
271
268
 
272
269
  export const TASK_BUDGET_MULTIPLIER = 3;
273
270
 
@@ -284,9 +281,9 @@ export function resolveTaskBudget(turnBudget, multiplier = TASK_BUDGET_MULTIPLIE
284
281
  function taskRefusalTail() {
285
282
  return "This is a HARD STOP for the current task, not a turn refusal — another user message does " +
286
283
  "NOT reopen it. Summarize what is proven (with evidence and artifact paths), what is unproven, " +
287
- "and what remains, then ask the human to either narrow the remaining work or open a fresh task " +
288
- "window with `/af-new-task`. If the task genuinely grew, say what it grew INTO — a task that " +
289
- "outgrew its envelope three times over is a re-scoping decision, not a budget problem.";
284
+ "and what remains, then use the Hub's one-click task-budget continuation confirmation. A confirmed " +
285
+ "continuation opens one audited tranche while preserving task state. Use `set_task_tier` with " +
286
+ "`new_task: true` only when the human genuinely moved to different work.";
290
287
  }
291
288
 
292
289
  /**
@@ -294,7 +291,7 @@ function taskRefusalTail() {
294
291
  *
295
292
  * The task clock must never charge for human time. A task's wall clock spans
296
293
  * every message on it, so a lunch break, an overnight pause, or a long `ask_user`
297
- * 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
298
295
  * single coffee break would hard-stop a task with two dispatches spent. That is a
299
296
  * false positive that teaches people to reset the task window reflexively, which
300
297
  * costs more than the guardrail buys. Dispatch/research counts stay the honest
@@ -433,8 +430,8 @@ const GATED_TIERS = new Set(["trivial", "small"]);
433
430
 
434
431
  /**
435
432
  * Refuse a heavy persona at a low tier. Returns null when allowed, else
436
- * { reason, message }. Unknown/absent tier never gates (strict mode leaves the
437
- * tier unset on purpose).
433
+ * { reason, message }. Unknown/absent tier never gates here; the harness assumes
434
+ * DEFAULT_TASK_TIER before calling.
438
435
  */
439
436
  export function checkTierPersonaGate(tier, persona) {
440
437
  const t = normalizeTaskTier(tier);
@@ -500,7 +497,7 @@ export function checkReviewRoundCap(tier, persona, roundsSoFar) {
500
497
  `the fix produced new findings is the ratchet — each round's findings become requirements, and the ` +
501
498
  `enlarged requirement set justifies the next round.\n` +
502
499
  `If this genuinely is a different review (a different subsystem, or work the earlier round never saw), ` +
503
- `raise the tier with a reason via set_task_tier, or open a new task window with /af-new-task.`,
500
+ `raise the tier with a reason via set_task_tier, or call it with new_task: true for genuinely different work.`,
504
501
  };
505
502
  }
506
503
 
@@ -49,7 +49,14 @@ export interface SpawnPiAgentOptions {
49
49
  model: string;
50
50
  tools: string;
51
51
  thinking: string;
52
- appendSystemPrompt: string;
52
+ /** Replacement prompt; mutually exclusive with appendSystemPrompt when spawning. */
53
+ systemPrompt?: string;
54
+ /** Prompt appended to Pi's inherited prompt (legacy/default child policy). */
55
+ appendSystemPrompt?: string;
56
+ /** Disable automatic global skill discovery for a minimized child. */
57
+ noSkills?: boolean;
58
+ /** Disable AGENTS.md/CLAUDE.md and other automatic context-file discovery. */
59
+ noContextFiles?: boolean;
53
60
  sessionFile: string;
54
61
  resume?: boolean;
55
62
  prompt: string;
@@ -122,11 +129,16 @@ export function spawnPiAgent(
122
129
  opts: SpawnPiAgentOptions,
123
130
  cbs: SpawnPiAgentCallbacks = {},
124
131
  ): Promise<SpawnPiAgentResult> {
132
+ const promptArg = opts.systemPrompt !== undefined
133
+ ? ["--system-prompt", opts.systemPrompt]
134
+ : ["--append-system-prompt", opts.appendSystemPrompt ?? ""];
125
135
  const args = [
126
136
  "--mode", "json", "-p", "--no-extensions",
137
+ ...(opts.noSkills ? ["--no-skills"] : []),
138
+ ...(opts.noContextFiles ? ["--no-context-files"] : []),
127
139
  ...(opts.extensions || []).flatMap(e => ["-e", e]),
128
140
  "--model", opts.model, "--tools", opts.tools, "--thinking", opts.thinking,
129
- "--append-system-prompt", opts.appendSystemPrompt, "--session", opts.sessionFile,
141
+ ...promptArg, "--session", opts.sessionFile,
130
142
  ];
131
143
  if (opts.resume) args.push("-c");
132
144
 
@@ -35,6 +35,26 @@ interface InstallOptions {
35
35
  remoteProject?: string | (() => string);
36
36
  }
37
37
 
38
+ export interface AskUserResultObservation {
39
+ params: { question?: unknown; context?: unknown; options?: unknown };
40
+ result?: unknown;
41
+ phase: "start" | "result";
42
+ }
43
+
44
+ const askUserResultObservers = new Set<(observation: AskUserResultObservation) => void>();
45
+
46
+ /** Observe compact ask calls without inspecting human prose. */
47
+ export function observeAskUserResults(observer: (observation: AskUserResultObservation) => void): () => void {
48
+ askUserResultObservers.add(observer);
49
+ return () => askUserResultObservers.delete(observer);
50
+ }
51
+
52
+ function emitAskUserObservation(observation: AskUserResultObservation): void {
53
+ for (const observer of askUserResultObservers) {
54
+ try { observer(observation); } catch { /* observers cannot break asking */ }
55
+ }
56
+ }
57
+
38
58
  interface ResolveStockOptions {
39
59
  moduleUrl?: string;
40
60
  cwd?: string;
@@ -329,26 +349,59 @@ async function defaultCancelRemote(qid: string, reason: string, project: string)
329
349
  }
330
350
  }
331
351
 
352
+ // Keep UI preferences in the stock implementation; expose only question semantics.
353
+ export const COMPACT_ASK_USER_PARAMETERS = {
354
+ type: "object",
355
+ properties: {
356
+ question: { type: "string", description: "One focused question." },
357
+ context: { type: "string", description: "Short decision context." },
358
+ options: { type: "array", items: { type: "string", description: "Choice label." }, minItems: 2, maxItems: 6, description: "Two to six choices." },
359
+ allowMultiple: { type: "boolean", description: "Allow several choices." },
360
+ allowFreeform: { type: "boolean", description: "Allow a typed answer." },
361
+ allowComment: { type: "boolean", description: "Allow an optional comment." },
362
+ },
363
+ required: ["question"],
364
+ } as const;
365
+
366
+ export function compactAskUserParams(params: any): any {
367
+ return {
368
+ question: params?.question,
369
+ ...(params?.context === undefined ? {} : { context: params.context }),
370
+ ...(params?.options === undefined ? {} : { options: normalizeOptions(params.options) }),
371
+ ...(params?.allowMultiple === undefined ? {} : { allowMultiple: params.allowMultiple }),
372
+ ...(params?.allowFreeform === undefined ? {} : { allowFreeform: params.allowFreeform }),
373
+ ...(params?.allowComment === undefined ? {} : { allowComment: params.allowComment }),
374
+ };
375
+ }
376
+
332
377
  export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOptions = {}): ToolRegistration {
333
378
  return {
334
379
  ...stockTool,
380
+ description: "Ask one focused human question; choices are optional.",
381
+ promptSnippet: "Ask one focused human question",
382
+ promptGuidelines: ["Ask one focused question per call."],
383
+ parameters: COMPACT_ASK_USER_PARAMETERS,
335
384
  async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
385
+ const stockParams = compactAskUserParams(params);
386
+ emitAskUserObservation({ params: stockParams, phase: "start" });
336
387
  const configuredProject = typeof options.remoteProject === "function" ? options.remoteProject() : options.remoteProject;
337
388
  const remoteProject = configuredProject ?? process.env.PI_COMS_PROJECT?.trim() ?? "default";
338
389
  const startRemote = options.startRemote ?? ((remoteParams: any) => defaultStartRemote(remoteParams, remoteProject));
339
390
  let remoteStart: { qid: string; result: Promise<any> } | null = null;
340
391
  try {
341
- remoteStart = await startRemote(params, ctx);
392
+ remoteStart = await startRemote(stockParams, ctx);
342
393
  } catch {
343
394
  remoteStart = null;
344
395
  }
345
396
 
346
397
  if (!remoteStart) {
347
- return await stockTool.execute?.(toolCallId, params, signal, onUpdate, ctx);
398
+ const result = await stockTool.execute?.(toolCallId, stockParams, signal, onUpdate, ctx);
399
+ emitAskUserObservation({ params: stockParams, result, phase: "result" });
400
+ return result;
348
401
  }
349
402
 
350
- return await raceAskUser({
351
- runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, params, localSignal, onUpdate, ctx),
403
+ const result = await raceAskUser({
404
+ runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, stockParams, localSignal, onUpdate, ctx),
352
405
  startRemote: () => remoteStart,
353
406
  cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
354
407
  createAbortController: () => {
@@ -358,6 +411,8 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
358
411
  },
359
412
  signal,
360
413
  });
414
+ emitAskUserObservation({ params: stockParams, result, phase: "result" });
415
+ return result;
361
416
  },
362
417
  };
363
418
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "1.0.1"
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.1"
6
+ "version": "1.0.3"
7
7
  }