@sema-agent/client-core 0.90.0 → 0.92.0

package/dist/humanTurnRead.js

@@ -0,0 +1,331 @@
+const descriptorKindsAligned = true;
+void descriptorKindsAligned;
+const MALFORMED = Object.freeze({});
+const bad = () => {
+    throw MALFORMED;
+};
+function isPlainObject(x) {
+    if (x === null || typeof x !== 'object' || Array.isArray(x))
+        return false;
+    const p = Object.getPrototypeOf(x);
+    return p === Object.prototype || p === null;
+}
+function ownData(o, key) {
+    const d = Object.getOwnPropertyDescriptor(o, key);
+    if (d === undefined)
+        return undefined;
+    if (!('value' in d))
+        bad();
+    return d.value;
+}
+function ownArray(x) {
+    if (!Array.isArray(x))
+        bad();
+    const arr = x;
+    const n = ownData(arr, 'length');
+    if (typeof n !== 'number' || !Number.isSafeInteger(n) || n < 0)
+        bad();
+    const out = [];
+    for (let i = 0; i < n; i += 1) {
+        const d = Object.getOwnPropertyDescriptor(arr, i);
+        if (d === undefined || !('value' in d))
+            bad();
+        out.push(d.value);
+    }
+    return out;
+}
+const str = (v) => (typeof v === 'string' ? v : bad());
+const optStr = (v) => (v === undefined ? undefined : str(v));
+const strArray = (v) => ownArray(v).map(str);
+const sizeOf = (v) => (v === null ? null : typeof v === 'number' ? v : bad());
+const posInt = (v) => (typeof v === 'number' && Number.isSafeInteger(v) && v >= 1 ? v : bad());
+const natInt = (v) => (typeof v === 'number' && Number.isSafeInteger(v) && v >= 0 ? v : bad());
+function sourceOf(v) {
+    return v === 'at-mention' || v === 'compact-restore' ? v : bad();
+}
+function readCell(x) {
+    if (!isPlainObject(x))
+        bad();
+    const c = x;
+    const outputsRaw = ownData(c, 'outputs');
+    const outputs = outputsRaw === undefined
+        ? []
+        : ownArray(outputsRaw).map((o) => {
+            if (!isPlainObject(o))
+                bad();
+            const hasImage = ownData(o, 'hasImage');
+            if (hasImage !== undefined && typeof hasImage !== 'boolean')
+                bad();
+            return { text: optStr(ownData(o, 'text')), hasImage: hasImage === true };
+        });
+    const tooLarge = ownData(c, 'outputsTooLarge');
+    if (tooLarge !== undefined && typeof tooLarge !== 'boolean')
+        bad();
+    return {
+        cellType: optStr(ownData(c, 'cellType')),
+        source: optStr(ownData(c, 'source')),
+        cellId: optStr(ownData(c, 'cellId')),
+        language: optStr(ownData(c, 'language')),
+        outputs,
+        outputsTooLarge: tooLarge === true,
+    };
+}
+function readDescriptorAny(x, imageDelivery) {
+    try {
+        if (!isPlainObject(x))
+            return undefined;
+        const o = x;
+        const kind = ownData(o, 'kind');
+        const name = () => str(ownData(o, 'name'));
+        const path = () => str(ownData(o, 'path'));
+        switch (kind) {
+            case 'text': {
+                const complete = ownData(o, 'complete');
+                if (typeof complete !== 'boolean')
+                    bad();
+                return {
+                    kind,
+                    source: sourceOf(ownData(o, 'source')),
+                    name: name(),
+                    path: path(),
+                    lines: strArray(ownData(o, 'lines')),
+                    startLine: posInt(ownData(o, 'startLine')),
+                    totalLines: natInt(ownData(o, 'totalLines')),
+                    complete: complete,
+                };
+            }
+            case 'notebook':
+                return { kind, source: sourceOf(ownData(o, 'source')), name: name(), path: path(), cells: ownArray(ownData(o, 'cells')).map(readCell) };
+            case 'image': {
+                let delivery;
+                if (imageDelivery === 'required') {
+                    const d = ownData(o, 'delivery');
+                    delivery = d === 'attached' || d === 'not-attached' ? d : bad();
+                }
+                return { kind, source: sourceOf(ownData(o, 'source')), name: name(), path: path(), sizeBytes: sizeOf(ownData(o, 'sizeBytes')), delivery };
+            }
+            case 'pdf': {
+                const pc = ownData(o, 'pageCount');
+                return {
+                    kind,
+                    source: sourceOf(ownData(o, 'source')),
+                    name: name(),
+                    path: path(),
+                    sizeBytes: sizeOf(ownData(o, 'sizeBytes')),
+                    pageCount: pc === null ? null : typeof pc === 'number' ? pc : bad(),
+                };
+            }
+            case 'directory':
+                return { kind, name: name(), path: path(), entries: strArray(ownData(o, 'entries')), totalEntries: natInt(ownData(o, 'totalEntries')) };
+            case 'not-included': {
+                const target = ownData(o, 'target');
+                const reason = ownData(o, 'reason');
+                if (target !== 'file' && target !== 'directory' && target !== 'path')
+                    bad();
+                if (reason !== 'too-large' && reason !== 'unreadable' && reason !== 'read-denied')
+                    bad();
+                return {
+                    kind,
+                    target: target,
+                    name: name(),
+                    path: path(),
+                    sizeBytes: sizeOf(ownData(o, 'sizeBytes')),
+                    reason: reason,
+                };
+            }
+            default:
+                return undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readDescriptor(x, imageDelivery) {
+    return readDescriptorAny(x, imageDelivery);
+}
+const REASON_LIST = ['empty', 'malformed_input', 'malformed_item', 'duplicate_uuid', 'rider_collides_primary'];
+const reasonListExhaustive = true;
+void reasonListExhaustive;
+const REJECT_SENTINELS = new Map(REASON_LIST.map((r) => [Object.freeze({}), r]));
+const sentinelOf = (reason) => {
+    for (const [s, r] of REJECT_SENTINELS)
+        if (r === reason)
+            return s;
+    return MALFORMED;
+};
+const reject = (reason) => {
+    throw sentinelOf(reason);
+};
+const rejectReasonOf = (e) => (typeof e === 'object' && e !== null ? REJECT_SENTINELS.get(e) : undefined);
+const nonEmpty = (v) => (typeof v === 'string' && v.length > 0 ? v : reject('malformed_item'));
+const optArray = (v) => (v === undefined ? [] : ownArray(v));
+function readImage(x) {
+    if (!isPlainObject(x))
+        reject('malformed_item');
+    const o = x;
+    const data = ownData(o, 'data');
+    const mimeType = ownData(o, 'mimeType');
+    const url = ownData(o, 'url');
+    if (url === undefined && data !== undefined)
+        return { data: nonEmpty(data), mimeType: nonEmpty(mimeType) };
+    if (data === undefined && mimeType === undefined)
+        return { url: nonEmpty(url) };
+    return reject('malformed_item');
+}
+const MISSING_KIND_LIST = ['rider_text', 'image', 'attachment_ref', 'non_text'];
+const MISSING_REASON_LIST = ['not_persisted', 'not_found', 'non_text_filtered', 'projection_failed'];
+const missingListsExhaustive = true;
+void missingListsExhaustive;
+const MISSING_KINDS = new Set(MISSING_KIND_LIST);
+const MISSING_REASONS = new Set(MISSING_REASON_LIST);
+function readItem(x) {
+    if (!isPlainObject(x))
+        reject('malformed_item');
+    const o = x;
+    const text = ownData(o, 'text');
+    if (typeof text !== 'string')
+        reject('malformed_item');
+    const attachments = optArray(ownData(o, 'attachments')).map((a) => {
+        if (!isPlainObject(a))
+            reject('malformed_item');
+        const ao = a;
+        const d = readDescriptorAny(ownData(ao, 'descriptor'), 'ignored');
+        if (d === undefined)
+            reject('malformed_item');
+        const px = ownData(ao, 'pixels');
+        let pixels;
+        if (px !== undefined) {
+            if (d.kind !== 'image' || !isPlainObject(px))
+                reject('malformed_item');
+            pixels = { data: nonEmpty(ownData(px, 'data')), mimeType: nonEmpty(ownData(px, 'mimeType')) };
+        }
+        return { uuid: nonEmpty(ownData(ao, 'uuid')), d: d, pixels };
+    });
+    return {
+        uuid: nonEmpty(ownData(o, 'uuid')),
+        text: text,
+        images: optArray(ownData(o, 'images')).map(readImage),
+        attachments,
+        attachmentIds: optArray(ownData(o, 'attachmentIds')).map(nonEmpty),
+        riders: optArray(ownData(o, 'riders')).map((r) => {
+            if (!isPlainObject(r))
+                reject('malformed_item');
+            const ti = ownData(r, 'textIncluded');
+            if (typeof ti !== 'boolean')
+                reject('malformed_item');
+            return { uuid: nonEmpty(ownData(r, 'uuid')), role: nonEmpty(ownData(r, 'role')), textIncluded: ti };
+        }),
+        missing: optArray(ownData(o, 'missing')).map((m) => {
+            if (!isPlainObject(m))
+                reject('malformed_item');
+            const kind = ownData(m, 'kind');
+            const reason = ownData(m, 'reason');
+            const ref = ownData(m, 'ref');
+            if (typeof kind !== 'string' || !MISSING_KINDS.has(kind))
+                reject('malformed_item');
+            if (typeof reason !== 'string' || !MISSING_REASONS.has(reason))
+                reject('malformed_item');
+            if (ref !== undefined && typeof ref !== 'string')
+                reject('malformed_item');
+            return { kind: kind, ref: ref, reason: reason };
+        }),
+    };
+}
+function readInputAny(x) {
+    if (!isPlainObject(x))
+        reject('malformed_input');
+    const o = x;
+    const lane = ownData(o, 'lane');
+    if (lane !== 'objective' && lane !== 'steer')
+        reject('malformed_input');
+    const caps = ownData(o, 'caps');
+    if (!isPlainObject(caps))
+        reject('malformed_input');
+    const vision = ownData(caps, 'vision');
+    if (vision !== undefined && vision !== 'yes' && vision !== 'no' && vision !== 'unknown')
+        reject('malformed_input');
+    let otherBodyBytes = 0;
+    if (lane === 'objective') {
+        const ob = ownData(o, 'otherBodyBytes');
+        if (typeof ob !== 'number' || !Number.isSafeInteger(ob) || ob < 2)
+            reject('malformed_input');
+        otherBodyBytes = ob;
+    }
+    const raw = ownData(o, 'items');
+    if (!Array.isArray(raw))
+        reject('malformed_input');
+    let rawItems;
+    try {
+        rawItems = ownArray(raw);
+    }
+    catch {
+        return reject('malformed_input');
+    }
+    if (rawItems.length === 0)
+        reject('empty');
+    const items = rawItems.map((x) => {
+        try {
+            return readItem(x);
+        }
+        catch (e) {
+            return reject(rejectReasonOf(e) ?? 'malformed_item');
+        }
+    });
+    const primaries = new Set();
+    for (const it of items) {
+        if (primaries.has(it.uuid))
+            reject('duplicate_uuid');
+        primaries.add(it.uuid);
+    }
+    const secondaries = new Set();
+    for (const it of items) {
+        for (const u of [...it.riders.map((r) => r.uuid), ...it.attachments.map((a) => a.uuid)]) {
+            if (primaries.has(u))
+                reject('rider_collides_primary');
+            if (secondaries.has(u))
+                reject('malformed_item');
+            secondaries.add(u);
+        }
+    }
+    if (items.every((it) => it.text.length === 0 && it.images.length === 0 && it.attachments.length === 0 && it.attachmentIds.length === 0))
+        reject('empty');
+    return { lane: lane, vision: vision ?? 'unknown', otherBodyBytes, items };
+}
+export function readHumanTurnInput(input) {
+    try {
+        return readInputAny(input);
+    }
+    catch (e) {
+        return { reject: rejectReasonOf(e) ?? 'malformed_input' };
+    }
+}
+export function readEncodingShares(encoding) {
+    try {
+        if (!isPlainObject(encoding) || ownData(encoding, 'ok') !== true)
+            return undefined;
+        const out = [];
+        for (const s of ownArray(ownData(encoding, 'shares'))) {
+            if (!isPlainObject(s))
+                return undefined;
+            const level = ownData(s, 'level');
+            const uuid = ownData(s, 'uuid');
+            const riders = ownArray(ownData(s, 'riderUuids'));
+            if (typeof uuid !== 'string' || uuid.length === 0)
+                return undefined;
+            if (level !== 'full' && level !== 'partial' && level !== 'none')
+                return undefined;
+            const riderUuids = [];
+            for (const r of riders) {
+                if (typeof r !== 'string' || r.length === 0)
+                    return undefined;
+                riderUuids.push(r);
+            }
+            out.push({ uuid, level, riderUuids });
+        }
+        return out;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/index.d.ts

@@ -31,7 +31,8 @@ export * from './executionLaneCapability.js';
 export * from './approvalsStreamLiveCapability.js';
 export * from './peerLaneCapability.js';
 export * from './permissionRulesWriteCapability.js';
-export * from './permissionsAllowGrantCapability.js';
+export { __resetPermissionsAllowGrantReadingsForTests, forgetPermissionsAllowGrantReading, noteEngineCapsForPermissionsAllowGrant, observedPermissionsAllowGrant, permissionsAllowGrantAvailable, permissionsAllowGrantDoctorDetail, projectPermissionsAllowGrantCapability, } from './permissionsAllowGrantCapability.js';
+export type { PermissionsAllowGrantReading } from './permissionsAllowGrantCapability.js';
 export * from './sessionPolicyCapability.js';
 export * from './memoryComplianceCapability.js';
 export * from './memoryOriginCapability.js';
@@ -49,6 +50,11 @@ export * from './mcpPanel.js';
 export * from './mcpLiveness.js';
 export * from './mcpEngineLeg.js';
 export * from './mcpProbeCapability.js';
+export * from './sessionSyncFileHistoryCapability.js';
+export * from './workflowsJournalCapability.js';
+export * from './userInvokedSkillsCapability.js';
+export * from './skillToolListsCapability.js';
+export * from './steerPriorityCapability.js';
 export * from './mcpProbeWire.js';
 export * from './effectiveFacts.js';
 export * from './gateOutcome.js';
@@ -68,14 +74,15 @@ export type { DisplayUntrustedOptions, DisplayMark, DisplayMarkSpan, DisplayUntr
 export type * from './types/engineState.js';
 export * from './hostEnv.js';
 export * from './unrefTimer.js';
-export { ControlRouter, ControlSafetyError, errCodes, type ControlClientLike, type ControlRouterOptions, type ControlSafetyCode, type ErrCodes, type QueuedCommand, type QueuePriority, type RunsResourceLike, } from './controlRouter.js';
+export { ControlRouter, ControlSafetyError, errCodes, steerBodyOf, steerRefusalAdviceOf, steeringRefusedBeforeEngine, type ControlClientLike, type ControlRouterOptions, type ControlRouterSteerOptions, type ControlSafetyCode, type ErrCodes, type RunsResourceLike, type SteerBody, type SteerBodyInput, type SteerRefusalAdvice, type SteeringRefusedBeforeEngine, } from './controlRouter.js';
+export { readSteerReceipt, type SteerReceiptReading } from './steerReceipt.js';
 export * from './sseIdleTriage.js';
 export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
 export { stripSystemReminderBlocks, unwrapSystemReminder } from './systemReminderTag.js';
 export { findSystemReminderOpenTag, type SystemReminderOpenTagSpan } from './systemReminderTag.js';
-export { ACTIVE_RUN_BUSY_ERROR_CODE, asModelFallbackReason, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_LEGACY_TOOL_NAME, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_REFUSAL_CODES, CONFIG_STRATEGY_FIND_LIMIT_INVALID, CONFIG_STRATEGY_MAX_SIZE_INVALID, CORRUPT_SESSION_ERROR_CODE, DECIDE_CLAIM_LOST, DECIDE_GATE_MOVED, DECIDE_NOT_PARKED, DECIDE_PARK_MOVED_CODES, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, FLEET_LEASE_UNAVAILABLE, GATE_PARKED_ERROR_CODE, isConfigRefusalCode, isCorruptSessionCode, isDecideParkMovedCode, isDelegationCapCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isRulesRefusalCode, isStatusDerivedCoarseCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, OUTPUT_INVALID, PARKED_RESUME_STARTUP_FAILED, RESUME_AT_ERROR_CODE_PREFIX, RESUME_CONTEXT_UNAVAILABLE, RESUME_ENV_FAILED, RESUME_PLACEMENT_MISMATCH, RESUME_POLICY_FOLD_CODE, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_RETRY_LATER_CODES, RESUME_TOOL_CONTRACT_MISMATCH, RESUME_TOOL_UNAVAILABLE, RESUME_USAGE_WINDOW_EXHAUSTED, REWIND_ERROR_CODE_PREFIXES, RULES_LEGACY_TOOL_NAME, SCENARIO_NOT_ALLOWED_ERROR_CODE, STATUS_DERIVED_COARSE_CODES, STOP_CONFLICT_CODES, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
-export type { DelegationCapDisposition, ModelFallbackReason, } from './engineErrorCodes.js';
+export { ACTIVE_RUN_BUSY_ERROR_CODE, APPROVAL_EXPIRED, ASK_GONE, asModelFallbackReason, CAPABILITY_OPERATOR_PRINCIPALS_REQUIRED, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_IMAGE_INVALID, CONFIG_LEGACY_TOOL_NAME, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_REFUSAL_CODES, CONFIG_STRATEGY_FIND_LIMIT_INVALID, CONFIG_STRATEGY_MAX_SIZE_INVALID, CORRUPT_SESSION_ERROR_CODE, DECIDE_CLAIM_LOST, DECIDE_GATE_MOVED, DECIDE_NOT_PARKED, DECIDE_PARK_MOVED_CODES, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, FLEET_LEASE_UNAVAILABLE, GATE_PARKED_ERROR_CODE, imageInvalidFailureNoteOf, isConfigRefusalCode, isCorruptSessionCode, isDecideParkMovedCode, isDelegationCapCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isRulesRefusalCode, isStatusDerivedCoarseCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, operatorGateRefusalContent, OUTPUT_INVALID, PARKED_RESUME_STARTUP_FAILED, RESUME_AT_ERROR_CODE_PREFIX, RESUME_CONTEXT_UNAVAILABLE, RESUME_ENV_FAILED, RESUME_PLACEMENT_MISMATCH, RESUME_POLICY_FOLD_CODE, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_RETRY_LATER_CODES, RESUME_TOOL_CONTRACT_MISMATCH, RESUME_TOOL_UNAVAILABLE, RESUME_USAGE_WINDOW_EXHAUSTED, REWIND_ERROR_CODE_PREFIXES, RULES_LEGACY_TOOL_NAME, RUN_DEATH_VERDICT_CODES, RUN_ORPHANED, RUN_STALLED, runDeathVerdictNoteOf, SCENARIO_NOT_ALLOWED_ERROR_CODE, STATUS_DERIVED_COARSE_CODES, STOP_CONFLICT_CODES, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
+export type { DelegationCapDisposition, ModelFallbackReason, OperatorGateRefusal, RunDeathVerdictCode, } from './engineErrorCodes.js';
 export * from './agentsWireCaps.js';
 export * from './attachmentsWireCaps.js';
 export * from './clientContextWireCaps.js';
@@ -110,17 +117,18 @@ export * from './effortWire.js';
 export * from './adapter/types.js';
 export * from './adapter/downstream/turnUsageToModelUsage.js';
 export * from './adapter/downstream/eventToSdkMessage.js';
-export type { WiringManifestView, WiringManifestSections } from './adapter/downstream/wiringManifestView.js';
+export type { WiringManifestView, WiringManifestSections, WiringManifestFleetView } from './adapter/downstream/wiringManifestView.js';
 export * from './adapter/downstream/terminalToSdkResult.js';
 export * from './adapter/runStream.js';
 export * from './adapter/activeRunSelfHeal.js';
 export * from './request/taskRequest.js';
-export { disableSkillsDeclaration } from './disableSkillsWire.js';
+export { disableSkillsDeclaration, disableSkillsDeclarationSettled } from './disableSkillsWire.js';
 export type { DisableSkillsDeclaration } from './disableSkillsWire.js';
-export { permissionsDeclaration } from './permissionsDeclaration.js';
-export type { PermissionsDeclaration, PermissionsDeclarationBuckets, PermissionsDeclarationInput, WireRuleOrigin, WireRuleOrigins } from './permissionsDeclaration.js';
+export { PERMISSIONS_KEPT_REASONS, permissionsDeclaration, permissionsDeclarationReport } from './permissionsDeclaration.js';
+export type { PermissionsDeclaration, PermissionsDeclarationBuckets, PermissionsDeclarationInput, PermissionsDeclarationReport, PermissionsKeptReason, PermissionsKeptRule, PermissionsRewrittenRule, PermissionsUncheckedRule, PermissionsUnreachableRule, WireRuleOrigin, WireRuleOrigins, } from './permissionsDeclaration.js';
 export * from './clientSlice.js';
 export * from './host.js';
+export { abortableSleep } from './abortableSleep.js';
 export { DEFAULT_SESSION_KEY } from './sessionSlot.js';
 export * from './scratchpadWireCaps.js';
 export * from './toolResult.js';
@@ -153,11 +161,19 @@ export * from './principalWire.js';
 export * from './wireErrorTriage.js';
 export * from './corruptSession.js';
 export * from './corruptSessionCopy.js';
-export { classifyToolHistoryMismatch, resolveToolHistoryRewindTarget } from './toolHistoryMismatch.js';
+export { classifyToolHistoryMismatch, readToolHistoryMismatchKey, resolveToolHistoryRewindTarget } from './toolHistoryMismatch.js';
+export type { ToolHistoryMismatchRowKey } from './toolHistoryMismatch.js';
+export { toolHistoryBadTurnSentence } from './toolHistoryBadTurn.js';
 export { classifyRegistryConflict, isScopeGoneError } from './registryConflict.js';
 export type { RegistryConflictClass } from './registryConflict.js';
 export { createPromptDeliveryLedger, promptKnownUndelivered, withoutUndeliveredPrompts } from './promptDelivery.js';
 export type { PromptDeliveryLedger, PromptDeliveryRecord } from './promptDelivery.js';
+export { mintUserAttachmentEnvelope } from './userAttachmentEnvelope.js';
+export type { UserAttachmentDescriptor, UserAttachmentNotebookCell } from './userAttachmentEnvelope.js';
+export { encodeHumanTurn, deliveredUuidsOf } from './humanTurn.js';
+export type { HumanTurnInput, HumanTurnItem, HumanTurnAttachment, HumanTurnRider, HumanTurnMissing, HumanTurnCaps, HumanTurnEncoding, HumanTurnShare, HumanTurnSharePart, HumanTurnDegraded, HumanTurnDelivered, } from './humanTurn.js';
+export { noteEngineCapsForAttachmentSeat, observedAttachmentSeat, forgetAttachmentSeatReading, __resetAttachmentSeatReadingsForTests, } from './attachmentSeatCapability.js';
+export type { AttachmentSeatReading } from './attachmentSeatCapability.js';
 export * from './resumeRefusalCopy.js';
 export * from './wireRefusalCopy.js';
 export * from './inheritEnvWire.js';
@@ -171,6 +187,11 @@ export * from './workflowClient.js';
 export * from './hooksWireCaps.js';
 export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS, PLUGIN_HOOK_EXCLUSION_REASONS, SETTINGS_HOOK_DROP_REASONS, isEngineFiredHookEvent, pluginHookVerdictOf, pluginHookReasonText, settingsHookDropText, pluginHookExecutorLabel, hooksNotRunNotice, settingsHooksKeptLocally, type EngineFiredHookEvent, type PluginHookDisposition, type PluginHookReason, type PluginHookExclusionReason, type SettingsHookDropReason, type HookSettingsSource, type PluginHookKey, type PluginHookVerdict, type PluginHookExclusion, type SettingsHookDrop, type SettingsHookVerdict, type SettingsHookExclusion, type HooksWireEngineFacts, type PluginHookReaderState, type HooksWirePlan, type HooksWirePlanOptions, } from './pluginHooksWire.js';
 export { hookToolAliasesOf, canonicalHookToolName } from './hookToolAliases.js';
+export { hookMatcherVerdict } from './hookMatcherVerdict.js';
+export type { HookMatcherVerdict, HookMatcherUnjudgedReason } from './hookMatcherVerdict.js';
+export { ASK_EVIDENCE_ABSENCE_VALUES, SYSTEM_INJECTION_PRIORITIES } from './engineClosedSets.js';
+export { READ_DENY_BUILTIN_TIERS, READ_DENY_DEFAULT_TIERS, parseReadDenyBuiltinTiers, type ReadDenyBuiltinTiersParse } from './readDenyTiers.js';
+export { MODE_ARBITRATION, askSurvivesStandingAnswer, type StandingAnswerVerdict } from './askSurvivesStandingAnswer.js';
 export * from './liveInitToolFace.js';
 export * from './printInitToolFace.js';
 export * from './model/providerPresets.js';
@@ -180,7 +201,7 @@ export * from './hitl/suspendedReopen.js';
 export * from './hitl/approvalOutcomeNote.js';
 export * from './hitl/approvalResolution.js';
 export { toolEndOutputText, ENGINE_ABORT_TOOL_RESULT } from './hitl/frameRouter.js';
-export { _resetHitlHostSurfaceForTest, CANCEL_DENY_BUDGET_MS, CANCEL_DENY_WARN_TEXT, EDIT_NOT_FORWARDED_WARN_TEXT, EDIT_REFUSED_ON_BLIND_ASK_WARN_TEXT, hitlHostSurfaceFor, hitlHostSurfaceMisses, hitlHostSurfaceMissesFor, installHitlHostSurface, installHitlHostSurfaceFor, observeCancelByDeny, REMEMBER_NOT_APPLIED_WARN_TEXT, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
+export { _resetHitlHostSurfaceForTest, CANCEL_DENY_BUDGET_MS, CANCEL_DENY_WARN_TEXT, EDIT_NOT_FORWARDED_WARN_TEXT, EDIT_REFUSED_ON_BLIND_ASK_WARN_TEXT, hitlHostSurfaceFor, hitlHostSurfaceMisses, hitlHostSurfaceMissesFor, installHitlHostSurface, installHitlHostSurfaceFor, observeCancelByDeny, REMEMBER_NOT_APPLIED_WARN_TEXT, REPLAYED_APPROVAL_LIST_UNREADABLE_WARN_TEXT, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
 export type { ClassifierDenyContext, HitlHostSurface, HitlNotice, } from './hitl/hitlHostSurface.js';
 export * from './hitl/toolApprovalWire.js';
 export * from './hitl/editedRuleTextPrecheck.js';
@@ -200,8 +221,14 @@ export * from './hitl/sessionPolicyWire.js';
 export * from './hitl/sessionPolicyDeliverable.js';
 export * from './hitl/approvalsFeed.js';
 export * from './hitl/livePendingAsk.js';
+export { replayedApprovalDisposition } from './hitl/replayedApproval.js';
+export type { ReplayedApprovalDisposition, ReplayPendingBasis } from './hitl/replayedApproval.js';
 export * from './hitl/askSurvivesPosture.js';
-export * from './hitl/crashConverged.js';
+export { automaticAnswerVerdict, type AutomaticAnswerLane, type AutomaticAnswerFacts, type AutomaticAnswerRoad, type AutomaticAnswerUnknownWhy, type AutomaticAnswerVerdict, } from './hitl/automaticAnswerVerdict.js';
+export { readApprovalAllowRuleShadow, approvalAllowRuleShadowed, type ApprovalAllowRuleShadow, type ApprovalAllowRuleShadowMember, type AllowRuleShadowedWireMember, } from './hitl/allowRuleShadow.js';
+export { projectCrashConverged } from './hitl/crashConverged.js';
+export type { ApprovalsListEnvelope, CrashConvergedOrphanState, CrashConvergedProjection, CrashConvergedRow } from './hitl/crashConverged.js';
+export * from './hitl/crashConvergedNotice.js';
 export * from './interactiveHalt.js';
 export * from './compensations.js';
 export * from './request/printNotification.js';

package/dist/index.js

@@ -26,7 +26,7 @@ export * from './executionLaneCapability.js';
 export * from './approvalsStreamLiveCapability.js';
 export * from './peerLaneCapability.js';
 export * from './permissionRulesWriteCapability.js';
-export * from './permissionsAllowGrantCapability.js';
+export { __resetPermissionsAllowGrantReadingsForTests, forgetPermissionsAllowGrantReading, noteEngineCapsForPermissionsAllowGrant, observedPermissionsAllowGrant, permissionsAllowGrantAvailable, permissionsAllowGrantDoctorDetail, projectPermissionsAllowGrantCapability, } from './permissionsAllowGrantCapability.js';
 export * from './sessionPolicyCapability.js';
 export * from './memoryComplianceCapability.js';
 export * from './memoryOriginCapability.js';
@@ -44,6 +44,11 @@ export * from './mcpPanel.js';
 export * from './mcpLiveness.js';
 export * from './mcpEngineLeg.js';
 export * from './mcpProbeCapability.js';
+export * from './sessionSyncFileHistoryCapability.js';
+export * from './workflowsJournalCapability.js';
+export * from './userInvokedSkillsCapability.js';
+export * from './skillToolListsCapability.js';
+export * from './steerPriorityCapability.js';
 export * from './mcpProbeWire.js';
 export * from './effectiveFacts.js';
 export * from './gateOutcome.js';
@@ -61,13 +66,14 @@ export * from './fleetTaskDesc.js';
 export { displayUntrusted, displayUntrustedMarks } from './displayUntrusted.js';
 export * from './hostEnv.js';
 export * from './unrefTimer.js';
-export { ControlRouter, ControlSafetyError, errCodes, } from './controlRouter.js';
+export { ControlRouter, ControlSafetyError, errCodes, steerBodyOf, steerRefusalAdviceOf, steeringRefusedBeforeEngine, } from './controlRouter.js';
+export { readSteerReceipt } from './steerReceipt.js';
 export * from './sseIdleTriage.js';
 export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
 export { stripSystemReminderBlocks, unwrapSystemReminder } from './systemReminderTag.js';
 export { findSystemReminderOpenTag } from './systemReminderTag.js';
-export { ACTIVE_RUN_BUSY_ERROR_CODE, asModelFallbackReason, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_LEGACY_TOOL_NAME, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_REFUSAL_CODES, CONFIG_STRATEGY_FIND_LIMIT_INVALID, CONFIG_STRATEGY_MAX_SIZE_INVALID, CORRUPT_SESSION_ERROR_CODE, DECIDE_CLAIM_LOST, DECIDE_GATE_MOVED, DECIDE_NOT_PARKED, DECIDE_PARK_MOVED_CODES, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, FLEET_LEASE_UNAVAILABLE, GATE_PARKED_ERROR_CODE, isConfigRefusalCode, isCorruptSessionCode, isDecideParkMovedCode, isDelegationCapCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isRulesRefusalCode, isStatusDerivedCoarseCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, OUTPUT_INVALID, PARKED_RESUME_STARTUP_FAILED, RESUME_AT_ERROR_CODE_PREFIX, RESUME_CONTEXT_UNAVAILABLE, RESUME_ENV_FAILED, RESUME_PLACEMENT_MISMATCH, RESUME_POLICY_FOLD_CODE, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_RETRY_LATER_CODES, RESUME_TOOL_CONTRACT_MISMATCH, RESUME_TOOL_UNAVAILABLE, RESUME_USAGE_WINDOW_EXHAUSTED, REWIND_ERROR_CODE_PREFIXES, RULES_LEGACY_TOOL_NAME, SCENARIO_NOT_ALLOWED_ERROR_CODE, STATUS_DERIVED_COARSE_CODES, STOP_CONFLICT_CODES, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
+export { ACTIVE_RUN_BUSY_ERROR_CODE, APPROVAL_EXPIRED, ASK_GONE, asModelFallbackReason, CAPABILITY_OPERATOR_PRINCIPALS_REQUIRED, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_IMAGE_INVALID, CONFIG_LEGACY_TOOL_NAME, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_REFUSAL_CODES, CONFIG_STRATEGY_FIND_LIMIT_INVALID, CONFIG_STRATEGY_MAX_SIZE_INVALID, CORRUPT_SESSION_ERROR_CODE, DECIDE_CLAIM_LOST, DECIDE_GATE_MOVED, DECIDE_NOT_PARKED, DECIDE_PARK_MOVED_CODES, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, FLEET_LEASE_UNAVAILABLE, GATE_PARKED_ERROR_CODE, imageInvalidFailureNoteOf, isConfigRefusalCode, isCorruptSessionCode, isDecideParkMovedCode, isDelegationCapCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isRulesRefusalCode, isStatusDerivedCoarseCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, operatorGateRefusalContent, OUTPUT_INVALID, PARKED_RESUME_STARTUP_FAILED, RESUME_AT_ERROR_CODE_PREFIX, RESUME_CONTEXT_UNAVAILABLE, RESUME_ENV_FAILED, RESUME_PLACEMENT_MISMATCH, RESUME_POLICY_FOLD_CODE, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_RETRY_LATER_CODES, RESUME_TOOL_CONTRACT_MISMATCH, RESUME_TOOL_UNAVAILABLE, RESUME_USAGE_WINDOW_EXHAUSTED, REWIND_ERROR_CODE_PREFIXES, RULES_LEGACY_TOOL_NAME, RUN_DEATH_VERDICT_CODES, RUN_ORPHANED, RUN_STALLED, runDeathVerdictNoteOf, SCENARIO_NOT_ALLOWED_ERROR_CODE, STATUS_DERIVED_COARSE_CODES, STOP_CONFLICT_CODES, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
 export * from './agentsWireCaps.js';
 export * from './attachmentsWireCaps.js';
 export * from './clientContextWireCaps.js';
@@ -105,10 +111,11 @@ export * from './adapter/downstream/terminalToSdkResult.js';
 export * from './adapter/runStream.js';
 export * from './adapter/activeRunSelfHeal.js';
 export * from './request/taskRequest.js';
-export { disableSkillsDeclaration } from './disableSkillsWire.js';
-export { permissionsDeclaration } from './permissionsDeclaration.js';
+export { disableSkillsDeclaration, disableSkillsDeclarationSettled } from './disableSkillsWire.js';
+export { PERMISSIONS_KEPT_REASONS, permissionsDeclaration, permissionsDeclarationReport } from './permissionsDeclaration.js';
 export * from './clientSlice.js';
 export * from './host.js';
+export { abortableSleep } from './abortableSleep.js';
 export { DEFAULT_SESSION_KEY } from './sessionSlot.js';
 export * from './scratchpadWireCaps.js';
 export * from './toolResult.js';
@@ -138,9 +145,13 @@ export * from './principalWire.js';
 export * from './wireErrorTriage.js';
 export * from './corruptSession.js';
 export * from './corruptSessionCopy.js';
-export { classifyToolHistoryMismatch, resolveToolHistoryRewindTarget } from './toolHistoryMismatch.js';
+export { classifyToolHistoryMismatch, readToolHistoryMismatchKey, resolveToolHistoryRewindTarget } from './toolHistoryMismatch.js';
+export { toolHistoryBadTurnSentence } from './toolHistoryBadTurn.js';
 export { classifyRegistryConflict, isScopeGoneError } from './registryConflict.js';
 export { createPromptDeliveryLedger, promptKnownUndelivered, withoutUndeliveredPrompts } from './promptDelivery.js';
+export { mintUserAttachmentEnvelope } from './userAttachmentEnvelope.js';
+export { encodeHumanTurn, deliveredUuidsOf } from './humanTurn.js';
+export { noteEngineCapsForAttachmentSeat, observedAttachmentSeat, forgetAttachmentSeatReading, __resetAttachmentSeatReadingsForTests, } from './attachmentSeatCapability.js';
 export * from './resumeRefusalCopy.js';
 export * from './wireRefusalCopy.js';
 export * from './inheritEnvWire.js';
@@ -153,6 +164,10 @@ export * from './workflowClient.js';
 export * from './hooksWireCaps.js';
 export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS, PLUGIN_HOOK_EXCLUSION_REASONS, SETTINGS_HOOK_DROP_REASONS, isEngineFiredHookEvent, pluginHookVerdictOf, pluginHookReasonText, settingsHookDropText, pluginHookExecutorLabel, hooksNotRunNotice, settingsHooksKeptLocally, } from './pluginHooksWire.js';
 export { hookToolAliasesOf, canonicalHookToolName } from './hookToolAliases.js';
+export { hookMatcherVerdict } from './hookMatcherVerdict.js';
+export { ASK_EVIDENCE_ABSENCE_VALUES, SYSTEM_INJECTION_PRIORITIES } from './engineClosedSets.js';
+export { READ_DENY_BUILTIN_TIERS, READ_DENY_DEFAULT_TIERS, parseReadDenyBuiltinTiers } from './readDenyTiers.js';
+export { MODE_ARBITRATION, askSurvivesStandingAnswer } from './askSurvivesStandingAnswer.js';
 export * from './liveInitToolFace.js';
 export * from './printInitToolFace.js';
 export * from './model/providerPresets.js';
@@ -161,7 +176,7 @@ export * from './hitl/suspendedReopen.js';
 export * from './hitl/approvalOutcomeNote.js';
 export * from './hitl/approvalResolution.js';
 export { toolEndOutputText, ENGINE_ABORT_TOOL_RESULT } from './hitl/frameRouter.js';
-export { _resetHitlHostSurfaceForTest, CANCEL_DENY_BUDGET_MS, CANCEL_DENY_WARN_TEXT, EDIT_NOT_FORWARDED_WARN_TEXT, EDIT_REFUSED_ON_BLIND_ASK_WARN_TEXT, hitlHostSurfaceFor, hitlHostSurfaceMisses, hitlHostSurfaceMissesFor, installHitlHostSurface, installHitlHostSurfaceFor, observeCancelByDeny, REMEMBER_NOT_APPLIED_WARN_TEXT, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
+export { _resetHitlHostSurfaceForTest, CANCEL_DENY_BUDGET_MS, CANCEL_DENY_WARN_TEXT, EDIT_NOT_FORWARDED_WARN_TEXT, EDIT_REFUSED_ON_BLIND_ASK_WARN_TEXT, hitlHostSurfaceFor, hitlHostSurfaceMisses, hitlHostSurfaceMissesFor, installHitlHostSurface, installHitlHostSurfaceFor, observeCancelByDeny, REMEMBER_NOT_APPLIED_WARN_TEXT, REPLAYED_APPROVAL_LIST_UNREADABLE_WARN_TEXT, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
 export * from './hitl/toolApprovalWire.js';
 export * from './hitl/editedRuleTextPrecheck.js';
 export * from './coreValuePorts.js';
@@ -180,8 +195,12 @@ export * from './hitl/sessionPolicyWire.js';
 export * from './hitl/sessionPolicyDeliverable.js';
 export * from './hitl/approvalsFeed.js';
 export * from './hitl/livePendingAsk.js';
+export { replayedApprovalDisposition } from './hitl/replayedApproval.js';
 export * from './hitl/askSurvivesPosture.js';
-export * from './hitl/crashConverged.js';
+export { automaticAnswerVerdict, } from './hitl/automaticAnswerVerdict.js';
+export { readApprovalAllowRuleShadow, approvalAllowRuleShadowed, } from './hitl/allowRuleShadow.js';
+export { projectCrashConverged } from './hitl/crashConverged.js';
+export * from './hitl/crashConvergedNotice.js';
 export * from './interactiveHalt.js';
 export * from './compensations.js';
 export * from './request/printNotification.js';

package/dist/inheritEnvWire.js

@@ -1,5 +1,6 @@
 import { INHERIT_ENV_WORDS, isInheritEnvWord } from './request/taskRequest.js';
 import { settingsPermissionBucketRefusalFromError } from './wireRefusalCopy.js';
+import { engineVersionTier } from './supportFloor.js';
 export const INHERIT_ENV_MIN_SERVER = Object.freeze([7, 106, 0]);
 export function inheritEnvServerSupport(version) {
     const mm = typeof version === 'string' ? /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.exec(version) : null;
@@ -21,11 +22,9 @@ export function inheritEnvDeclaration(word, serverVersion) {
     if (!isInheritEnvWord(word)) {
         throw new TypeError(`inheritEnvDeclaration: inheritEnv 只接受 ${INHERIT_ENV_WORDS.map((w) => `'${w}'`).join(' / ')} 或缺席 —— 收到 ${Array.isArray(word) ? 'typeof=object / array' : `typeof=${typeof word}`}。坏词在版本判定之前就拒:「这一次不发」不许顺手吞掉一个打错字的声明。错误文本只报形状,不回显值。`);
     }
-    const support = inheritEnvServerSupport(serverVersion);
-    if (support === 'supported')
+    if (engineVersionTier(serverVersion) !== 'unknown')
         return Object.freeze({ field: Object.freeze({ inheritEnv: word }) });
-    const cause = support === 'unsupported' ? 'server_too_old' : 'server_version_unknown';
-    return Object.freeze({ field: Object.freeze({}), withheld: Object.freeze({ cause, word }) });
+    return Object.freeze({ field: Object.freeze({}), withheld: Object.freeze({ cause: 'server_version_unknown', word }) });
 }
 const WITHHELD_NOTICES = Object.freeze({
     server_too_old: Object.freeze({
@@ -77,7 +76,7 @@ export function inheritEnvRefusalFromError(err, sentRequest) {
         return null;
     }
 }
-const REFUSAL_NOT_ACCEPTED = 'The engine refused this request as invalid without naming the field · ' +
+const REFUSAL_NOT_ACCEPTED = 'The engine refused this request as invalid, under a refusal code that many different request fields share · ' +
     "This request asked for the shell to inherit this machine's whole environment, which the engine accepts only when tools run directly on its own machine and the request belongs to a session; if that is what it refused, send it again without that setting (or with the default)";
 export function inheritEnvRefusalContent(_detail) {
     return REFUSAL_NOT_ACCEPTED;

package/dist/liveModelCatalog.d.ts

@@ -16,6 +16,8 @@ export declare function setLiveModelCatalogRefresher(fn: (() => Promise<LiveMode
 export declare function refreshLiveModelCatalog(): Promise<boolean>;
 export declare function getLiveModelCatalog(): LiveModelCatalog | null;
 export declare function normalizeLiveModelRef(ref: string): string;
+export type ImageVision = 'yes' | 'no' | 'unknown';
+export declare function imageVisionOf(model: string | undefined, catalog?: LiveModelCatalog | null): ImageVision;
 export declare function liveDefaultModelName(): string | null;
 export interface RoutePairingVerdict {
     verdict: 'ok' | 'broken' | 'unknown';