@chankov/agent-fleet 1.0.4 → 2.0.0

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 (476) hide show
  1. package/.pi/harnesses/agent-hub/README.md +57 -66
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  32. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  38. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  39. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  40. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  41. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  42. package/.pi/harnesses/agent-hub/index.ts +1324 -9645
  43. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  44. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  45. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  51. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  53. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  58. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  59. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  60. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  61. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  62. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  63. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  64. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  65. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  66. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  67. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  68. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  69. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  70. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  71. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  72. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  73. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  75. package/.pi/harnesses/agent-hub/types.ts +60 -0
  76. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  77. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  78. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  79. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  80. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  81. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  82. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  83. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  84. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  85. package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
  86. package/.pi/harnesses/coms/index.ts +139 -1630
  87. package/.pi/harnesses/coms/package.json +1 -1
  88. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  89. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  90. package/.pi/harnesses/lib/coms-core.ts +577 -0
  91. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  92. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  93. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  94. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  95. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  96. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  97. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  98. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  99. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  100. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  101. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  102. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  103. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  104. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  105. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  106. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  107. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  108. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  109. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  110. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  111. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  112. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  113. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  114. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  115. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  116. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  117. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  118. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  119. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  120. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  121. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  122. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  123. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  124. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  125. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  126. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  127. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  128. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  129. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  130. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  131. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  132. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  133. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  134. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  135. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  136. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  137. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  138. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  139. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  140. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  141. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  142. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  143. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  144. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  145. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  146. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  147. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  148. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  149. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  150. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  151. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  152. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  153. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  154. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  155. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  156. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  157. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  158. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  159. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  160. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  161. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  162. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  163. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  164. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  165. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  166. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  167. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  168. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  169. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  170. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  171. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  172. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  173. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  174. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  175. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  176. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  177. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  178. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  179. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  180. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  181. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  182. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  183. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  184. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  185. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  186. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  187. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  188. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  189. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  190. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  191. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  192. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  193. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  194. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  195. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  196. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  197. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  198. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  199. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  200. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  201. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  202. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  203. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  204. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  205. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  206. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  207. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  208. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  209. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  210. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  211. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  212. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  213. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  214. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  215. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  216. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  217. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  218. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  219. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  220. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  221. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  222. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  223. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  224. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  225. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  226. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  227. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  228. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  229. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  230. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  231. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  232. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  233. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  234. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  235. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  236. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  237. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  238. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  239. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  240. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  241. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  242. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  243. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  244. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  245. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  246. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  247. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  248. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  249. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  250. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  251. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  252. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  253. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  254. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  255. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  256. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  257. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  258. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  259. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  260. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  261. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  262. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  263. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  264. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  265. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  266. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  267. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  268. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  269. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  270. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  271. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  272. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  273. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  274. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  275. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  276. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  277. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  278. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  279. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  280. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  281. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  282. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  283. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  284. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  285. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  286. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  287. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  288. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  289. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  290. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  291. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  292. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  293. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  294. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  295. package/.versions/2.0.0/.version +1 -0
  296. package/.versions/2.0.0/agents/architect.md +25 -0
  297. package/.versions/2.0.0/agents/bowser.md +28 -0
  298. package/.versions/2.0.0/agents/builder.md +56 -0
  299. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  300. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  301. package/.versions/2.0.0/agents/documenter.md +19 -0
  302. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  303. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  304. package/.versions/2.0.0/agents/planner.md +71 -0
  305. package/.versions/2.0.0/agents/releaser.md +25 -0
  306. package/.versions/2.0.0/agents/researcher.md +29 -0
  307. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  308. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  309. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  310. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  311. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  312. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  313. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  314. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  315. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  316. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  317. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  318. package/.versions/2.0.0/docs/getting-started.md +98 -0
  319. package/.versions/2.0.0/docs/npm-install.md +292 -0
  320. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  321. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  322. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  323. package/.versions/2.0.0/hermes/README.md +347 -0
  324. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  325. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  326. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  327. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  328. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  329. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  330. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  331. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  332. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  333. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  334. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  335. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  336. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  337. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  338. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  339. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  340. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  341. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  342. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  343. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  344. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  345. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  346. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  347. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  348. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  349. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  350. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  351. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  352. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  353. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  354. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  355. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  356. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  357. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  358. package/.versions/2.0.0/install-manifest.json +2745 -0
  359. package/.versions/2.0.0/justfile +272 -0
  360. package/.versions/2.0.0/manifest-meta.json +882 -0
  361. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  362. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  363. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  364. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  365. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  366. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  367. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  368. package/.versions/2.0.0/references/security-checklist.md +179 -0
  369. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  370. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  371. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  372. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  373. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  374. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  375. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  376. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  377. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  378. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  379. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  380. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  381. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  382. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  383. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  384. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  385. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  386. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  387. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  388. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  389. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  390. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  391. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  392. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  393. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  394. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  395. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  396. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  397. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  398. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  399. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  400. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  401. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  402. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  403. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  404. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  405. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  406. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  407. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  408. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  409. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  410. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  411. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  412. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  413. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  414. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  415. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  416. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  417. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  418. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  419. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  420. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  421. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  422. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  423. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  424. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  425. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  426. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  427. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  428. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  429. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  430. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  431. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  432. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  433. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  434. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  435. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  436. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  437. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  438. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  439. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  440. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  441. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  442. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  443. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  444. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  445. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  446. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  447. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  448. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  449. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  450. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  451. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  452. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  453. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  454. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  455. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  456. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  457. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  458. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  459. package/CHANGELOG.md +33 -0
  460. package/README.md +5 -5
  461. package/agents/orchestrator.md +3 -1
  462. package/bin/lib/overrides.js +2 -0
  463. package/bin/lib/validate-overrides.js +1 -1
  464. package/docs/ARCHITECTURE.md +42 -13
  465. package/docs/MIGRATION-agent-fleet.md +4 -4
  466. package/docs/agent-fleet-setup.md +15 -15
  467. package/docs/npm-install.md +1 -1
  468. package/docs/pi-extensions.md +16 -18
  469. package/install-manifest.json +1 -1
  470. package/justfile +2 -2
  471. package/package.json +3 -2
  472. package/scripts/fleet.ts +10 -10
  473. package/scripts/lib/fleet-command.ts +15 -11
  474. package/scripts/lib/team-project.ts +2 -2
  475. package/scripts/team-up.ts +10 -10
  476. package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
@@ -0,0 +1,532 @@
1
+ // ask-user-remote harness
2
+ //
3
+ // Captures the stock pi-ask-user `ask_user` tool, then registers a wrapper with
4
+ // the same schema/renderers/result shape. With no live `user-remote` coms peer
5
+ // it delegates to stock execute with the original arguments unchanged. When the
6
+ // peer is live, it races the stock local UI against a remote coms round trip.
7
+
8
+ import * as fs from "node:fs";
9
+ import * as os from "node:os";
10
+ import * as path from "node:path";
11
+ import { fileURLToPath, pathToFileURL } from "node:url";
12
+
13
+ import { raceAskUser } from "./race-core.js";
14
+
15
+ interface ToolRegistration {
16
+ name: string;
17
+ execute?: (...args: any[]) => Promise<any> | any;
18
+ [key: string]: any;
19
+ }
20
+
21
+ interface ExtensionLike {
22
+ registerTool: (tool: ToolRegistration) => void;
23
+ [key: string]: any;
24
+ }
25
+
26
+ interface InstallOptions {
27
+ stockFactory?: (pi: ExtensionLike) => void;
28
+ startRemote?: (params: any, ctx?: any) => Promise<{ qid: string; result: Promise<any> } | null> | { qid: string; result: Promise<any> } | null;
29
+ cancelRemote?: (qid: string, reason: string) => Promise<void> | void;
30
+ warn?: (message: string) => void;
31
+ createAbortController?: () => AbortController;
32
+ settingsPaths?: string[];
33
+ /** When true, settings-listed packages are dormant (Pi `--no-extensions`/`-ne`). */
34
+ extensionDiscoveryDisabled?: boolean;
35
+ remoteProject?: string | (() => string);
36
+ }
37
+
38
+ export interface AskUserResultObservation {
39
+ params: { question?: unknown; context?: unknown; options?: unknown };
40
+ result?: unknown;
41
+ phase: "start" | "result";
42
+ }
43
+
44
+ const askUserResultObservers = new Set<(observation: AskUserResultObservation) => void>();
45
+
46
+ /** Observe compact ask calls without inspecting human prose. */
47
+ export function observeAskUserResults(observer: (observation: AskUserResultObservation) => void): () => void {
48
+ askUserResultObservers.add(observer);
49
+ return () => askUserResultObservers.delete(observer);
50
+ }
51
+
52
+ function emitAskUserObservation(observation: AskUserResultObservation): void {
53
+ for (const observer of askUserResultObservers) {
54
+ try { observer(observation); } catch { /* observers cannot break asking */ }
55
+ }
56
+ }
57
+
58
+ interface ResolveStockOptions {
59
+ moduleUrl?: string;
60
+ cwd?: string;
61
+ homeDir?: string;
62
+ }
63
+
64
+ // A stock `pi-ask-user` package listed in pi settings is loaded by pi core
65
+ // itself only when extension discovery is enabled. Under `--no-extensions`/
66
+ // `-ne` the entry is dormant, so this harness must still install the wrapper.
67
+ // When discovery is enabled, registering here first would make pi core
68
+ // hard-crash later with a tool-name conflict — the preflight skips instead.
69
+ const STOCK_PACKAGE_PATTERN = /(^|[/:])pi-ask-user(@[^/]*)?$/;
70
+
71
+ export function defaultSettingsPaths(): string[] {
72
+ return [
73
+ path.join(process.cwd(), ".pi", "settings.json"),
74
+ path.join(os.homedir(), ".pi", "agent", "settings.json"),
75
+ ];
76
+ }
77
+
78
+ /** True when argv disables Pi package/extension discovery (explicit `-e` still works). */
79
+ export function hasDisabledExtensionDiscovery(argv: string[] = process.argv): boolean {
80
+ return argv.includes("--no-extensions") || argv.includes("-ne");
81
+ }
82
+
83
+ interface StockPackageEntry {
84
+ source: string;
85
+ autoload?: boolean;
86
+ extensions?: unknown;
87
+ }
88
+
89
+ function parseStockPackageEntry(value: unknown): StockPackageEntry | null {
90
+ if (typeof value === "string") {
91
+ return STOCK_PACKAGE_PATTERN.test(value) ? { source: value } : null;
92
+ }
93
+ if (!value || typeof value !== "object") return null;
94
+ const entry = value as { source?: unknown; autoload?: unknown; extensions?: unknown };
95
+ if (typeof entry.source !== "string" || !STOCK_PACKAGE_PATTERN.test(entry.source)) return null;
96
+ return {
97
+ source: entry.source,
98
+ autoload: entry.autoload === false ? false : undefined,
99
+ extensions: entry.extensions,
100
+ };
101
+ }
102
+
103
+ function stockExtensionPatternMatches(rawPattern: string): boolean {
104
+ let pattern = rawPattern;
105
+ if (pattern.startsWith("!") || pattern.startsWith("+") || pattern.startsWith("-")) pattern = pattern.slice(1);
106
+ pattern = pattern.replace(/^\.\//, "");
107
+ let expression = "";
108
+ for (let i = 0; i < pattern.length; i++) {
109
+ const char = pattern[i];
110
+ if (char === "*") {
111
+ if (pattern[i + 1] === "*") {
112
+ expression += ".*";
113
+ i++;
114
+ } else {
115
+ expression += "[^/]*";
116
+ }
117
+ } else if (char === "?") {
118
+ expression += "[^/]";
119
+ } else {
120
+ expression += char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
121
+ }
122
+ }
123
+ return new RegExp(`^${expression}$`).test("index.ts");
124
+ }
125
+
126
+ function applyStockExtensionFilter(filter: unknown, inherited: boolean): boolean {
127
+ if (filter === undefined || !Array.isArray(filter)) return inherited;
128
+ if (filter.length === 0) return false;
129
+
130
+ const patterns = filter.filter((value): value is string => typeof value === "string" && value.length > 0);
131
+ const selectors = patterns.filter((pattern) => !pattern.startsWith("!") && !pattern.startsWith("+") && !pattern.startsWith("-"));
132
+ let enabled = selectors.length > 0
133
+ ? selectors.some(stockExtensionPatternMatches)
134
+ : inherited;
135
+
136
+ for (const pattern of patterns) {
137
+ if (!stockExtensionPatternMatches(pattern)) continue;
138
+ if (pattern.startsWith("!") || pattern.startsWith("-")) enabled = false;
139
+ else if (pattern.startsWith("+")) enabled = true;
140
+ }
141
+ return enabled;
142
+ }
143
+
144
+ export function findStockAskUserPackageEntry(settingsPaths: string[]): { entry: string; settingsPath: string } | null {
145
+ const located: Array<{ entry: StockPackageEntry; settingsPath: string }> = [];
146
+ for (const settingsPath of settingsPaths) {
147
+ let packages: unknown;
148
+ try {
149
+ packages = JSON.parse(fs.readFileSync(settingsPath, "utf8"))?.packages;
150
+ } catch {
151
+ continue;
152
+ }
153
+ if (!Array.isArray(packages)) continue;
154
+ const entry = packages.map(parseStockPackageEntry).find(Boolean);
155
+ if (entry) located.push({ entry, settingsPath });
156
+ }
157
+
158
+ // Pi resolves lower-precedence settings first. A normal project entry
159
+ // replaces the global entry; `autoload:false` applies only its resource
160
+ // filter as a delta over the inherited package state.
161
+ let enabled = false;
162
+ let owner: { entry: StockPackageEntry; settingsPath: string } | null = null;
163
+ for (let i = located.length - 1; i >= 0; i--) {
164
+ const current = located[i];
165
+ const inherited = current.entry.autoload === false ? enabled : true;
166
+ enabled = applyStockExtensionFilter(current.entry.extensions, inherited);
167
+ owner = enabled ? current : null;
168
+ }
169
+ return owner ? { entry: owner.entry.source, settingsPath: owner.settingsPath } : null;
170
+ }
171
+
172
+ export function captureAskUserTool(stockFactory: (pi: ExtensionLike) => void, pi: ExtensionLike): ToolRegistration {
173
+ let captured: ToolRegistration | null = null;
174
+ const proxy = new Proxy(pi, {
175
+ get(target, prop, receiver) {
176
+ if (prop === "registerTool") {
177
+ return (tool: ToolRegistration) => {
178
+ if (tool?.name === "ask_user") {
179
+ captured = tool;
180
+ return;
181
+ }
182
+ return target.registerTool(tool);
183
+ };
184
+ }
185
+ return Reflect.get(target, prop, receiver);
186
+ },
187
+ }) as ExtensionLike;
188
+
189
+ stockFactory(proxy);
190
+ if (!captured) throw new Error("ask-user-remote: stock pi-ask-user did not register ask_user");
191
+ return captured;
192
+ }
193
+
194
+ function warn(pi: ExtensionLike, options: InstallOptions, message: string): void {
195
+ if (typeof options.warn === "function") {
196
+ options.warn(message);
197
+ return;
198
+ }
199
+ if (typeof pi.logger?.warn === "function") {
200
+ pi.logger.warn(message);
201
+ return;
202
+ }
203
+ if (typeof pi.log?.warn === "function") {
204
+ pi.log.warn(message);
205
+ return;
206
+ }
207
+ console.warn(message);
208
+ }
209
+
210
+ export function resolveRemoteProject(pi: ExtensionLike, argv: string[] = process.argv): string {
211
+ for (let i = argv.length - 2; i >= 0; i--) {
212
+ if (argv[i] === "--project" && typeof argv[i + 1] === "string" && argv[i + 1].trim()) {
213
+ return argv[i + 1].trim();
214
+ }
215
+ }
216
+ const inlineProject = [...argv].reverse().find((arg) => arg.startsWith("--project="))?.slice("--project=".length).trim();
217
+ if (inlineProject) return inlineProject;
218
+ const cliProject = typeof pi.getFlag === "function" ? pi.getFlag("project") : undefined;
219
+ if (typeof cliProject === "string" && cliProject.trim()) return cliProject.trim();
220
+ const envProject = process.env.PI_COMS_PROJECT;
221
+ return envProject?.trim() || "default";
222
+ }
223
+
224
+ function linkAbortSignal(parent: AbortSignal | undefined, child: AbortController): void {
225
+ if (!parent) return;
226
+ if (parent.aborted) {
227
+ child.abort();
228
+ return;
229
+ }
230
+ parent.addEventListener("abort", () => child.abort(), { once: true });
231
+ }
232
+
233
+ function stockResultFromRemote(params: any, response: any): any {
234
+ const summary = response?.kind === "selection"
235
+ ? (Array.isArray(response.selections) ? response.selections.join(", ") : "")
236
+ : response?.kind === "freeform"
237
+ ? String(response.text ?? "")
238
+ : typeof response === "string"
239
+ ? response
240
+ : JSON.stringify(response);
241
+ return {
242
+ content: [{ type: "text", text: `User answered: ${summary}` }],
243
+ details: {
244
+ question: params?.question,
245
+ context: params?.context?.trim?.() || params?.context,
246
+ options: normalizeOptions(params?.options ?? []),
247
+ response,
248
+ cancelled: false,
249
+ },
250
+ };
251
+ }
252
+
253
+ function normalizeOptions(options: any[]): Array<{ title: string; description?: string }> {
254
+ return (Array.isArray(options) ? options : [])
255
+ .map((option) => {
256
+ if (typeof option === "string") return { title: option };
257
+ if (option && typeof option === "object" && typeof option.title === "string") {
258
+ return typeof option.description === "string"
259
+ ? { title: option.title, description: option.description }
260
+ : { title: option.title };
261
+ }
262
+ return null;
263
+ })
264
+ .filter(Boolean) as Array<{ title: string; description?: string }>;
265
+ }
266
+
267
+ // Live remote questions started by defaultStartRemote, keyed by qid. A cancel
268
+ // must settle the pending result so the per-question endpoint server is closed;
269
+ // otherwise every locally-answered race leaks a bound socket until process exit.
270
+ const activeRemote = new Map<string, (error: Error) => void>();
271
+
272
+ export function activeRemoteCount(): number {
273
+ return activeRemote.size;
274
+ }
275
+
276
+ async function defaultStartRemote(params: any, project: string): Promise<{ qid: string; result: Promise<any> } | null> {
277
+ const coms = await import("../../../scripts/lib/coms-envelope.ts");
278
+ const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
279
+ const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
280
+ if (!peer) return null;
281
+
282
+ coms.ensureComsDirs(project);
283
+ const id = {
284
+ session_id: coms.ulid(),
285
+ name: "ask-user-remote",
286
+ endpoint: "",
287
+ cwd: process.cwd(),
288
+ };
289
+ id.endpoint = coms.makeEndpoint(id.session_id);
290
+
291
+ let resolveResult!: (value: any) => void;
292
+ let rejectResult!: (error: Error) => void;
293
+ const rawResult = new Promise<any>((resolve, reject) => {
294
+ resolveResult = resolve;
295
+ rejectResult = reject;
296
+ });
297
+ const server = await coms.bindEndpoint(
298
+ id.endpoint,
299
+ coms.makeConnHandler((env: Record<string, unknown>, socket: any) => {
300
+ if (coms.isResponseEnvelope(env)) {
301
+ coms.writeAck(socket, env.msg_id);
302
+ if (env.error) rejectResult(new Error(String(env.error)));
303
+ else resolveResult(stockResultFromRemote(params, env.response));
304
+ return;
305
+ }
306
+ coms.writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "ask-user-remote awaits responses only");
307
+ }),
308
+ );
309
+ const cleanup = () => {
310
+ try { server.close(); } catch { /* ignore */ }
311
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
312
+ };
313
+
314
+ const promptPayload = JSON.stringify({
315
+ question: params?.question,
316
+ context: params?.context,
317
+ options: params?.options ?? [],
318
+ });
319
+ const env = coms.makePromptEnvelope(id, promptPayload);
320
+ activeRemote.set(env.msg_id, rejectResult);
321
+ const result = rawResult.finally(() => {
322
+ activeRemote.delete(env.msg_id);
323
+ cleanup();
324
+ });
325
+ try {
326
+ await coms.sendEnvelope(peer.endpoint, env);
327
+ } catch (error) {
328
+ rejectResult(error instanceof Error ? error : new Error(String(error)));
329
+ }
330
+ return { qid: env.msg_id, result };
331
+ }
332
+
333
+ async function defaultCancelRemote(qid: string, reason: string, project: string): Promise<void> {
334
+ try {
335
+ const coms = await import("../../../scripts/lib/coms-envelope.ts");
336
+ const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
337
+ const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
338
+ if (peer) {
339
+ await coms.sendEnvelope(peer.endpoint, coms.makeCancelEnvelope({
340
+ from: "ask-user-remote",
341
+ to: peer.name,
342
+ ref_msg_id: qid,
343
+ }));
344
+ }
345
+ } finally {
346
+ // The bridge sends no response for a cancelled qid, so settle the pending
347
+ // result here to release the per-question endpoint server.
348
+ activeRemote.get(qid)?.(new Error(`ask-user-remote: cancelled (${reason})`));
349
+ }
350
+ }
351
+
352
+ // Keep UI preferences in the stock implementation; expose only question semantics.
353
+ export const COMPACT_ASK_USER_PARAMETERS = {
354
+ type: "object",
355
+ properties: {
356
+ question: { type: "string", description: "One focused question." },
357
+ context: { type: "string", description: "Short decision context." },
358
+ options: { type: "array", items: { type: "string", description: "Choice label." }, minItems: 2, maxItems: 6, description: "Two to six choices." },
359
+ allowMultiple: { type: "boolean", description: "Allow several choices." },
360
+ allowFreeform: { type: "boolean", description: "Allow a typed answer." },
361
+ allowComment: { type: "boolean", description: "Allow an optional comment." },
362
+ },
363
+ required: ["question"],
364
+ } as const;
365
+
366
+ export function compactAskUserParams(params: any): any {
367
+ return {
368
+ question: params?.question,
369
+ ...(params?.context === undefined ? {} : { context: params.context }),
370
+ ...(params?.options === undefined ? {} : { options: normalizeOptions(params.options) }),
371
+ ...(params?.allowMultiple === undefined ? {} : { allowMultiple: params.allowMultiple }),
372
+ ...(params?.allowFreeform === undefined ? {} : { allowFreeform: params.allowFreeform }),
373
+ ...(params?.allowComment === undefined ? {} : { allowComment: params.allowComment }),
374
+ };
375
+ }
376
+
377
+ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOptions = {}): ToolRegistration {
378
+ return {
379
+ ...stockTool,
380
+ description: "Ask one focused human question; choices are optional.",
381
+ promptSnippet: "Ask one focused human question",
382
+ promptGuidelines: ["Ask one focused question per call."],
383
+ parameters: COMPACT_ASK_USER_PARAMETERS,
384
+ async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
385
+ const stockParams = compactAskUserParams(params);
386
+ emitAskUserObservation({ params: stockParams, phase: "start" });
387
+ const configuredProject = typeof options.remoteProject === "function" ? options.remoteProject() : options.remoteProject;
388
+ const remoteProject = configuredProject ?? process.env.PI_COMS_PROJECT?.trim() ?? "default";
389
+ const startRemote = options.startRemote ?? ((remoteParams: any) => defaultStartRemote(remoteParams, remoteProject));
390
+ let remoteStart: { qid: string; result: Promise<any> } | null = null;
391
+ try {
392
+ remoteStart = await startRemote(stockParams, ctx);
393
+ } catch {
394
+ remoteStart = null;
395
+ }
396
+
397
+ if (!remoteStart) {
398
+ const result = await stockTool.execute?.(toolCallId, stockParams, signal, onUpdate, ctx);
399
+ emitAskUserObservation({ params: stockParams, result, phase: "result" });
400
+ return result;
401
+ }
402
+
403
+ const result = await raceAskUser({
404
+ runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, stockParams, localSignal, onUpdate, ctx),
405
+ startRemote: () => remoteStart,
406
+ cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
407
+ createAbortController: () => {
408
+ const controller = options.createAbortController?.() ?? new AbortController();
409
+ linkAbortSignal(signal, controller);
410
+ return controller;
411
+ },
412
+ signal,
413
+ });
414
+ emitAskUserObservation({ params: stockParams, result, phase: "result" });
415
+ return result;
416
+ },
417
+ };
418
+ }
419
+
420
+ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions = {}): { registered: boolean; tool?: ToolRegistration } {
421
+ const discoveryDisabled = options.extensionDiscoveryDisabled === true;
422
+ // Settings presence is not runtime availability: under --no-extensions the
423
+ // package entry is dormant and the wrapper must still install itself.
424
+ if (!discoveryDisabled && options.settingsPaths) {
425
+ const listed = findStockAskUserPackageEntry(options.settingsPaths);
426
+ if (listed) {
427
+ warn(pi, options, `ask-user-remote: "${listed.entry}" is listed in ${listed.settingsPath} "packages" and extension discovery is enabled; skipping the ask_user wrapper so the stock package registers without a tool conflict (remote answer racing disabled for this session).`);
428
+ return { registered: false };
429
+ }
430
+ }
431
+ if (!options.stockFactory) throw new Error("ask-user-remote: stockFactory is required for synchronous install");
432
+ const stockTool = captureAskUserTool(options.stockFactory, pi);
433
+ const wrapped = wrapAskUserTool(stockTool, {
434
+ ...options,
435
+ remoteProject: options.remoteProject ?? (() => resolveRemoteProject(pi)),
436
+ });
437
+ try {
438
+ pi.registerTool(wrapped);
439
+ return { registered: true, tool: wrapped };
440
+ } catch (error) {
441
+ const message = error instanceof Error ? error.message : String(error);
442
+ warn(pi, options, `ask-user-remote: ask_user already registered; wrapper not installed (${message})`);
443
+ return { registered: false };
444
+ }
445
+ }
446
+
447
+ const STOCK_ENTRY_NAMES = ["index.ts", "index.js", "index.mjs"] as const;
448
+
449
+ function stockEntriesUnder(packageDir: string): string[] {
450
+ return STOCK_ENTRY_NAMES.map((name) => path.join(packageDir, name));
451
+ }
452
+
453
+ /**
454
+ * Candidate filesystem paths for stock `pi-ask-user`, in priority order:
455
+ * 1. Package-native bundled dependency beside the Agent Fleet package
456
+ * 2. Project Pi package (`.pi/npm`)
457
+ * 3. Harness runtime dependency (`.pi/harnesses/node_modules`)
458
+ * 4. Global Pi package (`~/.pi/agent/npm`)
459
+ *
460
+ * Each root expands to `index.ts`, then `index.js` / `index.mjs` so plain-Node
461
+ * smoke fixtures can supply a JS stub while production still prefers the
462
+ * upstream TypeScript entry that Pi's jiti loader understands.
463
+ */
464
+ export function stockAskUserCandidatePaths(options: ResolveStockOptions = {}): string[] {
465
+ const moduleUrl = options.moduleUrl ?? import.meta.url;
466
+ const cwd = options.cwd ?? process.cwd();
467
+ const homeDir = options.homeDir ?? os.homedir();
468
+
469
+ // Pi's jiti loader preserves the workspace-facing path of a symlinked
470
+ // harness. Canonicalize this module first so the bundled dependency is
471
+ // resolved beside the actual Agent Fleet package, not at workspace root.
472
+ const realModulePath = fs.realpathSync(fileURLToPath(moduleUrl));
473
+ const moduleDir = path.dirname(realModulePath);
474
+ // ask-user-remote lives at <package>/.pi/harnesses/ask-user-remote
475
+ const packageRoot = path.resolve(moduleDir, "../../..");
476
+ const harnessRoot = path.resolve(moduleDir, "..");
477
+
478
+ let isPackageNative = false;
479
+ try {
480
+ isPackageNative = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"))?.name === "@chankov/agent-fleet";
481
+ } catch {
482
+ // A copied harness has no Agent Fleet package root; do not treat the
483
+ // downstream application's node_modules as a bundled runtime source.
484
+ }
485
+
486
+ const roots = [
487
+ ...(isPackageNative ? [path.join(packageRoot, "node_modules", "pi-ask-user")] : []),
488
+ path.join(cwd, ".pi", "npm", "node_modules", "pi-ask-user"),
489
+ path.join(harnessRoot, "node_modules", "pi-ask-user"),
490
+ path.join(cwd, ".pi", "harnesses", "node_modules", "pi-ask-user"),
491
+ path.join(homeDir, ".pi", "agent", "npm", "node_modules", "pi-ask-user"),
492
+ ];
493
+ return roots.flatMap((root) => stockEntriesUnder(root));
494
+ }
495
+
496
+ export const MISSING_STOCK_ASK_USER_MESSAGE =
497
+ "ask-user-remote: pi-ask-user not found. Run `npm ci --prefix .pi/harnesses` and/or `pi install -l npm:pi-ask-user`.";
498
+
499
+ export function resolveStockAskUserModule(options: ResolveStockOptions | string = {}): string {
500
+ // Back-compat: older callers passed moduleUrl as the first positional arg.
501
+ const normalized: ResolveStockOptions = typeof options === "string" ? { moduleUrl: options } : options;
502
+ const seen = new Set<string>();
503
+ for (const candidate of stockAskUserCandidatePaths(normalized)) {
504
+ const resolved = path.resolve(candidate);
505
+ if (seen.has(resolved)) continue;
506
+ seen.add(resolved);
507
+ if (fs.existsSync(resolved)) {
508
+ return pathToFileURL(fs.realpathSync(resolved)).href;
509
+ }
510
+ }
511
+ throw new Error(MISSING_STOCK_ASK_USER_MESSAGE);
512
+ }
513
+
514
+ async function loadStockFactory(): Promise<(pi: ExtensionLike) => void> {
515
+ const mod = await import(resolveStockAskUserModule());
516
+ return mod.default as (pi: ExtensionLike) => void;
517
+ }
518
+
519
+ export default async function askUserRemote(pi: ExtensionLike): Promise<void> {
520
+ // Await registration so session_start probes (e.g. agent-hub getAllTools)
521
+ // see ask_user after extension factories finish loading.
522
+ try {
523
+ const stockFactory = await loadStockFactory();
524
+ installAskUserRemote(pi, {
525
+ stockFactory,
526
+ settingsPaths: defaultSettingsPaths(),
527
+ extensionDiscoveryDisabled: hasDisabledExtensionDiscovery(),
528
+ });
529
+ } catch (error) {
530
+ warn(pi, {}, `ask-user-remote: failed to load pi-ask-user (${error instanceof Error ? error.message : String(error)})`);
531
+ }
532
+ }
@@ -0,0 +1,106 @@
1
+ // Pure race arbitration for the ask-user-remote harness.
2
+ //
3
+ // The wrapper supplies the side-effecting pieces:
4
+ // - runLocal(signal): stock pi-ask-user execute with an AbortSignal
5
+ // - startRemote(): starts a user-remote coms request and returns
6
+ // { qid, result: Promise<stock-shaped ask_user result> }, or null when no peer
7
+ // - cancelRemote(qid, reason): best-effort cancel envelope for local-first wins
8
+ //
9
+ // This module owns only the first-answer-wins latch and exactly-once cancel/
10
+ // abort decisions; it has no pi, socket, or filesystem imports.
11
+
12
+ export async function raceAskUser({
13
+ runLocal,
14
+ startRemote,
15
+ cancelRemote,
16
+ createAbortController = () => new AbortController(),
17
+ signal,
18
+ }) {
19
+ if (typeof runLocal !== "function") throw new TypeError("runLocal is required");
20
+
21
+ const controller = createAbortController();
22
+ let settled = false;
23
+ let remotePending = false;
24
+ let remoteQid = null;
25
+ let cancelSent = false;
26
+
27
+ async function emitCancel(reason) {
28
+ if (cancelSent || !remotePending || !remoteQid || typeof cancelRemote !== "function") return;
29
+ cancelSent = true;
30
+ try {
31
+ await cancelRemote(remoteQid, reason);
32
+ } catch {
33
+ // Cancel is best-effort; the winning local answer must not fail because
34
+ // the losing remote channel is already unhealthy.
35
+ }
36
+ }
37
+
38
+ const localPromise = Promise.resolve().then(() => runLocal(controller.signal));
39
+
40
+ let remoteStart = null;
41
+ if (typeof startRemote === "function") {
42
+ try {
43
+ remoteStart = await Promise.resolve().then(() => startRemote());
44
+ } catch {
45
+ remoteStart = null;
46
+ }
47
+ }
48
+
49
+ // No live user-remote peer, or remote startup failed before a qid existed:
50
+ // preserve stock pi-ask-user behavior exactly by returning the local result.
51
+ if (!remoteStart) return await localPromise;
52
+
53
+ remoteQid = typeof remoteStart.qid === "string" ? remoteStart.qid : null;
54
+ remotePending = !!remoteQid;
55
+ const remotePromise = Promise.resolve(remoteStart.result);
56
+
57
+ // If the whole tool call is aborted (turn cancelled), withdraw the remote
58
+ // question instead of leaving it live on the phone until timeout.
59
+ if (signal) {
60
+ if (signal.aborted) void emitCancel("aborted");
61
+ else signal.addEventListener("abort", () => { void emitCancel("aborted"); }, { once: true });
62
+ }
63
+
64
+ return await new Promise((resolve, reject) => {
65
+ let localRejected = false;
66
+ let localError;
67
+ let remoteRejected = false;
68
+
69
+ localPromise.then(
70
+ async (result) => {
71
+ if (settled) return;
72
+ settled = true;
73
+ await emitCancel("local_answered");
74
+ resolve(result);
75
+ },
76
+ (error) => {
77
+ if (settled) return;
78
+ localRejected = true;
79
+ localError = error;
80
+ if (remoteRejected) {
81
+ settled = true;
82
+ reject(localError);
83
+ }
84
+ },
85
+ );
86
+
87
+ remotePromise.then(
88
+ (result) => {
89
+ remotePending = false;
90
+ if (settled) return;
91
+ settled = true;
92
+ controller.abort?.();
93
+ resolve(result);
94
+ },
95
+ () => {
96
+ remotePending = false;
97
+ remoteRejected = true;
98
+ // Remote errors are non-fatal: keep waiting for stock local behavior.
99
+ if (localRejected) {
100
+ settled = true;
101
+ reject(localError);
102
+ }
103
+ },
104
+ );
105
+ });
106
+ }