Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

qa/scenarios/agents/subagent-completion-direct-fallback.yaml

@@ -0,0 +1,108 @@
+title: Subagent completion direct fallback
+
+scenario:
+  id: subagent-completion-direct-fallback
+  surface: subagents
+  coverage:
+    primary:
+      - agents.subagents
+    secondary:
+      - runtime.delivery
+      - channels.qa-channel
+  objective: Verify a yielded parent still receives a successful subagent result through direct fallback delivery when the dormant announce turn produces no visible reply.
+  successCriteria:
+    - Parent launches a native subagent.
+    - Parent yields instead of waiting in-turn.
+    - Subagent completion result is delivered to the original QA DM without a thread id.
+    - Durable task delivery is marked delivered, not failed.
+  docsRefs:
+    - docs/tools/subagents.md
+    - docs/help/testing.md
+    - docs/channels/qa-channel.md
+  codeRefs:
+    - src/agents/subagent-announce-delivery.ts
+    - src/agents/subagent-registry-lifecycle.ts
+    - src/agents/tools/sessions-yield-tool.ts
+    - extensions/qa-lab/src/providers/mock-openai/server.ts
+  execution:
+    kind: flow
+    summary: Reproduce yielded-parent subagent completion delivery and require frozen-result fallback to the QA DM.
+    config:
+      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."
+      expectedMarker: QA-SUBAGENT-DIRECT-FALLBACK-OK
+      expectedLabel: qa-direct-fallback-worker
+
+flow:
+  steps:
+    - name: yielded parent receives child completion through direct fallback
+      actions:
+        - call: waitForGatewayHealthy
+          args:
+            - ref: env
+            - 120000
+        - call: waitForQaChannelReady
+          args:
+            - ref: env
+            - 120000
+        - call: reset
+        - set: sessionKey
+          value:
+            expr: "`agent:qa:subagent-direct-fallback:${randomUUID().slice(0, 8)}`"
+        - try:
+            actions:
+              - call: runAgentPrompt
+                args:
+                  - ref: env
+                  - sessionKey:
+                      ref: sessionKey
+                    message:
+                      expr: config.prompt
+                    timeoutMs:
+                      expr: liveTurnTimeoutMs(env, 90000)
+              - call: waitForCondition
+                saveAs: outbound
+                args:
+                  - lambda:
+                      expr: "state.getSnapshot().messages.filter((message) => message.direction === 'outbound' && String(message.text ?? '').includes(config.expectedMarker)).at(-1)"
+                  - expr: liveTurnTimeoutMs(env, 180000)
+                  - expr: "env.providerMode === 'mock-openai' ? 100 : 250"
+              - assert:
+                  expr: "String(outbound.text ?? '').trim().includes(config.expectedMarker)"
+                  message:
+                    expr: "`fallback completion marker missing from outbound QA DM: ${recentOutboundSummary(state)}`"
+            catchAs: fallbackError
+            catch:
+              - set: fallbackDebugRequests
+                value:
+                  expr: "env.mock ? [...(await fetchJson(`${env.mock.baseUrl}/debug/requests`))].slice(-20).map((request) => ({ plannedToolName: request.plannedToolName ?? null, plannedToolArgs: request.plannedToolArgs ?? null, prompt: String(request.prompt ?? '').slice(0, 280), allInputText: String(request.allInputText ?? '').slice(0, 280), toolOutput: request.toolOutput ? String(request.toolOutput).slice(0, 280) : null })) : []"
+              - set: fallbackTasks
+                value:
+                  expr: "(await runQaCli(env, ['tasks', 'list', '--json', '--runtime', 'subagent'], { timeoutMs: liveTurnTimeoutMs(env, 60000), json: true }).catch((error) => ({ error: String(error?.message ?? error) })))"
+              - throw:
+                  expr: "`subagent fallback marker missing: ${fallbackError?.message ?? fallbackError}; outbound=${recentOutboundSummary(state, 8)} tasks=${JSON.stringify(fallbackTasks)} requests=${JSON.stringify(fallbackDebugRequests)}`"
+        - if:
+            expr: "Boolean(env.mock)"
+            then:
+              - set: fallbackDebugRequests
+                value:
+                  expr: "[...(await fetchJson(`${env.mock.baseUrl}/debug/requests`))]"
+              - assert:
+                  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)"
+                  message:
+                    expr: "`expected sessions_spawn for yielded fallback scenario, saw ${JSON.stringify(fallbackDebugRequests.map((request) => ({ plannedToolName: request.plannedToolName ?? null, plannedToolArgs: request.plannedToolArgs ?? null })))}`"
+              - assert:
+                  expr: "fallbackDebugRequests.some((request) => /subagent direct fallback qa check/i.test(String(request.allInputText ?? '')) && request.plannedToolName === 'sessions_yield')"
+                  message:
+                    expr: "`expected sessions_yield for yielded fallback scenario, saw ${JSON.stringify(fallbackDebugRequests.map((request) => request.plannedToolName ?? null))}`"
+              - call: waitForCondition
+                saveAs: deliveredTask
+                args:
+                  - lambda:
+                      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; })()"
+                  - expr: liveTurnTimeoutMs(env, 60000)
+                  - 250
+              - assert:
+                  expr: "deliveredTask.deliveryStatus === 'delivered'"
+                  message:
+                    expr: "`expected delivered task status for ${config.expectedLabel}, got ${JSON.stringify(deliveredTask)}`"
+      detailsExpr: "outbound.text"