@sema-agent/client-core 0.96.0 → 0.97.0

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,12 +11,41 @@ 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';

package/dist/runTerminal.js

@@ -29,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;
@@ -38,21 +155,59 @@ 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))
-            return undefined;
-        const code = str(own(v, 'code'));
-        const isRejection = kind === PROVIDER_REJECTED_DETAIL_KIND;
-        const providerCondition = isRejection ? optionalDetailString(v, 'providerCondition') : undefined;
-        const providerConditionSource = isRejection ? optionalDetailString(v, 'providerConditionSource') : undefined;
-        return {
-            kind,
-            ...(status !== undefined ? { status } : {}),
-            ...(code !== undefined ? { code } : {}),
-            ...(providerCondition !== undefined ? { providerCondition } : {}),
-            ...(providerConditionSource !== undefined ? { providerConditionSource } : {}),
-        };
+        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;

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';
 } | {

package/dist/sealedKeyCapability.js

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

package/dist/seatContract.d.ts

@@ -68,7 +68,7 @@ export interface ToolPermissionRequest {
     ruleOffersAbsence?: string;
     askClass?: string;
     classes?: readonly string[];
-    rememberRefused?: true;
+    sessionRow?: true;
 }
 declare const SEAT_EVENT_TYPE_TUPLE: readonly ["start", "close", "session_updated", "message", "stream_event", "chrome_event", "error", "tool_permission_resolved"];
 export type SeatEventType = (typeof SEAT_EVENT_TYPE_TUPLE)[number];
@@ -343,7 +343,7 @@ export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "inter
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "messages", "error", "errorCategory", "code", "request", "data", "sources", "permissionMode", "session", "userMessageUuid", "hasPreClearSession", "requestId", "outcome", "parked", "chrome"];
-export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "rememberRefused"];
+export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "sessionRow"];
 export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"];
 export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario", "rewind"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
@@ -426,8 +426,8 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
             readonly key: "classes";
             readonly why: "与 askClass 同一对(CC-284),同在同缺、同一只成对窄读(非空、每员非空串、无重复、首员等于 askClass;开集、原样顺序);座位门不设第二判官,理由同 askClass。";
         }, {
-            readonly key: "rememberRefused";
-            readonly why: "展示增强位(CC-642),权威窄读在卡口两条腿与过境口 toolPermissionRequestAskBits(同一只 readApprovalRememberRefused:自有键 ∧ 严格 true 才上座,永不铸 false);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 读,其余(缺席 / 坏形)一律当缺席 ⇒ 照旧渲「本会话放行」。缺席 = 服务端没说(记得住或老服务端),不是 false。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+            readonly key: "sessionRow";
+            readonly why: "放宽方向的展示位(CC-699),判官在过境口 toolPermissionRequestAskBits(card, requestId):卡上「本会话放行」判官 standingRowsOf 的会话行同一前提 ∧ 本请求 requestId 的域带得走(live: / durable:),严格 true 才上座、永不铸 false;座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 才渲「本会话放行」,其余(缺席 / 坏形)一律不渲 —— 缺席是闭合失败,不是「没说就照渲」。不经过境口自铸座位请求的宿主拿不到这一位,座位卡就不给那一档。";
         }, {
             readonly key: "ruleOffersAbsence";
             readonly why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
@@ -454,6 +454,9 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly unchecked: readonly [{
             readonly key: "droppedEntries";
             readonly why: "诊断面(哪些目录条目没被引擎收下),三态读法归 droppedModelEntriesOf(含坏形 malformed);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
+        }, {
+            readonly key: "candidateRejected";
+            readonly why: "诊断面(0.97.0 CC-715;当前配置是候选被整拒后回落的那一份),三态读法归 modelCandidateRejectedOf(含坏形 unreadable);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
         }];
     };
     readonly SendMessageRequest: {

package/dist/seatContract.js

@@ -33,6 +33,16 @@ const ownItems = (a) => {
         out.push(own(a, String(i)));
     return out;
 };
+const sendableKeysOf = (v) => {
+    const keys = [];
+    for (const k of Reflect.ownKeys(v)) {
+        if (typeof k !== "string")
+            continue;
+        own(v, k);
+        keys.push(k);
+    }
+    return keys;
+};
 const firstAccessorPath = (root) => {
     const seen = new Set();
     const stack = [[root, ""]];
@@ -592,9 +602,9 @@ const checkLiveModelCatalog = seatCheck((v) => {
     return true;
 });
 const checkSeatRewindIntent = seatCheck((v) => {
-    if (!isObject(v) || Array.isArray(v))
-        return bad("rewind must be an object {mode, targetMessageUuid}");
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("rewind must be a plain object {mode, targetMessageUuid}");
+    for (const k of sendableKeysOf(v)) {
         if (!inTuple(SEAT_REWIND_INTENT_KEYS, k))
             return bad(`unknown key (closed shape: ${SEAT_REWIND_INTENT_KEYS.join(", ")})`, k);
     }
@@ -608,9 +618,9 @@ const checkSeatRewindIntent = seatCheck((v) => {
     return true;
 });
 const checkSeatTurnSettings = seatCheck((v) => {
-    if (!isObject(v) || Array.isArray(v))
-        return bad("settings must be an object");
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("settings must be a plain object");
+    for (const k of sendableKeysOf(v)) {
         if (!inTuple(SEAT_TURN_SETTINGS_KEYS, k)) {
             const host = Object.hasOwn(SEAT_TURN_SETTINGS_ORIGINS, k);
             return bad(host ? "this settings key is supplied by the host, not carried by the seat" : `unknown key (closed shape: ${SEAT_TURN_SETTINGS_KEYS.join(", ")})`, k);
@@ -624,9 +634,9 @@ const checkSeatTurnSettings = seatCheck((v) => {
 const checkRetainSubagentSessions = seatCheck((v) => {
     if (typeof v === "boolean")
         return true;
-    if (!isObject(v) || Array.isArray(v))
-        return bad("retainSubagentSessions must be a boolean or {ttlMs?, max?}");
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("retainSubagentSessions must be a boolean or a plain object {ttlMs?, max?}");
+    for (const k of sendableKeysOf(v)) {
         if (k !== "ttlMs" && k !== "max")
             return bad("unknown key (closed shape: ttlMs, max)", k);
         const n = own(v, k);
@@ -637,13 +647,13 @@ const checkRetainSubagentSessions = seatCheck((v) => {
 });
 export function checkSendMessageRequest(v) {
     try {
-        if (!isObject(v) || Array.isArray(v))
-            return bad("sendMessage request is not an object");
+        if (!isPlainRecord(v))
+            return bad("sendMessage request is not a plain object");
         const at = firstAccessorPath(v);
         if (at !== undefined)
             return bad(NOT_PLAIN_DATA, at);
-        const body = {};
-        for (const k of Object.keys(v)) {
+        const body = Object.create(null);
+        for (const k of sendableKeysOf(v)) {
             if (!inTuple(SEND_MESSAGE_REQUEST_KEYS, k))
                 return bad(`unknown key (closed shape: ${SEND_MESSAGE_REQUEST_KEYS.join(", ")})`, k);
             body[k] = own(v, k);
@@ -703,10 +713,10 @@ export function isSendMessageRequest(v) {
     return checkSendMessageRequest(v) === true;
 }
 export const checkSessionRowPatchRequest = seatCheck((v) => {
-    if (!isObject(v) || Array.isArray(v))
-        return bad("patchSession request is not an object");
-    const body = {};
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("patchSession request is not a plain object");
+    const body = Object.create(null);
+    for (const k of sendableKeysOf(v)) {
         if (!inTuple(SESSION_ROW_PATCH_REQUEST_KEYS, k))
             return bad(`unknown key (closed shape: ${SESSION_ROW_PATCH_REQUEST_KEYS.join(", ")})`, k);
         body[k] = own(v, k);
@@ -959,7 +969,7 @@ export const TOOL_PERMISSION_REQUEST_KEYS = [
     "ruleOffersAbsence",
     "askClass",
     "classes",
-    "rememberRefused",
+    "sessionRow",
 ];
 export const LOCAL_SESSION_RECORD_KEYS = [
     "sessionId",
@@ -1058,8 +1068,8 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 why: "与 askClass 同一对(CC-284),同在同缺、同一只成对窄读(非空、每员非空串、无重复、首员等于 askClass;开集、原样顺序);座位门不设第二判官,理由同 askClass。",
             },
             {
-                key: "rememberRefused",
-                why: "展示增强位(CC-642),权威窄读在卡口两条腿与过境口 toolPermissionRequestAskBits(同一只 readApprovalRememberRefused:自有键 ∧ 严格 true 才上座,永不铸 false);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 读,其余(缺席 / 坏形)一律当缺席 ⇒ 照旧渲「本会话放行」。缺席 = 服务端没说(记得住或老服务端),不是 false。不经过境口自铸座位请求的宿主要自己按同一把窄读。",
+                key: "sessionRow",
+                why: "放宽方向的展示位(CC-699),判官在过境口 toolPermissionRequestAskBits(card, requestId):卡上「本会话放行」判官 standingRowsOf 的会话行同一前提 ∧ 本请求 requestId 的域带得走(live: / durable:),严格 true 才上座、永不铸 false;座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 才渲「本会话放行」,其余(缺席 / 坏形)一律不渲 —— 缺席是闭合失败,不是「没说就照渲」。不经过境口自铸座位请求的宿主拿不到这一位,座位卡就不给那一档。",
             },
             {
                 key: "ruleOffersAbsence",
@@ -1110,6 +1120,10 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 key: "droppedEntries",
                 why: "诊断面(哪些目录条目没被引擎收下),三态读法归 droppedModelEntriesOf(含坏形 malformed);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。",
             },
+            {
+                key: "candidateRejected",
+                why: "诊断面(0.97.0 CC-715;当前配置是候选被整拒后回落的那一份),三态读法归 modelCandidateRejectedOf(含坏形 unreadable);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。",
+            },
         ],
     },
     SendMessageRequest: {

package/dist/sessionPolicyCapability.d.ts

@@ -1,5 +1,7 @@
 export type SessionPolicyReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/sessionPolicyCapability.js

@@ -1,5 +1,5 @@
 import { engineWireTarget } from './engineWireTarget.js';
-import { createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 export function projectSessionPolicyCapability(caps) {
     try {
@@ -20,7 +20,6 @@ export function projectSessionPolicyCapability(caps) {
 const reader = createEngineCapReader({
     name: 'sessionPolicy',
     project: projectSessionPolicyCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForSessionPolicy(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
@@ -37,6 +36,8 @@ export function sessionPolicyFaceAvailable(reading) {
 }
 export function sessionPolicyDoctorDetail(reading) {
     switch (reading.kind) {
+        case 'unreadable':
+            return unreadableReadingDetail('per-session rule face');
         case 'unobserved':
             return 'per-session rule face not observed — the engine reports it on /v1/capabilities (sessionPolicy); this process has no usable capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which)';
         case 'not_reported':

package/dist/sessionReadRedactionCapability.d.ts

@@ -1,5 +1,7 @@
 export type SessionReadRedactionReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/sessionReadRedactionCapability.js

@@ -17,7 +17,6 @@ export function projectSessionReadRedactionCapability(caps) {
 const reader = createEngineCapReader({
     name: 'sessionReadRedaction',
     project: projectSessionReadRedactionCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function observedSessionReadRedaction(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);

package/dist/sessionSyncFileHistoryCapability.d.ts

@@ -1,5 +1,7 @@
 export type SessionSyncFileHistoryReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/sessionSyncFileHistoryCapability.js

@@ -1,5 +1,5 @@
 import { engineWireTarget } from './engineWireTarget.js';
-import { createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 export function projectSessionSyncFileHistoryCapability(caps) {
     try {
@@ -19,7 +19,6 @@ export function projectSessionSyncFileHistoryCapability(caps) {
 const reader = createEngineCapReader({
     name: 'sessionSyncFileHistory',
     project: projectSessionSyncFileHistoryCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForSessionSyncFileHistory(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
@@ -36,6 +35,8 @@ export function sessionSyncFileHistoryAvailable(reading) {
 }
 export function sessionSyncFileHistoryDoctorDetail(reading) {
     switch (reading.kind) {
+        case 'unreadable':
+            return unreadableReadingDetail('session-sync file history');
         case 'unobserved':
             return 'session-sync file history not observed — the engine reports it on /v1/capabilities (sessionSyncFileHistory); this process has no usable capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which)';
         case 'not_reported':

package/dist/skillToolListsCapability.d.ts

@@ -1,5 +1,7 @@
 export type SkillToolListsReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/skillToolListsCapability.js

@@ -1,5 +1,5 @@
 import { engineWireTarget } from './engineWireTarget.js';
-import { createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 export function projectSkillToolListsCapability(caps) {
     try {
@@ -19,7 +19,6 @@ export function projectSkillToolListsCapability(caps) {
 const reader = createEngineCapReader({
     name: 'skillToolLists',
     project: projectSkillToolListsCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForSkillToolLists(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
@@ -36,6 +35,8 @@ export function skillToolListsAvailable(reading) {
 }
 export function skillToolListsDoctorDetail(reading) {
     switch (reading.kind) {
+        case 'unreadable':
+            return unreadableReadingDetail('skill tool lists');
         case 'unobserved':
             return 'skill tool lists not observed — the engine reports it on /v1/capabilities (skillToolLists); this process has no usable capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which)';
         case 'not_reported':

package/dist/sqlEngineCapability.d.ts

@@ -5,6 +5,8 @@ export interface SqlEngineCapabilityView {
 }
 export type SqlEngineReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/sqlEngineCapability.js

@@ -1,6 +1,6 @@
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
-import { storeSeatOf, createEngineCapReader } from './engineCapReader.js';
+import { storeSeatOf, createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 export function projectSqlEngineCapability(caps) {
     try {
@@ -16,7 +16,7 @@ export function projectSqlEngineCapability(caps) {
                 return { kind: 'none' };
             return projectSqlEngineView(nested);
         }
-        return { kind: 'not_reported' };
+        return seat.kind === 'absent' ? { kind: 'not_reported' } : undefined;
     }
     catch {
         return undefined;
@@ -39,7 +39,6 @@ function projectSqlEngineView(sql) {
 const reader = createEngineCapReader({
     name: 'sql',
     project: projectSqlEngineCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForSqlEngine(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
@@ -53,6 +52,8 @@ function cleanSqlDetailScalar(v) {
 }
 export function sqlEngineDoctorDetail(reading) {
     switch (reading.kind) {
+        case 'unreadable':
+            return unreadableReadingDetail();
         case 'unobserved':
             return ('not observed — the engine reports it on /v1/capabilities; this process has no usable ' +
                 'capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which)');

package/dist/steerPriorityCapability.d.ts

@@ -1,5 +1,7 @@
 export type SteerPriorityReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/steerPriorityCapability.js

@@ -1,6 +1,6 @@
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
-import { createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 export function projectSteerPriorityCapability(caps) {
     try {
@@ -25,7 +25,6 @@ export function projectSteerPriorityCapability(caps) {
 const reader = createEngineCapReader({
     name: 'fleet.steerPriority',
     project: projectSteerPriorityCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForSteerPriority(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
@@ -65,6 +64,8 @@ export function steerPriorityDoctorDetail(reading) {
     if (kind === 'not_reported') {
         return 'steer priority not reported by this engine — its capabilities reading carries no fleet.steerPriority (the fleet face is not reported, or the face carries no such field; this client cannot tell which), so a "now" or "later" steer is not sent (steers without a priority work as before)';
     }
+    if (kind === 'unreadable')
+        return unreadableReadingDetail('steer priority');
     if (kind !== 'present' || typeof word !== 'string' || word.length === 0)
         return unobserved;
     if (word === 'engine')

package/dist/storePostureCapability.d.ts

@@ -8,6 +8,8 @@ export interface StorePostureView {
 }
 export type StorePostureReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {