@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
@@ -0,0 +1,73 @@
1
+ import { turnActiveMs } from "./run-budget.js";
2
+
3
+ export type BudgetContinuationKind = "turn" | "task";
4
+ export type BudgetContinuationOutcome = "continue" | "stop";
5
+
6
+ export const BUDGET_CONTINUATION_MARKER = "agent-hub-budget-continuation";
7
+
8
+ export function budgetContinuationContext(kind: BudgetContinuationKind): string {
9
+ return `[[${BUDGET_CONTINUATION_MARKER}:${kind}]]`;
10
+ }
11
+
12
+ export function budgetContinuationKind(context: unknown): BudgetContinuationKind | null {
13
+ if (typeof context !== "string") return null;
14
+ const match = new RegExp(`\\[\\[${BUDGET_CONTINUATION_MARKER}:(turn|task)\\]\\]`).exec(context);
15
+ return (match?.[1] as BudgetContinuationKind | undefined) ?? null;
16
+ }
17
+
18
+ /** Model-facing protocol appended to a budget refusal. */
19
+ export function budgetContinuationInstruction(message: string, kind: BudgetContinuationKind, userLanguage: string): string {
20
+ const scope = kind === "task" ? "same task with one additional task-budget window" : "same task with a fresh turn-budget window";
21
+ return `${message}\n\n` +
22
+ `Do not ask the human to type continue or run a slash command. Call ask_user exactly once, in ${userLanguage}, ` +
23
+ `to ask whether to continue the ${scope}. Put ${budgetContinuationContext(kind)} in the context, summarize ` +
24
+ `what is complete and what the next window will do, and provide exactly two single-select options in this order: ` +
25
+ `(1) Yes — continue, (2) No — stop. Set allowFreeform to false. The first option automatically renews the ` +
26
+ `${kind} budget; after that answer, continue directly in this tool loop without requesting another message. ` +
27
+ `The second option or cancellation stops.`;
28
+ }
29
+
30
+ function optionTitle(option: unknown): string {
31
+ if (typeof option === "string") return option.trim();
32
+ if (!option || typeof option !== "object") return "";
33
+ const title = (option as { title?: unknown }).title;
34
+ return typeof title === "string" ? title.trim() : "";
35
+ }
36
+
37
+ function selectedAnswer(result: unknown): string {
38
+ const response = (result as { details?: { response?: unknown } } | null)?.details?.response;
39
+ const selections = (response as { selections?: unknown } | null)?.selections;
40
+ if (Array.isArray(selections) && typeof selections[0] === "string") return selections[0].trim();
41
+ return "";
42
+ }
43
+
44
+ /**
45
+ * Interpret only a marked, ordered ask_user confirmation. The displayed labels
46
+ * may be translated: option 1 always means continue and every later option
47
+ * means stop. Cancellation is conservative and stops.
48
+ */
49
+ export function budgetContinuationOutcome(
50
+ params: { context?: unknown; options?: unknown },
51
+ result: unknown,
52
+ ): BudgetContinuationOutcome | null {
53
+ if (!budgetContinuationKind(params.context)) return null;
54
+ if ((result as { details?: { cancelled?: unknown } } | null)?.details?.cancelled === true) return "stop";
55
+ if (!Array.isArray(params.options) || params.options.length < 2) return null;
56
+ const options = params.options.map(optionTitle);
57
+ if (!options[0] || options.some(title => !title)) return null;
58
+ const selected = selectedAnswer(result);
59
+ if (!selected) return null;
60
+ const index = options.indexOf(selected);
61
+ if (index < 0) return null;
62
+ return index === 0 ? "continue" : "stop";
63
+ }
64
+
65
+ /** Active turn-budget time excludes both completed and currently-open asks. */
66
+ export function turnBudgetActiveMs(
67
+ turnStartedAt: number,
68
+ now: number,
69
+ completedAskWaitMs = 0,
70
+ openAskWaitMs = 0,
71
+ ): number {
72
+ return turnActiveMs(turnStartedAt, now, Math.max(0, completedAskWaitMs) + Math.max(0, openAskWaitMs));
73
+ }
@@ -0,0 +1,47 @@
1
+ import type { CapabilityPack } from "./capability-packs.ts";
2
+
3
+ export type ConfirmableCapabilityPack = Exclude<CapabilityPack, "core" | "verification" | "compaction">;
4
+ export type CapabilityConfirmationStatus = "pending" | "promoted" | "declined";
5
+ export type CapabilityConfirmationState = Partial<Record<ConfirmableCapabilityPack, CapabilityConfirmationStatus>>;
6
+
7
+ export const CAPABILITY_CONFIRMATION_MARKER = "agent-hub-capability-confirmation";
8
+
9
+ export function capabilityConfirmationContext(pack: ConfirmableCapabilityPack): string {
10
+ return `[[${CAPABILITY_CONFIRMATION_MARKER}:${pack}]]`;
11
+ }
12
+
13
+ export function capabilityConfirmationPack(context: unknown): ConfirmableCapabilityPack | null {
14
+ if (typeof context !== "string") return null;
15
+ const match = new RegExp(`\\[\\[${CAPABILITY_CONFIRMATION_MARKER}:(fleet|peer|workspace)\\]\\]`).exec(context);
16
+ return (match?.[1] as ConfirmableCapabilityPack | undefined) ?? null;
17
+ }
18
+
19
+ export function capabilityConfirmationQuestion(pack: ConfirmableCapabilityPack): { question: string; context: string; options: string[] } {
20
+ return {
21
+ question: `Use the provisional ${pack} capability for this task?`,
22
+ context: `${capabilityConfirmationContext(pack)} Confirm before its first side effect.`,
23
+ options: ["Confirm", "Reject", "Cancel"],
24
+ };
25
+ }
26
+
27
+ export function confirmationOutcome(result: unknown): "promoted" | "declined" | null {
28
+ const value = result as { details?: { cancelled?: unknown; response?: unknown } } | null;
29
+ if (value?.details?.cancelled === true) return "declined";
30
+ const response = value?.details?.response;
31
+ const answer = Array.isArray((response as { selections?: unknown })?.selections)
32
+ ? (response as { selections: unknown[] }).selections.join(" ")
33
+ : typeof (response as { text?: unknown })?.text === "string"
34
+ ? (response as { text: string }).text
35
+ : typeof response === "string" ? response : "";
36
+ if (/^\s*confirm\s*$/i.test(answer)) return "promoted";
37
+ if (/^\s*(reject|cancel)\s*$/i.test(answer)) return "declined";
38
+ return null;
39
+ }
40
+
41
+ export function confirmationGate(state: CapabilityConfirmationState, pack: ConfirmableCapabilityPack, provisional: boolean): { allowed: true } | { allowed: false; status: "ask" | "pending" | "declined"; message: string } {
42
+ const status = state[pack];
43
+ if (status === "declined") return { allowed: false, status: "declined", message: `provisional ${pack} capability was declined for this task; do not perform this side effect.` };
44
+ if (status === "promoted" || !provisional) return { allowed: true };
45
+ if (status === "pending") return { allowed: false, status: "pending", message: `provisional ${pack} capability awaits its single human confirmation; do not repeat the question or side effect.` };
46
+ return { allowed: false, status: "ask", message: `provisional ${pack} capability requires one human confirmation before this side effect; call ask_user with ${JSON.stringify(capabilityConfirmationQuestion(pack))}.` };
47
+ }
@@ -0,0 +1,180 @@
1
+ import type { Posture } from "./posture.ts";
2
+ import type { CapabilityConfirmationState } from "./capability-confirmation.ts";
3
+
4
+ export const CAPABILITY_PACKS = ["core", "fleet", "verification", "peer", "workspace", "compaction"] as const;
5
+ export type CapabilityPack = (typeof CAPABILITY_PACKS)[number];
6
+ export type TaskTier = "trivial" | "small" | "feature" | "project";
7
+ export type ContextState = "normal" | "approaching-compaction" | "imminent-compaction";
8
+
9
+ export interface PendingOperation {
10
+ pack: Exclude<CapabilityPack, "core">;
11
+ kind: string;
12
+ }
13
+
14
+ export interface CapabilityResolutionInput {
15
+ posture: Posture;
16
+ userText: string;
17
+ taskTier?: TaskTier;
18
+ taskPacks: readonly CapabilityPack[];
19
+ /** Provisional packs persist as provisional; they must never silently become active. */
20
+ provisionalPacks?: readonly CapabilityPack[];
21
+ comsReady: boolean;
22
+ herdrReady: boolean;
23
+ pendingOperations: readonly PendingOperation[];
24
+ contextState: ContextState;
25
+ /** Only an explicit lifecycle action may shrink task-scoped packs. */
26
+ newTask?: boolean;
27
+ }
28
+
29
+ export type CapabilityReason =
30
+ | "core"
31
+ | "inactive"
32
+ | "posture-required"
33
+ | "explicit-fleet"
34
+ | "explicit-verification"
35
+ | "tier-verification"
36
+ | "explicit-peer"
37
+ | "explicit-workspace"
38
+ | "explicit-compaction"
39
+ | "approaching-compaction"
40
+ | "imminent-compaction"
41
+ | "ambiguous-fleet"
42
+ | "ambiguous-peer"
43
+ | "ambiguous-workspace"
44
+ | "task-retained"
45
+ | "pending-operation";
46
+
47
+ export interface CapabilityResolution {
48
+ active: CapabilityPack[];
49
+ provisional: CapabilityPack[];
50
+ reasons: Record<CapabilityPack, CapabilityReason>;
51
+ confirmationRequired: CapabilityPack[];
52
+ /** Persist this compact state for the current task; it contains no user text. */
53
+ nextTaskPacks: CapabilityPack[];
54
+ }
55
+
56
+ /** Session-safe capability metadata. It intentionally contains no user message. */
57
+ export interface PersistedCapabilityState {
58
+ taskPacks: CapabilityPack[];
59
+ active: CapabilityPack[];
60
+ provisional: CapabilityPack[];
61
+ reasons: Record<CapabilityPack, CapabilityReason>;
62
+ confirmationRequired: CapabilityPack[];
63
+ confirmation: CapabilityConfirmationState;
64
+ }
65
+
66
+ export function persistedCapabilityState(resolution: CapabilityResolution, confirmation: CapabilityConfirmationState = {}): PersistedCapabilityState {
67
+ return {
68
+ taskPacks: resolution.nextTaskPacks,
69
+ active: resolution.active,
70
+ provisional: resolution.provisional,
71
+ reasons: resolution.reasons,
72
+ confirmationRequired: resolution.confirmationRequired,
73
+ confirmation,
74
+ };
75
+ }
76
+
77
+ export function latestPersistedCapabilityState(entries: readonly unknown[]): PersistedCapabilityState | null {
78
+ for (let i = entries.length - 1; i >= 0; i--) {
79
+ const entry = entries[i] as { type?: unknown; customType?: unknown; data?: Partial<PersistedCapabilityState> } | null;
80
+ if (entry?.type !== "custom" || entry.customType !== "agent-hub-capability-packs") continue;
81
+ const data = entry.data;
82
+ if (!data || !Array.isArray(data.taskPacks) || !Array.isArray(data.active) || !Array.isArray(data.provisional) || !Array.isArray(data.confirmationRequired) || !data.reasons) continue;
83
+ const valid = (packs: unknown[]): packs is CapabilityPack[] => packs.every(pack => typeof pack === "string" && CAPABILITY_PACKS.includes(pack as CapabilityPack));
84
+ if (!valid(data.taskPacks) || !valid(data.active) || !valid(data.provisional) || !valid(data.confirmationRequired)) continue;
85
+ return {
86
+ taskPacks: ordered(data.taskPacks), active: ordered(data.active), provisional: ordered(data.provisional),
87
+ reasons: { core: "core", fleet: "inactive", verification: "inactive", peer: "inactive", workspace: "inactive", compaction: "inactive", ...data.reasons },
88
+ confirmationRequired: ordered(data.confirmationRequired),
89
+ confirmation: data.confirmation && typeof data.confirmation === "object" ? data.confirmation as CapabilityConfirmationState : {},
90
+ };
91
+ }
92
+ return null;
93
+ }
94
+
95
+ function matches(text: string, expression: RegExp): boolean {
96
+ return expression.test(text);
97
+ }
98
+
99
+ function isAvailable(pack: CapabilityPack, input: CapabilityResolutionInput): boolean {
100
+ return pack !== "peer" || input.comsReady
101
+ ? pack !== "workspace" || input.herdrReady
102
+ : false;
103
+ }
104
+
105
+ /**
106
+ * Resolves semantic operation families locally. The input text is inspected only
107
+ * for this call; no raw text is included in the resolution or persisted state.
108
+ */
109
+ function intentFor(text: string): Record<Exclude<CapabilityPack, "core">, boolean> {
110
+ const normalized = text.toLowerCase();
111
+ return {
112
+ fleet: matches(normalized, /\b(dispatch|delegate|delegation|specialist|research(?:\s+helper)?|spawn\s+(?:an?\s+)?agent)\b/),
113
+ verification: matches(normalized, /\b(verification|verify|acceptance\s+(?:criteria|gate|work)|assertions?|parity)\b/),
114
+ peer: matches(normalized, /\b(coms|existing\s+peer|peer\s+(?:message|reply|channel)|message\s+(?:the\s+)?peer)\b/),
115
+ workspace: matches(normalized, /\b(herdr|(?:open|spawn)\s+(?:a\s+)?pane|watcher|notify|notification)\b/),
116
+ compaction: matches(normalized, /\b(compaction|request_compaction|compact\s+(?:the\s+)?(?:context|conversation|session))\b/),
117
+ };
118
+ }
119
+
120
+ function ambiguousPack(text: string, input: CapabilityResolutionInput): CapabilityPack | null {
121
+ const normalized = text.toLowerCase();
122
+ if (input.comsReady && matches(normalized, /\b(contact|message|reach)\s+(them|someone)\b/)) return "peer";
123
+ if (input.herdrReady && matches(normalized, /\b(start|open)\s+(it|something)\s+(somewhere|else)\b/)) return "workspace";
124
+ if (matches(normalized, /\b(somebody|someone|another\s+person)\s+else\s+(?:to\s+)?(?:handle|do|work)\b/)) return "fleet";
125
+ return null;
126
+ }
127
+
128
+ function ordered(packs: Iterable<CapabilityPack>): CapabilityPack[] {
129
+ const set = new Set(packs);
130
+ return CAPABILITY_PACKS.filter(pack => set.has(pack));
131
+ }
132
+
133
+ /** A pure, deterministic resolver for the model-visible capability profile. */
134
+ export function resolveCapabilityPacks(input: CapabilityResolutionInput): CapabilityResolution {
135
+ const intent = intentFor(input.userText);
136
+ const active = new Set<CapabilityPack>(["core"]);
137
+ const provisional = new Set<CapabilityPack>();
138
+ const reasons: Record<CapabilityPack, CapabilityReason> = {
139
+ core: "core", fleet: "inactive", verification: "inactive", peer: "inactive", workspace: "inactive", compaction: "inactive",
140
+ };
141
+ const activate = (pack: CapabilityPack, reason: CapabilityReason) => {
142
+ if (!isAvailable(pack, input)) return;
143
+ active.add(pack);
144
+ reasons[pack] = reason;
145
+ };
146
+
147
+ if (!input.newTask) {
148
+ for (const pack of input.taskPacks) {
149
+ if (pack !== "core" && pack !== "compaction") activate(pack, "task-retained");
150
+ }
151
+ for (const pack of input.provisionalPacks ?? []) {
152
+ if (pack !== "core" && pack !== "compaction" && isAvailable(pack, input)) {
153
+ provisional.add(pack);
154
+ reasons[pack] = `ambiguous-${pack}` as CapabilityReason;
155
+ }
156
+ }
157
+ }
158
+ for (const operation of input.pendingOperations) activate(operation.pack, "pending-operation");
159
+
160
+ if (input.posture === "orchestrator") activate("fleet", "posture-required");
161
+ if (intent.fleet) activate("fleet", "explicit-fleet");
162
+ if (intent.verification) activate("verification", "explicit-verification");
163
+ if (input.taskTier === "feature" || input.taskTier === "project") activate("verification", "tier-verification");
164
+ if (intent.peer) activate("peer", "explicit-peer");
165
+ if (intent.workspace) activate("workspace", "explicit-workspace");
166
+ if (intent.compaction) activate("compaction", "explicit-compaction");
167
+ if (input.contextState === "approaching-compaction") activate("compaction", "approaching-compaction");
168
+ if (input.contextState === "imminent-compaction") activate("compaction", "imminent-compaction");
169
+
170
+ const ambiguous = ambiguousPack(input.userText, input);
171
+ if (ambiguous && !active.has(ambiguous) && isAvailable(ambiguous, input)) {
172
+ provisional.add(ambiguous);
173
+ reasons[ambiguous] = `ambiguous-${ambiguous}` as CapabilityReason;
174
+ }
175
+
176
+ const activePacks = ordered(active);
177
+ const provisionalPacks = ordered(provisional);
178
+ const nextTaskPacks = ordered(activePacks.filter(pack => pack !== "core" && pack !== "compaction"));
179
+ return { active: activePacks, provisional: provisionalPacks, reasons, confirmationRequired: provisionalPacks, nextTaskPacks };
180
+ }
@@ -0,0 +1,105 @@
1
+ import { component, reconcilePlane, safeSchemaChars, type ContextBudgetComponent, type ContextPlane } from "../lib/context-budget.ts";
2
+ import type { ContextPressureDiagnostic } from "./context-pressure.ts";
3
+
4
+ export interface Usage { input?: number; cacheRead?: number; cacheWrite?: number; output?: number; reasoning?: number; total?: number; cost?: number; }
5
+ export interface ProjectionPart { id: string; category: ContextBudgetComponent["category"]; label: string; chars: number; }
6
+ export interface LivePlane { id: string; label: string; plane: Exclude<ContextPlane, "hub">; model?: string; window?: number; tokens?: number; percent?: number | null; projectionChars?: number; projectionParts?: readonly ProjectionPart[]; attribution?: "unavailable" | "projected"; }
7
+ export interface SnapshotInput {
8
+ model?: string; window?: number; usage?: Usage; systemPrompt?: string; systemPromptOptions?: Record<string, unknown>;
9
+ tools?: readonly { name: string; description?: string; parameters?: unknown; promptGuidelines?: string; sourceInfo?: { source?: string; path?: string; origin?: string } }[];
10
+ activeToolNames?: readonly string[];
11
+ commands?: readonly { name: string; description?: string; source?: string; sourceInfo?: { path?: string; source?: string } }[];
12
+ conversation?: readonly unknown[]; ledger?: readonly ContextBudgetComponent[]; planes?: readonly LivePlane[];
13
+ pressure?: ContextPressureDiagnostic;
14
+ }
15
+ export interface ContextBudgetSnapshot { estimator: "chars/4-v1"; capturedAt: number; model?: string; hub: ReturnType<typeof reconcilePlane>; components: ContextBudgetComponent[]; planes: ReturnType<typeof reconcilePlane>[]; usage: Usage; pressure?: ContextPressureDiagnostic; }
16
+
17
+ const chars = (value: unknown) => typeof value === "string" ? value.length : safeSchemaChars(value);
18
+ const entry = (id: string, category: ContextBudgetComponent["category"], label: string, size: number, visibility: ContextBudgetComponent["visibility"] = "model-visible", source?: string) => component({ id, plane: "hub", category, label, source, persistence: "turn", visibility, confidence: "heuristic", chars: size });
19
+ const number = (value: unknown): number | undefined => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
20
+
21
+ function textChars(content: unknown): number {
22
+ if (typeof content === "string") return content.length;
23
+ if (Array.isArray(content)) return content.reduce((sum, part) => sum + (typeof part === "string" ? part.length : typeof part === "object" && part && typeof (part as any).text === "string" ? (part as any).text.length : 0), 0);
24
+ return 0;
25
+ }
26
+ function conversationEntry(entryValue: unknown): { kind?: string; chars: number; usage?: Usage } | undefined {
27
+ const e = entryValue as any;
28
+ if (!e || typeof e !== "object") return undefined;
29
+ if (e.type === "compaction" || e.type === "branch_summary") return { kind: e.type, chars: chars(e.summary), usage: usageFrom(e.usage) };
30
+ if (e.type === "custom_message") return { kind: "custom", chars: textChars(e.content) };
31
+ if (e.type !== "message") return undefined; // custom, label, session/model/thinking changes are not model messages.
32
+ const message = e.message ?? {};
33
+ return { kind: message.role ?? "message", chars: textChars(message.content), usage: usageFrom(message.usage) };
34
+ }
35
+ function usageFrom(value: unknown): Usage | undefined {
36
+ if (!value || typeof value !== "object") return undefined;
37
+ const u = value as Record<string, unknown>;
38
+ const result: Usage = { input: number(u.input), cacheRead: number(u.cacheRead), cacheWrite: number(u.cacheWrite), output: number(u.output), reasoning: number(u.reasoning), cost: number(u.cost), total: number(u.totalTokens) ?? number(u.total) };
39
+ return Object.values(result).some(v => v !== undefined) ? result : undefined;
40
+ }
41
+ function latestUsage(entries: readonly unknown[]): Usage | undefined {
42
+ for (let i = entries.length - 1; i >= 0; i--) { const found = conversationEntry(entries[i])?.usage; if (found) return found; }
43
+ return undefined;
44
+ }
45
+
46
+ /** Metadata-only snapshot: strings are sized immediately and never returned. */
47
+ export function buildContextBudgetSnapshot(input: SnapshotInput): ContextBudgetSnapshot {
48
+ const components: ContextBudgetComponent[] = [...(input.ledger ?? [])];
49
+ if (input.systemPrompt !== undefined && components.length === 0) components.push(entry("hub/final-prompt", "system", "Final Hub system prompt", chars(input.systemPrompt)));
50
+ for (const [key, value] of Object.entries(input.systemPromptOptions ?? {})) {
51
+ if (key === "skills" && Array.isArray(value)) for (const skill of value) { const name = typeof skill === "string" ? skill : String((skill as any)?.name ?? "skill"); components.push(entry(`skill/${name}`, "skill", `Skill: ${name}`, chars(skill), "loaded-excluded", name)); }
52
+ else if ((key === "contextFiles" || key === "promptGuidelines" || key === "toolSnippets") && Array.isArray(value)) {
53
+ for (const item of value) {
54
+ const rec = item as { path?: string; name?: string; content?: string; text?: string } | string;
55
+ const name = typeof rec === "string" ? rec : String(rec.path ?? rec.name ?? key);
56
+ const body = typeof rec === "string" ? rec : rec.content ?? rec.text ?? rec;
57
+ components.push(entry(`pi/${key}/${name}`, "project", `Pi input: ${key} ${name}`, chars(body), "loaded-excluded", name));
58
+ }
59
+ } else if (typeof value === "string" && value) components.push(entry(`pi/${key}`, "project", `Pi input: ${key}`, value.length, "loaded-excluded", key));
60
+ }
61
+ const active = new Set(input.activeToolNames ?? input.tools?.map(tool => tool.name) ?? []);
62
+ for (const tool of input.tools ?? []) if (active.has(tool.name)) components.push(entry(`tool/${tool.name}`, "tool", tool.name, chars({ name: tool.name, description: tool.description, parameters: tool.parameters, promptGuidelines: tool.promptGuidelines }), "model-visible", tool.sourceInfo?.path ?? tool.sourceInfo?.source ?? tool.sourceInfo?.origin));
63
+ for (const command of input.commands ?? []) components.push(entry(`addon/command/${command.name}`, "addon", command.name, chars({ name: command.name, description: command.description }), "ui-only", command.sourceInfo?.path ?? command.sourceInfo?.source ?? command.source));
64
+ const byKind = new Map<string, number>();
65
+ for (const value of input.conversation ?? []) { const e = conversationEntry(value); if (e) byKind.set(e.kind ?? "message", (byKind.get(e.kind ?? "message") ?? 0) + e.chars); }
66
+ for (const [kind, count] of byKind) components.push(entry(`conversation/${kind}`, "conversation", `Conversation: ${kind}`, count));
67
+ const usage = { ...(latestUsage(input.conversation ?? []) ?? {}), ...(input.usage ?? {}) };
68
+ const measured = input.usage?.input ?? input.usage?.total;
69
+ const hub = reconcilePlane(components, "hub", measured, input.window);
70
+ const planes = (input.planes ?? []).map(plane => {
71
+ const projected = plane.projectionParts?.map(part => component({ id: `${plane.id}/${part.id}`, plane: plane.plane, category: part.category, label: part.label, persistence: "projected", visibility: "model-visible", confidence: "heuristic", chars: part.chars })) ?? [component({ id: `${plane.id}/projection`, plane: plane.plane, category: "persona", label: `${plane.label} cold-start projection`, persistence: "projected", visibility: "model-visible", confidence: plane.attribution === "unavailable" ? "unavailable" : "heuristic", chars: plane.projectionChars ?? 0 })];
72
+ const result = reconcilePlane(projected, plane.plane, plane.tokens, plane.window);
73
+ // Pi may report percentage while absolute token count is unavailable. Preserve it without inventing a denominator.
74
+ if (plane.tokens === undefined && number(plane.percent) !== undefined) result.summary.occupancyPercent = number(plane.percent);
75
+ return result;
76
+ });
77
+ return { estimator: "chars/4-v1", capturedAt: Date.now(), model: input.model, hub, components: [...hub.components, ...(hub.residual ? [hub.residual] : [])], planes, usage, pressure: input.pressure };
78
+ }
79
+
80
+ /** Pull only Pi's documented read APIs; no send/compact/session write is used here. */
81
+ export function collectContextBudgetSnapshot(ctx: any, input: Omit<SnapshotInput, "usage" | "systemPrompt" | "systemPromptOptions" | "tools" | "activeToolNames" | "commands" | "conversation" | "window" | "model"> = {}): ContextBudgetSnapshot {
82
+ const read = <T>(fn: (() => T) | undefined, fallback: T): T => { try { return fn ? fn() : fallback; } catch { return fallback; } };
83
+ const contextUsage = read(ctx?.getContextUsage?.bind(ctx), undefined as { tokens?: number | null; contextWindow?: number; percent?: number | null } | undefined);
84
+ // Pi compaction keeps raw session history for persistence, while buildContextEntries
85
+ // is the branch actually supplied to the next model request. Always prefer it.
86
+ const rawEntries = read(ctx?.sessionManager?.buildContextEntries?.bind(ctx.sessionManager), undefined as unknown);
87
+ const entries = Array.isArray(rawEntries)
88
+ ? rawEntries
89
+ : Array.isArray((rawEntries as any)?.entries)
90
+ ? (rawEntries as any).entries
91
+ : read(ctx?.sessionManager?.getEntries?.bind(ctx.sessionManager), [] as unknown[]);
92
+ const measured = contextUsage?.tokens == null ? undefined : contextUsage.tokens;
93
+ return buildContextBudgetSnapshot({
94
+ ...input,
95
+ model: ctx?.model?.id ?? ctx?.model?.modelId,
96
+ window: contextUsage?.contextWindow ?? input.window ?? ctx?.model?.contextWindow,
97
+ usage: measured === undefined ? input.usage : { total: measured, ...input.usage },
98
+ systemPrompt: input.systemPrompt ?? read(ctx?.getSystemPrompt?.bind(ctx), undefined as string | undefined),
99
+ systemPromptOptions: input.systemPromptOptions ?? read(ctx?.getSystemPromptOptions?.bind(ctx), {} as Record<string, unknown>),
100
+ tools: input.tools ?? [],
101
+ activeToolNames: input.activeToolNames ?? [],
102
+ commands: input.commands ?? [],
103
+ conversation: input.conversation ?? entries,
104
+ });
105
+ }
@@ -0,0 +1,191 @@
1
+ export const CONTEXT_WARNING_PERCENT = 80;
2
+ export const AUTO_COMPACT_PERCENT = 90;
3
+
4
+ export type ContextPressure = "unknown" | "normal" | "approaching" | "imminent";
5
+ export type ContextPressurePhase = "normal" | "warning" | "compacting" | "recovered" | "failed";
6
+ export type ContextPressureAction = "none" | "expose-compaction" | "compact-now";
7
+ export type ContextPressureReason =
8
+ | "usage-unknown"
9
+ | "below-warning"
10
+ | "warning-threshold"
11
+ | "automatic-threshold"
12
+ | "single-flight"
13
+ | "recovery-observed"
14
+ | "compaction-succeeded"
15
+ | "compaction-failed";
16
+
17
+ export interface ContextUsageMeasurement {
18
+ tokens: number | null;
19
+ contextWindow: number | null;
20
+ percent: number | null;
21
+ }
22
+
23
+ export type ContextRecoveryOutcome = "none" | "succeeded" | "failed";
24
+
25
+ export interface ContextPressureState {
26
+ phase: ContextPressurePhase;
27
+ pressure: ContextPressure;
28
+ episode: number;
29
+ usage: ContextUsageMeasurement;
30
+ /** Rearmed only after measured usage falls below the warning threshold. */
31
+ autoCompactArmed: boolean;
32
+ lastRecoveryOutcome: ContextRecoveryOutcome;
33
+ lastError: string | null;
34
+ }
35
+
36
+ export interface ContextPressureDiagnostic {
37
+ phase: ContextPressurePhase;
38
+ pressure: ContextPressure;
39
+ episode: number;
40
+ tokens: number | null;
41
+ contextWindow: number | null;
42
+ percent: number | null;
43
+ warningPercent: number;
44
+ automaticPercent: number;
45
+ lastRecoveryOutcome: ContextRecoveryOutcome;
46
+ }
47
+
48
+ export type ContextPressureEvent =
49
+ | { type: "usage"; usage: ContextUsageMeasurement }
50
+ | { type: "compaction-succeeded" }
51
+ | { type: "compaction-failed"; error?: string };
52
+
53
+ export interface ContextPressureDecision {
54
+ state: ContextPressureState;
55
+ action: ContextPressureAction;
56
+ reason: ContextPressureReason;
57
+ }
58
+
59
+ const EMPTY_USAGE: ContextUsageMeasurement = { tokens: null, contextWindow: null, percent: null };
60
+
61
+ export function createContextPressureState(): ContextPressureState {
62
+ return {
63
+ phase: "normal",
64
+ pressure: "unknown",
65
+ episode: 0,
66
+ usage: { ...EMPTY_USAGE },
67
+ autoCompactArmed: true,
68
+ lastRecoveryOutcome: "none",
69
+ lastError: null,
70
+ };
71
+ }
72
+
73
+ function finiteNonNegative(value: number | null): number | null {
74
+ return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
75
+ }
76
+
77
+ function positive(value: number | null): number | null {
78
+ return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : null;
79
+ }
80
+
81
+ function normalizeUsage(input: ContextUsageMeasurement): ContextUsageMeasurement {
82
+ const tokens = finiteNonNegative(input.tokens);
83
+ const contextWindow = positive(input.contextWindow);
84
+ const measuredPercent = finiteNonNegative(input.percent);
85
+ const percent = measuredPercent ?? (tokens !== null && contextWindow !== null ? tokens / contextWindow * 100 : null);
86
+ return { tokens, contextWindow, percent };
87
+ }
88
+
89
+ function pressureFor(percent: number | null): ContextPressure {
90
+ if (percent === null) return "unknown";
91
+ if (percent >= AUTO_COMPACT_PERCENT) return "imminent";
92
+ if (percent >= CONTEXT_WARNING_PERCENT) return "approaching";
93
+ return "normal";
94
+ }
95
+
96
+ export function contextPressureDiagnostic(state: ContextPressureState): ContextPressureDiagnostic {
97
+ return {
98
+ phase: state.phase,
99
+ pressure: state.pressure,
100
+ episode: state.episode,
101
+ tokens: state.usage.tokens,
102
+ contextWindow: state.usage.contextWindow,
103
+ percent: state.usage.percent,
104
+ warningPercent: CONTEXT_WARNING_PERCENT,
105
+ automaticPercent: AUTO_COMPACT_PERCENT,
106
+ lastRecoveryOutcome: state.lastRecoveryOutcome,
107
+ };
108
+ }
109
+
110
+ export function shouldExposeCompaction(state: ContextPressureState): boolean {
111
+ return state.phase !== "normal";
112
+ }
113
+
114
+ export function transitionContextPressure(
115
+ state: ContextPressureState,
116
+ event: ContextPressureEvent,
117
+ ): ContextPressureDecision {
118
+ if (event.type === "compaction-succeeded") {
119
+ return {
120
+ state: { ...state, phase: "recovered", lastRecoveryOutcome: "succeeded", lastError: null },
121
+ action: "none",
122
+ reason: "compaction-succeeded",
123
+ };
124
+ }
125
+ if (event.type === "compaction-failed") {
126
+ return {
127
+ state: { ...state, phase: "failed", autoCompactArmed: false, lastRecoveryOutcome: "failed", lastError: event.error?.trim() || "compaction failed" },
128
+ action: "none",
129
+ reason: "compaction-failed",
130
+ };
131
+ }
132
+
133
+ const usage = normalizeUsage(event.usage);
134
+ const pressure = pressureFor(usage.percent);
135
+ if (pressure === "unknown") {
136
+ return {
137
+ state: { ...state, pressure, usage },
138
+ action: "none",
139
+ reason: "usage-unknown",
140
+ };
141
+ }
142
+
143
+ if (pressure === "normal") {
144
+ return {
145
+ state: {
146
+ ...state,
147
+ phase: "normal",
148
+ pressure,
149
+ usage,
150
+ autoCompactArmed: true,
151
+ lastError: null,
152
+ },
153
+ action: "none",
154
+ reason: state.phase === "normal" ? "below-warning" : "recovery-observed",
155
+ };
156
+ }
157
+
158
+ const enteringEpisode = state.pressure === "normal" || state.pressure === "unknown";
159
+ const episode = state.episode + (enteringEpisode ? 1 : 0);
160
+
161
+ if (state.phase === "compacting" || !state.autoCompactArmed) {
162
+ return {
163
+ state: { ...state, pressure, usage, episode },
164
+ action: "none",
165
+ reason: "single-flight",
166
+ };
167
+ }
168
+
169
+ if (pressure === "imminent") {
170
+ return {
171
+ state: {
172
+ ...state,
173
+ phase: "compacting",
174
+ pressure,
175
+ usage,
176
+ episode,
177
+ autoCompactArmed: false,
178
+ lastError: null,
179
+ },
180
+ action: "compact-now",
181
+ reason: "automatic-threshold",
182
+ };
183
+ }
184
+
185
+ const enteringWarning = state.phase !== "warning";
186
+ return {
187
+ state: { ...state, phase: "warning", pressure, usage, episode, lastError: null },
188
+ action: enteringWarning ? "expose-compaction" : "none",
189
+ reason: "warning-threshold",
190
+ };
191
+ }
@@ -2,7 +2,7 @@
2
2
  //
3
3
  // The bug this fixes: the hub measured EVERY specialist and research helper
4
4
  // against `ctx.model.contextWindow` — the DISPATCHER's window. A specialist on
5
- // custom/Qwen3.6-35B-A3B-4bit (49152) and one on a 400k hosted model were
5
+ // custom/Qwen3.8-27B-Uncensored-MLX-4bit (49152) and one on a 400k hosted model were
6
6
  // divided by the same number, so `⚠ Planner context at 315%` could mean either
7
7
  // "the window is wrong for that provider" or "the run really did run 3× over",
8
8
  // and nothing in the output told them apart.
@@ -18,11 +18,18 @@ export function normalizeWatchdogSetting(value) {
18
18
  }
19
19
 
20
20
  /**
21
- * Is the watchdog armed for one dispatch? Precedence: the dispatch_agent
22
- * `watchdog` param (boolean) > the per-agent /af-watchdog override ("on"/"off")
23
- * > the hub-wide setting ("on"/"auto" arm, "off" disarms).
21
+ * Is the watchdog armed for one dispatch?
22
+ * Operator (or omitted posture): dispatch param > per-agent /af-watchdog
23
+ * override ("on"/"off") > hub-wide setting ("on"/"auto" arm, "off" disarms).
24
+ * Orchestrator: hub `off` or per-agent `off` still disarms; otherwise armed.
25
+ * A specialist cannot pass `watchdog: false` to sneak around orchestrator.
24
26
  */
25
- export function resolveWatchdogActive(dispatchParam, agentOverride, hubSetting) {
27
+ export function resolveWatchdogActive(dispatchParam, agentOverride, hubSetting, posture) {
28
+ if (posture === "orchestrator") {
29
+ if (normalizeWatchdogSetting(hubSetting) === "off") return false;
30
+ if (agentOverride === "off") return false;
31
+ return true;
32
+ }
26
33
  if (dispatchParam === true) return true;
27
34
  if (dispatchParam === false) return false;
28
35
  if (agentOverride === "on") return true;