@sema-agent/client-core 0.94.0 → 0.96.0

package/dist/fleet/fleetLedger.js

@@ -1,4 +1,5 @@
 import { hostLog } from '../host.js';
+import { invokeHostCallbackIsolated } from '../hostCallbackGuard.js';
 import { engineWireDebugEnabled } from '../engineWireTarget.js';
 import { engineSessionParam, engineSessionParamFor } from '../engineSessionParam.js';
 import { enqueueBgChildNotification, isOwnWorkflowRun } from '../notifications.js';
@@ -7,9 +8,15 @@ import { rowIdTail } from '../workflow.js';
 import { recordEngineTranscriptId } from '../subagent/engineDelegatedPrompt.js';
 import { recordFleetRowAgentType } from './fleetRowAgentType.js';
 import { DEFAULT_SESSION_KEY } from '../sessionSlot.js';
-import { TERMINAL_FLEET_TASK_STATUSES, projectTasks, projectWorkflows, wireCycleSeq, wireParentId, } from './fleetProjection.js';
+import { isSdkFleetTaskTerminal, isSdkFleetTaskTerminalNotSuccess } from '../terminalStatuses.js';
+import { projectTasks, projectWorkflows, wireCycleSeq, wireParentId, } from './fleetProjection.js';
 import { isInStreamDrainingEnd } from '../wireErrorTriage.js';
+import { cycleSeqOrder, cycleSeqValue } from '../cycleOrder.js';
 export const TERMINAL_RETAIN_MS = 60_000;
+function hasRowId(row) {
+    const id = row?.id;
+    return typeof id === 'string' && id.length > 0;
+}
 const liveBgViews = new Map();
 function viewsFor(sessionKey) {
     return liveBgViews.get(sessionKey) ?? new Set();
@@ -59,6 +66,16 @@ export function clearAllRetainedFleetRowsFor(sessionKey) {
         }
     }
 }
+export function forgetSettledTerminalRow(id) {
+    return forgetSettledTerminalRowFor(DEFAULT_SESSION_KEY, id);
+}
+export function forgetSettledTerminalRowFor(sessionKey, id) {
+    let forgotten = false;
+    for (const view of viewsFor(sessionKey))
+        if (view.forgetSettledTerminal(id))
+            forgotten = true;
+    return forgotten;
+}
 export function __resetFleetLedgerRegistryForTests() {
     liveBgViews.clear();
 }
@@ -88,7 +105,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         if (gen === undefined || tail.length === 0)
             return;
         const prior = cycleWatermark.get(tail);
-        if (prior !== undefined && prior >= gen)
+        if (prior !== undefined && cycleSeqOrder(prior, gen) !== 'before')
             return;
         cycleWatermark.delete(tail);
         if (cycleWatermark.size >= CYCLE_WATERMARK_MAX) {
@@ -98,6 +115,25 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         }
         cycleWatermark.set(tail, gen);
     }
+    const settledTerminal = new Map();
+    const SETTLED_TERMINAL_MAX = 512;
+    function noteSettledTerminal(tail, row) {
+        if (tail.length === 0 || typeof row.status !== 'string')
+            return;
+        const gen = wireCycleSeq(row);
+        const recordedGen = settledTerminal.get(tail)?.cycleSeq;
+        if (cycleSeqOrder(gen, recordedGen) === 'before')
+            return;
+        if (cycleSeqOrder(gen, cycleWatermark.get(tail)) === 'before')
+            return;
+        settledTerminal.delete(tail);
+        if (settledTerminal.size >= SETTLED_TERMINAL_MAX) {
+            const oldest = settledTerminal.keys().next().value;
+            if (oldest !== undefined)
+                settledTerminal.delete(oldest);
+        }
+        settledTerminal.set(tail, { status: row.status, cycleSeq: gen });
+    }
     let droppedMalformed = 0;
     let droppedUnknownFrame = 0;
     let droppedForeignBgNotification = 0;
@@ -127,14 +163,48 @@ export function createFleetLedger(hooks = {}, opts = {}) {
             ...(typeof r.name === 'string' && r.name.length > 0 ? { name: r.name } : {}),
             status: r.status ?? 'unknown',
             ...(parentId !== undefined ? { parentId } : {}),
+            ...(typeof r.sourceLane === 'string' && r.sourceLane.length > 0 ? { sourceLane: r.sourceLane } : {}),
             ...(retired ? { retiredByNotification: true } : {}),
         };
     };
+    function settleTerminalRow(row, receivedAtMs) {
+        taskMap.delete(row.id);
+        rowMeta.delete(row.id);
+        retained.set(row.id, { row, expireAt: receivedAtMs + TERMINAL_RETAIN_MS });
+        const tail = rowIdTail(row.id);
+        for (const id of [...retained.keys()]) {
+            if (id !== row.id && rowIdTail(id) === tail)
+                retained.delete(id);
+        }
+        noteSettledTerminal(tail, row);
+    }
+    function admitRow(row, receivedAtMs) {
+        if (isSdkFleetTaskTerminal(row.status)) {
+            settleTerminalRow(row, receivedAtMs);
+            return;
+        }
+        taskMap.set(row.id, row);
+        rowMeta.set(row.id, { receivedAtMs });
+        const tail = rowIdTail(row.id);
+        for (const id of [...retained.keys()]) {
+            if (rowIdTail(id) === tail)
+                retained.delete(id);
+        }
+        settledTerminal.delete(tail);
+        clearBgTerminalFacts(tail);
+    }
+    function forgetSettledTerminalRowOf(id) {
+        if (taskMap.has(id))
+            return false;
+        const pooled = retained.get(id);
+        if (pooled === undefined || pooled.retiredByNotification === true)
+            return false;
+        retained.delete(id);
+        return true;
+    }
     const bgView = {
         read: () => {
-            const rows = [...taskMap.values()]
-                .filter(r => !TERMINAL_FLEET_TASK_STATUSES.has(r.status ?? ''))
-                .map(r => toBgTask(r, false));
+            const rows = [...taskMap.values()].map(r => toBgTask(r, false));
             const nowMs = nowFn();
             for (const [id, r] of retained) {
                 if (r.retiredByNotification !== true)
@@ -151,6 +221,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         clearRetained: () => {
             retained.clear();
         },
+        forgetSettledTerminal: id => forgetSettledTerminalRowOf(id),
     };
     {
         let views = liveBgViews.get(sessionKey);
@@ -176,33 +247,35 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 wfMap.clear();
                 rowMeta.clear();
                 const receivedAtMs = nowFn();
+                const rows = [];
                 for (const row of frame.tasks) {
-                    taskMap.set(row.id, row);
-                    rowMeta.set(row.id, { receivedAtMs });
-                    if (!TERMINAL_FLEET_TASK_STATUSES.has(row.status ?? '')) {
-                        const tail = rowIdTail(row.id);
-                        for (const id of [...retained.keys()]) {
-                            if (rowIdTail(id) === tail)
-                                retained.delete(id);
-                        }
-                        clearBgTerminalFacts(tail);
+                    if (!hasRowId(row)) {
+                        droppedMalformed++;
+                        debug('[fleet-frame] MALFORMED snapshot task row dropped(row 或 row.id 缺席 / 非串)');
+                        continue;
                     }
+                    rows.push(row);
                 }
+                for (const row of rows)
+                    if (isSdkFleetTaskTerminal(row.status))
+                        admitRow(row, receivedAtMs);
+                for (const row of rows)
+                    if (!isSdkFleetTaskTerminal(row.status))
+                        admitRow(row, receivedAtMs);
                 for (const row of frame.workflows)
                     wfMap.set(row.id, row);
                 break;
             }
             case 'task': {
                 const row = frame.row;
-                if (!row?.id) {
+                if (!hasRowId(row)) {
                     droppedMalformed++;
-                    debug('[fleet-frame] MALFORMED task frame dropped(row 或 row.id 缺席)');
+                    debug('[fleet-frame] MALFORMED task frame dropped(row 或 row.id 缺席 / 非串)');
                     break;
                 }
                 const receivedAtMs = nowFn();
-                taskMap.set(row.id, row);
+                admitRow(row, receivedAtMs);
                 raiseCycleWatermark(rowIdTail(row.id), wireCycleSeq(row));
-                rowMeta.set(row.id, { receivedAtMs });
                 debug(`[fleet-row] id=${row.id} parent=${row.parentId ?? '-'} agentType=${row.agentType ?? '-'}` +
                     ` agentName=${row.agentName ?? '-'} name=${row.name ?? '-'} status=${row.status ?? '-'}` +
                     ` tokens=${row.tokens ?? '-'} parentToolCallId=${row.parentToolCallId ?? '-'}`);
@@ -224,54 +297,37 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                     recordEngineTranscriptId(rowIdTail(row.id), row.transcriptId);
                 }
                 recordFleetRowAgentType(rowIdTail(row.id), row.agentType);
-                if (TERMINAL_FLEET_TASK_STATUSES.has(row.status ?? '')) {
-                    retained.set(row.id, { row, expireAt: receivedAtMs + TERMINAL_RETAIN_MS });
-                    const tailT = rowIdTail(row.id);
-                    for (const id of [...retained.keys()]) {
-                        if (id !== row.id && rowIdTail(id) === tailT)
-                            retained.delete(id);
-                    }
-                }
-                else {
-                    retained.delete(row.id);
-                    const tail = rowIdTail(row.id);
-                    for (const id of [...retained.keys()]) {
-                        if (id !== row.id && rowIdTail(id) === tail)
-                            retained.delete(id);
-                    }
-                    clearBgTerminalFacts(tail);
-                }
                 break;
             }
             case 'task_remove': {
                 const fr = frame;
-                const removedGen = typeof fr.cycleSeq === 'number' && Number.isInteger(fr.cycleSeq) && fr.cycleSeq >= 1 ? fr.cycleSeq : undefined;
-                const held = taskMap.get(frame.id);
+                const removedGen = cycleSeqValue(fr.cycleSeq);
+                const pooledHeld = retained.get(frame.id);
+                const held = taskMap.get(frame.id) ?? (pooledHeld !== undefined && pooledHeld.retiredByNotification !== true ? pooledHeld.row : undefined);
                 const heldGen = held !== undefined ? wireCycleSeq(held) : undefined;
-                const stale = removedGen !== undefined && heldGen !== undefined && removedGen < heldGen;
+                const stale = cycleSeqOrder(removedGen, heldGen) === 'before';
+                const reason = typeof fr.removeReason === 'string' && fr.removeReason.length > 0 ? fr.removeReason : undefined;
                 if (!stale) {
                     taskMap.delete(frame.id);
                     rowMeta.delete(frame.id);
-                }
-                if (hooks.onTaskRemoved !== undefined) {
-                    const reason = typeof fr.removeReason === 'string' && fr.removeReason.length > 0 ? fr.removeReason : undefined;
-                    try {
-                        const out = hooks.onTaskRemoved({
-                            id: frame.id,
-                            ...(reason !== undefined ? { removeReason: reason } : {}),
-                            ...(removedGen !== undefined ? { cycleSeq: removedGen } : {}),
-                            ...(stale ? { stale: true } : {}),
-                            ...(held === undefined ? { unknownRow: true } : {}),
-                        });
-                        if (out && typeof out.then === 'function') {
-                            void Promise.resolve(out).catch((e) => {
-                                hostLog('debug', `[fleet-frame] onTaskRemoved hook rejected: ${String(e).slice(0, 160)}`);
-                            });
+                    if (reason === undefined) {
+                        const pooled = retained.get(frame.id);
+                        if (pooled !== undefined &&
+                            pooled.row.status === 'killed' &&
+                            cycleSeqOrder(removedGen, wireCycleSeq(pooled.row)) !== 'before' &&
+                            forgetSettledTerminalRowOf(frame.id)) {
+                            debug(`[fleet-frame] settled-level task_remove evicted the stopped row(id=${frame.id})`);
                         }
                     }
-                    catch (e) {
-                        hostLog('debug', `[fleet-frame] onTaskRemoved hook threw: ${String(e).slice(0, 160)}`);
-                    }
+                }
+                if (hooks.onTaskRemoved !== undefined) {
+                    invokeHostCallbackIsolated('[fleet-frame] onTaskRemoved hook', () => hooks.onTaskRemoved?.({
+                        id: frame.id,
+                        ...(reason !== undefined ? { removeReason: reason } : {}),
+                        ...(removedGen !== undefined ? { cycleSeq: removedGen } : {}),
+                        ...(stale ? { stale: true } : {}),
+                        ...(held === undefined ? { unknownRow: true } : {}),
+                    }));
                 }
                 break;
             }
@@ -345,29 +401,30 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                     ? 'own_parent'
                     : 'absent_parent');
         debug(`[fleet-frame] bg_notification taskId=${n.taskId} status=${n.status} seq=${n.seq ?? '-'} accept=${evidence}`);
+        const notifTail = rowIdTail(n.taskId);
         const rowIds = [];
         for (const id of taskMap.keys()) {
-            if (id === n.taskId || rowIdTail(id) === n.taskId)
+            if (rowIdTail(id) === notifTail)
                 rowIds.push(id);
         }
-        if (TERMINAL_FLEET_TASK_STATUSES.has(n.status)) {
+        if (isSdkFleetTaskTerminal(n.status)) {
             if (typeof n.parentTaskId === 'string' && n.parentTaskId) {
                 recordBgParentRun(n.taskId, n.parentTaskId, ing?.session, ing?.sessionKey);
             }
             if (typeof n.transcriptId === 'string' && n.transcriptId.length > 0) {
                 recordEngineTranscriptId(n.taskId, n.transcriptId);
             }
-            const isWashGreen = (prior, next) => next === 'completed' && (prior === 'failed' || prior === 'killed');
+            const isWashGreen = (prior, next) => next === 'completed' && isSdkFleetTaskTerminalNotSuccess(prior);
             const coerced = n.status;
             const nowMs = nowFn();
             const writtenIds = new Set();
             let applied = false;
             let washBlocked = false;
             let staleBlocked = false;
-            const notifSeq = typeof n.seq === 'number' && Number.isInteger(n.seq) && n.seq >= 1 ? n.seq : undefined;
+            const notifSeq = cycleSeqValue(n.seq);
             {
                 const mark = cycleWatermark.get(n.taskId);
-                if (notifSeq !== undefined && mark !== undefined && notifSeq < mark) {
+                if (cycleSeqOrder(notifSeq, mark) === 'before') {
                     staleBlocked = true;
                     debug(`[fleet-frame] bg_notification stale-cycle ignored(watermark=${mark} notif-seq=${notifSeq})`);
                 }
@@ -377,56 +434,39 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 if (!known)
                     continue;
                 const heldGen = wireCycleSeq(known);
-                if (notifSeq !== undefined && heldGen !== undefined && notifSeq < heldGen) {
+                if (cycleSeqOrder(notifSeq, heldGen) === 'before') {
                     staleBlocked = true;
                     debug(`[fleet-frame] bg_notification stale-cycle ignored(row=${id} row-cycle=${heldGen} notif-seq=${notifSeq})`);
                     continue;
                 }
-                const rowStatus = known.status ?? '';
-                if (TERMINAL_FLEET_TASK_STATUSES.has(rowStatus)) {
-                    if (isWashGreen(rowStatus, n.status)) {
-                        washBlocked = true;
-                        debug(`[fleet-frame] bg_notification WASH-GREEN blocked(row=${id} row-status=${rowStatus} notif=${n.status})`);
-                        continue;
-                    }
-                    if (rowStatus !== n.status) {
-                        const upgraded = { ...known, status: coerced };
-                        retained.set(id, { row: upgraded, expireAt: nowMs + TERMINAL_RETAIN_MS });
-                        taskMap.set(id, upgraded);
-                    }
-                    writtenIds.add(id);
-                    applied = true;
-                }
-                else {
-                    const started = known.startedAt;
-                    const meta = rowMeta.get(id);
-                    const frozenElapsed = typeof started === 'number' && started > 0 && started <= nowMs
-                        ? nowMs - started
-                        : meta !== undefined && isElapsedBase(known.elapsedMs)
-                            ? known.elapsedMs + Math.max(0, nowMs - meta.receivedAtMs)
-                            : known.elapsedMs;
-                    taskMap.delete(id);
-                    rowMeta.delete(id);
-                    retained.set(id, {
-                        row: {
-                            ...known,
-                            status: coerced,
-                            ...(typeof frozenElapsed === 'number' ? { elapsedMs: frozenElapsed } : {}),
-                        },
-                        expireAt: nowMs + TERMINAL_RETAIN_MS,
-                        retiredByNotification: true,
-                    });
-                    writtenIds.add(id);
-                    applied = true;
-                }
+                const started = known.startedAt;
+                const meta = rowMeta.get(id);
+                const frozenElapsed = typeof started === 'number' && started > 0 && started <= nowMs
+                    ? nowMs - started
+                    : meta !== undefined && isElapsedBase(known.elapsedMs)
+                        ? known.elapsedMs + Math.max(0, nowMs - meta.receivedAtMs)
+                        : known.elapsedMs;
+                taskMap.delete(id);
+                rowMeta.delete(id);
+                retained.set(id, {
+                    row: {
+                        ...known,
+                        status: coerced,
+                        ...(typeof frozenElapsed === 'number' ? { elapsedMs: frozenElapsed } : {}),
+                    },
+                    expireAt: nowMs + TERMINAL_RETAIN_MS,
+                    retiredByNotification: true,
+                });
+                writtenIds.add(id);
+                applied = true;
             }
             for (const [id, entry] of retained) {
                 if (writtenIds.has(id))
                     continue;
-                if (id !== n.taskId && rowIdTail(id) !== n.taskId)
+                if (rowIdTail(id) !== notifTail)
                     continue;
                 const retainedGen = wireCycleSeq(entry.row);
-                if (notifSeq !== undefined && retainedGen !== undefined && notifSeq < retainedGen) {
+                if (cycleSeqOrder(notifSeq, retainedGen) === 'before') {
                     staleBlocked = true;
                     debug(`[fleet-frame] bg_notification stale-cycle ignored(retained=${id} row-cycle=${retainedGen} notif-seq=${notifSeq})`);
                     continue;
@@ -452,16 +492,18 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 (applied ||
                     (!washBlocked &&
                         (() => {
-                            const prior = getBgTerminalFacts(n.taskId);
-                            if (prior === undefined)
-                                return true;
-                            if (notifSeq !== undefined && prior.cycleSeq !== undefined) {
-                                if (notifSeq < prior.cycleSeq)
+                            for (const prior of [getBgTerminalFacts(n.taskId), settledTerminal.get(notifTail)]) {
+                                if (prior === undefined)
+                                    continue;
+                                const order = cycleSeqOrder(notifSeq, prior.cycleSeq);
+                                if (order === 'before')
+                                    return false;
+                                if (order === 'after')
+                                    continue;
+                                if (isWashGreen(prior.status, n.status))
                                     return false;
-                                if (notifSeq > prior.cycleSeq)
-                                    return true;
                             }
-                            return !isWashGreen(prior.status, n.status);
+                            return true;
                         })()));
             if (factsAccepted)
                 raiseCycleWatermark(n.taskId, notifSeq);
@@ -487,17 +529,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 debug(`[fleet-frame] bg_notification state-plane rejected as wash-green echo(taskId=${n.taskId} notif=${n.status})—— 通知面照常入队`);
             }
         }
-        try {
-            const out = hooks.onBgNotificationAccepted?.(n, rowIds, evidence);
-            if (out && typeof out.then === 'function') {
-                void Promise.resolve(out).catch((e) => {
-                    hostLog('debug', `[fleet-frame] onBgNotificationAccepted hook rejected: ${String(e).slice(0, 160)}`);
-                });
-            }
-        }
-        catch (e) {
-            hostLog('debug', `[fleet-frame] onBgNotificationAccepted hook threw: ${String(e).slice(0, 160)}`);
-        }
+        invokeHostCallbackIsolated('[fleet-frame] onBgNotificationAccepted hook', () => hooks.onBgNotificationAccepted?.(n, rowIds, evidence));
         enqueueBgChildNotification({
             taskId: n.taskId,
             status: n.status,
@@ -508,8 +540,6 @@ export function createFleetLedger(hooks = {}, opts = {}) {
     function project(nowMs, opts) {
         const viewingTaskId = opts.viewingTaskId;
         const liveRows = [...taskMap.values()].map(r => {
-            if (TERMINAL_FLEET_TASK_STATUSES.has(r.status ?? ''))
-                return r;
             const started = r.startedAt;
             if (typeof started === 'number' && started > 0 && started <= nowMs) {
                 return { ...r, elapsedMs: nowMs - started };
@@ -603,6 +633,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         wfMap.clear();
         rowMeta.clear();
         retained.clear();
+        settledTerminal.clear();
         contentAnchorSet = false;
         contentAnchor = undefined;
         debug(`[fleet-frame] 会话锚变更(${from ?? '-'} → ${to ?? '-'})⇒ 清上一会话的行/留存` +

package/dist/fleet/fleetProjection.d.ts

@@ -10,7 +10,6 @@ export interface FleetTaskView {
     elapsedMs?: number;
     tokens?: number;
     tokenDir: 'down' | 'up';
-    queuedCount?: number;
     awaitingPlanApproval: boolean;
     descendantCount: number;
     viewed: boolean;
@@ -31,6 +30,7 @@ export interface FleetTaskView {
     }>;
     cycleSeq?: number;
     retiredBy?: string;
+    workspaceSnapshot?: 'failed';
 }
 export interface FleetRowUsage {
     totalTokens?: number;
@@ -51,9 +51,7 @@ export interface FleetWorkflowView {
     tokens?: number;
     failedCount?: number;
     startedCount?: number;
-    errorCode?: string;
 }
-export declare const TERMINAL_FLEET_TASK_STATUSES: ReadonlySet<string>;
 export declare function coerceTaskStatus(s: string): FleetTaskStatus;
 export declare function coerceWorkflowStatus(s: string | undefined): FleetTaskStatus;
 export declare const CONTROL_TOOL_VERBS: ReadonlySet<string>;

package/dist/fleet/fleetProjection.js

@@ -1,12 +1,8 @@
 import { collapseLabel, escapeDisplayControlChars, taskDescFromName } from '../fleetTaskDesc.js';
 import { rowIdTail } from '../workflow.js';
+import { cycleSeqValue } from '../cycleOrder.js';
 import { frozenSet } from '../frozenSet.js';
 import { CORE_RESERVED_AGENT_NAMES } from '../generated/engineFactTables.js';
-export const TERMINAL_FLEET_TASK_STATUSES = frozenSet([
-    'completed',
-    'failed',
-    'killed',
-]);
 export function coerceTaskStatus(s) {
     switch (s) {
         case 'queued':
@@ -130,13 +126,15 @@ function wireStoppedBy(r) {
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
 export function wireCycleSeq(r) {
-    const v = r.cycleSeq;
-    return typeof v === 'number' && Number.isInteger(v) && v > 0 ? v : undefined;
+    return cycleSeqValue(r.cycleSeq);
 }
 function wireRetiredBy(r) {
     const v = r.retiredBy;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
+function wireWorkspaceSnapshot(r) {
+    return r.workspaceSnapshot === 'failed' ? 'failed' : undefined;
+}
 export function wireResumable(r) {
     return typeof r.resumable === 'boolean' ? r.resumable : undefined;
 }
@@ -172,6 +170,7 @@ export function projectTasks(allRows, opts) {
         const editedFiles = wireEditedFiles(r);
         const cycleSeq = wireCycleSeq(r);
         const retiredBy = wireRetiredBy(r);
+        const workspaceSnapshot = wireWorkspaceSnapshot(r);
         const task = {
             id: r.id,
             name: deriveAgentLabel(r.agentType, r.agentName, r.name, r.id),
@@ -182,7 +181,6 @@ export function projectTasks(allRows, opts) {
             ...wireNumberKey('elapsedMs', wireDuration(r.elapsedMs)),
             ...wireNumberKey('tokens', wireCount(r.tokens)),
             tokenDir: 'down',
-            ...wireNumberKey('queuedCount', wireCount(r.queuedCount)),
             awaitingPlanApproval: r.awaitingPlanApproval ?? false,
             descendantCount: childCount.get(r.id) ?? 0,
             viewed: viewingTaskId !== undefined && rowIdTail(r.id) === viewingTaskId,
@@ -197,6 +195,7 @@ export function projectTasks(allRows, opts) {
             ...(editedFiles !== undefined ? { editedFiles } : {}),
             ...(cycleSeq !== undefined ? { cycleSeq } : {}),
             ...(retiredBy !== undefined ? { retiredBy } : {}),
+            ...(workspaceSnapshot !== undefined ? { workspaceSnapshot } : {}),
         };
         return task;
     });
@@ -213,7 +212,6 @@ function wireNumberKey(key, v) {
 export function projectWorkflows(rows) {
     return rows.map(r => {
         const startedCount = wireStartedCount(r);
-        const errorCode = wireErrorCode(r);
         return {
             id: r.id,
             name: collapseLabel(r.name ?? '') || 'Dynamic workflow',
@@ -225,14 +223,9 @@ export function projectWorkflows(rows) {
             ...wireNumberKey('tokens', wireCount(r.tokens)),
             ...wireNumberKey('failedCount', wireCount(r.failedCount)),
             ...(startedCount !== undefined ? { startedCount } : {}),
-            ...(errorCode !== undefined ? { errorCode } : {}),
         };
     });
 }
-function wireErrorCode(r) {
-    const v = r.errorCode;
-    return typeof v === 'string' && v.length > 0 ? v : undefined;
-}
 const FLEET_TASK_VIEW_KEY_TUPLE = [
     'id',
     'name',
@@ -243,7 +236,6 @@ const FLEET_TASK_VIEW_KEY_TUPLE = [
     'elapsedMs',
     'tokens',
     'tokenDir',
-    'queuedCount',
     'awaitingPlanApproval',
     'descendantCount',
     'viewed',
@@ -258,6 +250,7 @@ const FLEET_TASK_VIEW_KEY_TUPLE = [
     'editedFiles',
     'cycleSeq',
     'retiredBy',
+    'workspaceSnapshot',
 ];
 export const FLEET_TASK_VIEW_KEYS = FLEET_TASK_VIEW_KEY_TUPLE;
 const FLEET_WORKFLOW_VIEW_KEY_TUPLE = [
@@ -271,7 +264,6 @@ const FLEET_WORKFLOW_VIEW_KEY_TUPLE = [
     'tokens',
     'failedCount',
     'startedCount',
-    'errorCode',
 ];
 export const FLEET_WORKFLOW_VIEW_KEYS = FLEET_WORKFLOW_VIEW_KEY_TUPLE;
 const FLEET_TASK_ROW_WIRE_KEY_TUPLE = [
@@ -300,6 +292,7 @@ const FLEET_TASK_ROW_WIRE_KEY_TUPLE = [
     'editedFiles',
     'cycleSeq',
     'retiredBy',
+    'workspaceSnapshot',
 ];
 export const FLEET_TASK_ROW_WIRE_KEYS = FLEET_TASK_ROW_WIRE_KEY_TUPLE;
 const FLEET_WORKFLOW_ROW_WIRE_KEY_TUPLE = [
@@ -319,9 +312,9 @@ export const FLEET_TASK_ROW_KEYS_NOT_PROJECTED = {
     sourceLane: {
         kind: 'by-design',
         owner: 'client-core 规范重构轮',
-        reason: 'SDK 3.0.0 新键([2070]① 让位半场:前台 delegation 复合 id 行带 "run-leg" 标)。两仓现零消费面 ——' +
-            '#95 纪律:没人读的键不盲投。已知潜在消费方=壳 wf-panel 的双生行过滤(现走 taskId 台账补偿),' +
-            '若迁到本键判别则届时投影并删本条(那是行为改动,单独批)。',
+        reason: 'SDK 3.0.0 新键([2070]① 让位半场:前台 delegation 复合 id 行带 "run-leg" 标)。**渲染视图**(FleetTaskView)不投 —— 渲染面没有按车道分支的需求,' +
+            '#95 纪律:没人读的键不盲投。🆕 0.96.0 CC-643 起它有了消费者,但住在另一张读面:在飞 bg 读面行(EngineActiveBgTask)投了它,' +
+            '「这一行是不是后台子代」的单一判定口 isBackgroundSubagentRow 读它(见 fleet/bgSubagentRow.ts);视图不投的理由不变,不是第二份真源。',
     },
     agentType: {
         kind: 'by-design',
@@ -337,6 +330,13 @@ export const FLEET_TASK_ROW_KEYS_NOT_PROJECTED = {
         owner: 'client-core 规范重构轮',
         reason: '同 agentType:两位在本层合成一个身份 label,分开带出去等于把 187 的 tjl 规则推给每个消费端各写一遍。',
     },
+    queuedCount: {
+        kind: 'by-design',
+        owner: 'client-core 0.95.0 CC-388',
+        reason: '幻影键:sdk 行型仍声明它,但任何 server 版本都不发(生产侧已整只删除,零生产者,契约里也从没列过)。' +
+            '投影一个永远缺席的可选位 = 假线索(读者以为「队列深度已经报了」),所以视图上不留位。' +
+            'sdk 在下一个 major 删掉这条声明的同批,本条与 `FLEET_TASK_ROW_WIRE_KEYS` 的 `queuedCount` 一起删;真要队列深度 = 带生产者的新键,不是复活这一个。',
+    },
     workflowRunId: {
         kind: 'by-design',
         owner: 'client-core 规范重构轮',

package/dist/fleetAgentPanelProjection.d.ts

@@ -1,20 +1,7 @@
-export interface FleetAgentRowLike {
-    id: string;
-    name?: string;
-    description?: string;
-    status?: string;
-    tokens?: number;
-    toolUses?: number;
-    transcriptId?: string;
-    currentTool?: {
-        toolName: string;
-        target?: string;
-    };
-    startedAt?: number;
-    cycleSeq?: number;
-    parentToolCallId?: string;
-}
-export declare const ABSENT_SETTLE_MS = 30000;
+import { ABSENT_SETTLE_MS } from './panelReduce.js';
+import type { FleetAgentRowLike } from './fleetAgentRowLike.js';
+export type { FleetAgentRowLike };
+export { ABSENT_SETTLE_MS };
 export declare function resetFleetAgentPanelProjection(): void;
 export declare function resetFleetAgentPanelProjectionFor(sessionKey: string): void;
 export declare function fleetAgentProjectionSize(): number;