@chankov/agent-fleet 2.0.16 → 2.0.17

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 (569) hide show
  1. package/.pi/harnesses/agent-hub/README.md +4 -0
  2. package/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  3. package/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  4. package/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  5. package/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  6. package/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  7. package/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
  8. package/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  9. package/.pi/harnesses/agent-hub/index.ts +8 -2
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
  12. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  13. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +9 -24
  14. package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
  15. package/.pi/harnesses/agent-hub/prompts/fragments.ts +7 -0
  16. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  17. package/.pi/harnesses/agent-hub/system1-communication-store.ts +29 -7
  18. package/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  19. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  20. package/.pi/harnesses/agent-hub/work-mode.ts +6 -1
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/index.ts +6 -23
  23. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  24. package/.pi/harnesses/lib/damage-control-shared.ts +29 -0
  25. package/.pi/harnesses/lib/safe-source-read.js +29 -0
  26. package/.pi/harnesses/lib/system1/config-agentic.js +14 -0
  27. package/.pi/harnesses/lib/system1/config-v2.js +6 -3
  28. package/.versions/2.0.17/.pi/agent-fleet/hermes/README.md +347 -0
  29. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  30. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  31. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  32. package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  33. package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  34. package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  35. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  36. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  37. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  38. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  39. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  40. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  41. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  42. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  43. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  44. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  45. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  46. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  47. package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  48. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  49. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  50. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  51. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  52. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  53. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  54. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  55. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  56. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  57. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  58. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  59. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  60. package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  61. package/.versions/2.0.17/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  62. package/.versions/2.0.17/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  63. package/.versions/2.0.17/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  64. package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  65. package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  66. package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  67. package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  68. package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  69. package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet.ts +217 -0
  70. package/.versions/2.0.17/.pi/agent-fleet/scripts/flow.ts +157 -0
  71. package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  72. package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  73. package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  74. package/.versions/2.0.17/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  75. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  76. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  77. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  78. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  79. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  80. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  81. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  82. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  83. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  84. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  85. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  86. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  87. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  88. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  89. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  90. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  91. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  92. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  93. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  94. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  95. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  96. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  97. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  98. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  99. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  100. package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  101. package/.versions/2.0.17/.pi/agent-fleet/scripts/package-lock.json +35 -0
  102. package/.versions/2.0.17/.pi/agent-fleet/scripts/package.json +9 -0
  103. package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  104. package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  105. package/.versions/2.0.17/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  106. package/.versions/2.0.17/.pi/agent-fleet/scripts/team-up.ts +378 -0
  107. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  108. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  109. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  110. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  111. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  112. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  113. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  114. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  115. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  116. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  117. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  118. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  119. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  120. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  121. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  122. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  123. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  124. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  125. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  126. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  127. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  128. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  129. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  130. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  131. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  132. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  133. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  134. package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  135. package/.versions/2.0.17/.pi/agents/dispatch-policy.yaml +32 -0
  136. package/.versions/2.0.17/.pi/agents/model-profiles.yaml +134 -0
  137. package/.versions/2.0.17/.pi/agents/peers.yaml +147 -0
  138. package/.versions/2.0.17/.pi/agents/teams.yaml +41 -0
  139. package/.versions/2.0.17/.pi/agents/voices.yaml +13 -0
  140. package/.versions/2.0.17/.pi/damage-control-rules.yaml +297 -0
  141. package/.versions/2.0.17/.pi/extensions/btw/README.md +120 -0
  142. package/.versions/2.0.17/.pi/extensions/btw/index.ts +914 -0
  143. package/.versions/2.0.17/.pi/extensions/btw/package.json +6 -0
  144. package/.versions/2.0.17/.pi/extensions/btw/state.js +179 -0
  145. package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  146. package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  147. package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  148. package/.versions/2.0.17/.pi/extensions/compact-and-continue/README.md +42 -0
  149. package/.versions/2.0.17/.pi/extensions/compact-and-continue/index.ts +120 -0
  150. package/.versions/2.0.17/.pi/extensions/compact-and-continue/package.json +6 -0
  151. package/.versions/2.0.17/.pi/extensions/mcp-bridge/README.md +46 -0
  152. package/.versions/2.0.17/.pi/extensions/mcp-bridge/index.ts +206 -0
  153. package/.versions/2.0.17/.pi/extensions/mcp-bridge/package.json +6 -0
  154. package/.versions/2.0.17/.pi/extensions/package-lock.json +1175 -0
  155. package/.versions/2.0.17/.pi/extensions/package.json +9 -0
  156. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/README.md +224 -0
  157. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/config.ts +198 -0
  158. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  159. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/index.ts +248 -0
  160. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/package.json +6 -0
  161. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  162. package/.versions/2.0.17/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  163. package/.versions/2.0.17/.pi/harnesses/agent-hub/README.md +1456 -0
  164. package/.versions/2.0.17/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  165. package/.versions/2.0.17/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  166. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  167. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  168. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  169. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  170. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  171. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
  172. package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  173. package/.versions/2.0.17/.pi/harnesses/agent-hub/artifacts.js +146 -0
  174. package/.versions/2.0.17/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  175. package/.versions/2.0.17/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  176. package/.versions/2.0.17/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  177. package/.versions/2.0.17/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  178. package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  179. package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  180. package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  181. package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  182. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  183. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  184. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  185. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  186. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  187. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  188. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  189. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  190. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  191. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  192. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  193. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  194. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  195. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  196. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  197. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  198. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  199. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  200. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  201. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  202. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  203. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  204. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  205. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  206. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  207. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  208. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  209. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  210. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  211. package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  212. package/.versions/2.0.17/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  213. package/.versions/2.0.17/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  214. package/.versions/2.0.17/.pi/harnesses/agent-hub/config/overrides.ts +155 -0
  215. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  216. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  217. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  218. package/.versions/2.0.17/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  219. package/.versions/2.0.17/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  220. package/.versions/2.0.17/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  221. package/.versions/2.0.17/.pi/harnesses/agent-hub/context-window.js +108 -0
  222. package/.versions/2.0.17/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  223. package/.versions/2.0.17/.pi/harnesses/agent-hub/delegate.ts +467 -0
  224. package/.versions/2.0.17/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
  225. package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  226. package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  227. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  228. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  229. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  230. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
  231. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  232. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
  233. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  234. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  235. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  236. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  237. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  238. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  239. package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  240. package/.versions/2.0.17/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  241. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  242. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  243. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  244. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  245. package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  246. package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  247. package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  248. package/.versions/2.0.17/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  249. package/.versions/2.0.17/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  250. package/.versions/2.0.17/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
  251. package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
  252. package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  253. package/.versions/2.0.17/.pi/harnesses/agent-hub/footer.ts +30 -0
  254. package/.versions/2.0.17/.pi/harnesses/agent-hub/helpers.ts +270 -0
  255. package/.versions/2.0.17/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  256. package/.versions/2.0.17/.pi/harnesses/agent-hub/index.ts +2607 -0
  257. package/.versions/2.0.17/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  258. package/.versions/2.0.17/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  259. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  260. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  261. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  262. package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  263. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  264. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  265. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  266. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  267. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  268. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  269. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  270. package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  271. package/.versions/2.0.17/.pi/harnesses/agent-hub/no-progress.ts +563 -0
  272. package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  273. package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  274. package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  275. package/.versions/2.0.17/.pi/harnesses/agent-hub/package.json +7 -0
  276. package/.versions/2.0.17/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  277. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  278. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  279. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  280. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  281. package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/work-mode.ts +136 -0
  282. package/.versions/2.0.17/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  283. package/.versions/2.0.17/.pi/harnesses/agent-hub/presentation.ts +48 -0
  284. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-config.ts +16 -0
  285. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  286. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  287. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  288. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-local.ts +71 -0
  289. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  290. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  291. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  292. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  293. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  294. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot.ts +228 -0
  295. package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  296. package/.versions/2.0.17/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  297. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
  298. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/fragments.ts +123 -0
  299. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  300. package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/system-prompt.ts +124 -0
  301. package/.versions/2.0.17/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  302. package/.versions/2.0.17/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  303. package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  304. package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  305. package/.versions/2.0.17/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  306. package/.versions/2.0.17/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  307. package/.versions/2.0.17/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  308. package/.versions/2.0.17/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
  309. package/.versions/2.0.17/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
  310. package/.versions/2.0.17/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  311. package/.versions/2.0.17/.pi/harnesses/agent-hub/return-contract.js +349 -0
  312. package/.versions/2.0.17/.pi/harnesses/agent-hub/return-extract.js +77 -0
  313. package/.versions/2.0.17/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  314. package/.versions/2.0.17/.pi/harnesses/agent-hub/review-findings.js +104 -0
  315. package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  316. package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  317. package/.versions/2.0.17/.pi/harnesses/agent-hub/run-budget.js +554 -0
  318. package/.versions/2.0.17/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  319. package/.versions/2.0.17/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  320. package/.versions/2.0.17/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  321. package/.versions/2.0.17/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  322. package/.versions/2.0.17/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  323. package/.versions/2.0.17/.pi/harnesses/agent-hub/session-health.js +110 -0
  324. package/.versions/2.0.17/.pi/harnesses/agent-hub/session-start.ts +42 -0
  325. package/.versions/2.0.17/.pi/harnesses/agent-hub/spawn.ts +534 -0
  326. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  327. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-communication-store.ts +151 -0
  328. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  329. package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  330. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  331. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  332. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  333. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  334. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  335. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  336. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  337. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  338. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  339. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  340. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  341. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  342. package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  343. package/.versions/2.0.17/.pi/harnesses/agent-hub/timeline.ts +72 -0
  344. package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  345. package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  346. package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  347. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
  348. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  349. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  350. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  351. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  352. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
  353. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  354. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  355. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  356. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  357. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  358. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  359. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  360. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  361. package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  362. package/.versions/2.0.17/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  363. package/.versions/2.0.17/.pi/harnesses/agent-hub/types.ts +66 -0
  364. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  365. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  366. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  367. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  368. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  369. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  370. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  371. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  372. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  373. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  374. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  375. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  376. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  377. package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  378. package/.versions/2.0.17/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  379. package/.versions/2.0.17/.pi/harnesses/agent-hub/version.ts +42 -0
  380. package/.versions/2.0.17/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  381. package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  382. package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode.ts +184 -0
  383. package/.versions/2.0.17/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  384. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/README.md +59 -0
  385. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/index.ts +558 -0
  386. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  387. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  388. package/.versions/2.0.17/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  389. package/.versions/2.0.17/.pi/harnesses/coms/README.md +100 -0
  390. package/.versions/2.0.17/.pi/harnesses/coms/index.ts +282 -0
  391. package/.versions/2.0.17/.pi/harnesses/coms/package.json +7 -0
  392. package/.versions/2.0.17/.pi/harnesses/coms/version.ts +42 -0
  393. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/README.md +135 -0
  394. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/index.ts +533 -0
  395. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/package.json +7 -0
  396. package/.versions/2.0.17/.pi/harnesses/damage-control-continue/version.ts +42 -0
  397. package/.versions/2.0.17/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  398. package/.versions/2.0.17/.pi/harnesses/lib/coms-core-io.ts +385 -0
  399. package/.versions/2.0.17/.pi/harnesses/lib/coms-core.ts +577 -0
  400. package/.versions/2.0.17/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  401. package/.versions/2.0.17/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  402. package/.versions/2.0.17/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  403. package/.versions/2.0.17/.pi/harnesses/lib/context-budget-view.ts +107 -0
  404. package/.versions/2.0.17/.pi/harnesses/lib/context-budget.ts +114 -0
  405. package/.versions/2.0.17/.pi/harnesses/lib/damage-control-shared.ts +226 -0
  406. package/.versions/2.0.17/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  407. package/.versions/2.0.17/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  408. package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  409. package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  410. package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  411. package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  412. package/.versions/2.0.17/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  413. package/.versions/2.0.17/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  414. package/.versions/2.0.17/.pi/harnesses/lib/fleet-panel.ts +34 -0
  415. package/.versions/2.0.17/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  416. package/.versions/2.0.17/.pi/harnesses/lib/fleet-selection.ts +24 -0
  417. package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  418. package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  419. package/.versions/2.0.17/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  420. package/.versions/2.0.17/.pi/harnesses/lib/herdr-client.ts +472 -0
  421. package/.versions/2.0.17/.pi/harnesses/lib/herdr-presence.ts +399 -0
  422. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  423. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  424. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  425. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  426. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  427. package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  428. package/.versions/2.0.17/.pi/harnesses/lib/safe-source-read.js +29 -0
  429. package/.versions/2.0.17/.pi/harnesses/lib/spawned-peers.js +191 -0
  430. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-agentic.js +14 -0
  431. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-json.js +37 -0
  432. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-loader.js +44 -0
  433. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-proactive.js +57 -0
  434. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-triage.js +42 -0
  435. package/.versions/2.0.17/.pi/harnesses/lib/system1/config-v2.js +103 -0
  436. package/.versions/2.0.17/.pi/harnesses/lib/system1/config.js +50 -0
  437. package/.versions/2.0.17/.pi/harnesses/lib/system1/contracts.ts +154 -0
  438. package/.versions/2.0.17/.pi/harnesses/lib/system1/demo.ts +95 -0
  439. package/.versions/2.0.17/.pi/harnesses/lib/system1/jev.ts +503 -0
  440. package/.versions/2.0.17/.pi/harnesses/lib/system1/selection.js +11 -0
  441. package/.versions/2.0.17/.pi/harnesses/lib/system1/service.ts +245 -0
  442. package/.versions/2.0.17/.pi/harnesses/lib/update-check.ts +222 -0
  443. package/.versions/2.0.17/.pi/harnesses/package-lock.json +2039 -0
  444. package/.versions/2.0.17/.pi/harnesses/package.json +10 -0
  445. package/.versions/2.0.17/.pi/prompts/af-build.md +27 -0
  446. package/.versions/2.0.17/.pi/prompts/af-code-simplify.md +22 -0
  447. package/.versions/2.0.17/.pi/prompts/af-constraints.md +31 -0
  448. package/.versions/2.0.17/.pi/prompts/af-plan.md +17 -0
  449. package/.versions/2.0.17/.pi/prompts/af-review.md +16 -0
  450. package/.versions/2.0.17/.pi/prompts/af-set-hermes-telegram.md +15 -0
  451. package/.versions/2.0.17/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  452. package/.versions/2.0.17/.pi/prompts/af-setup-rules.md +20 -0
  453. package/.versions/2.0.17/.pi/prompts/af-ship.md +17 -0
  454. package/.versions/2.0.17/.pi/prompts/af-spec.md +15 -0
  455. package/.versions/2.0.17/.pi/prompts/af-test.md +19 -0
  456. package/.versions/2.0.17/.pi/skills/bowser/SKILL.md +145 -0
  457. package/.versions/2.0.17/.version +1 -0
  458. package/.versions/2.0.17/agents/architect.md +24 -0
  459. package/.versions/2.0.17/agents/bowser.md +28 -0
  460. package/.versions/2.0.17/agents/builder.md +55 -0
  461. package/.versions/2.0.17/agents/code-reviewer.md +209 -0
  462. package/.versions/2.0.17/agents/deep-researcher.md +32 -0
  463. package/.versions/2.0.17/agents/documenter.md +22 -0
  464. package/.versions/2.0.17/agents/orchestrator.md +22 -0
  465. package/.versions/2.0.17/agents/plan-reviewer.md +83 -0
  466. package/.versions/2.0.17/agents/planner.md +105 -0
  467. package/.versions/2.0.17/agents/releaser.md +24 -0
  468. package/.versions/2.0.17/agents/researcher.md +30 -0
  469. package/.versions/2.0.17/agents/security-auditor.md +167 -0
  470. package/.versions/2.0.17/agents/test-engineer.md +153 -0
  471. package/.versions/2.0.17/agents/web-debugger.md +44 -0
  472. package/.versions/2.0.17/agents/web-performance-auditor.md +194 -0
  473. package/.versions/2.0.17/bin/catalog/harness-runtime-closure.json +73 -0
  474. package/.versions/2.0.17/codex/fleet-session-client/SKILL.md +34 -0
  475. package/.versions/2.0.17/codex/fleet-session-client.zip +0 -0
  476. package/.versions/2.0.17/docs/ARCHITECTURE.md +834 -0
  477. package/.versions/2.0.17/docs/agent-fleet-setup.md +1101 -0
  478. package/.versions/2.0.17/docs/claude-code-coms-bridge.md +134 -0
  479. package/.versions/2.0.17/docs/codex-session-bridge.md +219 -0
  480. package/.versions/2.0.17/docs/coms-hermes-bridge.md +188 -0
  481. package/.versions/2.0.17/docs/getting-started.md +126 -0
  482. package/.versions/2.0.17/docs/npm-install.md +530 -0
  483. package/.versions/2.0.17/docs/pi-extensions.md +454 -0
  484. package/.versions/2.0.17/docs/pi-setup.md +92 -0
  485. package/.versions/2.0.17/docs/skill-anatomy.md +150 -0
  486. package/.versions/2.0.17/install-manifest.json +3193 -0
  487. package/.versions/2.0.17/justfile +247 -0
  488. package/.versions/2.0.17/manifest-meta.json +1071 -0
  489. package/.versions/2.0.17/references/accessibility-checklist.md +160 -0
  490. package/.versions/2.0.17/references/communication-contract.md +26 -0
  491. package/.versions/2.0.17/references/definition-of-done.md +67 -0
  492. package/.versions/2.0.17/references/fleet-coordination-patterns.md +171 -0
  493. package/.versions/2.0.17/references/observability-checklist.md +92 -0
  494. package/.versions/2.0.17/references/orchestration-patterns.md +370 -0
  495. package/.versions/2.0.17/references/performance-checklist.md +236 -0
  496. package/.versions/2.0.17/references/prompting-patterns.md +380 -0
  497. package/.versions/2.0.17/references/security-checklist.md +245 -0
  498. package/.versions/2.0.17/references/testing-patterns.md +235 -0
  499. package/.versions/2.0.17/references/workflow-authoring.md +304 -0
  500. package/.versions/2.0.17/skills/_internal/grilling.md +59 -0
  501. package/.versions/2.0.17/skills/browser-testing-with-devtools/SKILL.md +351 -0
  502. package/.versions/2.0.17/skills/code-review-and-quality/SKILL.md +396 -0
  503. package/.versions/2.0.17/skills/compound-learning/SKILL.md +137 -0
  504. package/.versions/2.0.17/skills/constraint-driven-development/SKILL.md +338 -0
  505. package/.versions/2.0.17/skills/constraint-driven-development/references/floor-guard.md +99 -0
  506. package/.versions/2.0.17/skills/context-engineering/SKILL.md +341 -0
  507. package/.versions/2.0.17/skills/deprecation-and-migration/SKILL.md +247 -0
  508. package/.versions/2.0.17/skills/designing-agents/SKILL.md +394 -0
  509. package/.versions/2.0.17/skills/designing-agents/pi-harness-authoring.md +222 -0
  510. package/.versions/2.0.17/skills/drafting-workflows/SKILL.md +143 -0
  511. package/.versions/2.0.17/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  512. package/.versions/2.0.17/skills/frontend-ui-engineering/SKILL.md +328 -0
  513. package/.versions/2.0.17/skills/git-workflow-and-versioning/SKILL.md +316 -0
  514. package/.versions/2.0.17/skills/idea-refine/SKILL.md +182 -0
  515. package/.versions/2.0.17/skills/idea-refine/examples.md +238 -0
  516. package/.versions/2.0.17/skills/idea-refine/frameworks.md +99 -0
  517. package/.versions/2.0.17/skills/idea-refine/refinement-criteria.md +113 -0
  518. package/.versions/2.0.17/skills/idea-refine/scripts/idea-refine.sh +15 -0
  519. package/.versions/2.0.17/skills/incremental-implementation/SKILL.md +353 -0
  520. package/.versions/2.0.17/skills/interview-me/SKILL.md +226 -0
  521. package/.versions/2.0.17/skills/orchestration-verification/SKILL.md +182 -0
  522. package/.versions/2.0.17/skills/peer-coms/SKILL.md +90 -0
  523. package/.versions/2.0.17/skills/performance-optimization/SKILL.md +496 -0
  524. package/.versions/2.0.17/skills/planning-and-task-breakdown/SKILL.md +318 -0
  525. package/.versions/2.0.17/skills/repository-ai-setup/SKILL.md +117 -0
  526. package/.versions/2.0.17/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  527. package/.versions/2.0.17/skills/repository-ai-setup/references/apply-contract.md +74 -0
  528. package/.versions/2.0.17/skills/repository-ai-setup/references/provenance-template.md +16 -0
  529. package/.versions/2.0.17/skills/repository-ai-setup/references/setup-flow.md +108 -0
  530. package/.versions/2.0.17/skills/repository-ai-setup/references/verify-setup.md +20 -0
  531. package/.versions/2.0.17/skills/security-and-hardening/SKILL.md +524 -0
  532. package/.versions/2.0.17/skills/spec-driven-development/SKILL.md +295 -0
  533. package/.versions/2.0.17/skills/using-agent-skills/SKILL.md +198 -0
  534. package/.versions/2.0.17/vendor/agent-skills-upstream/LICENSE +21 -0
  535. package/.versions/2.0.17/vendor/agent-skills-upstream/README.md +430 -0
  536. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  537. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  538. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  539. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  540. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  541. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  542. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  543. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  544. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  545. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  546. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  547. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  548. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  549. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  550. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  551. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  552. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  553. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  554. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  555. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  556. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  557. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  558. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  559. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  560. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  561. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  562. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  563. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  564. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  565. package/.versions/2.0.17/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  566. package/CHANGELOG.md +12 -0
  567. package/docs/system1-agentic.md +106 -0
  568. package/install-manifest.json +1 -1
  569. package/package.json +5 -2
@@ -0,0 +1,183 @@
1
+ import { dirname } from "node:path";
2
+ import { fileURLToPath } from "node:url";
3
+ import { beginExecutionEvidence, finishExecutionEvidence } from "../execution-evidence.ts";
4
+ import { profileFallback, readActiveProfile } from '../policy/profile-runtime.ts';
5
+ import { resolveAssist } from '../assist-profile.ts';
6
+ import { BOUNDED_OUTPUT_DIR_ENV } from '../bounded-output.ts';
7
+ import { FILESYSTEM_SESSION_DIR_ENV } from '../filesystem-tool.ts';
8
+ import { boundOutput } from '../deterministic-fs.ts';
9
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
10
+ import { contextPct, resolveContextWindow } from "../context-window.js";
11
+ import { isReadOnlyToolList, safePathWithin } from "../helpers.ts";
12
+ import { researchTerminationOutcome, researchWatchdogSpawnOptions } from "../research-watchdog.ts";
13
+ import { explicitProcessLifecycle, lifecycleAfterSpawnException } from "../recovery-contract.ts";
14
+ import type { InputArtifactPreview } from "../context/assertions-artifacts.ts";
15
+ import type { ResearchAgentDef, ResearchFinalizeOutcome, ResearchResult, ResearchRuntimeDeps, ResearchState } from "./runtime.ts";
16
+ import { bumpMessageCount } from "../ui/activity-dots.ts";
17
+
18
+ export interface ResearchSpawnPorts<TDef extends ResearchAgentDef> extends ResearchRuntimeDeps<TDef> {
19
+ researchTools: string;
20
+ sessionPath(id: number): string;
21
+ finalize(state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome): void;
22
+ }
23
+
24
+ function completeOutput<TDef extends ResearchAgentDef>(state: ResearchState<TDef>, res: any): string {
25
+ let output = String(res.output ?? "");
26
+ if (res.modelFallback) {
27
+ output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
28
+ }
29
+ if (res.exitCode !== 0) {
30
+ const errText = [res.assistantError, res.stderr].filter(Boolean).join("\n\n").trim();
31
+ const tail = errText.length > 1500 ? `...\n${errText.slice(-1500)}` : errText;
32
+ const errBlock = tail ? `\n\n[stderr]\n${tail}` : "";
33
+ output = output ? `${output}${errBlock}` : `Research helper r${state.id} exited with code ${res.exitCode} and produced no output.${errBlock}`;
34
+ }
35
+ return output;
36
+ }
37
+
38
+ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
39
+ deps: ResearchSpawnPorts<TDef>, state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext,
40
+ inputArtifacts: InputArtifactPreview[] = [], signal?: AbortSignal,
41
+ ): Promise<ResearchResult> {
42
+ const startTime = Date.now();
43
+ let result: ResearchResult | undefined;
44
+ let diagnostics: object | null = null;
45
+ let spawnAttempted = false;
46
+ let spawnLifecycle: { launched: boolean; closeSeen: boolean } | undefined;
47
+ const transcriptPath = safePathWithin(state.evidenceDir, "transcript.jsonl");
48
+
49
+ const settle = (status: ResearchFinalizeOutcome["status"], historyStatus: ResearchFinalizeOutcome["historyStatus"], lastWork: string, settled: ResearchResult): ResearchResult => {
50
+ state.elapsed = settled.elapsed;
51
+ deps.finalize(state, { status, historyStatus, lastWork });
52
+ deps.flushTimelineStore(state);
53
+ result = finishExecutionEvidence(state.evidenceDir, { ...settled, dispatchId: state.dispatchId, transcriptPath, sessionPath: state.sessionPath, diagnostics });
54
+ return result;
55
+ };
56
+
57
+ try {
58
+ beginExecutionEvidence(dirname(dirname(state.evidenceDir)), state.dispatchId, { task: prompt, agent: state.def.name, modelRequested: state.model }, inputArtifacts);
59
+ if (!state.histEntry) state.histEntry = deps.executionHistory.start("research", `Research r${state.id}`);
60
+
61
+ const safety = deps.requireSafetyHarness(deps.getSafetyHarnessPath());
62
+ // T3: safety refusal never launched a process — distinct from spawn failure and timeout.
63
+ if (!safety.ok) return settle("error", "error", safety.error, { output: safety.error, exitCode: 1, elapsed: 0, lifecycle: { launched: false, closeSeen: false } });
64
+
65
+ state.status = "running";
66
+ state.task = prompt;
67
+ state.toolCount = 0;
68
+ state.messageCount = 0;
69
+ state.elapsed = 0;
70
+ state.lastWork = "";
71
+ state.killedByOperator = false;
72
+ deps.flushTimelineStore(state);
73
+ state.timeline = [];
74
+ state.transcriptStore = deps.createTranscriptStore(transcriptPath);
75
+
76
+ state.timer = setInterval(() => {
77
+ state.elapsed = Date.now() - startTime;
78
+ deps.onElapsed?.();
79
+ }, 1000);
80
+ const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
81
+ const wantThinking = thinkingLevel !== "off";
82
+ const sessionPath = state.sessionPath;
83
+ const researchWindow = resolveContextWindow(state.model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
84
+ const fallbackCandidate = profileFallback(deps.substitutedModel(deps.fallbackModelFor(state.def, state.model)));
85
+ const fallback = fallbackCandidate === state.model ? undefined : fallbackCandidate;
86
+ let fullText = "";
87
+ deps.notifyProviderQueue(state.model, `Research r${state.id}`, ctx);
88
+
89
+ const assist = resolveAssist(readActiveProfile()?.profile.assist);
90
+ const boundedOutput = assist['bounded-output'];
91
+ const declaredTools = state.def.tools.split(",").map(tool => tool.trim()).filter(Boolean);
92
+ const deterministicTools = assist['deterministic-tools'] && (state.def.toolsExplicit !== true || declaredTools.includes("filesystem"));
93
+ const boundedOutputDir = safePathWithin(state.evidenceDir, "bounded-output");
94
+ const researchTools = deterministicTools && !deps.researchTools.split(",").includes("filesystem") ? `${deps.researchTools},filesystem` : deps.researchTools;
95
+ const cwd = ctx.cwd || process.cwd();
96
+ spawnAttempted = true;
97
+ const res = await deps.providerSemaphore.run(state.model, () => deps.spawnPiAgentWithModelFallback({
98
+ model: state.model, tools: researchTools, thinking: thinkingLevel,
99
+ systemPrompt: deps.nativeResearchSystemPrompt({
100
+ ...(state.persona ? { personaName: state.def.name, personaPath: state.def.file } : {}),
101
+ cwd,
102
+ rulesPaths: deps.getProjectPolicyPaths(cwd),
103
+ docsPaths: deps.getProjectDocsPaths(),
104
+ }),
105
+ noSkills: true, noContextFiles: true, sessionFile: sessionPath, resume: false,
106
+ prompt: deps.artifacts.appendInputArtifacts(prompt, inputArtifacts), cwd: ctx.cwd || process.cwd(),
107
+ extensions: [...safety.extensions, ...(boundedOutput ? [fileURLToPath(new URL("../bounded-output.ts", import.meta.url))] : []), ...(deterministicTools ? [fileURLToPath(new URL("../filesystem-tool.ts", import.meta.url))] : [])],
108
+ env: { ...deps.guardrailEnv(`research-r${state.id}`), ...(boundedOutput ? { [BOUNDED_OUTPUT_DIR_ENV]: boundedOutputDir } : {}), ...(deterministicTools ? { [FILESYSTEM_SESSION_DIR_ENV]: dirname(dirname(state.evidenceDir)) } : {}) },
109
+ ...(boundedOutput ? { boundedOutputDir } : {}),
110
+ ...researchWatchdogSpawnOptions(deps.getReconSearchTimeoutMs(), signal),
111
+ turnDeadlineMs: deps.budget.currentBudget().agentTurnMs,
112
+ }, fallback, {
113
+ onProcess: process => { state.proc = process; },
114
+ onModelFallback: ({ from, to, reason }) => {
115
+ state.lastWork = `model fallback: ${deps.shortModel(from)} → ${deps.shortModel(to)}`;
116
+ ctx.ui.notify(`Research r${state.id}: overridden model ${from} failed before work began; retrying with persona model ${to} (${reason})`, "warning");
117
+ },
118
+ onTextDelta: delta => {
119
+ fullText += delta;
120
+ state.lastWork = fullText.split("\n").filter(line => line.trim()).pop() || "";
121
+ bumpMessageCount(state, "text");
122
+ deps.appendTimelineText(state, "text", delta);
123
+ state.zoomRender?.();
124
+ },
125
+ onThinkingDelta: delta => {
126
+ if (!wantThinking) return;
127
+ deps.appendTimelineText(state, "thinking", delta);
128
+ state.zoomRender?.();
129
+ },
130
+ onToolStart: (toolName, argStr, callId) => {
131
+ state.toolCount++;
132
+ deps.appendTimelineEvent(state, { kind: "tool-start", title: `Tool: ${toolName}`, content: argStr, timestamp: Date.now(), ...(callId ? { callId } : {}) });
133
+ state.zoomRender?.();
134
+ },
135
+ onToolEnd: (toolName, callId, isError, resultText, durationMs) => {
136
+ deps.appendTimelineEvent(state, { kind: "tool-result", title: `Result: ${toolName}`, content: resultText ?? "", timestamp: Date.now(), ...(callId ? { callId } : {}), status: isError ? "error" : "success", ...(durationMs == null ? {} : { durationMs }) });
137
+ state.zoomRender?.();
138
+ },
139
+ onUsage: usage => {
140
+ state.contextTokens = (usage.input || 0) + (usage.cacheRead || 0) + (usage.cacheWrite || 0);
141
+ if (researchWindow.window > 0) {
142
+ state.contextPct = contextPct(usage, researchWindow.window);
143
+ }
144
+ },
145
+ }, { midRun: isReadOnlyToolList(researchTools) }));
146
+
147
+ diagnostics = { assistantError: res.assistantError ?? null, stderr: res.stderr, spawnError: res.spawnError ?? null, modelUsed: res.modelUsed ?? null, toolCallsStarted: res.toolCallsStarted ?? null, termination: res.termination ?? null, processExitCode: res.exitCode };
148
+ state.elapsed = Date.now() - startTime;
149
+ state.proc = undefined;
150
+ // T3: only explicit spawn lifecycle is trusted. Missing facts stay omitted, not inferred.
151
+ spawnLifecycle = explicitProcessLifecycle((res as { lifecycle?: unknown }).lifecycle);
152
+ const lifecycle = spawnLifecycle;
153
+ if (res.spawnError) {
154
+ return settle("error", "error", `Error: ${res.spawnError}`, { output: `Error spawning research helper: ${res.spawnError}`, exitCode: 1, elapsed: state.elapsed, lifecycle });
155
+ }
156
+ if (res.termination) {
157
+ const outcome = researchTerminationOutcome(state.id, res.termination);
158
+ return settle("error", "error", outcome.lastWork, { output: outcome.output, exitCode: outcome.exitCode, elapsed: state.elapsed, termination: res.termination, lifecycle });
159
+ }
160
+ if (state.killedByOperator) {
161
+ state.killedByOperator = false;
162
+ return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode == null || res.exitCode === 0 ? 143 : res.exitCode, elapsed: state.elapsed, lifecycle });
163
+ }
164
+
165
+ const status = res.exitCode === 0 ? "done" : "error";
166
+ const lastWork = String(res.output ?? "").split("\n").filter((line: string) => line.trim()).pop() || "";
167
+ const completed = completeOutput(state, res);
168
+ const parent = res.boundedOutput ? boundOutput({ content: completed, retentionDir: safePathWithin(state.evidenceDir, "bounded-output", "parent"), label: "parent-summary" }) : null;
169
+ const settled = settle(status, status, lastWork, { output: parent?.reply ?? completed, exitCode: res.exitCode ?? 1, elapsed: state.elapsed, lifecycle });
170
+ ctx.ui.notify(`Research r${state.id} ${status} in ${Math.round(state.elapsed / 1000)}s`, status === "done" ? "info" : "error");
171
+ return settled;
172
+ } catch (err: unknown) {
173
+ const message = err instanceof Error ? err.message : String(err);
174
+ state.elapsed = Date.now() - startTime;
175
+ const lifecycle = lifecycleAfterSpawnException({ spawnAttempted, spawnLifecycle, processSeen: !!state.proc });
176
+ return settle("error", "error", `Error: ${message}`, { output: `Error spawning research helper: ${message}`, exitCode: 1, elapsed: state.elapsed, ...(lifecycle ? { lifecycle } : {}) });
177
+ } finally {
178
+ if (!result) {
179
+ state.elapsed = Date.now() - startTime;
180
+ deps.finalize(state, { status: "error", historyStatus: "error", lastWork: "terminated unexpectedly" });
181
+ }
182
+ }
183
+ }
@@ -0,0 +1,40 @@
1
+ import type { Termination } from "./spawn.ts";
2
+
3
+ /** Spawn policy shared by every native read-only research-helper path. */
4
+ export function researchWatchdogSpawnOptions(timeoutMs: number | null, signal?: AbortSignal) {
5
+ return {
6
+ detached: true,
7
+ signal,
8
+ toolWatchdog: { timeoutMs },
9
+ };
10
+ }
11
+
12
+ /** Stable terminal result used by research lifecycle code after parent cleanup. */
13
+ export function researchTerminationOutcome(id: number, termination: Termination) {
14
+ const reason = termination.reason;
15
+ const tool = termination.tool;
16
+ const status = reason; // "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled"
17
+ const lastWork = reason === "tool_timeout"
18
+ ? `tool_timeout: ${tool?.toolName || "tool"} (${tool?.toolCallId || "unknown"})`
19
+ : reason === "turn_timeout"
20
+ ? "turn_timeout: per-run deadline exceeded"
21
+ : reason === "drift_stop"
22
+ ? "drift_stop: stopped by the drift watchdog"
23
+ : "cancelled by caller";
24
+ const metadata = reason === "tool_timeout"
25
+ ? `toolCallId=${tool?.toolCallId || "unknown"}, tool=${tool?.toolName || "unknown"}, deadline=${tool?.deadlineAt || "unknown"}, terminationConfirmed=${termination.confirmed}`
26
+ : `terminationConfirmed=${termination.confirmed}`;
27
+ const explanation = reason === "tool_timeout"
28
+ ? "exceeded its per-tool watchdog"
29
+ : reason === "turn_timeout"
30
+ ? "exceeded the per-run deadline (agent-turn-timeout-s / mode budget) — narrow the question or raise the deadline"
31
+ : reason === "drift_stop"
32
+ ? "was stopped by the drift watchdog"
33
+ : "was cancelled by its caller";
34
+ return {
35
+ status,
36
+ lastWork,
37
+ output: `${status}: research helper r${id} ${explanation} (${metadata}).`,
38
+ exitCode: reason === "cancelled" ? 130 : reason === "drift_stop" ? 125 : 124,
39
+ };
40
+ }
@@ -0,0 +1,349 @@
1
+ const STRUCTURED_KEYS = [
2
+ "changed_files",
3
+ "assertions_proven",
4
+ "assertions_unproven",
5
+ "assertions_failed",
6
+ "tests_run",
7
+ "open_risks",
8
+ "requires_user_decision",
9
+ ];
10
+
11
+ const ASSERTION_KEYS = new Set(["assertions_proven", "assertions_unproven", "assertions_failed"]);
12
+
13
+ // Line-form verdicts. Specialists routinely report
14
+ // ASSERTION A1: PASS — Conventional Hermes plan path ... are present
15
+ // - **A2: FAIL** — the gate never fires
16
+ // instead of the declared schema, and the parser used to see none of it: 16 of 46
17
+ // dispatches in one session were scored "no structured return" and every assertion
18
+ // treated as unproven, including runs that had reported a complete verdict.
19
+ //
20
+ // The status must be the whole token right after the id, and any explanation must
21
+ // be introduced by a separator — so ordinary prose mentioning an id never matches.
22
+ const LINE_FORM_STATUS = {
23
+ pass: "assertions_proven",
24
+ passed: "assertions_proven",
25
+ proven: "assertions_proven",
26
+ fail: "assertions_failed",
27
+ failed: "assertions_failed",
28
+ blocked: "assertions_failed",
29
+ unproven: "assertions_unproven",
30
+ unverified: "assertions_unproven",
31
+ };
32
+
33
+ const LINE_FORM_RE =
34
+ /^\s*(?:[-*]\s+|\d+[.)]\s+)?\**(?:ASSERTION\s+)?(A\d+)\**\s*[:\-–—]\s*\**(PASS|PASSED|PROVEN|FAIL|FAILED|BLOCKED|UNPROVEN|UNVERIFIED)\**\s*(?:[:\-–—]\s*(.*))?$/i;
35
+
36
+ export function extractAssertionIds(taskText) {
37
+ const ids = [];
38
+ const seen = new Set();
39
+ for (const match of String(taskText || "").matchAll(/\bA\d+\b/g)) {
40
+ const id = match[0];
41
+ if (!seen.has(id)) {
42
+ seen.add(id);
43
+ ids.push(id);
44
+ }
45
+ }
46
+ return ids;
47
+ }
48
+
49
+ export function parseStructuredReturn(finalText) {
50
+ const text = String(finalText || "");
51
+ const candidates = fencedBlocks(text);
52
+ candidates.push(text);
53
+
54
+ let best = null;
55
+ for (const candidate of candidates) {
56
+ const parsed = parseCandidate(candidate);
57
+ if (parsed && (!best || parsed.__score > best.__score)) best = parsed;
58
+ }
59
+ if (!best) return null;
60
+ delete best.__score;
61
+ return best;
62
+ }
63
+
64
+ /** Decide whether output is a return, a failure diagnostic, or still pending. */
65
+ export function deliveryDisposition(exitCode, pending = false) {
66
+ if (pending) return { delivered: false, pending: true, status: "pending", artifactKind: null };
67
+ if (exitCode === 0) return { delivered: true, pending: false, status: "done", artifactKind: "returns" };
68
+ return { delivered: false, pending: false, status: "error", artifactKind: "failures" };
69
+ }
70
+
71
+ /**
72
+ * Parse only a successfully delivered specialist result. A failed process may
73
+ * have emitted a partial structured block before crashing, but that output is
74
+ * diagnostic data, never assertion evidence.
75
+ */
76
+ export function parseDeliveredReturn(finalText, dispatchedIds, delivered) {
77
+ const parsed = delivered ? parseStructuredReturn(finalText) : null;
78
+ return { parsed, notices: crossCheck(parsed, dispatchedIds) };
79
+ }
80
+
81
+ export function crossCheck(parsed, dispatchedIds) {
82
+ const ids = Array.from(new Set(dispatchedIds || []));
83
+ if (!parsed) {
84
+ return ids.length > 0 ? [{ type: "no_structured_return", ids }] : [];
85
+ }
86
+
87
+ const notices = [];
88
+ const present = new Set();
89
+ for (const key of ["assertions_proven", "assertions_unproven", "assertions_failed"]) {
90
+ for (const entry of parsed[key] || []) {
91
+ if (entry && entry.id) present.add(entry.id);
92
+ }
93
+ }
94
+ for (const id of ids) {
95
+ if (!present.has(id)) notices.push({ type: "missing", id });
96
+ }
97
+ for (const entry of parsed.assertions_proven || []) {
98
+ if (entry && entry.id && !entry.evidence) {
99
+ notices.push({ type: "proven_without_evidence", id: entry.id, note: entry.note || "" });
100
+ }
101
+ }
102
+ return notices;
103
+ }
104
+
105
+ /**
106
+ * Runtime compiler facts outrank a specialist's raw claim, but only for ids in
107
+ * this dispatch and only when a completed, non-overlapped check found an error
108
+ * in an observed changed file. This returns a copy and never touches the ledger.
109
+ */
110
+ export function correctStructuredReturnForCompiler(parsed, dispatchedIds, compilerDiagnostics) {
111
+ if (!parsed || compilerDiagnostics?.status !== "completed" || compilerDiagnostics?.attribution !== "no_observed_overlap") {
112
+ return { parsed, demotedIds: [] };
113
+ }
114
+ const normalize = value => String(value || "").replace(/\\/g, "/").replace(/^\.\//, "");
115
+ const changed = new Set((compilerDiagnostics.changedFiles || []).map(normalize));
116
+ const hasChangedFileError = (compilerDiagnostics.projects || []).some(project =>
117
+ project?.status === "errors" && (project.diagnostics || []).some(diagnostic => diagnostic?.file && changed.has(normalize(diagnostic.file))),
118
+ );
119
+ if (!hasChangedFileError) return { parsed, demotedIds: [] };
120
+ const currentIds = new Set(dispatchedIds || []);
121
+ const demoted = (parsed.assertions_proven || [])
122
+ .filter(entry => entry?.id && currentIds.has(entry.id))
123
+ .map(entry => ({ ...entry, reason: "compiler_diagnostics" }));
124
+ if (!demoted.length) return { parsed, demotedIds: [] };
125
+ const demotedIds = new Set(demoted.map(entry => entry.id));
126
+ return {
127
+ parsed: {
128
+ ...parsed,
129
+ assertions_proven: (parsed.assertions_proven || []).filter(entry => !demotedIds.has(entry?.id)),
130
+ assertions_unproven: [
131
+ ...(parsed.assertions_unproven || []).filter(entry => !demotedIds.has(entry?.id)),
132
+ ...demoted,
133
+ ],
134
+ },
135
+ demotedIds: [...demotedIds],
136
+ };
137
+ }
138
+
139
+ function fencedBlocks(text) {
140
+ const blocks = [];
141
+ const re = /```[^\n]*\n([\s\S]*?)```/g;
142
+ let match;
143
+ while ((match = re.exec(text))) blocks.push(match[1]);
144
+ return blocks;
145
+ }
146
+
147
+ function parseCandidate(text) {
148
+ const result = Object.fromEntries(STRUCTURED_KEYS.map((key) => [key, []]));
149
+ let score = 0;
150
+
151
+ const keyBlocks = collectKeyBlocks(text);
152
+ for (const [key, blocks] of keyBlocks) {
153
+ result[key] = blocks.flatMap((block) => parseEntries(key, block));
154
+ score += 2 + result[key].length;
155
+ }
156
+
157
+ const sectionBlocks = collectMarkdownSections(text);
158
+ for (const [key, block] of sectionBlocks) {
159
+ if (!keyBlocks.has(key)) {
160
+ result[key] = parseEntries(key, block);
161
+ score += 1 + result[key].length;
162
+ }
163
+ }
164
+
165
+ // Lowest-precedence source: a specialist that follows the schema is never
166
+ // second-guessed. A declared bucket wins outright, and an id the schema already
167
+ // classified is never re-stated from a loose line — otherwise a stale summary
168
+ // line could land the same id in two buckets at once.
169
+ const declaredIds = new Set();
170
+ for (const key of ASSERTION_KEYS) {
171
+ for (const entry of result[key] || []) {
172
+ if (entry && entry.id) declaredIds.add(entry.id);
173
+ }
174
+ }
175
+ for (const [key, entries] of collectLineFormAssertions(text)) {
176
+ if (keyBlocks.has(key) || sectionBlocks.has(key)) continue;
177
+ const fresh = entries.filter((entry) => !declaredIds.has(entry.id));
178
+ if (fresh.length === 0) continue;
179
+ result[key] = fresh;
180
+ score += fresh.length;
181
+ }
182
+
183
+ if (score === 0) return null;
184
+ result.__score = score;
185
+ return result;
186
+ }
187
+
188
+ function collectKeyBlocks(text) {
189
+ const found = new Map();
190
+ const lines = text.split(/\r?\n/);
191
+ for (let i = 0; i < lines.length; i++) {
192
+ const match = lines[i].match(/^\s*["']?([A-Za-z][A-Za-z0-9_ -]*)["']?\s*:\s*(.*)$/);
193
+ if (!match) continue;
194
+ const key = normalizeKey(match[1]);
195
+ if (!STRUCTURED_KEYS.includes(key)) continue;
196
+
197
+ const block = [match[2] || ""];
198
+ let bracketBalance = balanceBrackets(match[2] || "");
199
+ let j = i + 1;
200
+ for (; j < lines.length; j++) {
201
+ const next = lines[j];
202
+ const nextKey = next.match(/^\s*["']?([A-Za-z][A-Za-z0-9_ -]*)["']?\s*:\s*/);
203
+ const isKnownNextKey = nextKey && STRUCTURED_KEYS.includes(normalizeKey(nextKey[1]));
204
+ const isHeading = /^\s*#{1,6}\s+/.test(next);
205
+ // Fences delimit a structured candidate, never a value. In the
206
+ // whole-response candidate a closing fence used to become the last
207
+ // decision entry (e.g. "[]\n```").
208
+ if (/^\s*```/.test(next) || (bracketBalance <= 0 && /^\s*}[,;]?\s*$/.test(next))) break;
209
+ if (bracketBalance <= 0 && (isKnownNextKey || isHeading)) break;
210
+ if (next.trim() === "" && bracketBalance <= 0) break;
211
+ block.push(next);
212
+ bracketBalance += balanceBrackets(next);
213
+ }
214
+ // Repeated blocks (including distinct fences) must not hide a real
215
+ // decision behind a later empty declaration.
216
+ found.set(key, [...(found.get(key) || []), block.join("\n")]);
217
+ }
218
+ return found;
219
+ }
220
+
221
+ function collectMarkdownSections(text) {
222
+ const found = new Map();
223
+ const lines = text.split(/\r?\n/);
224
+ for (let i = 0; i < lines.length; i++) {
225
+ const match = lines[i].match(/^\s*#{1,6}\s+(.+?)\s*#*\s*$/);
226
+ if (!match) continue;
227
+ const key = normalizeKey(match[1]);
228
+ if (!STRUCTURED_KEYS.includes(key)) continue;
229
+ const block = [];
230
+ for (let j = i + 1; j < lines.length; j++) {
231
+ if (/^\s*#{1,6}\s+/.test(lines[j])) break;
232
+ block.push(lines[j]);
233
+ }
234
+ found.set(key, block.join("\n"));
235
+ }
236
+ return found;
237
+ }
238
+
239
+ function collectLineFormAssertions(text) {
240
+ const found = new Map();
241
+ const seen = new Set();
242
+ for (const line of String(text || "").split(/\r?\n/)) {
243
+ const match = line.match(LINE_FORM_RE);
244
+ if (!match) continue;
245
+ const id = match[1].toUpperCase();
246
+ const key = LINE_FORM_STATUS[match[2].toLowerCase()];
247
+ // First verdict per id wins: a later restatement is a summary, not a change.
248
+ if (!key || seen.has(id)) continue;
249
+ seen.add(id);
250
+ // The text after the separator IS the named evidence in this form. Left null
251
+ // for a bare verdict, so crossCheck still demotes it to unproven.
252
+ const evidence = String(match[3] || "").trim().replace(/\*+$/, "").trim() || null;
253
+ if (!found.has(key)) found.set(key, []);
254
+ found.get(key).push({ id, note: "", evidence });
255
+ }
256
+ return found;
257
+ }
258
+
259
+ function parseEntries(key, rawBlock) {
260
+ if (key === "requires_user_decision") {
261
+ const [first, ...rest] = rawBlock.split(/\r?\n/);
262
+ // A completed inline list cannot consume following prose as a single
263
+ // array value. Retain that prose as an additional decision rather than
264
+ // silently discarding ambiguous or malformed content.
265
+ if (rest.length && /^\[.*\],?$/.test(first.trim())) {
266
+ return [...parseEntries(key, first), ...splitListEntries(rest.join("\n"))];
267
+ }
268
+ const value = rawBlock.trim().replace(/,\s*$/, "");
269
+ if (/^\[.*\]$/s.test(value)) {
270
+ try {
271
+ const entries = JSON.parse(value);
272
+ if (Array.isArray(entries) && entries.every((entry) => typeof entry === "string")) return entries;
273
+ } catch { /* YAML and malformed list content remain visible to the caller. */ }
274
+ }
275
+ }
276
+ if (ASSERTION_KEYS.has(key)) {
277
+ return splitAssertionEntries(rawBlock).map(parseAssertionEntry).filter(Boolean);
278
+ }
279
+ return splitListEntries(rawBlock);
280
+ }
281
+
282
+ function normalizeListBlock(rawBlock) {
283
+ let block = String(rawBlock || "").trim();
284
+ if (!block || block === "[]") return "";
285
+ if (block.startsWith("[") && block.endsWith("]")) block = block.slice(1, -1);
286
+ return block;
287
+ }
288
+
289
+ function strippedLines(block) {
290
+ return block.split(/\r?\n/)
291
+ .map((line) => line.trim())
292
+ .filter(Boolean)
293
+ .map((line) => line.replace(/^[-*]\s+/, "").replace(/^\d+[.)]\s+/, "").replace(/,$/, "").trim())
294
+ .filter(Boolean);
295
+ }
296
+
297
+ function splitListEntries(rawBlock) {
298
+ const block = normalizeListBlock(rawBlock);
299
+ if (!block) return [];
300
+ const rawLines = block.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
301
+ const hasBulletLines = rawLines.some((line) => /^([-*]|\d+[.)])\s+/.test(line));
302
+ if (hasBulletLines) return strippedLines(block);
303
+ return [block.trim()];
304
+ }
305
+
306
+ function splitAssertionEntries(rawBlock) {
307
+ const block = normalizeListBlock(rawBlock);
308
+ if (!block) return [];
309
+ const rawLines = block.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
310
+ const hasBoundaryLines = rawLines.some((line) => /^([-*]|\d+[.)])\s+\bA\d+\b/.test(line));
311
+ if (hasBoundaryLines) return strippedLines(block).filter((line) => /^\bA\d+\b/.test(line));
312
+ return block
313
+ .split(/,(?=\s*A\d+\s*[:\-–—])/g)
314
+ .map((part) => part.trim().replace(/^,+\s*/, "").replace(/,+\s*$/, ""))
315
+ .filter(Boolean);
316
+ }
317
+
318
+ function parseAssertionEntry(entry) {
319
+ const text = String(entry || "").trim();
320
+ const idMatch = text.match(/\bA\d+\b/);
321
+ if (!idMatch) return null;
322
+ const id = idMatch[0];
323
+ let rest = text.slice((idMatch.index || 0) + id.length).trim();
324
+ rest = rest.replace(/^[:\-–—]\s*/, "");
325
+
326
+ let evidence = null;
327
+ const evidenceMatch = rest.match(/(?:^|\s+[—–-]\s*|\s+)evidence\s*:\s*([\s\S]*)$/i);
328
+ if (evidenceMatch) {
329
+ evidence = evidenceMatch[1].trim() || null;
330
+ rest = rest.slice(0, evidenceMatch.index).trim();
331
+ }
332
+ const note = rest.replace(/[✓✔]\s*$/u, "").trim();
333
+ return { id, note, evidence };
334
+ }
335
+
336
+ function normalizeKey(value) {
337
+ return String(value || "")
338
+ .trim()
339
+ .toLowerCase()
340
+ .replace(/[`*]/g, "")
341
+ .replace(/[^a-z0-9]+/g, "_")
342
+ .replace(/^_+|_+$/g, "");
343
+ }
344
+
345
+ function balanceBrackets(value) {
346
+ const opens = (String(value).match(/\[/g) || []).length;
347
+ const closes = (String(value).match(/\]/g) || []).length;
348
+ return opens - closes;
349
+ }
@@ -0,0 +1,77 @@
1
+ // Second chance at a structured return — the pure policy behind it.
2
+ //
3
+ // When a specialist's report carries no parseable structured block, the hub
4
+ // declares every dispatched assertion unproven. That is correct as a default and
5
+ // ruinous as an outcome: one 1221-second test-engineer run returned nothing
6
+ // parseable, and 16 of 46 dispatches in the same session were written off the
7
+ // same way. Discarding twenty minutes of real work over a formatting miss is the
8
+ // most expensive failure mode in the system.
9
+ //
10
+ // So: ONE cheap read-only pass over the report that was already written to disk,
11
+ // asked to restate what is there — never to judge, and never to invent evidence.
12
+ // The caller labels the result as extracted, so recovered evidence is always
13
+ // visibly weaker than evidence the specialist declared itself.
14
+
15
+ /** The dedicated cheap model required by the recovery contract. */
16
+ export const EXTRACTION_MODEL = "openai-codex/gpt-6-luna";
17
+
18
+ /** Two minutes: the pass must read a file, but it may never become a real run. */
19
+ export const EXTRACTION_DEADLINE_MS = 120_000;
20
+
21
+ /** A unique throwaway session per return artifact, safe under parallel dispatches. */
22
+ export function extractionSessionName(returnPath) {
23
+ const base = String(returnPath ?? "return")
24
+ .replace(/\\/g, "/")
25
+ .split("/")
26
+ .pop()
27
+ .replace(/\.md$/i, "")
28
+ .replace(/[^a-zA-Z0-9._-]+/g, "-") || "return";
29
+ return `return-extract-${base}.json`;
30
+ }
31
+
32
+ /**
33
+ * Is a second chance warranted? Only when nothing parsed AND the dispatcher was
34
+ * actually tracking assertions — with no assertions there is nothing to recover,
35
+ * and the raw output already reaches the dispatcher untouched.
36
+ */
37
+ export function shouldExtractReturn(parsed, dispatchedIds) {
38
+ return !parsed && Array.isArray(dispatchedIds) && dispatchedIds.length > 0;
39
+ }
40
+
41
+ /** The extraction prompt: restate, never evaluate.
42
+ * @param {{returnPath: string, assertionIds?: string[]}} input
43
+ */
44
+ export function buildExtractionPrompt({ returnPath, assertionIds = [] }) {
45
+ return `A specialist agent has already finished its work and written its report to a file.
46
+ Your ONLY job is to restate what that report says in a fixed format.
47
+ You are not reviewing the work. You are not judging it. You add nothing.
48
+
49
+ ## Report file
50
+ ${returnPath}
51
+
52
+ Read it with your read tool.
53
+
54
+ ## Assertion ids the dispatcher is tracking
55
+ ${assertionIds.length > 0 ? assertionIds.join(", ") : "(none)"}
56
+
57
+ ## Rules
58
+ - Put an id in assertions_proven ONLY if the report names concrete evidence for
59
+ it: a test name, command output, or file:line. Copy that evidence VERBATIM
60
+ from the report. Never write evidence of your own, never summarise it into a
61
+ claim, and never mark something proven because it sounds done.
62
+ - An id the report does not clearly resolve goes in assertions_unproven. When in
63
+ doubt, unproven — that is the safe answer and costs nothing.
64
+ - An id the report says failed, blocked, or regressed goes in assertions_failed.
65
+ - Every tracked id must appear in exactly one of the three lists.
66
+
67
+ ## Your answer
68
+ Reply with ONLY the block below and nothing else — no preamble, no explanation:
69
+
70
+ changed_files: [<path:line — what changed>]
71
+ assertions_proven: [<id>: <what the report claims> — evidence: <verbatim evidence>]
72
+ assertions_unproven: [<id>: <why the report leaves it open>]
73
+ assertions_failed: [<id>: <what the report says went wrong>]
74
+ tests_run: [<command → result, as the report states it>]
75
+ open_risks: [<risk the report names>]
76
+ requires_user_decision: [<decision the report says is needed>]`;
77
+ }