@zhushanwen/pi-subagent-workflow 8.6.0 → 8.8.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 (364) hide show
  1. package/README.md +5 -11
  2. package/package.json +13 -20
  3. package/relay/relay.mjs +1 -1
  4. package/skills/workflow-script-format/SKILL.md +32 -13
  5. package/src/host/__tests__/pi-host.test.ts +235 -0
  6. package/src/host/pi-host.ts +163 -0
  7. package/src/index.ts +141 -138
  8. package/src/injectors/__tests__/engine-awareness.test.ts +292 -0
  9. package/src/injectors/__tests__/engine-section-stability.test.ts +343 -0
  10. package/src/injectors/__tests__/model-list-injector.test.ts +18 -21
  11. package/src/injectors/__tests__/subagent-list-injector.test.ts +59 -19
  12. package/src/injectors/__tests__/workflow-list-injector.test.ts +31 -17
  13. package/src/injectors/engine-awareness.ts +119 -0
  14. package/src/injectors/model-list-injector.ts +15 -58
  15. package/src/injectors/subagent-list-injector.ts +56 -114
  16. package/src/injectors/workflow-list-injector.ts +37 -70
  17. package/src/interface/__tests__/detectors.test.ts +48 -37
  18. package/src/interface/__tests__/subagent-tool-path-guard.test.ts +2 -2
  19. package/src/interface/__tests__/subagent-tool-prompt.test.ts +6 -3
  20. package/src/interface/__tests__/tool-workflow-run-builtin-name.test.ts +216 -0
  21. package/src/interface/__tests__/tool-workflow-script-generate.test.ts +17 -6
  22. package/src/interface/__tests__/tool-workflow-throw-paths.test.ts +38 -2
  23. package/src/interface/bg-notify-render.ts +7 -17
  24. package/src/interface/command-actions.ts +5 -15
  25. package/src/interface/commands.ts +4 -4
  26. package/src/interface/format.ts +17 -6
  27. package/src/interface/gui-mappers.ts +18 -22
  28. package/src/interface/helpers.ts +9 -130
  29. package/src/interface/list-component.ts +5 -5
  30. package/src/interface/list-shared.ts +3 -3
  31. package/src/interface/list-view.ts +3 -3
  32. package/src/interface/subagent-actions.ts +66 -439
  33. package/src/interface/subagent-tool-schema.ts +21 -17
  34. package/src/interface/subagent-tool.ts +12 -7
  35. package/src/interface/subagents.ts +4 -4
  36. package/src/interface/tool-render.ts +37 -15
  37. package/src/interface/tool-workflow-script.ts +34 -76
  38. package/src/interface/tool-workflow.ts +57 -94
  39. package/src/interface/views/WorkflowsView.ts +8 -16
  40. package/src/interface/views/__tests__/WorkflowsView-signature.test.ts +3 -3
  41. package/src/interface/views/__tests__/detail-content-session-file.test.ts +2 -2
  42. package/src/interface/views/detail-content.ts +4 -4
  43. package/src/interface/views/format.ts +23 -62
  44. package/src/{orchestration/jsonl-run-store.ts → jsonl-run-store.ts} +137 -225
  45. package/agents/analyst.md +0 -61
  46. package/agents/coder.md +0 -70
  47. package/agents/debugger.md +0 -67
  48. package/agents/doc-reviewer.md +0 -50
  49. package/agents/explorer.md +0 -64
  50. package/agents/general-purpose.md +0 -32
  51. package/agents/orchestrator.md +0 -63
  52. package/agents/planner.md +0 -54
  53. package/agents/researcher.md +0 -65
  54. package/agents/reviewer.md +0 -74
  55. package/src/execution/__tests__/__fixtures__/notifier-golden-snapshots.json +0 -53
  56. package/src/execution/__tests__/__fixtures__/truncline.snapshot.json +0 -1
  57. package/src/execution/__tests__/agent-registry.test.ts +0 -363
  58. package/src/execution/__tests__/agent-result-mapper.test.ts +0 -150
  59. package/src/execution/__tests__/alive-store.test.ts +0 -147
  60. package/src/execution/__tests__/ask-user-transit-e2e.test.ts +0 -490
  61. package/src/execution/__tests__/before-agent-start-injection.test.ts +0 -132
  62. package/src/execution/__tests__/bg-notify-render.test.ts +0 -329
  63. package/src/execution/__tests__/channel-registry-handshake.test.ts +0 -243
  64. package/src/execution/__tests__/chat-engine-routing.test.ts +0 -601
  65. package/src/execution/__tests__/chatmode-first-round-closure-service.test.ts +0 -365
  66. package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +0 -190
  67. package/src/execution/__tests__/chatmode-round-notify-real-chain.test.ts +0 -215
  68. package/src/execution/__tests__/concurrency-pool.test.ts +0 -250
  69. package/src/execution/__tests__/config.test.ts +0 -110
  70. package/src/execution/__tests__/conversation-wiring.test.ts +0 -198
  71. package/src/execution/__tests__/crash-recovery.test.ts +0 -320
  72. package/src/execution/__tests__/delivery-methods.test.ts +0 -422
  73. package/src/execution/__tests__/dialog-queue.test.ts +0 -299
  74. package/src/execution/__tests__/epipe-fallback.test.ts +0 -241
  75. package/src/execution/__tests__/execute-and-await-worktree.test.ts +0 -243
  76. package/src/execution/__tests__/execute-nesting.test.ts +0 -323
  77. package/src/execution/__tests__/execute-options-mapper.test.ts +0 -200
  78. package/src/execution/__tests__/execution-record.test.ts +0 -1394
  79. package/src/execution/__tests__/explicit-agent-ref-guard.test.ts +0 -171
  80. package/src/execution/__tests__/finalize-record.test.ts +0 -368
  81. package/src/execution/__tests__/finalized-marker.test.ts +0 -82
  82. package/src/execution/__tests__/format-schema-instruction.test.ts +0 -169
  83. package/src/execution/__tests__/format.test.ts +0 -458
  84. package/src/execution/__tests__/gc-timer.test.ts +0 -184
  85. package/src/execution/__tests__/get-record-for-action-restart.test.ts +0 -254
  86. package/src/execution/__tests__/gui-mode-dispatch.test.ts +0 -59
  87. package/src/execution/__tests__/helpers/mock-extension-api.ts +0 -30
  88. package/src/execution/__tests__/helpers/spawn-mock.ts +0 -242
  89. package/src/execution/__tests__/host-mode.test.ts +0 -87
  90. package/src/execution/__tests__/index-session-start-identity.test.ts +0 -371
  91. package/src/execution/__tests__/index-session-start.test.ts +0 -672
  92. package/src/execution/__tests__/lifecycle-manager-lock.test.ts +0 -211
  93. package/src/execution/__tests__/lifecycle-manager.test.ts +0 -383
  94. package/src/execution/__tests__/lifecycle-predicates.test.ts +0 -116
  95. package/src/execution/__tests__/list-component.test.ts +0 -401
  96. package/src/execution/__tests__/list-fields.test.ts +0 -140
  97. package/src/execution/__tests__/manifest-parentid.test.ts +0 -117
  98. package/src/execution/__tests__/model-resolver.test.ts +0 -465
  99. package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +0 -287
  100. package/src/execution/__tests__/nested-visibility.test.ts +0 -325
  101. package/src/execution/__tests__/notifier-flush.test.ts +0 -612
  102. package/src/execution/__tests__/notifier-golden-snapshot.test.ts +0 -261
  103. package/src/execution/__tests__/notify-ledger.test.ts +0 -826
  104. package/src/execution/__tests__/one-shot-upgrade.test.ts +0 -205
  105. package/src/execution/__tests__/output-collector.test.ts +0 -358
  106. package/src/execution/__tests__/parent-child-matrix.test.ts +0 -336
  107. package/src/execution/__tests__/path-encoding.test.ts +0 -104
  108. package/src/execution/__tests__/pi-invocation.test.ts +0 -134
  109. package/src/execution/__tests__/record-store.test.ts +0 -1057
  110. package/src/execution/__tests__/records-cwd-isolation.test.ts +0 -91
  111. package/src/execution/__tests__/recursive-visibility-baseline.test.ts +0 -339
  112. package/src/execution/__tests__/recursive-visibility-env.test.ts +0 -273
  113. package/src/execution/__tests__/relay-agent.test.ts +0 -448
  114. package/src/execution/__tests__/relay-env.test.ts +0 -42
  115. package/src/execution/__tests__/resource-policy.test.ts +0 -109
  116. package/src/execution/__tests__/rpc-mode.test.ts +0 -89
  117. package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +0 -267
  118. package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +0 -253
  119. package/src/execution/__tests__/run-spawn-edges.test.ts +0 -687
  120. package/src/execution/__tests__/run-spawn-integration.test.ts +0 -933
  121. package/src/execution/__tests__/run-spawn-resume.test.ts +0 -322
  122. package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +0 -196
  123. package/src/execution/__tests__/run-spawn-stdout-callback-throw.test.ts +0 -199
  124. package/src/execution/__tests__/sdk-contract.test.ts +0 -273
  125. package/src/execution/__tests__/session-context-resolver.test.ts +0 -167
  126. package/src/execution/__tests__/session-file-gc.test.ts +0 -293
  127. package/src/execution/__tests__/session-pending.test.ts +0 -197
  128. package/src/execution/__tests__/session-reconstructor.test.ts +0 -379
  129. package/src/execution/__tests__/session-runner-epipe.test.ts +0 -178
  130. package/src/execution/__tests__/session-runner-schema-env.test.ts +0 -350
  131. package/src/execution/__tests__/session-start-reaper.test.ts +0 -233
  132. package/src/execution/__tests__/spawn-args.test.ts +0 -445
  133. package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +0 -189
  134. package/src/execution/__tests__/spawn-event-adapter.test.ts +0 -167
  135. package/src/execution/__tests__/spawn-worktree-guidance.test.ts +0 -207
  136. package/src/execution/__tests__/spawned-children.test.ts +0 -92
  137. package/src/execution/__tests__/start-sync-model-guard.test.ts +0 -150
  138. package/src/execution/__tests__/startup-config-declaration.test.ts +0 -35
  139. package/src/execution/__tests__/status-refactor.test.ts +0 -345
  140. package/src/execution/__tests__/stdin-writer.test.ts +0 -463
  141. package/src/execution/__tests__/stream-sink-retirement.test.ts +0 -261
  142. package/src/execution/__tests__/subagent-service-abort.test.ts +0 -60
  143. package/src/execution/__tests__/subagent-service-message-close.test.ts +0 -629
  144. package/src/execution/__tests__/subagent-service-parent-guard.test.ts +0 -180
  145. package/src/execution/__tests__/subagent-service.test.ts +0 -788
  146. package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +0 -310
  147. package/src/execution/__tests__/subprocess-agent-runner.test.ts +0 -599
  148. package/src/execution/__tests__/temp-prompt.test.ts +0 -53
  149. package/src/execution/__tests__/timeout-integration.test.ts +0 -615
  150. package/src/execution/__tests__/tombstone-store.test.ts +0 -73
  151. package/src/execution/__tests__/tool-action.test.ts +0 -476
  152. package/src/execution/__tests__/truncline-snapshot.test.ts +0 -81
  153. package/src/execution/__tests__/turn-limiter-semantics.test.ts +0 -194
  154. package/src/execution/__tests__/turn-limiter.test.ts +0 -65
  155. package/src/execution/__tests__/ui-channels.test.ts +0 -187
  156. package/src/execution/__tests__/ui-interaction-model.test.ts +0 -67
  157. package/src/execution/__tests__/ui-request-handler-factory.test.ts +0 -370
  158. package/src/execution/__tests__/ui-request-handler.test.ts +0 -204
  159. package/src/execution/__tests__/ui-request-observability.test.ts +0 -114
  160. package/src/execution/__tests__/ui-request-queue.test.ts +0 -133
  161. package/src/execution/__tests__/worktree-manager.test.ts +0 -633
  162. package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +0 -229
  163. package/src/execution/__tests__/worktree-reconcile.integration.test.ts +0 -181
  164. package/src/execution/__tests__/worktree-registry.test.ts +0 -199
  165. package/src/execution/agent-registry.ts +0 -199
  166. package/src/execution/agent-result-mapper.ts +0 -90
  167. package/src/execution/alive-store.ts +0 -92
  168. package/src/execution/argv-mirror.ts +0 -113
  169. package/src/execution/best-effort.ts +0 -38
  170. package/src/execution/channel-registry-access.ts +0 -144
  171. package/src/execution/concurrency-pool.ts +0 -116
  172. package/src/execution/config.ts +0 -96
  173. package/src/execution/dialog-queue.ts +0 -330
  174. package/src/execution/engine/__tests__/common/data-dir.test.ts +0 -53
  175. package/src/execution/engine/__tests__/common/errors.test.ts +0 -132
  176. package/src/execution/engine/__tests__/common/event-journal.test.ts +0 -177
  177. package/src/execution/engine/__tests__/common/kill-chain.test.ts +0 -192
  178. package/src/execution/engine/__tests__/common/nesting-guard.test.ts +0 -81
  179. package/src/execution/engine/__tests__/common/persona-router.test.ts +0 -123
  180. package/src/execution/engine/__tests__/common/pool-manager.test.ts +0 -154
  181. package/src/execution/engine/__tests__/common/schema-emulation.test.ts +0 -128
  182. package/src/execution/engine/__tests__/conformance/__fixtures__/pi-golden-events.json +0 -28
  183. package/src/execution/engine/__tests__/conformance/agent-event-invariants.ts +0 -141
  184. package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +0 -109
  185. package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +0 -101
  186. package/src/execution/engine/__tests__/conformance/contract.probe.test.ts +0 -77
  187. package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +0 -104
  188. package/src/execution/engine/__tests__/conformance/contract.relay.test.ts +0 -342
  189. package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +0 -201
  190. package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +0 -76
  191. package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +0 -79
  192. package/src/execution/engine/__tests__/engine-discovery.test.ts +0 -87
  193. package/src/execution/engine/__tests__/engines-declaration.test.ts +0 -36
  194. package/src/execution/engine/__tests__/model-prompt.test.ts +0 -85
  195. package/src/execution/engine/__tests__/paths.test.ts +0 -39
  196. package/src/execution/engine/__tests__/registry.test.ts +0 -120
  197. package/src/execution/engine/__tests__/routing.test.ts +0 -231
  198. package/src/execution/engine/common/data-dir.ts +0 -62
  199. package/src/execution/engine/common/errors.ts +0 -183
  200. package/src/execution/engine/common/event-journal.ts +0 -254
  201. package/src/execution/engine/common/journal-replay.ts +0 -62
  202. package/src/execution/engine/common/kill-chain.ts +0 -221
  203. package/src/execution/engine/common/nesting-guard.ts +0 -50
  204. package/src/execution/engine/common/persona-router.ts +0 -108
  205. package/src/execution/engine/common/pool-manager.ts +0 -226
  206. package/src/execution/engine/common/schema-emulation.ts +0 -189
  207. package/src/execution/engine/common/session-view-projection.ts +0 -51
  208. package/src/execution/engine/engine-discovery.ts +0 -65
  209. package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +0 -469
  210. package/src/execution/engine/engines/pi/__tests__/reader.test.ts +0 -155
  211. package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
  212. package/src/execution/engine/engines/pi/pi-engine.ts +0 -415
  213. package/src/execution/engine/engines/pi/reader.ts +0 -48
  214. package/src/execution/engine/engines/pi/registration.ts +0 -35
  215. package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
  216. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
  217. package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
  218. package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +0 -246
  219. package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +0 -228
  220. package/src/execution/engine/engines/zcode/__tests__/reader.test.ts +0 -210
  221. package/src/execution/engine/engines/zcode/__tests__/registration.test.ts +0 -64
  222. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +0 -127
  223. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -580
  224. package/src/execution/engine/engines/zcode/constants.ts +0 -43
  225. package/src/execution/engine/engines/zcode/golden-sample.ts +0 -39
  226. package/src/execution/engine/engines/zcode/launcher.ts +0 -161
  227. package/src/execution/engine/engines/zcode/parser.ts +0 -436
  228. package/src/execution/engine/engines/zcode/preparer.ts +0 -363
  229. package/src/execution/engine/engines/zcode/reader.ts +0 -381
  230. package/src/execution/engine/engines/zcode/registration.ts +0 -37
  231. package/src/execution/engine/engines/zcode/zcode-engine.ts +0 -658
  232. package/src/execution/engine/host-task-spec.ts +0 -47
  233. package/src/execution/engine/model-prompt.ts +0 -59
  234. package/src/execution/engine/paths.ts +0 -42
  235. package/src/execution/engine/port.ts +0 -153
  236. package/src/execution/engine/registry.ts +0 -123
  237. package/src/execution/engine/routing.ts +0 -218
  238. package/src/execution/engine/types.ts +0 -309
  239. package/src/execution/execute-options-mapper.ts +0 -112
  240. package/src/execution/execution-record.ts +0 -965
  241. package/src/execution/finalize-record.ts +0 -251
  242. package/src/execution/finalized-marker.ts +0 -51
  243. package/src/execution/get-state-handshake.ts +0 -104
  244. package/src/execution/host-mode.ts +0 -56
  245. package/src/execution/idle-gc.ts +0 -47
  246. package/src/execution/lifecycle-manager.ts +0 -513
  247. package/src/execution/lifecycle-predicates.ts +0 -65
  248. package/src/execution/manifest-store.ts +0 -256
  249. package/src/execution/model-config-service.ts +0 -219
  250. package/src/execution/model-resolver.ts +0 -248
  251. package/src/execution/notifier.ts +0 -330
  252. package/src/execution/notify-ledger.ts +0 -580
  253. package/src/execution/output-collector.ts +0 -228
  254. package/src/execution/path-encoding.ts +0 -60
  255. package/src/execution/pi-invocation.ts +0 -120
  256. package/src/execution/record-entry.ts +0 -132
  257. package/src/execution/record-store.ts +0 -1234
  258. package/src/execution/relay-env.ts +0 -37
  259. package/src/execution/session-context-resolver.ts +0 -64
  260. package/src/execution/session-file-gc.ts +0 -120
  261. package/src/execution/session-pending.ts +0 -164
  262. package/src/execution/session-reconstructor.ts +0 -678
  263. package/src/execution/session-runner.ts +0 -1781
  264. package/src/execution/sessions-index.ts +0 -304
  265. package/src/execution/spawn-event-adapter.ts +0 -363
  266. package/src/execution/stdin-writer.ts +0 -198
  267. package/src/execution/stream-sink.ts +0 -126
  268. package/src/execution/subagent-service.ts +0 -2141
  269. package/src/execution/subprocess-agent-runner.ts +0 -317
  270. package/src/execution/temp-prompt.ts +0 -62
  271. package/src/execution/tombstone-store.ts +0 -72
  272. package/src/execution/turn-limiter.ts +0 -102
  273. package/src/execution/types.ts +0 -973
  274. package/src/execution/ui-channels.ts +0 -216
  275. package/src/execution/ui-interaction-model.ts +0 -48
  276. package/src/execution/ui-request-handler-factory.ts +0 -212
  277. package/src/execution/ui-request-observability.ts +0 -81
  278. package/src/execution/ui-request-queue.ts +0 -184
  279. package/src/execution/worktree-manager.ts +0 -688
  280. package/src/execution/worktree-registry.ts +0 -222
  281. package/src/orchestration/__tests__/__fixtures__/worker-template.snapshot.txt +0 -349
  282. package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +0 -202
  283. package/src/orchestration/__tests__/agent-call-stream.test.ts +0 -152
  284. package/src/orchestration/__tests__/args-validator.test.ts +0 -143
  285. package/src/orchestration/__tests__/config-loader.test.ts +0 -503
  286. package/src/orchestration/__tests__/error-recovery-handlers.test.ts +0 -809
  287. package/src/orchestration/__tests__/error-recovery-postmessage-defense.test.ts +0 -405
  288. package/src/orchestration/__tests__/error-recovery-serialize-failed-result.test.ts +0 -56
  289. package/src/orchestration/__tests__/error-recovery-workflow-call.test.ts +0 -166
  290. package/src/orchestration/__tests__/execute-agent-call.test.ts +0 -451
  291. package/src/orchestration/__tests__/jsonl-run-store-corrupt-entry.test.ts +0 -150
  292. package/src/orchestration/__tests__/jsonl-run-store-loadall-sources.test.ts +0 -171
  293. package/src/orchestration/__tests__/jsonl-run-store-retention.test.ts +0 -202
  294. package/src/orchestration/__tests__/jsonl-run-store-session-file.test.ts +0 -1030
  295. package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +0 -600
  296. package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +0 -96
  297. package/src/orchestration/__tests__/lifecycle.test.ts +0 -659
  298. package/src/orchestration/__tests__/non-cloneable-return-e2e.test.ts +0 -95
  299. package/src/orchestration/__tests__/review-fix-loop-e2e.test.ts +0 -2025
  300. package/src/orchestration/__tests__/script-lint.test.ts +0 -831
  301. package/src/orchestration/__tests__/skill-discovery.test.ts +0 -201
  302. package/src/orchestration/__tests__/test-mocks.ts +0 -197
  303. package/src/orchestration/__tests__/worker-exit-without-result.test.ts +0 -368
  304. package/src/orchestration/__tests__/worker-host.test.ts +0 -120
  305. package/src/orchestration/__tests__/worker-returnmeta-passthrough.test.ts +0 -164
  306. package/src/orchestration/__tests__/worker-script-builder-runtime.test.ts +0 -563
  307. package/src/orchestration/__tests__/worker-script-builder.test.ts +0 -309
  308. package/src/orchestration/__tests__/worker-script-template-snapshot.test.ts +0 -129
  309. package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +0 -317
  310. package/src/orchestration/__tests__/workflow-script-lint-memo.test.ts +0 -110
  311. package/src/orchestration/__tests__/workflows-e2e.test.ts +0 -537
  312. package/src/orchestration/agent-opts-resolver.ts +0 -174
  313. package/src/orchestration/args-validator.ts +0 -127
  314. package/src/orchestration/config-loader.ts +0 -315
  315. package/src/orchestration/error-recovery.ts +0 -1018
  316. package/src/orchestration/execute-agent-call.ts +0 -256
  317. package/src/orchestration/launcher.ts +0 -455
  318. package/src/orchestration/lifecycle.ts +0 -399
  319. package/src/orchestration/models/__tests__/budget.test.ts +0 -307
  320. package/src/orchestration/models/__tests__/trace.test.ts +0 -408
  321. package/src/orchestration/models/agent-call.ts +0 -83
  322. package/src/orchestration/models/budget.ts +0 -118
  323. package/src/orchestration/models/ports.ts +0 -164
  324. package/src/orchestration/models/run-runtime.ts +0 -104
  325. package/src/orchestration/models/run-spec.ts +0 -83
  326. package/src/orchestration/models/run-state.ts +0 -44
  327. package/src/orchestration/models/trace.ts +0 -183
  328. package/src/orchestration/models/types.ts +0 -301
  329. package/src/orchestration/models/workflow-run.ts +0 -254
  330. package/src/orchestration/models/workflow-script-registry.ts +0 -35
  331. package/src/orchestration/models/workflow-script.ts +0 -117
  332. package/src/orchestration/script-lint.ts +0 -766
  333. package/src/orchestration/skill-discovery.ts +0 -115
  334. package/src/orchestration/worker-handle.ts +0 -115
  335. package/src/orchestration/worker-host.ts +0 -98
  336. package/src/orchestration/worker-script-builder.ts +0 -421
  337. package/src/orchestration/workflow-files.ts +0 -85
  338. package/src/orchestration/workflow-script-registry-impl.ts +0 -133
  339. package/src/shared/__tests__/agent-ref.test.ts +0 -34
  340. package/src/shared/__tests__/meta-parser.test.ts +0 -304
  341. package/src/shared/__tests__/model-ref.test.ts +0 -306
  342. package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -280
  343. package/src/shared/__tests__/resource-discovery.test.ts +0 -736
  344. package/src/shared/__tests__/resource-meta.test.ts +0 -51
  345. package/src/shared/__tests__/schema-jsonify.test.ts +0 -81
  346. package/src/shared/__tests__/timer-delay.test.ts +0 -61
  347. package/src/shared/agent-event.ts +0 -13
  348. package/src/shared/agent-ref.ts +0 -57
  349. package/src/shared/meta-parser.ts +0 -261
  350. package/src/shared/model-ref.ts +0 -286
  351. package/src/shared/resource-discovery.ts +0 -811
  352. package/src/shared/resource-meta.ts +0 -65
  353. package/src/shared/schema-env.ts +0 -44
  354. package/src/shared/schema-jsonify.ts +0 -58
  355. package/src/shared/timer-delay.ts +0 -54
  356. package/src/shared/xml-injection.ts +0 -35
  357. package/workflows/README.md +0 -81
  358. package/workflows/_shared/agent-refs.cjs +0 -40
  359. package/workflows/chain.js +0 -131
  360. package/workflows/map-reduce.js +0 -174
  361. package/workflows/parallel.js +0 -148
  362. package/workflows/review-fix-loop-utils.cjs +0 -1309
  363. package/workflows/review-fix-loop.js +0 -1404
  364. package/workflows/scatter-gather.js +0 -178
@@ -1,293 +0,0 @@
1
- // src/__tests__/session-file-gc.test.ts
2
- //
3
- // 锁定 maybeCleanupExpiredSessionFiles 的 TTL 边界(数据安全风险):
4
- // - 概率门(CLEANUP_PROBABILITY = 1/20)
5
- // - TTL 边界(mtimeMs 恰好 = now - TTL_MS)
6
- // - 只删 .jsonl,不删 .txt 等
7
- // - 递归 walk 子目录
8
- // - best-effort 吞错(只读目录不外抛)
9
- //
10
- // 边界算错会误删未过期 session 文件或不清理——数据安全风险。
11
- import * as fs from "node:fs";
12
- import * as os from "node:os";
13
- import * as path from "node:path";
14
-
15
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
16
-
17
- import * as aliveStore from "../alive-store.ts";
18
- import { maybeCleanupExpiredSessionFiles } from "../session-file-gc.ts";
19
-
20
- // ============================================================
21
- // helpers
22
- // ============================================================
23
-
24
- let tmpAgentDir: string;
25
-
26
- beforeEach(() => {
27
- tmpAgentDir = fs.mkdtempSync(path.join(os.tmpdir(), "subagents-gc-test-"));
28
- });
29
-
30
- afterEach(() => {
31
- fs.rmSync(tmpAgentDir, { recursive: true, force: true });
32
- vi.restoreAllMocks();
33
- });
34
-
35
- /** 强制 Math.random 返回 0(< CLEANUP_PROBABILITY → 必触发清理)。 */
36
- function forceCleanupTrigger(): void {
37
- vi.spyOn(Math, "random").mockReturnValue(0);
38
- }
39
-
40
- /** 强制 Math.random 返回 1(>= CLEANUP_PROBABILITY → 跳过清理)。 */
41
- function forceCleanupSkip(): void {
42
- vi.spyOn(Math, "random").mockReturnValue(1);
43
- }
44
-
45
- /** 创建一个 .jsonl 文件,mtime 设为指定天数前。 */
46
- function createSessionFile(relPath: string, daysAgo: number): string {
47
- const fullPath = path.join(tmpAgentDir, "subagents", relPath);
48
- fs.mkdirSync(path.dirname(fullPath), { recursive: true });
49
- fs.writeFileSync(fullPath, `{"id":"${relPath}"}\n`, "utf-8");
50
- // 设置 mtime:daysAgo 天前
51
- const targetTime = Date.now() / 1000 - daysAgo * 86400;
52
- fs.utimesSync(fullPath, targetTime, targetTime);
53
- return fullPath;
54
- }
55
-
56
- // ============================================================
57
- // maybeCleanupExpiredSessionFiles
58
- // ============================================================
59
-
60
- describe("maybeCleanupExpiredSessionFiles", () => {
61
- it("skips cleanup when random >= CLEANUP_PROBABILITY (probability gate)", () => {
62
- forceCleanupSkip();
63
- const oldFile = createSessionFile("old.jsonl", 31); // 31 天前,超 TTL
64
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
65
- // 概率门跳过 → 文件仍在
66
- expect(fs.existsSync(oldFile)).toBe(true);
67
- });
68
-
69
- it("triggers cleanup when random < CLEANUP_PROBABILITY", () => {
70
- forceCleanupTrigger();
71
- const oldFile = createSessionFile("old.jsonl", 31);
72
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
73
- expect(fs.existsSync(oldFile)).toBe(false);
74
- });
75
-
76
- it("deletes files older than 30 days (TTL)", () => {
77
- forceCleanupTrigger();
78
- const old = createSessionFile("old.jsonl", 31);
79
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
80
- expect(fs.existsSync(old)).toBe(false);
81
- });
82
-
83
- it("preserves files younger than 30 days", () => {
84
- forceCleanupTrigger();
85
- const young = createSessionFile("young.jsonl", 29);
86
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
87
- expect(fs.existsSync(young)).toBe(true);
88
- });
89
-
90
- it("does NOT delete non-.jsonl files even if old (e.g. .txt)", () => {
91
- forceCleanupTrigger();
92
- const oldTxt = createSessionFile("old.txt", 31);
93
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
94
- // .txt 不在清理范围
95
- expect(fs.existsSync(oldTxt)).toBe(true);
96
- });
97
-
98
- it("recursively walks subdirectories", () => {
99
- forceCleanupTrigger();
100
- // 子目录中的旧文件
101
- const oldNested = createSessionFile(
102
- path.join("encoded-cwd-1", "sessions", "sess-old.jsonl"),
103
- 31,
104
- );
105
- const youngNested = createSessionFile(
106
- path.join("encoded-cwd-1", "sessions", "sess-young.jsonl"),
107
- 5,
108
- );
109
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
110
- expect(fs.existsSync(oldNested)).toBe(false);
111
- expect(fs.existsSync(youngNested)).toBe(true);
112
- });
113
-
114
- it("no-op when subagents dir does not exist (no throw)", () => {
115
- forceCleanupTrigger();
116
- // tmpAgentDir 下没有 subagents/ 目录
117
- expect(() => maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd")).not.toThrow();
118
- });
119
-
120
- it("best-effort: never throws when 'subagents' is a file not a dir (readdirSync ENOTDIR)", () => {
121
- // ESM 不允许 spyOn 命名空间导出,改用真实错误场景:
122
- // 创建一个名为 subagents 的普通文件(非目录),existsSync 返 true 但 readdirSync 抛 ENOTDIR
123
- forceCleanupTrigger();
124
- const fileNotDir = path.join(tmpAgentDir, "subagents");
125
- fs.writeFileSync(fileNotDir, "not a directory", "utf-8");
126
- // walkAndClean 内部 readdirSync 抛错 → 被其 try/catch 吞掉 → 不外抛
127
- expect(() => maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd")).not.toThrow();
128
- });
129
-
130
- it("TTL boundary: file just under 30 days is NOT deleted (strict greater-than semantics)", () => {
131
- // walkAndClean 条件: now - stat.mtimeMs > TTL_MS(严格大于)
132
- // 设 mtime 为 30 天前减去 2 分钟 → now - mtimeMs = TTL_MS - 2min + ε < TTL_MS → 保留
133
- // 用 2 分钟缓冲消除「设 mtime 与 Date.now() 调用之间的几 ms 时间差」造成的抖动
134
- forceCleanupTrigger();
135
- const boundary = createSessionFile("boundary.jsonl", 0);
136
- // 覆盖 mtime 为「30 天 - 2 分钟」前
137
- const targetTime = Date.now() / 1000 - (30 * 86400 - 120);
138
- fs.utimesSync(boundary, targetTime, targetTime);
139
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
140
- // 严格 < TTL_MS → 不删(边界保留)
141
- expect(fs.existsSync(boundary)).toBe(true);
142
- });
143
-
144
- it("handles empty subagents dir (no files, no throw)", () => {
145
- forceCleanupTrigger();
146
- // 创建空 subagents 目录
147
- fs.mkdirSync(path.join(tmpAgentDir, "subagents"), { recursive: true });
148
- expect(() => maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd")).not.toThrow();
149
- });
150
-
151
- // ---- .finalized sidecar 清理 ----
152
-
153
- it("deletes .finalized sidecar along with expired .jsonl", () => {
154
- forceCleanupTrigger();
155
- const jsonl = createSessionFile("sess-finalized.jsonl", 31);
156
- const finalized = `${jsonl}.finalized`;
157
- fs.writeFileSync(finalized, "", "utf-8");
158
- const targetTime = Date.now() / 1000 - 31 * 86400;
159
- fs.utimesSync(finalized, targetTime, targetTime);
160
-
161
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
162
-
163
- expect(fs.existsSync(jsonl)).toBe(false);
164
- expect(fs.existsSync(finalized)).toBe(false);
165
- });
166
-
167
- it("cleans orphan .finalized sidecar when .jsonl already gone", () => {
168
- forceCleanupTrigger();
169
- const subagentsDir = path.join(tmpAgentDir, "subagents");
170
- fs.mkdirSync(subagentsDir, { recursive: true });
171
- const orphan = path.join(subagentsDir, "dead-session.jsonl.finalized");
172
- fs.writeFileSync(orphan, "", "utf-8");
173
- const targetTime = Date.now() / 1000 - 31 * 86400;
174
- fs.utimesSync(orphan, targetTime, targetTime);
175
-
176
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
177
-
178
- expect(fs.existsSync(orphan)).toBe(false);
179
- });
180
-
181
- // ---- .alive sidecar + pid 探活 ----
182
-
183
- it("preserves expired .jsonl when .alive sidecar indicates live process (D-024)", () => {
184
- forceCleanupTrigger();
185
- const jsonl = createSessionFile("sess-alive.jsonl", 31);
186
- const alivePath = `${jsonl}.alive`;
187
- fs.writeFileSync(alivePath, JSON.stringify({ pid: 1, id: "s1", startedAt: Date.now() }), "utf-8");
188
-
189
- vi.spyOn(aliveStore, "readAliveMarker").mockReturnValue({ pid: 1, id: "s1", startedAt: Date.now() });
190
- vi.spyOn(aliveStore, "isProcessAlive").mockReturnValue(true);
191
-
192
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
193
-
194
- expect(fs.existsSync(jsonl)).toBe(true);
195
- expect(fs.existsSync(alivePath)).toBe(true);
196
- });
197
-
198
- it("deletes expired .jsonl + .alive when process is dead", () => {
199
- forceCleanupTrigger();
200
- const jsonl = createSessionFile("sess-dead.jsonl", 31);
201
- const alivePath = `${jsonl}.alive`;
202
- fs.writeFileSync(alivePath, JSON.stringify({ pid: 99999, id: "s2", startedAt: Date.now() }), "utf-8");
203
-
204
- vi.spyOn(aliveStore, "readAliveMarker").mockReturnValue({ pid: 99999, id: "s2", startedAt: Date.now() });
205
- vi.spyOn(aliveStore, "isProcessAlive").mockReturnValue(false);
206
-
207
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
208
-
209
- expect(fs.existsSync(jsonl)).toBe(false);
210
- expect(fs.existsSync(alivePath)).toBe(false);
211
- });
212
-
213
- it("cleans orphan .alive sidecar when .jsonl already gone", () => {
214
- forceCleanupTrigger();
215
- const subagentsDir = path.join(tmpAgentDir, "subagents");
216
- fs.mkdirSync(subagentsDir, { recursive: true });
217
- const orphan = path.join(subagentsDir, "dead-session.jsonl.alive");
218
- fs.writeFileSync(orphan, JSON.stringify({ pid: 99999, id: "s3", startedAt: Date.now() }), "utf-8");
219
- const targetTime = Date.now() / 1000 - 31 * 86400;
220
- fs.utimesSync(orphan, targetTime, targetTime);
221
-
222
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
223
-
224
- expect(fs.existsSync(orphan)).toBe(false);
225
- });
226
-
227
- it("deletes .jsonl + all sidecars (.cancelled, .finalized, .alive) together", () => {
228
- forceCleanupTrigger();
229
- const jsonl = createSessionFile("sess-all-sidecars.jsonl", 31);
230
- const cancelled = `${jsonl}.cancelled`;
231
- const finalized = `${jsonl}.finalized`;
232
- const alive = `${jsonl}.alive`;
233
- fs.writeFileSync(cancelled, "", "utf-8");
234
- fs.writeFileSync(finalized, "", "utf-8");
235
- fs.writeFileSync(alive, JSON.stringify({ pid: 99999, id: "s4", startedAt: Date.now() }), "utf-8");
236
-
237
- vi.spyOn(aliveStore, "readAliveMarker").mockReturnValue({ pid: 99999, id: "s4", startedAt: Date.now() });
238
- vi.spyOn(aliveStore, "isProcessAlive").mockReturnValue(false);
239
-
240
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
241
-
242
- expect(fs.existsSync(jsonl)).toBe(false);
243
- expect(fs.existsSync(cancelled)).toBe(false);
244
- expect(fs.existsSync(finalized)).toBe(false);
245
- expect(fs.existsSync(alive)).toBe(false);
246
- });
247
-
248
- // ---- [F2] manifest .json 清理(仅 records 子目录内)----
249
- // records 目录布局:subagents/<enc>/records/<id>.json(D-004 cwd 物理隔离)。
250
- // allowManifestJson 仅在名为 records 的子目录内打开,防止误删 enc 外层的
251
- // worktrees.json(worktree reaper 依赖的状态文件)。
252
-
253
- it("[F2] deletes expired manifest .json inside records/ subdir", () => {
254
- forceCleanupTrigger();
255
- const manifest = createSessionFile(
256
- path.join("--Users-x-proj--", "records", "rec-1.json"),
257
- 31,
258
- );
259
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
260
- expect(fs.existsSync(manifest)).toBe(false);
261
- });
262
-
263
- it("[F2] preserves manifest .json younger than TTL inside records/", () => {
264
- forceCleanupTrigger();
265
- const manifest = createSessionFile(
266
- path.join("--Users-x-proj--", "records", "rec-young.json"),
267
- 5,
268
- );
269
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
270
- expect(fs.existsSync(manifest)).toBe(true);
271
- });
272
-
273
- it("[F2] CRITICAL: does NOT delete worktrees.json at subagents/ root (regression)", () => {
274
- // 破坏性风险点:worktrees.json 在 agentDir/subagents/worktrees.json(enc 外层第一层)。
275
- // 暴力匹配所有 .json 会误删 → worktree reaper 失效。allowManifestJson 只在名为 records
276
- // 的子目录内打开,根层的 worktrees.json 必须保留。
277
- forceCleanupTrigger();
278
- const worktrees = createSessionFile("worktrees.json", 31);
279
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
280
- expect(fs.existsSync(worktrees)).toBe(true);
281
- });
282
-
283
- it("[F2] preserves .json.tmp.* inside records/ (recoverTmpFiles owns them)", () => {
284
- // 跳过 .tmp.:session_start 的 recoverTmpFiles 同步处理 tmp,GC 不重复。
285
- forceCleanupTrigger();
286
- const tmp = createSessionFile(
287
- path.join("--Users-x-proj--", "records", "rec-2.json.tmp.123"),
288
- 31,
289
- );
290
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
291
- expect(fs.existsSync(tmp)).toBe(true);
292
- });
293
- });
@@ -1,197 +0,0 @@
1
- // src/execution/__tests__/session-pending.test.ts
2
- //
3
- // readActivePendingFromSessionFile:读 session 文件算活跃后代(pending 差集)。
4
- // 覆盖:差集、快速路径过滤、文件不存在/坏行/未回填 sessionFile。
5
-
6
- import * as fs from "node:fs";
7
- import * as os from "node:os";
8
- import * as path from "node:path";
9
-
10
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
11
-
12
- import { readActivePendingFromSessionFile, clearPendingCursors } from "../session-pending.ts";
13
-
14
- function makeTmpSessionFile(lines: string[]): string {
15
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), "session-pending-test-"));
16
- const file = path.join(dir, "session.jsonl");
17
- fs.writeFileSync(file, lines.join("\n") + "\n");
18
- return file;
19
- }
20
-
21
- const mkRegister = (id: string, type: "subagent" | "workflow" = "subagent") =>
22
- JSON.stringify({ type: "custom", customType: "pending:register", data: { id, type, name: id } });
23
-
24
- const mkUnregister = (id: string, reason = "completed", ts = "2026-08-06T08:00:00.000Z") =>
25
- JSON.stringify({ type: "custom", customType: "pending:unregister", data: { id, reason }, timestamp: ts });
26
-
27
- const mkMessage = (role: string, text: string) =>
28
- JSON.stringify({ type: "message", id: `m-${Date.now()}-${Math.random()}`, message: { role, content: [{ type: "text", text }] } });
29
-
30
- describe("readActivePendingFromSessionFile", () => {
31
- const tmpFiles: string[] = [];
32
-
33
- afterEach(() => {
34
- for (const f of tmpFiles.splice(0)) {
35
- try {
36
- fs.rmSync(path.dirname(f), { recursive: true, force: true });
37
- } catch {
38
- // 清理失败不影响断言
39
- }
40
- }
41
- });
42
-
43
- it("无 pending entries → count 0", () => {
44
- const file = makeTmpSessionFile([mkMessage("user", "hi"), mkMessage("assistant", "hello")]);
45
- tmpFiles.push(file);
46
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: false });
47
- });
48
-
49
- it("纯 register → count = 活跃后代数", () => {
50
- const file = makeTmpSessionFile([mkRegister("bg-1"), mkRegister("bg-2", "workflow")]);
51
- tmpFiles.push(file);
52
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 2, recentUnregister: false });
53
- });
54
-
55
- it("register + unregister 同 id → 差集抵消", () => {
56
- const file = makeTmpSessionFile([mkRegister("bg-1"), mkUnregister("bg-1")]);
57
- tmpFiles.push(file);
58
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: false });
59
- });
60
-
61
- it("混合:部分注销 → 只统计仍活跃的(真实 e2e 场景:P 的 agent_end 时 explorer 未注销)", () => {
62
- const file = makeTmpSessionFile([
63
- mkRegister("bg-1"),
64
- mkUnregister("bg-1", "completed"),
65
- mkRegister("explorer-1"),
66
- mkMessage("assistant", "waiting for explorer..."),
67
- ]);
68
- tmpFiles.push(file);
69
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
70
- });
71
-
72
- it("fork 继承的主 session register 已被 expired unregister 抵消 → 不干扰", () => {
73
- // 模拟 P fork 主 session:继承 register(sessionId 不匹配),session_start 重建补 unregister(expired)
74
- const file = makeTmpSessionFile([
75
- mkRegister("parent-bg"),
76
- mkUnregister("parent-bg", "expired"),
77
- mkRegister("my-bg"),
78
- ]);
79
- tmpFiles.push(file);
80
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
81
- });
82
-
83
- it("坏行(截断 JSON)跳过,不影响其余判定", () => {
84
- const file = makeTmpSessionFile([
85
- '{"type":"custom","customType":"pending:register","data":{"id":"bg-1"',
86
- mkRegister("bg-2"),
87
- ]);
88
- tmpFiles.push(file);
89
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
90
- });
91
-
92
- it("sessionFile 未回填(undefined)→ error(调用方保守不 kill)", () => {
93
- const res = readActivePendingFromSessionFile(undefined);
94
- expect(res.count).toBe(0);
95
- expect(res.error).toBeDefined();
96
- });
97
-
98
- it("文件不存在 → error(调用方保守不 kill)", () => {
99
- const res = readActivePendingFromSessionFile("/nonexistent/path/session.jsonl");
100
- expect(res.count).toBe(0);
101
- expect(res.error).toBeDefined();
102
- });
103
-
104
- it("最近 60s 内有 unregister → recentUnregister=true(后代刚完成,唤醒在路上——竞态窗口不 kill)", () => {
105
- const file = makeTmpSessionFile([
106
- mkRegister("bg-live"),
107
- mkUnregister("bg-live", "completed", new Date().toISOString()),
108
- ]);
109
- tmpFiles.push(file);
110
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: true });
111
- });
112
-
113
- it("unregister 在 60s 窗口外 → recentUnregister=false(正常 kill 路径)", () => {
114
- const file = makeTmpSessionFile([
115
- mkRegister("bg-live"),
116
- mkUnregister("bg-live", "completed", "2020-01-01T00:00:00.000Z"),
117
- ]);
118
- tmpFiles.push(file);
119
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: false });
120
- });
121
-
122
- // [S-4] fast-path 按值匹配而非序列化格式。旧行 `line.includes('"customType":"pending:')`
123
- // 耦合 pi 的 JSON 序列化空格习惯(冒号后无空格)。若 pi 改序列化(单行内冒号后加空格),
124
- // 旧实现全过滤 → count=0 → keep-alive 静默失效 → recursive tree 被杀、steer 丢失。
125
- // 本用例构造冒号后带空格的单行 JSON,验证值匹配仍命中 + 解析正确。
126
- it("S-4: 序列化冒号后带空格 → 仍正确解析(防 fast-path 格式耦合导致 keep-alive 静默失效)", () => {
127
- const file = makeTmpSessionFile([
128
- `{ "type": "message", "message": { "role": "user", "content": [] } }`,
129
- `{ "type": "custom", "customType": "pending:register", "data": { "id": "bg-1", "type": "subagent", "name": "bg-1" } }`,
130
- `{ "type": "custom", "customType": "pending:unregister", "data": { "id": "bg-1", "reason": "completed" }, "timestamp": "2020-01-01T00:00:00.000Z" }`,
131
- `{ "type": "custom", "customType": "pending:register", "data": { "id": "bg-2", "type": "subagent", "name": "bg-2" } }`,
132
- ]);
133
- tmpFiles.push(file);
134
- // bg-1 register+unregister 抵消,bg-2 仍活跃 → count=1。
135
- // 旧 fast-path(`"customType":"pending:` 冒号无空格)会跳过所有行 → count=0(静默失效)。
136
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
137
- });
138
- });
139
-
140
- // [perf] 增量游标行为:同文件重复判定(层主被多个后代唤醒 N 次 → N 次 agent_end)
141
- // 只读上次 offset 之后的新增行,累计差集语义与全量读一致。
142
- describe("readActivePendingFromSessionFile — 增量游标 [perf]", () => {
143
- let dir: string;
144
- let file: string;
145
-
146
- beforeEach(() => {
147
- dir = fs.mkdtempSync(path.join(os.tmpdir(), "session-pending-incr-"));
148
- file = path.join(dir, "session.jsonl");
149
- clearPendingCursors();
150
- });
151
-
152
- afterEach(() => {
153
- fs.rmSync(dir, { recursive: true, force: true });
154
- });
155
-
156
- it("首次全量 + append 后增量:unregister 只抵消对应 id(与全量读一致)", () => {
157
- fs.writeFileSync(file, mkRegister("d1") + "\n" + mkRegister("d2") + "\n");
158
- expect(readActivePendingFromSessionFile(file).count).toBe(2);
159
-
160
- fs.appendFileSync(file, mkUnregister("d1", "completed") + "\n");
161
- const r = readActivePendingFromSessionFile(file);
162
- expect(r.error).toBeUndefined();
163
- expect(r.count).toBe(1);
164
- });
165
-
166
- it("EOF 半行(append 竞态)不入账,补全换行后入账", () => {
167
- fs.writeFileSync(file, mkRegister("d1") + "\n");
168
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
169
-
170
- // 半行:无尾换行 → offset 不推进该行
171
- const full = mkUnregister("d1", "completed", new Date().toISOString());
172
- fs.appendFileSync(file, full.slice(0, full.length - 4));
173
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
174
-
175
- // 补全(剩余字符 + 换行)→ 消费
176
- fs.appendFileSync(file, full.slice(-4) + "\n");
177
- const r = readActivePendingFromSessionFile(file);
178
- expect(r.count).toBe(0);
179
- expect(r.recentUnregister).toBe(true);
180
- });
181
-
182
- it("文件 truncate/重建(size 回退)→ 重置游标从头全读", () => {
183
- fs.writeFileSync(file, mkRegister("d1") + "\n" + mkRegister("d2") + "\n");
184
- expect(readActivePendingFromSessionFile(file).count).toBe(2);
185
-
186
- fs.writeFileSync(file, mkRegister("d3") + "\n");
187
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
188
- });
189
-
190
- it("clearPendingCursors 后重新全量(累计 entries 不残留旧账)", () => {
191
- fs.writeFileSync(file, mkRegister("d1") + "\n");
192
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
193
- clearPendingCursors();
194
- fs.appendFileSync(file, mkRegister("d2") + "\n");
195
- expect(readActivePendingFromSessionFile(file).count).toBe(2);
196
- });
197
- });