@sema-agent/client-core 0.95.0 → 0.97.0

package/dist/rewindArchiveReading.d.ts

@@ -0,0 +1,17 @@
+export type RewindArchiveBit = 'on' | 'off' | 'not_reported' | 'malformed';
+export type RewindArchiveReading = {
+    kind: 'unobserved';
+} | {
+    kind: 'unreadable';
+} | {
+    kind: 'present';
+    conversationAnchor: RewindArchiveBit;
+    forkRestore: RewindArchiveBit;
+    codeOnly: RewindArchiveBit;
+    restoreFilesEpoch: RewindArchiveBit;
+};
+export type RewindCodeArchive = 'available' | 'unavailable' | 'unknown';
+export declare function projectRewindArchiveCapability(caps: unknown): RewindArchiveReading | undefined;
+export declare function rewindArchiveReadingAt(baseUrl: string | undefined): RewindArchiveReading;
+export declare function resetRewindArchiveReader(): void;
+export declare function rewindConversationAvailability(reading: RewindArchiveReading): RewindCodeArchive;

package/dist/rewindArchiveReading.js

@@ -0,0 +1,55 @@
+import { createEngineCapReader } from './engineCapReader.js';
+import { ownDataField } from './ownKey.js';
+const CAPS_KEYS = {
+    conversationAnchor: 'resumeAt',
+    forkRestore: 'rewindFiles',
+    codeOnly: 'rewindFilesTo',
+    restoreFilesEpoch: 'restoreFiles',
+};
+const _capsKeyPin = true;
+void _capsKeyPin;
+function bitOf(caps, key) {
+    const v = ownDataField(caps, key);
+    if (v === undefined)
+        return 'not_reported';
+    if (v === true)
+        return 'on';
+    if (v === false)
+        return 'off';
+    return 'malformed';
+}
+export function projectRewindArchiveCapability(caps) {
+    try {
+        if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
+            return undefined;
+        return {
+            kind: 'present',
+            conversationAnchor: bitOf(caps, CAPS_KEYS.conversationAnchor),
+            forkRestore: bitOf(caps, CAPS_KEYS.forkRestore),
+            codeOnly: bitOf(caps, CAPS_KEYS.codeOnly),
+            restoreFilesEpoch: bitOf(caps, CAPS_KEYS.restoreFilesEpoch),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+const reader = createEngineCapReader({
+    name: 'rewindArchive',
+    project: projectRewindArchiveCapability,
+});
+export function rewindArchiveReadingAt(baseUrl) {
+    return reader.observed(baseUrl);
+}
+export function resetRewindArchiveReader() {
+    reader.__resetForTests();
+}
+export function rewindConversationAvailability(reading) {
+    if (reading.kind !== 'present')
+        return 'unknown';
+    if (reading.conversationAnchor === 'on')
+        return 'available';
+    if (reading.conversationAnchor === 'off')
+        return 'unavailable';
+    return 'unknown';
+}

package/dist/ruleCompileVerdict.d.ts

@@ -1,2 +1,10 @@
-export type RuleCompileVerdict = 'compiles' | 'refused' | 'unknown';
+export type RuleCompileVerdict = {
+    readonly kind: 'compiles';
+} | {
+    readonly kind: 'refused';
+    readonly code?: string;
+    readonly message?: string;
+} | {
+    readonly kind: 'unknown';
+};
 export declare function ruleCompileVerdict(rule: string, behavior: 'deny' | 'ask'): RuleCompileVerdict;

package/dist/ruleCompileVerdict.js

@@ -1,13 +1,38 @@
 import { validatePermissionRules } from './coreValuePorts.js';
 const RULE_COMPILE_ROOT = '/';
+function issueText(issue, key) {
+    try {
+        if (typeof issue !== 'object' || issue === null || !Object.hasOwn(issue, key))
+            return undefined;
+        const v = issue[key];
+        return typeof v === 'string' && v.length > 0 ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function firstIssue(issues) {
+    try {
+        return issues[0];
+    }
+    catch {
+        return undefined;
+    }
+}
 export function ruleCompileVerdict(rule, behavior) {
+    let issues;
     try {
-        const issues = validatePermissionRules([{ rule, behavior }], { pathBases: { root: RULE_COMPILE_ROOT } });
+        issues = validatePermissionRules([{ rule, behavior }], { pathBases: { root: RULE_COMPILE_ROOT } });
         if (!Array.isArray(issues))
-            return 'unknown';
-        return issues.length === 0 ? 'compiles' : 'refused';
+            return { kind: 'unknown' };
+        if (issues.length === 0)
+            return { kind: 'compiles' };
     }
     catch {
-        return 'unknown';
+        return { kind: 'unknown' };
     }
+    const issue = firstIssue(issues);
+    const code = issueText(issue, 'code');
+    const message = issueText(issue, 'message');
+    return { kind: 'refused', ...(code !== undefined ? { code } : {}), ...(message !== undefined ? { message } : {}) };
 }

package/dist/runTerminal.d.ts

@@ -1,4 +1,4 @@
-import type { CheckpointGate } from '@sema-agent/sdk';
+import type { CheckpointGate, TerminalModelOutputInvalidDetail } from '@sema-agent/sdk';
 export type RunTerminalPlane = 'cause' | 'flat';
 export interface RunTerminalPause {
     gate?: CheckpointGate;
@@ -11,11 +11,49 @@ export interface RunTerminalPausedRead extends RunTerminalPause {
     code?: string;
     flatStatus?: string;
 }
-export interface RunTerminalFailureDetail {
-    kind: string;
-    status?: number;
+export type RunTerminalFailureDetail = RunTerminalProviderRejectedDetail | {
+    kind: 'coded';
+    detail: {
+        readonly [key: string]: RunTerminalJsonValue;
+    };
+} | {
+    kind: 'model_output_invalid';
+    cause: TerminalModelOutputInvalidDetail['cause'];
+    outputLimit?: RunTerminalOutputLimit;
+} | {
+    kind: 'unrecognized';
+    word: string;
+};
+export type RunTerminalJsonValue = string | number | boolean | null | readonly RunTerminalJsonValue[] | {
+    readonly [key: string]: RunTerminalJsonValue;
+};
+export interface RunTerminalOutputLimit {
+    capStop: boolean;
+    outputTokens?: number;
+    capTokens?: number;
+}
+export interface RunTerminalProviderRejectedDetail {
+    kind: 'provider_rejected';
+    status: number;
     code?: string;
+    providerCondition?: string;
+    providerConditionSource?: string;
+    providerResetAtMs?: number;
+    route?: RunTerminalRequestRoute;
 }
+export interface RunTerminalRequestRoute {
+    credentialSource: string;
+    carrier?: string;
+    carrierBag?: string;
+    root: string;
+}
+export type RunTerminalCompletedDetail = {
+    kind: 'finish_reason_unknown';
+    finishReasonUnknown: string;
+} | {
+    kind: 'unrecognized';
+    word: string;
+};
 export declare const PROMPT_BLOCK_CAUSES: readonly ["block", "crashed", "timeout", "cancelled"];
 export type PromptBlockCause = (typeof PROMPT_BLOCK_CAUSES)[number];
 export type RunTerminalBlockedDetail = {
@@ -31,9 +69,13 @@ export type RunTerminalBlockedDetail = {
     kind: 'unrecognized';
     word: string;
 };
-export type RunTerminalRead = {
+export type RunTerminalRead = RunTerminalReadArm & {
+    readonly replay?: true;
+};
+type RunTerminalReadArm = {
     kind: 'completed';
     plane: RunTerminalPlane;
+    detail?: RunTerminalCompletedDetail;
 } | {
     kind: 'failed';
     plane: RunTerminalPlane;
@@ -60,3 +102,4 @@ export declare function runTerminalGateKind(read: RunTerminalRead | null): strin
 export declare function runTerminalGateToolName(read: RunTerminalRead | null): string | undefined;
 export declare function runTerminalCode(read: RunTerminalRead | null): string | undefined;
 export declare function isReviewPark(read: RunTerminalRead | null): boolean;
+export {};

package/dist/runTerminal.js

@@ -1,5 +1,7 @@
 import { CORE_PROMPT_BLOCK_CAUSES } from './generated/engineFactTables.js';
 import { isSdkRunParked } from './terminalStatuses.js';
+import { readOwnDataNonEmptyString, readOwnDataValue } from './ownKey.js';
+import { doneResultView } from './replayBody.js';
 export const PROMPT_BLOCK_CAUSES = CORE_PROMPT_BLOCK_CAUSES;
 const PROMPT_BLOCKED_BY_HOOK_DETAIL_KIND = 'prompt_blocked_by_hook';
 function str(v) {
@@ -27,6 +29,123 @@ function ownValueOf(o, k) {
     return Object.prototype.hasOwnProperty.call(o, k) ? o[k] : undefined;
 }
 const PROVIDER_REJECTED_DETAIL_KIND = 'provider_rejected';
+const CODED_DETAIL_KIND = 'coded';
+const MODEL_OUTPUT_INVALID_DETAIL_KIND = 'model_output_invalid';
+const MODEL_OUTPUT_INVALID_CAUSES = Object.freeze(['truncated', 'unnamed']);
+const _modelOutputInvalidCausePin = [true, true];
+void _modelOutputInvalidCausePin;
+const CODED_DETAIL_MAX_DEPTH = 40;
+function ownData(o, k) {
+    const d = Object.getOwnPropertyDescriptor(o, k);
+    return d !== undefined && 'value' in d ? d.value : undefined;
+}
+function isPlainRecord(v) {
+    if (typeof v !== 'object' || v === null || Array.isArray(v))
+        return false;
+    const proto = Object.getPrototypeOf(v);
+    return proto === null || Object.getPrototypeOf(proto) === null;
+}
+const CODED_DETAIL_BUDGET = 50_000;
+const CODED_DETAIL_OVER_BUDGET = Symbol('coded-detail-over-budget');
+function jsonSnapshot(v, depth, ctx) {
+    ctx.budget -= 1;
+    if (ctx.budget < 0)
+        throw CODED_DETAIL_OVER_BUDGET;
+    if (v === null || typeof v === 'string' || typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : undefined;
+    if (depth >= CODED_DETAIL_MAX_DEPTH)
+        return undefined;
+    if (typeof v !== 'object' || ctx.path.has(v))
+        return undefined;
+    if (Array.isArray(v)) {
+        const n = ownData(v, 'length');
+        if (typeof n !== 'number' || !Number.isSafeInteger(n) || n < 0)
+            return undefined;
+        ctx.path.add(v);
+        try {
+            const out = [];
+            for (let i = 0; i < n; i += 1) {
+                ctx.budget -= 1;
+                if (ctx.budget < 0)
+                    throw CODED_DETAIL_OVER_BUDGET;
+                let item;
+                try {
+                    item = jsonSnapshot(ownData(v, String(i)), depth + 1, ctx);
+                }
+                catch (e) {
+                    if (e === CODED_DETAIL_OVER_BUDGET)
+                        throw e;
+                    item = undefined;
+                }
+                if (item !== undefined)
+                    out.push(item);
+            }
+            return Object.freeze(out);
+        }
+        finally {
+            ctx.path.delete(v);
+        }
+    }
+    if (!isPlainRecord(v))
+        return undefined;
+    ctx.path.add(v);
+    try {
+        const out = {};
+        for (const k of Object.keys(v)) {
+            let item;
+            try {
+                item = jsonSnapshot(ownData(v, k), depth + 1, ctx);
+            }
+            catch (e) {
+                if (e === CODED_DETAIL_OVER_BUDGET)
+                    throw e;
+                item = undefined;
+            }
+            if (item !== undefined)
+                Object.defineProperty(out, k, { value: item, enumerable: true, writable: false, configurable: false });
+        }
+        return Object.freeze(out);
+    }
+    finally {
+        ctx.path.delete(v);
+    }
+}
+const isCount = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0;
+function outputLimitOf(d) {
+    try {
+        const v = ownData(d, 'outputLimit');
+        if (!isPlainRecord(v))
+            return undefined;
+        const capStop = ownData(v, 'capStop');
+        if (typeof capStop !== 'boolean')
+            return undefined;
+        const outputTokens = ownData(v, 'outputTokens');
+        const capTokens = ownData(v, 'capTokens');
+        return { capStop, ...(isCount(outputTokens) ? { outputTokens } : {}), ...(isCount(capTokens) ? { capTokens } : {}) };
+    }
+    catch {
+        return undefined;
+    }
+}
+function requestRouteOf(d) {
+    try {
+        const v = ownData(d, 'route');
+        if (!isPlainRecord(v))
+            return undefined;
+        const credentialSource = str(ownData(v, 'credentialSource'));
+        const root = str(ownData(v, 'root'));
+        if (credentialSource === undefined || root === undefined)
+            return undefined;
+        const carrier = str(ownData(v, 'carrier'));
+        const carrierBag = str(ownData(v, 'carrierBag'));
+        return { credentialSource, ...(carrier !== undefined ? { carrier } : {}), ...(carrierBag !== undefined ? { carrierBag } : {}), root };
+    }
+    catch {
+        return undefined;
+    }
+}
 function failureDetailOf(cause) {
     try {
         const own = ownValueOf;
@@ -36,12 +155,85 @@ function failureDetailOf(cause) {
         const kind = str(own(v, 'kind'));
         if (kind === undefined)
             return undefined;
-        const rawStatus = own(v, 'status');
-        const status = typeof rawStatus === 'number' && Number.isInteger(rawStatus) && rawStatus >= 100 && rawStatus <= 599 ? rawStatus : undefined;
-        if (kind === PROVIDER_REJECTED_DETAIL_KIND && (status === undefined || status < 400))
+        if (kind === PROVIDER_REJECTED_DETAIL_KIND) {
+            const rawStatus = own(v, 'status');
+            const status = typeof rawStatus === 'number' && Number.isInteger(rawStatus) && rawStatus >= 400 && rawStatus <= 599 ? rawStatus : undefined;
+            if (status === undefined)
+                return undefined;
+            const code = str(own(v, 'code'));
+            const providerCondition = optionalDetailString(v, 'providerCondition');
+            const providerConditionSource = optionalDetailString(v, 'providerConditionSource');
+            let providerResetAtMs;
+            try {
+                const r = ownData(v, 'providerResetAtMs');
+                providerResetAtMs = typeof r === 'number' && Number.isFinite(r) && r >= 0 ? r : undefined;
+            }
+            catch {
+                providerResetAtMs = undefined;
+            }
+            const route = requestRouteOf(v);
+            return {
+                kind: PROVIDER_REJECTED_DETAIL_KIND,
+                status,
+                ...(code !== undefined ? { code } : {}),
+                ...(providerCondition !== undefined ? { providerCondition } : {}),
+                ...(providerConditionSource !== undefined ? { providerConditionSource } : {}),
+                ...(providerResetAtMs !== undefined ? { providerResetAtMs } : {}),
+                ...(route !== undefined ? { route } : {}),
+            };
+        }
+        if (kind === CODED_DETAIL_KIND) {
+            const inner = ownData(v, 'detail');
+            if (!isPlainRecord(inner))
+                return undefined;
+            let snap;
+            try {
+                snap = jsonSnapshot(inner, 0, { budget: CODED_DETAIL_BUDGET, path: new Set() });
+            }
+            catch (e) {
+                if (e === CODED_DETAIL_OVER_BUDGET)
+                    return undefined;
+                throw e;
+            }
+            if (snap === undefined || snap === null || typeof snap !== 'object' || Array.isArray(snap))
+                return undefined;
+            return { kind: CODED_DETAIL_KIND, detail: snap };
+        }
+        if (kind === MODEL_OUTPUT_INVALID_DETAIL_KIND) {
+            const c = ownData(v, 'cause');
+            const cause = MODEL_OUTPUT_INVALID_CAUSES.find((w) => w === c);
+            if (cause === undefined)
+                return undefined;
+            const outputLimit = outputLimitOf(v);
+            return { kind: MODEL_OUTPUT_INVALID_DETAIL_KIND, cause, ...(outputLimit !== undefined ? { outputLimit } : {}) };
+        }
+        return { kind: 'unrecognized', word: kind };
+    }
+    catch {
+        return undefined;
+    }
+}
+function optionalDetailString(d, key) {
+    try {
+        return readOwnDataNonEmptyString(d, key);
+    }
+    catch {
+        return undefined;
+    }
+}
+const FINISH_REASON_UNKNOWN_DETAIL_KIND = 'finish_reason_unknown';
+function completedDetailOf(cause) {
+    try {
+        const v = readOwnDataValue(cause, 'detail');
+        if (typeof v !== 'object' || v === null || Array.isArray(v))
             return undefined;
-        const code = str(own(v, 'code'));
-        return { kind, ...(status !== undefined ? { status } : {}), ...(code !== undefined ? { code } : {}) };
+        const kind = readOwnDataNonEmptyString(v, 'kind');
+        if (kind === undefined)
+            return undefined;
+        if (kind !== FINISH_REASON_UNKNOWN_DETAIL_KIND)
+            return { kind: 'unrecognized', word: kind };
+        const word = readOwnDataNonEmptyString(v, 'finishReasonUnknown');
+        return word === undefined ? undefined : { kind: FINISH_REASON_UNKNOWN_DETAIL_KIND, finishReasonUnknown: word };
     }
     catch {
         return undefined;
@@ -71,6 +263,16 @@ function blockedDetailOf(cause) {
     }
 }
 export function readRunTerminal(result) {
+    if (typeof result !== 'object' || result === null || Array.isArray(result))
+        return null;
+    const view = doneResultView(result);
+    if (view.replay) {
+        const inner = readRunTerminalArm(view.engine) ?? readRunTerminalArm({ status: view.row?.status, errorCode: view.row?.errorCode, errorMessage: view.row?.error });
+        return inner === null ? null : { ...inner, replay: true };
+    }
+    return readRunTerminalArm(result);
+}
+function readRunTerminalArm(result) {
     if (typeof result !== 'object' || result === null || Array.isArray(result))
         return null;
     const r = result;
@@ -87,8 +289,10 @@ export function readRunTerminal(result) {
             return { kind: 'paused', plane: 'cause', flatStatus: parkWord, ...(kind === 'paused' ? (pauseOf(c) ?? {}) : {}) };
         }
         switch (kind) {
-            case 'completed':
-                return { kind: 'completed', plane: 'cause' };
+            case 'completed': {
+                const detail = completedDetailOf(c);
+                return { kind: 'completed', plane: 'cause', ...(detail !== undefined ? { detail } : {}) };
+            }
             case 'failed': {
                 const code = str(c.code);
                 const message = str(c.message);
@@ -160,11 +364,10 @@ export function readRunTerminal(result) {
         ...(message !== undefined ? { message } : {}),
     };
 }
-export const REVIEW_PARK_GATE_KINDS = Object.freeze([
-    'plan_review',
-    'dry_run_review',
-    'needs_review',
-]);
+const REVIEW_PARK_GATE_KIND_TUPLE = ['plan_review', 'needs_review'];
+const _reviewParkGateKindPins = [true, true];
+void _reviewParkGateKindPins;
+export const REVIEW_PARK_GATE_KINDS = Object.freeze([...REVIEW_PARK_GATE_KIND_TUPLE]);
 export function runTerminalGateKind(read) {
     return read !== null && read.kind === 'paused' ? str(read.gate?.kind) : undefined;
 }

package/dist/sandboxWire.js

@@ -1,4 +1,5 @@
 import { lastFlagValue } from './argvFlagValue.js';
+import { CAPABILITY_IMAGE_INDEX_REQUIRED } from './engineErrorCodes.js';
 const MAX_PROFILE_LEN = 128;
 const USAGE_HINT = "sema: --sandbox expects a profile name or 'auto'.\n" +
     '  --sandbox <profile>  run on that sandbox image profile (k8s-lane workers; list: sema cloud images list)\n' +
@@ -45,8 +46,20 @@ export const SANDBOX_K8S_ONLY_400_ANCHOR = 'only supported on the k8s sandbox ba
 export const SANDBOX_NO_IMAGE_INDEX_400_ANCHOR = 'requires the image index';
 export const SANDBOX_NO_PUBLISHED_IMAGE_404_ANCHOR = 'no published sandbox image for profile';
 export const SANDBOX_CASCADE_CONFLICT_400_ANCHOR = 'not supported together with cascade/verify';
+const SANDBOX_IMAGE_INDEX_501_HINT = 'Cloud sandbox images are not available on this engine: its storage backend keeps no image index, so profiles cannot be listed or selected here.\n' +
+    'Use a worker backed by a SQL store (it has the image index), or re-run without --sandbox.';
+function imageIndexRequiredCode(err) {
+    try {
+        return typeof err === 'object' && err !== null && err.errorCode === CAPABILITY_IMAGE_INDEX_REQUIRED;
+    }
+    catch {
+        return false;
+    }
+}
 export function sandboxDegradeHint(err) {
     const e = err;
+    if (e?.status === 501 && imageIndexRequiredCode(err))
+        return SANDBOX_IMAGE_INDEX_501_HINT;
     if (typeof e?.status !== 'number' || typeof e?.message !== 'string')
         return undefined;
     const msg = e.message;

package/dist/sdkWireTransit.d.ts

@@ -1,4 +1,5 @@
 export { AgentClient } from '@sema-agent/sdk';
 export { isApprovalRequestFrameV1, isApprovalRevokeFrameV1 } from '@sema-agent/sdk';
 export { pushSessionBundle, pullSessionBundle, importSessionBundle, APIError } from '@sema-agent/sdk';
-export type { TaskRequest, SessionPermissionRules, SemaSettings, SkillSpec, AgentEvent, RunReceipt, CancelAck, RunRecord, ToolApprovalRespondAck, FleetTaskRow, FleetWorkflowRow, ApprovalCard, ApprovalRequestFrame, ApprovalRiskAxes, AskDecisionAck, AskDecisionBody, PolicyInfo, CcImportLayer, CcImportPrepareResult, CcImportRedeemResult, CcImportSettingsLayer, CcImportSkippedRule, PersistedRule, RuleRevokeRequest, RuleRevokeResult, } from '@sema-agent/sdk';
+export { APPROVAL_DECIDE_GATE_KINDS, PLAN_REVIEW_GATE_KINDS } from '@sema-agent/sdk';
+export type { TaskRequest, SessionPermissionRules, SemaSettings, SkillSpec, AgentEvent, RunReceipt, CancelAck, RunRecord, ToolApprovalRespondAck, FleetTaskRow, FleetWorkflowRow, ApprovalCard, ApprovalRequestFrame, ApprovalRiskAxes, AskDecisionAck, AskDecisionBody, PolicyInfo, CcImportLayer, CcImportPrepareResult, CcImportRedeemResult, CcImportSettingsLayer, CcImportSkippedRule, PersistedRule, RuleRevokeRequest, RuleRevokeResult, ApprovalDecideGateKind, PlanReviewGateKind, } from '@sema-agent/sdk';

package/dist/sdkWireTransit.js

@@ -1,3 +1,4 @@
 export { AgentClient } from '@sema-agent/sdk';
 export { isApprovalRequestFrameV1, isApprovalRevokeFrameV1 } from '@sema-agent/sdk';
 export { pushSessionBundle, pullSessionBundle, importSessionBundle, APIError } from '@sema-agent/sdk';
+export { APPROVAL_DECIDE_GATE_KINDS, PLAN_REVIEW_GATE_KINDS } from '@sema-agent/sdk';

package/dist/sealedKeyCapability.d.ts

@@ -1,5 +1,7 @@
 export type SealedKeyReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {
@@ -9,8 +11,4 @@ export type SealedKeyReading = {
     publicKey: string;
 };
 export declare function projectSealedKeyCapability(caps: unknown): SealedKeyReading | undefined;
-export declare function noteEngineCapsForSealedKey(baseUrl: string, caps: unknown, opts?: {
-    generation?: number;
-}): void;
 export declare function observedSealedKey(baseUrl?: string | undefined): SealedKeyReading;
-export declare function __resetSealedKeyReadingsForTests(): void;

package/dist/sealedKeyCapability.js

@@ -28,14 +28,7 @@ export function projectSealedKeyCapability(caps) {
 const reader = createEngineCapReader({
     name: 'sealedKey',
     project: projectSealedKeyCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-export function noteEngineCapsForSealedKey(baseUrl, caps, opts) {
-    reader.note(baseUrl, caps, opts);
-}
 export function observedSealedKey(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-export function __resetSealedKeyReadingsForTests() {
-    reader.__resetForTests();
-}

package/dist/seam.js

@@ -102,7 +102,8 @@ const CHROME_ARM_TABLE = {
         required: true,
         duty: '整段替换:①`diverged`(never false)在场 ⇒ 自己拼 thinking stream_delta 上屏的端按 content 重渲该块;' +
             '②`committedPrefixDiverged`(never false)在场 ⇒ 所有端把 `committedUuids` 首行就地换成 content,其余行**删除或清空其推理正文**(宿主按自身转录结构选:有父链/压缩段依赖的转录清空优于删,保行身份;安全目标 = 未脱敏字节零留盘;整段换不切片;`committedUuid` = 末条兼容位;`committedPrefixLen` = 全部行全文长度之和,单位 UTF-16 代码单元);' +
-            '本包在这一形上一个字节都不再交;③三键全缺席 ⇒ 照旧只当对账/定界;④缺席 ≠ 段没结束,按整条流判。',
+            '本包在这一形上一个字节都不再交;③三键全缺席 ⇒ 照旧只当对账/定界;④缺席 ≠ 段没结束,按整条流判;' +
+            '⑤序:该段推理尾部的活体增量一律先于本事件到达,本事件之后不再有同段推理增量。',
     },
     wiring_manifest: {
         required: false,
@@ -150,7 +151,8 @@ const CHROME_ARM_TABLE = {
             '🔴 **单位 = JS 字符串长度(UTF-16 代码单元),不是 UTF-8 字节、也不是几条消息**' +
             '(按 UTF-8 字节截会在非 ASCII 正文上截错位置把凭据留在屏上;按消息丢会连合并在同一条消息里的上一段定稿一起删掉),' +
             '照抄 `已committed正文.slice(0, 长度 - committedPrefixLen) + content`;按**增量拼文**计长、不是 content 上的偏移;④三键全缺席 ⇒ 照旧只当对账/定界,拿 content 再渲一行 = 同一段上屏两遍;⑤`segmentId`(恒在场)= 段身份,与本段已过境的 committed 文本行顶层 `_sema_segment_id` 同值 —— 换掉已提交那截时认行的钥匙是**两把**:行 uuid ∧ 段身份(按字节相等找行会被同后缀的独立行冒充)。' +
-            '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = 前段定稿前缀 + content、其余行空;别整行换首行,提交行可能带上一段定稿),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位。',
+            '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = 前段定稿前缀 + content、其余行空;别整行换首行,提交行可能带上一段定稿),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位;' +
+            '⑦序:该段尾部的活体增量(`stream_delta`)一律先于本事件到达,本事件之后不再有同段增量(下一条增量属于下一段)。',
     },
 };
 export const CHROME_ARMS = Object.entries(CHROME_ARM_TABLE).map(([kind, d]) => ({ kind, required: d.required, duty: d.duty }));