@zhushanwen/pi-subagent-workflow 8.6.0 → 8.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +9 -13
- package/relay/relay.mjs +1 -1
- package/src/host/__tests__/pi-host.test.ts +214 -0
- package/src/host/pi-host.ts +109 -0
- package/src/index.ts +89 -32
- package/src/injectors/__tests__/engine-awareness.test.ts +292 -0
- package/src/injectors/__tests__/engine-section-stability.test.ts +341 -0
- package/src/injectors/__tests__/subagent-list-injector.test.ts +5 -5
- package/src/injectors/__tests__/workflow-list-injector.test.ts +5 -5
- package/src/injectors/engine-awareness.ts +123 -0
- package/src/injectors/model-list-injector.ts +1 -1
- package/src/injectors/subagent-list-injector.ts +8 -8
- package/src/injectors/workflow-list-injector.ts +8 -8
- package/src/interface/__tests__/detectors.test.ts +3 -3
- package/src/interface/__tests__/subagent-tool-path-guard.test.ts +2 -2
- package/src/interface/__tests__/tool-workflow-script-generate.test.ts +2 -2
- package/src/interface/__tests__/tool-workflow-throw-paths.test.ts +1 -1
- package/src/interface/bg-notify-render.ts +4 -4
- package/src/interface/commands.ts +3 -3
- package/src/interface/format.ts +2 -2
- package/src/interface/helpers.ts +1 -1
- package/src/interface/list-component.ts +4 -4
- package/src/interface/list-shared.ts +2 -2
- package/src/interface/list-view.ts +2 -2
- package/src/interface/subagent-actions.ts +263 -11
- package/src/interface/subagent-tool-schema.ts +20 -13
- package/src/interface/subagent-tool.ts +11 -6
- package/src/interface/subagents.ts +3 -3
- package/src/interface/tool-render.ts +34 -2
- package/src/interface/tool-workflow-script.ts +4 -4
- package/src/interface/tool-workflow.ts +6 -6
- package/src/interface/views/WorkflowsView.ts +5 -5
- package/src/interface/views/__tests__/WorkflowsView-signature.test.ts +3 -3
- package/src/interface/views/__tests__/detail-content-session-file.test.ts +2 -2
- package/src/interface/views/detail-content.ts +4 -4
- package/src/interface/views/format.ts +4 -4
- package/src/{orchestration/jsonl-run-store.ts → jsonl-run-store.ts} +11 -11
- package/src/execution/__tests__/__fixtures__/notifier-golden-snapshots.json +0 -53
- package/src/execution/__tests__/__fixtures__/truncline.snapshot.json +0 -1
- package/src/execution/__tests__/agent-registry.test.ts +0 -363
- package/src/execution/__tests__/agent-result-mapper.test.ts +0 -150
- package/src/execution/__tests__/alive-store.test.ts +0 -147
- package/src/execution/__tests__/ask-user-transit-e2e.test.ts +0 -490
- package/src/execution/__tests__/before-agent-start-injection.test.ts +0 -132
- package/src/execution/__tests__/bg-notify-render.test.ts +0 -329
- package/src/execution/__tests__/channel-registry-handshake.test.ts +0 -243
- package/src/execution/__tests__/chat-engine-routing.test.ts +0 -601
- package/src/execution/__tests__/chatmode-first-round-closure-service.test.ts +0 -365
- package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +0 -190
- package/src/execution/__tests__/chatmode-round-notify-real-chain.test.ts +0 -215
- package/src/execution/__tests__/concurrency-pool.test.ts +0 -250
- package/src/execution/__tests__/config.test.ts +0 -110
- package/src/execution/__tests__/conversation-wiring.test.ts +0 -198
- package/src/execution/__tests__/crash-recovery.test.ts +0 -320
- package/src/execution/__tests__/delivery-methods.test.ts +0 -422
- package/src/execution/__tests__/dialog-queue.test.ts +0 -299
- package/src/execution/__tests__/epipe-fallback.test.ts +0 -241
- package/src/execution/__tests__/execute-and-await-worktree.test.ts +0 -243
- package/src/execution/__tests__/execute-nesting.test.ts +0 -323
- package/src/execution/__tests__/execute-options-mapper.test.ts +0 -200
- package/src/execution/__tests__/execution-record.test.ts +0 -1394
- package/src/execution/__tests__/explicit-agent-ref-guard.test.ts +0 -171
- package/src/execution/__tests__/finalize-record.test.ts +0 -368
- package/src/execution/__tests__/finalized-marker.test.ts +0 -82
- package/src/execution/__tests__/format-schema-instruction.test.ts +0 -169
- package/src/execution/__tests__/format.test.ts +0 -458
- package/src/execution/__tests__/gc-timer.test.ts +0 -184
- package/src/execution/__tests__/get-record-for-action-restart.test.ts +0 -254
- package/src/execution/__tests__/gui-mode-dispatch.test.ts +0 -59
- package/src/execution/__tests__/helpers/mock-extension-api.ts +0 -30
- package/src/execution/__tests__/helpers/spawn-mock.ts +0 -242
- package/src/execution/__tests__/host-mode.test.ts +0 -87
- package/src/execution/__tests__/index-session-start-identity.test.ts +0 -371
- package/src/execution/__tests__/index-session-start.test.ts +0 -672
- package/src/execution/__tests__/lifecycle-manager-lock.test.ts +0 -211
- package/src/execution/__tests__/lifecycle-manager.test.ts +0 -383
- package/src/execution/__tests__/lifecycle-predicates.test.ts +0 -116
- package/src/execution/__tests__/list-component.test.ts +0 -401
- package/src/execution/__tests__/list-fields.test.ts +0 -140
- package/src/execution/__tests__/manifest-parentid.test.ts +0 -117
- package/src/execution/__tests__/model-resolver.test.ts +0 -465
- package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +0 -287
- package/src/execution/__tests__/nested-visibility.test.ts +0 -325
- package/src/execution/__tests__/notifier-flush.test.ts +0 -612
- package/src/execution/__tests__/notifier-golden-snapshot.test.ts +0 -261
- package/src/execution/__tests__/notify-ledger.test.ts +0 -826
- package/src/execution/__tests__/one-shot-upgrade.test.ts +0 -205
- package/src/execution/__tests__/output-collector.test.ts +0 -358
- package/src/execution/__tests__/parent-child-matrix.test.ts +0 -336
- package/src/execution/__tests__/path-encoding.test.ts +0 -104
- package/src/execution/__tests__/pi-invocation.test.ts +0 -134
- package/src/execution/__tests__/record-store.test.ts +0 -1057
- package/src/execution/__tests__/records-cwd-isolation.test.ts +0 -91
- package/src/execution/__tests__/recursive-visibility-baseline.test.ts +0 -339
- package/src/execution/__tests__/recursive-visibility-env.test.ts +0 -273
- package/src/execution/__tests__/relay-agent.test.ts +0 -448
- package/src/execution/__tests__/relay-env.test.ts +0 -42
- package/src/execution/__tests__/resource-policy.test.ts +0 -109
- package/src/execution/__tests__/rpc-mode.test.ts +0 -89
- package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +0 -267
- package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +0 -253
- package/src/execution/__tests__/run-spawn-edges.test.ts +0 -687
- package/src/execution/__tests__/run-spawn-integration.test.ts +0 -933
- package/src/execution/__tests__/run-spawn-resume.test.ts +0 -322
- package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +0 -196
- package/src/execution/__tests__/run-spawn-stdout-callback-throw.test.ts +0 -199
- package/src/execution/__tests__/sdk-contract.test.ts +0 -273
- package/src/execution/__tests__/session-context-resolver.test.ts +0 -167
- package/src/execution/__tests__/session-file-gc.test.ts +0 -293
- package/src/execution/__tests__/session-pending.test.ts +0 -197
- package/src/execution/__tests__/session-reconstructor.test.ts +0 -379
- package/src/execution/__tests__/session-runner-epipe.test.ts +0 -178
- package/src/execution/__tests__/session-runner-schema-env.test.ts +0 -350
- package/src/execution/__tests__/session-start-reaper.test.ts +0 -233
- package/src/execution/__tests__/spawn-args.test.ts +0 -445
- package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +0 -189
- package/src/execution/__tests__/spawn-event-adapter.test.ts +0 -167
- package/src/execution/__tests__/spawn-worktree-guidance.test.ts +0 -207
- package/src/execution/__tests__/spawned-children.test.ts +0 -92
- package/src/execution/__tests__/start-sync-model-guard.test.ts +0 -150
- package/src/execution/__tests__/startup-config-declaration.test.ts +0 -35
- package/src/execution/__tests__/status-refactor.test.ts +0 -345
- package/src/execution/__tests__/stdin-writer.test.ts +0 -463
- package/src/execution/__tests__/stream-sink-retirement.test.ts +0 -261
- package/src/execution/__tests__/subagent-service-abort.test.ts +0 -60
- package/src/execution/__tests__/subagent-service-message-close.test.ts +0 -629
- package/src/execution/__tests__/subagent-service-parent-guard.test.ts +0 -180
- package/src/execution/__tests__/subagent-service.test.ts +0 -788
- package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +0 -310
- package/src/execution/__tests__/subprocess-agent-runner.test.ts +0 -599
- package/src/execution/__tests__/temp-prompt.test.ts +0 -53
- package/src/execution/__tests__/timeout-integration.test.ts +0 -615
- package/src/execution/__tests__/tombstone-store.test.ts +0 -73
- package/src/execution/__tests__/tool-action.test.ts +0 -476
- package/src/execution/__tests__/truncline-snapshot.test.ts +0 -81
- package/src/execution/__tests__/turn-limiter-semantics.test.ts +0 -194
- package/src/execution/__tests__/turn-limiter.test.ts +0 -65
- package/src/execution/__tests__/ui-channels.test.ts +0 -187
- package/src/execution/__tests__/ui-interaction-model.test.ts +0 -67
- package/src/execution/__tests__/ui-request-handler-factory.test.ts +0 -370
- package/src/execution/__tests__/ui-request-handler.test.ts +0 -204
- package/src/execution/__tests__/ui-request-observability.test.ts +0 -114
- package/src/execution/__tests__/ui-request-queue.test.ts +0 -133
- package/src/execution/__tests__/worktree-manager.test.ts +0 -633
- package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +0 -229
- package/src/execution/__tests__/worktree-reconcile.integration.test.ts +0 -181
- package/src/execution/__tests__/worktree-registry.test.ts +0 -199
- package/src/execution/agent-registry.ts +0 -199
- package/src/execution/agent-result-mapper.ts +0 -90
- package/src/execution/alive-store.ts +0 -92
- package/src/execution/argv-mirror.ts +0 -113
- package/src/execution/best-effort.ts +0 -38
- package/src/execution/channel-registry-access.ts +0 -144
- package/src/execution/concurrency-pool.ts +0 -116
- package/src/execution/config.ts +0 -96
- package/src/execution/dialog-queue.ts +0 -330
- package/src/execution/engine/__tests__/common/data-dir.test.ts +0 -53
- package/src/execution/engine/__tests__/common/errors.test.ts +0 -132
- package/src/execution/engine/__tests__/common/event-journal.test.ts +0 -177
- package/src/execution/engine/__tests__/common/kill-chain.test.ts +0 -192
- package/src/execution/engine/__tests__/common/nesting-guard.test.ts +0 -81
- package/src/execution/engine/__tests__/common/persona-router.test.ts +0 -123
- package/src/execution/engine/__tests__/common/pool-manager.test.ts +0 -154
- package/src/execution/engine/__tests__/common/schema-emulation.test.ts +0 -128
- package/src/execution/engine/__tests__/conformance/__fixtures__/pi-golden-events.json +0 -28
- package/src/execution/engine/__tests__/conformance/agent-event-invariants.ts +0 -141
- package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +0 -109
- package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +0 -101
- package/src/execution/engine/__tests__/conformance/contract.probe.test.ts +0 -77
- package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +0 -104
- package/src/execution/engine/__tests__/conformance/contract.relay.test.ts +0 -342
- package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +0 -201
- package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +0 -76
- package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +0 -79
- package/src/execution/engine/__tests__/engine-discovery.test.ts +0 -87
- package/src/execution/engine/__tests__/engines-declaration.test.ts +0 -36
- package/src/execution/engine/__tests__/model-prompt.test.ts +0 -85
- package/src/execution/engine/__tests__/paths.test.ts +0 -39
- package/src/execution/engine/__tests__/registry.test.ts +0 -120
- package/src/execution/engine/__tests__/routing.test.ts +0 -231
- package/src/execution/engine/common/data-dir.ts +0 -62
- package/src/execution/engine/common/errors.ts +0 -183
- package/src/execution/engine/common/event-journal.ts +0 -254
- package/src/execution/engine/common/journal-replay.ts +0 -62
- package/src/execution/engine/common/kill-chain.ts +0 -221
- package/src/execution/engine/common/nesting-guard.ts +0 -50
- package/src/execution/engine/common/persona-router.ts +0 -108
- package/src/execution/engine/common/pool-manager.ts +0 -226
- package/src/execution/engine/common/schema-emulation.ts +0 -189
- package/src/execution/engine/common/session-view-projection.ts +0 -51
- package/src/execution/engine/engine-discovery.ts +0 -65
- package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +0 -469
- package/src/execution/engine/engines/pi/__tests__/reader.test.ts +0 -155
- package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
- package/src/execution/engine/engines/pi/pi-engine.ts +0 -415
- package/src/execution/engine/engines/pi/reader.ts +0 -48
- package/src/execution/engine/engines/pi/registration.ts +0 -35
- package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
- package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
- package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
- package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +0 -246
- package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +0 -228
- package/src/execution/engine/engines/zcode/__tests__/reader.test.ts +0 -210
- package/src/execution/engine/engines/zcode/__tests__/registration.test.ts +0 -64
- package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +0 -127
- package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -580
- package/src/execution/engine/engines/zcode/constants.ts +0 -43
- package/src/execution/engine/engines/zcode/golden-sample.ts +0 -39
- package/src/execution/engine/engines/zcode/launcher.ts +0 -161
- package/src/execution/engine/engines/zcode/parser.ts +0 -436
- package/src/execution/engine/engines/zcode/preparer.ts +0 -363
- package/src/execution/engine/engines/zcode/reader.ts +0 -381
- package/src/execution/engine/engines/zcode/registration.ts +0 -37
- package/src/execution/engine/engines/zcode/zcode-engine.ts +0 -658
- package/src/execution/engine/host-task-spec.ts +0 -47
- package/src/execution/engine/model-prompt.ts +0 -59
- package/src/execution/engine/paths.ts +0 -42
- package/src/execution/engine/port.ts +0 -153
- package/src/execution/engine/registry.ts +0 -123
- package/src/execution/engine/routing.ts +0 -218
- package/src/execution/engine/types.ts +0 -309
- package/src/execution/execute-options-mapper.ts +0 -112
- package/src/execution/execution-record.ts +0 -965
- package/src/execution/finalize-record.ts +0 -251
- package/src/execution/finalized-marker.ts +0 -51
- package/src/execution/get-state-handshake.ts +0 -104
- package/src/execution/host-mode.ts +0 -56
- package/src/execution/idle-gc.ts +0 -47
- package/src/execution/lifecycle-manager.ts +0 -513
- package/src/execution/lifecycle-predicates.ts +0 -65
- package/src/execution/manifest-store.ts +0 -256
- package/src/execution/model-config-service.ts +0 -219
- package/src/execution/model-resolver.ts +0 -248
- package/src/execution/notifier.ts +0 -330
- package/src/execution/notify-ledger.ts +0 -580
- package/src/execution/output-collector.ts +0 -228
- package/src/execution/path-encoding.ts +0 -60
- package/src/execution/pi-invocation.ts +0 -120
- package/src/execution/record-entry.ts +0 -132
- package/src/execution/record-store.ts +0 -1234
- package/src/execution/relay-env.ts +0 -37
- package/src/execution/session-context-resolver.ts +0 -64
- package/src/execution/session-file-gc.ts +0 -120
- package/src/execution/session-pending.ts +0 -164
- package/src/execution/session-reconstructor.ts +0 -678
- package/src/execution/session-runner.ts +0 -1781
- package/src/execution/sessions-index.ts +0 -304
- package/src/execution/spawn-event-adapter.ts +0 -363
- package/src/execution/stdin-writer.ts +0 -198
- package/src/execution/stream-sink.ts +0 -126
- package/src/execution/subagent-service.ts +0 -2141
- package/src/execution/subprocess-agent-runner.ts +0 -317
- package/src/execution/temp-prompt.ts +0 -62
- package/src/execution/tombstone-store.ts +0 -72
- package/src/execution/turn-limiter.ts +0 -102
- package/src/execution/types.ts +0 -973
- package/src/execution/ui-channels.ts +0 -216
- package/src/execution/ui-interaction-model.ts +0 -48
- package/src/execution/ui-request-handler-factory.ts +0 -212
- package/src/execution/ui-request-observability.ts +0 -81
- package/src/execution/ui-request-queue.ts +0 -184
- package/src/execution/worktree-manager.ts +0 -688
- package/src/execution/worktree-registry.ts +0 -222
- package/src/orchestration/__tests__/__fixtures__/worker-template.snapshot.txt +0 -349
- package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +0 -202
- package/src/orchestration/__tests__/agent-call-stream.test.ts +0 -152
- package/src/orchestration/__tests__/args-validator.test.ts +0 -143
- package/src/orchestration/__tests__/config-loader.test.ts +0 -503
- package/src/orchestration/__tests__/error-recovery-handlers.test.ts +0 -809
- package/src/orchestration/__tests__/error-recovery-postmessage-defense.test.ts +0 -405
- package/src/orchestration/__tests__/error-recovery-serialize-failed-result.test.ts +0 -56
- package/src/orchestration/__tests__/error-recovery-workflow-call.test.ts +0 -166
- package/src/orchestration/__tests__/execute-agent-call.test.ts +0 -451
- package/src/orchestration/__tests__/jsonl-run-store-corrupt-entry.test.ts +0 -150
- package/src/orchestration/__tests__/jsonl-run-store-loadall-sources.test.ts +0 -171
- package/src/orchestration/__tests__/jsonl-run-store-retention.test.ts +0 -202
- package/src/orchestration/__tests__/jsonl-run-store-session-file.test.ts +0 -1030
- package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +0 -600
- package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +0 -96
- package/src/orchestration/__tests__/lifecycle.test.ts +0 -659
- package/src/orchestration/__tests__/non-cloneable-return-e2e.test.ts +0 -95
- package/src/orchestration/__tests__/review-fix-loop-e2e.test.ts +0 -2025
- package/src/orchestration/__tests__/script-lint.test.ts +0 -831
- package/src/orchestration/__tests__/skill-discovery.test.ts +0 -201
- package/src/orchestration/__tests__/test-mocks.ts +0 -197
- package/src/orchestration/__tests__/worker-exit-without-result.test.ts +0 -368
- package/src/orchestration/__tests__/worker-host.test.ts +0 -120
- package/src/orchestration/__tests__/worker-returnmeta-passthrough.test.ts +0 -164
- package/src/orchestration/__tests__/worker-script-builder-runtime.test.ts +0 -563
- package/src/orchestration/__tests__/worker-script-builder.test.ts +0 -309
- package/src/orchestration/__tests__/worker-script-template-snapshot.test.ts +0 -129
- package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +0 -317
- package/src/orchestration/__tests__/workflow-script-lint-memo.test.ts +0 -110
- package/src/orchestration/__tests__/workflows-e2e.test.ts +0 -537
- package/src/orchestration/agent-opts-resolver.ts +0 -174
- package/src/orchestration/args-validator.ts +0 -127
- package/src/orchestration/config-loader.ts +0 -315
- package/src/orchestration/error-recovery.ts +0 -1018
- package/src/orchestration/execute-agent-call.ts +0 -256
- package/src/orchestration/launcher.ts +0 -455
- package/src/orchestration/lifecycle.ts +0 -399
- package/src/orchestration/models/__tests__/budget.test.ts +0 -307
- package/src/orchestration/models/__tests__/trace.test.ts +0 -408
- package/src/orchestration/models/agent-call.ts +0 -83
- package/src/orchestration/models/budget.ts +0 -118
- package/src/orchestration/models/ports.ts +0 -164
- package/src/orchestration/models/run-runtime.ts +0 -104
- package/src/orchestration/models/run-spec.ts +0 -83
- package/src/orchestration/models/run-state.ts +0 -44
- package/src/orchestration/models/trace.ts +0 -183
- package/src/orchestration/models/types.ts +0 -301
- package/src/orchestration/models/workflow-run.ts +0 -254
- package/src/orchestration/models/workflow-script-registry.ts +0 -35
- package/src/orchestration/models/workflow-script.ts +0 -117
- package/src/orchestration/script-lint.ts +0 -766
- package/src/orchestration/skill-discovery.ts +0 -115
- package/src/orchestration/worker-handle.ts +0 -115
- package/src/orchestration/worker-host.ts +0 -98
- package/src/orchestration/worker-script-builder.ts +0 -421
- package/src/orchestration/workflow-files.ts +0 -85
- package/src/orchestration/workflow-script-registry-impl.ts +0 -133
- package/src/shared/__tests__/agent-ref.test.ts +0 -34
- package/src/shared/__tests__/meta-parser.test.ts +0 -304
- package/src/shared/__tests__/model-ref.test.ts +0 -306
- package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -280
- package/src/shared/__tests__/resource-discovery.test.ts +0 -736
- package/src/shared/__tests__/resource-meta.test.ts +0 -51
- package/src/shared/__tests__/schema-jsonify.test.ts +0 -81
- package/src/shared/__tests__/timer-delay.test.ts +0 -61
- package/src/shared/agent-event.ts +0 -13
- package/src/shared/agent-ref.ts +0 -57
- package/src/shared/meta-parser.ts +0 -261
- package/src/shared/model-ref.ts +0 -286
- package/src/shared/resource-discovery.ts +0 -811
- package/src/shared/resource-meta.ts +0 -65
- package/src/shared/schema-env.ts +0 -44
- package/src/shared/schema-jsonify.ts +0 -58
- package/src/shared/timer-delay.ts +0 -54
- package/src/shared/xml-injection.ts +0 -35
- package/workflows/README.md +0 -81
- package/workflows/_shared/agent-refs.cjs +0 -40
- package/workflows/chain.js +0 -131
- package/workflows/map-reduce.js +0 -174
- package/workflows/parallel.js +0 -148
- package/workflows/review-fix-loop-utils.cjs +0 -1309
- package/workflows/review-fix-loop.js +0 -1404
- package/workflows/scatter-gather.js +0 -178
|
@@ -1,612 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* BgNotifier flushPendingNotifications — 单通道 triggerTurn 契约(U2 / D5)。
|
|
3
|
-
*
|
|
4
|
-
* 迁移史:deliverAs 从 'followUp' 改为 'steer'(FR-3/AC-3,commit d214d0d83)后,
|
|
5
|
-
* U2 courier 单通道化再收敛——steer / followUp / nextTurn 通道全部删除(nextTurn
|
|
6
|
-
* 唯一 drain 点在 session.prompt() 内,主 agent 长 streaming 场景下无限期滞留,
|
|
7
|
-
* 设计 D5 实测证伪),唯一发送形态 = sendCustomMessage({triggerTurn:true});busy
|
|
8
|
-
* 场景由 ledger(settled 边沿 + isIdle 二次复查)或内核 settled 订阅在空闲边沿驱动。
|
|
9
|
-
*
|
|
10
|
-
* 测试方法:mock NotifierHost,捕获 sendMessage 调用参数,断言 options 恰为
|
|
11
|
-
* { triggerTurn: true }(G4 字节锁定测试新锚:行为契约不变,机械迁移)。
|
|
12
|
-
*/
|
|
13
|
-
|
|
14
|
-
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
|
15
|
-
|
|
16
|
-
import { createNotifier, type BgNotifier, type NotifierHost } from "../notifier.ts";
|
|
17
|
-
|
|
18
|
-
/** mock host:捕获所有 sendMessage 调用 + 控制 hasRunningBackground + isIdle。 */
|
|
19
|
-
function makeMockHost(): NotifierHost & {
|
|
20
|
-
sendMessageCalls: { message: unknown; options: unknown }[];
|
|
21
|
-
hasRunningBackground: ReturnType<typeof vi.fn>;
|
|
22
|
-
isIdle: ReturnType<typeof vi.fn>;
|
|
23
|
-
} {
|
|
24
|
-
const sendMessageCalls: { message: unknown; options: unknown }[] = [];
|
|
25
|
-
const hasRunningBackground = vi.fn(() => false);
|
|
26
|
-
const isIdle = vi.fn(() => true);
|
|
27
|
-
return {
|
|
28
|
-
sendMessageCalls,
|
|
29
|
-
hasRunningBackground,
|
|
30
|
-
isIdle,
|
|
31
|
-
sendMessage(message, options) {
|
|
32
|
-
sendMessageCalls.push({ message, options });
|
|
33
|
-
},
|
|
34
|
-
};
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
describe("BgNotifier.flushPendingNotifications — 单通道 triggerTurn 契约(U2/D5)", () => {
|
|
38
|
-
let host: ReturnType<typeof makeMockHost>;
|
|
39
|
-
let notifier: BgNotifier;
|
|
40
|
-
|
|
41
|
-
beforeEach(() => {
|
|
42
|
-
host = makeMockHost();
|
|
43
|
-
notifier = createNotifier(host);
|
|
44
|
-
});
|
|
45
|
-
|
|
46
|
-
afterEach(() => {
|
|
47
|
-
notifier.dispose();
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
it("flush 时 sendMessage 的 options 恰为 { triggerTurn: true }(无 deliverAs,D5 单通道)", () => {
|
|
51
|
-
notifier.notify({
|
|
52
|
-
id: "bg-test-1",
|
|
53
|
-
status: "closed",
|
|
54
|
-
agent: "explorer",
|
|
55
|
-
result: "done",
|
|
56
|
-
startedAt: Date.now() - 1000,
|
|
57
|
-
endedAt: Date.now(),
|
|
58
|
-
});
|
|
59
|
-
|
|
60
|
-
// hasRunningBackground=false → notify 立即 flush
|
|
61
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
62
|
-
const call = host.sendMessageCalls[0];
|
|
63
|
-
expect(call.options).toEqual({ triggerTurn: true });
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
it("flush 时 triggerTurn 必须为 true(让父 agent 立即唤醒)", () => {
|
|
67
|
-
notifier.notify({
|
|
68
|
-
id: "bg-test-2",
|
|
69
|
-
status: "closed",
|
|
70
|
-
agent: "worker",
|
|
71
|
-
error: "boom",
|
|
72
|
-
startedAt: Date.now(),
|
|
73
|
-
endedAt: Date.now(),
|
|
74
|
-
});
|
|
75
|
-
|
|
76
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
77
|
-
expect(host.sendMessageCalls[0].options).toEqual({ triggerTurn: true });
|
|
78
|
-
});
|
|
79
|
-
});
|
|
80
|
-
|
|
81
|
-
describe("BgNotifier — isIdle gate 竞态修复", () => {
|
|
82
|
-
let host: ReturnType<typeof makeMockHost>;
|
|
83
|
-
let notifier: BgNotifier;
|
|
84
|
-
|
|
85
|
-
beforeEach(() => {
|
|
86
|
-
vi.useFakeTimers();
|
|
87
|
-
host = makeMockHost();
|
|
88
|
-
notifier = createNotifier(host);
|
|
89
|
-
});
|
|
90
|
-
|
|
91
|
-
afterEach(() => {
|
|
92
|
-
notifier.dispose();
|
|
93
|
-
vi.useRealTimers();
|
|
94
|
-
});
|
|
95
|
-
|
|
96
|
-
it("主 agent busy 时 flush 退避,idle 后才 sendMessage(规避 agent_end→finishRun 竞态窗口)", () => {
|
|
97
|
-
// 模拟竞态:notify 时主 agent 仍 streaming(isIdle=false)
|
|
98
|
-
host.isIdle.mockReturnValue(false);
|
|
99
|
-
notifier.notify({
|
|
100
|
-
id: "bg-race-1",
|
|
101
|
-
status: "closed",
|
|
102
|
-
agent: "worker",
|
|
103
|
-
result: "ok",
|
|
104
|
-
startedAt: Date.now(),
|
|
105
|
-
endedAt: Date.now(),
|
|
106
|
-
});
|
|
107
|
-
|
|
108
|
-
// busy 退避:未发送
|
|
109
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
110
|
-
expect(host.isIdle).toHaveBeenCalled();
|
|
111
|
-
|
|
112
|
-
// 推进 1 个退避间隔(100ms)——仍 busy,继续退避
|
|
113
|
-
vi.advanceTimersByTime(100);
|
|
114
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
115
|
-
|
|
116
|
-
// 主 agent 变 idle
|
|
117
|
-
host.isIdle.mockReturnValue(true);
|
|
118
|
-
vi.advanceTimersByTime(100);
|
|
119
|
-
|
|
120
|
-
// idle 后发送,单通道 {triggerTurn:true}(U2/D5:无 deliverAs)
|
|
121
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
122
|
-
expect(host.sendMessageCalls[0].options).toEqual({ triggerTurn: true });
|
|
123
|
-
});
|
|
124
|
-
|
|
125
|
-
it("主 agent 持续 busy 达退避上限后强制发送(防通知饿死)", () => {
|
|
126
|
-
host.isIdle.mockReturnValue(false);
|
|
127
|
-
notifier.notify({
|
|
128
|
-
id: "bg-starve-1",
|
|
129
|
-
status: "closed",
|
|
130
|
-
agent: "worker",
|
|
131
|
-
result: "ok",
|
|
132
|
-
startedAt: Date.now(),
|
|
133
|
-
endedAt: Date.now(),
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
137
|
-
// 推进超过退避上限(50 × 100ms = 5s)
|
|
138
|
-
vi.advanceTimersByTime(10_000);
|
|
139
|
-
|
|
140
|
-
// 达上限后 fallthrough 强制发送(至少不丢消息)
|
|
141
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
it("未注入 isIdle 时不 gate,保持原立即发送行为(向后兼容)", () => {
|
|
145
|
-
// 重建无 isIdle 的 host(模拟旧调用方/测试 host)
|
|
146
|
-
const legacyHost: NotifierHost = {
|
|
147
|
-
sendMessage: (message, options) => host.sendMessage(message, options),
|
|
148
|
-
hasRunningBackground: () => false,
|
|
149
|
-
};
|
|
150
|
-
const legacyNotifier = createNotifier(legacyHost);
|
|
151
|
-
legacyNotifier.notify({
|
|
152
|
-
id: "bg-legacy-1",
|
|
153
|
-
status: "closed",
|
|
154
|
-
agent: "worker",
|
|
155
|
-
result: "ok",
|
|
156
|
-
startedAt: Date.now(),
|
|
157
|
-
endedAt: Date.now(),
|
|
158
|
-
});
|
|
159
|
-
|
|
160
|
-
// 无 isIdle gate → 立即发送
|
|
161
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
162
|
-
legacyNotifier.dispose();
|
|
163
|
-
});
|
|
164
|
-
|
|
165
|
-
it("dispose 后退避 timer 不再触发发送", () => {
|
|
166
|
-
host.isIdle.mockReturnValue(false);
|
|
167
|
-
notifier.notify({
|
|
168
|
-
id: "bg-dispose-1",
|
|
169
|
-
status: "closed",
|
|
170
|
-
agent: "worker",
|
|
171
|
-
result: "ok",
|
|
172
|
-
startedAt: Date.now(),
|
|
173
|
-
endedAt: Date.now(),
|
|
174
|
-
});
|
|
175
|
-
|
|
176
|
-
notifier.dispose();
|
|
177
|
-
// 推进足够久,退避 timer 若未清会触发
|
|
178
|
-
vi.advanceTimersByTime(10_000);
|
|
179
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
180
|
-
});
|
|
181
|
-
});
|
|
182
|
-
|
|
183
|
-
describe("BgNotifier dedup 按轮次(G1 决策 9:对话模式豁免 60s dedup)", () => {
|
|
184
|
-
let host: ReturnType<typeof makeMockHost>;
|
|
185
|
-
let notifier: BgNotifier;
|
|
186
|
-
|
|
187
|
-
beforeEach(() => {
|
|
188
|
-
host = makeMockHost();
|
|
189
|
-
// hasRunningBackground=false → notify 立即 flush(不排队);dedup 仍在 push 前生效
|
|
190
|
-
notifier = createNotifier(host);
|
|
191
|
-
});
|
|
192
|
-
|
|
193
|
-
afterEach(() => {
|
|
194
|
-
notifier.dispose();
|
|
195
|
-
});
|
|
196
|
-
|
|
197
|
-
it("对话模式:同 id 不同 round 的两次 notify 不互相吞(round 参与 dedup key)", () => {
|
|
198
|
-
notifier.notify({
|
|
199
|
-
id: "sa-chat", status: "idle", agent: "w", round: 1, result: "round1",
|
|
200
|
-
startedAt: 1, endedAt: 2,
|
|
201
|
-
});
|
|
202
|
-
notifier.notify({
|
|
203
|
-
id: "sa-chat", status: "idle", agent: "w", round: 2, result: "round2",
|
|
204
|
-
startedAt: 3, endedAt: 4,
|
|
205
|
-
});
|
|
206
|
-
|
|
207
|
-
// MF-1 修复:dedup key=id:round,不同 round 不互相吞
|
|
208
|
-
expect(host.sendMessageCalls).toHaveLength(2);
|
|
209
|
-
});
|
|
210
|
-
|
|
211
|
-
it("同 id 同 round 60s 内第二次被 dedup 吞(防重复通知)", () => {
|
|
212
|
-
notifier.notify({
|
|
213
|
-
id: "sa-dup", status: "idle", agent: "w", round: 1, result: "r",
|
|
214
|
-
startedAt: 1, endedAt: 2,
|
|
215
|
-
});
|
|
216
|
-
notifier.notify({
|
|
217
|
-
id: "sa-dup", status: "idle", agent: "w", round: 1, result: "r",
|
|
218
|
-
startedAt: 3, endedAt: 4,
|
|
219
|
-
});
|
|
220
|
-
|
|
221
|
-
// 第二条被吞(dedup key=sa-dup:1 命中)
|
|
222
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
223
|
-
});
|
|
224
|
-
|
|
225
|
-
it("非 chatMode(round undefined → key=id:0)行为同旧(向后兼容,60s 内同 id 吞)", () => {
|
|
226
|
-
// round undefined → dedup key="sa-once:0",与旧 record.id 单 key 行为一致
|
|
227
|
-
notifier.notify({
|
|
228
|
-
id: "sa-once", status: "closed", agent: "w", result: "done",
|
|
229
|
-
startedAt: 1, endedAt: 2,
|
|
230
|
-
});
|
|
231
|
-
notifier.notify({
|
|
232
|
-
id: "sa-once", status: "closed", agent: "w", result: "done",
|
|
233
|
-
startedAt: 3, endedAt: 4,
|
|
234
|
-
});
|
|
235
|
-
|
|
236
|
-
// 第二条被吞(旧 dedup 行为不变,一次性模式回归)
|
|
237
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
238
|
-
});
|
|
239
|
-
});
|
|
240
|
-
|
|
241
|
-
describe("BgNotifier buildLlmContent 指针行(wave2:chatMode sessionFile 透传)", () => {
|
|
242
|
-
let host: ReturnType<typeof makeMockHost>;
|
|
243
|
-
let notifier: BgNotifier;
|
|
244
|
-
|
|
245
|
-
beforeEach(() => {
|
|
246
|
-
host = makeMockHost();
|
|
247
|
-
// hasRunningBackground=false → notify 立即 flush,sendMessageCalls 恰 1 条
|
|
248
|
-
notifier = createNotifier(host);
|
|
249
|
-
});
|
|
250
|
-
|
|
251
|
-
afterEach(() => {
|
|
252
|
-
notifier.dispose();
|
|
253
|
-
});
|
|
254
|
-
|
|
255
|
-
/** 取唯一一条已发消息的 content(前置断言恰 1 条)。 */
|
|
256
|
-
function sentContent(): string {
|
|
257
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
258
|
-
return (host.sendMessageCalls[0]!.message as { content: string }).content;
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
it("running(轮次通知)+ sessionFile → 末尾追加 \\n\\n 空行分隔的指针行", () => {
|
|
262
|
-
notifier.notify({
|
|
263
|
-
id: "sa-ptr-1", status: "running", agent: "w", round: 1, result: "round1 text",
|
|
264
|
-
sessionFile: "/tmp/sessions/child-1.jsonl",
|
|
265
|
-
startedAt: 1, endedAt: 2,
|
|
266
|
-
});
|
|
267
|
-
|
|
268
|
-
expect(sentContent()).toBe(
|
|
269
|
-
'Subagent "w" (sa-ptr-1) finished a round. Reply:\nround1 text' +
|
|
270
|
-
"\n\nFull transcript: /tmp/sessions/child-1.jsonl",
|
|
271
|
-
);
|
|
272
|
-
});
|
|
273
|
-
|
|
274
|
-
it("closed 成功文案 + sessionFile → 指针行追加在最终串末尾", () => {
|
|
275
|
-
notifier.notify({
|
|
276
|
-
id: "sa-ptr-2", status: "closed", agent: "w", result: "final result",
|
|
277
|
-
sessionFile: "/tmp/sessions/child-2.jsonl",
|
|
278
|
-
startedAt: 1, endedAt: 2,
|
|
279
|
-
});
|
|
280
|
-
|
|
281
|
-
expect(sentContent()).toBe(
|
|
282
|
-
'Subagent "w" (sa-ptr-2) completed. Result:\nfinal result' +
|
|
283
|
-
"\n\nFull transcript: /tmp/sessions/child-2.jsonl",
|
|
284
|
-
);
|
|
285
|
-
});
|
|
286
|
-
|
|
287
|
-
it("closed + patchFile + sessionFile → 指针行追加在 patch 提示串末尾(最终串)", () => {
|
|
288
|
-
notifier.notify({
|
|
289
|
-
id: "sa-ptr-3", status: "closed", agent: "w", result: "did work",
|
|
290
|
-
patchFile: "/tmp/patches/sa-ptr-3.patch",
|
|
291
|
-
sessionFile: "/tmp/sessions/child-3.jsonl",
|
|
292
|
-
startedAt: 1, endedAt: 2,
|
|
293
|
-
});
|
|
294
|
-
|
|
295
|
-
const content = sentContent();
|
|
296
|
-
expect(content).toContain("git apply /tmp/patches/sa-ptr-3.patch");
|
|
297
|
-
expect(content.endsWith("\n\nFull transcript: /tmp/sessions/child-3.jsonl")).toBe(true);
|
|
298
|
-
});
|
|
299
|
-
|
|
300
|
-
it("sessionFile 缺失 → 省略整行(running 通知正文与无指针形态逐字节一致)", () => {
|
|
301
|
-
notifier.notify({
|
|
302
|
-
id: "sa-ptr-4", status: "running", agent: "w", round: 2, result: "round2 text",
|
|
303
|
-
startedAt: 1, endedAt: 2,
|
|
304
|
-
});
|
|
305
|
-
|
|
306
|
-
expect(sentContent()).toBe('Subagent "w" (sa-ptr-4) finished a round. Reply:\nround2 text');
|
|
307
|
-
});
|
|
308
|
-
|
|
309
|
-
it("cancelled → 不追加指针行(即使 sessionFile 有值)", () => {
|
|
310
|
-
notifier.notify({
|
|
311
|
-
id: "sa-ptr-5", status: "closed", closedReason: "cancelled", agent: "w",
|
|
312
|
-
sessionFile: "/tmp/sessions/child-5.jsonl",
|
|
313
|
-
startedAt: 1, endedAt: 2,
|
|
314
|
-
});
|
|
315
|
-
|
|
316
|
-
expect(sentContent()).toBe('Subagent "w" (sa-ptr-5) cancelled.');
|
|
317
|
-
});
|
|
318
|
-
|
|
319
|
-
it("gc-failed(closed + closedReason=gc + error 有值)→ 不追加指针行", () => {
|
|
320
|
-
notifier.notify({
|
|
321
|
-
id: "sa-ptr-6", status: "closed", closedReason: "gc", agent: "w",
|
|
322
|
-
error: "spawn EPIPE",
|
|
323
|
-
sessionFile: "/tmp/sessions/child-6.jsonl",
|
|
324
|
-
startedAt: 1, endedAt: 2,
|
|
325
|
-
});
|
|
326
|
-
|
|
327
|
-
expect(sentContent()).toBe('Subagent "w" (sa-ptr-6) failed: spawn EPIPE');
|
|
328
|
-
});
|
|
329
|
-
|
|
330
|
-
it("[review 修复] gc-failed + patchFile 并存 → failed 文案优先(失败轮也会写 patchFile,patch 提示不可达)", () => {
|
|
331
|
-
// 回归锚定:doFinalizeRecord Step 0 对 worktreeHandle 无条件 collectPatch,gc 失败 +
|
|
332
|
-
// worktree 并存时 patchFile 有值。[U3] 判定收口到单一 deriveOutcome(cancelled →
|
|
333
|
-
// failed → patch/result),否则 LLM 被告知 completed 掩盖失败。
|
|
334
|
-
notifier.notify({
|
|
335
|
-
id: "sa-ptr-8", status: "closed", closedReason: "gc", agent: "w",
|
|
336
|
-
error: "spawn EPIPE",
|
|
337
|
-
patchFile: "/tmp/patches/sa-ptr-8.patch",
|
|
338
|
-
sessionFile: "/tmp/sessions/child-8.jsonl",
|
|
339
|
-
startedAt: 1, endedAt: 2,
|
|
340
|
-
});
|
|
341
|
-
|
|
342
|
-
expect(sentContent()).toBe('Subagent "w" (sa-ptr-8) failed: spawn EPIPE');
|
|
343
|
-
});
|
|
344
|
-
|
|
345
|
-
it("[U3][D6 显式取舍] parent-shutdown 合成关闭 + patchFile 并存 → failed 文案优先(patch 提示不可达)", () => {
|
|
346
|
-
// disposeAllRecords 合成 result 恒写 error:"closed due to ..." → outcome='failed';
|
|
347
|
-
// worktree 失败并存时仍不得展示 patch 提示(「failed 优先于 patchFile 提示」保真)。
|
|
348
|
-
notifier.notify({
|
|
349
|
-
id: "sa-u3-ps", status: "closed", closedReason: "parent-shutdown", agent: "w",
|
|
350
|
-
error: "closed due to parent-shutdown",
|
|
351
|
-
patchFile: "/tmp/patches/sa-u3-ps.patch",
|
|
352
|
-
startedAt: 1, endedAt: 2,
|
|
353
|
-
});
|
|
354
|
-
|
|
355
|
-
expect(sentContent()).toBe('Subagent "w" (sa-u3-ps) failed: closed due to parent-shutdown');
|
|
356
|
-
});
|
|
357
|
-
|
|
358
|
-
it("[U3] details payload 物化 outcome:closed 入参缺省时按 deriveOutcome 兑底填充", () => {
|
|
359
|
-
notifier.notify({
|
|
360
|
-
id: "sa-u3-mat", status: "closed", closedReason: "gc", agent: "w",
|
|
361
|
-
error: "boom",
|
|
362
|
-
startedAt: 1, endedAt: 2,
|
|
363
|
-
});
|
|
364
|
-
|
|
365
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
366
|
-
const msg = host.sendMessageCalls[0]!.message as { details?: { outcome?: string } };
|
|
367
|
-
expect(msg.details?.outcome).toBe("failed");
|
|
368
|
-
});
|
|
369
|
-
|
|
370
|
-
it("[U3] 显式 outcome 优先于 closedReason 兑底(一等字段直读)", () => {
|
|
371
|
-
notifier.notify({
|
|
372
|
-
id: "sa-u3-explicit", status: "closed", closedReason: "gc", agent: "w",
|
|
373
|
-
outcome: "cancelled",
|
|
374
|
-
startedAt: 1, endedAt: 2,
|
|
375
|
-
});
|
|
376
|
-
|
|
377
|
-
expect(sentContent()).toBe('Subagent "w" (sa-u3-explicit) cancelled.');
|
|
378
|
-
});
|
|
379
|
-
|
|
380
|
-
it("[U3] running(轮次通知)不物化 outcome(终态语义不适用活跃态)", () => {
|
|
381
|
-
notifier.notify({
|
|
382
|
-
id: "sa-u3-round", status: "running", agent: "w", round: 1, result: "r1",
|
|
383
|
-
startedAt: 1, endedAt: 2,
|
|
384
|
-
});
|
|
385
|
-
|
|
386
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
387
|
-
const msg = host.sendMessageCalls[0]!.message as { details?: { outcome?: string } };
|
|
388
|
-
expect(msg.details?.outcome).toBeUndefined();
|
|
389
|
-
});
|
|
390
|
-
|
|
391
|
-
it("one-shot(sessionFile 未透传 → undefined)→ closed 通知与改造前逐字节一致(基线常量锚定)", () => {
|
|
392
|
-
notifier.notify({
|
|
393
|
-
id: "sa-ptr-7", status: "closed", agent: "worker", result: "done",
|
|
394
|
-
startedAt: 1, endedAt: 2,
|
|
395
|
-
});
|
|
396
|
-
|
|
397
|
-
// 改造前形态:sessionFile undefined 时指针为空串,追加不改变输出——逐字节锁定
|
|
398
|
-
expect(sentContent()).toBe('Subagent "worker" (sa-ptr-7) completed. Result:\ndone');
|
|
399
|
-
});
|
|
400
|
-
|
|
401
|
-
it("[C-2] closed + totalRounds(chatMode close 终态通知)→ 文案附轮次统计 after N rounds", () => {
|
|
402
|
-
notifier.notify({
|
|
403
|
-
id: "sa-rounds-1", status: "closed", agent: "w", totalRounds: 3, result: "",
|
|
404
|
-
sessionFile: "/tmp/sessions/child-rounds.jsonl",
|
|
405
|
-
startedAt: 1, endedAt: 2,
|
|
406
|
-
});
|
|
407
|
-
|
|
408
|
-
// 设计 D2 路径①:closed 分支文案附轮次统计 + sessionFile 提示;
|
|
409
|
-
// 路径②正文空串(idle close)形态也走本分支(result 空串非 nullish,不触发 (empty))
|
|
410
|
-
expect(sentContent()).toBe(
|
|
411
|
-
'Subagent "w" (sa-rounds-1) completed after 3 rounds. Result:\n' +
|
|
412
|
-
"\n\nFull transcript: /tmp/sessions/child-rounds.jsonl",
|
|
413
|
-
);
|
|
414
|
-
});
|
|
415
|
-
|
|
416
|
-
it("[C-2] 对照:totalRounds 缺失(one-shot 完成通知)→ 无轮次统计,文案逐字节保持 completed. Result:", () => {
|
|
417
|
-
notifier.notify({
|
|
418
|
-
id: "sa-rounds-2", status: "closed", agent: "w", result: "done",
|
|
419
|
-
sessionFile: "/tmp/sessions/child-oneshot.jsonl",
|
|
420
|
-
startedAt: 1, endedAt: 2,
|
|
421
|
-
});
|
|
422
|
-
|
|
423
|
-
// one-shot record 无轮次语义(totalRounds 不设置)——G4:文案不含统计
|
|
424
|
-
expect(sentContent()).toBe(
|
|
425
|
-
'Subagent "w" (sa-rounds-2) completed. Result:\ndone' +
|
|
426
|
-
"\n\nFull transcript: /tmp/sessions/child-oneshot.jsonl",
|
|
427
|
-
);
|
|
428
|
-
});
|
|
429
|
-
});
|
|
430
|
-
|
|
431
|
-
describe("BgNotifier — subscribeSettled 装配(must-fix #4 / D8 settled 边沿驱动)", () => {
|
|
432
|
-
let host: ReturnType<typeof makeMockHost>;
|
|
433
|
-
let notifier: BgNotifier;
|
|
434
|
-
/** 内核经 port.subscribeSettled 注册的 settled 边沿回调(测试手动触发模拟 pi 事件)。 */
|
|
435
|
-
let settledEdges: Array<() => void>;
|
|
436
|
-
|
|
437
|
-
beforeEach(() => {
|
|
438
|
-
vi.useFakeTimers();
|
|
439
|
-
host = makeMockHost();
|
|
440
|
-
settledEdges = [];
|
|
441
|
-
// host 注入原生订阅能力;notifier port 内部用 disposed 标志包装(D8 适配)
|
|
442
|
-
host.onAgentSettled = (handler) => {
|
|
443
|
-
settledEdges.push(handler);
|
|
444
|
-
};
|
|
445
|
-
notifier = createNotifier(host);
|
|
446
|
-
});
|
|
447
|
-
|
|
448
|
-
afterEach(() => {
|
|
449
|
-
notifier.dispose();
|
|
450
|
-
vi.useRealTimers();
|
|
451
|
-
});
|
|
452
|
-
|
|
453
|
-
it("busy 入队 → settled 事件触发 → flush 送达(不依赖退避轮询)", () => {
|
|
454
|
-
host.isIdle.mockReturnValue(false);
|
|
455
|
-
notifier.notify({
|
|
456
|
-
id: "bg-settled-1",
|
|
457
|
-
status: "closed",
|
|
458
|
-
agent: "worker",
|
|
459
|
-
result: "ok",
|
|
460
|
-
startedAt: Date.now(),
|
|
461
|
-
endedAt: Date.now(),
|
|
462
|
-
});
|
|
463
|
-
|
|
464
|
-
// busy 入队:内核装配了 subscribeSettled → settled 边沿驱动,注册过订阅
|
|
465
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
466
|
-
expect(settledEdges.length).toBeGreaterThanOrEqual(1);
|
|
467
|
-
|
|
468
|
-
// 有订阅装配下内核不走退避强发——推进远超退避上限(50 × 100ms)仍不发送
|
|
469
|
-
vi.advanceTimersByTime(10_000);
|
|
470
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
471
|
-
|
|
472
|
-
// settled 边沿(isIdle 已先于事件复位,agent-session.js:327-336)→ flush 送达
|
|
473
|
-
host.isIdle.mockReturnValue(true);
|
|
474
|
-
settledEdges[0]!();
|
|
475
|
-
|
|
476
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
477
|
-
expect(host.sendMessageCalls[0]!.options).toEqual({ triggerTurn: true });
|
|
478
|
-
});
|
|
479
|
-
|
|
480
|
-
it("dispose 后 settled 边沿不再触发发送(内核 disposed 拦截)", () => {
|
|
481
|
-
host.isIdle.mockReturnValue(false);
|
|
482
|
-
notifier.notify({
|
|
483
|
-
id: "bg-settled-2",
|
|
484
|
-
status: "closed",
|
|
485
|
-
agent: "worker",
|
|
486
|
-
result: "ok",
|
|
487
|
-
startedAt: Date.now(),
|
|
488
|
-
endedAt: Date.now(),
|
|
489
|
-
});
|
|
490
|
-
notifier.dispose();
|
|
491
|
-
|
|
492
|
-
host.isIdle.mockReturnValue(true);
|
|
493
|
-
settledEdges[0]!();
|
|
494
|
-
|
|
495
|
-
expect(host.sendMessageCalls).toHaveLength(0);
|
|
496
|
-
});
|
|
497
|
-
});
|
|
498
|
-
|
|
499
|
-
describe("BgNotifier — revive 重建内核 handle(must-fix #5)", () => {
|
|
500
|
-
let host: ReturnType<typeof makeMockHost>;
|
|
501
|
-
let notifier: BgNotifier;
|
|
502
|
-
|
|
503
|
-
beforeEach(() => {
|
|
504
|
-
host = makeMockHost();
|
|
505
|
-
notifier = createNotifier(host);
|
|
506
|
-
});
|
|
507
|
-
|
|
508
|
-
afterEach(() => {
|
|
509
|
-
notifier.dispose();
|
|
510
|
-
});
|
|
511
|
-
|
|
512
|
-
it("dispose → notify 静默丢弃 → revive → notify 恢复送达", () => {
|
|
513
|
-
notifier.notify({
|
|
514
|
-
id: "bg-revive-1",
|
|
515
|
-
status: "closed",
|
|
516
|
-
agent: "worker",
|
|
517
|
-
result: "ok",
|
|
518
|
-
startedAt: 1,
|
|
519
|
-
endedAt: 2,
|
|
520
|
-
});
|
|
521
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
522
|
-
|
|
523
|
-
// session_shutdown:dispose(内核 handle 销毁,disposed 不可逆)
|
|
524
|
-
notifier.dispose();
|
|
525
|
-
|
|
526
|
-
// dispose 窗口内的 notify:外层 disposed 短路,静默丢弃(旧有语义)
|
|
527
|
-
notifier.notify({
|
|
528
|
-
id: "bg-revive-2",
|
|
529
|
-
status: "closed",
|
|
530
|
-
agent: "worker",
|
|
531
|
-
result: "dropped",
|
|
532
|
-
startedAt: 3,
|
|
533
|
-
endedAt: 4,
|
|
534
|
-
});
|
|
535
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
536
|
-
|
|
537
|
-
// /resume /fork /new 后的 revive:必须重建内核 handle——旧实现仅复位外层标志,
|
|
538
|
-
// 内核已 dispose,此后所有 notify 被内核静默吞(通知永久丢失)
|
|
539
|
-
notifier.revive();
|
|
540
|
-
notifier.notify({
|
|
541
|
-
id: "bg-revive-3",
|
|
542
|
-
status: "closed",
|
|
543
|
-
agent: "worker",
|
|
544
|
-
result: "alive again",
|
|
545
|
-
startedAt: 5,
|
|
546
|
-
endedAt: 6,
|
|
547
|
-
});
|
|
548
|
-
|
|
549
|
-
expect(host.sendMessageCalls).toHaveLength(2);
|
|
550
|
-
const msg = host.sendMessageCalls[1]!.message as { content: string };
|
|
551
|
-
expect(msg.content).toContain("bg-revive-3");
|
|
552
|
-
});
|
|
553
|
-
|
|
554
|
-
it("revive 后同 id 重复通知不被旧生命周期的 dedup LRU 吞(新 handle 状态复位)", () => {
|
|
555
|
-
notifier.notify({ id: "bg-revive-dup", status: "closed", agent: "w", result: "r1", startedAt: 1, endedAt: 2 });
|
|
556
|
-
notifier.dispose();
|
|
557
|
-
notifier.revive();
|
|
558
|
-
// 同 id 第二次:旧 handle 的 dedup LRU 已随 dispose 清空 + 重建,不被吞
|
|
559
|
-
notifier.notify({ id: "bg-revive-dup", status: "closed", agent: "w", result: "r2", startedAt: 3, endedAt: 4 });
|
|
560
|
-
expect(host.sendMessageCalls).toHaveLength(2);
|
|
561
|
-
});
|
|
562
|
-
});
|
|
563
|
-
|
|
564
|
-
describe("U3_UNIT: createNotifier unit verification", () => {
|
|
565
|
-
it("createNotifier returns object with notify/flush/dispose/revive", () => {
|
|
566
|
-
const host = makeMockHost();
|
|
567
|
-
const notifier = createNotifier(host);
|
|
568
|
-
expect(typeof notifier.notify).toBe("function");
|
|
569
|
-
expect(typeof notifier.flushPendingNotifications).toBe("function");
|
|
570
|
-
expect(typeof notifier.dispose).toBe("function");
|
|
571
|
-
expect(typeof notifier.revive).toBe("function");
|
|
572
|
-
notifier.dispose();
|
|
573
|
-
});
|
|
574
|
-
|
|
575
|
-
it("notify calls host.sendMessage with customType=subagent-bg-notify", () => {
|
|
576
|
-
const host = makeMockHost();
|
|
577
|
-
const notifier = createNotifier(host);
|
|
578
|
-
notifier.notify({
|
|
579
|
-
id: "u3-test-1", status: "closed", agent: "worker", result: "ok",
|
|
580
|
-
startedAt: 1, endedAt: 2,
|
|
581
|
-
});
|
|
582
|
-
expect(host.sendMessageCalls).toHaveLength(1);
|
|
583
|
-
const msg = host.sendMessageCalls[0]!.message as { customType: string };
|
|
584
|
-
expect(msg.customType).toBe("subagent-bg-notify");
|
|
585
|
-
notifier.dispose();
|
|
586
|
-
});
|
|
587
|
-
|
|
588
|
-
it("notify with mergeHoldActive=true defers flush until explicit call", () => {
|
|
589
|
-
const sendMessageCalls: unknown[] = [];
|
|
590
|
-
const host: NotifierHost = {
|
|
591
|
-
sendMessage: (msg) => { sendMessageCalls.push(msg); },
|
|
592
|
-
hasRunningBackground: () => true,
|
|
593
|
-
isIdle: () => true,
|
|
594
|
-
};
|
|
595
|
-
const notifier = createNotifier(host);
|
|
596
|
-
notifier.notify({
|
|
597
|
-
id: "u3-merge-1", status: "closed", agent: "w", result: "r1",
|
|
598
|
-
startedAt: 1, endedAt: 2,
|
|
599
|
-
});
|
|
600
|
-
notifier.notify({
|
|
601
|
-
id: "u3-merge-2", status: "closed", agent: "w", result: "r2",
|
|
602
|
-
startedAt: 3, endedAt: 4,
|
|
603
|
-
});
|
|
604
|
-
// mergeHoldActive=true → messages queued, not sent yet
|
|
605
|
-
expect(sendMessageCalls).toHaveLength(0);
|
|
606
|
-
notifier.flushPendingNotifications();
|
|
607
|
-
expect(sendMessageCalls).toHaveLength(1);
|
|
608
|
-
const content = (sendMessageCalls[0] as { content: string }).content;
|
|
609
|
-
expect(content).toContain("\n\n---\n\n");
|
|
610
|
-
notifier.dispose();
|
|
611
|
-
});
|
|
612
|
-
});
|