@sema-agent/client-core 0.104.1 → 0.106.0

package/dist/displayUntrusted.js

@@ -3618,6 +3618,8 @@ class SequenceReader {
         if (this.atomicBlanks === 'none')
             return false;
         const cp = nameBlankTokenAt(this.text, at);
+        if (this.atomicBlanks === 'fillers')
+            return cp !== -1 && !isFoldedBlank(cp);
         return this.atomicBlanks === 'all' ? cp !== -1 : isFoldedBlank(cp);
     }
     intermediateAt(at) {
@@ -3735,6 +3737,9 @@ function nameBlankTokenAt(text, at) {
     const cp = Number.parseInt(hit[1] ?? '', 16);
     return isNameBlank(cp) ? cp : -1;
 }
+function isMarkedNameBlank(net, c) {
+    return net === 1 ? isNameBlank(c) : net === 2 ? isNameBlank(c) && !isRegexSpace(c) : false;
+}
 function buildScanView(text, o) {
     const chars = [];
     const starts = [];
@@ -3743,7 +3748,7 @@ function buildScanView(text, o) {
     const dropped = [];
     const spaceUnits = [];
     const contents = [];
-    const seq = new SequenceReader(text, o.blanks ? 'all' : 'none', o.blanks || o.fold, o.fold);
+    const seq = new SequenceReader(text, o.blanks === 1 ? 'all' : o.blanks === 2 ? 'fillers' : 'none', o.blanks === 1 || o.fold, o.fold);
     const keep = (ch, s, e, unit = UNIT_NONE) => {
         chars.push(ch);
         starts.push(s);
@@ -3814,7 +3819,7 @@ function buildScanView(text, o) {
                 continue;
             }
         }
-        if (o.blanks && isNameBlank(c)) {
+        if (isMarkedNameBlank(o.blanks, c)) {
             drop(i, i + 1);
             i++;
             continue;
@@ -3984,7 +3989,7 @@ function screenSurfaces(text, o) {
             i = j;
             continue;
         }
-        else if (unsafe !== null && unsafe.test(ch) && !faceHitKept(ch, i, text)) {
+        else if (unsafe !== null && unsafe.test(ch) && !faceHitKept(ch, i, text, face.keepCrlf === true)) {
             form = markOf(ch, face.mark);
             dotted = face.mark !== 'escape';
         }
@@ -4636,13 +4641,16 @@ function scanAndMask(text, o, trace, stats, phaseOut) {
     }
     return cur;
 }
-const WASH_OPTIONS = Object.freeze({ urls: true, words: true, blanks: false, fold: false, face: null, escapeSpaces: null });
+const WASH_OPTIONS = Object.freeze({ urls: true, words: true, blanks: 0, fold: false, face: null, escapeSpaces: null });
 export function washCredentials(text) {
     if (typeof text !== 'string')
         return text;
     return scanAndMask(text, WASH_OPTIONS, false).text;
 }
 const NAME_BLANKS = NAME_BLANK_RANGES.map(([a, b]) => (a === b ? classEscape(a) : `${classEscape(a)}-${classEscape(b)}`)).join('');
+const NAME_FILLERS = NAME_BLANK_RANGES.filter(([a, b]) => !isRegexSpace(a) && !isRegexSpace(b))
+    .map(([a, b]) => (a === b ? classEscape(a) : `${classEscape(a)}-${classEscape(b)}`))
+    .join('');
 function classEscape(cp) {
     return `\\u${cp.toString(16).toUpperCase().padStart(4, '0')}`;
 }
@@ -4740,10 +4748,12 @@ function joinerKept(text, at, zwj) {
 function emojiPresented(cp, after) {
     return isPictograph(cp) && (isEmojiPresentation(cp) || after === 0xfe0f || (after !== -1 && isEmojiModifier(after)));
 }
-function faceHitKept(ch, at, text) {
+function faceHitKept(ch, at, text, crlf = false) {
     if (ch.length > 2)
         return true;
     const c = ch.charCodeAt(0);
+    if (crlf && c === 0x0d && ch.length === 1)
+        return text.charCodeAt(at + 1) === 0x0a;
     return ch.length === 1 && (c === 0x200d || c === 0x200c) && joinerKept(text, at, c === 0x200d);
 }
 const RGI_TAG_FLAG = '\\u{1F3F4}\\u{E0067}\\u{E0062}(?:\\u{E0065}\\u{E006E}\\u{E0067}|\\u{E0073}\\u{E0063}\\u{E0074}|\\u{E0077}\\u{E006C}\\u{E0073})\\u{E007F}';
@@ -4771,7 +4781,7 @@ const FOLD_RUN_KEEPING_BLANKS = new RegExp(`[^\\S${NAME_BLANKS}]+`, 'g');
 const EDGE_SPACE = /^ | $/g;
 const foldWhitespace = (s, keepBlanks = false) => keepBlanks ? s.replace(FOLD_RUN_KEEPING_BLANKS, ' ').replace(EDGE_SPACE, '') : s.replace(FOLD_RUN, ' ').trim();
 export function applyDisplayFace(text, face) {
-    const markAll = (s) => face.unsafe === null ? s : s.replace(face.unsafe, (ch, at, whole) => (faceHitKept(ch, at, whole) ? ch : markOf(ch, face.mark)));
+    const markAll = (s) => face.unsafe === null ? s : s.replace(face.unsafe, (ch, at, whole) => (faceHitKept(ch, at, whole, face.keepCrlf === true) ? ch : markOf(ch, face.mark)));
     const keepBlanks = face.keepBlanks === true;
     if (face.mark === 'space') {
         const marked = markAll(text);
@@ -4779,7 +4789,7 @@ export function applyDisplayFace(text, face) {
     }
     return markAll(face.fold ? foldWhitespace(text, keepBlanks) : text);
 }
-function markTracked(t, re, mark, ledger) {
+function markTracked(t, re, mark, ledger, crlf = false) {
     const parts = [];
     const ids = [];
     const keep = (a, b) => {
@@ -4792,7 +4802,7 @@ function markTracked(t, re, mark, ledger) {
         const at = hit.index ?? 0;
         const ch = hit[0];
         keep(cursor, at);
-        if (faceHitKept(ch, at, t.text))
+        if (faceHitKept(ch, at, t.text, crlf))
             keep(at, at + ch.length);
         else {
             const form = markOf(ch, mark);
@@ -4841,7 +4851,7 @@ function foldTracked(t, keepBlanks) {
 function faceTracked(t, face, ledger) {
     const keepBlanks = face.keepBlanks === true;
     const unsafe = face.unsafe;
-    const markAll = (x) => (unsafe === null ? x : markTracked(x, unsafe, face.mark, ledger));
+    const markAll = (x) => (unsafe === null ? x : markTracked(x, unsafe, face.mark, ledger, face.keepCrlf === true));
     if (face.mark === 'space') {
         const marked = markAll(t);
         return face.fold ? foldTracked(marked, keepBlanks) : marked;
@@ -4920,20 +4930,33 @@ function collectMarks(t, ledger) {
     }
     return out;
 }
-const PUBLIC_UNSAFE_BY_NETS = Object.freeze(Array.from({ length: 16 }, (_, i) => {
-    const controls = (i & 8) !== 0;
-    const bidi = (i & 4) !== 0;
-    const keep = (i & 2) !== 0;
-    const blanks = (i & 1) !== 0;
-    const members = `${controls ? `${keep ? C0_KEEP_LAYOUT : C0_ALL}${DEL_C1}${LONE_SURROGATE}` : ''}${bidi ? LINE_SEPARATORS : ''}${blanks ? NAME_BLANKS : ''}`;
+export const DISPLAY_DECISION_BODY = Object.freeze({
+    foldLines: false,
+    keepLayout: 'crlf',
+    blanks: 'fillers',
+    mark: 'escape',
+});
+const PUBLIC_UNSAFE_BY_NETS = Object.freeze(Array.from({ length: 24 }, (_, i) => {
+    const net = i % 3;
+    const rest = (i - net) / 3;
+    const controls = (rest & 4) !== 0;
+    const bidi = (rest & 2) !== 0;
+    const keep = (rest & 1) !== 0;
+    const blanks = net === 1 ? NAME_BLANKS : net === 2 ? NAME_FILLERS : '';
+    const members = `${controls ? `${keep ? C0_KEEP_LAYOUT : C0_ALL}${DEL_C1}${LONE_SURROGATE}` : ''}${bidi ? LINE_SEPARATORS : ''}${blanks}`;
     return unsafeClass(members, bidi);
 }));
+function blankNetOf(opts) {
+    return opts.blanks === true ? 1 : opts.blanks === 'fillers' ? 2 : 0;
+}
+const keepsLayout = (opts) => opts.keepLayout === true || opts.keepLayout === 'crlf';
 function publicFace(opts) {
     const fold = opts.foldLines !== false;
-    const keep = !fold && opts.keepLayout === true;
-    const blanks = opts.blanks === true;
-    const index = (opts.controls !== false ? 8 : 0) + (opts.bidi !== false ? 4 : 0) + (keep ? 2 : 0) + (blanks ? 1 : 0);
-    return { unsafe: PUBLIC_UNSAFE_BY_NETS[index] ?? null, fold, mark: opts.mark ?? 'escape', keepBlanks: blanks };
+    const keep = !fold && keepsLayout(opts);
+    const net = blankNetOf(opts);
+    const index = ((opts.controls !== false ? 4 : 0) + (opts.bidi !== false ? 2 : 0) + (keep ? 1 : 0)) * 3 + net;
+    const face = { unsafe: PUBLIC_UNSAFE_BY_NETS[index] ?? null, fold, mark: opts.mark ?? 'escape', keepBlanks: net === 1 };
+    return keep && opts.keepLayout === 'crlf' && opts.controls !== false ? { ...face, keepCrlf: true } : face;
 }
 export const ESCAPE_FACE = Object.freeze({ ...publicFace({ foldLines: false }) });
 export const LABEL_FACE = Object.freeze({ ...publicFace({}) });
@@ -5007,7 +5030,7 @@ function escapeSpacesFor(o, face) {
     if (o.controls !== false) {
         for (const c of [0x09, 0x0a, 0x0b, 0x0c, 0x0d])
             set.add(c);
-        if (o.keepLayout === true) {
+        if (keepsLayout(o)) {
             set.delete(0x09);
             set.delete(0x0a);
         }
@@ -5024,7 +5047,7 @@ function scanOptionsOf(o, face, queryByShape = false, wholeAddress = false) {
         queryByShape,
         wholeAddress,
         words: o.credentialWords !== false,
-        blanks: face.keepBlanks === true,
+        blanks: blankNetOf(o),
         fold: face.fold,
         face,
         escapeSpaces: escapeSpacesFor(o, face),
@@ -5321,7 +5344,7 @@ function queryPartPhases(key, value, relax) {
     return hit;
 }
 const UPLOAD_PROBE_PREFIX = 'https://q.invalid/?';
-const UPLOAD_SCAN_OPTIONS = Object.freeze({ urls: true, queryByShape: 'strict', wholeAddress: true, words: true, blanks: false, fold: false, face: null, escapeSpaces: null });
+const UPLOAD_SCAN_OPTIONS = Object.freeze({ urls: true, queryByShape: 'strict', wholeAddress: true, words: true, blanks: 0, fold: false, face: null, escapeSpaces: null });
 export function queryCarriesCredential(query) {
     if (typeof query !== 'string' || query.length === 0)
         return false;

package/dist/engineAddress.d.ts

@@ -0,0 +1,3 @@
+export declare function tupleOriginUrlOf(raw: string): URL | undefined;
+export declare function carriesNoCredentialSlots(u: URL): boolean;
+export declare function isCenterRelativePath(path: string): boolean;

package/dist/engineAddress.js

@@ -0,0 +1,25 @@
+export function tupleOriginUrlOf(raw) {
+    try {
+        const u = new URL(raw);
+        return /^(?:https?|wss?|ftp):$/.test(u.protocol) ? u : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function carriesNoCredentialSlots(u) {
+    return u.username === '' && u.password === '' && u.search === '' && u.hash === '';
+}
+export function isCenterRelativePath(path) {
+    if (path.length === 0 || path.charCodeAt(0) !== 0x2f)
+        return false;
+    const second = path.charCodeAt(1);
+    if (second === 0x2f || second === 0x5c)
+        return false;
+    if (/[\s\u0000-\u001f\u007f-\u009f\\?#]/u.test(path))
+        return false;
+    return path.split('/').every((segment) => {
+        const decoded = segment.replace(/%2e/gi, '.');
+        return decoded !== '.' && decoded !== '..';
+    });
+}

package/dist/engineDirectory.js

@@ -1,21 +1,9 @@
 import { guardedRead, readOwnDataNonEmptyString, readOwnDataValue } from './ownKey.js';
+import { isCenterRelativePath } from './engineAddress.js';
 const KIND_WORDS = ['managed'];
 const POSTURE_WORDS = ['single', 'multi'];
 const RULE_WORDS = ['only-one', 'none', 'ambiguous'];
 const UNREADABLE = Object.freeze({ kind: 'unreadable' });
-function isCenterRelativePath(path) {
-    if (path.length === 0 || path.charCodeAt(0) !== 0x2f)
-        return false;
-    const second = path.charCodeAt(1);
-    if (second === 0x2f || second === 0x5c)
-        return false;
-    if (/[\s\u0000-\u001f\u007f-\u009f\\?#]/u.test(path))
-        return false;
-    return path.split('/').every((segment) => {
-        const decoded = segment.replace(/%2e/gi, '.');
-        return decoded !== '.' && decoded !== '..';
-    });
-}
 function isObj(v) {
     return typeof v === 'object' && v !== null && !Array.isArray(v);
 }
@@ -123,6 +111,9 @@ export function projectMeEngine(body) {
         return undefined;
     }
 }
+function sameNameCount(set, name) {
+    return set.rows.filter((row) => row.name === name).length + set.unreadableNames.filter((n) => n === name).length;
+}
 export function decideMeEngine(reading) {
     try {
         if (reading === undefined)
@@ -139,7 +130,9 @@ export function decideMeEngine(reading) {
             if (candidates === undefined)
                 return unresolved('candidates');
             const picked = target.row;
-            if (!candidates.rows.some((row) => row.name === picked.name && row.viaCenter === picked.viaCenter))
+            if (!candidates.rows.some((row) => row.name === picked.name && row.viaCenter === picked.viaCenter && row.scope === picked.scope))
+                return unresolved('conflict');
+            if (sameNameCount(candidates, picked.name) > 1)
                 return unresolved('conflict');
             if (rule.kind === 'listed' && (candidates.rows.length !== 1 || candidates.unreadableRows !== 0))
                 return unresolved('conflict');
@@ -171,12 +164,11 @@ export function engineOverrideOf(set, requested) {
         if (set === undefined)
             return { kind: 'unreadable' };
         const hits = set.rows.filter((row) => row.name === requested);
-        const hidden = set.unreadableNames.filter((name) => name === requested).length;
-        if (hits.length + hidden > 1)
+        if (sameNameCount(set, requested) > 1)
             return { kind: 'duplicate', name: requested };
         if (hits.length === 1)
             return { kind: 'select', engine: hits[0] };
-        if (hidden === 1)
+        if (set.unreadableNames.some((name) => name === requested))
             return { kind: 'row-unreadable', name: requested };
         return { kind: 'not-listed', candidates: set };
     }

package/dist/engineErrorCodes.d.ts

@@ -8,6 +8,7 @@ export declare const LIMITS_MAX_WALLTIME_EXCEEDED = "limits.max_walltime_exceede
 export declare function isLimitsExceededCode(code: string | undefined): boolean;
 export declare const USAGE_WINDOW_EXHAUSTED = "usage.window_exhausted";
 export declare const ENV_LIFETIME_EXPIRED = "env.lifetime_expired";
+export declare const ENV_HOME_UNCONFIRMED = "env.home_unconfirmed";
 export declare const FLEET_LEASE_UNAVAILABLE = "fleet.lease_unavailable";
 export declare const CONFIG_LIMIT_INVALID = "config.limit_invalid";
 export declare const CONFIG_LIMIT_UNKNOWN_KEY = "config.limit_unknown_key";
@@ -42,6 +43,12 @@ export declare const CAPABILITY_IMAGE_INDEX_REQUIRED = "capability.image_index_r
 export declare const CAPABILITY_K8S_LANE_REQUIRED = "capability.k8s_lane_required";
 export declare const NOT_FOUND_IMAGE = "not_found.image";
 export declare const REQUEST_PRECONDITION_UNMET = "request.precondition_unmet";
+export declare const ATTACHMENT_BUNDLE_INVALID = "attachment.bundle_invalid";
+export declare const ATTACHMENT_BUNDLE_LANE_NOT_ISOLATED = "attachment.bundle_lane_not_isolated";
+export declare const ATTACHMENT_BUNDLE_SEED_FIXED = "attachment.bundle_seed_fixed";
+export declare const ATTACHMENT_BOUND_ELSEWHERE = "attachment.bound_elsewhere";
+export declare const CONFLICT_SESSION_MEMORY_UNOBSERVED = "conflict.session_memory_unobserved";
+export declare const CONFLICT_SESSION_ARCHIVE_STAMPED = "conflict.session_archive_stamped";
 export declare const GATE_PARKED_ERROR_CODE = "gate.parked";
 export declare const ACTIVE_RUN_BUSY_ERROR_CODE = "conflict.session_active_run";
 export declare const CONFLICT_IDEMPOTENCY_PAYLOAD_MISMATCH = "conflict.idempotency_payload_mismatch";
@@ -114,6 +121,7 @@ export declare function isDecideParkMovedCode(code: string | null | undefined):
 export declare const DECIDE_ROW_UNREVIVABLE = "decide.row_unrevivable";
 export declare function isDecideRowUnrevivableCode(code: string | null | undefined): boolean;
 export declare const APPROVAL_STALE = "approval_stale";
+export declare const DECIDE_REQUIRES_BINDING = "decide_requires_binding";
 export declare const APPROVAL_BINDING_MISMATCH = "approval_binding_mismatch";
 export declare const CHECKPOINT_INVALID_OUTCOME = "checkpoint.invalid_outcome";
 export declare const RESUME_OUTCOME_INVALID = "resume_outcome_invalid";

package/dist/engineErrorCodes.js

@@ -11,6 +11,7 @@ export function isLimitsExceededCode(code) {
 }
 export const USAGE_WINDOW_EXHAUSTED = 'usage.window_exhausted';
 export const ENV_LIFETIME_EXPIRED = 'env.lifetime_expired';
+export const ENV_HOME_UNCONFIRMED = 'env.home_unconfirmed';
 export const FLEET_LEASE_UNAVAILABLE = 'fleet.lease_unavailable';
 export const CONFIG_LIMIT_INVALID = 'config.limit_invalid';
 export const CONFIG_LIMIT_UNKNOWN_KEY = 'config.limit_unknown_key';
@@ -66,6 +67,12 @@ export const CAPABILITY_IMAGE_INDEX_REQUIRED = 'capability.image_index_required'
 export const CAPABILITY_K8S_LANE_REQUIRED = 'capability.k8s_lane_required';
 export const NOT_FOUND_IMAGE = 'not_found.image';
 export const REQUEST_PRECONDITION_UNMET = 'request.precondition_unmet';
+export const ATTACHMENT_BUNDLE_INVALID = 'attachment.bundle_invalid';
+export const ATTACHMENT_BUNDLE_LANE_NOT_ISOLATED = 'attachment.bundle_lane_not_isolated';
+export const ATTACHMENT_BUNDLE_SEED_FIXED = 'attachment.bundle_seed_fixed';
+export const ATTACHMENT_BOUND_ELSEWHERE = 'attachment.bound_elsewhere';
+export const CONFLICT_SESSION_MEMORY_UNOBSERVED = 'conflict.session_memory_unobserved';
+export const CONFLICT_SESSION_ARCHIVE_STAMPED = 'conflict.session_archive_stamped';
 export const GATE_PARKED_ERROR_CODE = 'gate.parked';
 export const ACTIVE_RUN_BUSY_ERROR_CODE = 'conflict.session_active_run';
 export const CONFLICT_IDEMPOTENCY_PAYLOAD_MISMATCH = 'conflict.idempotency_payload_mismatch';
@@ -214,6 +221,7 @@ export function isDecideRowUnrevivableCode(code) {
     return typeof code === 'string' && code === DECIDE_ROW_UNREVIVABLE;
 }
 export const APPROVAL_STALE = 'approval_stale';
+export const DECIDE_REQUIRES_BINDING = 'decide_requires_binding';
 export const APPROVAL_BINDING_MISMATCH = 'approval_binding_mismatch';
 export const CHECKPOINT_INVALID_OUTCOME = 'checkpoint.invalid_outcome';
 export const RESUME_OUTCOME_INVALID = 'resume_outcome_invalid';

package/dist/engineGenerationPort.d.ts

@@ -19,7 +19,9 @@ export interface EngineGenerationPort {
     endedMaterials: () => Promise<EndedGenerationMaterials>;
     replacementInFlight?: () => boolean;
     awaitEngineInstalled?: (signal: AbortSignal, maxMs: number) => Promise<boolean>;
+    endedBy?: (generation: number) => EngineGenerationEndFact | undefined;
 }
+export type EngineGenerationEndFact = 'own-supervision' | 'external-replacement';
 export type EngineGenerationReading = {
     readonly known: true;
     readonly generation: number;
@@ -42,11 +44,18 @@ export interface ApprovalFrameGenerationFacts {
 export declare function approvalFrameGenerationVerdict(facts: ApprovalFrameGenerationFacts): 'admit' | 'drop';
 export declare const REATTACH_AWAIT_NEXT_ENGINE_MS = 245000;
 export declare function unreachableForSettle(liveness: ReattachLivenessReading): boolean;
-export type EndedGenerationSettleStep = 'await-next-engine' | 'refresh-credentials' | 'credentials-rejected' | 'hand-over-terminal' | 'parked' | 'engine-stopped';
+export type EndedGenerationSettleStep = 'await-next-engine' | 'refresh-credentials' | 'credentials-rejected' | 'hand-over-terminal' | 'parked' | 'engine-stopped' | 'window-exhausted';
+export interface EndedGenerationWaitReading {
+    readonly replacing: boolean;
+    readonly installed: boolean;
+    readonly generationBefore?: EngineGenerationReading;
+    readonly generationAfter?: EngineGenerationReading;
+    readonly replacingAfter?: boolean;
+}
 export interface EndedGenerationSettleFacts {
     readonly liveness: ReattachLivenessReading;
     readonly canAwaitNextEngine: boolean;
-    readonly awaitedNextEngine: boolean;
+    readonly waits?: readonly EndedGenerationWaitReading[];
     readonly refreshedCredentials: boolean | null;
     readonly terminalReadable?: boolean;
 }

package/dist/engineGenerationPort.js

@@ -60,25 +60,79 @@ export function unreachableForSettle(liveness) {
         return false;
     }
 }
+const SETTLE_WAIT_ROUNDS_MAX = 8;
+function waitSnapshotsOf(raw) {
+    if (raw === undefined)
+        return [];
+    if (!Array.isArray(raw))
+        return null;
+    const out = [];
+    const n = raw.length;
+    for (let i = 0; i < n; i++) {
+        const item = raw[i];
+        if (typeof item !== 'object' || item === null)
+            return null;
+        const o = item;
+        const replacing = o.replacing;
+        const installed = o.installed;
+        const replacingAfter = o.replacingAfter;
+        if (typeof replacing !== 'boolean' || typeof installed !== 'boolean')
+            return null;
+        if (replacingAfter !== undefined && typeof replacingAfter !== 'boolean')
+            return null;
+        out.push({ replacing, installed, generationBefore: o.generationBefore, generationAfter: o.generationAfter, replacingAfter });
+    }
+    return out;
+}
 export function endedGenerationSettleStep(facts) {
     try {
         const liveness = facts.liveness;
-        if (typeof liveness !== 'object' || liveness === null || !REATTACH_RUN_STATES.includes(liveness.state))
-            return 'engine-stopped';
-        if (facts.canAwaitNextEngine === true && facts.awaitedNextEngine !== true && unreachableForSettle(liveness))
+        const canAwait = facts.canAwaitNextEngine;
+        const rawWaits = facts.waits;
+        const refreshed = facts.refreshedCredentials;
+        const terminalReadable = facts.terminalReadable;
+        if (typeof liveness !== 'object' || liveness === null)
+            return 'window-exhausted';
+        const state = liveness.state;
+        const notFound = liveness.notFound;
+        if (!REATTACH_RUN_STATES.includes(state))
+            return 'window-exhausted';
+        if (!(refreshed === null || typeof refreshed === 'boolean'))
+            return 'window-exhausted';
+        const waits = waitSnapshotsOf(rawWaits);
+        if (waits === null)
+            return 'window-exhausted';
+        const reading = notFound === true ? { state: state, notFound: true } : { state: state };
+        const unreachable = unreachableForSettle(reading);
+        const k = waits.length;
+        const w = k === 0 ? undefined : waits[k - 1];
+        const unstable = w !== undefined &&
+            w.installed &&
+            (engineGenerationEnded({ run: knownOrUnknown(w.generationBefore), current: knownOrUnknown(w.generationAfter) }) || w.replacingAfter === true);
+        if (refreshed === null && canAwait === true && (unreachable || state === 'unauthorized') && (k === 0 || (unstable && k < SETTLE_WAIT_ROUNDS_MAX)))
             return 'await-next-engine';
-        if (liveness.state === 'unauthorized')
-            return facts.refreshedCredentials === null ? 'refresh-credentials' : 'credentials-rejected';
-        if (liveness.state === 'done')
-            return facts.terminalReadable === false ? 'engine-stopped' : 'hand-over-terminal';
-        if (liveness.state === 'parked')
+        const answered401 = refreshed !== null || state === 'unauthorized';
+        const outcomeUnknown = w !== undefined && answered401 && ((!w.installed && w.replacing) || (unstable && k >= SETTLE_WAIT_ROUNDS_MAX));
+        if (state === 'unauthorized') {
+            if (refreshed === null)
+                return 'refresh-credentials';
+            return outcomeUnknown ? 'window-exhausted' : 'credentials-rejected';
+        }
+        if (outcomeUnknown && unreachable)
+            return 'window-exhausted';
+        if (state === 'done')
+            return terminalReadable === false ? 'engine-stopped' : 'hand-over-terminal';
+        if (state === 'parked')
             return 'parked';
         return 'engine-stopped';
     }
     catch {
-        return 'engine-stopped';
+        return 'window-exhausted';
     }
 }
+function knownOrUnknown(reading) {
+    return typeof reading === 'object' && reading !== null ? reading : UNKNOWN;
+}
 export const AWAIT_ENGINE_INSTALL_POLL_MS = 200;
 export function awaitNextEngineInstalled(signal, maxMs, deps) {
     const clock = typeof deps.now === 'function' ? deps.now : () => performance.now();

package/dist/engineHealthFacts.d.ts

@@ -14,10 +14,15 @@ export interface EngineHealthDrainingFacts {
     readonly since: number;
     readonly deadlineAt: number;
 }
+export interface EngineHealthLeaseFacts {
+    readonly lingerMs: number;
+    readonly tickMs: number;
+}
 export interface EngineHealthFacts {
     readonly center?: EngineHealthCenterFacts;
     readonly auth?: EngineHealthAuthFacts;
     readonly operator?: 'present' | 'absent';
     readonly draining?: EngineHealthDrainingFacts;
+    readonly engineLease?: EngineHealthLeaseFacts;
 }
 export declare function readEngineHealthFacts(health: object | null | undefined): EngineHealthFacts;

package/dist/engineHealthFacts.js

@@ -67,6 +67,15 @@ function drainingOf(health) {
         return undefined;
     return Object.freeze({ actionId, since, deadlineAt });
 }
+function leaseOf(raw) {
+    if (!isObject(raw))
+        return undefined;
+    const lingerMs = epochMs(readOwnDataValue(raw, 'lingerMs'));
+    const tickMs = epochMs(readOwnDataValue(raw, 'tickMs'));
+    if (lingerMs === undefined || tickMs === undefined)
+        return undefined;
+    return Object.freeze({ lingerMs, tickMs });
+}
 function guarded(read) {
     try {
         return read();
@@ -83,10 +92,12 @@ export function readEngineHealthFacts(health) {
     const operatorRaw = guarded(() => readOwnDataValue(health, 'operator'));
     const operator = operatorRaw === 'present' || operatorRaw === 'absent' ? operatorRaw : undefined;
     const draining = guarded(() => drainingOf(health));
+    const engineLease = guarded(() => leaseOf(readOwnDataValue(health, 'engineLease')));
     return Object.freeze({
         ...(center !== undefined ? { center } : {}),
         ...(auth !== undefined ? { auth } : {}),
         ...(operator !== undefined ? { operator } : {}),
         ...(draining !== undefined ? { draining } : {}),
+        ...(engineLease !== undefined ? { engineLease } : {}),
     });
 }

package/dist/engineNoticeCodes.d.ts

@@ -223,12 +223,14 @@ export interface StreamEndIgnoredFactsView {
     runId: string;
 }
 export declare function readStreamEndIgnored(notice: unknown): StreamEndIgnoredFactsView | undefined;
-export interface ContextImageRemovedFactsView {
+export interface ContextMediaRemovedFactsView {
+    reason: string;
     images: number;
+    documents: number;
     sessionId: string;
     runId: string;
 }
-export declare function readContextImageRemoved(notice: {} | null | undefined): ContextImageRemovedFactsView | undefined;
+export declare function readContextMediaRemoved(notice: {} | null | undefined): ContextMediaRemovedFactsView | undefined;
 export interface McpAuthorizationRequiredFactsView {
     server: string;
     reason: string;
@@ -237,6 +239,26 @@ export interface McpAuthorizationRequiredFactsView {
     runId: string;
 }
 export declare function readMcpAuthorizationRequired(notice: {} | null | undefined): McpAuthorizationRequiredFactsView | undefined;
+interface SessionLineageRerootedCommon {
+    recordsDropped: NoticeCountReading;
+    recordsTotal: NoticeCountReading;
+    entriesOnPath: NoticeCountReading;
+    sessionId: string;
+    runId: string;
+}
+interface SessionLineageRerootedWhole extends SessionLineageRerootedCommon {
+    break: false;
+    leaf: string | null;
+}
+interface SessionLineageRerootedBroken extends SessionLineageRerootedCommon {
+    break: true;
+    leaf: string;
+    missingParentId: string;
+    rootedAt: string;
+    entriesCut: NoticeCountReading;
+}
+export type SessionLineageRerootedFactsView = SessionLineageRerootedWhole | SessionLineageRerootedBroken;
+export declare function readSessionLineageRerooted(notice: {} | null | undefined): SessionLineageRerootedFactsView | undefined;
 export declare const ENGINE_NOTICE_FACT_READERS: Readonly<{
     readonly 'mcp.injection_dropped': typeof readMcpInjectionDrop;
     readonly 'delegation.ask_unresolvable': typeof readAskUnresolvable;
@@ -261,8 +283,9 @@ export declare const ENGINE_NOTICE_FACT_READERS: Readonly<{
     readonly 'task.turn_interrupted': typeof readTurnInterrupted;
     readonly 'route.finish_reason_unknown': typeof readFinishReasonUnknown;
     readonly 'route.stream_end_ignored': typeof readStreamEndIgnored;
-    readonly 'context.image_removed': typeof readContextImageRemoved;
     readonly 'mcp.authorization_required': typeof readMcpAuthorizationRequired;
+    readonly 'context.media_removed': typeof readContextMediaRemoved;
+    readonly 'session.lineage_rerooted': typeof readSessionLineageRerooted;
 }>;
 type FactReaderTable = typeof ENGINE_NOTICE_FACT_READERS;
 export type EngineNoticeFactsCode = keyof FactReaderTable;

package/dist/engineNoticeCodes.js

@@ -897,25 +897,28 @@ function readStreamEndIgnoredOf(notice) {
         return undefined;
     return { statement, word, frames, sessionId, runId };
 }
-export function readContextImageRemoved(notice) {
-    return guardedRead(notice, readContextImageRemovedOf);
+export function readContextMediaRemoved(notice) {
+    return guardedRead(notice, readContextMediaRemovedOf);
 }
-function readContextImageRemovedOf(notice) {
+function readContextMediaRemovedOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (ownSeat(n, 'code') !== 'context.image_removed')
+    if (ownSeat(n, 'code') !== 'context.media_removed')
         return undefined;
     const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
+    const reason = nonEmpty(ownSeat(o, 'reason'));
     const images = ownSeat(o, 'images');
+    const documents = ownSeat(o, 'documents');
     const sessionId = nonEmpty(ownSeat(o, 'sessionId'));
     const runId = nonEmpty(ownSeat(o, 'runId'));
-    if (typeof images !== 'number' || !Number.isSafeInteger(images) || images < 1 || sessionId === undefined || runId === undefined)
+    const count = (v) => typeof v === 'number' && Number.isSafeInteger(v) && v >= 0;
+    if (reason === undefined || !count(images) || !count(documents) || images + documents < 1 || sessionId === undefined || runId === undefined)
         return undefined;
-    return { images, sessionId, runId };
+    return { reason, images, documents, sessionId, runId };
 }
 export function readMcpAuthorizationRequired(notice) {
     return guardedRead(notice, readMcpAuthorizationRequiredOf);
@@ -939,6 +942,47 @@ function readMcpAuthorizationRequiredOf(notice) {
     const authorizeUrl = nonEmpty(optionalOwnSeat(o, 'authorizeUrl'));
     return { server, reason, ...(authorizeUrl !== undefined ? { authorizeUrl } : {}), sessionId, runId };
 }
+export function readSessionLineageRerooted(notice) {
+    return guardedRead(notice, readSessionLineageRerootedOf);
+}
+function readSessionLineageRerootedOf(notice) {
+    if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
+        return undefined;
+    const n = notice;
+    if (ownSeat(n, 'code') !== 'session.lineage_rerooted')
+        return undefined;
+    const d = ownSeat(n, 'detail');
+    if (typeof d !== 'object' || d === null || Array.isArray(d))
+        return undefined;
+    const o = d;
+    const brk = ownSeat(o, 'break');
+    if (brk !== true && brk !== false)
+        return undefined;
+    const sessionId = nonEmpty(ownSeat(o, 'sessionId'));
+    const runId = nonEmpty(ownSeat(o, 'runId'));
+    if (sessionId === undefined || runId === undefined)
+        return undefined;
+    const leafRaw = ownSeat(o, 'leaf');
+    const common = {
+        recordsDropped: countReading(optionalOwnSeat(o, 'recordsDropped')),
+        recordsTotal: countReading(optionalOwnSeat(o, 'recordsTotal')),
+        entriesOnPath: countReading(optionalOwnSeat(o, 'entriesOnPath')),
+        sessionId,
+        runId,
+    };
+    if (brk === false) {
+        const leaf = leafRaw === null ? null : nonEmpty(leafRaw);
+        if (leaf === undefined)
+            return undefined;
+        return { break: false, leaf, ...common };
+    }
+    const leaf = nonEmpty(leafRaw);
+    const missingParentId = nonEmpty(ownSeat(o, 'missingParentId'));
+    const rootedAt = nonEmpty(ownSeat(o, 'rootedAt'));
+    if (leaf === undefined || missingParentId === undefined || rootedAt === undefined)
+        return undefined;
+    return { break: true, leaf, missingParentId, rootedAt, entriesCut: countReading(optionalOwnSeat(o, 'entriesCut')), ...common };
+}
 export const ENGINE_NOTICE_FACT_READERS = Object.freeze({
     'mcp.injection_dropped': readMcpInjectionDrop,
     'delegation.ask_unresolvable': readAskUnresolvable,
@@ -963,8 +1007,9 @@ export const ENGINE_NOTICE_FACT_READERS = Object.freeze({
     'task.turn_interrupted': readTurnInterrupted,
     'route.finish_reason_unknown': readFinishReasonUnknown,
     'route.stream_end_ignored': readStreamEndIgnored,
-    'context.image_removed': readContextImageRemoved,
     'mcp.authorization_required': readMcpAuthorizationRequired,
+    'context.media_removed': readContextMediaRemoved,
+    'session.lineage_rerooted': readSessionLineageRerooted,
 });
 const _factReaderTablePin = true;
 void _factReaderTablePin;

package/dist/engineRowRef.js

@@ -74,7 +74,7 @@ export function mintEngineRowRef(eventId, bound) {
 export function terminalRunIdOf(ev) {
     if (ev.type !== 'done')
         return undefined;
-    const v = (doneResultView(ev.result).engine ?? ev.result)?.runId;
+    const v = doneResultView(ev.result).body?.runId;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
 export const TRANSCRIPT_ROW_SIDECAR_KEYS = Object.freeze([