@sema-agent/client-core 0.94.0 → 0.95.0

package/dist/executionLaneCapability.js

@@ -1,28 +1,27 @@
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
-import { capsGenerationOf, createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader } from './engineCapReader.js';
+import { ownDataField } from './ownKey.js';
 export function projectExecutionLaneCapability(caps) {
     try {
         if (caps === null || typeof caps !== 'object')
             return undefined;
         if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
             return undefined;
-        if (!Object.hasOwn(caps, 'executionLane'))
-            return { kind: 'not_reported' };
-        const lane = caps.executionLane;
+        const lane = ownDataField(caps, 'executionLane');
         if (lane === undefined)
             return { kind: 'not_reported' };
-        return projectExecutionLaneObject(lane, () => capsGenerationOf(caps).generation === 'new');
+        return projectExecutionLaneObject(lane);
     }
     catch {
         return undefined;
     }
 }
-function projectExecutionLaneObject(lane, newGeneration) {
+function projectExecutionLaneObject(lane) {
     if (lane === null || typeof lane !== 'object' || Array.isArray(lane))
         return undefined;
-    const provider = lane.provider;
-    const toolsOnThisHost = lane.toolsOnThisHost;
+    const provider = ownDataField(lane, 'provider');
+    const toolsOnThisHost = ownDataField(lane, 'toolsOnThisHost');
     if (typeof provider !== 'string' || provider === '')
         return undefined;
     if (typeof toolsOnThisHost !== 'boolean')
@@ -30,26 +29,24 @@ function projectExecutionLaneObject(lane, newGeneration) {
     let isolated;
     let isolatedThrew = false;
     try {
-        isolated = Object.hasOwn(lane, 'isolated') ? lane.isolated : undefined;
+        isolated = ownDataField(lane, 'isolated');
     }
     catch {
         isolatedThrew = true;
     }
     if (!isolatedThrew && typeof isolated === 'boolean')
         return { kind: 'present', view: { provider, toolsOnThisHost, isolated } };
-    const isolatedAbsent = isolatedThrew || isolated !== undefined ? 'unreadable' : !newGeneration() ? 'not_reported' : toolsOnThisHost ? 'unreadable' : 'no_hands';
+    const isolatedAbsent = isolatedThrew || isolated !== undefined ? 'unreadable' : toolsOnThisHost ? 'unreadable' : 'no_hands';
     return { kind: 'present', view: { provider, toolsOnThisHost, isolatedAbsent } };
 }
 export function projectExecutionLaneWiring(wiring) {
     try {
         if (wiring === null || typeof wiring !== 'object' || Array.isArray(wiring))
             return undefined;
-        if (!Object.hasOwn(wiring, 'executionLane'))
-            return { kind: 'not_reported' };
-        const lane = wiring.executionLane;
+        const lane = ownDataField(wiring, 'executionLane');
         if (lane === undefined)
             return { kind: 'not_reported' };
-        return projectExecutionLaneObject(lane, () => true);
+        return projectExecutionLaneObject(lane);
     }
     catch {
         return undefined;
@@ -66,12 +63,13 @@ export function noteEngineCapsForExecutionLane(baseUrl, caps, opts) {
 export function observedExecutionLane(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-export function toolsRunHereFromExecutionLane(reading, legacyInference) {
-    if (reading.kind === 'present')
-        return reading.view.toolsOnThisHost;
-    if (reading.kind === 'not_reported')
+export function toolsRunHereFromExecutionLane(reading) {
+    try {
+        return reading.kind === 'present' && reading.view.toolsOnThisHost === true;
+    }
+    catch {
         return false;
-    return legacyInference;
+    }
 }
 export function noOsSandboxOnThisHost(reading) {
     if (typeof reading !== 'object' || reading === null)
@@ -105,7 +103,7 @@ export function executionLaneDoctorDetail(reading) {
                 'this process has no usable capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which)');
         case 'not_reported':
             return ('execution lane not reported by this engine; ' +
-                'this does not say where tools run, so the client keeps inferring it the way it did before');
+                'this does not say where tools run, so skill baseDir is not sent until the engine reports it');
         case 'present': {
             const lane = capForDisplay(reading.view.provider, LANE_DETAIL_MAX);
             if (reading.view.toolsOnThisHost) {
@@ -118,9 +116,6 @@ export function executionLaneDoctorDetail(reading) {
         }
     }
 }
-export function forgetExecutionLaneReading(baseUrl) {
-    reader.forget(baseUrl);
-}
 export function __resetExecutionLaneReadingsForTests() {
     reader.__resetForTests();
 }

package/dist/fileHistoryCaptureCapability.d.ts

@@ -17,5 +17,4 @@ export declare function fileHistoryDeclarationField(reading: FileHistoryCaptureR
     fileHistory: 'disabled';
 } | Record<string, never>;
 export declare function fileHistoryCaptureDoctorDetail(reading: FileHistoryCaptureReading): string;
-export declare function forgetFileHistoryCaptureReading(baseUrl: string | undefined): void;
 export declare function __resetFileHistoryCaptureReadingsForTests(): void;

package/dist/fileHistoryCaptureCapability.js

@@ -1,14 +1,13 @@
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
+import { ownDataField } from './ownKey.js';
 import { FILE_HISTORY_DISABLED } from './request/taskRequest.js';
 export function projectFileHistoryCaptureCapability(caps) {
     try {
         if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
             return undefined;
-        if (!Object.hasOwn(caps, 'fileHistoryCapture'))
-            return { kind: 'not_reported' };
-        const v = caps.fileHistoryCapture;
+        const v = ownDataField(caps, 'fileHistoryCapture');
         if (v === undefined)
             return { kind: 'not_reported' };
         if (typeof v !== 'string' || v.length === 0)
@@ -84,9 +83,6 @@ export function fileHistoryCaptureDoctorDetail(reading) {
             return unobserved;
     }
 }
-export function forgetFileHistoryCaptureReading(baseUrl) {
-    reader.forget(baseUrl);
-}
 export function __resetFileHistoryCaptureReadingsForTests() {
     reader.__resetForTests();
 }

package/dist/fileHistoryLegNotice.d.ts

@@ -4,7 +4,7 @@ export type FileHistoryDeclarationFact = 'sent' | 'not_sent' | 'unknown';
 export declare const FILE_HISTORY_LEG_VERDICTS: readonly ["not_honored", "honored", "not_declared", "unknown"];
 export type FileHistoryLegNoticeVerdict = (typeof FILE_HISTORY_LEG_VERDICTS)[number];
 export interface FileHistoryLegNoticeInput {
-    readonly capability: FileHistoryCaptureReading;
+    readonly assemblyCapability: FileHistoryCaptureReading;
     readonly declaration: FileHistoryDeclarationFact;
     readonly captureOffByUser: boolean;
     readonly legWord: string | undefined;
@@ -22,10 +22,11 @@ export type OutboundBodyField = {
 };
 export declare function readOutboundBodyField(body: object | null | undefined, key: string): OutboundBodyField;
 export interface FileHistoryDeclarationLedger {
-    declared(requestKey: string, fact: FileHistoryDeclarationFact): boolean;
+    declared(requestKey: string, fact: FileHistoryDeclarationFact, capabilityAtAssembly?: FileHistoryCaptureReading): boolean;
     boundToRun(requestKey: string, runId: string, event: AgentEvent): boolean;
     declarationOf(runId: string): FileHistoryDeclarationFact;
     declaredLegCwd(requestKey: string, cwd: string | undefined): boolean;
     legCwdOf(runId: string): string | undefined;
+    capabilityAtAssemblyOf(runId: string): FileHistoryCaptureReading;
 }
 export declare function createFileHistoryDeclarationLedger(): FileHistoryDeclarationLedger;

package/dist/fileHistoryLegNotice.js

@@ -16,7 +16,7 @@ export function fileHistoryLegNoticeVerdict(input) {
     let offByUser;
     let legWord;
     try {
-        capability = ownRead(input, 'capability');
+        capability = ownRead(input, 'assemblyCapability');
         declaration = declarationOfInput(ownRead(input, 'declaration'));
         offByUser = ownRead(input, 'captureOffByUser') === true;
         legWord = ownRead(input, 'legWord');
@@ -82,10 +82,35 @@ export function readOutboundBodyField(body, key) {
     }
 }
 const idOk = (v) => typeof v === 'string' && v.length > 0;
+function canonReading(r) {
+    try {
+        if (typeof r !== 'object' || r === null)
+            return 'unobserved';
+        const kind = r.kind;
+        if (kind === 'not_reported')
+            return 'not_reported';
+        if (kind === 'present') {
+            const word = r.word;
+            return typeof word === 'string' && word.length > 0 ? `present:${word}` : 'unobserved';
+        }
+        return 'unobserved';
+    }
+    catch {
+        return 'unobserved';
+    }
+}
+function readingOfCanon(c) {
+    if (c === 'not_reported')
+        return { kind: 'not_reported' };
+    if (c.startsWith('present:'))
+        return { kind: 'present', word: c.slice('present:'.length) };
+    return { kind: 'unobserved' };
+}
 export function createFileHistoryDeclarationLedger() {
     const factsByKey = new Map();
     const cwdsByKey = new Map();
     const keysByRun = new Map();
+    const readingsByKey = new Map();
     return Object.freeze({
         declaredLegCwd(requestKey, cwd) {
             if (!idOk(requestKey) || !idOk(cwd))
@@ -114,15 +139,39 @@ export function createFileHistoryDeclarationLedger() {
             }
             return agreed;
         },
-        declared(requestKey, fact) {
+        declared(requestKey, fact, capabilityAtAssembly) {
             if (!idOk(requestKey) || (fact !== 'sent' && fact !== 'not_sent'))
                 return false;
             let set = factsByKey.get(requestKey);
             if (set === undefined)
                 factsByKey.set(requestKey, (set = new Set()));
             set.add(fact);
+            if (capabilityAtAssembly !== undefined) {
+                let rs = readingsByKey.get(requestKey);
+                if (rs === undefined)
+                    readingsByKey.set(requestKey, (rs = new Set()));
+                rs.add(canonReading(capabilityAtAssembly));
+            }
             return true;
         },
+        capabilityAtAssemblyOf(runId) {
+            if (!idOk(runId))
+                return { kind: 'unobserved' };
+            const keys = keysByRun.get(runId);
+            if (keys === undefined)
+                return { kind: 'unobserved' };
+            let agreed;
+            for (const k of keys) {
+                const rs = readingsByKey.get(k);
+                if (rs === undefined || rs.size !== 1)
+                    return { kind: 'unobserved' };
+                const [only] = rs;
+                if (only === undefined || (agreed !== undefined && agreed !== only))
+                    return { kind: 'unobserved' };
+                agreed = only;
+            }
+            return agreed === undefined ? { kind: 'unobserved' } : readingOfCanon(agreed);
+        },
         boundToRun(requestKey, runId, event) {
             if (!idOk(requestKey) || !idOk(runId) || !frameProvesDelivery(event))
                 return false;

package/dist/fleet/fleetLedger.d.ts

@@ -18,6 +18,8 @@ export declare function readEngineActiveBgTasks(): EngineActiveBgReading;
 export declare function readEngineActiveBgTasksFor(sessionKey: string): EngineActiveBgReading;
 export declare function clearAllRetainedFleetRows(): void;
 export declare function clearAllRetainedFleetRowsFor(sessionKey: string): void;
+export declare function forgetSettledTerminalRow(id: string): boolean;
+export declare function forgetSettledTerminalRowFor(sessionKey: string, id: string): boolean;
 export declare function __resetFleetLedgerRegistryForTests(): void;
 export declare function fleetStreamOptions(): {
     session?: string;

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,8 +8,10 @@ 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;
 const liveBgViews = new Map();
 function viewsFor(sessionKey) {
@@ -59,6 +62,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 +101,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) {
@@ -130,10 +143,24 @@ export function createFleetLedger(hooks = {}, opts = {}) {
             ...(retired ? { retiredByNotification: true } : {}),
         };
     };
+    function forgetSettledTerminalRowOf(id) {
+        const live = taskMap.get(id);
+        if (live !== undefined && !isSdkFleetTaskTerminal(live.status))
+            return false;
+        const pooled = retained.get(id);
+        if (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 => !TERMINAL_FLEET_TASK_STATUSES.has(r.status ?? ''))
+                .filter(r => !isSdkFleetTaskTerminal(r.status))
                 .map(r => toBgTask(r, false));
             const nowMs = nowFn();
             for (const [id, r] of retained) {
@@ -151,6 +178,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         clearRetained: () => {
             retained.clear();
         },
+        forgetSettledTerminal: id => forgetSettledTerminalRowOf(id),
     };
     {
         let views = liveBgViews.get(sessionKey);
@@ -179,7 +207,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 for (const row of frame.tasks) {
                     taskMap.set(row.id, row);
                     rowMeta.set(row.id, { receivedAtMs });
-                    if (!TERMINAL_FLEET_TASK_STATUSES.has(row.status ?? '')) {
+                    if (!isSdkFleetTaskTerminal(row.status)) {
                         const tail = rowIdTail(row.id);
                         for (const id of [...retained.keys()]) {
                             if (rowIdTail(id) === tail)
@@ -224,7 +252,7 @@ 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 ?? '')) {
+                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()]) {
@@ -245,33 +273,32 @@ export function createFleetLedger(hooks = {}, opts = {}) {
             }
             case 'task_remove': {
                 const fr = frame;
-                const removedGen = typeof fr.cycleSeq === 'number' && Number.isInteger(fr.cycleSeq) && fr.cycleSeq >= 1 ? fr.cycleSeq : undefined;
+                const removedGen = cycleSeqValue(fr.cycleSeq);
                 const held = taskMap.get(frame.id);
                 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 +372,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,13 +405,13 @@ 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 (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})`);
@@ -423,10 +451,10 @@ export function createFleetLedger(hooks = {}, opts = {}) {
             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;
@@ -455,12 +483,11 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                             const prior = getBgTerminalFacts(n.taskId);
                             if (prior === undefined)
                                 return true;
-                            if (notifSeq !== undefined && prior.cycleSeq !== undefined) {
-                                if (notifSeq < prior.cycleSeq)
-                                    return false;
-                                if (notifSeq > prior.cycleSeq)
-                                    return true;
-                            }
+                            const order = cycleSeqOrder(notifSeq, prior.cycleSeq);
+                            if (order === 'before')
+                                return false;
+                            if (order === 'after')
+                                return true;
                             return !isWashGreen(prior.status, n.status);
                         })()));
             if (factsAccepted)
@@ -487,17 +514,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,7 +525,7 @@ 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 ?? ''))
+            if (isSdkFleetTaskTerminal(r.status))
                 return r;
             const started = r.startedAt;
             if (typeof started === 'number' && started > 0 && started <= nowMs) {

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;
@@ -51,9 +50,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,8 +126,7 @@ 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;
@@ -182,7 +177,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,
@@ -213,7 +207,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 +218,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 +231,6 @@ const FLEET_TASK_VIEW_KEY_TUPLE = [
     'elapsedMs',
     'tokens',
     'tokenDir',
-    'queuedCount',
     'awaitingPlanApproval',
     'descendantCount',
     'viewed',
@@ -271,7 +258,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 = [
@@ -337,6 +323,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;