@chankov/agent-fleet 1.0.1 → 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 (316) hide show
  1. package/.pi/extensions/package-lock.json +77 -45
  2. package/.pi/harnesses/agent-hub/README.md +109 -18
  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/hub-state-audit.js +18 -0
  9. package/.pi/harnesses/agent-hub/index.ts +988 -422
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  12. package/.pi/harnesses/agent-hub/run-budget.js +12 -13
  13. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  14. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  15. package/.pi/harnesses/coms/package.json +1 -1
  16. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  17. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  18. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  19. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  20. package/.pi/harnesses/lib/context-budget.ts +114 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
  22. package/.pi/harnesses/package-lock.json +73 -80
  23. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  25. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  26. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  27. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  28. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  29. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  30. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  31. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  32. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  33. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  34. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  35. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  36. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  37. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  38. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  39. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  40. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  41. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  42. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  43. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  44. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  45. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  46. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  47. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  48. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  49. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  50. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  51. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  52. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  53. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  54. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  55. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  56. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  57. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  58. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  59. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  60. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  61. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  62. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  63. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  64. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  65. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  66. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  67. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  68. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  69. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  70. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  71. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  72. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  73. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  74. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  75. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  76. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  77. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  78. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  79. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  80. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  81. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  82. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  83. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  84. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  85. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  86. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  87. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  88. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  89. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  90. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  91. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  92. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  93. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  94. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  95. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  96. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  97. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  98. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  99. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  100. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  101. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  102. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  103. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  104. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  105. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  106. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  107. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  108. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  109. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  110. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  111. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  112. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  113. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  114. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  115. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  116. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  117. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  118. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  119. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  120. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  121. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  122. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  123. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  124. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  125. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  126. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  127. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  128. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  129. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  130. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  131. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  132. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  133. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  134. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  135. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  136. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  137. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  138. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  139. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  140. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  141. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  142. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  143. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  144. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  145. package/.versions/1.0.2/.version +1 -0
  146. package/.versions/1.0.2/agents/architect.md +24 -0
  147. package/.versions/1.0.2/agents/bowser.md +27 -0
  148. package/.versions/1.0.2/agents/builder.md +54 -0
  149. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  150. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  151. package/.versions/1.0.2/agents/documenter.md +18 -0
  152. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  153. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  154. package/.versions/1.0.2/agents/planner.md +70 -0
  155. package/.versions/1.0.2/agents/releaser.md +24 -0
  156. package/.versions/1.0.2/agents/researcher.md +28 -0
  157. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  158. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  159. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  160. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  161. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  162. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  163. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  164. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  165. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  166. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  167. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  168. package/.versions/1.0.2/docs/getting-started.md +98 -0
  169. package/.versions/1.0.2/docs/npm-install.md +292 -0
  170. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  171. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  172. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  173. package/.versions/1.0.2/hermes/README.md +347 -0
  174. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  175. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  176. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  177. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  178. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  179. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  180. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  181. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  182. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  183. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  184. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  185. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  186. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  187. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  188. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  189. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  190. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  191. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  192. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  193. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  194. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  195. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  196. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  197. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  198. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  199. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  200. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  201. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  202. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  203. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  204. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  205. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  206. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  207. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  208. package/.versions/1.0.2/install-manifest.json +2745 -0
  209. package/.versions/1.0.2/justfile +272 -0
  210. package/.versions/1.0.2/manifest-meta.json +882 -0
  211. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  212. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  213. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  214. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  215. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  216. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  217. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  218. package/.versions/1.0.2/references/security-checklist.md +179 -0
  219. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  220. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  221. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  222. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  223. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  224. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  225. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  226. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  227. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  228. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  229. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  230. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  231. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  232. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  233. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  234. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  235. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  236. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  237. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  238. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  239. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  240. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  241. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  242. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  243. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  244. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  245. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  246. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  247. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  248. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  249. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  250. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  251. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  252. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  253. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  254. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  255. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  256. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  257. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  258. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  259. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  260. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  261. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  262. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  263. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  264. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  265. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  266. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  267. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  268. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  269. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  270. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  271. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  272. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  273. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  274. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  275. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  276. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  277. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  278. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  279. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  280. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  281. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  282. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  283. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  284. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  285. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  286. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  287. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  288. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  289. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  290. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  291. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  292. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  293. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  294. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  295. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  299. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  300. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  301. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  302. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  303. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  304. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  305. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  306. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  307. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  308. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  309. package/CHANGELOG.md +9 -0
  310. package/README.md +4 -2
  311. package/agents/orchestrator.md +4 -56
  312. package/docs/ARCHITECTURE.md +48 -16
  313. package/docs/agent-fleet-setup.md +33 -2
  314. package/docs/pi-extensions.md +29 -2
  315. package/install-manifest.json +2 -2
  316. 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
+ }
@@ -53,3 +53,21 @@ export function buildTaskResetAudit(input = {}) {
53
53
  identity: buildHubAuditIdentity(input.identity),
54
54
  };
55
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
+ }