@sema-agent/client-core 0.97.1 → 0.99.0

package/dist/printModelStatus.js

@@ -0,0 +1,155 @@
+import { retryStatusFromArm, retryStatusNotice } from './retryStatus.js';
+import { guardedRead, readOwnDataFiniteNumber, readOwnDataNonEmptyString, readOwnDataValue } from './ownKey.js';
+export const PRINT_MODEL_STATUS_SUBTYPE = '_sema_model_status';
+export const PRINT_LAST_MODEL_STATUS_KEY = '_sema_last_model_status';
+function httpStatusOf(v) {
+    return typeof v === 'number' && Number.isInteger(v) && v > 0 && v <= 999 ? v : undefined;
+}
+function ccRetryErrorCategory(status) {
+    const code = httpStatusOf(status.errorStatus);
+    if (code === 529 || status.providerCondition === 'overloaded')
+        return 'overloaded';
+    if (code === 429)
+        return 'rate_limit';
+    if (code === 401 || code === 403)
+        return 'authentication_failed';
+    if (code !== undefined && code >= 408)
+        return 'server_error';
+    return 'unknown';
+}
+function modelStatusPayload(status, ctx) {
+    const code = httpStatusOf(status.errorStatus);
+    const terminal = 'terminal' in status && status.terminal === true;
+    const sane = (v) => (typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : undefined);
+    const count = (v) => (typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined);
+    const retryDelayMs = status.kind !== 'waiting' && !terminal ? sane(Math.max(0, status.deadline - ctx.nowMs)) : undefined;
+    const attempt = count(status.attempt);
+    const maxRetries = count(status.maxRetries);
+    const elapsed = sane(status.elapsedMs);
+    const ceiling = sane(status.timeoutMs);
+    const model = ctx.model !== undefined && ctx.model.length > 0 ? ctx.model : undefined;
+    const notice = retryStatusNotice(status, model !== undefined ? { modelName: model } : undefined);
+    return {
+        kind: status.kind,
+        ...(terminal ? { terminal: true } : {}),
+        ...(attempt !== undefined ? { attempt } : {}),
+        ...(maxRetries !== undefined ? { max_retries: maxRetries } : {}),
+        ...(retryDelayMs !== undefined ? { retry_delay_ms: retryDelayMs } : {}),
+        ...(code !== undefined ? { error_status: code } : {}),
+        ...(typeof status.providerCondition === 'string' ? { provider_condition: status.providerCondition } : {}),
+        ...(typeof status.errClass === 'string' ? { err_class: status.errClass } : {}),
+        ...(elapsed !== undefined ? { elapsed_ms: elapsed } : {}),
+        ...(ceiling !== undefined ? { timeout_ms: ceiling } : {}),
+        ...(model !== undefined ? { model } : {}),
+        phase: notice.phase,
+        ...(notice.recourse !== undefined ? { recourse: notice.recourse } : {}),
+        message: notice.line,
+    };
+}
+function apiRetryKeyOf(status) {
+    const terminal = 'terminal' in status && status.terminal === true;
+    const ok = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0;
+    if (status.kind === 'waiting' || terminal || !ok(status.attempt) || !ok(status.maxRetries))
+        return null;
+    return `${String(status.attempt)}/${String(status.maxRetries)}/${String(status.errClass ?? '')}/${String(status.errorStatus ?? '')}`;
+}
+function statusFrameOf(status, ctx, uuid, refresh) {
+    const payload = modelStatusPayload(status, ctx);
+    if (apiRetryKeyOf(status) !== null && !refresh) {
+        return {
+            type: 'system',
+            subtype: 'api_retry',
+            attempt: status.attempt ?? 0,
+            max_retries: status.maxRetries ?? 0,
+            retry_delay_ms: payload.retry_delay_ms ?? 0,
+            error_status: payload.error_status ?? null,
+            error: ccRetryErrorCategory(status),
+            ...(payload.provider_condition !== undefined ? { _sema_provider_condition: payload.provider_condition } : {}),
+            ...(payload.model !== undefined ? { _sema_model: payload.model } : {}),
+            _sema_message: payload.message,
+            uuid,
+            session_id: ctx.sessionId,
+        };
+    }
+    return { type: 'system', subtype: PRINT_MODEL_STATUS_SUBTYPE, _sema_model_status: { ...payload, ...(refresh ? { refresh: true } : {}) }, uuid, session_id: ctx.sessionId };
+}
+function isMainLaneArm(msg) {
+    const tri = (o, key) => {
+        try {
+            const d = Object.getOwnPropertyDescriptor(o, key);
+            if (d !== undefined && !('value' in d))
+                return { ok: false };
+            return { ok: true, v: readOwnDataValue(o, key) };
+        }
+        catch {
+            return { ok: false };
+        }
+    };
+    const top = tri(msg, 'parentToolCallId');
+    if (!top.ok)
+        return false;
+    const event = tri(msg, 'event');
+    if (!event.ok)
+        return false;
+    const nested = typeof event.v === 'object' && event.v !== null ? tri(event.v, 'parentToolCallId') : { ok: true, v: undefined };
+    if (!nested.ok)
+        return false;
+    return typeof top.v !== 'string' && typeof nested.v !== 'string';
+}
+export function createPrintModelStatusTracker() {
+    let last = null;
+    let lastApiRetryKey = null;
+    const clear = () => {
+        last = null;
+        lastApiRetryKey = null;
+    };
+    return {
+        take(msg, ctx) {
+            try {
+                const type = guardedRead(() => readOwnDataValue(msg, 'type'));
+                if (type === 'stream_event' || type === 'tool_end_result') {
+                    if (msg !== null && msg !== undefined && isMainLaneArm(msg))
+                        clear();
+                    return null;
+                }
+                if (type !== 'retry_status')
+                    return null;
+                const sessionId = readOwnDataNonEmptyString(ctx, 'sessionId');
+                const mintUuid = readOwnDataValue(ctx, 'mintUuid');
+                const nowMs = readOwnDataFiniteNumber(ctx, 'nowMs');
+                if (sessionId === undefined || typeof mintUuid !== 'function' || nowMs === undefined)
+                    return null;
+                const status = retryStatusFromArm(msg, nowMs);
+                if (status === undefined)
+                    return null;
+                if (status === null) {
+                    clear();
+                    return null;
+                }
+                const model = readOwnDataNonEmptyString(ctx, 'model');
+                const key = apiRetryKeyOf(status);
+                const refresh = key !== null && key === lastApiRetryKey;
+                const safeCtx = { sessionId, nowMs, mintUuid, ...(model !== undefined ? { model } : {}) };
+                const frame = statusFrameOf(status, safeCtx, mintUuid(), refresh);
+                lastApiRetryKey = key;
+                last = { status, model };
+                return frame;
+            }
+            catch {
+                return null;
+            }
+        },
+        beginTurn: clear,
+        resultFields(nowMs) {
+            try {
+                if (last === null)
+                    return {};
+                const now = typeof nowMs === 'number' && Number.isFinite(nowMs) ? nowMs : 0;
+                return { _sema_last_model_status: modelStatusPayload(last.status, { ...(last.model !== undefined ? { model: last.model } : {}), nowMs: now }) };
+            }
+            catch {
+                return {};
+            }
+        },
+    };
+}

package/dist/printToolResultFrame.js

@@ -1,11 +1,19 @@
 import { isCcToolDenialKind } from './gateVocabulary.js';
 export { flattenWireOutput as flattenToolOutput } from './adapt/wireShapes.js';
 import { flattenWireOutput } from './adapt/wireShapes.js';
-import { toolResultEnvelopeParts, toolResultOutcomeOf } from './adapt/toolCards.js';
-import { readFrameTrueMark } from './ownKey.js';
+import { toolResultEnvelopeParts, toolResultOutcomeOf, toolResultRowFlagParts, toolResultRowIdentity } from './adapt/toolCards.js';
+import { engineRefOf } from './engineRowRef.js';
+import { guardedRead } from './ownKey.js';
+import { gateOutcomeOf } from './gateOutcome.js';
+import { isUnsettledHeldToolEnd } from './engineRowRef.js';
 export function toolEndResultToUserFrame(arm) {
     if (typeof arm.toolCallId !== 'string' || arm.toolCallId.length === 0)
         return null;
+    if (isUnsettledHeldToolEnd(arm))
+        return null;
+    const armEventId = arm.eventId;
+    const callId = arm.toolCallId;
+    const rowIdentity = toolResultRowIdentity([{ eventId: typeof armEventId === 'string' ? armEventId : undefined, engineRef: engineRefOf(arm) }], callId, { uuid: () => callId });
     const text = flattenWireOutput(arm.output);
     const parent = typeof arm.parentToolCallId === 'string' ? arm.parentToolCallId : null;
     const outcome = toolResultOutcomeOf(typeof arm.toolName === 'string' ? arm.toolName : '', {
@@ -15,6 +23,7 @@ export function toolEndResultToUserFrame(arm) {
         isError: arm.isError === true,
     }, undefined, parent === null ? 'leader' : 'subagent');
     const envelope = toolResultEnvelopeParts(outcome);
+    const gateView = guardedRead(() => gateOutcomeOf(arm));
     const content = Array.isArray(outcome.body.content) ? outcome.body.content : arm.truncated === true ? `${text}\n…(truncated)` : text;
     return {
         type: 'user',
@@ -31,10 +40,12 @@ export function toolEndResultToUserFrame(arm) {
         },
         parent_tool_use_id: parent,
         ...(isCcToolDenialKind(arm._sema_denial_kind) ? { _sema_denial_kind: arm._sema_denial_kind } : {}),
-        ...(readFrameTrueMark(arm, 'notExecuted') ? { _sema_not_executed: true } : {}),
+        ...(gateView !== undefined ? { _sema_gate: gateView } : {}),
+        ...toolResultRowFlagParts(arm),
         ...(Object.hasOwn(envelope, 'tool_use_result') ? { tool_use_result: envelope.tool_use_result } : {}),
         ...(Object.hasOwn(envelope, '_sema_degraded') ? { _sema_degraded: envelope._sema_degraded } : {}),
-        uuid: arm.uuid,
+        uuid: rowIdentity.uuid,
         session_id: arm.session_id,
+        ...(rowIdentity.engineRef !== undefined ? { _sema_engine_ref: rowIdentity.engineRef } : {}),
     };
 }

package/dist/replayBody.d.ts

@@ -10,3 +10,6 @@ export interface DoneResultView {
     readonly row?: ReplayRowView;
 }
 export declare function doneResultView(result: unknown): DoneResultView;
+export declare function isReplayedTerminal(frame: object | null | undefined): boolean;
+export declare function isReplayMarked(message: object | null | undefined): boolean;
+export declare const RESULT_REPLAYED_TEXT = "No new run was started: this request's idempotency key matched an earlier submission.";

package/dist/replayBody.js

@@ -1,3 +1,4 @@
+import { readFrameTrueMark } from './ownKey.js';
 function guarded(o, k) {
     try {
         return o[k];
@@ -23,3 +24,16 @@ export function doneResultView(result) {
     }
     return { replay: true, engine: guarded(result, 'result'), row };
 }
+export function isReplayedTerminal(frame) {
+    if (frame === null || typeof frame !== 'object' || Array.isArray(frame))
+        return false;
+    if (guarded(frame, 'type') !== 'done')
+        return false;
+    if (readFrameTrueMark(frame, 'replay'))
+        return true;
+    return doneResultView(guarded(frame, 'result')).replay;
+}
+export function isReplayMarked(message) {
+    return readFrameTrueMark(message, '_sema_replay');
+}
+export const RESULT_REPLAYED_TEXT = "No new run was started: this request's idempotency key matched an earlier submission.";

package/dist/request/taskRequest.d.ts

@@ -1,6 +1,7 @@
-import type { TaskRequest } from '@sema-agent/sdk';
+import type { TaskRequest, UserAttachment } from '@sema-agent/sdk';
 import { type OutputStyleSeatReading } from '../outputStyleSeatCapability.js';
 import { type ApprovalReachWord } from '../approvalReachWire.js';
+import { type HostTurnSettings, type HostTurnSettingsInput } from '../hostTurnSettings.js';
 export type RequestLane = 'interactive' | 'print' | 'utility';
 export type TaskRequestLike = Record<string, unknown>;
 export interface RequestFieldSpec {
@@ -22,7 +23,9 @@ export interface TaskRequestInput {
     reasoningEffort?: string;
     model?: string;
     images?: readonly unknown[];
+    userAttachments?: readonly UserAttachment[];
     skills?: unknown;
+    userInvokedSkills?: readonly string[];
     mcpServers?: unknown;
     clientContext?: Record<string, unknown>;
     scratchpadDir?: string;
@@ -58,12 +61,13 @@ export interface TaskRequestInput {
     disableSkills?: TaskRequest['disableSkills'];
     rewind?: Record<string, unknown>;
     repo?: string;
+    hostSettings: HostTurnSettings;
     settings?: {
-        resolved?: Record<string, unknown>;
-        webSearch?: Record<string, unknown>;
+        resolved?: never;
+        webSearch?: never;
         ultracode?: boolean;
-        hooks?: Record<string, unknown>;
-        outputStyle?: string;
+        hooks?: never;
+        outputStyle?: never;
     };
 }
 export declare const TASK_REQUEST_OMISSION_CAUSES: readonly ["upstream_absent", "other_channel", "off_lane", "not_live"];
@@ -75,10 +79,10 @@ export interface TaskRequestOmission {
 export declare function taskRequestOmissionCauseDetail(cause: unknown): string;
 export declare const TASK_REQUEST_OMISSION_CAUSE_NOTICES: Readonly<Record<TaskRequestOmissionCause, string>>;
 export declare function taskRequestOmissionCauseNotice(cause: unknown): string;
-export declare function taskRequestOmissionCausePhrase(cause: unknown): string;
 export interface TaskRequestAssembly {
     readonly request: TaskRequestLike;
     readonly omitted: readonly TaskRequestOmission[];
+    readonly host: HostTurnSettings;
 }
 export type TaskRequestSeatReading = {
     readonly seat: 'seated';
@@ -96,6 +100,7 @@ export interface UpstreamAbsentRequestIntent {
 export declare const UPSTREAM_ABSENT_REQUEST_INTENTS: readonly UpstreamAbsentRequestIntent[];
 export declare const REQUEST_LANES: readonly RequestLane[];
 export declare function taskRequestSeatOf(key: string, lane: RequestLane): TaskRequestSeatReading;
+export declare function hostTurnSettings(input: HostTurnSettingsInput): HostTurnSettings;
 export declare const MEMORY_CAPTURE_OFF: "off";
 export declare function memoryCaptureDeclarationField(declared: boolean): {
     memoryCapture: 'off';

package/dist/request/taskRequest.js

@@ -1,8 +1,10 @@
 import { refuseBadDisableSkills, refuseDisableSkillsConflict } from '../disableSkillsWire.js';
 import { ATTACHMENTS_SPEC_KEYS, AttachmentsSpecRefused } from '../attachmentsWireCaps.js';
 import { retiredAttachmentsKeyOf } from '../taskRequestWords.js';
+import { msg, renderMessage } from '../i18n/translate.js';
 import { outputStyleSeatAdmitted } from '../outputStyleSeatCapability.js';
 import { refuseBadApprovalReach } from '../approvalReachWire.js';
+import { HOST_SUPPLIED_KEYS, HostSettingsRefused, buildHostTurnSettings, hostTurnSettingsOf, rethrowHostResolvedDeferred, } from '../hostTurnSettings.js';
 export const REQUEST_FIELD_MATRIX = [
     { field: 'objective', lanes: ['interactive', 'print', 'utility'], live: false, why: '本 turn 的真实输入,每条车道都必需', whyUtilityLane: '恒座:三条车道都必须带上本次提交的模型面输入' },
     { field: 'sessionId', lanes: ['interactive', 'print', 'utility'], live: false, why: '单命名空间(TP-A Step 2):壳 id 即引擎 session id;print 在非 live 下保留 mock 常量', whyUtilityLane: '恒座:side-channel 提交走**独立**会话 id(壳另铸一个,绝不复用用户会话那一个 —— 复用会把这次提交的转录混进用户会话)' },
@@ -16,6 +18,7 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'enableFork', lanes: ['interactive', 'print'], live: true, why: '显式布尔才 stamp([503]② fail-OPEN 教训:off 必须显式)', whyUtilityLane: '无座:分叉是会话面的动作,而 side-channel 提交是一次性的独立会话' },
     { field: 'attachments', lanes: ['interactive', 'print'], live: true, why: 'design/133 + G1 缺省开的 turn 边界 attachment', whyUtilityLane: '无座:turn 边界的附件配置属用户会话;side-channel 提交不带附件' },
     { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地技能目录投影(布局取 CC 同款);两条车道都由 launchRepl 载入面注入', whyUtilityLane: '无座:技能挂的是工具,与零工具面矛盾' },
+    { field: 'userInvokedSkills', lanes: ['interactive', 'print'], live: true, why: '人用名字点过的技能(sdk `TaskRequest.userInvokedSkills`:非空串数组;这些技能的 allowedTools / disallowedTools 开跑即生效、不出技能卡,只管这一次 run)。两条用户车道都有「人敲 /技能名」的入口 ⇒ 都有座。🔴 放宽方向:值只经片段口给(能力读数 present 才给键);空数组 = 没点名 ⇒ 不 stamp;坏形(不是串数组)装配期响亮拒;名字对不对归引擎判(`config.user_invoked_skill_unknown`)', whyUtilityLane: '无座:技能挂的是工具,与零工具面矛盾(与 skills 一行同理)' },
     { field: 'mcpServers', lanes: ['interactive', 'print'], live: true, why: '本地 .mcp.json 投影;service 单用户门决定是否兑现', whyUtilityLane: '无座:MCP 服务挂的是工具,与零工具面矛盾' },
     { field: 'settings.webSearch', lanes: ['interactive', 'print'], live: true, why: 'SEMA_WEBSEARCH_* / settings.json;per-request 配置赢过部署 env', whyUtilityLane: '无座:联网检索是一只工具,与零工具面矛盾' },
     { field: 'settings.hooks', lanes: ['interactive', 'print'], live: true, why: '[495]① 用户 settings 文件 hooks 逐字上 wire', whyUtilityLane: '无座:hook 挂在工具门上(零工具面没有门),而且 side-channel 是壳自己的提交,不该继承用户那份 hook 表' },
@@ -44,6 +47,7 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'reasoningEffort', lanes: ['interactive', 'print', 'utility'], live: false, why: '思考档位(sdk `TaskRequest.reasoningEffort` 七词闭集;上游对表外词 400 响亮拒 ⇒ 本层不预铸第二判官)。档位是请求级的位、与车道无关:交互面 = `/effort` 拨盘,无人值守面 = 档位旗。🔴 端交的必须是**档位词**:「思考 token 数」今天没有上游对位(见 `UPSTREAM_ABSENT_REQUEST_INTENTS` 的 `maxThinkingTokens`),别把一个数字折成档位词发出去', whyUtilityLane: '有座:side-channel 该用显式低档(省钱省时);与 model 同一条理由 —— 本车道上这两位都由壳显式给,不跟用户会话的拨盘走' },
     { field: 'model', lanes: ['interactive', 'print', 'utility'], live: false, why: '模型选择(sdk `TaskRequest.model`;交互面 = `/model` 中途换模型的拨盘,无人值守面 = 模型旗 / 部署缺省那一路,side-channel 面 = 壳显式挑的那一只)。三条车道都有来源、都是提交面。🔴 0.79.0 改口:修前「print 的模型走另一条路」这句理由被用户面实测证伪 —— 无人值守车道传了模型名却整键不上请求体,于是同一个坏名字在交互态被引擎 400 点名、在无人值守态却安静换成部署缺省并在首帧回显一个没生效的名字。一个**选择**类声明被静默丢掉,后果与收紧类声明被静默丢掉同形(端不读回执就以为生效)—— 与 `excludeTools` 补 print 座同律。本层原样透传、不预判模型名(名字的合法性归引擎,本层不铸第二判官)', whyUtilityLane: '有座:side-channel 显式挑便宜的那只模型(不跟用户会话的 `/model` 拨盘走)' },
     { field: 'images', lanes: ['interactive', 'print'], live: false, why: '图片输入(sdk `TaskRequest.images`;base64 / url 两形,原样透传)。两条用户车道都是提交面、都有来源:交互面 = 粘贴图与 `@` 图片像素,一次性车道 = 结构化输入里的图片块。张数、单张与合计的座位判定归人类提交装配口 `encodeHumanTurn`(两条车道同一份判定,本表不另判);请求体与图片张数的上限归上游判', whyUtilityLane: '无座:贴图是交互动作,side-channel 的提交体里没有图片块' },
+    { field: 'userAttachments', lanes: ['interactive', 'print'], live: false, why: '请求层附件(sdk `TaskRequest.userAttachments`:挂在这次提交目标上的 `@` 文本类附件条目,引擎铸帧、在第一次模型调用之前判形)。两条用户车道都是提交面、都经同一只装配口 `encodeHumanTurn`(条目只在这台引擎的席位读数判 `yes` 时出;老服务端对这一键 400,所以没有条目就不发);空数组 = 没带附件 ⇒ 整键不 stamp。座位集与 `images` 一行逐字相同', whyUtilityLane: '无座:side-channel 是壳自己的一次性提交,没有用户 `@` 附件' },
     { field: 'resumeAt/resumeAtMode/restoreFiles/rewindFilesTo', lanes: ['interactive'], live: false, why: 'E18 `/rewind` 是交互命令;四键同生同灭(CC-145:core 6.0.0 起 both 臂发 restoreFiles;CC-223 起退役键 rewindFiles 不再有座 —— 交它按表外子键响亮拒;resumeAtMode 是 both/conversation 两臂恒带的排他截语义位)', whyUtilityLane: '无座:回退是交互命令,而 side-channel 是一次性的独立会话,没有可回退的历史' },
     { field: 'clientContext', lanes: ['interactive'], live: false, why: 'IANA 时区 + 可选邮箱 → core 本地化 `# Environment` 的 today;print 同样跑在用户机器上,缺席让引擎误标 (UTC)', gap: true, whyUtilityLane: '无座:本地化 today 的用途在用户会话的环境段,而 side-channel 的系统提示由壳整段给出 —— 这一列我判不准要不要(与本行 `gap` 同一条待办:要补先单独立项)' },
     { field: 'scratchpadDir', lanes: ['interactive'], live: true, why: '[816]③ per-session 暂存目录;print 也有 session,缺席让 `-p` 的工具写不进 exemptDir', gap: true, whyUtilityLane: '无座:per-session 暂存目录是给**工具**写的,零工具面上没人写' },
@@ -112,9 +116,6 @@ export function taskRequestOmissionCauseNotice(cause) {
         ? TASK_REQUEST_OMISSION_CAUSE_NOTICES[cause]
         : TASK_REQUEST_OMISSION_UNKNOWN_CAUSE_NOTICE;
 }
-export function taskRequestOmissionCausePhrase(cause) {
-    return omissionNoticePartsOf(cause)?.reason ?? TASK_REQUEST_OMISSION_UNKNOWN_CAUSE_REASON;
-}
 const row = (field) => ({ via: 'matrix', field });
 const INPUT_KEY_ROUTES = {
     objective: { via: 'always' },
@@ -125,7 +126,9 @@ const INPUT_KEY_ROUTES = {
     reasoningEffort: row('reasoningEffort'),
     model: row('model'),
     images: row('images'),
+    userAttachments: row('userAttachments'),
     skills: row('skills'),
+    userInvokedSkills: row('userInvokedSkills'),
     mcpServers: row('mcpServers'),
     clientContext: row('clientContext'),
     scratchpadDir: row('scratchpadDir'),
@@ -173,8 +176,12 @@ const INPUT_KEY_ROUTES = {
     rewind: row('resumeAt/resumeAtMode/restoreFiles/rewindFilesTo'),
     repo: row('repo'),
     allowTools: row('allowTools'),
+    hostSettings: { via: 'control' },
     settings: { via: 'settings' },
 };
+const HOST_SETTINGS_SUBKEYS = Object.freeze(HOST_SUPPLIED_KEYS.filter((k) => k.startsWith('settings.')).map((k) => k.slice('settings.'.length)));
+const _hostSubkeysPin = [true, true, true, true];
+void _hostSubkeysPin;
 const SETTINGS_KEY_ROUTES = {
     resolved: row('settings.<resolved>'),
     webSearch: row('settings.webSearch'),
@@ -214,6 +221,35 @@ const OMISSION_JUDGES = {
     not_live: (s, _lane, live) => s.via === 'matrix' && s.spec.live && !live,
 };
 const omissionCauseOf = (s, lane, live) => TASK_REQUEST_OMISSION_CAUSES.find(cause => OMISSION_JUDGES[cause](s, lane, live));
+const hostRefusalNoticeOf = (host, lane, live, verdictNotice) => {
+    try {
+        const refusing = host.rows.filter((row) => row.disposition === 'refuse_turn');
+        if (refusing.length === 0)
+            return verdictNotice;
+        const turnNotices = host.notices.filter((n) => n.plane === 'turn');
+        const aligned = turnNotices.length === refusing.length;
+        for (const [i, row] of refusing.entries()) {
+            if (!hostRefuseRowSeated(row.key, lane, live))
+                continue;
+            return aligned ? (turnNotices[i] ?? verdictNotice) : verdictNotice;
+        }
+        return undefined;
+    }
+    catch {
+        return verdictNotice;
+    }
+};
+const hostRefuseRowSeated = (key, lane, live) => {
+    const sub = key.slice('settings.'.length);
+    if (!hasOwn(SETTINGS_KEY_ROUTES, sub))
+        return true;
+    const route = SETTINGS_KEY_ROUTES[sub];
+    if (route === undefined || route.via === 'always')
+        return true;
+    if (route.via === 'matrix' || route.via === 'fixed')
+        return omissionCauseOf(standingOf(route), lane, live) === undefined;
+    return true;
+};
 const REQUEST_LANE_SET = { interactive: true, print: true, utility: true };
 export const REQUEST_LANES = Object.freeze(Object.keys(REQUEST_LANE_SET));
 const refuseBadLane = (lane) => {
@@ -231,6 +267,8 @@ const VALUE_LEVEL_IN_PLAY = Object.freeze({
     oneShot: (v) => v === true,
     interactiveTools: (v) => v === false,
     images: (v) => Array.isArray(v) && v.length > 0,
+    userAttachments: (v) => Array.isArray(v) && v.length > 0,
+    userInvokedSkills: (v) => Array.isArray(v) && v.length > 0,
     attachmentIds: (v) => Array.isArray(v) && v.length > 0,
     excludeTools: (v) => Array.isArray(v) && v.length > 0,
     excludeAllTools: (v) => v === true,
@@ -405,6 +443,9 @@ const resolvedSnapshotForWire = (resolved) => {
     }
     return out;
 };
+export function hostTurnSettings(input) {
+    return buildHostTurnSettings(input, (snapshot) => resolvedSnapshotForWire(snapshot));
+}
 export const MEMORY_CAPTURE_OFF = 'off';
 export function memoryCaptureDeclarationField(declared) {
     return declared ? { memoryCapture: MEMORY_CAPTURE_OFF } : {};
@@ -430,11 +471,11 @@ export function memoryOffDeclared(input) {
     const sm = input.settingsMemory;
     if (sm !== undefined && sm !== null) {
         if (typeof sm !== 'object' || Array.isArray(sm)) {
-            throw new TypeError(`memoryOffDeclared: settings 的 memory 段必须是对象 —— 收到 ${coarseShape(sm)}。`);
+            throw new TypeError(renderMessage(msg('config.taskRequest.memoryOff.settingsSectionNotObject', { shape: coarseShape(sm) })));
         }
         const enabled = sm.enabled;
         if (enabled !== undefined && typeof enabled !== 'boolean') {
-            throw new TypeError(`memoryOffDeclared: settings memory.enabled 在场时必须是布尔 —— 收到 ${coarseShape(enabled)}。`);
+            throw new TypeError(renderMessage(msg('config.taskRequest.memoryOff.enabledNotBoolean', { shape: coarseShape(enabled) })));
         }
         fromSettings = enabled === false;
     }
@@ -533,6 +574,23 @@ const refuseBadAllowTools = (v) => {
         `收到 ${coarseShape(v)}。这一位是**可用性选择器**(收紧声明):本层若把坏形静默删键,这一次运行会挂上声明人以为已经收窄掉的全部工具。` +
         '错误文本只报形状,不回显值。');
 };
+const refuseBadUserInvokedSkills = (v) => {
+    if (v === undefined || v === null)
+        return;
+    if (Array.isArray(v) && v.length <= ALLOW_TOOLS_MAX_LENGTH) {
+        let ok = true;
+        for (let k = 0; k < v.length; k += 1) {
+            const d = Object.getOwnPropertyDescriptor(v, k);
+            if (d === undefined || !('value' in d) || typeof d.value !== 'string') {
+                ok = false;
+                break;
+            }
+        }
+        if (ok)
+            return;
+    }
+    throw new TypeError(renderMessage(msg('config.taskRequest.userInvokedSkillsMalformed', { shape: coarseShape(v) })));
+};
 const refuseBadExcludeAllTools = (v) => {
     if (v === undefined || v === null || v === true || v === false)
         return;
@@ -566,13 +624,16 @@ const refuseBadRequireExistingSession = (v) => {
         '上游对非布尔值同样拒收。错误文本只报形状,不回显值。');
 };
 const hasResumableSessionId = (sid) => typeof sid === 'string' && sid.length > 0;
-const refuseRequireExistingWithoutSession = (requireExisting, sessionId) => {
+const refuseRequireExistingWithoutSession = (requireExisting, sessionId, where = 'buildTaskRequest') => {
     if (requireExisting !== true || hasResumableSessionId(sessionId))
         return;
-    const shape = sessionId === undefined ? '缺席' : typeof sessionId === 'string' ? '空串' : coarseShape(sessionId);
-    throw new TypeError(`buildTaskRequest: requireExistingSession: true 要求续一个已存在的会话,但 sessionId ${shape} —— 没有可续的会话。` +
-        '上游对这一形同样拒收(不会新开会话,也不会续上任何东西);本层在装配前拒,不让它走一次往返。' +
-        '处置:要续哪个会话,就把它的 id 交在 sessionId 上;要开新会话,就别带 requireExistingSession(或给 false)。错误文本只报形状,不回显值。');
+    const shape = sessionId === undefined
+        ? renderMessage(msg('config.taskRequest.requireExisting.shapeAbsent'))
+        : typeof sessionId === 'string'
+            ? renderMessage(msg('config.taskRequest.requireExisting.shapeEmpty'))
+            : coarseShape(sessionId);
+    const layer = renderMessage(msg(where === 'buildTaskRequest' ? 'config.taskRequest.requireExisting.layerAssembly' : 'config.taskRequest.requireExisting.layerLive'));
+    throw new TypeError(renderMessage(msg('config.taskRequest.requireExisting.noSession', { where, shape, layer })));
 };
 const refuseBadMaxTokens = (v) => {
     if (v === undefined || v === null)
@@ -643,15 +704,15 @@ export function parseMaxCostUsd(text) {
         return { ok: false, why: 'not_positive' };
     return { ok: true, value };
 }
-const ACCESSOR_READ_ORDER = ['live', 'memoryCapture', 'memory', 'settings', 'maxCostUsd', 'excludeAllTools', 'maxTokens', 'outputRetries', 'fileHistory', 'inheritEnv', 'requireExistingSession', 'disableSkills', 'approvalReach', 'allowTools'];
-const MATERIALIZE_AT_READ = Object.freeze({ allowTools: (v) => allowToolsSnapshot(v) });
+const ACCESSOR_READ_ORDER = ['live', 'memoryCapture', 'memory', 'hostSettings', 'settings', 'maxCostUsd', 'excludeAllTools', 'maxTokens', 'outputRetries', 'fileHistory', 'inheritEnv', 'requireExistingSession', 'disableSkills', 'approvalReach', 'allowTools', 'userInvokedSkills'];
+const MATERIALIZE_AT_READ = Object.freeze({ allowTools: (v) => allowToolsSnapshot(v), userInvokedSkills: (v) => allowToolsSnapshot(v) });
 function dataFirstSnapshot(input, afterData) {
     let descs;
     try {
         descs = Object.getOwnPropertyDescriptors(input);
     }
     catch {
-        throw new TypeError('buildTaskRequest: 入参的键集 / 属性描述符读不出(代理 trap 抛)—— 无法安全快照声明,拒绝装配。错误文本只报形状,不回显值。');
+        throw new TypeError(renderMessage(msg('config.taskRequest.inputKeysUnreadable')));
     }
     const bag = Object.create(null);
     const accessors = [];
@@ -682,11 +743,14 @@ export function assembleTaskRequest(input, lane) {
     let resolvedMaterializeError;
     let resolvedHookRan = false;
     const src = dataFirstSnapshot(input, (bag) => {
-        const st = bag['settings'];
-        if (present(st) && typeof st === 'object' && !Array.isArray(st)) {
+        if (!Object.hasOwn(bag, 'hostSettings'))
+            return;
+        const product = hostTurnSettingsOf(bag['hostSettings'], 'shape');
+        if (product !== undefined) {
             resolvedHookRan = true;
-            resolvedInEarly = st.resolved;
+            resolvedInEarly = product.carried.resolved;
             try {
+                rethrowHostResolvedDeferred(product);
                 resolvedMaterialized = resolvedSnapshotForWire(resolvedInEarly);
             }
             catch (e) {
@@ -703,11 +767,18 @@ export function assembleTaskRequest(input, lane) {
             '这一位装着已解析权限面与 hooks:把畸形容器当成「没给」= 请求带着被剥掉的权限面照发。错误文本只报形状,不回显值。');
     }
     const settingsObj = present(settingsIn) ? settingsIn : {};
-    const resolvedIn = resolvedHookRan ? resolvedInEarly : settingsObj.resolved;
+    const hostIn = src.hostSettings;
+    const host = hostTurnSettingsOf(hostIn);
+    if (host === undefined) {
+        throw new TypeError(renderMessage(msg('config.taskRequest.hostSettingsMalformed', { shape: coarseShape(hostIn) })));
+    }
+    const resolvedIn = resolvedHookRan ? resolvedInEarly : host.carried.resolved;
     const resolvedRoute = SETTINGS_KEY_ROUTES.resolved;
     const resolvedOpen = resolvedRoute.via === 'matrix' && omissionCauseOf(standingOf(resolvedRoute), lane, live) === undefined;
     if (resolvedOpen && resolvedHookRan && resolvedMaterializeError !== undefined)
         throw resolvedMaterializeError;
+    if (resolvedOpen && !resolvedHookRan)
+        rethrowHostResolvedDeferred(host);
     const resolvedWire = resolvedOpen ? (resolvedMaterialized ?? resolvedSnapshotForWire(resolvedIn)) : {};
     const maxCostUsdIn = src.maxCostUsd;
     const excludeAllToolsIn = src.excludeAllTools;
@@ -737,7 +808,14 @@ export function assembleTaskRequest(input, lane) {
         settings: settingsIn,
     });
     const SETTINGS_KEYS = Object.keys(SETTINGS_KEY_ROUTES);
-    const s = snapshotByName(settingsObj, SETTINGS_KEYS, { resolved: resolvedIn });
+    const hostSettingsKeysIn = HOST_SETTINGS_SUBKEYS.filter((k) => hasOwn(settingsObj, k) && present(Reflect.get(settingsObj, k)));
+    const s = {
+        resolved: resolvedIn,
+        webSearch: host.carried.webSearch,
+        ultracode: snapshotByName(settingsObj, ['ultracode']).ultracode,
+        hooks: host.carried.hooks,
+        outputStyle: host.carried.outputStyle,
+    };
     refuseBadMemoryCapture(memoryCaptureIn);
     refuseBadMemoryOff(memoryIn);
     refuseBadMaxCostUsd(maxCostUsdIn);
@@ -750,6 +828,7 @@ export function assembleTaskRequest(input, lane) {
     refuseBadDisableSkills(disableSkillsIn, 'buildTaskRequest');
     refuseBadApprovalReach(approvalReachIn, 'buildTaskRequest');
     refuseBadAllowTools(allowToolsIn);
+    refuseBadUserInvokedSkills(i.userInvokedSkills);
     const rewindRoute = INPUT_KEY_ROUTES.rewind;
     const RETIRED_REWIND_FILES_KEY = 'rewindFiles';
     const REWIND_KEYS = rewindRoute.via === 'matrix' ? rewindRoute.field.split('/') : [];
@@ -816,6 +895,12 @@ export function assembleTaskRequest(input, lane) {
             '处置:删掉这个键;要在回退会话时一并还原文件,改交 ' +
             'rewind.restoreFiles: true(必须与 rewind.resumeAt 同交);只还原文件、不动会话,交 rewind.rewindFilesTo。错误文本只报键名,不回显值。');
     }
+    if (hostSettingsKeysIn.length > 0) {
+        throw new TypeError(renderMessage(msg('config.taskRequest.hostSuppliedKeysByHand', {
+            keys: hostSettingsKeysIn.map((k) => `settings.${k}`).join(', '),
+            fields: hostSettingsKeysIn.map((k) => `${k}: …`).join(', '),
+        })));
+    }
     if (unknownKeys.length > 0) {
         const shown = unknownKeys.slice(0, MAX_UNKNOWN_KEYS_SHOWN).map(keyForDisplay).join(', ');
         const more = unknownKeys.length > MAX_UNKNOWN_KEYS_SHOWN ? ` 等共 ${unknownKeys.length} 个` : '';
@@ -829,6 +914,11 @@ export function assembleTaskRequest(input, lane) {
     refuseRequireExistingWithoutSession(requireExistingSessionIn, i.sessionId);
     refuseDisableSkillsConflict(disableSkillsIn, i.skills, Reflect.get(src, 'agents'), 'buildTaskRequest');
     refuseUtilityWithoutToolUnload(lane, excludeAllToolsIn);
+    if (host.verdict.kind === 'refuse') {
+        const refusing = hostRefusalNoticeOf(host, lane, live, host.verdict.notice);
+        if (refusing !== undefined)
+            throw new HostSettingsRefused(refusing);
+    }
     const carries = (route, value, key) => {
         if (route.via === 'always')
             return present(value);
@@ -870,7 +960,9 @@ export function assembleTaskRequest(input, lane) {
         ...(on('reasoningEffort') ? { reasoningEffort: i.reasoningEffort } : {}),
         ...(on('model') ? { model: i.model } : {}),
         ...(on('images') ? { images: i.images } : {}),
+        ...(on('userAttachments') ? { userAttachments: [...(i.userAttachments ?? [])] } : {}),
         ...(on('skills') ? { skills: i.skills } : {}),
+        ...(on('userInvokedSkills') ? { userInvokedSkills: allowToolsCopy(i.userInvokedSkills) } : {}),
         ...(on('mcpServers') ? { mcpServers: i.mcpServers } : {}),
         ...(on('rewind') ? rewindWire : {}),
         ...(on('permissionMode') ? { permissionMode: i.permissionMode } : {}),
@@ -905,7 +997,7 @@ export function assembleTaskRequest(input, lane) {
         ...(on('approvalReach') ? { approvalReach: approvalReachIn } : {}),
         ...(Object.keys(settingsOut).length > 0 ? { settings: settingsOut } : {}),
     };
-    return Object.freeze({ request: out, omitted: Object.freeze([...omitted, ...lateOmitted]) });
+    return Object.freeze({ request: out, omitted: Object.freeze([...omitted, ...lateOmitted]), host });
 }
 export function buildTaskRequest(input, lane) {
     return assembleTaskRequest(input, lane).request;
@@ -958,6 +1050,7 @@ export function applyLiveRequestDefaults(req, host) {
         out.sessionId === host.mockSessionIdConstant) {
         delete out.sessionId;
     }
+    refuseRequireExistingWithoutSession(out.requireExistingSession, out.sessionId, 'applyLiveRequestDefaults');
     return out;
 }
 export function unregisteredRequestKeys(req, lane) {