@chankov/agent-fleet 2.0.9 → 2.0.11

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 (988) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +26 -8
  2. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
  3. package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  4. package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
  5. package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  6. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
  7. package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
  8. package/.pi/extensions/pi-voice-stt/README.md +24 -5
  9. package/.pi/extensions/pi-voice-stt/examples/stt.json +4 -4
  10. package/.pi/harnesses/agent-hub/README.md +53 -18
  11. package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
  12. package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
  13. package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  14. package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  15. package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
  16. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
  17. package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  18. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  19. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  20. package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
  21. package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
  22. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
  23. package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
  24. package/.pi/harnesses/agent-hub/delegate.ts +19 -2
  25. package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  26. package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  27. package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  28. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
  29. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
  30. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
  31. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
  32. package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
  33. package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  34. package/.pi/harnesses/agent-hub/helpers.ts +5 -1
  35. package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
  36. package/.pi/harnesses/agent-hub/index.ts +145 -14
  37. package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
  38. package/.pi/harnesses/agent-hub/package.json +1 -1
  39. package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
  40. package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  41. package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
  42. package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
  43. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
  44. package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  45. package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
  46. package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
  47. package/.pi/harnesses/agent-hub/return-contract.js +34 -0
  48. package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  49. package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  50. package/.pi/harnesses/agent-hub/spawn.ts +61 -7
  51. package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  52. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  53. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  54. package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  55. package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
  56. package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
  57. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  58. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +253 -41
  59. package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  60. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
  61. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
  62. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
  63. package/.pi/harnesses/agent-hub/types.ts +2 -0
  64. package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  65. package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
  66. package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  67. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
  68. package/.pi/harnesses/coms/package.json +1 -1
  69. package/.pi/harnesses/damage-control-continue/index.ts +9 -0
  70. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  71. package/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  72. package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  73. package/.versions/2.0.10/.pi/agent-fleet/hermes/README.md +347 -0
  74. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  75. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  76. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  77. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  78. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  79. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  80. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  81. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  82. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  83. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  84. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  85. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  86. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  87. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  88. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  89. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  90. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  91. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  92. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  93. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  94. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  95. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  96. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  97. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  98. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  99. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  100. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  101. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  102. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  103. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  104. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  105. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  106. package/.versions/2.0.10/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  107. package/.versions/2.0.10/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  108. package/.versions/2.0.10/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  109. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  110. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  111. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  112. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  113. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  114. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet.ts +216 -0
  115. package/.versions/2.0.10/.pi/agent-fleet/scripts/flow.ts +137 -0
  116. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  117. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  118. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  119. package/.versions/2.0.10/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  120. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  121. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  122. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  123. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  124. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  125. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  126. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  127. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  128. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  129. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  130. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  131. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  132. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  133. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  134. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  135. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  136. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  137. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  138. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  139. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  140. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  141. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  142. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  143. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  144. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  145. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  146. package/.versions/2.0.10/.pi/agent-fleet/scripts/package-lock.json +35 -0
  147. package/.versions/2.0.10/.pi/agent-fleet/scripts/package.json +9 -0
  148. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  149. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  150. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  151. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-up.ts +378 -0
  152. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  153. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  154. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  155. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  156. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  157. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  158. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  159. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  160. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  161. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  162. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  163. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  164. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  165. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  166. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  167. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  168. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  169. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  170. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  171. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  172. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  173. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  174. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  175. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  176. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  177. package/.versions/2.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  178. package/.versions/2.0.10/.pi/agents/model-profiles.yaml +83 -0
  179. package/.versions/2.0.10/.pi/agents/peers.yaml +147 -0
  180. package/.versions/2.0.10/.pi/agents/teams.yaml +41 -0
  181. package/.versions/2.0.10/.pi/agents/voices.yaml +13 -0
  182. package/.versions/2.0.10/.pi/damage-control-rules.yaml +297 -0
  183. package/.versions/2.0.10/.pi/extensions/btw/README.md +120 -0
  184. package/.versions/2.0.10/.pi/extensions/btw/index.ts +914 -0
  185. package/.versions/2.0.10/.pi/extensions/btw/package.json +6 -0
  186. package/.versions/2.0.10/.pi/extensions/btw/state.js +179 -0
  187. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  188. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  189. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  190. package/.versions/2.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  191. package/.versions/2.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  192. package/.versions/2.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  193. package/.versions/2.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  194. package/.versions/2.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  195. package/.versions/2.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  196. package/.versions/2.0.10/.pi/extensions/package-lock.json +1175 -0
  197. package/.versions/2.0.10/.pi/extensions/package.json +9 -0
  198. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/README.md +224 -0
  199. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  200. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  201. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  202. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  203. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  204. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  205. package/.versions/2.0.10/.pi/harnesses/agent-hub/README.md +1217 -0
  206. package/.versions/2.0.10/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  207. package/.versions/2.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  208. package/.versions/2.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  209. package/.versions/2.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  210. package/.versions/2.0.10/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  211. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  212. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  213. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  214. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  215. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  216. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  217. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  218. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  219. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  220. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  221. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  222. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  223. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  224. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  225. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  226. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  227. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  228. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  229. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  230. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  231. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  232. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  233. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  234. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  235. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  236. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  237. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  238. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  239. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  240. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  241. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  242. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  243. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  244. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  245. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  246. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  247. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  248. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  249. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  250. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  251. package/.versions/2.0.10/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  252. package/.versions/2.0.10/.pi/harnesses/agent-hub/delegate.ts +446 -0
  253. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  254. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  255. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  256. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  257. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  258. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  259. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  260. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  261. package/.versions/2.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  262. package/.versions/2.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  263. package/.versions/2.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  264. package/.versions/2.0.10/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  265. package/.versions/2.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  266. package/.versions/2.0.10/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  267. package/.versions/2.0.10/.pi/harnesses/agent-hub/footer.ts +30 -0
  268. package/.versions/2.0.10/.pi/harnesses/agent-hub/helpers.ts +266 -0
  269. package/.versions/2.0.10/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  270. package/.versions/2.0.10/.pi/harnesses/agent-hub/index.ts +2132 -0
  271. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  272. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  273. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  274. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  275. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  276. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  277. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  278. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  279. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  280. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  281. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  282. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  283. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  284. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  285. package/.versions/2.0.10/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  286. package/.versions/2.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  287. package/.versions/2.0.10/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  288. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  289. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  290. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  291. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  292. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  293. package/.versions/2.0.10/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  294. package/.versions/2.0.10/.pi/harnesses/agent-hub/presentation.ts +48 -0
  295. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  296. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  297. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  298. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  299. package/.versions/2.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  300. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  301. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  302. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  303. package/.versions/2.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  304. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-contract.js +327 -0
  305. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  306. package/.versions/2.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  307. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-budget.js +537 -0
  308. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  309. package/.versions/2.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  310. package/.versions/2.0.10/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  311. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  312. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-start.ts +42 -0
  313. package/.versions/2.0.10/.pi/harnesses/agent-hub/spawn.ts +404 -0
  314. package/.versions/2.0.10/.pi/harnesses/agent-hub/timeline.ts +54 -0
  315. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  316. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  317. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  318. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  319. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +335 -0
  320. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  321. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  322. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  323. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  324. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  325. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  326. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  327. package/.versions/2.0.10/.pi/harnesses/agent-hub/types.ts +63 -0
  328. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  329. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  330. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  331. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  332. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  333. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  334. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  335. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  336. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  337. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  338. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  339. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  340. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  341. package/.versions/2.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  342. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  343. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  344. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/README.md +59 -0
  345. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/index.ts +558 -0
  346. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  347. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  348. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  349. package/.versions/2.0.10/.pi/harnesses/coms/README.md +100 -0
  350. package/.versions/2.0.10/.pi/harnesses/coms/index.ts +282 -0
  351. package/.versions/2.0.10/.pi/harnesses/coms/package.json +7 -0
  352. package/.versions/2.0.10/.pi/harnesses/coms/version.ts +42 -0
  353. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/README.md +135 -0
  354. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/index.ts +541 -0
  355. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  356. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  357. package/.versions/2.0.10/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  358. package/.versions/2.0.10/.pi/harnesses/lib/coms-core-io.ts +385 -0
  359. package/.versions/2.0.10/.pi/harnesses/lib/coms-core.ts +577 -0
  360. package/.versions/2.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  361. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  362. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  363. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-view.ts +107 -0
  364. package/.versions/2.0.10/.pi/harnesses/lib/context-budget.ts +114 -0
  365. package/.versions/2.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  366. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  367. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  368. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  369. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  370. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  371. package/.versions/2.0.10/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  372. package/.versions/2.0.10/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  373. package/.versions/2.0.10/.pi/harnesses/lib/fleet-panel.ts +34 -0
  374. package/.versions/2.0.10/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  375. package/.versions/2.0.10/.pi/harnesses/lib/fleet-selection.ts +24 -0
  376. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  377. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  378. package/.versions/2.0.10/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  379. package/.versions/2.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  380. package/.versions/2.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  381. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  382. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  383. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  384. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  385. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  386. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  387. package/.versions/2.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  388. package/.versions/2.0.10/.pi/harnesses/lib/update-check.ts +222 -0
  389. package/.versions/2.0.10/.pi/harnesses/package-lock.json +2039 -0
  390. package/.versions/2.0.10/.pi/harnesses/package.json +10 -0
  391. package/.versions/2.0.10/.pi/prompts/af-build.md +24 -0
  392. package/.versions/2.0.10/.pi/prompts/af-code-simplify.md +22 -0
  393. package/.versions/2.0.10/.pi/prompts/af-constraints.md +31 -0
  394. package/.versions/2.0.10/.pi/prompts/af-plan.md +17 -0
  395. package/.versions/2.0.10/.pi/prompts/af-review.md +16 -0
  396. package/.versions/2.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  397. package/.versions/2.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  398. package/.versions/2.0.10/.pi/prompts/af-ship.md +17 -0
  399. package/.versions/2.0.10/.pi/prompts/af-spec.md +15 -0
  400. package/.versions/2.0.10/.pi/prompts/af-test.md +19 -0
  401. package/.versions/2.0.10/.pi/skills/bowser/SKILL.md +145 -0
  402. package/.versions/2.0.10/.version +1 -0
  403. package/.versions/2.0.10/agents/architect.md +25 -0
  404. package/.versions/2.0.10/agents/bowser.md +28 -0
  405. package/.versions/2.0.10/agents/builder.md +56 -0
  406. package/.versions/2.0.10/agents/code-reviewer.md +210 -0
  407. package/.versions/2.0.10/agents/deep-researcher.md +33 -0
  408. package/.versions/2.0.10/agents/documenter.md +23 -0
  409. package/.versions/2.0.10/agents/orchestrator.md +23 -0
  410. package/.versions/2.0.10/agents/plan-reviewer.md +84 -0
  411. package/.versions/2.0.10/agents/planner.md +106 -0
  412. package/.versions/2.0.10/agents/releaser.md +25 -0
  413. package/.versions/2.0.10/agents/researcher.md +31 -0
  414. package/.versions/2.0.10/agents/security-auditor.md +168 -0
  415. package/.versions/2.0.10/agents/test-engineer.md +154 -0
  416. package/.versions/2.0.10/agents/web-debugger.md +44 -0
  417. package/.versions/2.0.10/agents/web-performance-auditor.md +194 -0
  418. package/.versions/2.0.10/bin/catalog/harness-runtime-closure.json +32 -0
  419. package/.versions/2.0.10/codex/fleet-session-client/SKILL.md +34 -0
  420. package/.versions/2.0.10/codex/fleet-session-client.zip +0 -0
  421. package/.versions/2.0.10/docs/ARCHITECTURE.md +416 -0
  422. package/.versions/2.0.10/docs/agent-fleet-setup.md +586 -0
  423. package/.versions/2.0.10/docs/claude-code-coms-bridge.md +134 -0
  424. package/.versions/2.0.10/docs/codex-session-bridge.md +219 -0
  425. package/.versions/2.0.10/docs/coms-hermes-bridge.md +188 -0
  426. package/.versions/2.0.10/docs/getting-started.md +126 -0
  427. package/.versions/2.0.10/docs/npm-install.md +383 -0
  428. package/.versions/2.0.10/docs/pi-extensions.md +449 -0
  429. package/.versions/2.0.10/docs/pi-setup.md +92 -0
  430. package/.versions/2.0.10/docs/skill-anatomy.md +150 -0
  431. package/.versions/2.0.10/install-manifest.json +2991 -0
  432. package/.versions/2.0.10/justfile +247 -0
  433. package/.versions/2.0.10/manifest-meta.json +970 -0
  434. package/.versions/2.0.10/references/accessibility-checklist.md +160 -0
  435. package/.versions/2.0.10/references/communication-contract.md +26 -0
  436. package/.versions/2.0.10/references/definition-of-done.md +67 -0
  437. package/.versions/2.0.10/references/fleet-coordination-patterns.md +171 -0
  438. package/.versions/2.0.10/references/observability-checklist.md +92 -0
  439. package/.versions/2.0.10/references/orchestration-patterns.md +370 -0
  440. package/.versions/2.0.10/references/performance-checklist.md +236 -0
  441. package/.versions/2.0.10/references/prompting-patterns.md +380 -0
  442. package/.versions/2.0.10/references/security-checklist.md +245 -0
  443. package/.versions/2.0.10/references/testing-patterns.md +235 -0
  444. package/.versions/2.0.10/references/workflow-authoring.md +304 -0
  445. package/.versions/2.0.10/skills/_internal/grilling.md +59 -0
  446. package/.versions/2.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  447. package/.versions/2.0.10/skills/code-review-and-quality/SKILL.md +396 -0
  448. package/.versions/2.0.10/skills/compound-learning/SKILL.md +137 -0
  449. package/.versions/2.0.10/skills/constraint-driven-development/SKILL.md +338 -0
  450. package/.versions/2.0.10/skills/constraint-driven-development/references/floor-guard.md +99 -0
  451. package/.versions/2.0.10/skills/context-engineering/SKILL.md +341 -0
  452. package/.versions/2.0.10/skills/deprecation-and-migration/SKILL.md +247 -0
  453. package/.versions/2.0.10/skills/designing-agents/SKILL.md +394 -0
  454. package/.versions/2.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  455. package/.versions/2.0.10/skills/drafting-workflows/SKILL.md +143 -0
  456. package/.versions/2.0.10/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  457. package/.versions/2.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  458. package/.versions/2.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  459. package/.versions/2.0.10/skills/idea-refine/SKILL.md +182 -0
  460. package/.versions/2.0.10/skills/idea-refine/examples.md +238 -0
  461. package/.versions/2.0.10/skills/idea-refine/frameworks.md +99 -0
  462. package/.versions/2.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  463. package/.versions/2.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  464. package/.versions/2.0.10/skills/incremental-implementation/SKILL.md +302 -0
  465. package/.versions/2.0.10/skills/interview-me/SKILL.md +226 -0
  466. package/.versions/2.0.10/skills/orchestration-verification/SKILL.md +182 -0
  467. package/.versions/2.0.10/skills/peer-coms/SKILL.md +90 -0
  468. package/.versions/2.0.10/skills/performance-optimization/SKILL.md +496 -0
  469. package/.versions/2.0.10/skills/planning-and-task-breakdown/SKILL.md +289 -0
  470. package/.versions/2.0.10/skills/security-and-hardening/SKILL.md +524 -0
  471. package/.versions/2.0.10/skills/spec-driven-development/SKILL.md +295 -0
  472. package/.versions/2.0.10/skills/using-agent-skills/SKILL.md +198 -0
  473. package/.versions/2.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  474. package/.versions/2.0.10/vendor/agent-skills-upstream/README.md +430 -0
  475. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  476. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  477. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  478. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  479. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  480. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  481. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  482. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  483. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  484. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  485. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  486. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  487. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  488. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  489. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  490. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  491. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  492. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  493. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  494. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  495. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  496. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  497. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  498. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  499. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  500. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  501. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  502. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  503. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  504. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  505. package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
  506. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  507. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  508. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  509. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  510. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  511. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  512. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  513. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  514. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  515. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  516. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  517. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  518. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  519. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  520. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  521. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  522. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  523. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  524. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  525. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  526. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  527. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  528. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  529. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  530. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  531. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  532. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  533. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  534. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  535. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  536. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  537. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  538. package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  539. package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  540. package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  541. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  542. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  543. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  544. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  545. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  546. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
  547. package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
  548. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  549. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  550. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  551. package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  552. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  553. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  554. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  555. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  556. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  557. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  558. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  559. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  560. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  561. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  562. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  563. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  564. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  565. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  566. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  567. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  568. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  569. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  570. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  571. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  572. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  573. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  574. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  575. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  576. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  577. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  578. package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
  579. package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
  580. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  581. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  582. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  583. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
  584. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  585. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  586. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  587. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  588. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  589. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  590. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  591. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  592. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  593. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  594. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  595. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  596. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  597. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  598. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  599. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  600. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  601. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  602. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  603. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  604. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  605. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  606. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  607. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  608. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  609. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  610. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  611. package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  612. package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
  613. package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
  614. package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
  615. package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
  616. package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
  617. package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
  618. package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
  619. package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
  620. package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
  621. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  622. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  623. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  624. package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  625. package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  626. package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  627. package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  628. package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  629. package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  630. package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
  631. package/.versions/2.0.11/.pi/extensions/package.json +9 -0
  632. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
  633. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  634. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  635. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  636. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  637. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  638. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  639. package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
  640. package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  641. package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  642. package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  643. package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  644. package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  645. package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  646. package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  647. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  648. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
  649. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  650. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
  651. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  652. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  653. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  654. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  655. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  656. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  657. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  658. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  659. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  660. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  661. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  662. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  663. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  664. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  665. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  666. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  667. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
  668. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  669. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  670. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  671. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  672. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  673. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  674. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  675. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  676. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  677. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  678. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  679. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  680. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  681. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  682. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  683. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  684. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  685. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  686. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  687. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  688. package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  689. package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
  690. package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  691. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  692. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  693. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  694. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  695. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
  696. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  697. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
  698. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
  699. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  700. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  701. package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  702. package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  703. package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  704. package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  705. package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  706. package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  707. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
  708. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  709. package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
  710. package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
  711. package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  712. package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
  713. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  714. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  715. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  716. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  717. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  718. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  719. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  720. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  721. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  722. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  723. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  724. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  725. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  726. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  727. package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
  728. package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  729. package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  730. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  731. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  732. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  733. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  734. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  735. package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  736. package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
  737. package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  738. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  739. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  740. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  741. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  742. package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  743. package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  744. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  745. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  746. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  747. package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  748. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
  749. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  750. package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  751. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
  752. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  753. package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  754. package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  755. package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  756. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  757. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  758. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
  759. package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
  760. package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  761. package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
  762. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  763. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  764. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  765. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  766. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  767. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  768. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  769. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
  770. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  771. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  772. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  773. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  774. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  775. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  776. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  777. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  778. package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
  779. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  780. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  781. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  782. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  783. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  784. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  785. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  786. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  787. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  788. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  789. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  790. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  791. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  792. package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  793. package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  794. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  795. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  796. package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  797. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
  798. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
  799. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  800. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  801. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  802. package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
  803. package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
  804. package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
  805. package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
  806. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
  807. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
  808. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  809. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  810. package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  811. package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
  812. package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
  813. package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  814. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  815. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  816. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
  817. package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
  818. package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  819. package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  820. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  821. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  822. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  823. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  824. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  825. package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  826. package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  827. package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
  828. package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  829. package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
  830. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  831. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  832. package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  833. package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  834. package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  835. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  836. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  837. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  838. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  839. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  840. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  841. package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  842. package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
  843. package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
  844. package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
  845. package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
  846. package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
  847. package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
  848. package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
  849. package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
  850. package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  851. package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  852. package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
  853. package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
  854. package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
  855. package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
  856. package/.versions/2.0.11/.version +1 -0
  857. package/.versions/2.0.11/agents/architect.md +25 -0
  858. package/.versions/2.0.11/agents/bowser.md +28 -0
  859. package/.versions/2.0.11/agents/builder.md +56 -0
  860. package/.versions/2.0.11/agents/code-reviewer.md +210 -0
  861. package/.versions/2.0.11/agents/deep-researcher.md +33 -0
  862. package/.versions/2.0.11/agents/documenter.md +23 -0
  863. package/.versions/2.0.11/agents/orchestrator.md +23 -0
  864. package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
  865. package/.versions/2.0.11/agents/planner.md +106 -0
  866. package/.versions/2.0.11/agents/releaser.md +25 -0
  867. package/.versions/2.0.11/agents/researcher.md +31 -0
  868. package/.versions/2.0.11/agents/security-auditor.md +168 -0
  869. package/.versions/2.0.11/agents/test-engineer.md +154 -0
  870. package/.versions/2.0.11/agents/web-debugger.md +44 -0
  871. package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
  872. package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
  873. package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
  874. package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
  875. package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
  876. package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
  877. package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
  878. package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
  879. package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
  880. package/.versions/2.0.11/docs/getting-started.md +126 -0
  881. package/.versions/2.0.11/docs/npm-install.md +383 -0
  882. package/.versions/2.0.11/docs/pi-extensions.md +449 -0
  883. package/.versions/2.0.11/docs/pi-setup.md +92 -0
  884. package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
  885. package/.versions/2.0.11/install-manifest.json +3020 -0
  886. package/.versions/2.0.11/justfile +247 -0
  887. package/.versions/2.0.11/manifest-meta.json +970 -0
  888. package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
  889. package/.versions/2.0.11/references/communication-contract.md +26 -0
  890. package/.versions/2.0.11/references/definition-of-done.md +67 -0
  891. package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
  892. package/.versions/2.0.11/references/observability-checklist.md +92 -0
  893. package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
  894. package/.versions/2.0.11/references/performance-checklist.md +236 -0
  895. package/.versions/2.0.11/references/prompting-patterns.md +380 -0
  896. package/.versions/2.0.11/references/security-checklist.md +245 -0
  897. package/.versions/2.0.11/references/testing-patterns.md +235 -0
  898. package/.versions/2.0.11/references/workflow-authoring.md +304 -0
  899. package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
  900. package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  901. package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
  902. package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
  903. package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
  904. package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
  905. package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
  906. package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
  907. package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
  908. package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  909. package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
  910. package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  911. package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  912. package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  913. package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
  914. package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
  915. package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
  916. package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  917. package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  918. package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
  919. package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
  920. package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
  921. package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
  922. package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
  923. package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
  924. package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
  925. package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
  926. package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
  927. package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  928. package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
  929. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  930. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  931. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  932. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  933. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  934. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  935. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  936. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  937. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  938. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  939. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  940. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  941. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  942. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  943. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  944. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  945. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  946. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  947. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  948. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  949. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  950. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  951. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  952. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  953. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  954. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  955. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  956. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  957. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  958. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  959. package/CHANGELOG.md +19 -0
  960. package/README.md +1 -0
  961. package/agents/architect.md +1 -1
  962. package/agents/bowser.md +1 -1
  963. package/agents/builder.md +1 -1
  964. package/agents/code-reviewer.md +1 -1
  965. package/agents/deep-researcher.md +1 -1
  966. package/agents/documenter.md +1 -1
  967. package/agents/orchestrator.md +1 -1
  968. package/agents/plan-reviewer.md +1 -1
  969. package/agents/planner.md +1 -1
  970. package/agents/releaser.md +1 -1
  971. package/agents/researcher.md +1 -1
  972. package/agents/security-auditor.md +1 -1
  973. package/agents/test-engineer.md +1 -1
  974. package/agents/web-debugger.md +1 -1
  975. package/agents/web-performance-auditor.md +1 -1
  976. package/bin/catalog/harness-runtime-closure.json +29 -0
  977. package/bin/cli.js +23 -9
  978. package/bin/lib/doctor.js +83 -1
  979. package/bin/lib/path-boundaries.js +5 -6
  980. package/bin/lib/stt-wizard.js +154 -23
  981. package/docs/ARCHITECTURE.md +181 -2
  982. package/docs/agent-fleet-setup.md +26 -8
  983. package/docs/npm-install.md +29 -2
  984. package/docs/pi-setup.md +16 -0
  985. package/docs/workflows.md +8 -2
  986. package/install-manifest.json +31 -2
  987. package/package.json +13 -3
  988. package/skills/orchestration-verification/SKILL.md +1 -0
@@ -12,11 +12,11 @@ import { Run, type FinishResult } from "./workflows/lib/run.ts";
12
12
  import { buildTestWorkflow, buildTestWorkflowPreflight } from "./workflows/wf-build-test.ts";
13
13
  import { documentWorkflow, documentWorkflowPreflight } from "./workflows/wf-document.ts";
14
14
  import { qualityWorkflow, qualityWorkflowPreflight } from "./workflows/wf-quality.ts";
15
- import { scoutWorkflow, scoutWorkflowPreflight } from "./workflows/wf-scout.ts";
15
+ import { scoutWorkflow, scoutWorkflowPreflight, type ScoutWorkflowDeps } from "./workflows/wf-scout.ts";
16
16
  import { pollWorkflow, pollWorkflowPreflight, pollWorkflowValidate } from "./workflows/wf-poll.ts";
17
17
  import { debateWorkflow, debateWorkflowPreflight, debateWorkflowValidate } from "./workflows/wf-debate.ts";
18
18
 
19
- export type Workflow = (run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }) => Promise<FinishResult>;
19
+ export type Workflow = (run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }, deps?: any) => Promise<FinishResult>;
20
20
  export interface WorkflowDefinition {
21
21
  run: Workflow;
22
22
  validate?: (command: FlowCommand, cwd: string) => void;
@@ -64,20 +64,31 @@ export async function resolveWorkflow(name: string, workflowsDir = resolve(dirna
64
64
  return { run: run as Workflow, ...(typeof preflight === "function" ? { preflight: preflight as (cwd: string) => void } : {}) };
65
65
  }
66
66
 
67
- export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string } = {}): Promise<FinishResult> {
67
+ export interface HubScoutExecution {
68
+ /** Hub-only no-branch mode. CLI callers omit this and retain legacy branch semantics. */
69
+ noBranch: true;
70
+ traceDirectory: string;
71
+ signal?: AbortSignal;
72
+ scoutAgent?: ScoutWorkflowDeps["agent"];
73
+ }
74
+
75
+ export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string; hubScout?: HubScoutExecution } = {}): Promise<FinishResult> {
68
76
  const cwd = options.cwd ?? process.cwd();
77
+ if (options.hubScout && command.name !== "scout") throw Object.assign(new Error("Hub no-branch execution currently permits only the read-only scout flow"), { exitCode: 2 });
69
78
  const workflow = await resolveWorkflow(command.name, options.workflowsDir);
70
79
  if (!workflow) throw Object.assign(new Error(`Unknown flow: ${command.name}`), { exitCode: 2 });
71
80
  workflow.validate?.(command, cwd);
72
81
  loadEnv(cwd);
73
- // All refusal checks precede branch creation and the FlowTrace constructor.
74
- requireCleanTree(cwd, command.allowDirty);
82
+ // CLI keeps its clean-tree + branch defaults. Hub scout runs only in a detached
83
+ // isolated snapshot and never creates or annotates a branch.
84
+ if (!options.hubScout) requireCleanTree(cwd, command.allowDirty);
75
85
  workflow.preflight?.(cwd, command);
76
86
  const runId = command.runId ?? makeRunId();
77
87
  const repositoryBaseline = snapshot(cwd);
78
- const branch = createFlowBranch(command.name, runId, cwd);
79
- const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline });
88
+ const branch = options.hubScout ? undefined : createFlowBranch(command.name, runId, cwd);
89
+ const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline, traceDirectory: options.hubScout?.traceDirectory });
80
90
  const persistResult = (result: FinishResult) => {
91
+ if (!branch) return;
81
92
  try { recordFlowResult(branch, result.status, cwd); }
82
93
  catch (error) { console.error(`Warning: flow result metadata was not recorded: ${error instanceof Error ? error.message : String(error)}`); }
83
94
  };
@@ -86,10 +97,16 @@ export async function executeFlow(command: FlowCommand, options: { cwd?: string;
86
97
  if (interruption) return;
87
98
  interruption = run.interrupt(signal);
88
99
  };
100
+ const onAbort = () => { if (!interruption) interruption = run.abort("cancelled by Hub owner", 130); };
89
101
  process.once("SIGINT", onSignal);
90
102
  process.once("SIGTERM", onSignal);
103
+ options.hubScout?.signal?.addEventListener("abort", onAbort, { once: true });
91
104
  try {
92
- const result = await workflow.run(run, { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply });
105
+ if (options.hubScout?.signal?.aborted) onAbort();
106
+ const input = { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply };
107
+ const result = options.hubScout
108
+ ? await workflow.run(run, input, { ...(options.hubScout.scoutAgent ? { agent: options.hubScout.scoutAgent } : {}), dataReadRoot: cwd })
109
+ : await workflow.run(run, input);
93
110
  const finalResult = interruption ?? result;
94
111
  persistResult(finalResult);
95
112
  console.error(finalResult.banner);
@@ -108,6 +125,7 @@ export async function executeFlow(command: FlowCommand, options: { cwd?: string;
108
125
  } finally {
109
126
  process.removeListener("SIGINT", onSignal);
110
127
  process.removeListener("SIGTERM", onSignal);
128
+ options.hubScout?.signal?.removeEventListener("abort", onAbort);
111
129
  }
112
130
  }
113
131
 
@@ -1,12 +1,17 @@
1
1
  import { profileFallback } from './model-profile.ts';
2
2
  import type { ChildProcess } from "node:child_process";
3
- import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
3
+ import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
4
+ import { homedir } from "node:os";
4
5
  import { resolve } from "node:path";
6
+ import { fileURLToPath } from "node:url";
7
+ import { SCOUT_DATA_ROOT_ENV } from "./scout-data-boundary.ts";
5
8
 
6
9
  interface SpawnPiAgentOptions {
7
10
  model: string; tools: string; thinking: string; systemPrompt?: string; noSkills?: boolean; noContextFiles?: boolean;
8
11
  sessionFile: string; resume?: boolean; prompt: string; cwd?: string; extensions?: string[]; detached?: boolean;
9
12
  signal?: AbortSignal; toolWatchdog?: { timeoutMs: number | null }; turnDeadlineMs?: number | null;
13
+ env?: Record<string, string>;
14
+ writeIsolation?: { enabled: true; cwd: string; runtimePaths: string[] };
10
15
  }
11
16
  interface SpawnPiAgentResult { output: string; exitCode: number | null; assistantError?: string; spawnError?: string; stderr?: string }
12
17
  interface SpawnCallbacks { onProcess?(process: ChildProcess): void; onUsage?(usage: { input?: number; output?: number; cacheRead?: number; cacheWrite?: number }): void }
@@ -37,6 +42,8 @@ export interface AgentPhaseOptions<T = unknown> {
37
42
  toolWatchdogMs?: number; turnDeadlineMs?: number; rulesPaths?: string[]; docsPaths?: string[];
38
43
  gates?: Gate<T>[]; gateRetries?: number; protectedGlobs?: string[]; permissionPolicy?: PermissionPolicy;
39
44
  model?: string; thinking?: string; sessionTag?: string;
45
+ /** Hub scout only: confine OS writes and declared filesystem-tool data reads to this snapshot. */
46
+ dataReadRoot?: string;
40
47
  }
41
48
 
42
49
  export function modelTag(model: string): string {
@@ -95,17 +102,54 @@ export async function runAgentPhase<T = unknown>(options: AgentPhaseOptions<T>):
95
102
  options.run.trace.write("log", { phase: options.persona.name, message: `session recycled before spawn — ${overflow.message}` });
96
103
  }
97
104
  let measuredTokens = meta.contextTokens;
98
- const result = await spawnAgent({
99
- model, tools: options.persona.tools, thinking,
100
- systemPrompt: replacement, noSkills: true, noContextFiles: true, sessionFile, resume, prompt, cwd,
101
- extensions: [".pi/harnesses/damage-control-continue/index.ts"], detached: true, signal: options.run.signal,
102
- toolWatchdog: { timeoutMs: options.toolWatchdogMs ?? 120_000 }, turnDeadlineMs: options.turnDeadlineMs ?? 1_200_000,
103
- }, profileFallback(options.persona.fallbackModel), {
104
- onProcess: process => options.run.registerProcess(process, options.persona.name),
105
- onUsage: usage => {
106
- measuredTokens = Math.max(measuredTokens, Number(usage.input ?? 0) + Number(usage.output ?? 0) + Number((usage as any).cacheRead ?? 0) + Number((usage as any).cacheWrite ?? 0));
107
- },
108
- }, { midRun: !/(^|,)(write|edit)(,|$)/.test(options.persona.tools) });
105
+ const scoutBoundary = options.dataReadRoot ? fileURLToPath(new URL("./scout-data-boundary.ts", import.meta.url)) : null;
106
+ // Pi needs writable trust/auth locks even during read-only reconnaissance.
107
+ // Copy only runtime configuration, never the user's extensions or sessions.
108
+ const runtime = options.dataReadRoot ? mkdtempSync(resolve(directory, "pi-runtime-")) : null;
109
+ let result: SpawnPiAgentResult;
110
+ try {
111
+ if (runtime) {
112
+ // Match Pi's documented override without requiring its SDK in packaged CLI installs.
113
+ const configured = process.env.PI_CODING_AGENT_DIR || resolve(homedir(), ".pi", "agent");
114
+ const source = configured === "~" ? homedir() : configured.startsWith("~/") ? resolve(homedir(), configured.slice(2)) : resolve(configured);
115
+ for (const name of ["auth.json", "models.json", "settings.json", "trust.json"]) {
116
+ try {
117
+ let contents = readFileSync(resolve(source, name), "utf8");
118
+ if (name === "settings.json") {
119
+ // --no-extensions does not stop Pi resolving/installing packages.
120
+ // Managed scout loads only the explicitly supplied Fleet extensions.
121
+ const settings = JSON.parse(contents);
122
+ for (const key of ["packages", "extensions", "skills", "prompts", "themes"]) settings[key] = [];
123
+ contents = JSON.stringify(settings);
124
+ }
125
+ writeFileSync(resolve(runtime, name), contents, { mode: 0o600, flag: "wx" });
126
+ } catch (error) {
127
+ if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
128
+ }
129
+ }
130
+ mkdirSync(resolve(runtime, "tmp"), { mode: 0o700 });
131
+ }
132
+ result = await spawnAgent({
133
+ model, tools: options.persona.tools, thinking,
134
+ systemPrompt: replacement, noSkills: true, noContextFiles: true, sessionFile, resume, prompt, cwd,
135
+ extensions: scoutBoundary
136
+ ? [fileURLToPath(new URL("../../../../../.pi/harnesses/damage-control-continue/index.ts", import.meta.url)), scoutBoundary]
137
+ : [".pi/harnesses/damage-control-continue/index.ts"], detached: true, signal: options.run.signal,
138
+ ...(options.dataReadRoot ? {
139
+ env: { [SCOUT_DATA_ROOT_ENV]: resolve(options.dataReadRoot), PI_CODING_AGENT_DIR: runtime!, TMPDIR: resolve(runtime!, "tmp") },
140
+ writeIsolation: { enabled: true as const, cwd, runtimePaths: [directory] },
141
+ } : {}),
142
+ toolWatchdog: { timeoutMs: options.toolWatchdogMs ?? 120_000 }, turnDeadlineMs: options.turnDeadlineMs ?? 1_200_000,
143
+ }, profileFallback(options.persona.fallbackModel), {
144
+ onProcess: process => options.run.registerProcess(process, options.persona.name),
145
+ onUsage: usage => {
146
+ measuredTokens = Math.max(measuredTokens, Number(usage.input ?? 0) + Number(usage.output ?? 0) + Number((usage as any).cacheRead ?? 0) + Number((usage as any).cacheWrite ?? 0));
147
+ },
148
+ }, { midRun: !/(^|,)(write|edit)(,|$)/.test(options.persona.tools) });
149
+ } finally {
150
+ // Includes provider failure, cancellation, and setup/spawn exceptions.
151
+ if (runtime) rmSync(runtime, { recursive: true, force: true });
152
+ }
109
153
  meta = { contextTokens: measuredTokens };
110
154
  writeFileSync(metaFile, JSON.stringify(meta), "utf8");
111
155
  const after = snapshot(cwd);
@@ -0,0 +1,125 @@
1
+ import { createHash } from "node:crypto";
2
+ import { execFileSync } from "node:child_process";
3
+ import { chmodSync, closeSync, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, rmSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
4
+ import { constants } from "node:fs";
5
+ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
6
+
7
+ export const ISOLATED_SNAPSHOT_SCHEMA = "agent-fleet.flow-snapshot/v1" as const;
8
+ export interface SnapshotEntry { path: string; sha256: string | null; size: number; mode: number; state: "file" | "deleted" }
9
+ export interface IsolatedSnapshotManifest {
10
+ schema: typeof ISOLATED_SNAPSHOT_SCHEMA; sourceRoot: string; sourceRevision: string; sourceStateHash: string;
11
+ createdAt: string; entries: SnapshotEntry[]; excluded: string[]; workspace: string;
12
+ }
13
+
14
+ function git(cwd: string, args: string[]): string { return execFileSync("git", args, { cwd, encoding: "utf8", maxBuffer: 64 * 1024 * 1024 }); }
15
+ function safeRelative(path: string): string {
16
+ const value = path.replaceAll("\\", "/").replace(/^\.\//, "");
17
+ if (!value || isAbsolute(value) || value.split("/").includes("..") || value.includes("\0")) throw new Error(`Unsafe snapshot path: ${JSON.stringify(path)}`);
18
+ return value;
19
+ }
20
+ function sensitive(path: string): boolean {
21
+ const parts = path.toLowerCase().split("/"); const base = parts.at(-1) ?? "";
22
+ return parts.includes("agent-sessions") || parts.includes("flow-sessions") || /^\.env(?:\.|$)/.test(base) || /^(?:auth|credentials?|secrets?)\.json$/.test(base);
23
+ }
24
+ function assertInside(root: string, path: string, label: string): void {
25
+ const fromRoot = relative(root, path);
26
+ if (fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) throw new Error(`${label} escapes owned root`);
27
+ }
28
+ function pathExists(path: string): boolean { try { lstatSync(path); return true; } catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return false; throw error; } }
29
+ function assertPlainParents(root: string, relativePath: string): void {
30
+ let current = root;
31
+ for (const part of relativePath.split("/").slice(0, -1)) {
32
+ current = join(current, part);
33
+ assertInside(root, current, `Snapshot path ${relativePath}`);
34
+ if (pathExists(current) && lstatSync(current).isSymbolicLink()) throw new Error(`Snapshot path traverses symlink: ${relativePath}`);
35
+ }
36
+ }
37
+ function stableBytes(root: string, path: string): { data: Buffer; mode: number } {
38
+ const full = resolve(root, path);
39
+ assertInside(root, full, `Snapshot source ${path}`);
40
+ assertPlainParents(root, path);
41
+ let fd: number | undefined;
42
+ try {
43
+ fd = openSync(full, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
44
+ const before = fstatSync(fd);
45
+ if (!before.isFile()) throw new Error(`Snapshot source must be a plain file: ${path}`);
46
+ const data = readFileSync(fd);
47
+ const after = fstatSync(fd);
48
+ if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeMs !== after.mtimeMs) throw new Error(`Snapshot source changed while read: ${path}`);
49
+ return { data, mode: before.mode & 0o777 };
50
+ } catch (error) {
51
+ if ((error as NodeJS.ErrnoException).code === "ELOOP") throw new Error(`Snapshot source must be a plain file: ${path}`);
52
+ throw error;
53
+ } finally { if (fd !== undefined) closeSync(fd); }
54
+ }
55
+ function inspect(root: string, path: string): SnapshotEntry {
56
+ const full = resolve(root, path);
57
+ assertInside(root, full, `Snapshot source ${path}`);
58
+ assertPlainParents(root, path);
59
+ if (!pathExists(full)) return { path, sha256: null, size: 0, mode: 0, state: "deleted" };
60
+ const { data, mode } = stableBytes(root, path);
61
+ return { path, sha256: createHash("sha256").update(data).digest("hex"), size: data.length, mode, state: "file" };
62
+ }
63
+ function stateHash(entries: SnapshotEntry[]): string { return createHash("sha256").update(JSON.stringify(entries)).digest("hex"); }
64
+ function listedPaths(root: string): { included: string[]; excluded: string[] } {
65
+ const raw = git(root, ["ls-files", "-z", "--cached", "--others", "--exclude-standard"]);
66
+ const all = raw.split("\0").filter(Boolean).map(safeRelative).sort();
67
+ return { included: all.filter(path => !sensitive(path)), excluded: all.filter(sensitive) };
68
+ }
69
+ function removeOwnedLeaf(root: string, path: string): void {
70
+ const destination = resolve(root, path);
71
+ assertInside(root, destination, `Snapshot destination ${path}`);
72
+ assertPlainParents(root, path);
73
+ if (!pathExists(destination)) return;
74
+ const value = lstatSync(destination);
75
+ if (value.isDirectory() && !value.isSymbolicLink()) throw new Error(`Snapshot destination unexpectedly became a directory: ${path}`);
76
+ unlinkSync(destination); // unlink the leaf itself; never recurse through or follow its target
77
+ }
78
+ function prepareOwnedParents(root: string, path: string): void {
79
+ assertPlainParents(root, path);
80
+ mkdirSync(dirname(resolve(root, path)), { recursive: true, mode: 0o700 });
81
+ assertPlainParents(root, path);
82
+ }
83
+ function writeOwnedFile(root: string, entry: SnapshotEntry, data: Buffer): void {
84
+ const destination = resolve(root, entry.path);
85
+ assertInside(root, destination, `Snapshot destination ${entry.path}`);
86
+ prepareOwnedParents(root, entry.path);
87
+ removeOwnedLeaf(root, entry.path);
88
+ assertPlainParents(root, entry.path);
89
+ let fd: number | undefined;
90
+ try {
91
+ fd = openSync(destination, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), entry.mode);
92
+ writeSync(fd, data);
93
+ } finally { if (fd !== undefined) closeSync(fd); }
94
+ chmodSync(destination, entry.mode);
95
+ }
96
+
97
+ /** Create a detached local clone plus a stable overlay of the current working tree. Never mutates sourceRoot. */
98
+ export function createIsolatedWorkingTreeSnapshot(sourceRoot: string, workspace: string, manifestPath: string): IsolatedSnapshotManifest {
99
+ const root = resolve(sourceRoot), target = resolve(workspace);
100
+ if (target === root || !relative(root, target).startsWith("..")) throw new Error("Snapshot destination must be outside the source tree");
101
+ if (pathExists(target)) throw new Error("Snapshot destination must be newly owned and absent");
102
+ const sourceRevision = git(root, ["rev-parse", "HEAD"]).trim();
103
+ const { included, excluded } = listedPaths(root);
104
+ const first = included.map(path => inspect(root, path));
105
+ mkdirSync(dirname(target), { recursive: true, mode: 0o700 });
106
+ execFileSync("git", ["clone", "--quiet", "--no-hardlinks", "--no-checkout", root, target]);
107
+ execFileSync("git", ["checkout", "--quiet", "--detach", sourceRevision], { cwd: target });
108
+ for (const path of excluded) removeOwnedLeaf(target, path);
109
+ for (const entry of first) {
110
+ if (entry.state === "deleted") removeOwnedLeaf(target, entry.path);
111
+ else {
112
+ const { data } = stableBytes(root, entry.path);
113
+ const currentHash = createHash("sha256").update(data).digest("hex");
114
+ if (currentHash !== entry.sha256 || data.length !== entry.size) throw new Error(`Snapshot source changed before copy: ${entry.path}`);
115
+ writeOwnedFile(target, entry, data);
116
+ const copied = inspect(target, entry.path);
117
+ if (copied.sha256 !== entry.sha256 || copied.size !== entry.size) throw new Error(`Snapshot copy did not match stable source: ${entry.path}`);
118
+ }
119
+ }
120
+ const second = included.map(path => inspect(root, path));
121
+ if (stateHash(first) !== stateHash(second)) { rmSync(target, { recursive: true, force: true }); throw new Error("Source working tree changed while isolated snapshot was created"); }
122
+ const manifest: IsolatedSnapshotManifest = { schema: ISOLATED_SNAPSHOT_SCHEMA, sourceRoot: root, sourceRevision, sourceStateHash: stateHash(second), createdAt: new Date().toISOString(), entries: second, excluded, workspace: target };
123
+ mkdirSync(dirname(manifestPath), { recursive: true, mode: 0o700 }); writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o400 });
124
+ return manifest;
125
+ }
@@ -37,8 +37,8 @@ export class Run {
37
37
  private readonly cancellation = new AbortController();
38
38
  readonly signal = this.cancellation.signal;
39
39
 
40
- constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; repositoryBaseline?: PermissionSnapshot } = {}) {
41
- this.trace = options.trace ?? new FlowTrace(options);
40
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; traceDirectory?: string; repositoryBaseline?: PermissionSnapshot } = {}) {
41
+ this.trace = options.trace ?? new FlowTrace({ ...options, directory: options.traceDirectory });
42
42
  this.command = options.command ?? [];
43
43
  this.repositoryBaseline = options.repositoryBaseline;
44
44
  }
@@ -0,0 +1,55 @@
1
+ import { existsSync, lstatSync, realpathSync } from "node:fs";
2
+ import { isAbsolute, relative, resolve, sep } from "node:path";
3
+
4
+ export const SCOUT_DATA_ROOT_ENV = "AGENT_FLEET_SCOUT_DATA_ROOT";
5
+ const FILESYSTEM_TOOLS = new Set(["read", "grep", "find", "ls"]);
6
+
7
+ function hasTraversal(value: string): boolean {
8
+ return value.replaceAll("\\", "/").split("/").includes("..");
9
+ }
10
+
11
+ function inside(root: string, candidate: string): boolean {
12
+ const fromRoot = relative(root, candidate);
13
+ return fromRoot === "" || (!isAbsolute(fromRoot) && fromRoot !== ".." && !fromRoot.startsWith(`..${sep}`));
14
+ }
15
+
16
+ /** Validate model-declared filesystem data paths without restricting runtime/library reads. */
17
+ export function validateScoutDataPath(rootValue: string, cwdValue: string, inputValue: unknown): string | null {
18
+ if (typeof inputValue !== "string" || inputValue.includes("\0")) return "Scout filesystem path must be a plain string.";
19
+ if (hasTraversal(inputValue)) return "Scout filesystem traversal is denied.";
20
+ const root = realpathSync(resolve(rootValue));
21
+ // Canonicalize cwd too: Darwin tmpdir aliases (/var vs /private/var) would
22
+ // otherwise make every in-snapshot read look like an escape.
23
+ const cwd = realpathSync(resolve(cwdValue));
24
+ const candidate = resolve(cwd, inputValue || ".");
25
+ if (!inside(root, candidate)) return "Scout filesystem reads are limited to the isolated snapshot.";
26
+ let current = root;
27
+ const fromRoot = relative(root, candidate);
28
+ for (const part of fromRoot ? fromRoot.split(sep) : []) {
29
+ current = resolve(current, part);
30
+ if (!existsSync(current)) break;
31
+ if (lstatSync(current).isSymbolicLink()) return "Scout filesystem symlink traversal is denied.";
32
+ }
33
+ if (existsSync(candidate) && !inside(root, realpathSync(candidate))) return "Scout filesystem symlink escape is denied.";
34
+ return null;
35
+ }
36
+
37
+ function validatePattern(value: unknown): string | null {
38
+ if (value === undefined) return null;
39
+ if (typeof value !== "string" || value.includes("\0") || isAbsolute(value) || hasTraversal(value)) return "Scout filesystem pattern traversal is denied.";
40
+ return null;
41
+ }
42
+
43
+ export default function scoutDataBoundary(pi: { on(name: "tool_call", handler: (event: { toolName?: string; input: unknown }, ctx: { cwd: string }) => unknown): void }): void {
44
+ pi.on("tool_call", (event, ctx) => {
45
+ const tool = String(event.toolName ?? "").toLowerCase();
46
+ if (!FILESYSTEM_TOOLS.has(tool)) return;
47
+ const root = process.env[SCOUT_DATA_ROOT_ENV];
48
+ if (!root) return { block: true, reason: "Scout filesystem boundary is unavailable." };
49
+ const input = event.input as Record<string, unknown>;
50
+ const reason = validateScoutDataPath(root, ctx.cwd, tool === "read" ? input.path : (input.path ?? "."))
51
+ ?? (tool === "grep" ? validatePattern(input.glob) : null)
52
+ ?? (tool === "find" ? validatePattern(input.pattern) : null);
53
+ return reason ? { block: true, reason } : { block: false };
54
+ });
55
+ }
@@ -12,10 +12,10 @@ export class FlowTrace {
12
12
  readonly file: string;
13
13
  private ended = false;
14
14
 
15
- constructor(options: { cwd?: string; runId?: string; command?: string[]; pid?: number } = {}) {
15
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; pid?: number; directory?: string } = {}) {
16
16
  this.runId = options.runId ?? makeRunId();
17
17
  this.cwd = resolve(options.cwd ?? process.cwd());
18
- this.directory = resolve(this.cwd, ".pi", "flow-sessions", this.runId);
18
+ this.directory = options.directory ? resolve(options.directory) : resolve(this.cwd, ".pi", "flow-sessions", this.runId);
19
19
  this.file = resolve(this.directory, "trace.jsonl");
20
20
  mkdirSync(this.directory, { recursive: true });
21
21
  this.write("run_start", { pid: options.pid ?? process.pid, command: options.command ?? process.argv });
@@ -8,6 +8,8 @@ export const SCOUT_PERMISSION_POLICY: PermissionPolicy = { writes: [] };
8
8
  export interface ScoutWorkflowDeps {
9
9
  agent?: (options: Parameters<typeof runAgentPhase<ScoutReport>>[0]) => Promise<ScoutReport>;
10
10
  persona?: PersonaDefinition;
11
+ /** Present only for the Hub adapter's owned isolated snapshot. */
12
+ dataReadRoot?: string;
11
13
  }
12
14
 
13
15
  export function scoutWorkflowPreflight(cwd: string): void {
@@ -31,7 +33,7 @@ export async function scoutWorkflow(run: Run, input: { args: string[]; dryRun: b
31
33
  if (!parsed.ok) throw new Error(parsed.errors.join("; "));
32
34
  return parsed.value!;
33
35
  }
34
- return agent({ run, persona, task: request, envelope: "scout", cwd: input.cwd, permissionPolicy: SCOUT_PERMISSION_POLICY });
36
+ return agent({ run, persona, task: request, envelope: "scout", cwd: input.cwd, permissionPolicy: SCOUT_PERMISSION_POLICY, ...(deps.dataReadRoot ? { dataReadRoot: deps.dataReadRoot } : {}) });
35
37
  });
36
38
  run.trace.write("log", { phase: "scout", message: report.summary, findings: report.findings });
37
39
  return run.finish({ accepted: true });
@@ -4,7 +4,7 @@ Push-to-talk voice dictation for pi's terminal UI. Press a hotkey, speak, and th
4
4
  transcript is inserted into the prompt — or transcribed and sent in one step.
5
5
 
6
6
  A simplified, self-contained port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt),
7
- trimmed to **two** transcription backends and adapted to this repo's pi runtime.
7
+ trimmed to **three** transcription backends and adapted to this repo's pi runtime.
8
8
 
9
9
  ## How it works
10
10
 
@@ -47,15 +47,24 @@ Secrets are **never** stored in the file: the config names an environment variab
47
47
  key is read from the process environment — a gitignored `.env` at the repo root, auto-loaded by
48
48
  the `justfile`'s `dotenv-load`. See [`examples/stt.json`](examples/stt.json).
49
49
 
50
- > **Deterministic setup** can write `.ai/stt.json` and append an empty `.env`
51
- > placeholder — select the voice feature in `npx @chankov/agent-fleet setup` and answer
52
- > the provider prompts. See
50
+ > **Deterministic setup** uses the canonical nested `provider` format below. Its CLI aliases
51
+ > are `openai`, `groq`, `azure`, and `azure-openai`; these are not all runtime types. Setup can
52
+ > generate OpenAI defaults. For Groq, prepare complete nested JSON with runtime type
53
+ > `openai-compatible` and the actual Groq endpoint/model, then run setup without
54
+ > `--stt-provider groq`; other OpenAI-compatible services are not Groq. Azure Speech and Azure
55
+ > OpenAI also require complete prepared JSON when settings are missing. Setup does not guess
56
+ > provider-specific endpoints, models, deployments, or API versions. Existing supported flat
57
+ > legacy files are preserved with a runtime-compatibility warning and are not migrated
58
+ > automatically. See
53
59
  > [docs/agent-fleet-setup.md](../../../docs/agent-fleet-setup.md).
54
60
 
55
61
  ### Option 1 — Generic OpenAI-compatible endpoint
56
62
 
57
63
  Works with OpenAI Whisper, Groq, and local servers (`whisper.cpp`, `faster-whisper`) that
58
- expose `POST /v1/audio/transcriptions`.
64
+ expose `POST /v1/audio/transcriptions`. Use runtime type `openai` for the standard OpenAI
65
+ shape or `openai-compatible` to label a custom compatible service. The CLI alias `groq` does
66
+ not become a runtime `provider.type`; prepare the compatible service's real `baseUrl`, `model`,
67
+ and environment-variable name instead.
59
68
 
60
69
  ```json
61
70
  {
@@ -166,6 +175,16 @@ can be raised.
166
175
 
167
176
  ### All options
168
177
 
178
+ The canonical runtime types are `openai`, `openai-compatible`, `azure`, and `azure-openai`.
179
+ `azure` calls Azure Speech; it is not shorthand for Azure OpenAI.
180
+
181
+ Keep API keys and optional endpoint values in the workspace root's gitignored `.env`. The
182
+ config stores only names such as `apiKeyEnv` and `endpointEnv`. Deterministic setup recognizes
183
+ both `NAME=value` and `export NAME=value`, preserves existing declarations and values, and
184
+ adds only missing empty placeholders. A literal `provider.endpoint` needs no endpoint
185
+ placeholder. Setup validates the JSON shape and environment-variable names only: it neither
186
+ requires a credential to be set nor sends a request to validate one.
187
+
169
188
  | Key | Default | Notes |
170
189
  | --- | --- | --- |
171
190
  | `keybind` | `alt+s` | Any pi key id; override per-run with `PI_STT_KEYBIND` |
@@ -11,21 +11,21 @@
11
11
  "apiKeyEnv": "OPENAI_API_KEY"
12
12
  },
13
13
 
14
- "_azureExample": {
14
+ "_azureSpeechDocumentationExample": {
15
15
  "type": "azure",
16
- "endpoint": "https://fd-ai-credits.cognitiveservices.azure.com",
16
+ "endpoint": "https://<resource>.cognitiveservices.azure.com",
17
17
  "apiKeyEnv": "AZURE_SPEECH_KEY",
18
18
  "format": "detailed"
19
19
  },
20
20
 
21
- "_azureLanguageIdExample": {
21
+ "_azureSpeechLanguageIdDocumentationExample": {
22
22
  "type": "azure",
23
23
  "apiKeyEnv": "AZURE_SPEECH_KEY",
24
24
  "locales": ["bg-BG", "en-US"],
25
25
  "apiVersion": "2024-11-15"
26
26
  },
27
27
 
28
- "_azureOpenAIExample": {
28
+ "_azureOpenAIDocumentationExample": {
29
29
  "type": "azure-openai",
30
30
  "endpoint": "https://<resource>.openai.azure.com",
31
31
  "deployment": "gpt-4o-transcribe",
@@ -1181,21 +1181,56 @@ tool results; `artifacts/...` is a session-relative handoff alias, not a read-to
1181
1181
 
1182
1182
  ### No-progress stops
1183
1183
 
1184
- The first unchanged retry after a failed dispatch/research operation is refused across
1185
- turns. Identity uses actor, scope, supplied artifact contents and worktree content,
1186
- not task wording; generated runtime files are not progress. Budget renewal preserves
1187
- the guard. New input content/scope or a genuine new task can permit work. For research
1188
- without scope/artifacts, the guard conservatively treats the repository as its scope.
1189
-
1190
- A human may type `/af-retry <failed-dispatchId>` to authorize exactly one retry of
1191
- that failure. The command is audited, does not dispatch or renew budget, and stale
1192
- IDs/prose do not authorize. Same-input concurrent operations are also refused.
1193
-
1194
- The first unchanged refusal leaves the parent turn running so corrected inputs can
1195
- be supplied; a second unchanged refusal stops the turn. Successful-but-unverified
1196
- execution is **not** a no-progress failure; actual execution failure or failed
1197
- deliverable readback is. This distinction prevents acceptance policy from blocking
1198
- normal successful follow-up work.
1184
+ Unchanged failed dispatch/research retries are refused across turns using normalized
1185
+ actor, structured scope, input artifacts, actual execution conditions and worktree
1186
+ state, not task wording or scope_mode. Research scope is advisory, not isolation.
1187
+
1188
+ Operator cancellation fences the **agent identity**, including disjoint scopes,
1189
+ model/prose changes and dispatch/research inputs. Other agents' already-running work
1190
+ is not cancelled. A human `/af-retry <cancelled-dispatchId>` supplies one-use
1191
+ explicit authorization; it never dispatches or renews budget. Stale IDs cannot grant
1192
+ permission. Other failure categories cannot be authorized with this command.
1193
+
1194
+ Non-busy recovery refusals spend existing turn/task operation allowances. Exhaustion
1195
+ returns budget_refused; no new limit, parent abort, retry, wait or queue is added.
1196
+ Busy operations that never started spend no allowance. Turn reports include charged
1197
+ refusals as zero-time/zero-token no_progress_refused rows (research in its count);
1198
+ refusal totals include even uncharged budget refusals. Session execution totals
1199
+ still count real dispatch attempts rather than guard refusals.
1200
+
1201
+ The shared recovery contract is fail-closed. Protocol errors require changed
1202
+ conditions plus a trusted prior-effects inspection. The internal task-generation-bound
1203
+ establishEffects port accepts a retained inspection reference; it is not a model
1204
+ parameter or a promise that T3 exists. No T3 producer is installed yet. Unknown-tool
1205
+ recovery likewise has no trusted catalog-change producer in this slice.
1206
+
1207
+ ### Runtime verification contract
1208
+
1209
+ set_assertions.test_command declares an exact bash verification command for a test
1210
+ or code-grep requirement. It does not execute the command. For code-grep, the command
1211
+ must exit nonzero when the declared presence/absence condition fails. Native children
1212
+ run it through the existing approved bash path after edits. The child-loaded
1213
+ runtime-test-check observer preserves Pi's configured shell/prefix, execution context,
1214
+ renderers and tool_result error flag; the parent retains command, actual exit and
1215
+ before/after revisions, binding source/text/reference/critical conditions to task ID.
1216
+ Compilation only checks the minimal change requirement, never semantic assertions.
1217
+
1218
+ manual/runtime-ui requirements are explicitly unsupported by this producer. A test
1219
+ or code-grep without a command/check remains missing/unverified; a model's proven
1220
+ stamp is not runtime proof. Fresh bound runtime checks supersede old claimed ledger
1221
+ stamps; stale runtime checks do not. Runtime refs and claimedEvidenceRefs are separate.
1222
+
1223
+ agent-fleet.runtime-result/v1 reports orthogonal execution, changes, verification,
1224
+ acceptance and compatibility dimensions. Acceptance requires completed execution,
1225
+ current task, certain changed state, and all requirements/checks passing with current
1226
+ revision and retained runtime evidence. Missing/failed/stale/unsupported checks,
1227
+ unchanged/missing deliverables and uncertain attribution never accept, at any tier.
1228
+ needs_verification means unaccepted, not nearly done.
1229
+
1230
+ **Semantic limitation (operator accepted):** specialist-authored tests may pass the
1231
+ runtime gate. Runtime proves execution/state, NOT the adequacy of those tests or
1232
+ code-grep predicates. Separate code review remains required; accepted is not human
1233
+ Checkpoint A approval. No live model runs or T3/T7 implementation are included.
1199
1234
 
1200
1235
  ### Explicit delivery contract
1201
1236
 
@@ -1205,9 +1240,9 @@ records size/hash/preview and whether it changed, retains the inspected content,
1205
1240
  saves `details.assessmentPath`. Missing files, directories and unsafe symlink paths
1206
1241
  do not pass readback. An existing unchanged file is not attributed to this run.
1207
1242
 
1208
- Exit 0 returns `executionStatus: completed`, **not** acceptance. Tool status is
1209
- `completed_unverified` or `verification_failed`; `accepted: false` and the assertion
1210
- ledger keep semantic verification in the operator's hands. Every delivered return is
1243
+ Exit 0 returns `executionStatus: completed`, **not** acceptance. Without qualifying runtime checks, tool status is
1244
+ `completed_unverified` or `verification_failed` and `accepted: false`. Only the
1245
+ runtime verification contract above can produce `accepted: true`. Every delivered return is
1211
1246
  saved even without assertion IDs. Pending peer delivery remains pending.
1212
1247
 
1213
1248
  Scope roots are checked before budget confirmation/counters. Missing roots are not