@sema-agent/core 1.279.0 → 1.281.0

package/dist/agents/subagent.d.ts

@@ -49,6 +49,7 @@ export declare const SUBAGENT_RESUME_CAP = 8;
 export interface SubagentRetainEntry {
     childSessionId: string;
     agentName?: string;
+    ttlMs?: number;
     specSnapshot: Readonly<TaskSpec>;
     internalsSnapshot: RunInternals;
     running: boolean;
@@ -63,11 +64,15 @@ export declare class SubagentRetainLedger {
     readonly max: number;
     private entries;
     private evictedIds;
+    private ttlTimers;
     private isDisposed;
     constructor(config: true | {
         ttlMs?: number;
         max?: number;
     });
+    private static readonly TOMBSTONES_MAX;
+    private tombstone;
+    private effectiveTtlMs;
     get disposed(): boolean;
     get size(): number;
     get(parentToolCallId: string): SubagentRetainEntry | undefined;
@@ -75,6 +80,8 @@ export declare class SubagentRetainLedger {
     sweepExpired(now?: number): void;
     register(parentToolCallId: string, entry: Omit<SubagentRetainEntry, "running" | "settled" | "settledAt" | "resumeCount" | "activeAbort">): SubagentRetainEntry | undefined;
     markSettled(parentToolCallId: string): void;
+    private armTtlTimer;
+    private clearTtlTimer;
     abandon(parentToolCallId: string): void;
     evict(parentToolCallId: string): Promise<void>;
     disposeAll(): Promise<void>;
@@ -107,6 +114,11 @@ export interface SubagentToolOptions {
         timeoutSec?: number;
     };
     maxDepth?: number;
+    retainFailedSessions?: boolean;
+    onObserverError?: (err: unknown, info: {
+        observedAgent?: string;
+        observerAgent?: string;
+    }) => void;
 }
 export declare const SUBAGENT_SYSTEM_NOTE: string;
 export declare const FORK_DIRECTIVE_FRAME = "<fork-boilerplate>\nYou are a worker fork. The transcript above is the parent's history \u2014 inherited reference, not your situation. You are NOT a continuation of that agent. Execute ONE directive, then stop.\n\nHard rules:\n- Do NOT spawn subagents with the Agent tool. The \"default to forking\" guidance is for the parent; you ARE the fork, execute directly.\n- One shot: report once and stop. No follow-up questions, no proposed next steps, no waiting for the user.\n\nGuidelines (your directive may override any of these):\n- Stay in scope. Other forks may be handling adjacent work; if you spot something outside your directive, note it in a sentence and move on.\n- Open with one line restating your task, so the parent can spot scope drift at a glance.\n- Be concise \u2014 as short as the answer allows, no shorter. Plain text, no preamble, no meta-commentary.\n- If you committed changes, list the paths and commit hashes in your report.\n</fork-boilerplate>\n\nYour directive: ";

package/dist/agents/subagent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/agents/subagent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/agents/subagent.ts"],"names":[],"mappings":"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"}

package/dist/agents/subagent.js

@@ -175,6 +175,9 @@ export function classifySubagentError(child) {
 export const SUBAGENT_RESUME_CAP = 8;
 const RETAIN_DEFAULT_TTL_MS = 30 * 60 * 1000;
 const RETAIN_DEFAULT_MAX = 16;
+const FAILED_SESSION_RETAIN_TTL_MS = 15 * 60 * 1000;
+const PARTIAL_FINDINGS_MAX_CHARS = 1200;
+const BG_NOTIFY_DRAIN_WINDOW_MS = 2_000;
 function markerFragment() {
     return uuidv7().replace(/-/g, "").slice(-12);
 }
@@ -183,12 +186,27 @@ export class SubagentRetainLedger {
     max;
     entries = new Map();
     evictedIds = new Set();
+    ttlTimers = new Map();
     isDisposed = false;
     constructor(config) {
         const cfg = config === true ? {} : config;
         this.ttlMs = cfg.ttlMs ?? RETAIN_DEFAULT_TTL_MS;
         this.max = cfg.max ?? RETAIN_DEFAULT_MAX;
     }
+    static TOMBSTONES_MAX = 512;
+    tombstone(parentToolCallId) {
+        this.evictedIds.delete(parentToolCallId);
+        this.evictedIds.add(parentToolCallId);
+        while (this.evictedIds.size > SubagentRetainLedger.TOMBSTONES_MAX) {
+            const oldest = this.evictedIds.values().next().value;
+            if (oldest === undefined)
+                break;
+            this.evictedIds.delete(oldest);
+        }
+    }
+    effectiveTtlMs(e) {
+        return e.ttlMs ?? this.ttlMs;
+    }
     get disposed() {
         return this.isDisposed;
     }
@@ -203,7 +221,7 @@ export class SubagentRetainLedger {
     }
     sweepExpired(now = Date.now()) {
         for (const [id, e] of this.entries) {
-            if (e.settled && !e.running && now - e.settledAt > this.ttlMs) {
+            if (e.settled && !e.running && now - e.settledAt > this.effectiveTtlMs(e)) {
                 void this.evict(id);
             }
         }
@@ -222,7 +240,7 @@ export class SubagentRetainLedger {
                 }
             }
             if (oldest === undefined) {
-                this.evictedIds.add(parentToolCallId);
+                this.tombstone(parentToolCallId);
                 return undefined;
             }
             void this.evict(oldest);
@@ -237,11 +255,43 @@ export class SubagentRetainLedger {
             e.running = false;
             e.settled = true;
             e.settledAt = Date.now();
+            this.armTtlTimer(parentToolCallId);
+        }
+    }
+    armTtlTimer(parentToolCallId) {
+        this.clearTtlTimer(parentToolCallId);
+        const entry = this.entries.get(parentToolCallId);
+        if (!entry)
+            return;
+        const ttlMs = this.effectiveTtlMs(entry);
+        if (ttlMs >= 0x7fffffff)
+            return;
+        const t = setTimeout(() => {
+            this.ttlTimers.delete(parentToolCallId);
+            const e = this.entries.get(parentToolCallId);
+            if (!e)
+                return;
+            if (e.settled && !e.running && Date.now() - e.settledAt > this.effectiveTtlMs(e)) {
+                void this.evict(parentToolCallId);
+            }
+            else {
+                this.armTtlTimer(parentToolCallId);
+            }
+        }, ttlMs + 1);
+        t.unref?.();
+        this.ttlTimers.set(parentToolCallId, t);
+    }
+    clearTtlTimer(parentToolCallId) {
+        const t = this.ttlTimers.get(parentToolCallId);
+        if (t !== undefined) {
+            clearTimeout(t);
+            this.ttlTimers.delete(parentToolCallId);
         }
     }
     abandon(parentToolCallId) {
         if (this.entries.delete(parentToolCallId)) {
-            this.evictedIds.add(parentToolCallId);
+            this.clearTtlTimer(parentToolCallId);
+            this.tombstone(parentToolCallId);
         }
     }
     async evict(parentToolCallId) {
@@ -249,7 +299,8 @@ export class SubagentRetainLedger {
         if (!e)
             return;
         this.entries.delete(parentToolCallId);
-        this.evictedIds.add(parentToolCallId);
+        this.clearTtlTimer(parentToolCallId);
+        this.tombstone(parentToolCallId);
         try {
             e.activeAbort?.abort();
         }
@@ -265,8 +316,13 @@ export class SubagentRetainLedger {
     }
 }
 const sessionRetainLedgers = new Map();
+const SESSION_RETAIN_LEDGERS_MAX = 64;
 export function getSessionRetainLedger(sessionId) {
-    return sessionRetainLedgers.get(sessionId)?.ledger;
+    const row = sessionRetainLedgers.get(sessionId);
+    if (!row)
+        return undefined;
+    row.touchedAt = Date.now();
+    return row.ledger;
 }
 function getOrCreateSessionRetainLedger(sessionId, config) {
     const now = Date.now();
@@ -280,6 +336,21 @@ function getOrCreateSessionRetainLedger(sessionId, config) {
         existing.touchedAt = now;
         return existing.ledger;
     }
+    while (sessionRetainLedgers.size >= SESSION_RETAIN_LEDGERS_MAX) {
+        let lru;
+        let lruAt = Infinity;
+        for (const [sid, row] of sessionRetainLedgers) {
+            if (row.touchedAt < lruAt) {
+                lru = sid;
+                lruAt = row.touchedAt;
+            }
+        }
+        if (lru === undefined)
+            break;
+        const row = sessionRetainLedgers.get(lru);
+        sessionRetainLedgers.delete(lru);
+        void row.ledger.disposeAll();
+    }
     const ledger = new SubagentRetainLedger(config);
     sessionRetainLedgers.set(sessionId, { ledger, touchedAt: now });
     return ledger;
@@ -405,6 +476,7 @@ function makeSubagentResume(deps) {
                         status: child.status === "completed" ? "completed" : abort.signal.aborted ? "killed" : "failed",
                         summary: `resumed sub-agent ${marker} — ${child.status !== "completed" && abort.signal.aborted ? "killed" : child.status}`,
                         ...(child.result ? { result: child.result.slice(0, 2_000) } : {}),
+                        ...(child.status !== "completed" && abort.signal.aborted && child.result ? { partial: true } : {}),
                         usage: { tokens: child.stats.tokens, turns: child.stats.turns, costMicroUsd: child.stats.costMicroUsd },
                     }, { priority: "later" });
                 }
@@ -428,6 +500,7 @@ function makeSubagentResume(deps) {
                 entry.running = false;
                 entry.activeAbort = undefined;
                 entry.settledAt = Date.now();
+                ledger.markSettled(deps.parentToolCallId);
                 settleResolve();
             }
         })();
@@ -726,6 +799,20 @@ function makeSubagentTool(opts, depth, excluded) {
             let observerPairing;
             let observerTap;
             let observerSessionId;
+            let observerFailure;
+            const noteObserverFailure = (err) => {
+                if (observerFailure === undefined) {
+                    observerFailure = (err instanceof Error ? err.message : String(err)).slice(0, REPORT_FIELD_MAX);
+                }
+                try {
+                    opts.onObserverError?.(err, {
+                        ...(def !== undefined ? { observedAgent: def.name } : {}),
+                        ...(observerArm ? { observerAgent: observerArm.observerDefinition.name } : {}),
+                    });
+                }
+                catch {
+                }
+            };
             const observedSteerRef = {};
             if (observerArm) {
                 const observerDef = observerArm.observerDefinition;
@@ -771,6 +858,7 @@ function makeSubagentTool(opts, depth, excluded) {
                     ...(observerArm.observerMessage !== undefined ? { observerMessage: observerArm.observerMessage } : {}),
                     spawner,
                     framingPrompt: observerFramingPrompt({ observedEnvelopeName: envelopeName, ...(childAgentName !== undefined ? { observedTaskLabel: childAgentName } : {}) }),
+                    onError: noteObserverFailure,
                 });
                 reportOpts.pairing = observerPairing;
                 observerTap = new ObserverDigestTap((activity) => observerPairing.enqueueSegment(activity));
@@ -800,6 +888,8 @@ function makeSubagentTool(opts, depth, excluded) {
                         t.unref?.();
                     });
                     const outcome = await Promise.race([observerPairing.drain().then(() => "drained"), timeout]);
+                    if (outcome === "timeout")
+                        noteObserverFailure(new Error("observer unresponsive at settle (delivery drain timed out)"));
                     observerPairing.retire(outcome === "timeout" ? "stopped" : "retired");
                     if (observerSessionId !== undefined) {
                         try {
@@ -815,10 +905,29 @@ function makeSubagentTool(opts, depth, excluded) {
                 closeObserverWindow(status);
                 await drainAndReleaseObserver();
             };
+            const startBoundedObserverDrain = async () => {
+                const drain = drainAndReleaseObserver().catch(() => undefined);
+                if (observerPairing === undefined)
+                    return "drained";
+                let timer;
+                const timeout = new Promise((resolve) => {
+                    timer = setTimeout(() => resolve("still_draining"), BG_NOTIFY_DRAIN_WINDOW_MS);
+                    timer.unref?.();
+                });
+                const outcome = await Promise.race([drain.then(() => "drained"), timeout]);
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                return outcome;
+            };
+            const observerNoteFor = (outcome) => observerFailure !== undefined ? " [observer: failed]" : outcome === "still_draining" ? " [observer: still draining]" : "";
             const stepRecorder = new SubagentStepRecorder(ctx.toolCallId);
             const toolStatsCounter = makeToolStatsCounter(opts.name ?? DEFAULT_SUBAGENT_TOOL_NAME);
+            let assistantTextTail = "";
             const recordingForward = (e) => {
                 stepRecorder.record(e);
+                if (e.type === "text_delta" && e.parentToolCallId === ctx.toolCallId) {
+                    assistantTextTail = (assistantTextTail + e.delta).slice(-PARTIAL_FINDINGS_MAX_CHARS);
+                }
                 if (e.type === "tool_start")
                     toolStatsCounter.record(e.toolName, e.args);
                 if (e.type === "task_progress") {
@@ -860,13 +969,14 @@ function makeSubagentTool(opts, depth, excluded) {
                 limits: childLimits,
                 signal,
             });
-            const tryRetainChild = async (ledger) => {
+            const tryRetainChild = async (ledger, entryTtlMs) => {
                 if (!ledger)
                     return undefined;
                 const childSessionId = uuidv7();
                 const { signal: _spawnSignal, ...plainSpec } = buildChildSpec(undefined);
                 let entry = ledger.register(ctx.toolCallId, {
                     childSessionId,
+                    ...(entryTtlMs !== undefined ? { ttlMs: entryTtlMs } : {}),
                     ...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
                     specSnapshot: Object.freeze({
                         ...plainSpec,
@@ -897,9 +1007,85 @@ function makeSubagentTool(opts, depth, excluded) {
                         await ledger.evict(ctx.toolCallId);
                         entry = undefined;
                     }
+                    if (entry !== undefined && (ledger.disposed || ledger.get(ctx.toolCallId) !== entry)) {
+                        try {
+                            await opts.runner.sessions.unpin?.(childSessionId);
+                        }
+                        catch {
+                        }
+                        try {
+                            await opts.runner.sessions.release(childSessionId);
+                        }
+                        catch {
+                        }
+                        entry = undefined;
+                    }
                 }
                 return entry;
             };
+            const retainFailedChildSession = async (childSessionId) => {
+                const releaseChild = async () => {
+                    try {
+                        await opts.runner.sessions.unpin?.(childSessionId);
+                    }
+                    catch {
+                    }
+                    try {
+                        await opts.runner.sessions.release(childSessionId);
+                    }
+                    catch {
+                    }
+                };
+                const ledger = ctx.sessionId !== undefined
+                    ? getOrCreateSessionRetainLedger(ctx.sessionId, { ttlMs: FAILED_SESSION_RETAIN_TTL_MS, max: RETAIN_DEFAULT_MAX })
+                    : ctx.subagentRetain;
+                if (ledger !== undefined && !ledger.disposed) {
+                    if (opts.background)
+                        ensureSessionReapHook(opts.background.registry);
+                    const { signal: _spawnSignal, ...plainSpec } = buildChildSpec(undefined);
+                    const entry = ledger.register(ctx.toolCallId, {
+                        childSessionId,
+                        ttlMs: FAILED_SESSION_RETAIN_TTL_MS,
+                        ...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
+                        specSnapshot: Object.freeze({
+                            ...plainSpec,
+                            tools: [...(plainSpec.tools ?? [])],
+                            ...(plainSpec.limits ? { limits: { ...plainSpec.limits } } : {}),
+                            ...(plainSpec.memory !== undefined && typeof plainSpec.memory === "object" ? { memory: { ...plainSpec.memory } } : {}),
+                            ...(plainSpec.clientContext !== undefined ? { clientContext: { ...plainSpec.clientContext } } : {}),
+                        }),
+                        internalsSnapshot: { ...childInternals },
+                        release: releaseChild,
+                    });
+                    if (entry) {
+                        try {
+                            await opts.runner.sessions.pin?.(childSessionId);
+                        }
+                        catch {
+                            try {
+                                await opts.runner.sessions.unpin?.(childSessionId);
+                            }
+                            catch {
+                            }
+                            ledger.abandon(ctx.toolCallId);
+                            return false;
+                        }
+                        if (ledger.disposed || ledger.get(ctx.toolCallId) !== entry) {
+                            try {
+                                await opts.runner.sessions.unpin?.(childSessionId);
+                            }
+                            catch {
+                            }
+                            return false;
+                        }
+                        ledger.markSettled(ctx.toolCallId);
+                        return true;
+                    }
+                }
+                const timer = setTimeout(() => void releaseChild(), FAILED_SESSION_RETAIN_TTL_MS);
+                timer.unref?.();
+                return true;
+            };
             if (wantsFork) {
                 let forkedId;
                 try {
@@ -1051,6 +1237,7 @@ function makeSubagentTool(opts, depth, excluded) {
                                 summary: `${shortDesc} — ${settledBg === "killed" ? "stopped" : child.status}`,
                                 ...(child.sessionId ? { sessionId: child.sessionId } : {}),
                                 ...(child.result ? { result: child.result.slice(0, 2_000) } : {}),
+                                ...(settledBg === "killed" && child.result ? { partial: true } : {}),
                                 ...residualFork,
                                 resumable: resumableFork,
                                 usage: { tokens: child.stats.tokens, turns: child.stats.turns, costMicroUsd: (child.stats.costMicroUsd ?? 0) + (child.stats.nested?.costMicroUsd ?? 0) },
@@ -1231,7 +1418,7 @@ task_id: ${taskId}
                     : ctx.subagentRetain;
                 if (sessionScopedBg && bgRetainLedger)
                     ensureSessionReapHook(bg.registry);
-                const bgRetain = await tryRetainChild(bgRetainLedger);
+                const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined);
                 if (bgRetain)
                     stepRecorder.lockTo(bgRetain.childSessionId);
                 const bgSpec = { ...buildChildSpec(abort.signal), ...(bgRetain ? { sessionId: bgRetain.childSessionId } : {}) };
@@ -1315,6 +1502,7 @@ task_id: ${taskId}
                     }) ??
                         (abort.signal.aborted ? "killed" : ok ? "completed" : "failed");
                     const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
+                    const observerNote = observerNoteFor(await startBoundedObserverDrain());
                     const residual = residualFields();
                     const resumableBg = bgRetain !== undefined && settled !== "killed";
                     sinkEmit({
@@ -1324,7 +1512,7 @@ task_id: ${taskId}
                         ...(child.sessionId ? { sessionId: child.sessionId, transcriptId: child.sessionId } : {}),
                         status: settled,
                         ...(stoppedBy !== undefined ? { stoppedBy } : {}),
-                        summary: `${shortDesc} — ${settled === "killed" ? "stopped" : child.status}`,
+                        summary: `${shortDesc} — ${settled === "killed" ? "stopped" : child.status}${observerNote}`,
                         ...residual,
                         resumable: resumableBg,
                         usage: { tokens: child.stats.tokens, turns: child.stats.turns, costMicroUsd: (child.stats.costMicroUsd ?? 0) + (child.stats.nested?.costMicroUsd ?? 0) },
@@ -1336,9 +1524,10 @@ task_id: ${taskId}
                             toolUseId: ctx.toolCallId,
                             status: settled,
                             ...(stoppedBy !== undefined ? { stoppedBy } : {}),
-                            summary: `${shortDesc} — ${settled === "killed" ? "stopped" : child.status}`,
+                            summary: `${shortDesc} — ${settled === "killed" ? "stopped" : child.status}${observerNote}`,
                             ...(child.sessionId ? { sessionId: child.sessionId } : {}),
                             ...(child.result ? { result: child.result.slice(0, 2_000) } : {}),
+                            ...(settled === "killed" && child.result ? { partial: true } : {}),
                             ...residual,
                             resumable: resumableBg,
                             usage: { tokens: child.stats.tokens, turns: child.stats.turns, costMicroUsd: (child.stats.costMicroUsd ?? 0) + (child.stats.nested?.costMicroUsd ?? 0) },
@@ -1346,11 +1535,9 @@ task_id: ${taskId}
                     }
                     catch {
                     }
-                    void drainAndReleaseObserver();
                 })
-                    .catch((e) => {
+                    .catch(async (e) => {
                     closeObserverWindow("failed");
-                    void drainAndReleaseObserver();
                     dropHostAbortListener();
                     void finishWorktree();
                     const killed = abort.signal.aborted;
@@ -1363,13 +1550,14 @@ task_id: ${taskId}
                     const msg = e instanceof Error ? e.message : String(e);
                     const settled = bg.registry.settleBackgroundAgent(taskId, { status: killed ? "killed" : "failed", error: msg }) ?? (killed ? "killed" : "failed");
                     const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
+                    const observerNote = observerNoteFor(await startBoundedObserverDrain());
                     sinkEmit({
                         kind: "terminal",
                         taskId,
                         sessionScoped: sessionScopedBg === true,
                         status: settled,
                         ...(stoppedBy !== undefined ? { stoppedBy } : {}),
-                        summary: `${shortDesc} — ${settled === "failed" ? `failed: ${msg}` : settled}`.slice(0, 300),
+                        summary: `${shortDesc} — ${settled === "failed" ? `failed: ${msg}` : settled}${observerNote}`.slice(0, 300),
                     });
                     try {
                         notify?.({
@@ -1378,7 +1566,7 @@ task_id: ${taskId}
                             toolUseId: ctx.toolCallId,
                             status: settled,
                             ...(stoppedBy !== undefined ? { stoppedBy } : {}),
-                            summary: `${shortDesc} — ${settled === "failed" ? `failed: ${msg}` : settled}`.slice(0, 300),
+                            summary: `${shortDesc} — ${settled === "failed" ? `failed: ${msg}` : settled}${observerNote}`.slice(0, 300),
                         }, { priority: "later" });
                     }
                     catch {
@@ -1467,11 +1655,17 @@ task_id: ${taskId}
                     details: { error: child.status === "needs_review" ? "unexpected.needs_review" : "unexpected.suspended", checkpointToken: child.checkpointToken },
                 };
             }
+            let failureRetained = false;
             if (!retainEntry) {
-                try {
-                    await opts.runner.sessions.release(child.sessionId);
+                if (child.status !== "completed" && opts.retainFailedSessions !== false) {
+                    failureRetained = await retainFailedChildSession(child.sessionId);
                 }
-                catch {
+                if (!failureRetained) {
+                    try {
+                        await opts.runner.sessions.release(child.sessionId);
+                    }
+                    catch {
+                    }
                 }
             }
             const worktreeLine = await finishWorktree();
@@ -1484,9 +1678,13 @@ task_id: ${taskId}
                 child.blockedReason ? `blocked_reason: ${inlineUntrusted(child.blockedReason, REPORT_FIELD_MAX)}` : "",
                 child.errorMessage ? `error: ${inlineUntrusted(child.errorMessage, REPORT_FIELD_MAX)}` : "",
                 errClass ? `error_kind: ${errClass.errorKind} (retryable: ${errClass.retryable})` : "",
+                observerFailure !== undefined ? `observer: failed (${inlineUntrusted(observerFailure, REPORT_FIELD_MAX)})` : "",
                 `stats: turns=${child.stats.turns} tokens=${child.stats.tokens}`,
-                retainEntry ? `transcript_id: ${child.sessionId}` : "",
+                retainEntry || failureRetained ? `transcript_id: ${child.sessionId}` : "",
                 retainEntry ? `resumable: true` : "",
+                failureRetained
+                    ? `session_retained: this child's session is kept for a short time (~15 min) so its transcript stays inspectable via transcript_id; it is released automatically afterwards.`
+                    : "",
                 ...(child.status !== "completed"
                     ? (() => {
                         const rs = stepRecorder.recentSteps();
@@ -1506,7 +1704,11 @@ task_id: ${taskId}
                     : []),
                 "",
                 "result:",
-                child.result ? delimitUntrusted("sub-agent result", child.result) : "(no text result)",
+                child.result
+                    ? delimitUntrusted("sub-agent result", child.result)
+                    : child.status !== "completed" && assistantTextTail.trim() !== ""
+                        ? `partial findings (the child's last assistant text before it stopped):\n${delimitUntrusted("sub-agent partial findings", assistantTextTail.trim())}`
+                        : "(no text result)",
                 "",
                 "Verify this result before concluding. If it leaves more to do, continue or delegate again.",
             ].filter(Boolean);