@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,117 +0,0 @@
1
- // ManifestStore — parentRecordId 落盘测试(M3a)。
2
- //
3
- // 验证 M3a 三条契约:
4
- // 1. 新 record 落盘含 parentRecordId(depth>=1 subagent 读回直接父 record id)
5
- // 2. 旧 manifest JSON(无 parentRecordId 字段)readManifest 仍有效(向后兼容)
6
- // 3. isValidManifest 校验不改(5 必填不变,parentRecordId optional)
7
- //
8
- // isValidManifest 私有未 export——通过 readManifest 等价验证:readManifest 内部
9
- // `isValidManifest(parsed) ? parsed : null`,非 null ⟺ 校验通过。不 export 私有函数
10
- // 避免扩大公共 API 表面(M3a C1 约束:不改 isValidManifest,仅 2 行代码改动)。
11
-
12
- import * as fs from "node:fs";
13
- import * as os from "node:os";
14
- import * as path from "node:path";
15
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
16
-
17
- import { ManifestStore, type ManifestRecord } from "../manifest-store.ts";
18
-
19
- /** 构造最小合法 ManifestRecord(5 必填),optional 字段按 overrides 传入。 */
20
- function makeBaseManifest(overrides: Partial<ManifestRecord> = {}): ManifestRecord {
21
- return {
22
- id: "rec-test",
23
- rootSessionId: "session-main",
24
- agentName: "worker",
25
- status: "completed",
26
- createdAt: 1000,
27
- ...overrides,
28
- };
29
- }
30
-
31
- describe("ManifestStore — parentRecordId 落盘 (M3a)", () => {
32
- let tmpDir: string;
33
- let store: ManifestStore;
34
-
35
- beforeEach(() => {
36
- tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "manifest-parentid-"));
37
- store = new ManifestStore(tmpDir);
38
- });
39
-
40
- afterEach(() => {
41
- fs.rmSync(tmpDir, { recursive: true, force: true });
42
- });
43
-
44
- // ── TC-m3a-new-record-parentid ──
45
- it("新 record 落盘含 parentRecordId(depth>=1 读回直接父 record id)", async () => {
46
- const record = makeBaseManifest({
47
- id: "rec-child",
48
- parentRecordId: "sa-parent-1",
49
- });
50
- await store.writeManifest(record);
51
-
52
- const readBack = await store.readManifest("rec-child");
53
- expect(readBack).not.toBeNull();
54
- expect(readBack?.parentRecordId).toBe("sa-parent-1");
55
- });
56
-
57
- it("顶层 record(parentRecordId 缺失)落盘读回仍 undefined", async () => {
58
- // 顶层 subagent parentRecordId=undefined(父是 main,main 无 record)
59
- const record = makeBaseManifest({ id: "rec-top" });
60
- await store.writeManifest(record);
61
-
62
- const readBack = await store.readManifest("rec-top");
63
- expect(readBack).not.toBeNull();
64
- expect(readBack?.parentRecordId).toBeUndefined();
65
- });
66
-
67
- // ── TC-m3a-old-manifest-compat ──
68
- it("旧 manifest JSON(无 parentRecordId)readManifest 返有效(isValidManifest 通过)", async () => {
69
- // 手写旧版本格式 manifest(无 parentRecordId 字段),模拟旧 subagent-workflow 写的磁盘文件
70
- const oldManifest = {
71
- id: "rec-old",
72
- rootSessionId: "session-main",
73
- agentName: "worker",
74
- status: "completed",
75
- createdAt: 2000,
76
- // 无 parentRecordId —— 旧版本写的
77
- };
78
- fs.writeFileSync(
79
- path.join(tmpDir, "rec-old.json"),
80
- JSON.stringify(oldManifest),
81
- "utf-8",
82
- );
83
-
84
- const readBack = await store.readManifest("rec-old");
85
- // readManifest 内 isValidManifest(parsed) ? parsed : null —— 非 null 即 5 必填校验通过
86
- expect(readBack).not.toBeNull();
87
- expect(readBack?.id).toBe("rec-old");
88
- expect(readBack?.parentRecordId).toBeUndefined();
89
- });
90
-
91
- // ── TC-m3a-isvalidmanifest-unchanged ──
92
- it("isValidManifest 不改:含/不含 parentRecordId 均通过(5 必填不变)", async () => {
93
- // isValidManifest 私有,通过 readManifest 等价验证(非 null ⟺ 校验通过)。
94
- // 含 parentRecordId —— 新格式
95
- const withParent = makeBaseManifest({
96
- id: "rec-with-parent",
97
- parentRecordId: "sa-x",
98
- });
99
- await store.writeManifest(withParent);
100
- expect(await store.readManifest("rec-with-parent")).not.toBeNull();
101
-
102
- // 不含 parentRecordId —— 仅 5 必填(旧格式 / 顶层 record)
103
- const minimal = {
104
- id: "rec-minimal",
105
- rootSessionId: "session-main",
106
- agentName: "worker",
107
- status: "completed",
108
- createdAt: 3000,
109
- };
110
- fs.writeFileSync(
111
- path.join(tmpDir, "rec-minimal.json"),
112
- JSON.stringify(minimal),
113
- "utf-8",
114
- );
115
- expect(await store.readManifest("rec-minimal")).not.toBeNull();
116
- });
117
- });
@@ -1,465 +0,0 @@
1
- // src/__tests__/model-resolver.test.ts
2
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
3
-
4
- import {
5
- availableThinkingLevels,
6
- type ModelInfo,
7
- type ModelRegistryLike,
8
- resolveModel,
9
- } from "../model-resolver.ts";
10
-
11
- // ============================================================
12
- // helpers
13
- // ============================================================
14
-
15
- function makeModel(over: Partial<ModelInfo> = {}): ModelInfo {
16
- return {
17
- id: over.id ?? "sonnet-4-5",
18
- name: over.name ?? "Claude Sonnet 4.5",
19
- provider: over.provider ?? "anthropic",
20
- reasoning: over.reasoning ?? false,
21
- thinkingLevelMap: over.thinkingLevelMap,
22
- contextWindow: over.contextWindow,
23
- };
24
- }
25
-
26
- /** 构造 mock registry:registered 表 (provider/modelId) → ModelInfo;authed 集合控制鉴权。 */
27
- function makeRegistry(models: ModelInfo[], authed: string[] = models.map((m) => `${m.provider}/${m.id}`)): ModelRegistryLike {
28
- const authSet = new Set(authed);
29
- return {
30
- getAvailable: () => models,
31
- find: (provider, modelId) => models.find((m) => m.provider === provider && m.id === modelId),
32
- hasConfiguredAuth: (m) => {
33
- if (!m || typeof m !== "object") return false;
34
- const mm = m as ModelInfo;
35
- return authSet.has(`${mm.provider}/${mm.id}`);
36
- },
37
- };
38
- }
39
-
40
- /** 主 agent model(第三层兼底)。 */
41
- const ctxModel = makeModel({ id: "main-model", provider: "main" });
42
-
43
- // ============================================================
44
- // resolveModel — 三层优先级
45
- // ============================================================
46
-
47
- describe("resolveModel — three-layer priority", () => {
48
- it("L1: paramOverride.model wins over agentConfig and ctxModel", () => {
49
- const m1 = makeModel({ id: "explicit", provider: "p1" });
50
- const reg = makeRegistry([m1]);
51
- const r = resolveModel(
52
- { name: "worker", systemPrompt: "", model: "main/agent-md" },
53
- reg,
54
- { model: "p1/explicit" },
55
- ctxModel,
56
- );
57
- expect(r.model.id).toBe("explicit");
58
- });
59
-
60
- it("L2: agentConfig.model used when no paramOverride", () => {
61
- const m = makeModel({ id: "agent-md-model", provider: "ap" });
62
- const reg = makeRegistry([m]);
63
- const r = resolveModel(
64
- { name: "worker", systemPrompt: "", model: "ap/agent-md-model" },
65
- reg,
66
- undefined,
67
- ctxModel,
68
- );
69
- expect(r.model.id).toBe("agent-md-model");
70
- });
71
-
72
- it("L3: ctxModel (main agent model) used when no override and no agentConfig.model", () => {
73
- const reg = makeRegistry([]);
74
- const r = resolveModel(
75
- { name: "worker", systemPrompt: "" },
76
- reg,
77
- undefined,
78
- ctxModel,
79
- );
80
- expect(r.model).toBe(ctxModel);
81
- expect(r.thinkingLevel).toBeUndefined();
82
- });
83
-
84
- it("L3: ctxModel used even when registry is empty (no lookup needed)", () => {
85
- const reg = makeRegistry([]);
86
- const r = resolveModel(undefined, reg, undefined, ctxModel);
87
- expect(r.model).toBe(ctxModel);
88
- });
89
- });
90
-
91
- // ============================================================
92
- // 显式指定失败的错误行为
93
- // ============================================================
94
-
95
- describe("resolveModel — explicit override failures throw (no silent fallback)", () => {
96
- it("paramOverride.model not in registry → throws (does NOT fall back to ctxModel)", () => {
97
- const reg = makeRegistry([]);
98
- expect(() =>
99
- resolveModel(undefined, reg, { model: "x/nonexistent" }, ctxModel),
100
- ).toThrow(/is not a registry entry/);
101
- });
102
-
103
- it("paramOverride.model found but auth missing → throws auth-specific message", () => {
104
- const m = makeModel({ id: "unauthed", provider: "u" });
105
- const reg = makeRegistry([m], []); // 无鉴权
106
- expect(() =>
107
- resolveModel(undefined, reg, { model: "u/unauthed" }, ctxModel),
108
- ).toThrow(/exists but auth is not configured/);
109
- });
110
-
111
- it("agentConfig.model not in registry → throws", () => {
112
- const reg = makeRegistry([]);
113
- expect(() =>
114
- resolveModel(
115
- { name: "worker", systemPrompt: "", model: "x/missing" },
116
- reg,
117
- undefined,
118
- ctxModel,
119
- ),
120
- ).toThrow(/is not a registry entry/);
121
- });
122
-
123
- it("no override, no agentConfig.model, no ctxModel → throws listing available", () => {
124
- const m = makeModel({ id: "visible", provider: "v" });
125
- const reg = makeRegistry([m]);
126
- expect(() => resolveModel(undefined, reg, undefined, undefined)).toThrow(
127
- /No available model.*Available models/s,
128
- );
129
- });
130
-
131
- it("invalid model string (no slash) → throws", () => {
132
- const reg = makeRegistry([]);
133
- expect(() =>
134
- resolveModel(undefined, reg, { model: "no-slash" }, ctxModel),
135
- ).toThrow(/is not a registry entry/);
136
- });
137
- });
138
-
139
- // ============================================================
140
- // thinkingLevel 解析
141
- // ============================================================
142
-
143
- describe("resolveModel — thinkingLevel resolution", () => {
144
- it("override path: returns requested thinkingLevel when model supports it", () => {
145
- const m = makeModel({
146
- id: "reasoning-model",
147
- provider: "rp",
148
- reasoning: true,
149
- thinkingLevelMap: { low: 1, high: 2, xhigh: 3 },
150
- });
151
- const reg = makeRegistry([m]);
152
- const r = resolveModel(undefined, reg, { model: "rp/reasoning-model", thinkingLevel: "high" });
153
- expect(r.thinkingLevel).toBe("high");
154
- });
155
-
156
- it("override path: clamps down to highest available when requested unsupported", () => {
157
- const m = makeModel({
158
- id: "limited-model",
159
- provider: "lp",
160
- reasoning: true,
161
- thinkingLevelMap: { low: 1, medium: 2 }, // 不含 xhigh
162
- });
163
- const reg = makeRegistry([m]);
164
- const r = resolveModel(undefined, reg, { model: "lp/limited-model", thinkingLevel: "xhigh" });
165
- expect(r.thinkingLevel).toBe("medium");
166
- });
167
-
168
- it("override path: returns undefined when model.reasoning === false", () => {
169
- const m = makeModel({ id: "non-reasoning", provider: "nr", reasoning: false });
170
- const reg = makeRegistry([m]);
171
- const r = resolveModel(undefined, reg, { model: "nr/non-reasoning", thinkingLevel: "high" });
172
- expect(r.thinkingLevel).toBeUndefined();
173
- });
174
-
175
- it("ctxModel path: thinkingLevel from paramOverride.thinkingLevel (pass-through, no clamp)", () => {
176
- const reg = makeRegistry([]);
177
- const r = resolveModel(undefined, reg, { thinkingLevel: "high" }, ctxModel);
178
- // ctxModel reasoning=false,但 ctxModel 路径不 clamp(主 agent model 直接透传)
179
- expect(r.thinkingLevel).toBe("high");
180
- });
181
-
182
- it("ctxModel path: thinkingLevel from agentConfig.thinkingLevel when no paramOverride", () => {
183
- const reg = makeRegistry([]);
184
- const r = resolveModel(
185
- { name: "worker", systemPrompt: "", thinkingLevel: "medium" },
186
- reg,
187
- undefined,
188
- ctxModel,
189
- );
190
- expect(r.thinkingLevel).toBe("medium");
191
- });
192
-
193
- it("ctxModel path: thinkingLevel undefined when no override and ctxModel non-reasoning", () => {
194
- const reg = makeRegistry([]);
195
- // ctxModel(makeModel 默认 reasoning=false)无 override → 非 reasoning 不支持 thinking
196
- const r = resolveModel(undefined, reg, undefined, ctxModel);
197
- expect(r.thinkingLevel).toBeUndefined();
198
- });
199
-
200
- // ── 默认 thinking 兜底:无显式指定时用「模型最高可用档」(不落 pi 默认 medium)──
201
-
202
- it("ctxModel path: no override + reasoning model with map → highest mapped level", () => {
203
- const reg = makeRegistry([]);
204
- const m = makeModel({ id: "r-main", provider: "rm", reasoning: true, thinkingLevelMap: { low: 1, high: 2, xhigh: 3 } });
205
- const r = resolveModel(undefined, reg, undefined, m);
206
- expect(r.thinkingLevel).toBe("xhigh");
207
- });
208
-
209
- it("ctxModel path: no override + reasoning model with map containing max → max", () => {
210
- const reg = makeRegistry([]);
211
- const m = makeModel({ id: "r-max", provider: "rm", reasoning: true, thinkingLevelMap: { high: 2, max: 99 } });
212
- const r = resolveModel(undefined, reg, undefined, m);
213
- expect(r.thinkingLevel).toBe("max");
214
- });
215
-
216
- it("ctxModel path: no override + reasoning model without map → xhigh (pi-legal ceiling)", () => {
217
- const reg = makeRegistry([]);
218
- // 无 map 时不能用 "max"——pi 侧 model:"max" 后缀非法会导致 model 解析失败
219
- const m = makeModel({ id: "r-nomap", provider: "rm", reasoning: true });
220
- const r = resolveModel(undefined, reg, undefined, m);
221
- expect(r.thinkingLevel).toBe("xhigh");
222
- });
223
-
224
- it("override path: no thinkingLevel param → defaults to model's highest mapped level", () => {
225
- const m = makeModel({
226
- id: "default-thinking",
227
- provider: "dt",
228
- reasoning: true,
229
- thinkingLevelMap: { minimal: 1, medium: 2, high: 3 },
230
- });
231
- const reg = makeRegistry([m]);
232
- const r = resolveModel(undefined, reg, { model: "dt/default-thinking" });
233
- expect(r.thinkingLevel).toBe("high");
234
- });
235
- });
236
-
237
- // ============================================================
238
- // lookupModel 容错:剥离 ":thinkingLevel" 后缀(A)
239
- // ============================================================
240
-
241
- describe('resolveModel — strips ":thinkingLevel" suffix from model string (A)', () => {
242
- it('resolves model passed with ":xhigh" suffix', () => {
243
- const m = makeModel({ id: "ds-pro", provider: "deepseek-router", reasoning: true, thinkingLevelMap: { xhigh: 3 } });
244
- const reg = makeRegistry([m]);
245
- const r = resolveModel(undefined, reg, { model: "deepseek-router/ds-pro:xhigh" }, ctxModel);
246
- expect(r.model.id).toBe("ds-pro");
247
- });
248
-
249
- it('resolves model passed with ":high" suffix (registry has no suffix)', () => {
250
- const m = makeModel({ id: "sonnet", provider: "anthropic", reasoning: true, thinkingLevelMap: { high: 2 } });
251
- const reg = makeRegistry([m]);
252
- const r = resolveModel(undefined, reg, { model: "anthropic/sonnet:high" });
253
- expect(r.model.id).toBe("sonnet");
254
- });
255
-
256
- it('strips ":off" suffix (off is a valid thinking level)', () => {
257
- const m = makeModel({ id: "m1", provider: "p", reasoning: false });
258
- const reg = makeRegistry([m]);
259
- const r = resolveModel(undefined, reg, { model: "p/m1:off" });
260
- expect(r.model.id).toBe("m1");
261
- });
262
-
263
- it('does NOT strip unrelated colon suffix (e.g. ":foo")', () => {
264
- // ":foo" 不是合法 thinking level,不剥离 → 查不到 → 抛 not found
265
- const m = makeModel({ id: "m1", provider: "p", reasoning: false });
266
- const reg = makeRegistry([m]);
267
- expect(() => resolveModel(undefined, reg, { model: "p/m1:foo" })).toThrow(/is not a registry entry/);
268
- });
269
-
270
- it('suffix-stripped resolve still respects explicit thinkingLevel param', () => {
271
- const m = makeModel({ id: "ds-pro", provider: "deepseek-router", reasoning: true, thinkingLevelMap: { high: 2, xhigh: 3 } });
272
- const reg = makeRegistry([m]);
273
- // model 带 ":xhigh" 但 thinkingLevel param 指定 high -> thinking 取 high
274
- const r = resolveModel(undefined, reg, { model: "deepseek-router/ds-pro:xhigh", thinkingLevel: "high" });
275
- expect(r.model.id).toBe("ds-pro");
276
- expect(r.thinkingLevel).toBe("high");
277
- });
278
- });
279
-
280
- // ============================================================
281
- // not-found 错误信息:列出相近可用 model(B)
282
- // ============================================================
283
-
284
- describe("resolveModel — not-found error suggests similar models (B)", () => {
285
- it("not-found with available registry lists similar models", () => {
286
- const m = makeModel({ id: "ds-pro", provider: "deepseek-router" });
287
- const reg = makeRegistry([m]);
288
- let msg = "";
289
- try {
290
- resolveModel(undefined, reg, { model: "deepseek-router/ds-por" }, ctxModel); // 拼写错误
291
- } catch (e) {
292
- msg = (e as Error).message;
293
- }
294
- expect(msg).toMatch(/is not a registry entry/);
295
- expect(msg).toMatch(/deepseek-router\/ds-pro/); // 建议列表含正确拼写
296
- });
297
-
298
- it("not-found with empty registry reports no available models", () => {
299
- const reg = makeRegistry([]);
300
- expect(() => resolveModel(undefined, reg, { model: "x/none" }, ctxModel)).toThrow(
301
- /Registry has no available models/,
302
- );
303
- });
304
-
305
- it("auth-missing error does NOT list models, points to models.json", () => {
306
- const m = makeModel({ id: "unauthed", provider: "u" });
307
- const reg = makeRegistry([m], []);
308
- let msg = "";
309
- try {
310
- resolveModel(undefined, reg, { model: "u/unauthed" }, ctxModel);
311
- } catch (e) {
312
- msg = (e as Error).message;
313
- }
314
- expect(msg).toMatch(/auth is not configured/);
315
- expect(msg).toMatch(/models\.json/);
316
- expect(msg).not.toMatch(/Similar available models/); // auth 错误不列 model
317
- });
318
-
319
- it("P1: resolves model passed with ':max' suffix (THINKING_ORDER includes 'max')", () => {
320
- const m = makeModel({ id: "mock-model", provider: "p1", reasoning: true, thinkingLevelMap: { max: 4 } });
321
- const reg = makeRegistry([m]);
322
- const r = resolveModel(
323
- { name: "worker", systemPrompt: "" },
324
- reg,
325
- { model: "p1/mock-model:max" },
326
- ctxModel,
327
- );
328
- expect(r.model).toBeTruthy();
329
- expect(r.model.id).toBe("mock-model");
330
- expect(r.thinkingLevel).toBe("max");
331
- });
332
- });
333
-
334
- describe("availableThinkingLevels", () => {
335
- it("returns [] when reasoning false", () => {
336
- expect(availableThinkingLevels({ reasoning: false })).toEqual([]);
337
- });
338
- it("returns [] when no thinkingLevelMap", () => {
339
- expect(availableThinkingLevels({ reasoning: true })).toEqual([]);
340
- });
341
- it("filters THINKING_ORDER to non-null map entries, ascending", () => {
342
- expect(
343
- availableThinkingLevels({ reasoning: true, thinkingLevelMap: { off: 0, high: 2, low: 1, xhigh: 3 } }),
344
- ).toEqual(["off", "low", "high", "xhigh"]);
345
- });
346
-
347
- it("P2: includes 'max' as the last level (THINKING_ORDER SSOT derived)", () => {
348
- const levels = availableThinkingLevels({ reasoning: true, thinkingLevelMap: { off: 0, low: 1, high: 2, xhigh: 3, max: 4 } });
349
- expect(levels).toEqual(["off", "low", "high", "xhigh", "max"]);
350
- expect(levels.slice(-3)).toEqual(["high", "xhigh", "max"]);
351
- });
352
- });
353
-
354
- // ============================================================
355
- // [U1 ModelRef 全等裁决] 孪生守卫(D1 规则④,两路径共用)
356
- // ============================================================
357
-
358
- describe("resolveModel — U1 twin guard (D1 rule ④)", () => {
359
- /** 含大小写孪生的 registry 快照(模拟 models-store 刷新后大小写两形态并存)。 */
360
- function makeTwinRegistry(): ModelRegistryLike {
361
- return makeRegistry([
362
- makeModel({ id: "GLM-5.3-Flash", provider: "zai-coding-cn" }),
363
- makeModel({ id: "glm-5.3-flash", provider: "zai-coding-cn" }),
364
- ]);
365
- }
366
-
367
- it("显式入参全等命中但 registry 含孪生 → 拒单(ambiguous,不代改输入)", () => {
368
- expect(() =>
369
- resolveModel(undefined, makeTwinRegistry(), { model: "zai-coding-cn/GLM-5.3-Flash" }, ctxModel),
370
- ).toThrow(/ambiguous case variants/);
371
- });
372
-
373
- it("ctxModel 继承路径孪生守卫同等生效(D2 豁免的只是存在性复查)", () => {
374
- const main = makeModel({ id: "GLM-5.3-Flash", provider: "zai-coding-cn" });
375
- expect(() => resolveModel(undefined, makeTwinRegistry(), undefined, main)).toThrow(
376
- /ambiguous case variants/,
377
- );
378
- });
379
-
380
- it("无孪生时 ctxModel 路径零误伤(引用透传不变,P-A2 放行路径)", () => {
381
- const main = makeModel({ id: "main-model", provider: "main" });
382
- const r = resolveModel(undefined, makeRegistry([]), undefined, main);
383
- expect(r.model).toBe(main);
384
- });
385
-
386
- it("小写入参(存在 case variant)→ 首个建议为正确大写串并标注(S2 负面路径)", () => {
387
- const reg = makeRegistry([makeModel({ id: "GLM-5.3-Flash", provider: "zai-coding-cn" })]);
388
- let msg = "";
389
- try {
390
- resolveModel(undefined, reg, { model: "zai-coding-cn/glm-5.3-flash" }, ctxModel);
391
- } catch (e) {
392
- msg = (e as Error).message;
393
- }
394
- expect(msg).toMatch(/is not a registry entry/);
395
- expect(msg).toContain('zai-coding-cn/GLM-5.3-Flash ← case variant of "glm-5.3-flash"');
396
- });
397
-
398
- it("放行后回显与入参全等(L1 路径 model 字段保持 registry 原始大小写)", () => {
399
- const m = makeModel({ id: "GLM-5.3-Flash", provider: "zai-coding-cn" });
400
- const r = resolveModel(undefined, makeRegistry([m]), { model: "zai-coding-cn/GLM-5.3-Flash" }, ctxModel);
401
- expect(r.model.id).toBe("GLM-5.3-Flash");
402
- expect(r.model.provider).toBe("zai-coding-cn");
403
- });
404
- });
405
-
406
- // ============================================================
407
- // ModelConfigService: initModel(ctxModel) → resolveModel L3 plumb-through
408
- // changeset 主打路径的 runtime 契约保护(EA-4)。
409
- // 链路:session_start initModel({ctxModel}) → _ctxModel 缓存 → resolveModel 第三层命中
410
- // ============================================================
411
-
412
- import * as fs from "node:fs";
413
- import * as os from "node:os";
414
- import * as path from "node:path";
415
-
416
- import { ModelConfigService } from "../model-config-service.ts";
417
-
418
- describe("ModelConfigService: ctx.model plumb-through (EA-4)", () => {
419
- let tmpDir: string;
420
-
421
- beforeEach(() => {
422
- tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "subagents-resolver-test-"));
423
- });
424
- afterEach(() => {
425
- fs.rmSync(tmpDir, { recursive: true, force: true });
426
- });
427
-
428
- /** 构造已 initModel 的 ModelConfigService,ctxModel 注入缓存。 */
429
- function makeService(ctxModel: ModelInfo | undefined, registry: ModelRegistryLike = makeRegistry([])): ModelConfigService {
430
- const svc = new ModelConfigService({ agentDir: tmpDir });
431
- svc.initModel({
432
- modelRegistry: registry,
433
- sessionId: "test-session",
434
- ctxModel,
435
- });
436
- return svc;
437
- }
438
-
439
- it("initModel caches ctxModel; resolveModel L3 returns it (no override, no agentConfig.model)", () => {
440
- const main = makeModel({ id: "main-model", provider: "main" });
441
- const svc = makeService(main);
442
-
443
- // 无 override、无 agentConfig.model → 第三层命中缓存的 ctxModel
444
- const r = svc.resolveModel("general-purpose", undefined);
445
- expect(r.model).toBe(main);
446
- });
447
-
448
- it("resolveModel L3 hits cached ctxModel even with agent that has no model in frontmatter", () => {
449
- const main = makeModel({ id: "inherited", provider: "parent" });
450
- const svc = makeService(main);
451
-
452
- // worker.md 无 model frontmatter → 跳过 L2,命中 L3 ctxModel
453
- const r = svc.resolveModel("worker", undefined);
454
- expect(r.model).toBe(main);
455
- });
456
-
457
- it("resolveModel still prefers explicit paramOverride over cached ctxModel (L1 > L3)", () => {
458
- const main = makeModel({ id: "main", provider: "main" });
459
- const explicit = makeModel({ id: "explicit", provider: "p1" });
460
- const svc = makeService(main, makeRegistry([explicit]));
461
-
462
- const r = svc.resolveModel("worker", { model: "p1/explicit" });
463
- expect(r.model.id).toBe("explicit");
464
- });
465
- });