@zhushanwen/pi-subagent-workflow 8.6.0 → 8.7.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 (347) hide show
  1. package/package.json +9 -13
  2. package/relay/relay.mjs +1 -1
  3. package/src/host/__tests__/pi-host.test.ts +214 -0
  4. package/src/host/pi-host.ts +109 -0
  5. package/src/index.ts +89 -32
  6. package/src/injectors/__tests__/engine-awareness.test.ts +292 -0
  7. package/src/injectors/__tests__/engine-section-stability.test.ts +341 -0
  8. package/src/injectors/__tests__/subagent-list-injector.test.ts +5 -5
  9. package/src/injectors/__tests__/workflow-list-injector.test.ts +5 -5
  10. package/src/injectors/engine-awareness.ts +123 -0
  11. package/src/injectors/model-list-injector.ts +1 -1
  12. package/src/injectors/subagent-list-injector.ts +8 -8
  13. package/src/injectors/workflow-list-injector.ts +8 -8
  14. package/src/interface/__tests__/detectors.test.ts +3 -3
  15. package/src/interface/__tests__/subagent-tool-path-guard.test.ts +2 -2
  16. package/src/interface/__tests__/tool-workflow-script-generate.test.ts +2 -2
  17. package/src/interface/__tests__/tool-workflow-throw-paths.test.ts +1 -1
  18. package/src/interface/bg-notify-render.ts +4 -4
  19. package/src/interface/commands.ts +3 -3
  20. package/src/interface/format.ts +2 -2
  21. package/src/interface/helpers.ts +1 -1
  22. package/src/interface/list-component.ts +4 -4
  23. package/src/interface/list-shared.ts +2 -2
  24. package/src/interface/list-view.ts +2 -2
  25. package/src/interface/subagent-actions.ts +263 -11
  26. package/src/interface/subagent-tool-schema.ts +20 -13
  27. package/src/interface/subagent-tool.ts +11 -6
  28. package/src/interface/subagents.ts +3 -3
  29. package/src/interface/tool-render.ts +34 -2
  30. package/src/interface/tool-workflow-script.ts +4 -4
  31. package/src/interface/tool-workflow.ts +6 -6
  32. package/src/interface/views/WorkflowsView.ts +5 -5
  33. package/src/interface/views/__tests__/WorkflowsView-signature.test.ts +3 -3
  34. package/src/interface/views/__tests__/detail-content-session-file.test.ts +2 -2
  35. package/src/interface/views/detail-content.ts +4 -4
  36. package/src/interface/views/format.ts +4 -4
  37. package/src/{orchestration/jsonl-run-store.ts → jsonl-run-store.ts} +11 -11
  38. package/src/execution/__tests__/__fixtures__/notifier-golden-snapshots.json +0 -53
  39. package/src/execution/__tests__/__fixtures__/truncline.snapshot.json +0 -1
  40. package/src/execution/__tests__/agent-registry.test.ts +0 -363
  41. package/src/execution/__tests__/agent-result-mapper.test.ts +0 -150
  42. package/src/execution/__tests__/alive-store.test.ts +0 -147
  43. package/src/execution/__tests__/ask-user-transit-e2e.test.ts +0 -490
  44. package/src/execution/__tests__/before-agent-start-injection.test.ts +0 -132
  45. package/src/execution/__tests__/bg-notify-render.test.ts +0 -329
  46. package/src/execution/__tests__/channel-registry-handshake.test.ts +0 -243
  47. package/src/execution/__tests__/chat-engine-routing.test.ts +0 -601
  48. package/src/execution/__tests__/chatmode-first-round-closure-service.test.ts +0 -365
  49. package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +0 -190
  50. package/src/execution/__tests__/chatmode-round-notify-real-chain.test.ts +0 -215
  51. package/src/execution/__tests__/concurrency-pool.test.ts +0 -250
  52. package/src/execution/__tests__/config.test.ts +0 -110
  53. package/src/execution/__tests__/conversation-wiring.test.ts +0 -198
  54. package/src/execution/__tests__/crash-recovery.test.ts +0 -320
  55. package/src/execution/__tests__/delivery-methods.test.ts +0 -422
  56. package/src/execution/__tests__/dialog-queue.test.ts +0 -299
  57. package/src/execution/__tests__/epipe-fallback.test.ts +0 -241
  58. package/src/execution/__tests__/execute-and-await-worktree.test.ts +0 -243
  59. package/src/execution/__tests__/execute-nesting.test.ts +0 -323
  60. package/src/execution/__tests__/execute-options-mapper.test.ts +0 -200
  61. package/src/execution/__tests__/execution-record.test.ts +0 -1394
  62. package/src/execution/__tests__/explicit-agent-ref-guard.test.ts +0 -171
  63. package/src/execution/__tests__/finalize-record.test.ts +0 -368
  64. package/src/execution/__tests__/finalized-marker.test.ts +0 -82
  65. package/src/execution/__tests__/format-schema-instruction.test.ts +0 -169
  66. package/src/execution/__tests__/format.test.ts +0 -458
  67. package/src/execution/__tests__/gc-timer.test.ts +0 -184
  68. package/src/execution/__tests__/get-record-for-action-restart.test.ts +0 -254
  69. package/src/execution/__tests__/gui-mode-dispatch.test.ts +0 -59
  70. package/src/execution/__tests__/helpers/mock-extension-api.ts +0 -30
  71. package/src/execution/__tests__/helpers/spawn-mock.ts +0 -242
  72. package/src/execution/__tests__/host-mode.test.ts +0 -87
  73. package/src/execution/__tests__/index-session-start-identity.test.ts +0 -371
  74. package/src/execution/__tests__/index-session-start.test.ts +0 -672
  75. package/src/execution/__tests__/lifecycle-manager-lock.test.ts +0 -211
  76. package/src/execution/__tests__/lifecycle-manager.test.ts +0 -383
  77. package/src/execution/__tests__/lifecycle-predicates.test.ts +0 -116
  78. package/src/execution/__tests__/list-component.test.ts +0 -401
  79. package/src/execution/__tests__/list-fields.test.ts +0 -140
  80. package/src/execution/__tests__/manifest-parentid.test.ts +0 -117
  81. package/src/execution/__tests__/model-resolver.test.ts +0 -465
  82. package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +0 -287
  83. package/src/execution/__tests__/nested-visibility.test.ts +0 -325
  84. package/src/execution/__tests__/notifier-flush.test.ts +0 -612
  85. package/src/execution/__tests__/notifier-golden-snapshot.test.ts +0 -261
  86. package/src/execution/__tests__/notify-ledger.test.ts +0 -826
  87. package/src/execution/__tests__/one-shot-upgrade.test.ts +0 -205
  88. package/src/execution/__tests__/output-collector.test.ts +0 -358
  89. package/src/execution/__tests__/parent-child-matrix.test.ts +0 -336
  90. package/src/execution/__tests__/path-encoding.test.ts +0 -104
  91. package/src/execution/__tests__/pi-invocation.test.ts +0 -134
  92. package/src/execution/__tests__/record-store.test.ts +0 -1057
  93. package/src/execution/__tests__/records-cwd-isolation.test.ts +0 -91
  94. package/src/execution/__tests__/recursive-visibility-baseline.test.ts +0 -339
  95. package/src/execution/__tests__/recursive-visibility-env.test.ts +0 -273
  96. package/src/execution/__tests__/relay-agent.test.ts +0 -448
  97. package/src/execution/__tests__/relay-env.test.ts +0 -42
  98. package/src/execution/__tests__/resource-policy.test.ts +0 -109
  99. package/src/execution/__tests__/rpc-mode.test.ts +0 -89
  100. package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +0 -267
  101. package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +0 -253
  102. package/src/execution/__tests__/run-spawn-edges.test.ts +0 -687
  103. package/src/execution/__tests__/run-spawn-integration.test.ts +0 -933
  104. package/src/execution/__tests__/run-spawn-resume.test.ts +0 -322
  105. package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +0 -196
  106. package/src/execution/__tests__/run-spawn-stdout-callback-throw.test.ts +0 -199
  107. package/src/execution/__tests__/sdk-contract.test.ts +0 -273
  108. package/src/execution/__tests__/session-context-resolver.test.ts +0 -167
  109. package/src/execution/__tests__/session-file-gc.test.ts +0 -293
  110. package/src/execution/__tests__/session-pending.test.ts +0 -197
  111. package/src/execution/__tests__/session-reconstructor.test.ts +0 -379
  112. package/src/execution/__tests__/session-runner-epipe.test.ts +0 -178
  113. package/src/execution/__tests__/session-runner-schema-env.test.ts +0 -350
  114. package/src/execution/__tests__/session-start-reaper.test.ts +0 -233
  115. package/src/execution/__tests__/spawn-args.test.ts +0 -445
  116. package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +0 -189
  117. package/src/execution/__tests__/spawn-event-adapter.test.ts +0 -167
  118. package/src/execution/__tests__/spawn-worktree-guidance.test.ts +0 -207
  119. package/src/execution/__tests__/spawned-children.test.ts +0 -92
  120. package/src/execution/__tests__/start-sync-model-guard.test.ts +0 -150
  121. package/src/execution/__tests__/startup-config-declaration.test.ts +0 -35
  122. package/src/execution/__tests__/status-refactor.test.ts +0 -345
  123. package/src/execution/__tests__/stdin-writer.test.ts +0 -463
  124. package/src/execution/__tests__/stream-sink-retirement.test.ts +0 -261
  125. package/src/execution/__tests__/subagent-service-abort.test.ts +0 -60
  126. package/src/execution/__tests__/subagent-service-message-close.test.ts +0 -629
  127. package/src/execution/__tests__/subagent-service-parent-guard.test.ts +0 -180
  128. package/src/execution/__tests__/subagent-service.test.ts +0 -788
  129. package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +0 -310
  130. package/src/execution/__tests__/subprocess-agent-runner.test.ts +0 -599
  131. package/src/execution/__tests__/temp-prompt.test.ts +0 -53
  132. package/src/execution/__tests__/timeout-integration.test.ts +0 -615
  133. package/src/execution/__tests__/tombstone-store.test.ts +0 -73
  134. package/src/execution/__tests__/tool-action.test.ts +0 -476
  135. package/src/execution/__tests__/truncline-snapshot.test.ts +0 -81
  136. package/src/execution/__tests__/turn-limiter-semantics.test.ts +0 -194
  137. package/src/execution/__tests__/turn-limiter.test.ts +0 -65
  138. package/src/execution/__tests__/ui-channels.test.ts +0 -187
  139. package/src/execution/__tests__/ui-interaction-model.test.ts +0 -67
  140. package/src/execution/__tests__/ui-request-handler-factory.test.ts +0 -370
  141. package/src/execution/__tests__/ui-request-handler.test.ts +0 -204
  142. package/src/execution/__tests__/ui-request-observability.test.ts +0 -114
  143. package/src/execution/__tests__/ui-request-queue.test.ts +0 -133
  144. package/src/execution/__tests__/worktree-manager.test.ts +0 -633
  145. package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +0 -229
  146. package/src/execution/__tests__/worktree-reconcile.integration.test.ts +0 -181
  147. package/src/execution/__tests__/worktree-registry.test.ts +0 -199
  148. package/src/execution/agent-registry.ts +0 -199
  149. package/src/execution/agent-result-mapper.ts +0 -90
  150. package/src/execution/alive-store.ts +0 -92
  151. package/src/execution/argv-mirror.ts +0 -113
  152. package/src/execution/best-effort.ts +0 -38
  153. package/src/execution/channel-registry-access.ts +0 -144
  154. package/src/execution/concurrency-pool.ts +0 -116
  155. package/src/execution/config.ts +0 -96
  156. package/src/execution/dialog-queue.ts +0 -330
  157. package/src/execution/engine/__tests__/common/data-dir.test.ts +0 -53
  158. package/src/execution/engine/__tests__/common/errors.test.ts +0 -132
  159. package/src/execution/engine/__tests__/common/event-journal.test.ts +0 -177
  160. package/src/execution/engine/__tests__/common/kill-chain.test.ts +0 -192
  161. package/src/execution/engine/__tests__/common/nesting-guard.test.ts +0 -81
  162. package/src/execution/engine/__tests__/common/persona-router.test.ts +0 -123
  163. package/src/execution/engine/__tests__/common/pool-manager.test.ts +0 -154
  164. package/src/execution/engine/__tests__/common/schema-emulation.test.ts +0 -128
  165. package/src/execution/engine/__tests__/conformance/__fixtures__/pi-golden-events.json +0 -28
  166. package/src/execution/engine/__tests__/conformance/agent-event-invariants.ts +0 -141
  167. package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +0 -109
  168. package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +0 -101
  169. package/src/execution/engine/__tests__/conformance/contract.probe.test.ts +0 -77
  170. package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +0 -104
  171. package/src/execution/engine/__tests__/conformance/contract.relay.test.ts +0 -342
  172. package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +0 -201
  173. package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +0 -76
  174. package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +0 -79
  175. package/src/execution/engine/__tests__/engine-discovery.test.ts +0 -87
  176. package/src/execution/engine/__tests__/engines-declaration.test.ts +0 -36
  177. package/src/execution/engine/__tests__/model-prompt.test.ts +0 -85
  178. package/src/execution/engine/__tests__/paths.test.ts +0 -39
  179. package/src/execution/engine/__tests__/registry.test.ts +0 -120
  180. package/src/execution/engine/__tests__/routing.test.ts +0 -231
  181. package/src/execution/engine/common/data-dir.ts +0 -62
  182. package/src/execution/engine/common/errors.ts +0 -183
  183. package/src/execution/engine/common/event-journal.ts +0 -254
  184. package/src/execution/engine/common/journal-replay.ts +0 -62
  185. package/src/execution/engine/common/kill-chain.ts +0 -221
  186. package/src/execution/engine/common/nesting-guard.ts +0 -50
  187. package/src/execution/engine/common/persona-router.ts +0 -108
  188. package/src/execution/engine/common/pool-manager.ts +0 -226
  189. package/src/execution/engine/common/schema-emulation.ts +0 -189
  190. package/src/execution/engine/common/session-view-projection.ts +0 -51
  191. package/src/execution/engine/engine-discovery.ts +0 -65
  192. package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +0 -469
  193. package/src/execution/engine/engines/pi/__tests__/reader.test.ts +0 -155
  194. package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
  195. package/src/execution/engine/engines/pi/pi-engine.ts +0 -415
  196. package/src/execution/engine/engines/pi/reader.ts +0 -48
  197. package/src/execution/engine/engines/pi/registration.ts +0 -35
  198. package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
  199. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
  200. package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
  201. package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +0 -246
  202. package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +0 -228
  203. package/src/execution/engine/engines/zcode/__tests__/reader.test.ts +0 -210
  204. package/src/execution/engine/engines/zcode/__tests__/registration.test.ts +0 -64
  205. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +0 -127
  206. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -580
  207. package/src/execution/engine/engines/zcode/constants.ts +0 -43
  208. package/src/execution/engine/engines/zcode/golden-sample.ts +0 -39
  209. package/src/execution/engine/engines/zcode/launcher.ts +0 -161
  210. package/src/execution/engine/engines/zcode/parser.ts +0 -436
  211. package/src/execution/engine/engines/zcode/preparer.ts +0 -363
  212. package/src/execution/engine/engines/zcode/reader.ts +0 -381
  213. package/src/execution/engine/engines/zcode/registration.ts +0 -37
  214. package/src/execution/engine/engines/zcode/zcode-engine.ts +0 -658
  215. package/src/execution/engine/host-task-spec.ts +0 -47
  216. package/src/execution/engine/model-prompt.ts +0 -59
  217. package/src/execution/engine/paths.ts +0 -42
  218. package/src/execution/engine/port.ts +0 -153
  219. package/src/execution/engine/registry.ts +0 -123
  220. package/src/execution/engine/routing.ts +0 -218
  221. package/src/execution/engine/types.ts +0 -309
  222. package/src/execution/execute-options-mapper.ts +0 -112
  223. package/src/execution/execution-record.ts +0 -965
  224. package/src/execution/finalize-record.ts +0 -251
  225. package/src/execution/finalized-marker.ts +0 -51
  226. package/src/execution/get-state-handshake.ts +0 -104
  227. package/src/execution/host-mode.ts +0 -56
  228. package/src/execution/idle-gc.ts +0 -47
  229. package/src/execution/lifecycle-manager.ts +0 -513
  230. package/src/execution/lifecycle-predicates.ts +0 -65
  231. package/src/execution/manifest-store.ts +0 -256
  232. package/src/execution/model-config-service.ts +0 -219
  233. package/src/execution/model-resolver.ts +0 -248
  234. package/src/execution/notifier.ts +0 -330
  235. package/src/execution/notify-ledger.ts +0 -580
  236. package/src/execution/output-collector.ts +0 -228
  237. package/src/execution/path-encoding.ts +0 -60
  238. package/src/execution/pi-invocation.ts +0 -120
  239. package/src/execution/record-entry.ts +0 -132
  240. package/src/execution/record-store.ts +0 -1234
  241. package/src/execution/relay-env.ts +0 -37
  242. package/src/execution/session-context-resolver.ts +0 -64
  243. package/src/execution/session-file-gc.ts +0 -120
  244. package/src/execution/session-pending.ts +0 -164
  245. package/src/execution/session-reconstructor.ts +0 -678
  246. package/src/execution/session-runner.ts +0 -1781
  247. package/src/execution/sessions-index.ts +0 -304
  248. package/src/execution/spawn-event-adapter.ts +0 -363
  249. package/src/execution/stdin-writer.ts +0 -198
  250. package/src/execution/stream-sink.ts +0 -126
  251. package/src/execution/subagent-service.ts +0 -2141
  252. package/src/execution/subprocess-agent-runner.ts +0 -317
  253. package/src/execution/temp-prompt.ts +0 -62
  254. package/src/execution/tombstone-store.ts +0 -72
  255. package/src/execution/turn-limiter.ts +0 -102
  256. package/src/execution/types.ts +0 -973
  257. package/src/execution/ui-channels.ts +0 -216
  258. package/src/execution/ui-interaction-model.ts +0 -48
  259. package/src/execution/ui-request-handler-factory.ts +0 -212
  260. package/src/execution/ui-request-observability.ts +0 -81
  261. package/src/execution/ui-request-queue.ts +0 -184
  262. package/src/execution/worktree-manager.ts +0 -688
  263. package/src/execution/worktree-registry.ts +0 -222
  264. package/src/orchestration/__tests__/__fixtures__/worker-template.snapshot.txt +0 -349
  265. package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +0 -202
  266. package/src/orchestration/__tests__/agent-call-stream.test.ts +0 -152
  267. package/src/orchestration/__tests__/args-validator.test.ts +0 -143
  268. package/src/orchestration/__tests__/config-loader.test.ts +0 -503
  269. package/src/orchestration/__tests__/error-recovery-handlers.test.ts +0 -809
  270. package/src/orchestration/__tests__/error-recovery-postmessage-defense.test.ts +0 -405
  271. package/src/orchestration/__tests__/error-recovery-serialize-failed-result.test.ts +0 -56
  272. package/src/orchestration/__tests__/error-recovery-workflow-call.test.ts +0 -166
  273. package/src/orchestration/__tests__/execute-agent-call.test.ts +0 -451
  274. package/src/orchestration/__tests__/jsonl-run-store-corrupt-entry.test.ts +0 -150
  275. package/src/orchestration/__tests__/jsonl-run-store-loadall-sources.test.ts +0 -171
  276. package/src/orchestration/__tests__/jsonl-run-store-retention.test.ts +0 -202
  277. package/src/orchestration/__tests__/jsonl-run-store-session-file.test.ts +0 -1030
  278. package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +0 -600
  279. package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +0 -96
  280. package/src/orchestration/__tests__/lifecycle.test.ts +0 -659
  281. package/src/orchestration/__tests__/non-cloneable-return-e2e.test.ts +0 -95
  282. package/src/orchestration/__tests__/review-fix-loop-e2e.test.ts +0 -2025
  283. package/src/orchestration/__tests__/script-lint.test.ts +0 -831
  284. package/src/orchestration/__tests__/skill-discovery.test.ts +0 -201
  285. package/src/orchestration/__tests__/test-mocks.ts +0 -197
  286. package/src/orchestration/__tests__/worker-exit-without-result.test.ts +0 -368
  287. package/src/orchestration/__tests__/worker-host.test.ts +0 -120
  288. package/src/orchestration/__tests__/worker-returnmeta-passthrough.test.ts +0 -164
  289. package/src/orchestration/__tests__/worker-script-builder-runtime.test.ts +0 -563
  290. package/src/orchestration/__tests__/worker-script-builder.test.ts +0 -309
  291. package/src/orchestration/__tests__/worker-script-template-snapshot.test.ts +0 -129
  292. package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +0 -317
  293. package/src/orchestration/__tests__/workflow-script-lint-memo.test.ts +0 -110
  294. package/src/orchestration/__tests__/workflows-e2e.test.ts +0 -537
  295. package/src/orchestration/agent-opts-resolver.ts +0 -174
  296. package/src/orchestration/args-validator.ts +0 -127
  297. package/src/orchestration/config-loader.ts +0 -315
  298. package/src/orchestration/error-recovery.ts +0 -1018
  299. package/src/orchestration/execute-agent-call.ts +0 -256
  300. package/src/orchestration/launcher.ts +0 -455
  301. package/src/orchestration/lifecycle.ts +0 -399
  302. package/src/orchestration/models/__tests__/budget.test.ts +0 -307
  303. package/src/orchestration/models/__tests__/trace.test.ts +0 -408
  304. package/src/orchestration/models/agent-call.ts +0 -83
  305. package/src/orchestration/models/budget.ts +0 -118
  306. package/src/orchestration/models/ports.ts +0 -164
  307. package/src/orchestration/models/run-runtime.ts +0 -104
  308. package/src/orchestration/models/run-spec.ts +0 -83
  309. package/src/orchestration/models/run-state.ts +0 -44
  310. package/src/orchestration/models/trace.ts +0 -183
  311. package/src/orchestration/models/types.ts +0 -301
  312. package/src/orchestration/models/workflow-run.ts +0 -254
  313. package/src/orchestration/models/workflow-script-registry.ts +0 -35
  314. package/src/orchestration/models/workflow-script.ts +0 -117
  315. package/src/orchestration/script-lint.ts +0 -766
  316. package/src/orchestration/skill-discovery.ts +0 -115
  317. package/src/orchestration/worker-handle.ts +0 -115
  318. package/src/orchestration/worker-host.ts +0 -98
  319. package/src/orchestration/worker-script-builder.ts +0 -421
  320. package/src/orchestration/workflow-files.ts +0 -85
  321. package/src/orchestration/workflow-script-registry-impl.ts +0 -133
  322. package/src/shared/__tests__/agent-ref.test.ts +0 -34
  323. package/src/shared/__tests__/meta-parser.test.ts +0 -304
  324. package/src/shared/__tests__/model-ref.test.ts +0 -306
  325. package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -280
  326. package/src/shared/__tests__/resource-discovery.test.ts +0 -736
  327. package/src/shared/__tests__/resource-meta.test.ts +0 -51
  328. package/src/shared/__tests__/schema-jsonify.test.ts +0 -81
  329. package/src/shared/__tests__/timer-delay.test.ts +0 -61
  330. package/src/shared/agent-event.ts +0 -13
  331. package/src/shared/agent-ref.ts +0 -57
  332. package/src/shared/meta-parser.ts +0 -261
  333. package/src/shared/model-ref.ts +0 -286
  334. package/src/shared/resource-discovery.ts +0 -811
  335. package/src/shared/resource-meta.ts +0 -65
  336. package/src/shared/schema-env.ts +0 -44
  337. package/src/shared/schema-jsonify.ts +0 -58
  338. package/src/shared/timer-delay.ts +0 -54
  339. package/src/shared/xml-injection.ts +0 -35
  340. package/workflows/README.md +0 -81
  341. package/workflows/_shared/agent-refs.cjs +0 -40
  342. package/workflows/chain.js +0 -131
  343. package/workflows/map-reduce.js +0 -174
  344. package/workflows/parallel.js +0 -148
  345. package/workflows/review-fix-loop-utils.cjs +0 -1309
  346. package/workflows/review-fix-loop.js +0 -1404
  347. package/workflows/scatter-gather.js +0 -178
@@ -1,299 +0,0 @@
1
- // src/__tests__/dialog-queue.test.ts
2
- //
3
- // W2 红灯测试:dialog-queue.ts — L2 跨子进程全局 dialog 串行队列。
4
- //
5
- // 测试对象:extensions/universal/subagent-workflow/src/execution/dialog-queue.ts(新建)
6
- // 契约来源:.fix-plans/00-master-summary.md §一 冲突 3(L2 DialogGlobalQueue 设计)
7
- //
8
- // DialogGlobalQueue 设计要点:
9
- // - 进程单例,跨所有子进程共享,串行所有 dialog 类请求(isDialogMethod===true)
10
- // - enqueue(req, handler): Promise<UiResponse> — 入队,返回 Promise
11
- // - FIFO 串行:前一个 handler resolve 后才处理下一个
12
- // - SR-4:入队项带 child 引用,child close 时把该 child 的 pending dialog 全部
13
- // reject 为 cancelled(防 Promise 永挂 + 内存泄漏)
14
- // - handler 抛错兜底:catch → appendEntry "subagent:dialog-handler-failed"
15
- // → 回 {cancelled:true} → 继续处理下一个(不能让一个失败卡死队列)
16
- // - 调用方约定只对 dialog 类调 enqueue;fire-and-forget 由调用方(factory 层)
17
- // 直接调 handler 不入队。enqueue 内仍防御性兼容 fire-and-forget(直接调 handler)
18
- //
19
- // 4 个 TC-E4 测试 case:
20
- // 1. 3 个并发 dialog 请求按 FIFO 顺序串行处理
21
- // 2. SR-4: child close 时 pending dialog reject 为 cancelled
22
- // 3. handler 抛错后队列继续处理下一个
23
- // 4. fire-and-forget method 不入队(直接调 handler)
24
- //
25
- // 红灯原因:dialog-queue.ts 尚未创建,import 失败。
26
-
27
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
28
-
29
- import { DialogGlobalQueue, type UiRequest, type UiResponse } from "../dialog-queue.ts";
30
-
31
- // ── 类型助手 ────────────────────────────────────────────────
32
- // UiRequest 最小形状(method + id)。dialog 类:select/confirm/input/editor。
33
- // fire-and-forget 类:notify/setStatus/...。
34
-
35
- function dialogReq(id: string, method: "select" | "confirm" | "input" | "editor" = "select"): UiRequest {
36
- return { method, id, title: `q-${id}` };
37
- }
38
-
39
- function fireAndForgetReq(id: string): UiRequest {
40
- return { method: "notify", id, message: `n-${id}` };
41
- }
42
-
43
- // ── 测试 fixture ────────────────────────────────────────────
44
-
45
- beforeEach(() => {
46
- vi.useFakeTimers();
47
- });
48
-
49
- afterEach(() => {
50
- vi.useRealTimers();
51
- });
52
-
53
- describe("DialogGlobalQueue — FIFO 串行(TC-E4 case 1)", () => {
54
- it("3 个并发 dialog 请求按 FIFO 顺序串行处理(前一个 resolve 后才处理下一个)", async () => {
55
- const queue = new DialogGlobalQueue();
56
- const callOrder: string[] = [];
57
- // 每个请求返回独立的可控 Promise,模拟 handler 延迟
58
- const resolvers: Array<(v: UiResponse) => void> = [];
59
-
60
- const handler = vi.fn((req: UiRequest): Promise<UiResponse> => {
61
- callOrder.push(req.id);
62
- return new Promise<UiResponse>((resolve) => {
63
- resolvers.push(resolve);
64
- });
65
- });
66
-
67
- // 并发入队 3 个 dialog 请求
68
- const p1 = queue.enqueue(dialogReq("r1"), handler);
69
- const p2 = queue.enqueue(dialogReq("r2"), handler);
70
- const p3 = queue.enqueue(dialogReq("r3"), handler);
71
-
72
- // 只有第一个立即被处理
73
- expect(handler).toHaveBeenCalledTimes(1);
74
- expect(callOrder).toEqual(["r1"]);
75
-
76
- // resolve 第一个 → 第二个开始
77
- resolvers[0]({ value: "a1" });
78
- await vi.advanceTimersByTimeAsync(0);
79
- expect(handler).toHaveBeenCalledTimes(2);
80
- expect(callOrder).toEqual(["r1", "r2"]);
81
-
82
- // resolve 第二个 → 第三个开始
83
- resolvers[1]({ value: "a2" });
84
- await vi.advanceTimersByTimeAsync(0);
85
- expect(handler).toHaveBeenCalledTimes(3);
86
- expect(callOrder).toEqual(["r1", "r2", "r3"]);
87
-
88
- // resolve 第三个 → 全部 settle
89
- resolvers[2]({ value: "a3" });
90
- await vi.advanceTimersByTimeAsync(0);
91
-
92
- const [r1, r2, r3] = await Promise.all([p1, p2, p3]);
93
- expect(r1).toEqual({ value: "a1" });
94
- expect(r2).toEqual({ value: "a2" });
95
- expect(r3).toEqual({ value: "a3" });
96
- });
97
- });
98
-
99
- describe("DialogGlobalQueue — SR-4 child close reject(TC-E4 case 2)", () => {
100
- it("child close 时该 child 的 pending dialog reject 为 cancelled(防 Promise 永挂)", async () => {
101
- const queue = new DialogGlobalQueue();
102
- const child = { pid: 20001 };
103
-
104
- const handler = vi.fn(
105
- (): Promise<UiResponse> => new Promise<UiResponse>(() => {}),
106
- );
107
-
108
- // 入队一个永远不 resolve 的 dialog,绑定 child
109
- const pending = queue.enqueue(dialogReq("r1"), handler, { child });
110
-
111
- // 模拟 child close —— pending 必须被 reject 为 cancelled
112
- queue.rejectChildDialogs(child);
113
-
114
- await expect(pending).resolves.toEqual({ cancelled: true });
115
- });
116
-
117
- it("child close 不影响其他 child 的 pending dialog", async () => {
118
- const queue = new DialogGlobalQueue();
119
- const childA = { pid: 30001 };
120
- const childB = { pid: 30002 };
121
-
122
- const handler = vi.fn(
123
- (): Promise<UiResponse> => new Promise<UiResponse>(() => {}),
124
- );
125
-
126
- const pendingA = queue.enqueue(dialogReq("a1"), handler, { child: childA });
127
- const pendingB = queue.enqueue(dialogReq("b1"), handler, { child: childB });
128
-
129
- // close childA —— 只有 pendingA 被 reject,pendingB 仍 pending
130
- queue.rejectChildDialogs(childA);
131
-
132
- await expect(pendingA).resolves.toEqual({ cancelled: true });
133
- // pendingB 不被 reject(仍 pending)—— 用 race + real timer 验证它没 settle。
134
- // fake timer 下 setTimeout 不自动跑,临时切 real timer 做 10ms 超时探测。
135
- vi.useRealTimers();
136
- const settled = await Promise.race([
137
- pendingB.then(() => true),
138
- new Promise<boolean>((resolve) => setTimeout(() => resolve(false), 10)),
139
- ]);
140
- expect(settled).toBe(false);
141
- vi.useFakeTimers();
142
- });
143
- });
144
-
145
- describe("DialogGlobalQueue — handler 抛错兜底(TC-E4 case 3)", () => {
146
- it("handler 第一次抛错 → 回 cancelled → 队列继续处理下一个(不卡死)", async () => {
147
- const queue = new DialogGlobalQueue();
148
- const callOrder: string[] = [];
149
-
150
- const handler = vi.fn((req: UiRequest): Promise<UiResponse> => {
151
- callOrder.push(req.id);
152
- if (req.id === "r1") {
153
- return Promise.reject(new Error("handler boom"));
154
- }
155
- return Promise.resolve<UiResponse>({ value: "ok-" + req.id });
156
- });
157
-
158
- const p1 = queue.enqueue(dialogReq("r1"), handler);
159
- const p2 = queue.enqueue(dialogReq("r2"), handler);
160
-
161
- await vi.advanceTimersByTimeAsync(0);
162
-
163
- // r1 抛错兜底回 cancelled(不向上抛)
164
- await expect(p1).resolves.toEqual({ cancelled: true });
165
- // r2 正常处理
166
- await expect(p2).resolves.toEqual({ value: "ok-r2" });
167
-
168
- expect(callOrder).toEqual(["r1", "r2"]);
169
- });
170
- });
171
-
172
- describe("DialogGlobalQueue — fire-and-forget 防御性兼容(TC-E4 case 4)", () => {
173
- it("fire-and-forget method(notify)防御性直接调 handler,不串行等待(调用方约定不传此类)", async () => {
174
- const queue = new DialogGlobalQueue();
175
- const callOrder: string[] = [];
176
-
177
- // 第一个 dialog 请求永不 resolve(占住队列)
178
- const blockingHandler = vi.fn(
179
- (): Promise<UiResponse> => new Promise<UiResponse>(() => {}),
180
- );
181
- const ffHandler = vi.fn((req: UiRequest): Promise<UiResponse> => {
182
- callOrder.push(req.id);
183
- return Promise.resolve<UiResponse>({ ack: true });
184
- });
185
-
186
- // 入队一个 blocking dialog(占住队列)
187
- queue.enqueue(dialogReq("d1"), blockingHandler);
188
- // fire-and-forget 必须立即被调用,不等 d1 resolve
189
- const ffResult = await queue.enqueue(fireAndForgetReq("f1"), ffHandler);
190
-
191
- expect(ffHandler).toHaveBeenCalledTimes(1);
192
- expect(callOrder).toEqual(["f1"]);
193
- expect(ffResult).toEqual({ ack: true });
194
- // blocking dialog 的 handler 仍只调用一次,ff 没有插入队列等待
195
- expect(blockingHandler).toHaveBeenCalledTimes(1);
196
- });
197
- });
198
-
199
- // ── A4+C12:rejectAll + #19 单一推进点 + child close 集成语义 ──
200
-
201
- describe("DialogGlobalQueue — rejectAll settle 全部 pending + 清状态(#10/session_shutdown)", () => {
202
- it("rejectAll 把 current + 队列所有 pending settle 为 cancelled,并清空 queue/current/processing", async () => {
203
- const queue = new DialogGlobalQueue();
204
- const child = { pid: 50001 };
205
- const blocking = vi.fn((): Promise<UiResponse> => new Promise<UiResponse>(() => {}));
206
-
207
- // r1 占 current(永不 settle);r2/r3 在队列等(含跨 child 的 r3)
208
- const p1 = queue.enqueue(dialogReq("r1"), blocking, { child });
209
- const p2 = queue.enqueue(dialogReq("r2"), blocking, { child });
210
- const p3 = queue.enqueue(dialogReq("r3"), blocking);
211
- expect(queue.size).toBe(2);
212
-
213
- queue.rejectAll();
214
-
215
- // 全部 settle 为 cancelled(Promise 不永挂)
216
- await expect(p1).resolves.toEqual({ cancelled: true });
217
- await expect(p2).resolves.toEqual({ cancelled: true });
218
- await expect(p3).resolves.toEqual({ cancelled: true });
219
- // 状态清空
220
- expect(queue.size).toBe(0);
221
- });
222
-
223
- it("rejectAll 幂等:重复调用不抛错,状态保持清空,已 settle 的 Promise 不重复 resolve", async () => {
224
- const queue = new DialogGlobalQueue();
225
- const blocking = vi.fn((): Promise<UiResponse> => new Promise<UiResponse>(() => {}));
226
- const p1 = queue.enqueue(dialogReq("r1"), blocking);
227
-
228
- queue.rejectAll();
229
- await expect(p1).resolves.toEqual({ cancelled: true });
230
-
231
- // 再次调用——幂等(settled 标志保证只 settle 一次),不抛错
232
- expect(() => queue.rejectAll()).not.toThrow();
233
- expect(queue.size).toBe(0);
234
- // p1 仍是 cancelled(防重复 resolve)
235
- await expect(p1).resolves.toEqual({ cancelled: true });
236
- });
237
-
238
- it("rejectAll 后队列仍可正常 enqueue 新请求(状态完全重置,processing 不残留)", async () => {
239
- const queue = new DialogGlobalQueue();
240
- const blocking = vi.fn((): Promise<UiResponse> => new Promise<UiResponse>(() => {}));
241
- queue.enqueue(dialogReq("r1"), blocking);
242
- queue.rejectAll();
243
-
244
- // rejectAll 后 enqueue 新 dialog,能正常处理(processing 已重置为 false)
245
- const okHandler = vi.fn(async (): Promise<UiResponse> => ({ value: "new" }));
246
- const p = queue.enqueue(dialogReq("after"), okHandler);
247
- await vi.advanceTimersByTimeAsync(0);
248
- await expect(p).resolves.toEqual({ value: "new" });
249
- expect(okHandler).toHaveBeenCalledTimes(1);
250
- });
251
- });
252
-
253
- describe("DialogGlobalQueue — #19 单一推进点 + child close 集成语义", () => {
254
- it("#19 单一推进点:rejectChildDialogs 取消占住 current 的永不 settle dialog 后,队列下一个 item 被推进处理(不卡死)", async () => {
255
- const queue = new DialogGlobalQueue();
256
- const childA = { pid: 60001 };
257
- const blockingHandler = vi.fn((): Promise<UiResponse> => new Promise<UiResponse>(() => {}));
258
- const r2Handler = vi.fn(async (): Promise<UiResponse> => ({ value: "r2-ok" }));
259
-
260
- // r1 占 current(永不 settle,模拟等用户输入卡死);r2(另一 child)排队等待
261
- const p1 = queue.enqueue(dialogReq("r1"), blockingHandler, { child: childA });
262
- const p2 = queue.enqueue(dialogReq("r2"), r2Handler);
263
- expect(blockingHandler).toHaveBeenCalledTimes(1);
264
- expect(r2Handler).toHaveBeenCalledTimes(0); // r2 还在等 r1 settle
265
-
266
- // childA close → rejectChildDialogs settle r1;#19:settleItem 内唯一 processNext 推进 r2
267
- queue.rejectChildDialogs(childA);
268
- await vi.advanceTimersByTimeAsync(0);
269
-
270
- await expect(p1).resolves.toEqual({ cancelled: true });
271
- // 关键:r2 被推进(队列没卡死在永不 settle 的 r1)
272
- expect(r2Handler).toHaveBeenCalledTimes(1);
273
- await expect(p2).resolves.toEqual({ value: "r2-ok" });
274
- });
275
-
276
- it("child close 集成语义:queue 中同一 child 的多个 pending 被 rejectChildDialogs 一次全部 settle cancelled", async () => {
277
- // 模拟 session-runner child 'close' 事件 → dialogQueue.rejectChildDialogs(child) 清理路径。
278
- // 绑定点在 session-runner(非 dialog-queue 内部),本测试验证 rejectChildDialogs 公共方法语义。
279
- // 用 blocker 占 current(另一 child)使被测 child 的项全排队,聚焦验证 queue 批量 cancel。
280
- const queue = new DialogGlobalQueue();
281
- const blocker = { pid: 70000 };
282
- const child = { pid: 70001 };
283
- const blocking = vi.fn((): Promise<UiResponse> => new Promise<UiResponse>(() => {}));
284
-
285
- // blocker 占 current(永不 settle),让 child 的项都进队列
286
- queue.enqueue(dialogReq("blk"), blocking, { child: blocker });
287
- const p1 = queue.enqueue(dialogReq("c1"), blocking, { child });
288
- const p2 = queue.enqueue(dialogReq("c2"), blocking, { child });
289
- const p3 = queue.enqueue(dialogReq("c3"), blocking, { child });
290
- expect(queue.size).toBe(3);
291
-
292
- queue.rejectChildDialogs(child);
293
-
294
- await expect(p1).resolves.toEqual({ cancelled: true });
295
- await expect(p2).resolves.toEqual({ cancelled: true });
296
- await expect(p3).resolves.toEqual({ cancelled: true });
297
- expect(queue.size).toBe(0);
298
- });
299
- });
@@ -1,241 +0,0 @@
1
- // src/execution/__tests__/epipe-fallback.test.ts
2
- //
3
- // deliverMessage EPIPE 兜底集成测试——热路径 stdin 写入 EPIPE 时自动转冷路径 resume + 消息重放。
4
- //
5
- // 场景覆盖:
6
- // 1. 首次 EPIPE → 自动转冷路径 resumeRound(runSpawn 收到 resume 参数 + 原消息)
7
- // 2. 连续 2 次 EPIPE → throw 含恢复指引(防无限循环)
8
- // 3. 热路径成功写入后清零 EPIPE 计数(正常路径不受影响)
9
-
10
- import * as fs from "node:fs";
11
- import * as os from "node:os";
12
- import * as path from "node:path";
13
- import type { ChildProcess } from "node:child_process";
14
- import { PassThrough } from "node:stream";
15
-
16
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
17
-
18
- const { loggerMock } = vi.hoisted(() => ({
19
- loggerMock: { debug: vi.fn(), warn: vi.fn(), error: vi.fn(), info: vi.fn() },
20
- }));
21
- vi.mock("@zhushanwen/pi-extension-logger", () => ({ getLogger: () => loggerMock }));
22
-
23
- // mock session-runner:runSpawn 受控 + killAllSpawnedChildren 空实现;
24
- // getChildByRecord/spawnedChildren 提供真实 Map 语义。
25
- vi.mock("../session-runner.ts", () => {
26
- const spawnedChildren = new Map<string, unknown>();
27
- return {
28
- runSpawn: vi.fn(),
29
- killAllSpawnedChildren: vi.fn(),
30
- spawnedChildren,
31
- getChildByRecord: (id: string): unknown => spawnedChildren.get(id),
32
- };
33
- });
34
-
35
- import { runSpawn, spawnedChildren } from "../session-runner.ts";
36
- import * as lifecycle from "../lifecycle-manager.ts";
37
- import { createRecord } from "../execution-record.ts";
38
- import { ModelConfigService } from "../model-config-service.ts";
39
- import type { ModelInfo } from "../model-resolver.ts";
40
- import { SubagentService } from "../subagent-service.ts";
41
- import type { PiLike } from "../subagent-service.ts";
42
- import type { AgentResult, ExecutionRecord } from "../types.ts";
43
-
44
- const mockRunSpawn = vi.mocked(runSpawn);
45
-
46
- function makeTmpAgentDir(): string {
47
- return fs.mkdtempSync(path.join(os.tmpdir(), "epipe-test-"));
48
- }
49
-
50
- function makePi(): PiLike & {
51
- appendEntry: ReturnType<typeof vi.fn>;
52
- events: { emit: ReturnType<typeof vi.fn> };
53
- sendMessage: ReturnType<typeof vi.fn>;
54
- } {
55
- return { appendEntry: vi.fn(), events: { emit: vi.fn() }, sendMessage: vi.fn() };
56
- }
57
-
58
- function makeResult(success: boolean): AgentResult {
59
- return {
60
- text: success ? "done" : "err",
61
- turns: 1,
62
- durationMs: 100,
63
- success,
64
- error: success ? undefined : "boom",
65
- sessionId: "sess-1",
66
- toolCalls: [],
67
- };
68
- }
69
-
70
- /** chatMode running-resumable record(第一轮已完成,等待续聊;v4 B-1 旧 idle 折入 running)。 */
71
- function makeIdleRecord(id = "sa-epipe"): ExecutionRecord {
72
- const record = createRecord(id, {
73
- agent: "general-purpose",
74
- model: "test/test-model",
75
- thinkingLevel: "low",
76
- mode: "background",
77
- task: "initial task",
78
- slug: "epipe-chat",
79
- startedAt: 1000,
80
- rootSessionId: "root-session",
81
- chatMode: true,
82
- });
83
- record.status = "running";
84
- record.round = 1;
85
- record.controller = new AbortController();
86
- return record;
87
- }
88
-
89
- /**
90
- * 构造 EPIPE child:stdin.write 抛 {code:'EPIPE'},模拟子进程已退出但 close 事件尚未到达的窗口。
91
- */
92
- function makeEpipeChild(): ChildProcess {
93
- const fakeStdin = {
94
- write: vi.fn(() => {
95
- const err = Object.assign(new Error("write after end"), { code: "EPIPE" });
96
- throw err;
97
- }),
98
- destroyed: false,
99
- } as unknown as PassThrough;
100
- return { stdin: fakeStdin, pid: 99999 } as unknown as ChildProcess;
101
- }
102
-
103
- /**
104
- * 构造正常 child:PassThrough stdin(可正常写入)。
105
- */
106
- function makeNormalChild(): ChildProcess {
107
- return { stdin: new PassThrough(), pid: 88888 } as unknown as ChildProcess;
108
- }
109
-
110
- // ============================================================
111
- // deliverMessage EPIPE 兜底
112
- // ============================================================
113
-
114
- describe("deliverMessage EPIPE 兜底(热路径 stdin EPIPE → 冷路径 resume)", () => {
115
- let agentDir: string;
116
- let service: SubagentService;
117
- let record: ExecutionRecord;
118
-
119
- beforeEach(() => {
120
- agentDir = makeTmpAgentDir();
121
- const modelService = new ModelConfigService({ agentDir });
122
- service = new SubagentService({ cwd: agentDir, modelService });
123
- service.initSession({ pi: makePi(), sessionId: "root-session" });
124
- record = makeIdleRecord();
125
- record.sessionFile = path.join(agentDir, "fake-session.jsonl");
126
- spawnedChildren.clear();
127
- mockRunSpawn.mockReset();
128
- lifecycle._resetLifecycleState();
129
- loggerMock.warn.mockClear();
130
- });
131
-
132
- afterEach(() => {
133
- service.dispose();
134
- spawnedChildren.clear();
135
- lifecycle._resetLifecycleState();
136
- fs.rmSync(agentDir, { recursive: true, force: true });
137
- });
138
-
139
- it("首次 EPIPE → 自动转冷路径 resumeRound + 原消息重放", async () => {
140
- mockRunSpawn.mockResolvedValueOnce(makeResult(true));
141
- // 注册 EPIPE child(热路径会命中但 stdin.write 抛 EPIPE)
142
- spawnedChildren.set(record.id, makeEpipeChild());
143
-
144
- // deliverMessage 不 throw(首次 EPIPE 走 resume 兜底)
145
- await expect(service.deliverMessage(record, "msg after epipe", false)).resolves.toBeUndefined();
146
-
147
- // spawnedChildren 中的死进程条目已清理(EPIPE catch 块 delete)
148
- expect(spawnedChildren.has(record.id)).toBe(false);
149
-
150
- // resumeRound 被触发(冷路径),runSpawn 收到 resume 参数 + 原消息
151
- await vi.waitFor(() => expect(mockRunSpawn).toHaveBeenCalledTimes(1));
152
- const call = mockRunSpawn.mock.calls[0]!;
153
- expect(call[1]).toBe("msg after epipe");
154
- expect(call[4]).toEqual({
155
- sessionFile: record.sessionFile,
156
- model: record.model,
157
- thinkingLevel: record.thinkingLevel,
158
- });
159
-
160
- // warn 日志包含 EPIPE 关键词
161
- expect(loggerMock.warn).toHaveBeenCalled();
162
- const warnCalls = loggerMock.warn.mock.calls;
163
- const epipeWarn = warnCalls.find((c: unknown[]) =>
164
- typeof c[0] === "string" && c[0].includes("EPIPE"),
165
- );
166
- expect(epipeWarn).toBeDefined();
167
- });
168
-
169
- it("连续 2 次 EPIPE → throw 含恢复指引(防无限循环)", async () => {
170
- mockRunSpawn.mockResolvedValue(makeResult(true));
171
- // 注册 EPIPE child
172
- spawnedChildren.set(record.id, makeEpipeChild());
173
-
174
- // 第 1 次:EPIPE → resume(不 throw)
175
- await service.deliverMessage(record, "first epipe", false);
176
- await vi.waitFor(() => expect(mockRunSpawn).toHaveBeenCalledTimes(1));
177
-
178
- // resume 完成后 record 回 running(v4 B-1:finalizeRoundToIdle 设 running,旧 idle 折入)
179
- await vi.waitFor(() => expect(record.status).toBe("running"));
180
-
181
- // 第 2 次:再次注入 EPIPE child + EPIPE
182
- spawnedChildren.set(record.id, makeEpipeChild());
183
-
184
- // 第 2 次 EPIPE → throw 含恢复指引(连续 2 次触发 exhaustion)
185
- // 注意:第二 EPIPE 时 count 已为 2,catch 块立即 throw(不经过 resumeRound)。
186
- let thrown: unknown;
187
- try {
188
- await service.deliverMessage(record, "second epipe", false);
189
- } catch (err) {
190
- thrown = err;
191
- }
192
- expect(thrown).toBeInstanceOf(Error);
193
- expect((thrown as Error).message).toContain("EPIPE fallback exhausted");
194
- expect((thrown as Error).message).toContain("2 consecutive EPIPE");
195
- expect((thrown as Error).message).toContain("action:'close'");
196
- expect((thrown as Error).message).toContain("action:'start'");
197
- });
198
-
199
- it("热路径成功写入后清零 EPIPE 计数(正常路径不受 EPIPE 计数影响)", async () => {
200
- mockRunSpawn.mockResolvedValue(makeResult(true));
201
-
202
- // 第 1 轮:EPIPE → resume
203
- spawnedChildren.set(record.id, makeEpipeChild());
204
- await service.deliverMessage(record, "epipe msg", false);
205
- await vi.waitFor(() => expect(mockRunSpawn).toHaveBeenCalledTimes(1));
206
- await vi.waitFor(() => expect(record.status).toBe("running"));
207
-
208
- // 第 2 轮:正常 child,成功写入(清零 EPIPE 计数)
209
- spawnedChildren.set(record.id, makeNormalChild());
210
- await service.deliverMessage(record, "normal msg", true);
211
- // 不 throw,status=running(热路径成功)
212
- expect(record.status).toBe("running");
213
-
214
- // 第 3 轮:再次 EPIPE → 但因为第 2 轮清零了计数,这次是首次 EPIPE(不 throw)
215
- // 需要先让 record 回 running(等待续聊态)
216
- record.status = "running";
217
- spawnedChildren.set(record.id, makeEpipeChild());
218
- await expect(service.deliverMessage(record, "after reset", false)).resolves.toBeUndefined();
219
- });
220
-
221
- it("EPIPE 兜底与冷路径共用 in-flight 守卫:resume 在途时 EPIPE 兜底不再二次 spawn(review round2 MF1)", async () => {
222
- // 冷路径发起 resume,runSpawn 挂起(spawn 异步窗口内)
223
- let releaseFirst!: (r: AgentResult) => void;
224
- mockRunSpawn.mockImplementationOnce(
225
- () => new Promise<AgentResult>((res) => { releaseFirst = res; }),
226
- );
227
- await service.deliverMessage(record, "cold path first", false);
228
- await vi.waitFor(() => expect(mockRunSpawn).toHaveBeenCalledTimes(1));
229
-
230
- // 注册 EPIPE child → deliverMessage 走热路径 → stdin EPIPE → 兜底调 resumeRound
231
- // → in-flight 命中 → throw(不再走第二次 spawn。EPIPE 计数仍 +1 但未达阈值 2,
232
- // exhaustion 分支不触发;throw 由兜底路径的 resumeRound 守卫抛出)
233
- spawnedChildren.set(record.id, makeEpipeChild());
234
- await expect(service.deliverMessage(record, "epipe during resume", false)).rejects.toThrow(
235
- /already starting a new round/,
236
- );
237
- expect(mockRunSpawn).toHaveBeenCalledTimes(1);
238
-
239
- releaseFirst(makeResult(true));
240
- });
241
- });