@@ -0,0 +1,99 @@
1+# Subagent completion direct fallback
2+3+```yaml qa-scenario
4+id: subagent-completion-direct-fallback
5+title: Subagent completion direct fallback
6+surface: subagents
7+coverage:
8+primary:
9+ - agents.subagents
10+secondary:
11+ - runtime.delivery
12+ - channels.qa-channel
13+objective: Verify a yielded parent still receives a successful subagent result through direct fallback delivery when the dormant announce turn produces no visible reply.
14+successCriteria:
15+ - Parent launches a native subagent.
16+ - Parent yields instead of waiting in-turn.
17+ - Subagent completion result is delivered to the original QA DM without a thread id.
18+ - Durable task delivery is marked delivered, not failed.
19+docsRefs:
20+ - docs/tools/subagents.md
21+ - docs/help/testing.md
22+ - docs/channels/qa-channel.md
23+codeRefs:
24+ - src/agents/subagent-announce-delivery.ts
25+ - src/agents/subagent-registry-lifecycle.ts
26+ - src/agents/tools/sessions-yield-tool.ts
27+ - extensions/qa-lab/src/providers/mock-openai/server.ts
28+execution:
29+kind: flow
30+summary: Reproduce yielded-parent subagent completion delivery and require frozen-result fallback to the QA DM.
31+config:
32+prompt: "Subagent direct fallback QA check: spawn one native subagent worker. The worker must finish with exactly QA-SUBAGENT-DIRECT-FALLBACK-OK. After spawning it, call sessions_yield and wait for the completion event. Do not use ACP."
33+expectedMarker: QA-SUBAGENT-DIRECT-FALLBACK-OK
34+expectedLabel: qa-direct-fallback-worker
35+```
36+37+```yaml qa-flow
38+steps:
39+ - name: yielded parent receives child completion through direct fallback
40+actions:
41+ - call: waitForGatewayHealthy
42+args:
43+ - ref: env
44+ - 120000
45+ - call: waitForQaChannelReady
46+args:
47+ - ref: env
48+ - 120000
49+ - call: reset
50+ - set: sessionKey
51+value:
52+expr: "`agent:qa:subagent-direct-fallback:${randomUUID().slice(0, 8)}`"
53+ - call: runAgentPrompt
54+args:
55+ - ref: env
56+ - sessionKey:
57+ref: sessionKey
58+message:
59+expr: config.prompt
60+timeoutMs:
61+expr: liveTurnTimeoutMs(env, 90000)
62+ - call: waitForCondition
63+saveAs: outbound
64+args:
65+ - lambda:
66+expr: "state.getSnapshot().messages.filter((message) => message.direction === 'outbound' && String(message.text ?? '').includes(config.expectedMarker)).at(-1)"
67+ - expr: liveTurnTimeoutMs(env, 60000)
68+ - expr: "env.providerMode === 'mock-openai' ? 100 : 250"
69+ - assert:
70+expr: "String(outbound.text ?? '').trim().includes(config.expectedMarker)"
71+message:
72+expr: "`fallback completion marker missing from outbound QA DM: ${recentOutboundSummary(state)}`"
73+ - if:
74+expr: "Boolean(env.mock)"
75+then:
76+ - set: fallbackDebugRequests
77+value:
78+expr: "[...(await fetchJson(`${env.mock.baseUrl}/debug/requests`))]"
79+ - assert:
80+expr: "fallbackDebugRequests.some((request) => !request.toolOutput && /subagent direct fallback qa check/i.test(String(request.allInputText ?? '')) && request.plannedToolName === 'sessions_spawn' && request.plannedToolArgs?.label === config.expectedLabel)"
81+message:
82+expr: "`expected sessions_spawn for yielded fallback scenario, saw ${JSON.stringify(fallbackDebugRequests.map((request) => ({ plannedToolName: request.plannedToolName ?? null, plannedToolArgs: request.plannedToolArgs ?? null })))}`"
83+ - assert:
84+expr: "fallbackDebugRequests.some((request) => /subagent direct fallback qa check/i.test(String(request.allInputText ?? '')) && request.plannedToolName === 'sessions_yield')"
85+message:
86+expr: "`expected sessions_yield for yielded fallback scenario, saw ${JSON.stringify(fallbackDebugRequests.map((request) => request.plannedToolName ?? null))}`"
87+ - call: waitForCondition
88+saveAs: deliveredTask
89+args:
90+ - lambda:
91+expr: "(async () => { const payload = await runQaCli(env, ['tasks', 'list', '--json', '--runtime', 'subagent'], { timeoutMs: liveTurnTimeoutMs(env, 60000), json: true }); return (payload.tasks ?? []).find((task) => task.label === config.expectedLabel && task.deliveryStatus === 'delivered' && task.status === 'succeeded') ?? null; })()"
92+ - expr: liveTurnTimeoutMs(env, 30000)
93+ - 250
94+ - assert:
95+expr: "deliveredTask.deliveryStatus === 'delivered'"
96+message:
97+expr: "`expected delivered task status for ${config.expectedLabel}, got ${JSON.stringify(deliveredTask)}`"
98+detailsExpr: "outbound.text"
99+```
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。