@zhushanwen/pi-subagent-workflow 8.5.0 → 8.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (336) hide show
  1. package/package.json +13 -16
  2. package/relay/relay.mjs +1 -1
  3. package/src/host/__tests__/pi-host.test.ts +214 -0
  4. package/src/host/pi-host.ts +109 -0
  5. package/src/index.ts +142 -32
  6. package/src/injectors/__tests__/engine-awareness.test.ts +292 -0
  7. package/src/injectors/__tests__/engine-section-stability.test.ts +341 -0
  8. package/src/injectors/__tests__/subagent-list-injector.test.ts +5 -5
  9. package/src/injectors/__tests__/workflow-list-injector.test.ts +5 -5
  10. package/src/injectors/engine-awareness.ts +123 -0
  11. package/src/injectors/model-list-injector.ts +1 -1
  12. package/src/injectors/subagent-list-injector.ts +8 -8
  13. package/src/injectors/workflow-list-injector.ts +8 -8
  14. package/src/interface/__tests__/detectors.test.ts +3 -3
  15. package/src/interface/__tests__/subagent-tool-path-guard.test.ts +157 -0
  16. package/src/interface/__tests__/subagent-tool-prompt.test.ts +12 -0
  17. package/src/interface/__tests__/tool-workflow-script-generate.test.ts +2 -2
  18. package/src/interface/__tests__/tool-workflow-throw-paths.test.ts +1 -1
  19. package/src/interface/bg-notify-render.ts +34 -13
  20. package/src/interface/commands.ts +3 -3
  21. package/src/interface/format.ts +2 -2
  22. package/src/interface/helpers.ts +3 -3
  23. package/src/interface/list-component.ts +4 -4
  24. package/src/interface/list-shared.ts +2 -2
  25. package/src/interface/list-view.ts +2 -2
  26. package/src/interface/subagent-actions.ts +288 -19
  27. package/src/interface/subagent-tool-schema.ts +163 -0
  28. package/src/interface/subagent-tool.ts +65 -129
  29. package/src/interface/subagents.ts +5 -5
  30. package/src/interface/tool-render.ts +34 -2
  31. package/src/interface/tool-workflow-script.ts +4 -4
  32. package/src/interface/tool-workflow.ts +6 -6
  33. package/src/interface/views/WorkflowsView.ts +5 -5
  34. package/src/interface/views/__tests__/WorkflowsView-signature.test.ts +3 -3
  35. package/src/interface/views/__tests__/detail-content-session-file.test.ts +2 -2
  36. package/src/interface/views/detail-content.ts +4 -4
  37. package/src/interface/views/format.ts +4 -4
  38. package/src/{orchestration/jsonl-run-store.ts → jsonl-run-store.ts} +132 -18
  39. package/src/execution/__tests__/__fixtures__/notifier-golden-snapshots.json +0 -53
  40. package/src/execution/__tests__/__fixtures__/truncline.snapshot.json +0 -1
  41. package/src/execution/__tests__/agent-registry.test.ts +0 -363
  42. package/src/execution/__tests__/agent-result-mapper.test.ts +0 -150
  43. package/src/execution/__tests__/alive-store.test.ts +0 -147
  44. package/src/execution/__tests__/ask-user-transit-e2e.test.ts +0 -490
  45. package/src/execution/__tests__/before-agent-start-injection.test.ts +0 -132
  46. package/src/execution/__tests__/bg-notify-render.test.ts +0 -256
  47. package/src/execution/__tests__/channel-registry-handshake.test.ts +0 -243
  48. package/src/execution/__tests__/chat-engine-routing.test.ts +0 -597
  49. package/src/execution/__tests__/chatmode-first-round-closure-service.test.ts +0 -365
  50. package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +0 -190
  51. package/src/execution/__tests__/chatmode-round-notify-real-chain.test.ts +0 -215
  52. package/src/execution/__tests__/concurrency-pool.test.ts +0 -250
  53. package/src/execution/__tests__/config.test.ts +0 -110
  54. package/src/execution/__tests__/conversation-wiring.test.ts +0 -198
  55. package/src/execution/__tests__/crash-recovery.test.ts +0 -320
  56. package/src/execution/__tests__/delivery-methods.test.ts +0 -385
  57. package/src/execution/__tests__/dialog-queue.test.ts +0 -299
  58. package/src/execution/__tests__/epipe-fallback.test.ts +0 -241
  59. package/src/execution/__tests__/execute-and-await-worktree.test.ts +0 -243
  60. package/src/execution/__tests__/execute-nesting.test.ts +0 -323
  61. package/src/execution/__tests__/execute-options-mapper.test.ts +0 -189
  62. package/src/execution/__tests__/execution-record.test.ts +0 -1284
  63. package/src/execution/__tests__/finalize-record.test.ts +0 -368
  64. package/src/execution/__tests__/finalized-marker.test.ts +0 -82
  65. package/src/execution/__tests__/format-schema-instruction.test.ts +0 -138
  66. package/src/execution/__tests__/format.test.ts +0 -458
  67. package/src/execution/__tests__/gc-timer.test.ts +0 -184
  68. package/src/execution/__tests__/get-record-for-action-restart.test.ts +0 -254
  69. package/src/execution/__tests__/gui-mode-dispatch.test.ts +0 -59
  70. package/src/execution/__tests__/helpers/mock-extension-api.ts +0 -30
  71. package/src/execution/__tests__/helpers/spawn-mock.ts +0 -238
  72. package/src/execution/__tests__/host-mode.test.ts +0 -87
  73. package/src/execution/__tests__/index-session-start-identity.test.ts +0 -371
  74. package/src/execution/__tests__/index-session-start.test.ts +0 -593
  75. package/src/execution/__tests__/lifecycle-manager-lock.test.ts +0 -211
  76. package/src/execution/__tests__/lifecycle-manager.test.ts +0 -337
  77. package/src/execution/__tests__/lifecycle-predicates.test.ts +0 -116
  78. package/src/execution/__tests__/list-component.test.ts +0 -401
  79. package/src/execution/__tests__/list-fields.test.ts +0 -109
  80. package/src/execution/__tests__/manifest-parentid.test.ts +0 -117
  81. package/src/execution/__tests__/model-resolver.test.ts +0 -413
  82. package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +0 -287
  83. package/src/execution/__tests__/nested-visibility.test.ts +0 -325
  84. package/src/execution/__tests__/notifier-flush.test.ts +0 -574
  85. package/src/execution/__tests__/notifier-golden-snapshot.test.ts +0 -261
  86. package/src/execution/__tests__/one-shot-upgrade.test.ts +0 -205
  87. package/src/execution/__tests__/output-collector.test.ts +0 -61
  88. package/src/execution/__tests__/parent-child-matrix.test.ts +0 -336
  89. package/src/execution/__tests__/path-encoding.test.ts +0 -104
  90. package/src/execution/__tests__/pi-invocation.test.ts +0 -134
  91. package/src/execution/__tests__/record-store.test.ts +0 -1057
  92. package/src/execution/__tests__/records-cwd-isolation.test.ts +0 -91
  93. package/src/execution/__tests__/recursive-visibility-baseline.test.ts +0 -339
  94. package/src/execution/__tests__/recursive-visibility-env.test.ts +0 -273
  95. package/src/execution/__tests__/relay-agent.test.ts +0 -448
  96. package/src/execution/__tests__/relay-env.test.ts +0 -42
  97. package/src/execution/__tests__/resource-policy.test.ts +0 -109
  98. package/src/execution/__tests__/rpc-mode.test.ts +0 -89
  99. package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +0 -267
  100. package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +0 -253
  101. package/src/execution/__tests__/run-spawn-edges.test.ts +0 -644
  102. package/src/execution/__tests__/run-spawn-integration.test.ts +0 -933
  103. package/src/execution/__tests__/run-spawn-resume.test.ts +0 -322
  104. package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +0 -196
  105. package/src/execution/__tests__/sdk-contract.test.ts +0 -273
  106. package/src/execution/__tests__/session-context-resolver.test.ts +0 -167
  107. package/src/execution/__tests__/session-file-gc.test.ts +0 -293
  108. package/src/execution/__tests__/session-pending.test.ts +0 -197
  109. package/src/execution/__tests__/session-reconstructor.test.ts +0 -379
  110. package/src/execution/__tests__/session-runner-epipe.test.ts +0 -178
  111. package/src/execution/__tests__/session-runner-schema-env.test.ts +0 -311
  112. package/src/execution/__tests__/session-start-reaper.test.ts +0 -233
  113. package/src/execution/__tests__/spawn-args.test.ts +0 -434
  114. package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +0 -189
  115. package/src/execution/__tests__/spawn-event-adapter.test.ts +0 -167
  116. package/src/execution/__tests__/spawn-worktree-guidance.test.ts +0 -207
  117. package/src/execution/__tests__/spawned-children.test.ts +0 -92
  118. package/src/execution/__tests__/startup-config-declaration.test.ts +0 -35
  119. package/src/execution/__tests__/status-refactor.test.ts +0 -345
  120. package/src/execution/__tests__/stdin-writer.test.ts +0 -463
  121. package/src/execution/__tests__/stream-sink-retirement.test.ts +0 -261
  122. package/src/execution/__tests__/subagent-service-abort.test.ts +0 -60
  123. package/src/execution/__tests__/subagent-service-message-close.test.ts +0 -629
  124. package/src/execution/__tests__/subagent-service-parent-guard.test.ts +0 -180
  125. package/src/execution/__tests__/subagent-service.test.ts +0 -788
  126. package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +0 -310
  127. package/src/execution/__tests__/subprocess-agent-runner.test.ts +0 -506
  128. package/src/execution/__tests__/temp-prompt.test.ts +0 -53
  129. package/src/execution/__tests__/timeout-integration.test.ts +0 -397
  130. package/src/execution/__tests__/tombstone-store.test.ts +0 -73
  131. package/src/execution/__tests__/tool-action.test.ts +0 -385
  132. package/src/execution/__tests__/truncline-snapshot.test.ts +0 -81
  133. package/src/execution/__tests__/turn-limiter-semantics.test.ts +0 -194
  134. package/src/execution/__tests__/turn-limiter.test.ts +0 -65
  135. package/src/execution/__tests__/ui-channels.test.ts +0 -187
  136. package/src/execution/__tests__/ui-interaction-model.test.ts +0 -67
  137. package/src/execution/__tests__/ui-request-handler-factory.test.ts +0 -370
  138. package/src/execution/__tests__/ui-request-handler.test.ts +0 -204
  139. package/src/execution/__tests__/ui-request-observability.test.ts +0 -114
  140. package/src/execution/__tests__/ui-request-queue.test.ts +0 -133
  141. package/src/execution/__tests__/worktree-manager.test.ts +0 -633
  142. package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +0 -229
  143. package/src/execution/__tests__/worktree-reconcile.integration.test.ts +0 -181
  144. package/src/execution/__tests__/worktree-registry.test.ts +0 -199
  145. package/src/execution/agent-registry.ts +0 -193
  146. package/src/execution/agent-result-mapper.ts +0 -90
  147. package/src/execution/alive-store.ts +0 -92
  148. package/src/execution/argv-mirror.ts +0 -109
  149. package/src/execution/best-effort.ts +0 -38
  150. package/src/execution/channel-registry-access.ts +0 -144
  151. package/src/execution/concurrency-pool.ts +0 -116
  152. package/src/execution/config.ts +0 -96
  153. package/src/execution/dialog-queue.ts +0 -330
  154. package/src/execution/engine/__tests__/common/data-dir.test.ts +0 -53
  155. package/src/execution/engine/__tests__/common/errors.test.ts +0 -132
  156. package/src/execution/engine/__tests__/common/event-journal.test.ts +0 -177
  157. package/src/execution/engine/__tests__/common/kill-chain.test.ts +0 -192
  158. package/src/execution/engine/__tests__/common/nesting-guard.test.ts +0 -81
  159. package/src/execution/engine/__tests__/common/persona-router.test.ts +0 -123
  160. package/src/execution/engine/__tests__/common/pool-manager.test.ts +0 -154
  161. package/src/execution/engine/__tests__/common/schema-emulation.test.ts +0 -128
  162. package/src/execution/engine/__tests__/conformance/__fixtures__/pi-golden-events.json +0 -28
  163. package/src/execution/engine/__tests__/conformance/agent-event-invariants.ts +0 -141
  164. package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +0 -109
  165. package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +0 -101
  166. package/src/execution/engine/__tests__/conformance/contract.probe.test.ts +0 -77
  167. package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +0 -104
  168. package/src/execution/engine/__tests__/conformance/contract.relay.test.ts +0 -342
  169. package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +0 -201
  170. package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +0 -76
  171. package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +0 -79
  172. package/src/execution/engine/__tests__/engine-discovery.test.ts +0 -87
  173. package/src/execution/engine/__tests__/engines-declaration.test.ts +0 -36
  174. package/src/execution/engine/__tests__/model-prompt.test.ts +0 -85
  175. package/src/execution/engine/__tests__/paths.test.ts +0 -39
  176. package/src/execution/engine/__tests__/registry.test.ts +0 -120
  177. package/src/execution/engine/__tests__/routing.test.ts +0 -231
  178. package/src/execution/engine/common/data-dir.ts +0 -62
  179. package/src/execution/engine/common/errors.ts +0 -183
  180. package/src/execution/engine/common/event-journal.ts +0 -254
  181. package/src/execution/engine/common/journal-replay.ts +0 -62
  182. package/src/execution/engine/common/kill-chain.ts +0 -221
  183. package/src/execution/engine/common/nesting-guard.ts +0 -50
  184. package/src/execution/engine/common/persona-router.ts +0 -108
  185. package/src/execution/engine/common/pool-manager.ts +0 -226
  186. package/src/execution/engine/common/schema-emulation.ts +0 -189
  187. package/src/execution/engine/common/session-view-projection.ts +0 -51
  188. package/src/execution/engine/engine-discovery.ts +0 -65
  189. package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +0 -469
  190. package/src/execution/engine/engines/pi/__tests__/reader.test.ts +0 -155
  191. package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
  192. package/src/execution/engine/engines/pi/pi-engine.ts +0 -415
  193. package/src/execution/engine/engines/pi/reader.ts +0 -48
  194. package/src/execution/engine/engines/pi/registration.ts +0 -35
  195. package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
  196. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
  197. package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
  198. package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +0 -246
  199. package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +0 -228
  200. package/src/execution/engine/engines/zcode/__tests__/reader.test.ts +0 -210
  201. package/src/execution/engine/engines/zcode/__tests__/registration.test.ts +0 -64
  202. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +0 -127
  203. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -567
  204. package/src/execution/engine/engines/zcode/constants.ts +0 -43
  205. package/src/execution/engine/engines/zcode/golden-sample.ts +0 -39
  206. package/src/execution/engine/engines/zcode/launcher.ts +0 -161
  207. package/src/execution/engine/engines/zcode/parser.ts +0 -436
  208. package/src/execution/engine/engines/zcode/preparer.ts +0 -363
  209. package/src/execution/engine/engines/zcode/reader.ts +0 -381
  210. package/src/execution/engine/engines/zcode/registration.ts +0 -37
  211. package/src/execution/engine/engines/zcode/zcode-engine.ts +0 -648
  212. package/src/execution/engine/host-task-spec.ts +0 -47
  213. package/src/execution/engine/model-prompt.ts +0 -59
  214. package/src/execution/engine/paths.ts +0 -42
  215. package/src/execution/engine/port.ts +0 -153
  216. package/src/execution/engine/registry.ts +0 -123
  217. package/src/execution/engine/routing.ts +0 -218
  218. package/src/execution/engine/types.ts +0 -304
  219. package/src/execution/execute-options-mapper.ts +0 -111
  220. package/src/execution/execution-record.ts +0 -906
  221. package/src/execution/finalize-record.ts +0 -251
  222. package/src/execution/finalized-marker.ts +0 -51
  223. package/src/execution/get-state-handshake.ts +0 -104
  224. package/src/execution/host-mode.ts +0 -56
  225. package/src/execution/idle-gc.ts +0 -47
  226. package/src/execution/lifecycle-manager.ts +0 -491
  227. package/src/execution/lifecycle-predicates.ts +0 -65
  228. package/src/execution/manifest-store.ts +0 -256
  229. package/src/execution/model-config-service.ts +0 -204
  230. package/src/execution/model-resolver.ts +0 -276
  231. package/src/execution/notifier.ts +0 -260
  232. package/src/execution/output-collector.ts +0 -88
  233. package/src/execution/path-encoding.ts +0 -60
  234. package/src/execution/pi-invocation.ts +0 -120
  235. package/src/execution/record-entry.ts +0 -132
  236. package/src/execution/record-store.ts +0 -1234
  237. package/src/execution/relay-env.ts +0 -37
  238. package/src/execution/session-context-resolver.ts +0 -64
  239. package/src/execution/session-file-gc.ts +0 -120
  240. package/src/execution/session-pending.ts +0 -164
  241. package/src/execution/session-reconstructor.ts +0 -678
  242. package/src/execution/session-runner.ts +0 -1548
  243. package/src/execution/sessions-index.ts +0 -304
  244. package/src/execution/spawn-event-adapter.ts +0 -363
  245. package/src/execution/stdin-writer.ts +0 -198
  246. package/src/execution/stream-sink.ts +0 -126
  247. package/src/execution/subagent-service.ts +0 -2119
  248. package/src/execution/subprocess-agent-runner.ts +0 -303
  249. package/src/execution/temp-prompt.ts +0 -62
  250. package/src/execution/tombstone-store.ts +0 -72
  251. package/src/execution/turn-limiter.ts +0 -102
  252. package/src/execution/types.ts +0 -910
  253. package/src/execution/ui-channels.ts +0 -216
  254. package/src/execution/ui-interaction-model.ts +0 -48
  255. package/src/execution/ui-request-handler-factory.ts +0 -212
  256. package/src/execution/ui-request-observability.ts +0 -81
  257. package/src/execution/ui-request-queue.ts +0 -174
  258. package/src/execution/worktree-manager.ts +0 -688
  259. package/src/execution/worktree-registry.ts +0 -222
  260. package/src/orchestration/__tests__/__fixtures__/worker-template.snapshot.txt +0 -336
  261. package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +0 -208
  262. package/src/orchestration/__tests__/agent-call-stream.test.ts +0 -157
  263. package/src/orchestration/__tests__/args-validator.test.ts +0 -143
  264. package/src/orchestration/__tests__/concurrency-gate.test.ts +0 -125
  265. package/src/orchestration/__tests__/config-loader.test.ts +0 -503
  266. package/src/orchestration/__tests__/error-recovery-handlers.test.ts +0 -724
  267. package/src/orchestration/__tests__/error-recovery-postmessage-defense.test.ts +0 -405
  268. package/src/orchestration/__tests__/error-recovery-serialize-failed-result.test.ts +0 -56
  269. package/src/orchestration/__tests__/error-recovery-workflow-call.test.ts +0 -166
  270. package/src/orchestration/__tests__/execute-agent-call.test.ts +0 -314
  271. package/src/orchestration/__tests__/jsonl-run-store-loadall-sources.test.ts +0 -171
  272. package/src/orchestration/__tests__/jsonl-run-store-session-file.test.ts +0 -1030
  273. package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +0 -277
  274. package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +0 -96
  275. package/src/orchestration/__tests__/lifecycle.test.ts +0 -625
  276. package/src/orchestration/__tests__/review-fix-loop-e2e.test.ts +0 -1971
  277. package/src/orchestration/__tests__/script-lint.test.ts +0 -831
  278. package/src/orchestration/__tests__/skill-discovery.test.ts +0 -157
  279. package/src/orchestration/__tests__/test-mocks.ts +0 -197
  280. package/src/orchestration/__tests__/worker-host.test.ts +0 -120
  281. package/src/orchestration/__tests__/worker-returnmeta-passthrough.test.ts +0 -164
  282. package/src/orchestration/__tests__/worker-script-builder-runtime.test.ts +0 -520
  283. package/src/orchestration/__tests__/worker-script-builder.test.ts +0 -309
  284. package/src/orchestration/__tests__/worker-script-template-snapshot.test.ts +0 -110
  285. package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +0 -317
  286. package/src/orchestration/__tests__/workflow-script-lint-memo.test.ts +0 -110
  287. package/src/orchestration/__tests__/workflows-e2e.test.ts +0 -537
  288. package/src/orchestration/agent-opts-resolver.ts +0 -93
  289. package/src/orchestration/args-validator.ts +0 -127
  290. package/src/orchestration/concurrency-gate.ts +0 -69
  291. package/src/orchestration/config-loader.ts +0 -315
  292. package/src/orchestration/error-recovery.ts +0 -862
  293. package/src/orchestration/execute-agent-call.ts +0 -217
  294. package/src/orchestration/launcher.ts +0 -410
  295. package/src/orchestration/lifecycle.ts +0 -396
  296. package/src/orchestration/models/__tests__/budget.test.ts +0 -367
  297. package/src/orchestration/models/__tests__/trace.test.ts +0 -408
  298. package/src/orchestration/models/agent-call.ts +0 -83
  299. package/src/orchestration/models/budget.ts +0 -148
  300. package/src/orchestration/models/ports.ts +0 -164
  301. package/src/orchestration/models/run-runtime.ts +0 -89
  302. package/src/orchestration/models/run-spec.ts +0 -83
  303. package/src/orchestration/models/run-state.ts +0 -44
  304. package/src/orchestration/models/trace.ts +0 -183
  305. package/src/orchestration/models/types.ts +0 -292
  306. package/src/orchestration/models/workflow-run.ts +0 -254
  307. package/src/orchestration/models/workflow-script-registry.ts +0 -35
  308. package/src/orchestration/models/workflow-script.ts +0 -117
  309. package/src/orchestration/script-lint.ts +0 -766
  310. package/src/orchestration/skill-discovery.ts +0 -92
  311. package/src/orchestration/worker-handle.ts +0 -115
  312. package/src/orchestration/worker-host.ts +0 -98
  313. package/src/orchestration/worker-script-builder.ts +0 -408
  314. package/src/orchestration/workflow-files.ts +0 -85
  315. package/src/orchestration/workflow-script-registry-impl.ts +0 -133
  316. package/src/shared/__tests__/agent-ref.test.ts +0 -34
  317. package/src/shared/__tests__/meta-parser.test.ts +0 -304
  318. package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -280
  319. package/src/shared/__tests__/resource-discovery.test.ts +0 -736
  320. package/src/shared/__tests__/resource-meta.test.ts +0 -51
  321. package/src/shared/__tests__/schema-jsonify.test.ts +0 -81
  322. package/src/shared/agent-event.ts +0 -13
  323. package/src/shared/agent-ref.ts +0 -57
  324. package/src/shared/meta-parser.ts +0 -261
  325. package/src/shared/resource-discovery.ts +0 -811
  326. package/src/shared/resource-meta.ts +0 -65
  327. package/src/shared/schema-jsonify.ts +0 -56
  328. package/src/shared/xml-injection.ts +0 -35
  329. package/workflows/README.md +0 -81
  330. package/workflows/_shared/agent-refs.cjs +0 -40
  331. package/workflows/chain.js +0 -131
  332. package/workflows/map-reduce.js +0 -174
  333. package/workflows/parallel.js +0 -148
  334. package/workflows/review-fix-loop-utils.cjs +0 -1307
  335. package/workflows/review-fix-loop.js +0 -1396
  336. package/workflows/scatter-gather.js +0 -178
@@ -1,434 +0,0 @@
1
- // src/__tests__/spawn-args.test.ts
2
- import { spawnSync } from "node:child_process";
3
- import * as fs from "node:fs";
4
- import * as os from "node:os";
5
- import * as path from "node:path";
6
-
7
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
8
-
9
- import { mirrorMainProcessFlags } from "../argv-mirror.ts";
10
- import { MAX_FORK_DEPTH } from "../session-context-resolver.ts";
11
- import { buildEnvBlock, buildSpawnArgs } from "../session-runner.ts";
12
-
13
- describe("buildSpawnArgs", () => {
14
- const baseParams = {
15
- model: undefined as string | undefined,
16
- thinkingLevel: undefined as string | undefined,
17
- agentTools: undefined as string[] | undefined,
18
- appendSystemPromptPath: undefined as string | undefined,
19
- sessionDir: "/sessions/dir",
20
- forkSource: undefined as string | undefined,
21
- skillPaths: undefined as string[] | undefined,
22
- };
23
-
24
- it("基础参数:--mode rpc --session-dir,不含 -p 也不含 task(task 经 stdin 传)", () => {
25
- const args = buildSpawnArgs(baseParams);
26
- expect(args).toEqual(["--mode", "rpc", "--session-dir", "/sessions/dir"]);
27
- });
28
-
29
- it("不含 -p / --print(rpc mode 下 -p 被 resolveAppMode 无视,是死代码)", () => {
30
- const args = buildSpawnArgs(baseParams);
31
- expect(args).not.toContain("-p");
32
- expect(args).not.toContain("--print");
33
- });
34
-
35
- it("有 model → 追加 --model provider/id", () => {
36
- const args = buildSpawnArgs(
37
- { ...baseParams, model: "openai/gpt-4o" },
38
- );
39
- expect(args).toContain("--model");
40
- const idx = args.indexOf("--model");
41
- expect(args[idx + 1]).toBe("openai/gpt-4o");
42
- });
43
-
44
- it("model + thinkingLevel → model 后缀 :level", () => {
45
- const args = buildSpawnArgs(
46
- { ...baseParams, model: "anthropic/claude", thinkingLevel: "high" },
47
- );
48
- const idx = args.indexOf("--model");
49
- expect(args[idx + 1]).toBe("anthropic/claude:high");
50
- });
51
-
52
- it("thinkingLevel 无 model → 不追加(thinking 依赖 model 后缀)", () => {
53
- const args = buildSpawnArgs(
54
- { ...baseParams, model: undefined, thinkingLevel: "high" },
55
- );
56
- expect(args).not.toContain("--model");
57
- });
58
-
59
- it("agentTools → --tools 逗号分隔", () => {
60
- const args = buildSpawnArgs(
61
- { ...baseParams, agentTools: ["read", "bash", "edit"] },
62
- );
63
- const idx = args.indexOf("--tools");
64
- expect(args[idx + 1]).toBe("read,bash,edit");
65
- });
66
-
67
- it("appendSystemPromptPath → --append-system-prompt <path>", () => {
68
- const args = buildSpawnArgs(
69
- { ...baseParams, appendSystemPromptPath: "/tmp/prompt.md" },
70
- );
71
- const idx = args.indexOf("--append-system-prompt");
72
- expect(args[idx + 1]).toBe("/tmp/prompt.md");
73
- });
74
-
75
- it("forkSource → --fork <path>", () => {
76
- const args = buildSpawnArgs(
77
- { ...baseParams, forkSource: "/sessions/parent.jsonl" },
78
- );
79
- const idx = args.indexOf("--fork");
80
- expect(args[idx + 1]).toBe("/sessions/parent.jsonl");
81
- });
82
-
83
- it("skillPaths 多个 → 每个 push --skill <path>", () => {
84
- const args = buildSpawnArgs(
85
- { ...baseParams, skillPaths: ["/skills/a", "/skills/b", "/skills/c"] },
86
- );
87
- // 三个 --skill token,后跟各自路径,顺序保留
88
- const skillIdxs = args
89
- .map((a, i) => (a === "--skill" ? i : -1))
90
- .filter((i) => i >= 0);
91
- expect(skillIdxs).toHaveLength(3);
92
- expect(args[skillIdxs[0] + 1]).toBe("/skills/a");
93
- expect(args[skillIdxs[1] + 1]).toBe("/skills/b");
94
- expect(args[skillIdxs[2] + 1]).toBe("/skills/c");
95
- });
96
-
97
- it("skillPaths 空数组 → 不含 --skill", () => {
98
- const args = buildSpawnArgs(
99
- { ...baseParams, skillPaths: [] },
100
- );
101
- expect(args).not.toContain("--skill");
102
- });
103
-
104
- it("skillPaths undefined → 不含 --skill", () => {
105
- const args = buildSpawnArgs(baseParams);
106
- expect(args).not.toContain("--skill");
107
- });
108
-
109
- it("全参数组合:所有 flag 存在,不含 -p 也不含 positional task", () => {
110
- const args = buildSpawnArgs(
111
- {
112
- model: "openai/gpt-4o",
113
- thinkingLevel: "low",
114
- agentTools: ["read"],
115
- appendSystemPromptPath: "/tmp/p.md",
116
- sessionDir: "/s",
117
- forkSource: "/parent.jsonl",
118
- skillPaths: ["/skills/x"],
119
- },
120
- );
121
- // 末尾应是最后一个 --skill 的路径(task 不再作为 positional arg 出现)
122
- expect(args[args.length - 1]).toBe("/skills/x");
123
- expect(args).toContain("--fork");
124
- expect(args).toContain("--tools");
125
- expect(args).toContain("--skill");
126
- expect(args).not.toContain("-p");
127
- });
128
-
129
- it("空 tools 数组不追加 --tools", () => {
130
- const args = buildSpawnArgs(
131
- { ...baseParams, agentTools: [] },
132
- );
133
- expect(args).not.toContain("--tools");
134
- });
135
-
136
- it("含未注册扩展工具名(如 ask_user)正常透传 — 子进程 Pi 静默忽略未注册的 allowlist 项", () => {
137
- // 场景:orchestrator 模板声明了 ask_user,但用户环境未装 pi-ask-user 扩展。
138
- // 期望:subagent-workflow 不做特殊处理,仅原样透传给 pi CLI;
139
- // 静默兼容的责任在 Pi(args.ts 不校验、agent-session 的 _rebuildSystemPrompt
140
- // 对未注册工具名静默过滤)。本测试钉死这个透传行为,避免有人擅自加
141
- // 「未注册工具检测」导致原本兼容的场景崩溃。
142
- const args = buildSpawnArgs({
143
- ...baseParams,
144
- agentTools: ["todo", "goal_control", "workflow", "subagent", "ask_user"],
145
- });
146
- const idx = args.indexOf("--tools");
147
- expect(idx).toBeGreaterThanOrEqual(0);
148
- expect(args[idx + 1]).toBe(
149
- "todo,goal_control,workflow,subagent,ask_user",
150
- );
151
- });
152
-
153
- // ============================================================
154
- // mirrorFlags 透传:子进程镜像主进程 extension/approve flag
155
- // ============================================================
156
-
157
- it("mirrorFlags 透传:noExtensions+approve+noContextFiles+extensionPaths 全量 push(TC5)", () => {
158
- const args = buildSpawnArgs({
159
- ...baseParams,
160
- mirrorFlags: { noExtensions: true, approve: true, noContextFiles: true, extensionPaths: ["/e1", "/e2"] },
161
- });
162
- expect(args).toContain("--no-extensions");
163
- expect(args).toContain("--approve");
164
- expect(args).toContain("--no-context-files");
165
- // 每个 extension 独立 token,顺序保留
166
- const extIdxs = args.map((a, i) => (a === "--extension" ? i : -1)).filter((i) => i >= 0);
167
- expect(extIdxs).toHaveLength(2);
168
- expect(args[extIdxs[0] + 1]).toBe("/e1");
169
- expect(args[extIdxs[1] + 1]).toBe("/e2");
170
- });
171
-
172
- it("mirrorFlags 全 false/空 → 不追加任何目标 flag(TC6)", () => {
173
- const args = buildSpawnArgs({
174
- ...baseParams,
175
- mirrorFlags: { noExtensions: false, approve: false, noContextFiles: false, extensionPaths: [] },
176
- });
177
- expect(args).not.toContain("--no-extensions");
178
- expect(args).not.toContain("--approve");
179
- expect(args).not.toContain("--extension");
180
- expect(args).not.toContain("--no-context-files");
181
- // 仅基础参数
182
- expect(args).toEqual(["--mode", "rpc", "--session-dir", "/sessions/dir"]);
183
- });
184
-
185
- it("mirrorFlags undefined → 行为等同旧版(TC7)", () => {
186
- const args = buildSpawnArgs(baseParams);
187
- expect(args).toEqual(["--mode", "rpc", "--session-dir", "/sessions/dir"]);
188
- expect(args).not.toContain("--extension");
189
- expect(args).not.toContain("--no-extensions");
190
- expect(args).not.toContain("--approve");
191
- expect(args).not.toContain("--no-context-files");
192
- });
193
-
194
- it("noContextFiles 镜像:主进程 argv 含 --no-context-files → 子进程 args 含该 flag", () => {
195
- // 端到端链路断言:主 pi 进程以 --no-context-files 启动(用户 opt-out context files)
196
- // → mirrorMainProcessFlags 解析 → buildSpawnArgs 产出同 flag 给每个 subagent。
197
- // 缺此镜像时,--extension 镜像带入的 @zhushanwen/pi-system-prompt 检查子进程
198
- // 自己的 argv(无 flag)→ 全局 AGENTS.md 注入在 subagent system prompt 照常生效,
199
- // 用户 opt-out 被绕过。
200
- const mainArgv = [
201
- "bun", "/pi", "--mode", "rpc", "--no-context-files",
202
- "--extension", "/staged/@zhushanwen/pi-system-prompt/index.js",
203
- ];
204
- const args = buildSpawnArgs({ ...baseParams, mirrorFlags: mirrorMainProcessFlags(mainArgv) });
205
- expect(args).toContain("--no-context-files");
206
- // extension 镜像照常(两者共存才构成完整契约)
207
- const extIdx = args.indexOf("--extension");
208
- expect(args[extIdx + 1]).toBe("/staged/@zhushanwen/pi-system-prompt/index.js");
209
- });
210
-
211
- it("noContextFiles 不镜像:主进程 argv 不含 flag → 子进程 args 不含(默认行为不变)", () => {
212
- const mainArgv = ["bun", "/pi", "--mode", "rpc"];
213
- const args = buildSpawnArgs({ ...baseParams, mirrorFlags: mirrorMainProcessFlags(mainArgv) });
214
- expect(args).not.toContain("--no-context-files");
215
- });
216
-
217
- // ============================================================
218
- // sessionFile(M1 resume 基建):--session <file> 紧跟 --session-dir
219
- // ============================================================
220
-
221
- it("sessionFile 存在 → 紧跟 --session-dir 追加 --session <file>", () => {
222
- const args = buildSpawnArgs({
223
- ...baseParams,
224
- sessionFile: "/sessions/sub/abc.jsonl",
225
- });
226
- const idx = args.indexOf("--session");
227
- expect(idx).toBeGreaterThan(-1);
228
- expect(args[idx + 1]).toBe("/sessions/sub/abc.jsonl");
229
- // 位置紧跟 --session-dir <dir> 之后(--model 之前)
230
- const sessionDirIdx = args.indexOf("--session-dir");
231
- expect(idx).toBe(sessionDirIdx + 2);
232
- });
233
-
234
- it("sessionFile undefined → 不含 --session(向后兼容)", () => {
235
- const args = buildSpawnArgs(baseParams);
236
- expect(args).not.toContain("--session");
237
- expect(args).toEqual(["--mode", "rpc", "--session-dir", "/sessions/dir"]);
238
- });
239
-
240
- it("sessionFile + model + thinkingLevel → 三者都进 args(resume 全参数)", () => {
241
- const args = buildSpawnArgs({
242
- ...baseParams,
243
- sessionFile: "/sessions/sub/resume.jsonl",
244
- model: "anthropic/claude",
245
- thinkingLevel: "high",
246
- });
247
- // --session <file>
248
- const sessionIdx = args.indexOf("--session");
249
- expect(sessionIdx).toBeGreaterThan(-1);
250
- expect(args[sessionIdx + 1]).toBe("/sessions/sub/resume.jsonl");
251
- // --model provider/id:level(thinkingLevel 作 model 后缀)
252
- const modelIdx = args.indexOf("--model");
253
- expect(modelIdx).toBeGreaterThan(-1);
254
- expect(args[modelIdx + 1]).toBe("anthropic/claude:high");
255
- });
256
- });
257
-
258
- // ============================================================
259
- // mirrorMainProcessFlags:从主进程 argv 解析可镜像的 flag
260
- // ============================================================
261
-
262
- describe("mirrorMainProcessFlags", () => {
263
- it("--extension 多次出现(空格分隔)+ 布尔 flag(TC1)", () => {
264
- const r = mirrorMainProcessFlags([
265
- "bun", "/pi", "--mode", "rpc", "--no-extensions", "--approve",
266
- "--extension", "/a", "--extension", "/b",
267
- ]);
268
- expect(r).toEqual({ noExtensions: true, approve: true, extensionPaths: ["/a", "/b"], noContextFiles: false });
269
- });
270
-
271
- it("--extension=path 等号形式 + 短形式 -e/-ne/-a(TC2)", () => {
272
- const r = mirrorMainProcessFlags([
273
- "bun", "/pi", "--extension=/x", "-ne", "-a",
274
- ]);
275
- expect(r).toEqual({ noExtensions: true, approve: true, extensionPaths: ["/x"], noContextFiles: false });
276
- });
277
-
278
- it("混合形式(空格 + 等号),顺序保留(TC3)", () => {
279
- const r = mirrorMainProcessFlags([
280
- "bun", "/pi", "--extension", "/a", "--extension=/b", "--extension", "/c",
281
- ]);
282
- expect(r.extensionPaths).toEqual(["/a", "/b", "/c"]);
283
- expect(r.noExtensions).toBe(false);
284
- expect(r.approve).toBe(false);
285
- expect(r.noContextFiles).toBe(false);
286
- });
287
-
288
- it("无目标 flag → 全空/全 false(向后兼容,TC4)", () => {
289
- const r = mirrorMainProcessFlags(["bun", "/pi", "--mode", "rpc"]);
290
- expect(r).toEqual({ noExtensions: false, approve: false, extensionPaths: [], noContextFiles: false });
291
- });
292
-
293
- it("--no-context-files 长形式解析 → noContextFiles: true", () => {
294
- const r = mirrorMainProcessFlags([
295
- "bun", "/pi", "--mode", "rpc", "--no-context-files",
296
- "--extension", "/staged/@zhushanwen/pi-system-prompt/index.js",
297
- ]);
298
- expect(r.noContextFiles).toBe(true);
299
- // 与 extension 镜像共存(实际 xyz-agent 启动形态:两 flag 同时出现)
300
- expect(r.extensionPaths).toEqual(["/staged/@zhushanwen/pi-system-prompt/index.js"]);
301
- expect(r.noExtensions).toBe(false);
302
- expect(r.approve).toBe(false);
303
- });
304
-
305
- it("-nc 短形式解析 → noContextFiles: true(pi CLI 等价短形式)", () => {
306
- const r = mirrorMainProcessFlags(["bun", "/pi", "--mode", "rpc", "-nc"]);
307
- expect(r.noContextFiles).toBe(true);
308
- });
309
-
310
- it("不误吃其他 flag 值与 positional 参数(TC8)", () => {
311
- const r = mirrorMainProcessFlags([
312
- "bun", "/pi", "--no-extensions", "--skill", "/sk", "some prompt text",
313
- ]);
314
- expect(r.noExtensions).toBe(true);
315
- expect(r.extensionPaths).toEqual([]);
316
- // --skill 的 /sk 不混入 extensionPaths;positional prompt 被忽略
317
- });
318
-
319
- it("空 argv / 仅前导两项 → 全空", () => {
320
- expect(mirrorMainProcessFlags([])).toEqual({ noExtensions: false, approve: false, extensionPaths: [], noContextFiles: false });
321
- expect(mirrorMainProcessFlags(["bun", "/pi"])).toEqual({
322
- noExtensions: false, approve: false, extensionPaths: [], noContextFiles: false,
323
- });
324
- });
325
-
326
- it("--extension 末尾无值 → 跳过(不越界、不误吃下一个 token)", () => {
327
- const r = mirrorMainProcessFlags(["bun", "/pi", "--extension"]);
328
- expect(r.extensionPaths).toEqual([]);
329
- });
330
-
331
- it("-e 短形式多次 + 等号混用", () => {
332
- const r = mirrorMainProcessFlags(["bun", "/pi", "-e", "/a", "-e=/b", "-e", "/c"]);
333
- expect(r.extensionPaths).toEqual(["/a", "/b", "/c"]);
334
- });
335
- });
336
-
337
- // ============================================================
338
- // buildEnvBlock(M1 恢复)
339
- // ============================================================
340
-
341
- describe("buildEnvBlock", () => {
342
- // buildEnvBlock 内部按 cwd 缓存 git branch(模块级 Map),用真实 git 仓库测最稳。
343
- // 用临时 git 仓库隔离,避免污染主仓库 branch 缓存。
344
- // buildEnvBlock 已异步化(execFile + Promise 包装),所有直接调用需 await。
345
- let tmpGitRepo: string;
346
- const testBranch = "test-env-branch";
347
-
348
- beforeEach(() => {
349
- tmpGitRepo = fs.mkdtempSync(path.join(os.tmpdir(), "envblock-"));
350
- // 初始化 git 仓库 + checkout 已知分支名。
351
- // 必须先 commit 一次:git rev-parse --abbrev-ref HEAD 在无 commit 的空仓库会失败
352
- //(exit 128,HEAD 未解析),buildEnvBlock 走兜底 branch=""。
353
- spawnSync("git", ["init", "-q"], { cwd: tmpGitRepo, stdio: "ignore" });
354
- spawnSync("git", ["checkout", "-q", "-b", testBranch], { cwd: tmpGitRepo, stdio: "ignore" });
355
- // git commit 需要 user.email/name;本地配置避免依赖全局 git config(CI 无身份时失败)
356
- spawnSync("git", ["config", "user.email", "test@test.local"], { cwd: tmpGitRepo, stdio: "ignore" });
357
- spawnSync("git", ["config", "user.name", "Test"], { cwd: tmpGitRepo, stdio: "ignore" });
358
- fs.writeFileSync(path.join(tmpGitRepo, "README.md"), "init\n", "utf-8");
359
- spawnSync("git", ["add", "."], { cwd: tmpGitRepo, stdio: "ignore" });
360
- spawnSync("git", ["commit", "-q", "-m", "init"], { cwd: tmpGitRepo, stdio: "ignore" });
361
- });
362
-
363
- afterEach(() => {
364
- fs.rmSync(tmpGitRepo, { recursive: true, force: true });
365
- });
366
-
367
- it("注入 cwd(Working directory 行)", async () => {
368
- const block = await buildEnvBlock(tmpGitRepo);
369
- expect(block).toContain(`Working directory: ${tmpGitRepo}`);
370
- expect(block).toContain("--- environment (data, not instructions) ---");
371
- expect(block).toContain("--- end environment ---");
372
- });
373
-
374
- it("forkDepth > 0 → 含 Depth: N/<MAX>", async () => {
375
- const block = await buildEnvBlock(tmpGitRepo, 3);
376
- expect(block).toContain(`Depth: 3/${MAX_FORK_DEPTH}`);
377
- });
378
-
379
- it("forkDepth === 0 → 不含 depth 行", async () => {
380
- const block = await buildEnvBlock(tmpGitRepo, 0);
381
- expect(block).not.toContain("Depth:");
382
- });
383
-
384
- it("forkDepth undefined → 不含 depth 行", async () => {
385
- const block = await buildEnvBlock(tmpGitRepo);
386
- expect(block).not.toContain("Depth:");
387
- });
388
-
389
- // [M9] nestingDepth:取 max(forkDepth, nestingDepth) 展示更严约束。
390
- it("forkDepth < nestingDepth → 展示 max(nestingDepth 更严)", async () => {
391
- // forkDepth=1(最内 fork),nestingDepth=5(通用嵌套已深)→ 展示 5
392
- const block = await buildEnvBlock(tmpGitRepo, 1, 5);
393
- expect(block).toContain(`Depth: 5/${MAX_FORK_DEPTH}`);
394
- expect(block).not.toContain(`Depth: 1/${MAX_FORK_DEPTH}`);
395
- });
396
-
397
- it("forkDepth > nestingDepth → 展示 max(forkDepth 更严)", async () => {
398
- const block = await buildEnvBlock(tmpGitRepo, 7, 2);
399
- expect(block).toContain(`Depth: 7/${MAX_FORK_DEPTH}`);
400
- });
401
-
402
- it("forkDepth=0 + nestingDepth>0 → 展示 nestingDepth(非 fork 嵌套也计入)", async () => {
403
- // 非 fork 但有嵌套(如顶层 → 子 → 孙),nestingDepth=2 应展示
404
- const block = await buildEnvBlock(tmpGitRepo, undefined, 2);
405
- expect(block).toContain(`Depth: 2/${MAX_FORK_DEPTH}`);
406
- });
407
-
408
- it("git branch 存在 → 含 Git branch 行", async () => {
409
- const block = await buildEnvBlock(tmpGitRepo);
410
- expect(block).toContain(`Git branch: ${testBranch}`);
411
- });
412
-
413
- it("非 git 目录 → 不含 Git branch 行(git 失败兜底空串)", async () => {
414
- const nonGitDir = fs.mkdtempSync(path.join(os.tmpdir(), "envblock-nogit-"));
415
- try {
416
- const block = await buildEnvBlock(nonGitDir);
417
- expect(block).not.toContain("Git branch:");
418
- // 但仍含 working directory(环境块始终输出)
419
- expect(block).toContain(`Working directory: ${nonGitDir}`);
420
- } finally {
421
- fs.rmSync(nonGitDir, { recursive: true, force: true });
422
- }
423
- });
424
-
425
- it("git 失败(execFile err 回调)→ 不崩,静默省略 branch", async () => {
426
- // 旧版 spy 挂在测试本地对象字面量上(同名同步 git API 的对象包装),从未真正拦截
427
- // session-runner 的模块绑定——此前通过是靠 /some/cwd 不存在使真实 git 失败的副作用。
428
- // 异步化后改为显式用不存在的 cwd 触发 execFile err 回调(err → reject → catch →
429
- // branch=""),覆盖同一条失败路径,断言不变。
430
- const block = await buildEnvBlock("/some/cwd");
431
- expect(block).not.toContain("Git branch:");
432
- expect(block).toContain("Working directory: /some/cwd");
433
- });
434
- });
@@ -1,189 +0,0 @@
1
- // src/__tests__/spawn-event-adapter-rpc.test.ts
2
- //
3
- // W1 红灯测试:spawn-event-adapter.ts 协议层重写 — Pi 原生格式 + method 平铺。
4
- //
5
- // 测试对象:extensions/universal/subagent-workflow/src/execution/spawn-event-adapter.ts(改造)
6
- // 契约来源:.fix-plans/00-master-summary.md §二(统一接口契约)+ §一冲突 2/判定顺序
7
- //
8
- // 核心改动:
9
- // 1. isExtensionUiRequest 重写:判 type==="extension_ui_request" + id:string + method:string
10
- // (删 jsonrpc==="2.0" 守卫 + params 守卫 — Pi 原生格式是平铺字段)
11
- // 2. extension_ui_request 分支:从 {id, params:Record} 改为 {id, request: ExtensionUiRequest}
12
- // request 按 method 平铺(title/options/message/... 与 Pi rpc-types.ts 1:1)
13
- // 3. isRpcResponse 重写:判 type==="response" + command:string + success:boolean(SR-1 根因 1b)
14
- // 4. 判定顺序:isExtensionUiRequest 必须在 event 分支之前(否则被 typeof obj.type===string 吞)
15
- //
16
- // 红灯原因:spawn-event-adapter.ts 当前用旧 JSON-RPC 2.0 守卫,对 Pi 原生格式样本
17
- // 无法识别为 extension_ui_request(会落到 event 分支)。改造后这些断言才绿。
18
-
19
- import { describe, expect, it } from "vitest";
20
-
21
- import { parseSpawnLine } from "../spawn-event-adapter.ts";
22
-
23
- // ── Pi 原生协议样本构造(来源:rpc-types.ts L230-265 真实类型) ──────────
24
- // 10 种 method,全部 {type:"extension_ui_request", id, method, ...平铺字段}。
25
- // 注意:无 jsonrpc 字段、无 params 包裹、method 在顶层(非 method:"extension_ui_request")。
26
-
27
- function piLine(methodFields: Record<string, unknown>): string {
28
- return JSON.stringify({ type: "extension_ui_request", id: "req-001", ...methodFields });
29
- }
30
-
31
- describe("parseSpawnLine — 10 种 method 真实样本分类(Pi 原生格式)", () => {
32
- describe("dialog 类(select/confirm/input/editor)", () => {
33
- it("select → kind=extension_ui_request + request.method=select + title/options 平铺", () => {
34
- const result = parseSpawnLine(piLine({
35
- method: "select", title: "Pick one", options: ["a", "b"], timeout: 30000,
36
- }));
37
- expect(result?.kind).toBe("extension_ui_request");
38
- if (result?.kind !== "extension_ui_request") return;
39
- expect(result.id).toBe("req-001");
40
- expect(result.request.method).toBe("select");
41
- expect(result.request.title).toBe("Pick one");
42
- expect(result.request.options).toEqual(["a", "b"]);
43
- });
44
-
45
- it("confirm → request.method=confirm + title/message 平铺", () => {
46
- const result = parseSpawnLine(piLine({
47
- method: "confirm", title: "Sure?", message: "Proceed?", timeout: 10000,
48
- }));
49
- expect(result?.kind).toBe("extension_ui_request");
50
- if (result?.kind !== "extension_ui_request") return;
51
- expect(result.request.method).toBe("confirm");
52
- expect(result.request.title).toBe("Sure?");
53
- expect(result.request.message).toBe("Proceed?");
54
- });
55
-
56
- it("input → request.method=input + title + placeholder", () => {
57
- const result = parseSpawnLine(piLine({
58
- method: "input", title: "Name", placeholder: "type here",
59
- }));
60
- expect(result?.kind).toBe("extension_ui_request");
61
- if (result?.kind !== "extension_ui_request") return;
62
- expect(result.request.method).toBe("input");
63
- expect(result.request.placeholder).toBe("type here");
64
- });
65
-
66
- it("editor → request.method=editor + title + prefill", () => {
67
- const result = parseSpawnLine(piLine({
68
- method: "editor", title: "Edit", prefill: "initial text",
69
- }));
70
- expect(result?.kind).toBe("extension_ui_request");
71
- if (result?.kind !== "extension_ui_request") return;
72
- expect(result.request.method).toBe("editor");
73
- expect(result.request.prefill).toBe("initial text");
74
- });
75
- });
76
-
77
- describe("fire-and-forget 类(notify/setStatus/setWidget/setTitle/set_editor_text)", () => {
78
- it("notify → request.method=notify + message + notifyType", () => {
79
- const result = parseSpawnLine(piLine({
80
- method: "notify", message: "hi", notifyType: "info",
81
- }));
82
- expect(result?.kind).toBe("extension_ui_request");
83
- if (result?.kind !== "extension_ui_request") return;
84
- expect(result.request.method).toBe("notify");
85
- expect(result.request.message).toBe("hi");
86
- });
87
-
88
- it("setStatus → request.method=setStatus + statusKey/statusText", () => {
89
- const result = parseSpawnLine(piLine({
90
- method: "setStatus", statusKey: "k", statusText: "running",
91
- }));
92
- expect(result?.kind).toBe("extension_ui_request");
93
- if (result?.kind !== "extension_ui_request") return;
94
- expect(result.request.method).toBe("setStatus");
95
- expect(result.request.statusKey).toBe("k");
96
- });
97
-
98
- it("setWidget → request.method=setWidget + widgetKey/widgetLines/widgetPlacement", () => {
99
- const result = parseSpawnLine(piLine({
100
- method: "setWidget", widgetKey: "w1",
101
- widgetLines: ["line1"], widgetPlacement: "aboveEditor",
102
- }));
103
- expect(result?.kind).toBe("extension_ui_request");
104
- if (result?.kind !== "extension_ui_request") return;
105
- expect(result.request.method).toBe("setWidget");
106
- expect(result.request.widgetKey).toBe("w1");
107
- expect(result.request.widgetPlacement).toBe("aboveEditor");
108
- });
109
-
110
- it("setTitle → request.method=setTitle + title", () => {
111
- const result = parseSpawnLine(piLine({ method: "setTitle", title: "My Title" }));
112
- expect(result?.kind).toBe("extension_ui_request");
113
- if (result?.kind !== "extension_ui_request") return;
114
- expect(result.request.method).toBe("setTitle");
115
- expect(result.request.title).toBe("My Title");
116
- });
117
-
118
- it("set_editor_text → request.method=set_editor_text + text", () => {
119
- const result = parseSpawnLine(piLine({ method: "set_editor_text", text: "body" }));
120
- expect(result?.kind).toBe("extension_ui_request");
121
- if (result?.kind !== "extension_ui_request") return;
122
- expect(result.request.method).toBe("set_editor_text");
123
- expect(result.request.text).toBe("body");
124
- });
125
- });
126
- });
127
-
128
- describe("parseSpawnLine — 旧 JSON-RPC 2.0 格式不再被识别(守卫已删)", () => {
129
- it("jsonrpc+method:extension_ui_request+params 旧格式 → 不归类为 extension_ui_request", () => {
130
- // 旧格式(错误假设):会被识别为 event 或 invalid,因为新守卫不认 jsonrpc
131
- const oldFormat = JSON.stringify({
132
- jsonrpc: "2.0", id: "x", method: "extension_ui_request", params: { foo: "bar" },
133
- });
134
- const result = parseSpawnLine(oldFormat);
135
- // 旧格式的 method 字段值是 "extension_ui_request",无 type 字段 → invalid
136
- // (这是有意的:强制对齐 Pi 原生格式)
137
- expect(result?.kind).not.toBe("extension_ui_request");
138
- });
139
- });
140
-
141
- describe("parseSpawnLine — 判定顺序:isExtensionUiRequest 先于 event 分支", () => {
142
- it("extension_ui_request 不被 typeof obj.type===string 吞为 event", () => {
143
- // 关键 bug:extension_ui_request 有 type 字段,若 event 分支在前会被当 event
144
- const result = parseSpawnLine(piLine({ method: "notify", message: "x" }));
145
- // 必须是 extension_ui_request,不能是 event
146
- expect(result?.kind).toBe("extension_ui_request");
147
- expect(result?.kind).not.toBe("event");
148
- });
149
- });
150
-
151
- describe("parseSpawnLine — RPC response(isRpcResponse 重写,SR-1 根因 1b)", () => {
152
- it("Pi response 格式 {type:response, command, success} → kind=response", () => {
153
- const result = parseSpawnLine(JSON.stringify({
154
- type: "response", id: "r1", command: "run_tool", success: true,
155
- }));
156
- expect(result?.kind).toBe("response");
157
- if (result?.kind !== "response") return;
158
- expect(result.id).toBe("r1");
159
- expect(result.command).toBe("run_tool");
160
- expect(result.success).toBe(true);
161
- });
162
-
163
- it("Pi response 失败 {type:response, command, success:false, error}", () => {
164
- const result = parseSpawnLine(JSON.stringify({
165
- type: "response", command: "run_tool", success: false, error: "boom",
166
- }));
167
- expect(result?.kind).toBe("response");
168
- if (result?.kind !== "response") return;
169
- expect(result.success).toBe(false);
170
- expect(result.error).toBe("boom");
171
- });
172
-
173
- it("response 含 data 字段 → 保留", () => {
174
- const result = parseSpawnLine(JSON.stringify({
175
- type: "response", command: "read", success: true, data: { out: 42 },
176
- }));
177
- expect(result?.kind).toBe("response");
178
- if (result?.kind !== "response") return;
179
- expect(result.data).toEqual({ out: 42 });
180
- });
181
-
182
- it("旧 JSON-RPC 2.0 response(jsonrpc+id+result)→ 不再归类为 response", () => {
183
- const oldRpc = JSON.stringify({
184
- jsonrpc: "2.0", id: "x", result: { answers: [] },
185
- });
186
- const result = parseSpawnLine(oldRpc);
187
- expect(result?.kind).not.toBe("response");
188
- });
189
- });