@chankov/agent-fleet 2.0.15 → 2.0.16

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 (565) hide show
  1. package/.pi/harnesses/agent-hub/README.md +5 -1
  2. package/.pi/harnesses/agent-hub/config/overrides.ts +1 -6
  3. package/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +4 -15
  4. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +8 -7
  5. package/.pi/harnesses/agent-hub/index.ts +10 -6
  6. package/.pi/harnesses/agent-hub/package.json +1 -1
  7. package/.pi/harnesses/agent-hub/proactive-config.ts +11 -35
  8. package/.pi/harnesses/agent-hub/proactive-local.ts +1 -18
  9. package/.pi/harnesses/agent-hub/system1-runtime.ts +7 -29
  10. package/.pi/harnesses/agent-hub/task-triage-config.ts +8 -16
  11. package/.pi/harnesses/agent-hub/task-triage-contract.ts +1 -6
  12. package/.pi/harnesses/coms/package.json +1 -1
  13. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  14. package/.pi/harnesses/lib/system1/config-json.js +37 -0
  15. package/.pi/harnesses/lib/system1/config-loader.js +44 -0
  16. package/.pi/harnesses/lib/system1/config-proactive.js +57 -0
  17. package/.pi/harnesses/lib/system1/config-triage.js +42 -0
  18. package/.pi/harnesses/lib/system1/config-v2.js +100 -0
  19. package/.pi/harnesses/lib/system1/config.js +7 -18
  20. package/.pi/harnesses/lib/system1/contracts.ts +4 -2
  21. package/.pi/harnesses/lib/system1/demo.ts +3 -12
  22. package/.versions/2.0.16/.pi/agent-fleet/hermes/README.md +347 -0
  23. package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  24. package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  25. package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  26. package/.versions/2.0.16/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  27. package/.versions/2.0.16/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  28. package/.versions/2.0.16/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  29. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  30. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  31. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  32. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  33. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  34. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  35. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  36. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  37. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  38. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  39. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  40. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  41. package/.versions/2.0.16/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  42. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  43. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  44. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  45. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  46. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  47. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  48. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  49. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  50. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  51. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  52. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  53. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  54. package/.versions/2.0.16/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  55. package/.versions/2.0.16/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  56. package/.versions/2.0.16/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  57. package/.versions/2.0.16/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  58. package/.versions/2.0.16/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  59. package/.versions/2.0.16/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  60. package/.versions/2.0.16/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  61. package/.versions/2.0.16/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  62. package/.versions/2.0.16/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  63. package/.versions/2.0.16/.pi/agent-fleet/scripts/fleet.ts +217 -0
  64. package/.versions/2.0.16/.pi/agent-fleet/scripts/flow.ts +157 -0
  65. package/.versions/2.0.16/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  66. package/.versions/2.0.16/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  67. package/.versions/2.0.16/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  68. package/.versions/2.0.16/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  69. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  70. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  71. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  72. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  73. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  74. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  75. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  76. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  77. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  78. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  79. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  80. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  81. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  82. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  83. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  84. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  85. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  86. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  87. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  88. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  89. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  90. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  91. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  92. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  93. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  94. package/.versions/2.0.16/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  95. package/.versions/2.0.16/.pi/agent-fleet/scripts/package-lock.json +35 -0
  96. package/.versions/2.0.16/.pi/agent-fleet/scripts/package.json +9 -0
  97. package/.versions/2.0.16/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  98. package/.versions/2.0.16/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  99. package/.versions/2.0.16/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  100. package/.versions/2.0.16/.pi/agent-fleet/scripts/team-up.ts +378 -0
  101. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  102. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  103. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  104. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  105. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  106. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  107. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  108. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  109. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  110. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  111. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  112. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  113. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  114. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  115. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  116. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  117. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  118. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  119. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  120. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  121. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  122. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  123. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  124. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  125. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  126. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  127. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  128. package/.versions/2.0.16/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  129. package/.versions/2.0.16/.pi/agents/dispatch-policy.yaml +32 -0
  130. package/.versions/2.0.16/.pi/agents/model-profiles.yaml +134 -0
  131. package/.versions/2.0.16/.pi/agents/peers.yaml +147 -0
  132. package/.versions/2.0.16/.pi/agents/teams.yaml +41 -0
  133. package/.versions/2.0.16/.pi/agents/voices.yaml +13 -0
  134. package/.versions/2.0.16/.pi/damage-control-rules.yaml +297 -0
  135. package/.versions/2.0.16/.pi/extensions/btw/README.md +120 -0
  136. package/.versions/2.0.16/.pi/extensions/btw/index.ts +914 -0
  137. package/.versions/2.0.16/.pi/extensions/btw/package.json +6 -0
  138. package/.versions/2.0.16/.pi/extensions/btw/state.js +179 -0
  139. package/.versions/2.0.16/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  140. package/.versions/2.0.16/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  141. package/.versions/2.0.16/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  142. package/.versions/2.0.16/.pi/extensions/compact-and-continue/README.md +42 -0
  143. package/.versions/2.0.16/.pi/extensions/compact-and-continue/index.ts +120 -0
  144. package/.versions/2.0.16/.pi/extensions/compact-and-continue/package.json +6 -0
  145. package/.versions/2.0.16/.pi/extensions/mcp-bridge/README.md +46 -0
  146. package/.versions/2.0.16/.pi/extensions/mcp-bridge/index.ts +206 -0
  147. package/.versions/2.0.16/.pi/extensions/mcp-bridge/package.json +6 -0
  148. package/.versions/2.0.16/.pi/extensions/package-lock.json +1175 -0
  149. package/.versions/2.0.16/.pi/extensions/package.json +9 -0
  150. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/README.md +224 -0
  151. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/config.ts +198 -0
  152. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  153. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/index.ts +248 -0
  154. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/package.json +6 -0
  155. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  156. package/.versions/2.0.16/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  157. package/.versions/2.0.16/.pi/harnesses/agent-hub/README.md +1452 -0
  158. package/.versions/2.0.16/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  159. package/.versions/2.0.16/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  160. package/.versions/2.0.16/.pi/harnesses/agent-hub/artifacts.js +146 -0
  161. package/.versions/2.0.16/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  162. package/.versions/2.0.16/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  163. package/.versions/2.0.16/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  164. package/.versions/2.0.16/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  165. package/.versions/2.0.16/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  166. package/.versions/2.0.16/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  167. package/.versions/2.0.16/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  168. package/.versions/2.0.16/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  169. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  170. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  171. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  172. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  173. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  174. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  175. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  176. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  177. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  178. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  179. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  180. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  181. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  182. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  183. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  184. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  185. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  186. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  187. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  188. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  189. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  190. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  191. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  192. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  193. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  194. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  195. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  196. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  197. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  198. package/.versions/2.0.16/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  199. package/.versions/2.0.16/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  200. package/.versions/2.0.16/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  201. package/.versions/2.0.16/.pi/harnesses/agent-hub/config/overrides.ts +155 -0
  202. package/.versions/2.0.16/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  203. package/.versions/2.0.16/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  204. package/.versions/2.0.16/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  205. package/.versions/2.0.16/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  206. package/.versions/2.0.16/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  207. package/.versions/2.0.16/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  208. package/.versions/2.0.16/.pi/harnesses/agent-hub/context-window.js +108 -0
  209. package/.versions/2.0.16/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  210. package/.versions/2.0.16/.pi/harnesses/agent-hub/delegate.ts +467 -0
  211. package/.versions/2.0.16/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
  212. package/.versions/2.0.16/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  213. package/.versions/2.0.16/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  214. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  215. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  216. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  217. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
  218. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  219. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
  220. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  221. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  222. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  223. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  224. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  225. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  226. package/.versions/2.0.16/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  227. package/.versions/2.0.16/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  228. package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  229. package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  230. package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  231. package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  232. package/.versions/2.0.16/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  233. package/.versions/2.0.16/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  234. package/.versions/2.0.16/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  235. package/.versions/2.0.16/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  236. package/.versions/2.0.16/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  237. package/.versions/2.0.16/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
  238. package/.versions/2.0.16/.pi/harnesses/agent-hub/fixtures/registration-surface.json +64 -0
  239. package/.versions/2.0.16/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  240. package/.versions/2.0.16/.pi/harnesses/agent-hub/footer.ts +30 -0
  241. package/.versions/2.0.16/.pi/harnesses/agent-hub/helpers.ts +270 -0
  242. package/.versions/2.0.16/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  243. package/.versions/2.0.16/.pi/harnesses/agent-hub/index.ts +2601 -0
  244. package/.versions/2.0.16/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  245. package/.versions/2.0.16/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  246. package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  247. package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  248. package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  249. package/.versions/2.0.16/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  250. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  251. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  252. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  253. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  254. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  255. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  256. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  257. package/.versions/2.0.16/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  258. package/.versions/2.0.16/.pi/harnesses/agent-hub/no-progress.ts +563 -0
  259. package/.versions/2.0.16/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  260. package/.versions/2.0.16/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  261. package/.versions/2.0.16/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  262. package/.versions/2.0.16/.pi/harnesses/agent-hub/package.json +7 -0
  263. package/.versions/2.0.16/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  264. package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  265. package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  266. package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  267. package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  268. package/.versions/2.0.16/.pi/harnesses/agent-hub/policy/work-mode.ts +135 -0
  269. package/.versions/2.0.16/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  270. package/.versions/2.0.16/.pi/harnesses/agent-hub/presentation.ts +48 -0
  271. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-config.ts +16 -0
  272. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  273. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  274. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  275. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-local.ts +71 -0
  276. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  277. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  278. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  279. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  280. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  281. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  282. package/.versions/2.0.16/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  283. package/.versions/2.0.16/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  284. package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  285. package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/fragments.ts +116 -0
  286. package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  287. package/.versions/2.0.16/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  288. package/.versions/2.0.16/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  289. package/.versions/2.0.16/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  290. package/.versions/2.0.16/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  291. package/.versions/2.0.16/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  292. package/.versions/2.0.16/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  293. package/.versions/2.0.16/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  294. package/.versions/2.0.16/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  295. package/.versions/2.0.16/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
  296. package/.versions/2.0.16/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
  297. package/.versions/2.0.16/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  298. package/.versions/2.0.16/.pi/harnesses/agent-hub/return-contract.js +349 -0
  299. package/.versions/2.0.16/.pi/harnesses/agent-hub/return-extract.js +77 -0
  300. package/.versions/2.0.16/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  301. package/.versions/2.0.16/.pi/harnesses/agent-hub/review-findings.js +104 -0
  302. package/.versions/2.0.16/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  303. package/.versions/2.0.16/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  304. package/.versions/2.0.16/.pi/harnesses/agent-hub/run-budget.js +554 -0
  305. package/.versions/2.0.16/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  306. package/.versions/2.0.16/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  307. package/.versions/2.0.16/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  308. package/.versions/2.0.16/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  309. package/.versions/2.0.16/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  310. package/.versions/2.0.16/.pi/harnesses/agent-hub/session-health.js +110 -0
  311. package/.versions/2.0.16/.pi/harnesses/agent-hub/session-start.ts +42 -0
  312. package/.versions/2.0.16/.pi/harnesses/agent-hub/spawn.ts +534 -0
  313. package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  314. package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-communication-store.ts +129 -0
  315. package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  316. package/.versions/2.0.16/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  317. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  318. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  319. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  320. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  321. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  322. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  323. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  324. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  325. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  326. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  327. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  328. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  329. package/.versions/2.0.16/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  330. package/.versions/2.0.16/.pi/harnesses/agent-hub/timeline.ts +72 -0
  331. package/.versions/2.0.16/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  332. package/.versions/2.0.16/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  333. package/.versions/2.0.16/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  334. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
  335. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  336. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  337. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  338. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
  339. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  340. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  341. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  342. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  343. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  344. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  345. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  346. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  347. package/.versions/2.0.16/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  348. package/.versions/2.0.16/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  349. package/.versions/2.0.16/.pi/harnesses/agent-hub/types.ts +66 -0
  350. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  351. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  352. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  353. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  354. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  355. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  356. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  357. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  358. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  359. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  360. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  361. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  362. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  363. package/.versions/2.0.16/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  364. package/.versions/2.0.16/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  365. package/.versions/2.0.16/.pi/harnesses/agent-hub/version.ts +42 -0
  366. package/.versions/2.0.16/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  367. package/.versions/2.0.16/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  368. package/.versions/2.0.16/.pi/harnesses/agent-hub/work-mode.ts +179 -0
  369. package/.versions/2.0.16/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  370. package/.versions/2.0.16/.pi/harnesses/ask-user-remote/README.md +59 -0
  371. package/.versions/2.0.16/.pi/harnesses/ask-user-remote/index.ts +558 -0
  372. package/.versions/2.0.16/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  373. package/.versions/2.0.16/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  374. package/.versions/2.0.16/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  375. package/.versions/2.0.16/.pi/harnesses/coms/README.md +100 -0
  376. package/.versions/2.0.16/.pi/harnesses/coms/index.ts +282 -0
  377. package/.versions/2.0.16/.pi/harnesses/coms/package.json +7 -0
  378. package/.versions/2.0.16/.pi/harnesses/coms/version.ts +42 -0
  379. package/.versions/2.0.16/.pi/harnesses/damage-control-continue/README.md +135 -0
  380. package/.versions/2.0.16/.pi/harnesses/damage-control-continue/index.ts +550 -0
  381. package/.versions/2.0.16/.pi/harnesses/damage-control-continue/package.json +7 -0
  382. package/.versions/2.0.16/.pi/harnesses/damage-control-continue/version.ts +42 -0
  383. package/.versions/2.0.16/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  384. package/.versions/2.0.16/.pi/harnesses/lib/coms-core-io.ts +385 -0
  385. package/.versions/2.0.16/.pi/harnesses/lib/coms-core.ts +577 -0
  386. package/.versions/2.0.16/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  387. package/.versions/2.0.16/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  388. package/.versions/2.0.16/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  389. package/.versions/2.0.16/.pi/harnesses/lib/context-budget-view.ts +107 -0
  390. package/.versions/2.0.16/.pi/harnesses/lib/context-budget.ts +114 -0
  391. package/.versions/2.0.16/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  392. package/.versions/2.0.16/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  393. package/.versions/2.0.16/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  394. package/.versions/2.0.16/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  395. package/.versions/2.0.16/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  396. package/.versions/2.0.16/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  397. package/.versions/2.0.16/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  398. package/.versions/2.0.16/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  399. package/.versions/2.0.16/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  400. package/.versions/2.0.16/.pi/harnesses/lib/fleet-panel.ts +34 -0
  401. package/.versions/2.0.16/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  402. package/.versions/2.0.16/.pi/harnesses/lib/fleet-selection.ts +24 -0
  403. package/.versions/2.0.16/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  404. package/.versions/2.0.16/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  405. package/.versions/2.0.16/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  406. package/.versions/2.0.16/.pi/harnesses/lib/herdr-client.ts +472 -0
  407. package/.versions/2.0.16/.pi/harnesses/lib/herdr-presence.ts +399 -0
  408. package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  409. package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  410. package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  411. package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  412. package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  413. package/.versions/2.0.16/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  414. package/.versions/2.0.16/.pi/harnesses/lib/spawned-peers.js +191 -0
  415. package/.versions/2.0.16/.pi/harnesses/lib/system1/config-json.js +37 -0
  416. package/.versions/2.0.16/.pi/harnesses/lib/system1/config-loader.js +44 -0
  417. package/.versions/2.0.16/.pi/harnesses/lib/system1/config-proactive.js +57 -0
  418. package/.versions/2.0.16/.pi/harnesses/lib/system1/config-triage.js +42 -0
  419. package/.versions/2.0.16/.pi/harnesses/lib/system1/config-v2.js +100 -0
  420. package/.versions/2.0.16/.pi/harnesses/lib/system1/config.js +50 -0
  421. package/.versions/2.0.16/.pi/harnesses/lib/system1/contracts.ts +154 -0
  422. package/.versions/2.0.16/.pi/harnesses/lib/system1/demo.ts +95 -0
  423. package/.versions/2.0.16/.pi/harnesses/lib/system1/jev.ts +503 -0
  424. package/.versions/2.0.16/.pi/harnesses/lib/system1/selection.js +11 -0
  425. package/.versions/2.0.16/.pi/harnesses/lib/system1/service.ts +245 -0
  426. package/.versions/2.0.16/.pi/harnesses/lib/update-check.ts +222 -0
  427. package/.versions/2.0.16/.pi/harnesses/package-lock.json +2039 -0
  428. package/.versions/2.0.16/.pi/harnesses/package.json +10 -0
  429. package/.versions/2.0.16/.pi/prompts/af-build.md +27 -0
  430. package/.versions/2.0.16/.pi/prompts/af-code-simplify.md +22 -0
  431. package/.versions/2.0.16/.pi/prompts/af-constraints.md +31 -0
  432. package/.versions/2.0.16/.pi/prompts/af-plan.md +17 -0
  433. package/.versions/2.0.16/.pi/prompts/af-review.md +16 -0
  434. package/.versions/2.0.16/.pi/prompts/af-set-hermes-telegram.md +15 -0
  435. package/.versions/2.0.16/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  436. package/.versions/2.0.16/.pi/prompts/af-setup-rules.md +20 -0
  437. package/.versions/2.0.16/.pi/prompts/af-ship.md +17 -0
  438. package/.versions/2.0.16/.pi/prompts/af-spec.md +15 -0
  439. package/.versions/2.0.16/.pi/prompts/af-test.md +19 -0
  440. package/.versions/2.0.16/.pi/skills/bowser/SKILL.md +145 -0
  441. package/.versions/2.0.16/.version +1 -0
  442. package/.versions/2.0.16/agents/architect.md +24 -0
  443. package/.versions/2.0.16/agents/bowser.md +28 -0
  444. package/.versions/2.0.16/agents/builder.md +55 -0
  445. package/.versions/2.0.16/agents/code-reviewer.md +209 -0
  446. package/.versions/2.0.16/agents/deep-researcher.md +32 -0
  447. package/.versions/2.0.16/agents/documenter.md +22 -0
  448. package/.versions/2.0.16/agents/orchestrator.md +22 -0
  449. package/.versions/2.0.16/agents/plan-reviewer.md +83 -0
  450. package/.versions/2.0.16/agents/planner.md +105 -0
  451. package/.versions/2.0.16/agents/releaser.md +24 -0
  452. package/.versions/2.0.16/agents/researcher.md +30 -0
  453. package/.versions/2.0.16/agents/security-auditor.md +167 -0
  454. package/.versions/2.0.16/agents/test-engineer.md +153 -0
  455. package/.versions/2.0.16/agents/web-debugger.md +44 -0
  456. package/.versions/2.0.16/agents/web-performance-auditor.md +194 -0
  457. package/.versions/2.0.16/bin/catalog/harness-runtime-closure.json +73 -0
  458. package/.versions/2.0.16/codex/fleet-session-client/SKILL.md +34 -0
  459. package/.versions/2.0.16/codex/fleet-session-client.zip +0 -0
  460. package/.versions/2.0.16/docs/ARCHITECTURE.md +834 -0
  461. package/.versions/2.0.16/docs/agent-fleet-setup.md +1101 -0
  462. package/.versions/2.0.16/docs/claude-code-coms-bridge.md +134 -0
  463. package/.versions/2.0.16/docs/codex-session-bridge.md +219 -0
  464. package/.versions/2.0.16/docs/coms-hermes-bridge.md +188 -0
  465. package/.versions/2.0.16/docs/getting-started.md +126 -0
  466. package/.versions/2.0.16/docs/npm-install.md +530 -0
  467. package/.versions/2.0.16/docs/pi-extensions.md +454 -0
  468. package/.versions/2.0.16/docs/pi-setup.md +92 -0
  469. package/.versions/2.0.16/docs/skill-anatomy.md +150 -0
  470. package/.versions/2.0.16/install-manifest.json +3193 -0
  471. package/.versions/2.0.16/justfile +247 -0
  472. package/.versions/2.0.16/manifest-meta.json +1071 -0
  473. package/.versions/2.0.16/references/accessibility-checklist.md +160 -0
  474. package/.versions/2.0.16/references/communication-contract.md +26 -0
  475. package/.versions/2.0.16/references/definition-of-done.md +67 -0
  476. package/.versions/2.0.16/references/fleet-coordination-patterns.md +171 -0
  477. package/.versions/2.0.16/references/observability-checklist.md +92 -0
  478. package/.versions/2.0.16/references/orchestration-patterns.md +370 -0
  479. package/.versions/2.0.16/references/performance-checklist.md +236 -0
  480. package/.versions/2.0.16/references/prompting-patterns.md +380 -0
  481. package/.versions/2.0.16/references/security-checklist.md +245 -0
  482. package/.versions/2.0.16/references/testing-patterns.md +235 -0
  483. package/.versions/2.0.16/references/workflow-authoring.md +304 -0
  484. package/.versions/2.0.16/skills/_internal/grilling.md +59 -0
  485. package/.versions/2.0.16/skills/browser-testing-with-devtools/SKILL.md +351 -0
  486. package/.versions/2.0.16/skills/code-review-and-quality/SKILL.md +396 -0
  487. package/.versions/2.0.16/skills/compound-learning/SKILL.md +137 -0
  488. package/.versions/2.0.16/skills/constraint-driven-development/SKILL.md +338 -0
  489. package/.versions/2.0.16/skills/constraint-driven-development/references/floor-guard.md +99 -0
  490. package/.versions/2.0.16/skills/context-engineering/SKILL.md +341 -0
  491. package/.versions/2.0.16/skills/deprecation-and-migration/SKILL.md +247 -0
  492. package/.versions/2.0.16/skills/designing-agents/SKILL.md +394 -0
  493. package/.versions/2.0.16/skills/designing-agents/pi-harness-authoring.md +222 -0
  494. package/.versions/2.0.16/skills/drafting-workflows/SKILL.md +143 -0
  495. package/.versions/2.0.16/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  496. package/.versions/2.0.16/skills/frontend-ui-engineering/SKILL.md +328 -0
  497. package/.versions/2.0.16/skills/git-workflow-and-versioning/SKILL.md +316 -0
  498. package/.versions/2.0.16/skills/idea-refine/SKILL.md +182 -0
  499. package/.versions/2.0.16/skills/idea-refine/examples.md +238 -0
  500. package/.versions/2.0.16/skills/idea-refine/frameworks.md +99 -0
  501. package/.versions/2.0.16/skills/idea-refine/refinement-criteria.md +113 -0
  502. package/.versions/2.0.16/skills/idea-refine/scripts/idea-refine.sh +15 -0
  503. package/.versions/2.0.16/skills/incremental-implementation/SKILL.md +353 -0
  504. package/.versions/2.0.16/skills/interview-me/SKILL.md +226 -0
  505. package/.versions/2.0.16/skills/orchestration-verification/SKILL.md +182 -0
  506. package/.versions/2.0.16/skills/peer-coms/SKILL.md +90 -0
  507. package/.versions/2.0.16/skills/performance-optimization/SKILL.md +496 -0
  508. package/.versions/2.0.16/skills/planning-and-task-breakdown/SKILL.md +318 -0
  509. package/.versions/2.0.16/skills/repository-ai-setup/SKILL.md +117 -0
  510. package/.versions/2.0.16/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  511. package/.versions/2.0.16/skills/repository-ai-setup/references/apply-contract.md +74 -0
  512. package/.versions/2.0.16/skills/repository-ai-setup/references/provenance-template.md +16 -0
  513. package/.versions/2.0.16/skills/repository-ai-setup/references/setup-flow.md +108 -0
  514. package/.versions/2.0.16/skills/repository-ai-setup/references/verify-setup.md +20 -0
  515. package/.versions/2.0.16/skills/security-and-hardening/SKILL.md +524 -0
  516. package/.versions/2.0.16/skills/spec-driven-development/SKILL.md +295 -0
  517. package/.versions/2.0.16/skills/using-agent-skills/SKILL.md +198 -0
  518. package/.versions/2.0.16/vendor/agent-skills-upstream/LICENSE +21 -0
  519. package/.versions/2.0.16/vendor/agent-skills-upstream/README.md +430 -0
  520. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  521. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  522. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  523. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  524. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  525. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  526. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  527. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  528. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  529. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  530. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  531. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  532. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  533. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  534. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  535. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  536. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  537. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  538. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  539. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  540. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  541. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  542. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  543. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  544. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  545. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  546. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  547. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  548. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  549. package/.versions/2.0.16/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  550. package/CHANGELOG.md +12 -0
  551. package/bin/cli.js +17 -0
  552. package/bin/lib/doctor.js +41 -32
  553. package/bin/lib/system1-migration.js +107 -0
  554. package/bin/lib/task-triage-setup.js +31 -71
  555. package/bin/lib/transaction.js +61 -20
  556. package/bin/lib/workspace-safety.js +3 -2
  557. package/docs/ARCHITECTURE.md +9 -4
  558. package/docs/agent-fleet-setup.md +28 -17
  559. package/docs/npm-install.md +9 -4
  560. package/docs/system1-config.md +83 -0
  561. package/install-manifest.json +3 -3
  562. package/manifest-meta.json +2 -2
  563. package/package.json +6 -4
  564. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-closure.user-run.mjs +0 -336
  565. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs +0 -157
@@ -0,0 +1,219 @@
1
+ import { DELEGATE_TREE_SPAWN_BUDGET } from "../agent-hub/helpers.ts";
2
+ import { externalBlockedProtocol } from "../agent-hub/external-blocker.js";
3
+
4
+ export { DELEGATE_TREE_SPAWN_BUDGET };
5
+ export const RESEARCH_TOOLS = "read,grep,find,ls";
6
+ export const MAX_AUTO_RESEARCH_QUESTIONS = 4;
7
+ /** Deterministic reference estimate: four serialized characters per token. */
8
+ export const RESEARCH_STANDING_TOKEN_CEILING = 3_000;
9
+ export const RESEARCH_TOKEN_CHARS = 4;
10
+
11
+ export function buildClarificationProtocol(userLanguage: string, maxQuestions = MAX_AUTO_RESEARCH_QUESTIONS): string {
12
+ return `
13
+
14
+ ## Clarification protocol
15
+ If at any point you need a decision from the human user (ambiguity, missing input,
16
+ contradiction, or a destructive/irreversible next step), DO NOT guess. Stop and
17
+ return a single line of the form:
18
+
19
+ ASK_USER: <your question in one clear English sentence>
20
+
21
+ You may emit multiple ASK_USER lines if you have several questions. The dispatcher
22
+ will surface each to the human user in ${userLanguage} and re-dispatch you with the
23
+ answers. Do not invent values, do not pick "reasonable defaults" silently — ask.
24
+
25
+ ## External-blocker protocol
26
+ ${externalBlockedProtocol()}
27
+
28
+ ## Research protocol
29
+ If you need reconnaissance you cannot perform with your own tools (broad code search,
30
+ reading unfamiliar areas of the codebase, summarizing docs), DO NOT guess and DO NOT
31
+ ask the user. Pause for research instead: end your turn with one or more lines of the
32
+ form
33
+
34
+ NEEDS_RESEARCH: <one specific, self-contained question>
35
+
36
+ with nothing after them. Your session pauses there; read-only research helpers are
37
+ spawned for you, each helper's findings are saved to a file, and you are resumed in
38
+ this same session with the file paths — read them and continue from where you left
39
+ off. Ask at most ${maxQuestions} questions per pause. Use ASK_USER only
40
+ for decisions a human must make; use NEEDS_RESEARCH for facts that can be looked up.`;
41
+ }
42
+
43
+ export function buildDelegationProtocol(roleNames: readonly string[], spawnBudget = DELEGATE_TREE_SPAWN_BUDGET): string {
44
+ if (roleNames.length === 0) return "";
45
+ return `
46
+
47
+ ## Delegation protocol
48
+ You have a \`delegate\` tool with pre-configured sub-agents on cheaper models
49
+ (roles: ${roleNames.join(", ")}). Prefer delegating scoped, self-contained
50
+ sub-tasks to them over doing everything yourself. A child shares NONE of your
51
+ context — put everything it needs into its instruction/context. You may run up
52
+ to ${spawnBudget} delegate calls for this dispatch; parallel children are forced read-only.
53
+ Children are terminal workers: they do not receive delegate tooling at remaining depth 0.`;
54
+ }
55
+
56
+ export function buildDeliverableProtocol(agentKey: string, runNumber: number, artifactRoot = ".pi/agent-sessions/artifacts", dispatchId?: string): string {
57
+ const filename = `${agentKey}-${dispatchId ?? `run${runNumber}`}.md`;
58
+ return `
59
+
60
+ ## Deliverable-to-file protocol
61
+ When your deliverable is a document (plan, review, critique, inventory, report), write the full document to the real session artifact path when your tools allow it: ${artifactRoot}/<kind>/${filename} (kinds: plans, reviews, inventories, evidence). Do NOT write repo-root ./artifacts/... files. In your final response, report and pass the artifact-relative handoff path: artifacts/<kind>/${filename}. If your persona already has an explicit output path contract such as planner PLAN_FILE, keep that existing behavior and also summarize/return the session artifact path the hub gives you.
62
+ Finish with the artifact-relative path plus a digest of no more than 10 lines. If the dispatch includes acceptance assertions (A1, A2, ...), also include the structured return from skills/orchestration-verification/SKILL.md. If your tools are read-only and you cannot write a document artifact yourself, finish with the digest + structured return; the hub will still persist your full final return under artifacts/returns/ for dispatcher recovery.`;
63
+ }
64
+
65
+ export interface ChildPromptParts {
66
+ id: string;
67
+ category: "persona" | "tool" | "system" | "protocol";
68
+ label: string;
69
+ chars: number;
70
+ }
71
+
72
+ export interface SpecialistContextManifest {
73
+ persona: { name: string; sourcePath: string; primarySkillPaths: string[] };
74
+ taskSkillPaths: string[];
75
+ projectPolicy: { rulesPaths: string[]; docsPaths: string[] };
76
+ flags: { assertions: boolean; scope: boolean; artifacts: boolean };
77
+ delegateRoles: string[];
78
+ protocolIds: string[];
79
+ }
80
+
81
+ export function buildProjectRulesProtocol(paths: readonly string[]): string {
82
+ if (paths.length === 0) return "";
83
+ return `
84
+
85
+ ## Project rules
86
+ This project keeps its own rules in: ${paths.join(", ")} (repo-relative).
87
+ Rules are HOW constraints — read the ones relevant to your task and comply with them.
88
+ Read a listed file directly. Resolve them index-first when they are folders: if one has a
89
+ top-level README.md or index.md, read that first and follow its loading manifest
90
+ (session bundles, "load X when Y" lists) to select only the rule files that apply;
91
+ do not bulk-read the tree. Only when a folder has no such index, discover rule files
92
+ recursively (\`find <dir> -type f\`) and read the relevant ones. If you plan or review
93
+ work, validate your subject against the rules; when delegating, pass the relevant
94
+ rule file paths and specific points to check to the child.`;
95
+ }
96
+
97
+ export function buildProjectDocsProtocol(paths: readonly string[]): string {
98
+ if (paths.length === 0) return "";
99
+ return `
100
+
101
+ ## Project docs
102
+ This project's canonical documentation entry points are: ${paths.join(", ")}
103
+ (repo-relative). Docs carry WHAT/WHY context — architecture, standards, decisions.
104
+ They orient you; they are not compliance rules. Read a listed file directly. For a
105
+ listed folder, start from its README.md or index.md and follow only links relevant
106
+ to the task rather than bulk-reading doc trees. If your work changes something the
107
+ docs describe (architecture, public APIs, commands, structure), say so in your final
108
+ response so the docs can be updated.`;
109
+ }
110
+
111
+ export function buildSelectedProjectPolicyProtocol(manifest: SpecialistContextManifest): string {
112
+ const selected = new Set(manifest.protocolIds);
113
+ return (selected.has("rules") ? buildProjectRulesProtocol(manifest.projectPolicy.rulesPaths) : "") +
114
+ (selected.has("docs") ? buildProjectDocsProtocol(manifest.projectPolicy.docsPaths) : "");
115
+ }
116
+
117
+ const skillPaths = (text: string) => [...new Set(text.match(/(?:^|[\s`(])((?:\.?\/?skills\/)[\w./-]+\/SKILL\.md)/g) ?? [])]
118
+ .map(match => match.match(/((?:\.?\/?skills\/)[\w./-]+\/SKILL\.md)/)?.[1] ?? "")
119
+ .filter(Boolean);
120
+
121
+ export function buildSpecialistContextManifest(input: {
122
+ personaName: string;
123
+ personaPath: string;
124
+ personaPrompt: string;
125
+ task: string;
126
+ rulesPaths: readonly string[];
127
+ docsPaths: readonly string[];
128
+ hasAssertions: boolean;
129
+ hasScope: boolean;
130
+ hasArtifacts: boolean;
131
+ delegateRoles: readonly string[];
132
+ }): SpecialistContextManifest {
133
+ const protocolIds = ["clarification", "external-blocker", "research", "deliverable"];
134
+ if (input.rulesPaths.length) protocolIds.push("rules");
135
+ if (input.docsPaths.length) protocolIds.push("docs");
136
+ if (input.hasAssertions) protocolIds.push("verification");
137
+ if (input.delegateRoles.length) protocolIds.push("delegation");
138
+ return {
139
+ persona: { name: input.personaName, sourcePath: input.personaPath, primarySkillPaths: skillPaths(input.personaPrompt) },
140
+ taskSkillPaths: skillPaths(input.task),
141
+ projectPolicy: { rulesPaths: [...input.rulesPaths], docsPaths: [...input.docsPaths] },
142
+ flags: { assertions: input.hasAssertions, scope: input.hasScope, artifacts: input.hasArtifacts },
143
+ delegateRoles: [...input.delegateRoles],
144
+ protocolIds,
145
+ };
146
+ }
147
+
148
+ export function nativeSpecialistSystemPrompt(input: { manifest: SpecialistContextManifest; userLanguage: string; agentKey: string; runNumber: number; artifactRoot?: string; dispatchId?: string }): string {
149
+ const { manifest } = input;
150
+ const paths = (label: string, values: string[]) => values.length ? `\n${label}: ${values.join(", ")}` : "";
151
+ const framing = [
152
+ "Task is supplied via stdin.",
153
+ ...(manifest.flags.scope ? ["Declared scope is supplied via stdin."] : []),
154
+ ...(manifest.flags.artifacts ? ["Artifact paths are supplied via stdin."] : []),
155
+ ];
156
+ const references = `# Managed Specialist\nPersona: ${manifest.persona.name}; source: ${manifest.persona.sourcePath}.${paths("Primary skills", manifest.persona.primarySkillPaths)}${paths("Task-selected skills", manifest.taskSkillPaths)}${paths("Applicable project rules", manifest.projectPolicy.rulesPaths)}${paths("Applicable project docs", manifest.projectPolicy.docsPaths)}\n${framing.join(" ")} Read the persona source before work and applicable project rules before edits or commands. Read only the named skill and documentation paths when relevant; do not discover global skills or context files.`;
157
+ let prompt = references + buildSelectedProjectPolicyProtocol(manifest) + buildClarificationProtocol(input.userLanguage);
158
+ if (manifest.flags.assertions) prompt += "\n\n## Verification\nRead skills/orchestration-verification/SKILL.md for the structured return contract; apply the assertions supplied in the task.";
159
+ if (manifest.delegateRoles.length) prompt += buildDelegationProtocol(manifest.delegateRoles);
160
+ prompt += buildDeliverableProtocol(input.agentKey, input.runNumber, input.artifactRoot, input.dispatchId);
161
+ return prompt;
162
+ }
163
+
164
+ export function specialistStandingParts(input: {
165
+ replacementPrompt: string;
166
+ toolChars: number;
167
+ }): ChildPromptParts[] {
168
+ return [
169
+ { id: "specialist-replacement", category: "system", label: "Replacement specialist manifest prompt", chars: input.replacementPrompt.length },
170
+ { id: "child-tools", category: "tool", label: "Configured child tools", chars: input.toolChars },
171
+ { id: "pi-base", category: "system", label: "Pi child base prompt inputs", chars: 0 },
172
+ ];
173
+ }
174
+
175
+ export function researchStandingParts(input: {
176
+ replacementPrompt: string;
177
+ toolChars: number;
178
+ basePromptChars: number;
179
+ }): ChildPromptParts[] {
180
+ const parts = [
181
+ { id: "research-replacement", category: "system" as const, label: "Replacement read-only research prompt", chars: input.replacementPrompt.length },
182
+ { id: "child-tools", category: "tool" as const, label: "Configured child tools", chars: input.toolChars },
183
+ { id: "pi-base", category: "system" as const, label: "Pi child base prompt inputs", chars: input.basePromptChars },
184
+ ];
185
+ const standingChars = parts.reduce((sum, part) => sum + part.chars, 0);
186
+ if (Math.ceil(standingChars / RESEARCH_TOKEN_CHARS) > RESEARCH_STANDING_TOKEN_CEILING) {
187
+ throw new Error(`Research standing overhead exceeds ${RESEARCH_STANDING_TOKEN_CEILING} estimated tokens`);
188
+ }
189
+ return parts;
190
+ }
191
+
192
+ export function delegateStandingParts(input: {
193
+ toolChars: number;
194
+ basePromptChars: number;
195
+ roleNames: readonly string[];
196
+ }): ChildPromptParts[] {
197
+ return [
198
+ { id: "delegate-protocol", category: "protocol", label: "Resolved delegate role protocol", chars: buildDelegationProtocol(input.roleNames).length },
199
+ { id: "child-tools", category: "tool", label: "Resolved delegate tools", chars: input.toolChars },
200
+ { id: "pi-base", category: "system", label: "Pi child base prompt inputs", chars: input.basePromptChars },
201
+ ];
202
+ }
203
+
204
+ export function nativeResearchSystemPrompt(input: {
205
+ personaName?: string;
206
+ personaPath?: string;
207
+ cwd: string;
208
+ rulesPaths?: readonly string[];
209
+ docsPaths?: readonly string[];
210
+ }): string {
211
+ const persona = input.personaName && input.personaPath
212
+ ? `\nSelected persona: ${input.personaName}. Its source is ${input.personaPath}; read that one file only when its role guidance is needed.`
213
+ : "\nNo persona is selected; act as a general research helper.";
214
+ const policy = buildProjectRulesProtocol(input.rulesPaths ?? []) + buildProjectDocsProtocol(input.docsPaths ?? []);
215
+ return `# Read-only Research Helper
216
+ You investigate the requested repository topic for a parent agent. Your only tools are read, grep, find, and ls. Do not edit, write, run bash, delegate, or claim those tools are available.${persona}
217
+ Working directory: ${input.cwd}${policy}
218
+ Task input may name artifact paths; inspect only paths relevant to that task. Report concise findings with concrete path:line citations. State uncertainty or missing evidence plainly. Return findings only; do not propose or attempt edits.`;
219
+ }
@@ -0,0 +1,121 @@
1
+ import { component, type ContextBudgetComponent, type ContextCategory } from "./context-budget.ts";
2
+
3
+ /**
4
+ * Prompt inputs are deliberately split between stable policy and a small volatile
5
+ * state capsule. Callers must not put counters or task state in policy fragments.
6
+ */
7
+ export interface HubPromptParts {
8
+ intro: string;
9
+ toolList: string;
10
+ languageLines: string;
11
+ activeTeamName: string;
12
+ teamMembers: string;
13
+ dispatchSection: string;
14
+ userLanguage: string;
15
+ askUserBlock: string;
16
+ modeSection: string;
17
+ verificationSection: string;
18
+ projectPolicySection?: string;
19
+ comsSection: string;
20
+ herdrSection: string;
21
+ compactionSection?: string;
22
+ hardRules: string;
23
+ ambiguityRule: string;
24
+ agentCatalog: string;
25
+ researchCatalog: string;
26
+ /** Changes per turn: tier, budgets, active counters, and pending state only. */
27
+ stateCapsule?: string;
28
+ }
29
+
30
+ export const HUB_HERDR_SECTION = `
31
+ ## Fleet (herdr)
32
+ - Use panes only for auxiliary processes; never bypass specialist delegation.
33
+ - Spawn a peer immediately before its first message. It boots idle; \`peer_ready: false\` is a failed start.
34
+ - Check \`coms_list\` for peer status; read panes only for unbridged tools or post-mortems.
35
+ - \`herdr_close_pane\` requires human confirmation. Close only panes you opened when their work ends.
36
+ - \`herdr_notify\` reaches an away human; it never replaces \`ask_user\`.
37
+ `;
38
+
39
+ /** Assemble the effective Hub replacement prompt. Ledger metadata is never interpolated.
40
+ *
41
+ * T9 truthful guidance: the prompt points at the active catalog and the read-only
42
+ * inspection route, never at routine slash resets. Preflight refusals carry their
43
+ * authoritative tier/catalog/revision snapshot; tool availability is never gate admission.
44
+ */
45
+ export function assembleHubSystemPrompt(parts: HubPromptParts): string {
46
+ const team = parts.activeTeamName || "(none)";
47
+ const members = parts.teamMembers || "(none — add a persona before using dispatch_agent)";
48
+ const state = parts.stateCapsule ? `\n${parts.stateCapsule}\n` : "";
49
+ const fleet = parts.dispatchSection ? `
50
+ ## Native Roster: ${team}
51
+ Members: ${members}
52
+ Dispatch only listed agents. The roster may change through its Fleet commands or \`team_adjust\` when it genuinely cannot serve the task; more personas is usually the wrong answer.
53
+
54
+ ## How to Work
55
+ ${parts.dispatchSection}
56
+ - Choose \`backend: native\` only for an explicitly requested local Pi specialist, \`backend: coms\` only for an explicitly requested live same-name peer, and \`backend: auto\` otherwise. Never substitute an explicit backend.
57
+ - Review results, follow up when needed, and summarize for the user in ${parts.userLanguage}.
58
+
59
+ ## Research helpers (read-only)
60
+ - \`spawn_research\` is read-only (read/grep/find/ls; no bash or writes). Use it for necessary reconnaissance, not to read a return artifact you already have.
61
+ - Choose a light persona for simple reads and a stronger one for ambiguous, cross-cutting, or high-stakes research.
62
+ - Specialists cannot spawn helpers; run necessary research and pass its findings or artifact path to the specialist.
63
+
64
+ ## Agents
65
+
66
+ ${parts.agentCatalog}
67
+
68
+ ## Research personas
69
+
70
+ ${parts.researchCatalog}
71
+ ` : "";
72
+ const verification = parts.verificationSection ? `\n${parts.verificationSection}\n` : "";
73
+ const policy = `${parts.intro} You have ${parts.toolList}.
74
+
75
+ ## Language
76
+ ${parts.languageLines}${fleet}
77
+ ${parts.askUserBlock}
78
+
79
+ ${parts.modeSection}${state}${verification}${parts.projectPolicySection ?? ""}
80
+ ${parts.comsSection}${parts.herdrSection}${parts.compactionSection ?? ""}
81
+ ## Hard Rules
82
+ ${parts.hardRules}
83
+ ${parts.ambiguityRule}
84
+ - Keep each dispatch focused and use the returned evidence before reporting completion.`;
85
+ return policy;
86
+ }
87
+
88
+ export interface NamedHubPart { id: string; text: string; category: ContextCategory; persistence?: ContextBudgetComponent["persistence"]; source?: string; }
89
+
90
+ export function namedHubLedgerParts(input: {
91
+ intro: string; languageLines: string; teamMembers: string; agentCards: readonly { id: string; text: string }[];
92
+ dispatchSection: string; modeSection: string; verificationSection: string; projectPolicySection?: string; researchCards: readonly { id: string; text: string }[];
93
+ researchCatalog: string; comsSection: string; herdrSection: string; compactionSection?: string; stateCapsule?: string;
94
+ }): NamedHubPart[] {
95
+ return [
96
+ { id: "hub/policy/work-mode", text: input.intro, category: "system", persistence: "fixed", source: "work-mode.ts" },
97
+ { id: "hub/policy/language", text: input.languageLines, category: "protocol", persistence: "fixed", source: "hub-policy" },
98
+ { id: "hub/roster-header", text: input.teamMembers, category: "roster", persistence: "session", source: "active-roster" },
99
+ ...input.agentCards.map(card => ({ id: `hub/roster/${card.id}`, text: card.text, category: "roster" as const, persistence: "session" as const, source: "agent-persona" })),
100
+ { id: "hub/policy/dispatch", text: input.dispatchSection, category: "protocol", persistence: "fixed", source: "hub-policy" },
101
+ { id: "hub/policy/triage", text: input.modeSection, category: "protocol", persistence: "fixed", source: "run-budget" },
102
+ { id: "hub/policy/verification", text: input.verificationSection, category: "protocol", persistence: "fixed", source: "orchestration-verification" },
103
+ { id: "hub/policy/project", text: input.projectPolicySection ?? "", category: "protocol", persistence: "session", source: "project-overrides" },
104
+ { id: "hub/state", text: input.stateCapsule ?? "", category: "system", persistence: "turn", source: "hub-state" },
105
+ ...(input.researchCards.length ? input.researchCards.map(card => ({ id: `hub/research/${card.id}`, text: card.text, category: "persona" as const, persistence: "session" as const, source: "research-persona" })) : [{ id: "hub/research-empty", text: input.researchCatalog, category: "persona" as const, persistence: "session" as const, source: "research-persona" }]),
106
+ { id: "hub/policy/coms", text: input.comsSection, category: "protocol", persistence: "fixed", source: "coms" },
107
+ { id: "hub/policy/workspace", text: input.herdrSection, category: "protocol", persistence: "fixed", source: "herdr" },
108
+ { id: "hub/policy/compaction", text: input.compactionSection ?? "", category: "protocol", persistence: "fixed", source: "compaction" },
109
+ ];
110
+ }
111
+
112
+ export function recordHubLedger(systemPrompt: string, parts: readonly NamedHubPart[]): ContextBudgetComponent[] {
113
+ const namedChars = parts.reduce((sum, part) => sum + part.text.length, 0);
114
+ return parts.map(part => component({
115
+ id: part.id, plane: "hub", category: part.category, label: part.id.replace("hub/", "Hub "), source: part.source,
116
+ persistence: part.persistence ?? "turn", visibility: "model-visible", confidence: "exact-chars", chars: part.text.length,
117
+ })).concat(component({
118
+ id: "hub/separators-and-rules", plane: "hub", category: "system", label: "Hub separators and formatting", source: "hub-prompt-template",
119
+ persistence: "fixed", visibility: "model-visible", confidence: "exact-chars", chars: Math.max(0, systemPrompt.length - namedChars),
120
+ }));
121
+ }
@@ -0,0 +1,107 @@
1
+ import { clampScroll, fitToHeight } from "./fleet-overlay.ts";
2
+ import { moveSelection, reconcileSelection, type Selection } from "./fleet-selection.ts";
3
+ import type { ContextBudgetSnapshot } from "../agent-hub/context-budget-snapshot.ts";
4
+
5
+ export interface ContextBudgetViewState { selection: Selection; expanded: Set<string>; scrollOffset: number; }
6
+ export const CONTEXT_BUDGET_CHROME_ROWS = 5;
7
+ const tokens = (n: number | undefined) => n == null ? "—" : Intl.NumberFormat("en").format(Math.round(n));
8
+ const pct = (n: number | undefined) => n == null ? "window unknown" : `${n.toFixed(1)}%`;
9
+ const ANSI = /\x1B\[[0-?]*[ -\/]*[@-~]/;
10
+ /** Truncate by terminal cells while never cutting an ANSI escape sequence. */
11
+ export function ansiTruncate(value: string, width: number): string {
12
+ let cells = 0; let out = "";
13
+ for (let i = 0; i < value.length;) {
14
+ const escape = value.slice(i).match(/^\x1B\[[0-?]*[ -\/]*[@-~]/)?.[0];
15
+ if (escape) { out += escape; i += escape.length; continue; }
16
+ const char = String.fromCodePoint(value.codePointAt(i)!); if (cells + 1 > width) break;
17
+ out += char; cells++; i += char.length;
18
+ }
19
+ return out + (ANSI.test(out) ? "\x1b[0m" : "");
20
+ }
21
+
22
+ function groupKey(category: string): string {
23
+ if (category === "tool") return "group/tools";
24
+ if (category === "addon") return "group/addons";
25
+ if (category === "skill") return "group/skills";
26
+ if (category === "conversation") return "group/conversation";
27
+ if (category === "project") return "group/project";
28
+ if (category === "roster" || category === "persona") return "group/roster";
29
+ return "group/system";
30
+ }
31
+
32
+ export interface ContextBudgetRow { key: string; label: string; detail: string; expandable?: boolean; }
33
+
34
+ export function contextBudgetRows(snapshot: ContextBudgetSnapshot, expanded: Set<string> = new Set()): ContextBudgetRow[] {
35
+ const groups = new Map<string, { key: string; label: string; children: ContextBudgetRow[] }>();
36
+ const order = ["group/system", "group/project", "group/roster", "group/tools", "group/addons", "group/skills", "group/conversation"];
37
+ for (const component of snapshot.components) {
38
+ const key = groupKey(component.category);
39
+ if (!groups.has(key)) groups.set(key, { key, label: key.replace("group/", ""), children: [] });
40
+ groups.get(key)!.children.push({
41
+ key: `hub/${component.id}`,
42
+ label: ` ${component.label}`,
43
+ detail: `${component.visibility} · ${component.confidence} · ${tokens(component.adjustedTokens ?? component.estimatedTokens)} tok`,
44
+ });
45
+ }
46
+ const rows: ContextBudgetRow[] = [];
47
+ for (const key of order) {
48
+ const group = groups.get(key);
49
+ if (!group) continue;
50
+ rows.push({ key: group.key, label: group.label, detail: `${group.children.length} items`, expandable: true });
51
+ if (expanded.has(group.key)) rows.push(...group.children);
52
+ }
53
+ for (const plane of snapshot.planes) {
54
+ const key = `plane/${plane.summary.plane}/${plane.components[0]?.id ?? plane.summary.plane}`;
55
+ rows.push({ key, label: `${plane.summary.plane} plane`, detail: `${tokens(plane.summary.measuredTokens)} / ${tokens(plane.summary.window)} · ${pct(plane.summary.occupancyPercent)}`, expandable: true });
56
+ if (expanded.has(key)) {
57
+ for (const component of plane.components) {
58
+ rows.push({ key: `${key}/${component.id}`, label: ` ${component.label}`, detail: `${component.confidence} · ${tokens(component.adjustedTokens ?? component.estimatedTokens)} tok` });
59
+ }
60
+ }
61
+ }
62
+ return rows;
63
+ }
64
+
65
+ function keepSelectionVisible(state: ContextBudgetViewState, rows: readonly ContextBudgetRow[], bodyHeight: number): void {
66
+ const viewport = Math.max(1, bodyHeight);
67
+ if (state.selection.index < state.scrollOffset) state.scrollOffset = state.selection.index;
68
+ else if (state.selection.index >= state.scrollOffset + viewport) state.scrollOffset = state.selection.index - viewport + 1;
69
+ state.scrollOffset = clampScroll(state.scrollOffset, rows.length, viewport);
70
+ }
71
+
72
+ export function contextBudgetTransition(data: string, state: ContextBudgetViewState, snapshot: ContextBudgetSnapshot, bodyHeight: number): "close" | "refresh" | undefined {
73
+ let rows = contextBudgetRows(snapshot, state.expanded); reconcileSelection(state.selection, rows);
74
+ if (data === "q" || data === "\u001b") return "close";
75
+ if (data === "r") return "refresh";
76
+ if (data === "\u001b[A") moveSelection(state.selection, rows, -1);
77
+ else if (data === "\u001b[B") moveSelection(state.selection, rows, 1);
78
+ else if (data === "\u001b[5~") moveSelection(state.selection, rows, -Math.max(1, bodyHeight));
79
+ else if (data === "\u001b[6~") moveSelection(state.selection, rows, Math.max(1, bodyHeight));
80
+ else if (data === "g") { state.selection.index = 0; state.selection.key = rows[0]?.key; }
81
+ else if (data === "G") { state.selection.index = Math.max(0, rows.length - 1); state.selection.key = rows.at(-1)?.key; }
82
+ else if (data === "\r" && rows[state.selection.index]?.expandable) {
83
+ const key = state.selection.key!;
84
+ state.expanded.has(key) ? state.expanded.delete(key) : state.expanded.add(key);
85
+ rows = contextBudgetRows(snapshot, state.expanded);
86
+ reconcileSelection(state.selection, rows);
87
+ }
88
+ keepSelectionVisible(state, rows, bodyHeight);
89
+ return undefined;
90
+ }
91
+
92
+ /** Fixed-height, metadata-only overlay rendering. */
93
+ export function renderContextBudget(snapshot: ContextBudgetSnapshot, state: ContextBudgetViewState, width: number, height: number): string[] {
94
+ const rows = contextBudgetRows(snapshot, state.expanded); reconcileSelection(state.selection, rows);
95
+ keepSelectionVisible(state, rows, Math.max(0, height - 2));
96
+ const hub = snapshot.hub.summary;
97
+ const pressure = snapshot.pressure;
98
+ const pressureLabel = pressure ? ` · pressure ${pressure.phase}` : "";
99
+ const header = ansiTruncate(`CONTEXT BUDGET ${snapshot.model ?? "model unknown"} · ${tokens(hub.measuredTokens)} / ${tokens(hub.window)} (${pct(hub.occupancyPercent)})${pressureLabel} · ${snapshot.estimator}`, Math.max(1, width));
100
+ const visible = rows.slice(state.scrollOffset, state.scrollOffset + Math.max(0, height - 2));
101
+ const body = visible.map((row) => ansiTruncate(`${state.selection.key === row.key ? ">" : " "} ${row.label} — ${row.detail}`, Math.max(1, width)));
102
+ const recovery = pressure
103
+ ? `warn ${pressure.warningPercent}% · auto ${pressure.automaticPercent}% · last ${pressure.lastRecoveryOutcome} · `
104
+ : "";
105
+ const footer = ansiTruncate(`${recovery}Attributed ${tokens(hub.attributedTokens)} · residual ${tokens(hub.residualTokens)} · ↑↓ Enter r q`, Math.max(1, width));
106
+ return fitToHeight([header, ...fitToHeight(body, Math.max(0, height - 2)), footer], height);
107
+ }
@@ -0,0 +1,114 @@
1
+ export type ContextPlane = "hub" | "specialist" | "research" | "delegate" | "peer";
2
+ export type ContextCategory = "system" | "project" | "persona" | "roster" | "skill" | "tool" | "addon" | "conversation" | "protocol" | "unattributed";
3
+ export type ContextPersistence = "fixed" | "session" | "turn" | "message" | "projected";
4
+ export type ContextVisibility = "model-visible" | "loaded-excluded" | "ui-only" | "unknown";
5
+ export type ContextConfidence = "exact-chars" | "heuristic" | "provider-scaled" | "provider-total" | "unavailable";
6
+
7
+ /** Metadata-only accounting record. Deliberately contains no component text. */
8
+ export interface ContextBudgetComponent {
9
+ id: string;
10
+ parentId?: string;
11
+ plane: ContextPlane;
12
+ category: ContextCategory;
13
+ label: string;
14
+ source?: string;
15
+ persistence: ContextPersistence;
16
+ visibility: ContextVisibility;
17
+ chars: number;
18
+ estimatedTokens: number;
19
+ adjustedTokens?: number;
20
+ confidence: ContextConfidence;
21
+ }
22
+
23
+ export interface ContextPlaneSummary {
24
+ plane: ContextPlane;
25
+ measuredTokens?: number;
26
+ attributedTokens: number;
27
+ residualTokens?: number;
28
+ window?: number;
29
+ occupancyPercent?: number;
30
+ }
31
+
32
+ export const TOKEN_ESTIMATOR = "chars/4-v1";
33
+
34
+ /** A named, provider-independent heuristic retained beside provider measurements. */
35
+ export function estimateTokens(chars: number): number {
36
+ return Math.ceil(Math.max(0, Number.isFinite(chars) ? chars : 0) / 4);
37
+ }
38
+
39
+ /** Exact JavaScript string character count (not bytes) without retaining text. */
40
+ export function characterCount(value: unknown): number {
41
+ return typeof value === "string" ? value.length : String(value ?? "").length;
42
+ }
43
+
44
+ /**
45
+ * Safely measure a schema's serialised representation. Unsupported values are
46
+ * represented by stable markers; this never throws on circular user schemas.
47
+ */
48
+ export function safeSchemaChars(schema: unknown): number {
49
+ const seen = new WeakSet<object>();
50
+ const json = JSON.stringify(schema, (_key, value) => {
51
+ if (typeof value === "bigint") return "[bigint]";
52
+ if (typeof value === "function") return "[function]";
53
+ if (typeof value === "symbol") return "[symbol]";
54
+ if (value && typeof value === "object") {
55
+ if (seen.has(value)) return "[circular]";
56
+ seen.add(value);
57
+ }
58
+ return value;
59
+ });
60
+ return characterCount(json ?? "[undefined]");
61
+ }
62
+
63
+ export function component(input: Omit<ContextBudgetComponent, "chars" | "estimatedTokens"> & { chars?: number }): ContextBudgetComponent {
64
+ const chars = Math.max(0, Number(input.chars) || 0);
65
+ return { ...input, chars, estimatedTokens: estimateTokens(chars) };
66
+ }
67
+
68
+ /**
69
+ * Reconcile visible component estimates with a provider total. The raw estimate
70
+ * always remains intact. Estimated components are scaled only when needed;
71
+ * non-negative residual absorbs all rounding.
72
+ */
73
+ export function reconcileComponents(components: readonly ContextBudgetComponent[], measuredTokens?: number): ContextBudgetComponent[] {
74
+ const measured = Number(measuredTokens);
75
+ const hasMeasured = Number.isFinite(measured) && measured >= 0;
76
+ const visible = components.filter((entry) => entry.visibility === "model-visible");
77
+ const estimate = visible.reduce((sum, entry) => sum + Math.max(0, entry.estimatedTokens), 0);
78
+ const scale = hasMeasured && estimate > measured && estimate > 0 ? measured / estimate : 1;
79
+ return components.map((entry) => {
80
+ if (entry.visibility !== "model-visible") return { ...entry, adjustedTokens: 0, confidence: entry.confidence === "unavailable" ? "unavailable" : "exact-chars" };
81
+ const adjustedTokens = Math.max(0, Math.floor(Math.max(0, entry.estimatedTokens) * scale));
82
+ return {
83
+ ...entry,
84
+ adjustedTokens,
85
+ confidence: hasMeasured && scale < 1 ? "provider-scaled" : entry.confidence,
86
+ };
87
+ });
88
+ }
89
+
90
+ /** Produce a non-negative provider residual and an exact post-rounding total. */
91
+ export function reconcilePlane(components: readonly ContextBudgetComponent[], plane: ContextPlane, measuredTokens?: number, window?: number): { components: ContextBudgetComponent[]; summary: ContextPlaneSummary; residual?: ContextBudgetComponent } {
92
+ const reconciled = reconcileComponents(components, measuredTokens);
93
+ const measured = Number(measuredTokens);
94
+ const hasMeasured = Number.isFinite(measured) && measured >= 0;
95
+ const attributedTokens = reconciled
96
+ .filter((entry) => entry.plane === plane && entry.visibility === "model-visible")
97
+ .reduce((sum, entry) => sum + Math.max(0, entry.adjustedTokens ?? 0), 0);
98
+ const residualTokens = hasMeasured ? Math.max(0, measured - attributedTokens) : undefined;
99
+ const validWindow = Number(window);
100
+ const occupancyPercent = hasMeasured && Number.isFinite(validWindow) && validWindow > 0 ? (measured / validWindow) * 100 : undefined;
101
+ const residual: ContextBudgetComponent | undefined = residualTokens === undefined ? undefined : {
102
+ id: `${plane}/provider-unattributed`, plane, category: "unattributed", label: "Provider / serialization / unattributed",
103
+ persistence: "turn", visibility: "model-visible", chars: 0, estimatedTokens: 0, adjustedTokens: residualTokens,
104
+ confidence: "provider-total" as const,
105
+ };
106
+ return { components: reconciled, summary: { plane, measuredTokens: hasMeasured ? measured : undefined, attributedTokens, residualTokens, window: Number.isFinite(validWindow) && validWindow > 0 ? validWindow : undefined, occupancyPercent }, residual };
107
+ }
108
+
109
+ /** Context capacity is meaningful only with this plane's own known window. */
110
+ export function planeOccupancy(tokens: number | undefined, window: number | undefined): number | undefined {
111
+ const total = Number(tokens);
112
+ const capacity = Number(window);
113
+ return Number.isFinite(total) && total >= 0 && Number.isFinite(capacity) && capacity > 0 ? (total / capacity) * 100 : undefined;
114
+ }