@chankov/agent-fleet 1.0.0 → 1.0.2

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 (598) hide show
  1. package/.pi/agents/model-profiles.yaml +2 -2
  2. package/.pi/extensions/package-lock.json +77 -45
  3. package/.pi/harnesses/agent-hub/README.md +116 -16
  4. package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  5. package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  6. package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  7. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  8. package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  9. package/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  10. package/.pi/harnesses/agent-hub/index.ts +1095 -465
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  13. package/.pi/harnesses/agent-hub/run-budget.js +73 -13
  14. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  15. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  16. package/.pi/harnesses/coms/package.json +1 -1
  17. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  18. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  19. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  20. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  21. package/.pi/harnesses/lib/context-budget.ts +114 -0
  22. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
  23. package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
  24. package/.pi/harnesses/package-lock.json +73 -80
  25. package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  26. package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
  27. package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
  28. package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
  29. package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
  30. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  31. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  32. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  33. package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
  34. package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
  35. package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
  36. package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
  37. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  38. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  39. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  40. package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  41. package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  42. package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  43. package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  44. package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  45. package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  46. package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
  47. package/.versions/1.0.1/.pi/extensions/package.json +9 -0
  48. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  49. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  50. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  51. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  52. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  53. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  54. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  55. package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
  56. package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  57. package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  58. package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  59. package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  60. package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  61. package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
  62. package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  63. package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  64. package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  66. package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
  67. package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  68. package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  69. package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
  70. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  71. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  72. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  73. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  74. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  75. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  76. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  77. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  78. package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  79. package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  80. package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
  81. package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  82. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  83. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  84. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  85. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  86. package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  87. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
  88. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  89. package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  90. package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  91. package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  92. package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
  93. package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  94. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  95. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
  96. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  97. package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
  98. package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
  99. package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
  100. package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
  101. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  102. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  103. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  104. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  105. package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  106. package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  107. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  108. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  109. package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  110. package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  111. package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  112. package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  113. package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  114. package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  115. package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  116. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  117. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  118. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  119. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  120. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  121. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  122. package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  123. package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
  124. package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
  125. package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
  126. package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
  127. package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
  128. package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
  129. package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  130. package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  131. package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
  132. package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
  133. package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
  134. package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
  135. package/.versions/1.0.1/.version +1 -0
  136. package/.versions/1.0.1/agents/architect.md +24 -0
  137. package/.versions/1.0.1/agents/bowser.md +27 -0
  138. package/.versions/1.0.1/agents/builder.md +54 -0
  139. package/.versions/1.0.1/agents/code-reviewer.md +208 -0
  140. package/.versions/1.0.1/agents/deep-researcher.md +32 -0
  141. package/.versions/1.0.1/agents/documenter.md +18 -0
  142. package/.versions/1.0.1/agents/orchestrator.md +72 -0
  143. package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
  144. package/.versions/1.0.1/agents/planner.md +70 -0
  145. package/.versions/1.0.1/agents/releaser.md +24 -0
  146. package/.versions/1.0.1/agents/researcher.md +28 -0
  147. package/.versions/1.0.1/agents/security-auditor.md +167 -0
  148. package/.versions/1.0.1/agents/test-engineer.md +153 -0
  149. package/.versions/1.0.1/agents/web-debugger.md +43 -0
  150. package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
  151. package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  152. package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
  153. package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
  154. package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
  155. package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
  156. package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
  157. package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
  158. package/.versions/1.0.1/docs/getting-started.md +98 -0
  159. package/.versions/1.0.1/docs/npm-install.md +292 -0
  160. package/.versions/1.0.1/docs/pi-extensions.md +412 -0
  161. package/.versions/1.0.1/docs/pi-setup.md +74 -0
  162. package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
  163. package/.versions/1.0.1/hermes/README.md +347 -0
  164. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  165. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  166. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  167. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  168. package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
  169. package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  170. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  171. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  172. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  173. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  174. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  175. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  176. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  177. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  178. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  179. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  180. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  181. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  182. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  183. package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  184. package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  185. package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  186. package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  187. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  188. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  189. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  190. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  191. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  192. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  193. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  194. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  195. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  196. package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
  197. package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
  198. package/.versions/1.0.1/install-manifest.json +2745 -0
  199. package/.versions/1.0.1/justfile +272 -0
  200. package/.versions/1.0.1/manifest-meta.json +882 -0
  201. package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
  202. package/.versions/1.0.1/references/definition-of-done.md +67 -0
  203. package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
  204. package/.versions/1.0.1/references/observability-checklist.md +91 -0
  205. package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
  206. package/.versions/1.0.1/references/performance-checklist.md +153 -0
  207. package/.versions/1.0.1/references/prompting-patterns.md +380 -0
  208. package/.versions/1.0.1/references/security-checklist.md +179 -0
  209. package/.versions/1.0.1/references/testing-patterns.md +236 -0
  210. package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
  211. package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
  212. package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
  213. package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
  214. package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
  215. package/.versions/1.0.1/scripts/fleet.ts +185 -0
  216. package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  217. package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  218. package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  219. package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
  220. package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  221. package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
  222. package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
  223. package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
  224. package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  225. package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
  226. package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
  227. package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  228. package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  229. package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  230. package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  231. package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  232. package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  233. package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  234. package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
  235. package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
  236. package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
  237. package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
  238. package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
  239. package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
  240. package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
  241. package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
  242. package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
  243. package/.versions/1.0.1/scripts/team-up.ts +406 -0
  244. package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
  245. package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  246. package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  247. package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
  248. package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
  249. package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  250. package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
  251. package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  252. package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  253. package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  254. package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
  255. package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
  256. package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
  257. package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  258. package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  259. package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
  260. package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
  261. package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
  262. package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
  263. package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
  264. package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
  265. package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
  266. package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
  267. package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
  268. package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  269. package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  270. package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
  271. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  272. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  273. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  274. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  275. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  276. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  277. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  278. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  279. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  280. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  281. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  282. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  283. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  284. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  285. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  286. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  287. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  288. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  289. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  290. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  291. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  292. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  293. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  294. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  295. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  296. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  297. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  298. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  299. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  300. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  301. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  302. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  303. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  304. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  305. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  306. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  307. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  308. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  309. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  310. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  311. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  312. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  313. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  314. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  315. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  316. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  317. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  318. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  319. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  320. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  321. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  322. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  323. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  324. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  325. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  326. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  327. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  328. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  329. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  330. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  331. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  332. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  333. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  334. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  335. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  336. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  337. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  338. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  339. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  340. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  341. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  342. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  343. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  344. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  345. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  346. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  347. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  348. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  349. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  350. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  351. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  352. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  353. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  354. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  355. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  356. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  357. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  358. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  359. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  360. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  361. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  362. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  363. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  364. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  365. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  366. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  367. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  368. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  369. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  370. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  371. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  372. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  373. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  374. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  375. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  376. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  377. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  378. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  379. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  380. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  381. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  382. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  383. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  384. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  385. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  386. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  387. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  388. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  389. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  390. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  391. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  392. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  393. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  394. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  395. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  396. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  397. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  398. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  399. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  400. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  401. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  402. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  403. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  404. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  405. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  406. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  407. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  408. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  409. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  410. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  411. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  412. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  413. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  414. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  415. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  416. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  417. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  418. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  419. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  420. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  421. package/.versions/1.0.2/.version +1 -0
  422. package/.versions/1.0.2/agents/architect.md +24 -0
  423. package/.versions/1.0.2/agents/bowser.md +27 -0
  424. package/.versions/1.0.2/agents/builder.md +54 -0
  425. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  426. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  427. package/.versions/1.0.2/agents/documenter.md +18 -0
  428. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  429. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  430. package/.versions/1.0.2/agents/planner.md +70 -0
  431. package/.versions/1.0.2/agents/releaser.md +24 -0
  432. package/.versions/1.0.2/agents/researcher.md +28 -0
  433. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  434. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  435. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  436. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  437. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  438. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  439. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  440. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  441. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  442. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  443. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  444. package/.versions/1.0.2/docs/getting-started.md +98 -0
  445. package/.versions/1.0.2/docs/npm-install.md +292 -0
  446. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  447. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  448. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  449. package/.versions/1.0.2/hermes/README.md +347 -0
  450. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  451. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  452. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  453. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  454. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  455. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  456. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  457. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  458. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  459. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  460. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  461. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  462. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  463. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  464. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  465. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  466. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  467. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  468. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  469. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  470. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  471. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  472. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  473. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  474. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  475. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  476. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  477. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  478. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  479. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  480. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  481. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  482. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  483. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  484. package/.versions/1.0.2/install-manifest.json +2745 -0
  485. package/.versions/1.0.2/justfile +272 -0
  486. package/.versions/1.0.2/manifest-meta.json +882 -0
  487. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  488. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  489. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  490. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  491. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  492. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  493. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  494. package/.versions/1.0.2/references/security-checklist.md +179 -0
  495. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  496. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  497. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  498. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  499. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  500. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  501. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  502. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  503. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  504. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  505. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  506. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  507. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  508. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  509. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  510. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  511. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  512. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  513. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  514. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  515. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  516. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  517. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  518. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  519. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  520. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  521. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  522. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  523. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  524. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  525. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  526. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  527. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  528. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  529. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  530. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  531. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  532. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  533. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  534. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  535. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  536. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  537. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  538. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  539. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  540. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  541. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  542. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  543. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  544. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  545. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  546. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  547. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  548. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  549. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  550. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  551. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  552. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  553. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  554. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  555. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  556. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  557. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  558. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  559. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  560. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  561. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  562. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  563. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  564. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  565. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  566. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  567. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  568. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  569. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  570. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  571. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  572. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  573. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  574. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  575. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  576. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  577. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  578. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  579. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  580. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  581. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  582. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  583. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  584. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  585. package/CHANGELOG.md +15 -0
  586. package/README.md +4 -2
  587. package/agents/code-reviewer.md +1 -1
  588. package/agents/deep-researcher.md +1 -1
  589. package/agents/orchestrator.md +4 -56
  590. package/agents/plan-reviewer.md +1 -1
  591. package/agents/planner.md +1 -1
  592. package/agents/security-auditor.md +1 -1
  593. package/agents/test-engineer.md +1 -1
  594. package/docs/ARCHITECTURE.md +48 -16
  595. package/docs/agent-fleet-setup.md +33 -2
  596. package/docs/pi-extensions.md +29 -2
  597. package/install-manifest.json +2 -2
  598. package/package.json +2 -2
@@ -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
+ }
@@ -0,0 +1,73 @@
1
+ // Pure, allowlisted serializers for Hub mode/task lifecycle audit entries.
2
+ // Callers provide only runtime identity fields; unknown properties are ignored.
3
+
4
+ function text(value, max = 4096) {
5
+ if (typeof value !== "string") return null;
6
+ const clean = value.replace(/[\r\n]+/g, " ").trim();
7
+ return clean ? clean.slice(0, max) : null;
8
+ }
9
+
10
+ function count(value) {
11
+ return Number.isFinite(value) ? Math.max(0, Math.round(value)) : 0;
12
+ }
13
+
14
+ /** Return only non-secret process/session routing identity. */
15
+ export function buildHubAuditIdentity(input = {}) {
16
+ return {
17
+ cwd: text(input.cwd),
18
+ pid: count(input.pid),
19
+ session_id: text(input.sessionId, 256),
20
+ project: text(input.project, 256),
21
+ herdr_workspace_id: text(input.workspaceId, 256),
22
+ herdr_pane_id: text(input.paneId, 256),
23
+ };
24
+ }
25
+
26
+ export function buildHubModeAudit(input = {}) {
27
+ return {
28
+ schema_version: 1,
29
+ previous_mode: text(input.previousMode, 32),
30
+ mode: text(input.mode, 32),
31
+ source: text(input.source, 64),
32
+ override_file: text(input.overrideFile),
33
+ task_tier: text(input.taskTier, 32),
34
+ turn_dispatches: count(input.turnDispatches),
35
+ turn_research: count(input.turnResearch),
36
+ identity: buildHubAuditIdentity(input.identity),
37
+ };
38
+ }
39
+
40
+ export function buildTaskResetAudit(input = {}) {
41
+ const prior = input.prior ?? {};
42
+ return {
43
+ schema_version: 1,
44
+ source: text(input.source, 64),
45
+ label: text(input.label, 160),
46
+ prior: {
47
+ tier: text(prior.tier, 32),
48
+ dispatches: count(prior.dispatches),
49
+ research: count(prior.research),
50
+ review_rounds: count(prior.reviewRounds),
51
+ active_ms: count(prior.activeMs),
52
+ },
53
+ identity: buildHubAuditIdentity(input.identity),
54
+ };
55
+ }
56
+
57
+ export function buildBudgetContinuationAudit(input = {}) {
58
+ const prior = input.prior ?? {};
59
+ return {
60
+ schema_version: 1,
61
+ kind: text(input.kind, 16),
62
+ continuation: count(input.continuation),
63
+ reason: text(input.reason, 64),
64
+ prior: {
65
+ tier: text(prior.tier, 32),
66
+ dispatches: count(prior.dispatches),
67
+ research: count(prior.research),
68
+ review_rounds: count(prior.reviewRounds),
69
+ active_ms: count(prior.activeMs),
70
+ },
71
+ identity: buildHubAuditIdentity(input.identity),
72
+ };
73
+ }