@sema-agent/client-core 0.93.1 → 0.95.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,7 +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) {
@@ -58,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();
 }
@@ -87,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) {
@@ -129,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) {
@@ -150,6 +178,7 @@ export function createFleetLedger(hooks = {}, opts = {}) {
         clearRetained: () => {
             retained.clear();
         },
+        forgetSettledTerminal: id => forgetSettledTerminalRowOf(id),
     };
     {
         let views = liveBgViews.get(sessionKey);
@@ -178,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)
@@ -223,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()]) {
@@ -244,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;
             }
@@ -293,6 +321,10 @@ export function createFleetLedger(hooks = {}, opts = {}) {
                 applyBgNotification(frame.notification, ing);
                 break;
             default:
+                if (isInStreamDrainingEnd(frame)) {
+                    debug('[fleet-frame] drain end frame — the engine is going down; the host reconnects');
+                    break;
+                }
                 droppedUnknownFrame++;
                 debug(`[fleet-frame] UNKNOWN frame type ignored(type=${String(frame.type)})`);
                 break;
@@ -340,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})`);
                 }
@@ -372,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})`);
@@ -418,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;
@@ -450,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)
@@ -482,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,
@@ -503,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;

package/dist/fleetAgentPanelProjection.js

@@ -1,212 +1,22 @@
-import { isStaleEngineAgentPanelEnd, publishEngineAgentPanelAbsence, publishEngineAgentPanelEvent } from './engineAgentPanelStore.js';
-import { __resetPanelRunningHistoryForTests, notePanelRowRunning, panelRowUnknownToConsumer, panelRowEndedIdentity, holdNewbornTerminalRow, peekHeldNewbornTerminalRow, dropHeldNewbornTerminalRow } from './panelRunningHistory.js';
-import { rowIdTail } from './workflow.js';
-import { TERMINAL_FLEET_TASK_STATUSES } from './fleet/fleetProjection.js';
+import { ABSENT_SETTLE_MS, panelPresenceSize } from './panelReduce.js';
+import { panelStateNow, stepEnginePanel } from './panelStateHolder.js';
 import { DEFAULT_SESSION_KEY } from './sessionSlot.js';
-import { isTerminalNotSuccess } from './runTerminal.js';
-export const ABSENT_SETTLE_MS = 30_000;
-const SETTLED_RETENTION_MS = ABSENT_SETTLE_MS * 4;
-function currentToolKeyOf(ct) {
-    if (!ct || typeof ct.toolName !== 'string' || ct.toolName.length === 0)
-        return undefined;
-    return `${ct.toolName}\u0000${ct.target ?? ''}`;
-}
-const seen = new Map();
-function seenFor(sessionKey) {
-    let m = seen.get(sessionKey);
-    if (!m) {
-        m = new Map();
-        seen.set(sessionKey, m);
-    }
-    return m;
-}
+export { ABSENT_SETTLE_MS };
 export function resetFleetAgentPanelProjection() {
-    seen.clear();
-    __resetPanelRunningHistoryForTests();
+    stepEnginePanel({ kind: 'fleet-rows-reset' });
 }
 export function resetFleetAgentPanelProjectionFor(sessionKey) {
-    seen.delete(sessionKey);
+    stepEnginePanel({ kind: 'fleet-rows-reset', sessionKey });
 }
 export function fleetAgentProjectionSize() {
     return fleetAgentProjectionSizeFor(DEFAULT_SESSION_KEY);
 }
 export function fleetAgentProjectionSizeFor(sessionKey) {
-    return seen.get(sessionKey)?.size ?? 0;
+    return panelPresenceSize(panelStateNow(), sessionKey);
 }
 export function projectFleetAgentRows(rows, nowMs = Date.now()) {
     projectFleetAgentRowsFor(DEFAULT_SESSION_KEY, rows, nowMs);
 }
 export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
-    const seenMap = seenFor(sessionKey);
-    const present = new Set();
-    for (const row of rows) {
-        if (!row?.id)
-            continue;
-        const taskId = rowIdTail(row.id);
-        if (!taskId)
-            continue;
-        present.add(taskId);
-        const status = row.status ?? 'running';
-        const wireTokens = typeof row.tokens === 'number' && Number.isInteger(row.tokens) && row.tokens >= 0 ? row.tokens : undefined;
-        const tokens = wireTokens;
-        const toolUses = typeof row.toolUses === 'number' ? row.toolUses : undefined;
-        const transcriptId = row.transcriptId || undefined;
-        const parentToolCallId = typeof row.parentToolCallId === 'string' && row.parentToolCallId.length > 0 ? row.parentToolCallId : undefined;
-        const startedAt = typeof row.startedAt === 'number' && Number.isFinite(row.startedAt) && row.startedAt > 0 ? row.startedAt : undefined;
-        const cycleSeq = typeof row.cycleSeq === 'number' && Number.isInteger(row.cycleSeq) && row.cycleSeq >= 1 ? row.cycleSeq : undefined;
-        const currentTool = currentToolKeyOf(row.currentTool) !== undefined ? row.currentTool : undefined;
-        const currentToolKey = currentToolKeyOf(row.currentTool);
-        const prev = seenMap.get(taskId);
-        const rowIdentity = { ...(cycleSeq !== undefined ? { cycleSeq } : {}), ...(startedAt !== undefined ? { startedAt } : {}) };
-        const prevIdentity = prev !== undefined
-            ? { ...(prev.cycleSeq !== undefined ? { cycleSeq: prev.cycleSeq } : {}), ...(prev.startedAt !== undefined ? { startedAt: prev.startedAt } : {}) }
-            : undefined;
-        if (prev !== undefined && isStaleEngineAgentPanelEnd(rowIdentity, prevIdentity))
-            continue;
-        const rowNewerCycle = prev !== undefined && isStaleEngineAgentPanelEnd(prevIdentity, rowIdentity);
-        const sameCycle = prev !== undefined &&
-            !prev.settled &&
-            (startedAt === undefined || prev.startedAt === undefined || prev.startedAt === startedAt) &&
-            (cycleSeq === undefined || prev.cycleSeq === undefined || prev.cycleSeq === cycleSeq);
-        const knownTokens = tokens !== undefined ? tokens : sameCycle ? prev?.tokens : undefined;
-        const carryIdentity = prev !== undefined && !rowNewerCycle;
-        const knownStartedAt = startedAt !== undefined ? startedAt : carryIdentity ? prev.startedAt : undefined;
-        const knownCycleSeq = cycleSeq !== undefined ? cycleSeq : carryIdentity ? prev.cycleSeq : undefined;
-        if (TERMINAL_FLEET_TASK_STATUSES.has(status)) {
-            const newbornTerminal = prev === undefined && panelRowUnknownToConsumer(taskId);
-            const settledThisCycle = prev?.settled === true && !rowNewerCycle;
-            const endedRec = prev === undefined ? panelRowEndedIdentity(taskId) : undefined;
-            const frameCycle = { ...(cycleSeq !== undefined ? { cycleSeq } : {}), ...(startedAt !== undefined ? { startedAt } : {}) };
-            if (endedRec !== undefined && isStaleEngineAgentPanelEnd(frameCycle, endedRec))
-                continue;
-            const endedSameCycle = endedRec !== undefined && !isStaleEngineAgentPanelEnd(endedRec, frameCycle);
-            if (newbornTerminal) {
-                holdNewbornTerminalRow(taskId, {
-                    kind: 'fleet-row',
-                    taskId,
-                    ...(row.name ? { name: row.name } : {}),
-                    ...(row.description ? { description: row.description } : {}),
-                    ...(knownTokens !== undefined ? { totalTokens: knownTokens } : {}),
-                    ...(toolUses !== undefined ? { toolUses } : {}),
-                    ...(transcriptId !== undefined ? { transcriptId } : {}),
-                    ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
-                    ...(knownStartedAt !== undefined ? { startedAt: knownStartedAt } : {}),
-                    ...(knownCycleSeq !== undefined ? { cycleSeq: knownCycleSeq } : {}),
-                });
-            }
-            else if (!settledThisCycle) {
-                if (rowNewerCycle ||
-                    (cycleSeq !== undefined && prev?.cycleSeq !== cycleSeq) ||
-                    (tokens !== undefined && prev?.tokens !== tokens) ||
-                    (toolUses !== undefined && prev?.toolUses !== toolUses) ||
-                    (transcriptId !== undefined && prev?.transcriptId !== transcriptId) ||
-                    (parentToolCallId !== undefined && prev?.parentToolCallId !== parentToolCallId) ||
-                    (startedAt !== undefined && prev?.startedAt !== startedAt)) {
-                    publishEngineAgentPanelEvent({
-                        kind: 'fleet-row',
-                        taskId,
-                        ...(row.name ? { name: row.name } : {}),
-                        ...(row.description ? { description: row.description } : {}),
-                        ...(knownTokens !== undefined ? { totalTokens: knownTokens } : {}),
-                        ...(toolUses !== undefined ? { toolUses } : {}),
-                        ...(transcriptId !== undefined ? { transcriptId } : {}),
-                        ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
-                        ...(knownStartedAt !== undefined ? { startedAt: knownStartedAt } : {}),
-                        ...(knownCycleSeq !== undefined ? { cycleSeq: knownCycleSeq } : {}),
-                    });
-                }
-                if (!endedSameCycle)
-                    publishEngineAgentPanelEvent({
-                        kind: 'end',
-                        taskId,
-                        isError: isTerminalNotSuccess(status),
-                        ...(knownCycleSeq !== undefined ? { cycleSeq: knownCycleSeq } : {}),
-                        ...(knownStartedAt !== undefined ? { startedAt: knownStartedAt } : {}),
-                    });
-            }
-            seenMap.set(taskId, {
-                status,
-                tokens: knownTokens,
-                toolUses: toolUses !== undefined ? toolUses : prev?.toolUses,
-                transcriptId: transcriptId !== undefined ? transcriptId : prev?.transcriptId,
-                parentToolCallId: parentToolCallId !== undefined ? parentToolCallId : prev?.parentToolCallId,
-                startedAt: knownStartedAt,
-                cycleSeq: knownCycleSeq,
-                currentToolKey: currentToolKey !== undefined ? currentToolKey : prev?.currentToolKey,
-                lastSeenAt: nowMs,
-                settled: true,
-                settledAtMs: prev?.settled ? prev.settledAtMs : nowMs,
-                absentReportedAtMs: undefined,
-            });
-            continue;
-        }
-        const cycleComparable = (cycleSeq !== undefined && prev?.cycleSeq !== undefined) || (startedAt !== undefined && prev?.startedAt !== undefined);
-        const staleSnapshotOverHeldRow = prev !== undefined && prev.settled === true && cycleComparable && !rowNewerCycle && peekHeldNewbornTerminalRow(taskId) !== undefined;
-        if (staleSnapshotOverHeldRow)
-            continue;
-        if (!prev ||
-            prev.settled ||
-            prev.absentReportedAtMs !== undefined ||
-            prev.status !== status ||
-            prev.tokens !== knownTokens ||
-            (toolUses !== undefined && prev.toolUses !== toolUses) ||
-            (transcriptId !== undefined && prev.transcriptId !== transcriptId) ||
-            (parentToolCallId !== undefined && prev.parentToolCallId !== parentToolCallId) ||
-            (startedAt !== undefined && prev.startedAt !== startedAt) ||
-            (cycleSeq !== undefined && prev.cycleSeq !== cycleSeq) ||
-            (currentToolKey !== undefined && prev.currentToolKey !== currentToolKey)) {
-            notePanelRowRunning(taskId);
-            dropHeldNewbornTerminalRow(taskId);
-            publishEngineAgentPanelEvent({
-                kind: 'fleet-row',
-                taskId,
-                ...(row.name ? { name: row.name } : {}),
-                ...(row.description ? { description: row.description } : {}),
-                ...(knownTokens !== undefined ? { totalTokens: knownTokens } : {}),
-                ...(toolUses !== undefined ? { toolUses } : {}),
-                ...(transcriptId !== undefined ? { transcriptId } : {}),
-                ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
-                ...(knownStartedAt !== undefined ? { startedAt: knownStartedAt } : {}),
-                ...(knownCycleSeq !== undefined ? { cycleSeq: knownCycleSeq } : {}),
-                ...(currentTool !== undefined ? { currentTool } : {}),
-            });
-        }
-        seenMap.set(taskId, {
-            status,
-            tokens: knownTokens,
-            toolUses: toolUses !== undefined ? toolUses : prev?.toolUses,
-            transcriptId: transcriptId !== undefined ? transcriptId : prev?.transcriptId,
-            parentToolCallId: parentToolCallId !== undefined ? parentToolCallId : prev?.parentToolCallId,
-            startedAt: knownStartedAt,
-            cycleSeq: knownCycleSeq,
-            currentToolKey: currentToolKey !== undefined ? currentToolKey : prev?.currentToolKey,
-            lastSeenAt: nowMs,
-            settled: false,
-            settledAtMs: undefined,
-            absentReportedAtMs: undefined,
-        });
-    }
-    for (const [taskId, s] of seenMap) {
-        if (present.has(taskId) || s.settled || s.absentReportedAtMs !== undefined)
-            continue;
-        const absentForMs = nowMs - s.lastSeenAt;
-        if (absentForMs <= ABSENT_SETTLE_MS)
-            continue;
-        publishEngineAgentPanelAbsence({ taskId, lastSeenAtMs: s.lastSeenAt, absentForMs });
-        seenMap.set(taskId, { ...s, absentReportedAtMs: nowMs });
-    }
-    for (const [taskId, s] of seenMap) {
-        if (present.has(taskId))
-            continue;
-        if (s.settled) {
-            const settledAt = s.settledAtMs ?? s.lastSeenAt;
-            if (nowMs - settledAt > SETTLED_RETENTION_MS)
-                seenMap.delete(taskId);
-        }
-        else if (s.absentReportedAtMs !== undefined && nowMs - s.absentReportedAtMs > SETTLED_RETENTION_MS) {
-            seenMap.delete(taskId);
-        }
-    }
-    if (seenMap.size === 0)
-        seen.delete(sessionKey);
+    stepEnginePanel({ kind: 'fleet-rows', sessionKey, rows, nowMs });
 }

package/dist/fleetAgentRowLike.d.ts

@@ -0,0 +1,16 @@
+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;
+}

package/dist/fleetAgentRowLike.js

@@ -0,0 +1 @@
+export {};

package/dist/gateOutcome.d.ts

@@ -32,7 +32,7 @@ export interface GateModeReleaseView {
     mandate?: string;
     reason?: string;
 }
-export declare const GATE_MODE_RELEASE_REASON_WORDS: readonly ["rule_unreadable"];
+export declare const GATE_MODE_RELEASE_REASON_WORDS: readonly ["rule_unreadable", "write_protection_unresolved"];
 export type GateModeReleaseReasonWord = (typeof CORE_MODE_RELEASE_REASONS)[number];
 export declare function isGateModeReleaseReasonWord(v: unknown): v is GateModeReleaseReasonWord;
 export interface SettlementWhoView {
@@ -61,6 +61,7 @@ export declare function gateApprover(g: GateOutcomeView | undefined): string | u
 export declare function isApprovalWindowExpiredGate(g: GateOutcomeView | undefined): boolean;
 export declare function isDenialLimitAutoDeniedGate(g: GateOutcomeView | undefined): boolean;
 export declare function isParkSlaExpiredGate(g: GateOutcomeView | undefined): boolean;
+export declare function isApproverUnavailableGate(g: GateOutcomeView | undefined): boolean;
 export declare function isHumanSettledGate(g: GateOutcomeView | undefined): boolean;
 export declare function isPolicyRefusedGate(g: GateOutcomeView | undefined): boolean;
 export declare function ccToolDenialKindForToolEnd(frame: unknown): CcToolDenialKind | undefined;