@chankov/agent-fleet 2.1.0 → 2.1.1

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 (725) hide show
  1. package/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +9 -25
  2. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +31 -13
  3. package/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +2 -1
  4. package/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  5. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +9 -4
  6. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +22 -17
  7. package/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +2 -2
  8. package/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +1 -1
  9. package/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +30 -8
  10. package/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +4 -4
  11. package/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +3 -1
  12. package/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +1 -1
  13. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +3 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +3 -1
  15. package/.pi/harnesses/agent-hub/index.ts +30 -7
  16. package/.pi/harnesses/agent-hub/no-progress.ts +4 -4
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  19. package/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  20. package/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  21. package/.pi/harnesses/agent-hub/process-obligations.ts +21 -8
  22. package/.pi/harnesses/agent-hub/runtime-receipts.ts +3 -0
  23. package/.pi/harnesses/agent-hub/runtime-test-check.ts +8 -2
  24. package/.pi/harnesses/agent-hub/task-resume-contract.ts +5 -0
  25. package/.pi/harnesses/agent-hub/tools/action-executors.ts +4 -2
  26. package/.pi/harnesses/agent-hub/tools/context.ts +3 -1
  27. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +14 -12
  28. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +59 -16
  29. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +8 -2
  30. package/.pi/harnesses/coms/package.json +1 -1
  31. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  32. package/.pi/harnesses/lib/fleet-codex-event-bridge.ts +2 -1
  33. package/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  34. package/.pi/harnesses/lib/fleet-notification-validation.ts +66 -0
  35. package/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  36. package/.versions/2.1.1/.pi/agent-fleet/hermes/README.md +347 -0
  37. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  38. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  39. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  40. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  41. package/.versions/2.1.1/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  42. package/.versions/2.1.1/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  43. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  44. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  45. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  46. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  47. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  48. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  49. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  50. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  51. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  52. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  53. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  54. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  55. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  56. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  57. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  58. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  59. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  60. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  61. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  62. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  63. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  64. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  65. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  66. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  67. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  68. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  69. package/.versions/2.1.1/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  70. package/.versions/2.1.1/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  71. package/.versions/2.1.1/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  72. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  73. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  74. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  75. package/.versions/2.1.1/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  76. package/.versions/2.1.1/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  77. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  78. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  79. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet.ts +248 -0
  80. package/.versions/2.1.1/.pi/agent-fleet/scripts/flow.ts +166 -0
  81. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  82. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  83. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  84. package/.versions/2.1.1/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  85. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  86. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +106 -0
  87. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  88. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  89. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  90. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +367 -0
  91. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  92. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  93. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  94. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  95. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  96. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +116 -0
  97. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  98. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  99. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  100. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +406 -0
  101. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  102. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  103. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  104. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  105. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  106. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  107. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  108. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  109. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  110. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  111. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-command.ts +268 -0
  112. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  113. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +238 -0
  114. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  115. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  116. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  117. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  118. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  119. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  120. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  121. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  122. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  123. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  124. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  125. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  126. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  127. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  128. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  129. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  130. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  131. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  132. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  133. package/.versions/2.1.1/.pi/agent-fleet/scripts/package-lock.json +57 -0
  134. package/.versions/2.1.1/.pi/agent-fleet/scripts/package.json +10 -0
  135. package/.versions/2.1.1/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  136. package/.versions/2.1.1/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  137. package/.versions/2.1.1/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  138. package/.versions/2.1.1/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  139. package/.versions/2.1.1/.pi/agent-fleet/scripts/team-up.ts +385 -0
  140. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  141. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  142. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  143. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  144. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  145. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  146. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/git.ts +99 -0
  147. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  148. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  149. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  150. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  151. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  152. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  153. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  154. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  155. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/quality.ts +65 -0
  156. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  157. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  158. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  159. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  160. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  161. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  162. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  163. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  164. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  165. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  166. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  167. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  168. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  169. package/.versions/2.1.1/.pi/agents/dispatch-policy.yaml +32 -0
  170. package/.versions/2.1.1/.pi/agents/model-profiles.yaml +134 -0
  171. package/.versions/2.1.1/.pi/agents/peers.yaml +147 -0
  172. package/.versions/2.1.1/.pi/agents/teams.yaml +41 -0
  173. package/.versions/2.1.1/.pi/agents/voices.yaml +13 -0
  174. package/.versions/2.1.1/.pi/damage-control-rules.yaml +297 -0
  175. package/.versions/2.1.1/.pi/extensions/btw/README.md +120 -0
  176. package/.versions/2.1.1/.pi/extensions/btw/index.ts +916 -0
  177. package/.versions/2.1.1/.pi/extensions/btw/package.json +6 -0
  178. package/.versions/2.1.1/.pi/extensions/btw/state.js +179 -0
  179. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  180. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  181. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  182. package/.versions/2.1.1/.pi/extensions/compact-and-continue/README.md +42 -0
  183. package/.versions/2.1.1/.pi/extensions/compact-and-continue/index.ts +136 -0
  184. package/.versions/2.1.1/.pi/extensions/compact-and-continue/package.json +6 -0
  185. package/.versions/2.1.1/.pi/extensions/mcp-bridge/README.md +46 -0
  186. package/.versions/2.1.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  187. package/.versions/2.1.1/.pi/extensions/mcp-bridge/package.json +6 -0
  188. package/.versions/2.1.1/.pi/extensions/package-lock.json +1175 -0
  189. package/.versions/2.1.1/.pi/extensions/package.json +9 -0
  190. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/README.md +224 -0
  191. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/config.ts +199 -0
  192. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  193. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  194. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  195. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  196. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  197. package/.versions/2.1.1/.pi/harnesses/agent-hub/README.md +1584 -0
  198. package/.versions/2.1.1/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  199. package/.versions/2.1.1/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  200. package/.versions/2.1.1/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  201. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  202. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  203. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  204. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  205. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  206. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  207. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  208. package/.versions/2.1.1/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  209. package/.versions/2.1.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  210. package/.versions/2.1.1/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  211. package/.versions/2.1.1/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  212. package/.versions/2.1.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  213. package/.versions/2.1.1/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  214. package/.versions/2.1.1/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  215. package/.versions/2.1.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  216. package/.versions/2.1.1/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  217. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  218. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  219. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  220. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  221. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  222. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  223. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  224. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  225. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  226. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  227. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  228. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  229. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  230. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  231. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  232. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  233. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  234. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  235. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  236. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  237. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  238. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  239. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  240. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  241. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  242. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  243. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  244. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  245. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  246. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  247. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/agents.ts +181 -0
  248. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  249. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  250. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  251. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  252. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  253. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  254. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  255. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  256. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  257. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  258. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  259. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  260. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  261. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  262. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  263. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  264. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  265. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  266. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  267. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-window.js +108 -0
  268. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  269. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  270. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  271. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  272. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  273. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  274. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  275. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  276. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  277. package/.versions/2.1.1/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  278. package/.versions/2.1.1/.pi/harnesses/agent-hub/delegate.ts +478 -0
  279. package/.versions/2.1.1/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  280. package/.versions/2.1.1/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  281. package/.versions/2.1.1/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  282. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  283. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  284. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  285. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +301 -0
  286. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +262 -0
  287. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  288. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  289. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  290. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  291. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  292. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  293. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  294. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  295. package/.versions/2.1.1/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  296. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  297. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  298. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  299. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  300. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  301. package/.versions/2.1.1/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  302. package/.versions/2.1.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  303. package/.versions/2.1.1/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  304. package/.versions/2.1.1/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  305. package/.versions/2.1.1/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  306. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  307. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  308. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  309. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  310. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  311. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  312. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  313. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  314. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  315. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  316. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  317. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  318. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  319. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  320. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  321. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  322. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  323. package/.versions/2.1.1/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  324. package/.versions/2.1.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  325. package/.versions/2.1.1/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  326. package/.versions/2.1.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  327. package/.versions/2.1.1/.pi/harnesses/agent-hub/helpers.ts +270 -0
  328. package/.versions/2.1.1/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  329. package/.versions/2.1.1/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  330. package/.versions/2.1.1/.pi/harnesses/agent-hub/index.ts +2705 -0
  331. package/.versions/2.1.1/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  332. package/.versions/2.1.1/.pi/harnesses/agent-hub/input/shortcuts.ts +23 -0
  333. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  334. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  335. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +145 -0
  336. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  337. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  338. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  339. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  340. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  341. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  342. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  343. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  344. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  345. package/.versions/2.1.1/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  346. package/.versions/2.1.1/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  347. package/.versions/2.1.1/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  348. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  349. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  350. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  351. package/.versions/2.1.1/.pi/harnesses/agent-hub/package.json +7 -0
  352. package/.versions/2.1.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  353. package/.versions/2.1.1/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  354. package/.versions/2.1.1/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  355. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  356. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  357. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  358. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  359. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  360. package/.versions/2.1.1/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  361. package/.versions/2.1.1/.pi/harnesses/agent-hub/presentation.ts +54 -0
  362. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  363. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  364. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  365. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  366. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  367. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  368. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  369. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  370. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  371. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  372. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  373. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  374. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  375. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  376. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  377. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-snapshot.ts +279 -0
  378. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  379. package/.versions/2.1.1/.pi/harnesses/agent-hub/process-obligations.ts +177 -0
  380. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  381. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  382. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  383. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  384. package/.versions/2.1.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  385. package/.versions/2.1.1/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  386. package/.versions/2.1.1/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  387. package/.versions/2.1.1/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  388. package/.versions/2.1.1/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  389. package/.versions/2.1.1/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  390. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  391. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  392. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  393. package/.versions/2.1.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  394. package/.versions/2.1.1/.pi/harnesses/agent-hub/return-contract.js +371 -0
  395. package/.versions/2.1.1/.pi/harnesses/agent-hub/return-extract.js +77 -0
  396. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  397. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  398. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-findings.js +96 -0
  399. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  400. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  401. package/.versions/2.1.1/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  402. package/.versions/2.1.1/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  403. package/.versions/2.1.1/.pi/harnesses/agent-hub/run-budget.js +342 -0
  404. package/.versions/2.1.1/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  405. package/.versions/2.1.1/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  406. package/.versions/2.1.1/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  407. package/.versions/2.1.1/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  408. package/.versions/2.1.1/.pi/harnesses/agent-hub/scope-gate.js +233 -0
  409. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  410. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  411. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  412. package/.versions/2.1.1/.pi/harnesses/agent-hub/spawn.ts +702 -0
  413. package/.versions/2.1.1/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  414. package/.versions/2.1.1/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  415. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  416. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  417. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  418. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  419. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  420. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  421. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  422. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  423. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  424. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  425. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  426. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  427. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  428. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  429. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  430. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  431. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  432. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  433. package/.versions/2.1.1/.pi/harnesses/agent-hub/timeline.ts +72 -0
  434. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  435. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  436. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  437. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/action-executors.ts +216 -0
  438. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  439. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  440. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  441. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/context.ts +147 -0
  442. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +92 -0
  443. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +777 -0
  444. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  445. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  446. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  447. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  448. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/run-flow.ts +146 -0
  449. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  450. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  451. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  452. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  453. package/.versions/2.1.1/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  454. package/.versions/2.1.1/.pi/harnesses/agent-hub/types.ts +66 -0
  455. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  456. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  457. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  458. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  459. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +163 -0
  460. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  461. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  462. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  463. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  464. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  465. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  466. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  467. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  468. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  469. package/.versions/2.1.1/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  470. package/.versions/2.1.1/.pi/harnesses/agent-hub/version.ts +42 -0
  471. package/.versions/2.1.1/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  472. package/.versions/2.1.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  473. package/.versions/2.1.1/.pi/harnesses/agent-hub/work-mode.ts +188 -0
  474. package/.versions/2.1.1/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  475. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/README.md +59 -0
  476. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/index.ts +571 -0
  477. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  478. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  479. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  480. package/.versions/2.1.1/.pi/harnesses/coms/README.md +105 -0
  481. package/.versions/2.1.1/.pi/harnesses/coms/index.ts +308 -0
  482. package/.versions/2.1.1/.pi/harnesses/coms/package.json +7 -0
  483. package/.versions/2.1.1/.pi/harnesses/coms/version.ts +42 -0
  484. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/README.md +161 -0
  485. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/index.ts +659 -0
  486. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  487. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  488. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  489. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  490. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  491. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  492. package/.versions/2.1.1/.pi/harnesses/lib/approval-wait.ts +17 -0
  493. package/.versions/2.1.1/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  494. package/.versions/2.1.1/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  495. package/.versions/2.1.1/.pi/harnesses/lib/clarification-policy.ts +9 -0
  496. package/.versions/2.1.1/.pi/harnesses/lib/coms-core-io.ts +422 -0
  497. package/.versions/2.1.1/.pi/harnesses/lib/coms-core.ts +720 -0
  498. package/.versions/2.1.1/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  499. package/.versions/2.1.1/.pi/harnesses/lib/coms-observation.ts +74 -0
  500. package/.versions/2.1.1/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  501. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  502. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  503. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-view.ts +112 -0
  504. package/.versions/2.1.1/.pi/harnesses/lib/context-budget.ts +114 -0
  505. package/.versions/2.1.1/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  506. package/.versions/2.1.1/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  507. package/.versions/2.1.1/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  508. package/.versions/2.1.1/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  509. package/.versions/2.1.1/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  510. package/.versions/2.1.1/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  511. package/.versions/2.1.1/.pi/harnesses/lib/damage-policy.ts +35 -0
  512. package/.versions/2.1.1/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  513. package/.versions/2.1.1/.pi/harnesses/lib/damage-result-view.ts +16 -0
  514. package/.versions/2.1.1/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  515. package/.versions/2.1.1/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  516. package/.versions/2.1.1/.pi/harnesses/lib/execution-trace.ts +45 -0
  517. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  518. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  519. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  520. package/.versions/2.1.1/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  521. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  522. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  523. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  524. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  525. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  526. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  527. package/.versions/2.1.1/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  528. package/.versions/2.1.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  529. package/.versions/2.1.1/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  530. package/.versions/2.1.1/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  531. package/.versions/2.1.1/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  532. package/.versions/2.1.1/.pi/harnesses/lib/fleet-notification-validation.ts +66 -0
  533. package/.versions/2.1.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  534. package/.versions/2.1.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  535. package/.versions/2.1.1/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  536. package/.versions/2.1.1/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  537. package/.versions/2.1.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  538. package/.versions/2.1.1/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  539. package/.versions/2.1.1/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  540. package/.versions/2.1.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  541. package/.versions/2.1.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  542. package/.versions/2.1.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  543. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  544. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  545. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  546. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  547. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  548. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  549. package/.versions/2.1.1/.pi/harnesses/lib/identical-dialog.ts +27 -0
  550. package/.versions/2.1.1/.pi/harnesses/lib/installation-state.js +62 -0
  551. package/.versions/2.1.1/.pi/harnesses/lib/peer-target.ts +24 -0
  552. package/.versions/2.1.1/.pi/harnesses/lib/policy-roots.js +117 -0
  553. package/.versions/2.1.1/.pi/harnesses/lib/policy-roots.ts +32 -0
  554. package/.versions/2.1.1/.pi/harnesses/lib/process-shared.ts +9 -0
  555. package/.versions/2.1.1/.pi/harnesses/lib/resource-closure.js +26 -0
  556. package/.versions/2.1.1/.pi/harnesses/lib/safe-source-read.js +29 -0
  557. package/.versions/2.1.1/.pi/harnesses/lib/semantic-approval.ts +80 -0
  558. package/.versions/2.1.1/.pi/harnesses/lib/session-target.ts +62 -0
  559. package/.versions/2.1.1/.pi/harnesses/lib/spawned-peers.js +191 -0
  560. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  561. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  562. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  563. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  564. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-json.js +37 -0
  565. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-loader.js +53 -0
  566. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  567. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-triage.js +42 -0
  568. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-v2.js +112 -0
  569. package/.versions/2.1.1/.pi/harnesses/lib/system1/config.js +50 -0
  570. package/.versions/2.1.1/.pi/harnesses/lib/system1/contracts.ts +154 -0
  571. package/.versions/2.1.1/.pi/harnesses/lib/system1/demo.ts +95 -0
  572. package/.versions/2.1.1/.pi/harnesses/lib/system1/jev.ts +503 -0
  573. package/.versions/2.1.1/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  574. package/.versions/2.1.1/.pi/harnesses/lib/system1/selection.js +11 -0
  575. package/.versions/2.1.1/.pi/harnesses/lib/system1/service.ts +245 -0
  576. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  577. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  578. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  579. package/.versions/2.1.1/.pi/harnesses/lib/target-capabilities.js +7 -0
  580. package/.versions/2.1.1/.pi/harnesses/lib/update-check.ts +227 -0
  581. package/.versions/2.1.1/.pi/harnesses/lib/workspace-context.js +115 -0
  582. package/.versions/2.1.1/.pi/harnesses/lib/workspace-context.ts +22 -0
  583. package/.versions/2.1.1/.pi/harnesses/package-lock.json +2121 -0
  584. package/.versions/2.1.1/.pi/harnesses/package.json +13 -0
  585. package/.versions/2.1.1/.pi/prompts/af-build.md +27 -0
  586. package/.versions/2.1.1/.pi/prompts/af-code-simplify.md +22 -0
  587. package/.versions/2.1.1/.pi/prompts/af-constraints.md +31 -0
  588. package/.versions/2.1.1/.pi/prompts/af-plan.md +17 -0
  589. package/.versions/2.1.1/.pi/prompts/af-review.md +16 -0
  590. package/.versions/2.1.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  591. package/.versions/2.1.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  592. package/.versions/2.1.1/.pi/prompts/af-setup-rules.md +20 -0
  593. package/.versions/2.1.1/.pi/prompts/af-ship.md +17 -0
  594. package/.versions/2.1.1/.pi/prompts/af-spec.md +15 -0
  595. package/.versions/2.1.1/.pi/prompts/af-test.md +19 -0
  596. package/.versions/2.1.1/.pi/skills/bowser/SKILL.md +145 -0
  597. package/.versions/2.1.1/.version +1 -0
  598. package/.versions/2.1.1/agents/architect.md +24 -0
  599. package/.versions/2.1.1/agents/bowser.md +28 -0
  600. package/.versions/2.1.1/agents/builder.md +55 -0
  601. package/.versions/2.1.1/agents/code-reviewer.md +209 -0
  602. package/.versions/2.1.1/agents/deep-researcher.md +32 -0
  603. package/.versions/2.1.1/agents/documenter.md +22 -0
  604. package/.versions/2.1.1/agents/orchestrator.md +22 -0
  605. package/.versions/2.1.1/agents/plan-reviewer.md +83 -0
  606. package/.versions/2.1.1/agents/planner.md +107 -0
  607. package/.versions/2.1.1/agents/releaser.md +24 -0
  608. package/.versions/2.1.1/agents/researcher.md +30 -0
  609. package/.versions/2.1.1/agents/security-auditor.md +167 -0
  610. package/.versions/2.1.1/agents/test-engineer.md +153 -0
  611. package/.versions/2.1.1/agents/web-debugger.md +44 -0
  612. package/.versions/2.1.1/agents/web-performance-auditor.md +194 -0
  613. package/.versions/2.1.1/bin/catalog/harness-runtime-closure.json +85 -0
  614. package/.versions/2.1.1/docs/ARCHITECTURE.md +1187 -0
  615. package/.versions/2.1.1/docs/agent-fleet-setup.md +1143 -0
  616. package/.versions/2.1.1/docs/claude-code-coms-bridge.md +147 -0
  617. package/.versions/2.1.1/docs/codex-local-mcp.md +487 -0
  618. package/.versions/2.1.1/docs/codex-session-bridge.md +44 -0
  619. package/.versions/2.1.1/docs/codex-setup.md +183 -0
  620. package/.versions/2.1.1/docs/coms-hermes-bridge.md +188 -0
  621. package/.versions/2.1.1/docs/fleet-native-voice.md +137 -0
  622. package/.versions/2.1.1/docs/getting-started.md +126 -0
  623. package/.versions/2.1.1/docs/npm-install.md +535 -0
  624. package/.versions/2.1.1/docs/pi-extensions.md +455 -0
  625. package/.versions/2.1.1/docs/pi-setup.md +92 -0
  626. package/.versions/2.1.1/docs/skill-anatomy.md +150 -0
  627. package/.versions/2.1.1/install-manifest.json +3239 -0
  628. package/.versions/2.1.1/justfile +247 -0
  629. package/.versions/2.1.1/manifest-meta.json +1087 -0
  630. package/.versions/2.1.1/references/accessibility-checklist.md +160 -0
  631. package/.versions/2.1.1/references/communication-contract.md +26 -0
  632. package/.versions/2.1.1/references/definition-of-done.md +67 -0
  633. package/.versions/2.1.1/references/fleet-coordination-patterns.md +171 -0
  634. package/.versions/2.1.1/references/observability-checklist.md +92 -0
  635. package/.versions/2.1.1/references/orchestration-patterns.md +370 -0
  636. package/.versions/2.1.1/references/performance-checklist.md +236 -0
  637. package/.versions/2.1.1/references/prompting-patterns.md +380 -0
  638. package/.versions/2.1.1/references/security-checklist.md +245 -0
  639. package/.versions/2.1.1/references/testing-patterns.md +235 -0
  640. package/.versions/2.1.1/references/workflow-authoring.md +304 -0
  641. package/.versions/2.1.1/skills/_internal/grilling.md +59 -0
  642. package/.versions/2.1.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  643. package/.versions/2.1.1/skills/code-review-and-quality/SKILL.md +396 -0
  644. package/.versions/2.1.1/skills/compound-learning/SKILL.md +137 -0
  645. package/.versions/2.1.1/skills/constraint-driven-development/SKILL.md +338 -0
  646. package/.versions/2.1.1/skills/constraint-driven-development/references/floor-guard.md +99 -0
  647. package/.versions/2.1.1/skills/context-engineering/SKILL.md +341 -0
  648. package/.versions/2.1.1/skills/deprecation-and-migration/SKILL.md +247 -0
  649. package/.versions/2.1.1/skills/designing-agents/SKILL.md +394 -0
  650. package/.versions/2.1.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  651. package/.versions/2.1.1/skills/drafting-workflows/SKILL.md +143 -0
  652. package/.versions/2.1.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  653. package/.versions/2.1.1/skills/fleet-connect/SKILL.md +25 -0
  654. package/.versions/2.1.1/skills/fleet-native-voice/SKILL.md +79 -0
  655. package/.versions/2.1.1/skills/fleet-native-voice/agents/openai.yaml +4 -0
  656. package/.versions/2.1.1/skills/fleet-native-voice.zip +0 -0
  657. package/.versions/2.1.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  658. package/.versions/2.1.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  659. package/.versions/2.1.1/skills/idea-refine/SKILL.md +182 -0
  660. package/.versions/2.1.1/skills/idea-refine/examples.md +238 -0
  661. package/.versions/2.1.1/skills/idea-refine/frameworks.md +99 -0
  662. package/.versions/2.1.1/skills/idea-refine/refinement-criteria.md +113 -0
  663. package/.versions/2.1.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  664. package/.versions/2.1.1/skills/incremental-implementation/SKILL.md +353 -0
  665. package/.versions/2.1.1/skills/incremental-implementation.zip +0 -0
  666. package/.versions/2.1.1/skills/interview-me/SKILL.md +226 -0
  667. package/.versions/2.1.1/skills/orchestration-verification/SKILL.md +182 -0
  668. package/.versions/2.1.1/skills/peer-coms/SKILL.md +90 -0
  669. package/.versions/2.1.1/skills/performance-optimization/SKILL.md +496 -0
  670. package/.versions/2.1.1/skills/planning-and-task-breakdown/SKILL.md +318 -0
  671. package/.versions/2.1.1/skills/planning-and-task-breakdown.zip +0 -0
  672. package/.versions/2.1.1/skills/repository-ai-setup/SKILL.md +135 -0
  673. package/.versions/2.1.1/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  674. package/.versions/2.1.1/skills/repository-ai-setup/references/apply-contract.md +74 -0
  675. package/.versions/2.1.1/skills/repository-ai-setup/references/provenance-template.md +16 -0
  676. package/.versions/2.1.1/skills/repository-ai-setup/references/setup-flow.md +108 -0
  677. package/.versions/2.1.1/skills/repository-ai-setup/references/verify-setup.md +20 -0
  678. package/.versions/2.1.1/skills/repository-ai-setup.zip +0 -0
  679. package/.versions/2.1.1/skills/security-and-hardening/SKILL.md +524 -0
  680. package/.versions/2.1.1/skills/spec-driven-development/SKILL.md +295 -0
  681. package/.versions/2.1.1/skills/spec-driven-development.zip +0 -0
  682. package/.versions/2.1.1/skills/using-agent-skills/SKILL.md +198 -0
  683. package/.versions/2.1.1/vendor/agent-skills-upstream/LICENSE +21 -0
  684. package/.versions/2.1.1/vendor/agent-skills-upstream/README.md +430 -0
  685. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  686. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  687. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  688. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  689. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  690. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  691. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  692. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  693. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  694. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  695. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  696. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  697. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  698. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  699. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  700. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  701. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  702. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  703. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  704. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  705. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  706. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  707. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  708. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  709. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  710. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  711. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  712. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  713. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  714. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  715. package/CHANGELOG.md +10 -0
  716. package/docs/ARCHITECTURE.md +30 -1
  717. package/docs/codex-local-mcp.md +55 -2
  718. package/docs/codex-session-bridge.md +2 -2
  719. package/docs/codex-setup.md +1 -1
  720. package/docs/fleet-native-voice.md +9 -7
  721. package/install-manifest.json +24 -1
  722. package/manifest-meta.json +1 -0
  723. package/package.json +1 -1
  724. package/skills/fleet-connect/SKILL.md +25 -0
  725. package/skills/fleet-native-voice.zip +0 -0
@@ -0,0 +1,113 @@
1
+ // Optional cooperative local S6a protocol. Owner matching is routing, not caller authentication.
2
+ import { redactSecrets } from './fleet-transcript-store.ts';
3
+ export type InstructionOwner = {
4
+ project: string;
5
+ peer: string;
6
+ sessionId: string;
7
+ startedAt: string;
8
+ };
9
+ export type TerminalReceipt = {
10
+ version: 1;
11
+ owner: InstructionOwner;
12
+ wireId: string;
13
+ state: 'result' | 'failed';
14
+ text: string | null;
15
+ truncated: boolean;
16
+ observedAt: string;
17
+ };
18
+ const object = (v: unknown): v is Record<string, unknown> => !!v && typeof v === 'object' && !Array.isArray(v);
19
+ const keys = (v: Record<string, unknown>, k: string[]) => Object.keys(v).length === k.length && k.every(x => Object.hasOwn(v, x));
20
+ export const validOwner = (v: unknown): v is InstructionOwner => object(v) && keys(v, ['project', 'peer', 'sessionId', 'startedAt']) && ['project', 'peer', 'sessionId'].every(k => typeof v[k] === 'string' && /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(v[k] as string) && !(v[k] as string).includes('..')) && typeof v.startedAt === 'string' && /^\d{4}-\d\d-\d\dT[0-9:.+-]+(?:Z|[+-]\d\d:\d\d)$/.test(v.startedAt) && Number.isFinite(Date.parse(v.startedAt));
21
+ export const sameOwner = (a: InstructionOwner, b: InstructionOwner) => ['project', 'peer', 'sessionId', 'startedAt'].every(k => a[k as keyof InstructionOwner] === b[k as keyof InstructionOwner]);
22
+ export const validWire = (v: unknown): v is string => typeof v === 'string' && /^[a-f0-9]{64}$/.test(v);
23
+ export function ownerOf(identity: {
24
+ project: string;
25
+ name: string;
26
+ session_id: string;
27
+ started_at: string;
28
+ }): InstructionOwner { return { project: identity.project, peer: identity.name, sessionId: identity.session_id, startedAt: identity.started_at }; }
29
+ export function validateInstructionTag(envelope: unknown, owner: InstructionOwner): boolean {
30
+ if (!object(envelope) || !Object.hasOwn(envelope, 'instruction'))
31
+ return false;
32
+ const tag = envelope.instruction;
33
+ if (!object(tag) || !keys(tag, ['version', 'owner']) || tag.version !== 1 || !validOwner(tag.owner) || !sameOwner(tag.owner, owner) || !validWire(envelope.msg_id) || typeof envelope.prompt !== 'string' || !envelope.prompt.trim() || Buffer.byteLength(envelope.prompt) > 16384 || /[\u0000-\u0008\u000b\u000c\u000e-\u001f]/.test(envelope.prompt) || envelope.response_schema != null)
34
+ throw Error('instruction owner/version/payload mismatch');
35
+ return true;
36
+ }
37
+ export function instructionReceipt(owner: InstructionOwner, wireId: string, response: unknown, error: unknown): TerminalReceipt {
38
+ let text: string | null = null, truncated = false;
39
+ if (!error && typeof response === 'string') {
40
+ let input = response.slice(0, 16384);
41
+ truncated = input.length < response.length;
42
+ // An unterminated/truncated private key is still private.
43
+ input = input.replace(/-----BEGIN(?: [A-Z0-9]+)* PRIVATE KEY-----[\s\S]*/gi, '[REDACTED]');
44
+ const cleaned = redactSecrets(input).replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f]/g, '');
45
+ let bytes = 0;
46
+ text = '';
47
+ for (const char of cleaned) {
48
+ const n = Buffer.byteLength(char);
49
+ if (bytes + n > 4096) {
50
+ truncated = true;
51
+ break;
52
+ }
53
+ text += char;
54
+ bytes += n;
55
+ }
56
+ }
57
+ return { version: 1, owner: { ...owner }, wireId, state: error ? 'failed' : 'result', text, truncated, observedAt: new Date().toISOString() };
58
+ }
59
+ export function validTerminal(v: unknown): v is TerminalReceipt { return object(v) && keys(v, ['version', 'owner', 'wireId', 'state', 'text', 'truncated', 'observedAt']) && v.version === 1 && validOwner(v.owner) && validWire(v.wireId) && (v.state === 'result' || v.state === 'failed') && (v.text === null || typeof v.text === 'string' && Buffer.byteLength(v.text) <= 4096) && typeof v.truncated === 'boolean' && typeof v.observedAt === 'string' && v.observedAt.length <= 40 && Number.isFinite(Date.parse(v.observedAt)); }
60
+ type Manager = {
61
+ getLeafId?: () => string | null;
62
+ getEntry?: (id: string) => unknown;
63
+ };
64
+ export function handleInstructionReceipt(envelope: unknown, socket: {
65
+ write: (s: string) => unknown;
66
+ }, getOwner: () => InstructionOwner | null, manager: Manager | undefined): boolean {
67
+ if (!object(envelope) || envelope.type !== 'instruction_receipt_request')
68
+ return false;
69
+ const owner = getOwner();
70
+ let status: 'available' | 'unknown' | 'invalid' | 'stale' = 'unknown', receipt: TerminalReceipt | null = null;
71
+ const valid = keys(envelope, ['type', 'msg_id', 'version', 'owner', 'wireId', 'sender_session', 'sender_endpoint']) && typeof envelope.msg_id === 'string' && /^[A-Za-z0-9_-]{1,96}$/.test(envelope.msg_id) && envelope.version === 1 && validOwner(envelope.owner) && validWire(envelope.wireId);
72
+ if (!valid)
73
+ status = 'invalid';
74
+ else if (!owner || !sameOwner(owner, envelope.owner as InstructionOwner))
75
+ status = 'stale';
76
+ else
77
+ try {
78
+ if (manager?.getLeafId && manager.getEntry) {
79
+ const leaf = manager.getLeafId();
80
+ let id = leaf;
81
+ const seen = new Set<string>();
82
+ for (let i = 0; id && i < 256; i++) {
83
+ if (seen.has(id))
84
+ break;
85
+ seen.add(id);
86
+ const e = manager.getEntry(id);
87
+ if (!object(e) || e.id !== id)
88
+ break;
89
+ if (e.type === 'custom' && e.customType === 'coms-instruction-receipt' && object(e.data) && e.data.wireId === envelope.wireId) {
90
+ if (validTerminal(e.data) && sameOwner(e.data.owner, owner)) {
91
+ const clean=instructionReceipt(owner,e.data.wireId,e.data.text,e.data.state==='failed'?'failed':null);
92
+ receipt = {...structuredClone(e.data),text:clean.text,truncated:e.data.truncated||clean.truncated};
93
+ status = 'available';
94
+ }
95
+ break; // Corrupt exact-wire evidence never falls back to nearby/older text.
96
+ }
97
+ id = typeof e.parentId === 'string' ? e.parentId : null;
98
+ }
99
+ if(manager.getLeafId()!==leaf){status='unknown';receipt=null;}
100
+ }
101
+ }
102
+ catch {
103
+ status = 'unknown';
104
+ receipt = null;
105
+ }
106
+ const after = getOwner();
107
+ if (!owner || !after || !sameOwner(owner, after)) {
108
+ status = 'stale';
109
+ receipt = null;
110
+ }
111
+ socket.write(JSON.stringify({ type: 'instruction_receipt_response', msg_id: typeof envelope.msg_id === 'string' ? envelope.msg_id.slice(0, 96) : '', version: 1, owner: after, status, receipt }) + '\n');
112
+ return true;
113
+ }
@@ -0,0 +1,74 @@
1
+ // An addressed, read-only RPC over the existing local coms socket. Never queues prompts.
2
+ import { redactSecrets } from './fleet-transcript-store.ts';
3
+ import { createHash } from 'node:crypto';
4
+ export type ObservationOwner={project:string;peer:string;sessionId:string;startedAt:string};
5
+ export type SessionHistory={getLeafId?:()=>unknown;getEntry?:(id:string)=>unknown};
6
+ type Provider={owner:()=>ObservationOwner|null;session:()=>SessionHistory|null|undefined;questions:()=>unknown;permissions?:()=>unknown;now?:()=>number};
7
+ const object=(v:unknown):v is Record<string,unknown>=>!!v&&typeof v==='object'&&!Array.isArray(v);
8
+ const same=(a:unknown,b:unknown)=>object(a)&&object(b)&&['project','peer','sessionId','startedAt'].every(k=>typeof a[k]==='string'&&a[k]===b[k]);
9
+ const id=(v:unknown):v is string=>typeof v==='string'&&/^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$/.test(v);
10
+ const gap=(reason:string,status='unavailable')=>({status,partial:true,reasons:[reason],entries:[]});
11
+ function project(session:SessionHistory|null|undefined,owner:ObservationOwner) {
12
+ const token=(value:unknown)=>createHash('sha256').update(JSON.stringify([owner.project,owner.peer,owner.sessionId,owner.startedAt,value])).digest('hex');
13
+ if(typeof session?.getLeafId!=='function'||typeof session.getEntry!=='function')return gap('SOURCE_NOT_CONFIGURED','unsupported');
14
+ const rows:Array<{at:string;kind:string;text:string;id:string}>=[];const reasons=new Set<string>();const visited=new Set<string>();
15
+ const initial=session.getLeafId();let cursor=initial,bytes=0,full=false;
16
+ for(let count=0;cursor!==null&&count<256;count++) {
17
+ if(!id(cursor)||visited.has(cursor))return gap('SOURCE_INVALID');visited.add(cursor);
18
+ const e=session.getEntry(cursor);if(!object(e)||e.id!==cursor||e.parentId!==null&&!id(e.parentId))return gap('SOURCE_UNAVAILABLE');
19
+ cursor=e.parentId;
20
+ if(e.type!=='message'||!object(e.message)||e.message.role!=='assistant')continue;
21
+ const at=typeof e.timestamp==='string'&&Number.isFinite(Date.parse(e.timestamp))?new Date(e.timestamp).toISOString():null;
22
+ if(!at){reasons.add('SOURCE_INVALID');continue;}
23
+ const content=e.message.content;if(!Array.isArray(content)){reasons.add('SOURCE_INVALID');continue;}
24
+ const blockRows:Array<{at:string;kind:string;text:string;id:string}>=[];
25
+ const add=(ordinal:number,kind:string,text:string)=>blockRows.push({at,kind,text,id:token(['event',e.id,ordinal,kind,text,at])});
26
+ for(const [ordinal,block] of content.slice(0,128).entries()) {
27
+ if(!object(block)){reasons.add('SOURCE_INVALID');continue;}
28
+ // Thinking is deliberately outside the public projection, not missing public data.
29
+ if(block.type==='thinking')continue;
30
+ if(block.type==='text'&&typeof block.text==='string') {
31
+ if(block.text.length>8000){reasons.add('SOURCE_LIMIT');continue;}
32
+ const safe=redactSecrets(block.text);if(safe!==block.text)reasons.add('REDACTED');
33
+ if(safe.length>2000)reasons.add('TRUNCATED');
34
+ add(ordinal,'assistant',safe.slice(0,2000));
35
+ }
36
+ else if(block.type==='toolCall'&&typeof block.name==='string'&&/^[A-Za-z0-9_.:-]{1,128}$/.test(block.name))add(ordinal,'tool',block.name);
37
+ else reasons.add('SOURCE_INVALID');
38
+ }
39
+ if(content.length>=128)reasons.add('ENTRY_LIMIT');
40
+ if(['stop','error','aborted','end_turn','max_tokens','refusal'].includes(e.message.stopReason as string))add(content.length,'turn_end','turn boundary: '+e.message.stopReason);
41
+ // Walk newest -> oldest, but preserve the order inside each assistant message.
42
+ for(const r of blockRows.reverse()){
43
+ if(rows.length>=50){reasons.add('ENTRY_LIMIT');break;}
44
+ const size=Buffer.byteLength(JSON.stringify(r));if(bytes+size>49152){reasons.add('SOURCE_LIMIT');full=true;break;}
45
+ bytes+=size;rows.push(r);
46
+ }
47
+ if(full)break;
48
+ if(rows.length>=50){if(cursor!==null)reasons.add('ENTRY_LIMIT');break;}
49
+ }
50
+ if(cursor!==null)reasons.add('ENTRY_LIMIT');
51
+ if(session.getLeafId()!==initial)return gap('SOURCE_UNAVAILABLE');
52
+ return {status:'available',partial:reasons.size>0,reasons:[...reasons],entries:rows.reverse(),
53
+ window:{leaf:initial===null?null:token(['entry',initial]),ancestry:[...visited].map(entry=>token(['entry',entry])),rootReached:cursor===null}};
54
+ }
55
+ export function handleObservationEnvelope(socket:{end(data:string):unknown},envelope:Record<string,unknown>,provider:Provider):boolean {
56
+ if(envelope.type!=='observation_request')return false;
57
+ const send=(status:string,body:Record<string,unknown>={})=>{
58
+ const result={type:'observation_response',version:1,msg_id:id(envelope.msg_id)?envelope.msg_id:null,owner:provider.owner(),status,...body};
59
+ const line=JSON.stringify(result)+'\n';socket.end(Buffer.byteLength(line)<=131072?line:JSON.stringify({type:'observation_response',version:1,msg_id:result.msg_id,status:'limited'})+'\n');
60
+ };
61
+ if(envelope.version!==1||!id(envelope.msg_id)||Object.keys(envelope).some(k=>!['type','version','msg_id','sender_session','sender_endpoint','operation','owner'].includes(k))){send('invalid');return true;}
62
+ if(envelope.operation!=='snapshot'){send('unsupported');return true;}
63
+ const owner=provider.owner();if(!same(owner,envelope.owner)){send('stale');return true;}
64
+ try {
65
+ let transcript:ReturnType<typeof project>;try{transcript=project(provider.session(),owner!);}catch{transcript=gap('SOURCE_UNAVAILABLE');}
66
+ let q:unknown;try{q=provider.questions();}catch{q={status:'unavailable'};}
67
+ const questionState=object(q)&&q.status==='available'?{...q,reasons:[]}:{status:object(q)&&q.status==='unsupported'?'unsupported':'unavailable',partial:true,reasons:[object(q)&&q.status==='unsupported'?'RPC_UNSUPPORTED':'SOURCE_UNAVAILABLE'],questions:[],resolved:[],nextCursor:null};
68
+ let permissionState:unknown={status:'unsupported',partial:true,pendingCount:null,requests:[],resolved:[],nextCursor:null};
69
+ try{if(provider.permissions)permissionState=provider.permissions();}catch{permissionState={status:'unavailable',partial:true,pendingCount:null,requests:[],resolved:[],nextCursor:null};}
70
+ if(!same(owner,provider.owner())){send('stale');return true;}
71
+ send('available',{observedAt:new Date((provider.now??Date.now)()).toISOString(),transcript,questionState,permissionState});
72
+ }catch{send('unavailable');}
73
+ return true;
74
+ }
@@ -0,0 +1,99 @@
1
+ // .pi/harnesses/lib/coms-registry-entry.ts
2
+ //
3
+ // The shape written to ~/.pi/coms/projects/<project>/agents/<name>.json, and
4
+ // the one function that builds it for the 30-second heartbeat.
5
+ //
6
+ // It exists because both harnesses (the standalone coms harness and the copy
7
+ // embedded in agent-hub) had their own inline copy of the same object literal,
8
+ // and both copies wrote `started_at: nowIso()` on EVERY heartbeat. The field
9
+ // therefore never held the start of anything — it was always "about 30 seconds
10
+ // ago", and every reader that tried to show uptime showed noise. Registration
11
+ // sets `started_at`; the heartbeat carries it forward unchanged and moves
12
+ // `heartbeat_at` instead. That distinction is the whole point of this module,
13
+ // so it is stated once, here, and tested.
14
+ //
15
+ // Pure module: no pi imports, no fs, no clock of its own — `now` is passed in.
16
+ // Erasable-TS; testable under node --test.
17
+
18
+ export interface ComsRegistryEntry {
19
+ targetId?:string;
20
+ session_id: string;
21
+ name: string;
22
+ purpose: string;
23
+ model: string;
24
+ color: string;
25
+ pid: number;
26
+ endpoint: string;
27
+ cwd: string;
28
+ // When this session registered. NEVER refreshed — see the module note.
29
+ started_at: string;
30
+ explicit: boolean;
31
+ version: number;
32
+ // Live status snapshot — refreshed every keepalive tick. Optional so
33
+ // entries written before the heartbeat carried them still parse cleanly.
34
+ context_used_pct?: number | null;
35
+ context_measurement?: "measured" | "unknown";
36
+ queue_depth?: number;
37
+ heartbeat_at?: string;
38
+ }
39
+
40
+ // What the session knows about itself from registration onwards. This is the
41
+ // harness `identity` object; it is the source of every field the heartbeat is
42
+ // not allowed to invent.
43
+ export interface ComsIdentity {
44
+ targetId?:string;
45
+ session_id: string;
46
+ name: string;
47
+ purpose: string;
48
+ color: string;
49
+ cwd: string;
50
+ endpoint: string;
51
+ explicit: boolean;
52
+ model: string;
53
+ started_at: string;
54
+ }
55
+
56
+ // What is genuinely new at heartbeat time.
57
+ export interface LiveSnapshot {
58
+ now: string;
59
+ pid: number;
60
+ // The model can change mid-session (`/model`), so it is re-read rather than
61
+ // frozen at registration; falling back to the registered one when the ctx
62
+ // is not available.
63
+ model?: string | null;
64
+ contextUsedPct?: number | null;
65
+ queueDepth?: number | null;
66
+ }
67
+
68
+ // Percentages arrive from `ctx.getContextUsage()`, queue depths from a Map
69
+ // size. Both reach a human eye and a JSON file, so neither may be NaN,
70
+ // negative, or fractional.
71
+ function count(value: number | null | undefined): number {
72
+ if (typeof value !== "number" || !Number.isFinite(value)) return 0;
73
+ return Math.max(0, Math.round(value));
74
+ }
75
+
76
+ // The registry entry for a heartbeat write. Also the entry used for self-heal
77
+ // (the file was unlinked under us and is being re-created), which is why every
78
+ // field is present rather than patched onto whatever is on disk: there may be
79
+ // nothing on disk.
80
+ export function buildLiveRegistryEntry(identity: ComsIdentity, live: LiveSnapshot): ComsRegistryEntry {
81
+ return {
82
+ ...(identity.targetId?{targetId:identity.targetId}:{}),
83
+ session_id: identity.session_id,
84
+ name: identity.name,
85
+ purpose: identity.purpose,
86
+ model: live.model || identity.model,
87
+ color: identity.color,
88
+ pid: live.pid,
89
+ endpoint: identity.endpoint,
90
+ cwd: identity.cwd,
91
+ started_at: identity.started_at,
92
+ explicit: identity.explicit,
93
+ version: 1,
94
+ context_used_pct: typeof live.contextUsedPct === "number" && Number.isFinite(live.contextUsedPct) && live.contextUsedPct >= 0 ? Math.round(live.contextUsedPct) : null,
95
+ context_measurement: typeof live.contextUsedPct === "number" && Number.isFinite(live.contextUsedPct) && live.contextUsedPct >= 0 ? "measured" : "unknown",
96
+ queue_depth: count(live.queueDepth),
97
+ heartbeat_at: live.now,
98
+ };
99
+ }
@@ -0,0 +1,214 @@
1
+ import { SPECIALIST_CLARIFICATION } from "./clarification-policy.ts";
2
+ import { isAbsolute } from "node:path";
3
+ import { DELEGATE_TREE_SPAWN_BUDGET } from "../agent-hub/helpers.ts";
4
+ import { externalBlockedProtocol } from "../agent-hub/external-blocker.js";
5
+
6
+ export { DELEGATE_TREE_SPAWN_BUDGET };
7
+ export const RESEARCH_TOOLS = "read,grep,find,ls";
8
+ export const MAX_AUTO_RESEARCH_QUESTIONS = 4;
9
+ /** Deterministic reference estimate: four serialized characters per token. */
10
+ export const RESEARCH_STANDING_TOKEN_CEILING = 3_000;
11
+ export const RESEARCH_TOKEN_CHARS = 4;
12
+
13
+ export function buildClarificationProtocol(userLanguage: string, maxQuestions = MAX_AUTO_RESEARCH_QUESTIONS): string {
14
+ return `
15
+
16
+ ## Clarification protocol
17
+ ${SPECIALIST_CLARIFICATION}
18
+ Human escalations are presented in ${userLanguage}.
19
+
20
+ ## External-blocker protocol
21
+ ${externalBlockedProtocol()}
22
+
23
+ ## Research protocol
24
+ If you need reconnaissance you cannot perform with your own tools (broad code search,
25
+ reading unfamiliar areas of the codebase, summarizing docs), DO NOT guess and DO NOT
26
+ ask the user. Pause for research instead: end your turn with one or more lines of the
27
+ form
28
+
29
+ NEEDS_RESEARCH: <one specific, self-contained question>
30
+
31
+ with nothing after them. Your session pauses there; read-only research helpers are
32
+ spawned for you, each helper's findings are saved to a file, and you are resumed in
33
+ this same session with the file paths — read them and continue from where you left
34
+ off. Ask at most ${maxQuestions} questions per pause. Use ASK_USER for unresolved decisions routed through the orchestrator; use NEEDS_RESEARCH for facts that can be looked up.`;
35
+ }
36
+
37
+ export function buildDelegationProtocol(roleNames: readonly string[], spawnBudget = DELEGATE_TREE_SPAWN_BUDGET): string {
38
+ if (roleNames.length === 0) return "";
39
+ return `
40
+
41
+ ## Delegation protocol
42
+ You have a \`delegate\` tool with sub-agents on configured models
43
+ (roles: ${roleNames.join(", ")}). Delegate scoped, self-contained
44
+ sub-tasks when specialization or measured capability adds value. Routine reasoning
45
+ and bounded reads can proceed directly; delegation is optional. A child shares NONE of your
46
+ context — put everything it needs into its instruction/context. You may run up
47
+ to ${spawnBudget} delegate calls for this dispatch; parallel children are forced read-only.
48
+ Children are terminal workers: they do not receive delegate tooling at remaining depth 0.`;
49
+ }
50
+
51
+ export function buildDeliverableProtocol(agentKey: string, runNumber: number, artifactRoot = ".pi/agent-sessions/artifacts", dispatchId?: string): string {
52
+ const filename = `${agentKey}-${dispatchId ?? `run${runNumber}`}.md`;
53
+ return `
54
+
55
+ ## Deliverable-to-file protocol
56
+ 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.
57
+ 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.`;
58
+ }
59
+
60
+ export interface ChildPromptParts {
61
+ id: string;
62
+ category: "persona" | "tool" | "system" | "protocol";
63
+ label: string;
64
+ chars: number;
65
+ }
66
+
67
+ export interface SpecialistContextManifest {
68
+ persona: { name: string; sourcePath: string; primarySkillPaths: string[] };
69
+ taskSkillPaths: string[];
70
+ projectPolicy: { rulesPaths: string[]; docsPaths: string[] };
71
+ flags: { assertions: boolean; scope: boolean; artifacts: boolean };
72
+ delegateRoles: string[];
73
+ protocolIds: string[];
74
+ }
75
+
76
+ export function buildProjectRulesProtocol(paths: readonly string[]): string {
77
+ if (paths.length === 0) return "";
78
+ return `
79
+
80
+ ## Project rules
81
+ This project keeps its own rules in: ${paths.join(", ")} (${paths.some(isAbsolute) ? "absolute external references; local references are repo-relative" : "repo-relative"}).
82
+ Rules are HOW constraints — read the ones relevant to your task and comply with them.
83
+ Read a listed file directly. Resolve them index-first when they are folders: if one has a
84
+ top-level README.md or index.md, read that first and follow its loading manifest
85
+ (session bundles, "load X when Y" lists) to select only the rule files that apply;
86
+ do not bulk-read the tree. Only when a folder has no such index, discover rule files
87
+ recursively (\`find <dir> -type f\`) and read the relevant ones. If you plan or review
88
+ work, validate your subject against the rules; when delegating, pass the relevant
89
+ rule file paths and specific points to check to the child.`;
90
+ }
91
+
92
+ export function buildProjectDocsProtocol(paths: readonly string[]): string {
93
+ if (paths.length === 0) return "";
94
+ return `
95
+
96
+ ## Project docs
97
+ This project's canonical documentation entry points are: ${paths.join(", ")}
98
+ (${paths.some(isAbsolute) ? "absolute external references; local references are repo-relative" : "repo-relative"}). Docs carry WHAT/WHY context — architecture, standards, decisions.
99
+ They orient you; they are not compliance rules. Read a listed file directly. For a
100
+ listed folder, start from its README.md or index.md and follow only links relevant
101
+ to the task rather than bulk-reading doc trees. If your work changes something the
102
+ docs describe (architecture, public APIs, commands, structure), say so in your final
103
+ response so the docs can be updated.`;
104
+ }
105
+
106
+ export function buildSelectedProjectPolicyProtocol(manifest: SpecialistContextManifest): string {
107
+ const selected = new Set(manifest.protocolIds);
108
+ return (selected.has("rules") ? buildProjectRulesProtocol(manifest.projectPolicy.rulesPaths) : "") +
109
+ (selected.has("docs") ? buildProjectDocsProtocol(manifest.projectPolicy.docsPaths) : "");
110
+ }
111
+
112
+ const skillPaths = (text: string) => [...new Set(text.match(/(?:^|[\s`(])((?:\.?\/?skills\/)[\w./-]+\/SKILL\.md)/g) ?? [])]
113
+ .map(match => match.match(/((?:\.?\/?skills\/)[\w./-]+\/SKILL\.md)/)?.[1] ?? "")
114
+ .filter(Boolean);
115
+
116
+ export function buildSpecialistContextManifest(input: {
117
+ personaName: string;
118
+ personaPath: string;
119
+ personaPrompt: string;
120
+ task: string;
121
+ rulesPaths: readonly string[];
122
+ docsPaths: readonly string[];
123
+ hasAssertions: boolean;
124
+ hasScope: boolean;
125
+ hasArtifacts: boolean;
126
+ delegateRoles: readonly string[];
127
+ }): SpecialistContextManifest {
128
+ const protocolIds = ["clarification", "external-blocker", "research", "deliverable"];
129
+ if (input.rulesPaths.length) protocolIds.push("rules");
130
+ if (input.docsPaths.length) protocolIds.push("docs");
131
+ if (input.hasAssertions) protocolIds.push("verification");
132
+ if (input.delegateRoles.length) protocolIds.push("delegation");
133
+ return {
134
+ persona: { name: input.personaName, sourcePath: input.personaPath, primarySkillPaths: skillPaths(input.personaPrompt) },
135
+ taskSkillPaths: skillPaths(input.task),
136
+ projectPolicy: { rulesPaths: [...input.rulesPaths], docsPaths: [...input.docsPaths] },
137
+ flags: { assertions: input.hasAssertions, scope: input.hasScope, artifacts: input.hasArtifacts },
138
+ delegateRoles: [...input.delegateRoles],
139
+ protocolIds,
140
+ };
141
+ }
142
+
143
+ export function nativeSpecialistSystemPrompt(input: { manifest: SpecialistContextManifest; userLanguage: string; agentKey: string; runNumber: number; artifactRoot?: string; dispatchId?: string }): string {
144
+ const { manifest } = input;
145
+ const paths = (label: string, values: string[]) => values.length ? `\n${label}: ${values.join(", ")}` : "";
146
+ const framing = [
147
+ "Task is supplied via stdin.",
148
+ ...(manifest.flags.scope ? ["Declared scope is supplied via stdin."] : []),
149
+ ...(manifest.flags.artifacts ? ["Artifact paths are supplied via stdin."] : []),
150
+ ];
151
+ 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.`;
152
+ let prompt = references + buildSelectedProjectPolicyProtocol(manifest) + buildClarificationProtocol(input.userLanguage);
153
+ 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.";
154
+ if (manifest.delegateRoles.length) prompt += buildDelegationProtocol(manifest.delegateRoles);
155
+ prompt += buildDeliverableProtocol(input.agentKey, input.runNumber, input.artifactRoot, input.dispatchId);
156
+ return prompt;
157
+ }
158
+
159
+ export function specialistStandingParts(input: {
160
+ replacementPrompt: string;
161
+ toolChars: number;
162
+ }): ChildPromptParts[] {
163
+ return [
164
+ { id: "specialist-replacement", category: "system", label: "Replacement specialist manifest prompt", chars: input.replacementPrompt.length },
165
+ { id: "child-tools", category: "tool", label: "Configured child tools", chars: input.toolChars },
166
+ { id: "pi-base", category: "system", label: "Pi child base prompt inputs", chars: 0 },
167
+ ];
168
+ }
169
+
170
+ export function researchStandingParts(input: {
171
+ replacementPrompt: string;
172
+ toolChars: number;
173
+ basePromptChars: number;
174
+ }): ChildPromptParts[] {
175
+ const parts = [
176
+ { id: "research-replacement", category: "system" as const, label: "Replacement read-only research prompt", chars: input.replacementPrompt.length },
177
+ { id: "child-tools", category: "tool" as const, label: "Configured child tools", chars: input.toolChars },
178
+ { id: "pi-base", category: "system" as const, label: "Pi child base prompt inputs", chars: input.basePromptChars },
179
+ ];
180
+ const standingChars = parts.reduce((sum, part) => sum + part.chars, 0);
181
+ if (Math.ceil(standingChars / RESEARCH_TOKEN_CHARS) > RESEARCH_STANDING_TOKEN_CEILING) {
182
+ throw new Error(`Research standing overhead exceeds ${RESEARCH_STANDING_TOKEN_CEILING} estimated tokens`);
183
+ }
184
+ return parts;
185
+ }
186
+
187
+ export function delegateStandingParts(input: {
188
+ toolChars: number;
189
+ basePromptChars: number;
190
+ roleNames: readonly string[];
191
+ }): ChildPromptParts[] {
192
+ return [
193
+ { id: "delegate-protocol", category: "protocol", label: "Resolved delegate role protocol", chars: buildDelegationProtocol(input.roleNames).length },
194
+ { id: "child-tools", category: "tool", label: "Resolved delegate tools", chars: input.toolChars },
195
+ { id: "pi-base", category: "system", label: "Pi child base prompt inputs", chars: input.basePromptChars },
196
+ ];
197
+ }
198
+
199
+ export function nativeResearchSystemPrompt(input: {
200
+ personaName?: string;
201
+ personaPath?: string;
202
+ cwd: string;
203
+ rulesPaths?: readonly string[];
204
+ docsPaths?: readonly string[];
205
+ }): string {
206
+ const persona = input.personaName && input.personaPath
207
+ ? `\nSelected persona: ${input.personaName}. Its source is ${input.personaPath}; read that one file only when its role guidance is needed.`
208
+ : "\nNo persona is selected; act as a general research helper.";
209
+ const policy = buildProjectRulesProtocol(input.rulesPaths ?? []) + buildProjectDocsProtocol(input.docsPaths ?? []);
210
+ return `# Read-only Research Helper
211
+ 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}
212
+ Working directory: ${input.cwd}${policy}
213
+ 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.`;
214
+ }
@@ -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
+ }