@sema-agent/client-core 0.95.0 → 0.97.0

package/dist/fleet/bgSubagentRow.d.ts

@@ -0,0 +1,15 @@
+import type { FleetTaskRow } from '@sema-agent/sdk';
+export declare const DURABLE_AGENT_HANDLE_RE: RegExp;
+export declare function isAgentHandle(rowId: string): boolean;
+export type NonAgentHandleKind = 'background_bash' | 'monitor';
+export declare function nonAgentHandleKind(rowId: string): NonAgentHandleKind | null;
+export type BgSubagentRowFacts = Pick<FleetTaskRow, 'id' | 'parentId' | 'sourceLane'>;
+export declare function isBackgroundSubagentRow(row: BgSubagentRowFacts): boolean;
+export declare function isBackgroundWorkRow(row: BgSubagentRowFacts): boolean;
+export interface BgRowOwnership {
+    readonly scoped: boolean;
+    readonly isOwnRun: (taskIdTail: string) => boolean;
+}
+export declare function liveBgRowOwnership(): BgRowOwnership;
+export declare function liveBgRowOwnershipFor(sessionKey: string): BgRowOwnership;
+export declare function isOwnBackgroundSubagentRow(row: BgSubagentRowFacts, own: BgRowOwnership): boolean;

package/dist/fleet/bgSubagentRow.js

@@ -0,0 +1,67 @@
+import { CORE_DURABLE_AGENT_HANDLE_RE, CORE_TASK_HANDLE_PREFIXES } from '../generated/engineFactTables.js';
+import { DEFAULT_SESSION_KEY } from '../sessionSlot.js';
+import { isOwnEngineRun } from '../subagentContentStore.js';
+import { isWorkflowAgentTaskId, rowIdTail } from '../workflow.js';
+import { isFleetSessionScopedFor } from './fleetLedger.js';
+import { wireParentId } from './fleetProjection.js';
+const _taskTypePins = [true, true];
+void _taskTypePins;
+export const DURABLE_AGENT_HANDLE_RE = CORE_DURABLE_AGENT_HANDLE_RE;
+export function isAgentHandle(rowId) {
+    if (typeof rowId !== 'string' || rowId.length === 0)
+        return false;
+    if (rowIdTail(rowId) !== rowId)
+        return false;
+    return DURABLE_AGENT_HANDLE_RE.test(rowId) || isWorkflowAgentTaskId(rowId);
+}
+const NON_AGENT_HANDLE_TYPES = ['background_bash', 'monitor'];
+export function nonAgentHandleKind(rowId) {
+    if (typeof rowId !== 'string')
+        return null;
+    const prefix = /^([a-z])[0-9a-f]{16}$/.exec(rowIdTail(rowId))?.[1];
+    if (prefix === undefined)
+        return null;
+    for (const type of NON_AGENT_HANDLE_TYPES)
+        if (CORE_TASK_HANDLE_PREFIXES[type] === prefix)
+            return type;
+    return null;
+}
+const RUN_LEG_LANE = 'run-leg';
+function isForegroundDelegationRow(row) {
+    return rowIdTail(row.id) !== row.id || row.sourceLane === RUN_LEG_LANE;
+}
+function hasRowId(row) {
+    return typeof row?.id === 'string' && row.id.length > 0;
+}
+export function isBackgroundSubagentRow(row) {
+    if (!hasRowId(row))
+        return false;
+    if (isForegroundDelegationRow(row))
+        return false;
+    if (nonAgentHandleKind(row.id) !== null)
+        return false;
+    if (wireParentId(row) !== undefined)
+        return true;
+    return isAgentHandle(row.id);
+}
+export function isBackgroundWorkRow(row) {
+    if (isBackgroundSubagentRow(row))
+        return true;
+    if (!hasRowId(row))
+        return false;
+    return !isForegroundDelegationRow(row) && nonAgentHandleKind(row.id) !== null;
+}
+export function liveBgRowOwnership() {
+    return liveBgRowOwnershipFor(DEFAULT_SESSION_KEY);
+}
+export function liveBgRowOwnershipFor(sessionKey) {
+    return { scoped: isFleetSessionScopedFor(sessionKey), isOwnRun: isOwnEngineRun };
+}
+export function isOwnBackgroundSubagentRow(row, own) {
+    if (!isBackgroundSubagentRow(row))
+        return false;
+    if (own.scoped)
+        return true;
+    const parentId = wireParentId(row);
+    return own.isOwnRun(rowIdTail(row.id)) || (parentId !== undefined && own.isOwnRun(rowIdTail(parentId)));
+}

package/dist/fleet/fleetLedger.d.ts

@@ -6,6 +6,7 @@ export interface EngineActiveBgTask {
     name?: string;
     status: string;
     parentId?: string;
+    sourceLane?: string;
     retiredByNotification?: boolean;
 }
 export interface EngineActiveBgReading {

package/dist/fleet/fleetLedger.js

@@ -13,6 +13,10 @@ import { projectTasks, projectWorkflows, wireCycleSeq, wireParentId, } from './f
 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();
@@ -95,21 +99,48 @@ export function createFleetLedger(hooks = {}, opts = {}) {
     const wfMap = new Map();
     const rowMeta = new Map();
     const retained = new Map();
-    const cycleWatermark = new Map();
-    const CYCLE_WATERMARK_MAX = 512;
-    function raiseCycleWatermark(tail, gen) {
+    const tails = new Map();
+    const TAIL_RECORD_MAX = 512;
+    function touchTail(tail) {
+        const prior = tails.get(tail);
+        tails.delete(tail);
+        if (prior === undefined && tails.size >= TAIL_RECORD_MAX) {
+            const held = new Set();
+            for (const id of taskMap.keys())
+                held.add(rowIdTail(id));
+            for (const id of retained.keys())
+                held.add(rowIdTail(id));
+            for (const candidate of tails.keys()) {
+                if (held.has(candidate))
+                    continue;
+                tails.delete(candidate);
+                break;
+            }
+        }
+        const rec = prior ?? { gen: undefined, settled: undefined };
+        tails.set(tail, rec);
+        return rec;
+    }
+    function raiseTailGen(tail, gen) {
         if (gen === undefined || tail.length === 0)
             return;
-        const prior = cycleWatermark.get(tail);
+        const prior = tails.get(tail)?.gen;
         if (prior !== undefined && cycleSeqOrder(prior, gen) !== 'before')
             return;
-        cycleWatermark.delete(tail);
-        if (cycleWatermark.size >= CYCLE_WATERMARK_MAX) {
-            const oldest = cycleWatermark.keys().next().value;
-            if (oldest !== undefined)
-                cycleWatermark.delete(oldest);
-        }
-        cycleWatermark.set(tail, gen);
+        touchTail(tail).gen = gen;
+    }
+    function isFormerGeneration(tail, gen) {
+        return cycleSeqOrder(gen, tails.get(tail)?.gen) === 'before';
+    }
+    function noteSettledTerminal(tail, row) {
+        if (tail.length === 0 || typeof row.status !== 'string')
+            return;
+        touchTail(tail).settled = { status: row.status, cycleSeq: wireCycleSeq(row) };
+    }
+    function withdrawSettledTerminal(tail) {
+        const rec = tails.get(tail);
+        if (rec !== undefined)
+            rec.settled = undefined;
     }
     let droppedMalformed = 0;
     let droppedUnknownFrame = 0;
@@ -140,28 +171,67 @@ 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, tail, receivedAtMs) {
+        taskMap.delete(row.id);
+        rowMeta.delete(row.id);
+        for (const id of taskMap.keys()) {
+            if (rowIdTail(id) === tail) {
+                debug(`[fleet-frame] terminal row not retained: tail still in flight on an alias(row=${row.id} alias=${id})`);
+                return;
+            }
+        }
+        retained.set(row.id, { row, expireAt: receivedAtMs + TERMINAL_RETAIN_MS });
+        for (const id of [...retained.keys()]) {
+            if (id !== row.id && rowIdTail(id) === tail)
+                retained.delete(id);
+        }
+        noteSettledTerminal(tail, row);
+    }
+    function admitRow(row, receivedAtMs) {
+        const tail = rowIdTail(row.id);
+        const gen = wireCycleSeq(row);
+        if (isFormerGeneration(tail, gen)) {
+            debug(`[fleet-frame] former-generation row ignored(row=${row.id} row-cycle=${gen} tail-cycle=${tails.get(tail)?.gen})`);
+            return;
+        }
+        raiseTailGen(tail, gen);
+        if (gen !== undefined) {
+            for (const [id, alias] of [...taskMap]) {
+                if (id !== row.id && rowIdTail(id) === tail && cycleSeqOrder(wireCycleSeq(alias), gen) === 'before') {
+                    taskMap.delete(id);
+                    rowMeta.delete(id);
+                }
+            }
+        }
+        if (isSdkFleetTaskTerminal(row.status)) {
+            settleTerminalRow(row, tail, receivedAtMs);
+            return;
+        }
+        taskMap.set(row.id, row);
+        rowMeta.set(row.id, { receivedAtMs });
+        for (const id of [...retained.keys()]) {
+            if (rowIdTail(id) === tail)
+                retained.delete(id);
+        }
+        withdrawSettledTerminal(tail);
+        clearBgTerminalFacts(tail);
+    }
     function forgetSettledTerminalRowOf(id) {
-        const live = taskMap.get(id);
-        if (live !== undefined && !isSdkFleetTaskTerminal(live.status))
+        if (taskMap.has(id))
             return false;
         const pooled = retained.get(id);
-        if (pooled?.retiredByNotification === true)
+        if (pooled === undefined || pooled.retiredByNotification === true)
             return false;
-        if (live === undefined && pooled === undefined)
-            return false;
-        taskMap.delete(id);
-        rowMeta.delete(id);
         retained.delete(id);
         return true;
     }
     const bgView = {
         read: () => {
-            const rows = [...taskMap.values()]
-                .filter(r => !isSdkFleetTaskTerminal(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)
@@ -200,37 +270,49 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 break;
             }
             case 'snapshot': {
-                taskMap.clear();
-                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 (!isSdkFleetTaskTerminal(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);
+                }
+                const keepTails = new Set();
+                const currentTails = new Set();
+                for (const row of rows) {
+                    const tail = rowIdTail(row.id);
+                    if (isFormerGeneration(tail, wireCycleSeq(row)))
+                        keepTails.add(tail);
+                    else
+                        currentTails.add(tail);
+                }
+                for (const tail of currentTails)
+                    keepTails.delete(tail);
+                for (const id of [...taskMap.keys()]) {
+                    if (keepTails.has(rowIdTail(id)))
+                        continue;
+                    taskMap.delete(id);
+                    rowMeta.delete(id);
                 }
+                wfMap.clear();
+                for (const row of rows)
+                    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);
-                raiseCycleWatermark(rowIdTail(row.id), wireCycleSeq(row));
-                rowMeta.set(row.id, { receivedAtMs });
+                admitRow(row, 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 ?? '-'}`);
@@ -252,29 +334,13 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                     recordEngineTranscriptId(rowIdTail(row.id), row.transcriptId);
                 }
                 recordFleetRowAgentType(rowIdTail(row.id), row.agentType);
-                if (isSdkFleetTaskTerminal(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 = cycleSeqValue(fr.cycleSeq);
-                const held = taskMap.get(frame.id);
+                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 = cycleSeqOrder(removedGen, heldGen) === 'before';
                 const reason = typeof fr.removeReason === 'string' && fr.removeReason.length > 0 ? fr.removeReason : undefined;
@@ -391,41 +457,16 @@ export function createFleetLedger(hooks = {}, opts = {}) {
             const writtenIds = new Set();
             let applied = false;
             let washBlocked = false;
-            let staleBlocked = false;
             const notifSeq = cycleSeqValue(n.seq);
-            {
-                const mark = cycleWatermark.get(n.taskId);
-                if (cycleSeqOrder(notifSeq, mark) === 'before') {
-                    staleBlocked = true;
-                    debug(`[fleet-frame] bg_notification stale-cycle ignored(watermark=${mark} notif-seq=${notifSeq})`);
-                }
+            const staleBlocked = isFormerGeneration(notifTail, notifSeq);
+            if (staleBlocked) {
+                debug(`[fleet-frame] bg_notification stale-cycle ignored(tail-cycle=${tails.get(notifTail)?.gen} notif-seq=${notifSeq})`);
             }
-            for (const id of rowIds) {
-                const known = taskMap.get(id);
-                if (!known)
-                    continue;
-                const heldGen = wireCycleSeq(known);
-                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 (isSdkFleetTaskTerminal(rowStatus)) {
-                    if (isWashGreen(rowStatus, n.status)) {
-                        washBlocked = true;
-                        debug(`[fleet-frame] bg_notification WASH-GREEN blocked(row=${id} row-status=${rowStatus} notif=${n.status})`);
+            if (!staleBlocked) {
+                for (const id of rowIds) {
+                    const known = taskMap.get(id);
+                    if (!known)
                         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
@@ -447,51 +488,48 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                     writtenIds.add(id);
                     applied = true;
                 }
-            }
-            for (const [id, entry] of retained) {
-                if (writtenIds.has(id))
-                    continue;
-                if (rowIdTail(id) !== notifTail)
-                    continue;
-                const retainedGen = wireCycleSeq(entry.row);
-                if (cycleSeqOrder(notifSeq, retainedGen) === 'before') {
-                    staleBlocked = true;
-                    debug(`[fleet-frame] bg_notification stale-cycle ignored(retained=${id} row-cycle=${retainedGen} notif-seq=${notifSeq})`);
-                    continue;
-                }
-                const prior = entry.row.status ?? '';
-                if (prior === n.status) {
+                for (const [id, entry] of retained) {
+                    if (writtenIds.has(id))
+                        continue;
+                    if (rowIdTail(id) !== notifTail)
+                        continue;
+                    const prior = entry.row.status ?? '';
+                    if (prior === n.status) {
+                        applied = true;
+                        continue;
+                    }
+                    if (isWashGreen(prior, n.status)) {
+                        washBlocked = true;
+                        debug(`[fleet-frame] bg_notification WASH-GREEN blocked(retained=${id} prior=${prior} notif=${n.status})`);
+                        continue;
+                    }
+                    retained.set(id, {
+                        row: { ...entry.row, status: coerced },
+                        expireAt: nowMs + TERMINAL_RETAIN_MS,
+                        ...(entry.retiredByNotification === true ? { retiredByNotification: true } : {}),
+                    });
                     applied = true;
-                    continue;
                 }
-                if (isWashGreen(prior, n.status)) {
-                    washBlocked = true;
-                    debug(`[fleet-frame] bg_notification WASH-GREEN blocked(retained=${id} prior=${prior} notif=${n.status})`);
-                    continue;
-                }
-                retained.set(id, {
-                    row: { ...entry.row, status: coerced },
-                    expireAt: nowMs + TERMINAL_RETAIN_MS,
-                    ...(entry.retiredByNotification === true ? { retiredByNotification: true } : {}),
-                });
-                applied = true;
             }
             const factsAccepted = !staleBlocked &&
                 (applied ||
                     (!washBlocked &&
                         (() => {
-                            const prior = getBgTerminalFacts(n.taskId);
-                            if (prior === undefined)
-                                return true;
-                            const order = cycleSeqOrder(notifSeq, prior.cycleSeq);
-                            if (order === 'before')
-                                return false;
-                            if (order === 'after')
-                                return true;
-                            return !isWashGreen(prior.status, n.status);
+                            for (const prior of [getBgTerminalFacts(n.taskId), tails.get(notifTail)?.settled]) {
+                                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;
+                            }
+                            return true;
                         })()));
             if (factsAccepted)
-                raiseCycleWatermark(n.taskId, notifSeq);
+                raiseTailGen(notifTail, notifSeq);
             if (factsAccepted) {
                 recordBgTerminalFacts(n.taskId, {
                     status: n.status,
@@ -525,8 +563,6 @@ export function createFleetLedger(hooks = {}, opts = {}) {
     function project(nowMs, opts) {
         const viewingTaskId = opts.viewingTaskId;
         const liveRows = [...taskMap.values()].map(r => {
-            if (isSdkFleetTaskTerminal(r.status))
-                return r;
             const started = r.startedAt;
             if (typeof started === 'number' && started > 0 && started <= nowMs) {
                 return { ...r, elapsedMs: nowMs - started };
@@ -620,6 +656,8 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         wfMap.clear();
         rowMeta.clear();
         retained.clear();
+        for (const rec of tails.values())
+            rec.settled = undefined;
         contentAnchorSet = false;
         contentAnchor = undefined;
         debug(`[fleet-frame] 会话锚变更(${from ?? '-'} → ${to ?? '-'})⇒ 清上一会话的行/留存` +

package/dist/fleet/fleetProjection.d.ts

@@ -30,6 +30,7 @@ export interface FleetTaskView {
     }>;
     cycleSeq?: number;
     retiredBy?: string;
+    workspaceSnapshot?: 'failed';
 }
 export interface FleetRowUsage {
     totalTokens?: number;

package/dist/fleet/fleetProjection.js

@@ -132,6 +132,9 @@ 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;
 }
@@ -167,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),
@@ -191,6 +195,7 @@ export function projectTasks(allRows, opts) {
             ...(editedFiles !== undefined ? { editedFiles } : {}),
             ...(cycleSeq !== undefined ? { cycleSeq } : {}),
             ...(retiredBy !== undefined ? { retiredBy } : {}),
+            ...(workspaceSnapshot !== undefined ? { workspaceSnapshot } : {}),
         };
         return task;
     });
@@ -245,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 = [
@@ -286,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 = [
@@ -305,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',

package/dist/fleetTaskDesc.js

@@ -1,25 +1,12 @@
-import { applyDisplayFace, LEGACY_ESCAPE_FACE, LEGACY_LABEL_FACE } from './displayUntrusted.js';
+import { applyDisplayFace, ESCAPE_FACE, LABEL_FACE, paintAndCap } from './displayUntrusted.js';
 export function escapeDisplayControlChars(s) {
-    return applyDisplayFace(s, LEGACY_ESCAPE_FACE);
+    return applyDisplayFace(s, ESCAPE_FACE);
 }
 export function capForDisplay(raw, max) {
-    const escaped = escapeDisplayControlChars(raw);
-    if (escaped.length <= max)
-        return escaped;
-    let cut = max;
-    const tokenStart = escaped.lastIndexOf('\\', cut - 1);
-    if (tokenStart >= 0 && tokenStart + 6 > cut && /^\\u[0-9A-F]{4}$/.test(escaped.slice(tokenStart, tokenStart + 6))) {
-        cut = tokenStart;
-    }
-    if (cut > 0) {
-        const code = escaped.charCodeAt(cut - 1);
-        if (code >= 0xd800 && code <= 0xdbff)
-            cut -= 1;
-    }
-    return cut > 0 ? escaped.slice(0, cut) : '';
+    return paintAndCap(raw, ESCAPE_FACE, typeof max === 'number' && max > 0 ? max : 0);
 }
 export function collapseLabel(s) {
-    return applyDisplayFace(s, LEGACY_LABEL_FACE);
+    return applyDisplayFace(s, LABEL_FACE);
 }
 export function taskDescFromName(name, agentType, agentName) {
     if (!name || !agentType)

package/dist/gateOutcome.d.ts

@@ -32,9 +32,20 @@ export interface GateModeReleaseView {
     mandate?: string;
     reason?: string;
 }
-export declare const GATE_MODE_RELEASE_REASON_WORDS: readonly ["rule_unreadable", "write_protection_unresolved"];
+export declare const GATE_MODE_RELEASE_REASON_WORDS: readonly ["rule_unreadable", "target_unresolved"];
 export type GateModeReleaseReasonWord = (typeof CORE_MODE_RELEASE_REASONS)[number];
 export declare function isGateModeReleaseReasonWord(v: unknown): v is GateModeReleaseReasonWord;
+export declare function modeReleaseReasonSentence(reason: string | null | undefined): string | undefined;
+export interface ReleaseDisclosureIdentity {
+    readonly toolCallId?: string;
+    readonly callKey?: string;
+    readonly epoch?: string | number;
+}
+export interface ReleaseDisclosureLedger {
+    readonly has: (identity: ReleaseDisclosureIdentity | null | undefined) => boolean;
+    readonly mark: (identity: ReleaseDisclosureIdentity | null | undefined) => void;
+}
+export declare function createReleaseDisclosureLedger(): ReleaseDisclosureLedger;
 export interface SettlementWhoView {
     party: string;
     approver?: string;