@sema-agent/client-core 0.99.0 → 0.101.0

package/dist/scenarioRefusal.d.ts

@@ -1,3 +1,4 @@
+import type { UiLanguage } from './env/uiLanguage.js';
 export interface ScenarioRefusalReading {
     readonly errorCode?: string;
     readonly error?: string;
@@ -6,4 +7,4 @@ export interface ScenarioRefusalReading {
 }
 export declare function scenarioRefusalOf(body: object): ScenarioRefusalReading | undefined | null;
 export declare function scenarioRefusalFromError(err: {} | null | undefined): ScenarioRefusalReading | null;
-export declare function scenarioRefusalContent(reading: ScenarioRefusalReading): string;
+export declare function scenarioRefusalContent(reading: ScenarioRefusalReading, lang?: UiLanguage): string;

package/dist/scenarioRefusal.js

@@ -3,6 +3,7 @@ import { readOwnDataValue } from './ownKey.js';
 import { SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE } from './engineErrorCodes.js';
 import { readErrorRecord, readErrorString } from './wireFailureShape.js';
 import { effectiveWireErrorCode } from './wireErrorTriage.js';
+import { msg, renderMessage } from './i18n/translate.js';
 const SCENARIO_REFUSAL_ERROR_MAX = 200;
 function detailBits(detail) {
     if (detail === undefined)
@@ -33,7 +34,7 @@ export function scenarioRefusalOf(body) {
         const d = Object.getOwnPropertyDescriptor(body, 'scenarioRefusal');
         if (d === undefined)
             return undefined;
-        raw = 'value' in d ? d.value : undefined;
+        raw = Object.hasOwn(d, 'value') ? d.value : undefined;
     }
     catch {
         return null;
@@ -86,7 +87,7 @@ export function scenarioRefusalFromError(err) {
         return null;
     }
 }
-export function scenarioRefusalContent(reading) {
+export function scenarioRefusalContent(reading, lang) {
     let code;
     let scenario;
     let source;
@@ -102,10 +103,9 @@ export function scenarioRefusalContent(reading) {
     }
     if (code === SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE) {
         const name = typeof scenario === 'string' && scenario.length > 0 ? ` ("${capForDisplay(scenario, 80)}")` : '';
-        const from = source === 'ruling' ? ', assigned to you by the configuration center,' : source === 'deployment' ? ", this deployment's default scenario," : '';
-        return (`This deployment cannot resolve your scenario: the scenario${name}${from} does not exist here, so it refuses whatever depends on your scenario — ` +
-            "new runs that do not name a scenario, and this session's list of MCP servers · Ask whoever operates the engine to fix the scenario assignment");
+        const from = source === 'ruling' ? msg('config.scenarioRefusal.source.ruling') : source === 'deployment' ? msg('config.scenarioRefusal.source.deployment') : '';
+        return renderMessage(msg('config.scenarioRefusal.dangling', { name, from }), lang);
     }
     const tail = typeof code === 'string' && code.length > 0 ? ` (${capForDisplay(code, 80)})` : '';
-    return `This deployment's scenario check refused to resolve your scenario${tail}, so whatever depends on your scenario is not available — this session's list of MCP servers is unknown`;
+    return renderMessage(msg('config.scenarioRefusal.generic', { tail }), lang);
 }

package/dist/scenarioSkills.d.ts

@@ -0,0 +1,20 @@
+type ScenarioCardSkillSource = 'factory' | 'center' | 'unknown-source';
+export interface ScenarioCardSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly source: ScenarioCardSkillSource;
+}
+export declare function scenarioSkillsOf(card: object | null | undefined): readonly ScenarioCardSkill[] | undefined;
+export type ScenarioSkillsCapabilityReading = {
+    readonly kind: 'confirmed';
+} | {
+    readonly kind: 'absent';
+} | {
+    readonly kind: 'declined';
+} | {
+    readonly kind: 'unreadable';
+} | {
+    readonly kind: 'unobserved';
+};
+export declare function observedScenarioSkillsCapability(baseUrl?: string | undefined): ScenarioSkillsCapabilityReading;
+export {};

package/dist/scenarioSkills.js

@@ -0,0 +1,72 @@
+import { engineCapValue } from './engineCapsCache.js';
+import { engineWireTargetBaseUrl } from './engineWireTarget.js';
+import { appendOwnElement, guardedRead, readOwnDataValue } from './ownKey.js';
+const SKILLS_READ_BUDGET = 100_000;
+function skillOfEntry(raw) {
+    try {
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+            return undefined;
+        const name = readOwnDataValue(raw, 'name');
+        if (typeof name !== 'string' || name.length === 0)
+            return undefined;
+        const description = readOwnDataValue(raw, 'description');
+        if (typeof description !== 'string')
+            return undefined;
+        const source = guardedRead(() => readOwnDataValue(raw, 'source'));
+        return Object.freeze({
+            name,
+            description,
+            source: source === 'factory' || source === 'center' ? source : 'unknown-source',
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+export function scenarioSkillsOf(card) {
+    try {
+        if (typeof card !== 'object' || card === null)
+            return undefined;
+        const list = readOwnDataValue(card, 'skills');
+        if (!Array.isArray(list))
+            return undefined;
+        const lengthDesc = Object.getOwnPropertyDescriptor(list, 'length');
+        const length = lengthDesc !== undefined && Object.hasOwn(lengthDesc, 'value') ? lengthDesc.value : undefined;
+        if (typeof length !== 'number' || !Number.isSafeInteger(length) || length < 0 || length > SKILLS_READ_BUDGET)
+            return undefined;
+        const out = [];
+        for (let i = 0; i < length; i++) {
+            const entry = guardedRead(() => skillOfEntry(readOwnDataValue(list, String(i))));
+            if (entry !== undefined)
+                appendOwnElement(out, entry);
+        }
+        if (length > 0 && out.length === 0)
+            return undefined;
+        return Object.freeze(out);
+    }
+    catch {
+        return undefined;
+    }
+}
+const SCENARIO_SKILLS_CAPABILITY_KEY = 'scenarioSkills';
+export function observedScenarioSkillsCapability(baseUrl) {
+    try {
+        const base = baseUrl === undefined ? engineWireTargetBaseUrl() : baseUrl;
+        const slot = engineCapValue(typeof base === 'string' ? base : undefined, SCENARIO_SKILLS_CAPABILITY_KEY);
+        switch (slot.kind) {
+            case 'unobserved':
+                return Object.freeze({ kind: 'unobserved' });
+            case 'not_reported':
+                return Object.freeze({ kind: 'absent' });
+            case 'unreadable':
+                return Object.freeze({ kind: 'unreadable' });
+            case 'null':
+                return Object.freeze({ kind: 'declined' });
+            case 'value':
+                return slot.value === true ? Object.freeze({ kind: 'confirmed' }) : Object.freeze({ kind: 'declined' });
+        }
+    }
+    catch {
+        return Object.freeze({ kind: 'unobserved' });
+    }
+}

package/dist/scenarioWire.d.ts

@@ -8,6 +8,9 @@ export type ScenarioParseResult = {
     ok: false;
     error: string;
 };
-export declare function parseScenarioArgv(argv: readonly string[]): ScenarioParseResult;
+export interface ScenarioFlag {
+    readonly flag?: string;
+    readonly missing?: true;
+}
 export declare function headlessScenarioFromEnv(env?: EnvLike): string | undefined;
-export declare function scenarioForPrint(argv: string[], env?: EnvLike): ScenarioParseResult;
+export declare function scenarioForPrint(flag: ScenarioFlag | undefined, env?: EnvLike): ScenarioParseResult;

package/dist/scenarioWire.js

@@ -1,18 +1,18 @@
 import { hostEnv } from './hostEnv.js';
-import { lastFlagValue } from './argvFlagValue.js';
+import { flagIsWronglyTyped, flagString, flagTrue } from './flagInput.js';
 export const SCENARIO_NAME_RE = /^[a-z][a-z0-9-]{1,31}$/;
 export const HEADLESS_SCENARIO_ENV = 'SEMA_HEADLESS_SCENARIO';
 const USAGE_HINT = "sema: --scenario expects a scenario name (lowercase letters/digits/hyphens, starting with a letter, ≤32 chars).\n" +
     '  --scenario <name>    route this run through the named engine scenario (deployment-defined tool\n' +
     '                       roster + system prompt; unknown names are refused by the engine (scenario_unknown))\n' +
     '  (no flag)            the default scenario — today\'s behaviour';
-export function parseScenarioArgv(argv) {
-    const flag = lastFlagValue(argv, '--scenario');
-    if (!flag.present)
-        return { ok: true };
-    if (flag.raw === undefined)
+function parseScenarioFlag(input) {
+    if (flagIsWronglyTyped(input, 'flag'))
         return { ok: false, error: USAGE_HINT };
-    const v = flag.raw.trim();
+    const value = flagString(input, 'flag');
+    if (value === undefined)
+        return flagTrue(input, 'missing') ? { ok: false, error: USAGE_HINT } : { ok: true };
+    const v = value.trim();
     if (/\s/.test(v)) {
         return {
             ok: false,
@@ -36,8 +36,8 @@ export function headlessScenarioFromEnv(env = hostEnv()) {
     }
     return v;
 }
-export function scenarioForPrint(argv, env = hostEnv()) {
-    const parsed = parseScenarioArgv(argv);
+export function scenarioForPrint(flag, env = hostEnv()) {
+    const parsed = parseScenarioFlag(flag);
     if (!parsed.ok)
         return parsed;
     if (parsed.scenario)

package/dist/sealedKeyCapability.js

@@ -1,4 +1,4 @@
-import { engineWireTarget } from './engineWireTarget.js';
+import { engineWireTargetBaseUrl } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 function ownNonEmpty(seg, key) {
@@ -29,6 +29,6 @@ const reader = createEngineCapReader({
     name: 'sealedKey',
     project: projectSealedKeyCapability,
 });
-export function observedSealedKey(baseUrl = engineWireTarget()?.baseUrl) {
+export function observedSealedKey(baseUrl = engineWireTargetBaseUrl()) {
     return reader.observed(baseUrl);
 }

package/dist/seam.d.ts

@@ -1,12 +1,13 @@
 import type { ModelUsage, SDKMessage } from '@sema-agent/agent-types';
 import type { EngineTurnUsage } from './adapter/downstream/turnUsageToModelUsage.js';
 import type { RunCostReconcile } from './adapter/downstream/terminalToSdkResult.js';
-import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestHookEntryView, WiringManifestLspSeamView, WiringManifestWriteProtectionView, WiringManifestAutoConsolidationView, WiringManifestReadDenyView, ContextUsageSectionView, PromptManifestSectionView, PromptManifestBlockView, PromptManifestToolView } from './adapter/downstream/eventToSdkMessage.js';
+import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestHookEntryView, WiringManifestLspSeamView, WiringManifestWriteProtectionView, WiringManifestAutoConsolidationView, WiringManifestReadDenyView, WiringManifestModView, ContextUsageSectionView, PromptManifestSectionView, PromptManifestBlockView, PromptManifestToolView, PromptManifestIdentityView } from './adapter/downstream/eventToSdkMessage.js';
 import type { ToolRosterView, ToolRosterDeltaView, WiringManifestHandsView } from './toolRoster.js';
 import type { WiringManifestFleetView } from './adapter/downstream/wiringManifestView.js';
 import type { SuspendedReopenReading } from './hitl/suspendedReopen.js';
 import type { ToolKillCause } from './toolResult.js';
 import type { HumanInputAttachmentView } from './ownKey.js';
+import type { TaskNotificationFields } from './notifications.js';
 export interface AbortSignalLike {
     readonly aborted: boolean;
 }
@@ -34,13 +35,6 @@ export interface AdapterContext {
         readonly toolName: string;
     }): ToolKillCause | undefined;
     coalesceIntervalMs?: number;
-    continuesPark?: ContinuesParkDeclaration;
-}
-export interface ContinuesParkDeclaration {
-    readonly toolCallId: string;
-    readonly checkpointId?: string;
-    readonly parkedTaskId?: string;
-    readonly continuationTaskId?: string;
 }
 export type ChromeEvent = {
     kind: 'retry_status';
@@ -122,6 +116,7 @@ export type ChromeEvent = {
     status: 'completed' | 'failed';
     summary: string;
     message: string;
+    notification: Readonly<TaskNotificationFields>;
 } | {
     kind: 'task_ledger_sync';
     laneProof: LaneProof;
@@ -167,7 +162,7 @@ export type ChromeEvent = {
 } | ({
     kind: 'run_cost_reconciled';
     laneProof: LaneProof;
-} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | CompactionStartedChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
     kind: 'suspended_reopened';
     laneProof: LaneProof;
     reopen: Extract<SuspendedReopenReading, {
@@ -195,6 +190,7 @@ export interface WiringManifestChromeEvent {
         readonly selected: readonly string[];
     };
     fleet?: WiringManifestFleetView;
+    mods?: readonly WiringManifestModView[];
     eventId?: string;
 }
 export interface TextSegmentCommittedRow {
@@ -235,6 +231,15 @@ export interface CompactionOutcomeChromeEvent {
     outcome: string;
     trigger?: string;
     reason?: string;
+    pass?: string;
+    eventId?: string;
+}
+export interface CompactionStartedChromeEvent {
+    kind: 'compaction_started';
+    laneProof: LaneProof;
+    pass: string;
+    trigger: string;
+    startedAt?: number;
     eventId?: string;
 }
 export interface SubagentStartedChromeEvent {
@@ -269,6 +274,7 @@ export interface PromptAssembledChromeEvent {
     blocks?: readonly PromptManifestBlockView[];
     sections?: readonly PromptManifestSectionView[];
     tools?: readonly PromptManifestToolView[];
+    identity?: PromptManifestIdentityView;
     eventId?: string;
 }
 export interface ToolDisclosureChromeEvent {
@@ -401,3 +407,14 @@ export declare function deriveTranscriptId(frame: {
     id?: unknown;
     toolCallId?: unknown;
 }, ctx: Pick<AdapterContext, 'uuid'>, suffix?: string): string;
+export declare const SEMA_TERMINAL_OWNER_KEY = "_sema_terminal_owner";
+export type TerminalOwner = {
+    readonly kind: 'request-not-sent';
+    readonly requestId?: string;
+    readonly heldBy?: string;
+} | {
+    readonly kind: 'followed-run';
+    readonly taskId: string;
+    readonly runId?: string;
+};
+export declare function terminalOwnerOf(row: {} | null | undefined): TerminalOwner | undefined;

package/dist/seam.js

@@ -76,6 +76,12 @@ const CHROME_ARM_TABLE = {
         duty: 'CC-89(0.75.0):一次压缩的非 compacted 结局(作废 / 失败等),给用户一条可见提示。`outcome` / `trigger` 是引擎开集原词,按成员渲染必带 default 臂、认不得照原词显示;' +
             '🔴 不是终态 —— 任务还在跑,别据它收 spinner;`laneProof.lane` 为 subagent = 子代的压缩结局,别渲成主会话的;成功压缩不走本臂(权威是转录的 compact_boundary)。不接 = 压缩失败对用户不可见。',
     },
+    compaction_started: {
+        required: false,
+        duty: '可选:一次压缩 pass 宣告开始(服务端 ≥ 7.132.0)—— 要显示「正在压缩」的宿主接它。🔴 别自己配对开 / 收:把本臂、`compaction_outcome` 臂与转录 `compact_boundary` 行喂给' +
+            ' `createCompactionStatusTracker()`(按 `pass` 开收、子代车道不点亮主车道、流结束收口),交互车道读它的 `reading()`,print 车道把它的变化转成 CC 同形 `system/status` 帧;' +
+            '`trigger` 开集原词(按成员渲染带 default 臂);`startedAt` 缺席 = 没报;本臂不是终态,`laneProof.lane` 为 subagent = 子代的压缩,别渲成主会话的。',
+    },
     subagent_started: {
         required: false,
         duty: '可选:委派子代每周期一帧的起跑事实(sdk `task_started`,服务端 ≥ 7.127.0)—— 要「起跑时就开子代行」的宿主接它(不接 = 首个 task_progress 才开行,与 0.98.0 同)。' +
@@ -167,13 +173,13 @@ const CHROME_ARM_TABLE = {
         duty: '🔴 引擎明报的 assistant 散文段边界 + **该段权威全文**(#323/core #447;server ≥7.75.3 起 content 经脱敏器、' +
             'text_delta 仍逐字 ⇒ 两者**可以不相等**)。①`diverged` 在场(never false)⇒ 你按增量拼出来的那一段是过期的,' +
             '必须用 content **重渲该段**并以它为该段 committed 文本,不许保留增量拼文;②`committedPrefixDiverged` 在场' +
-            '(never false)⇒ 这一段此前已 committed 上屏的正文**也**过期了,🔴 本包在这一形上**一个字节都不再交**' +
+            '(never false)⇒ 这一段此前已 committed 上屏的正文**也**过期了,🔴 本包在这一形上**一个字节都不再交**(唯一不同:本段已提交行的归属说不出 —— 上游两行同 uuid,`committedUuids` 整键缺席 —— 时本包一个字节不动,还押着的原始那截在本事件之后照旧作为本段末行交出)' +
             '(撤不回的那截拼不出 content)⇒ 把 committedPrefixLen 指的那一截换成 content,这一条**所有宿主都要做**;' +
             '缺席 ⇒ 本包交的是尾段,前缀+尾段=content,什么都不用丢;③`committedPrefixLen`(never 0)= 定位量,' +
             '🔴 **单位 = JS 字符串长度(UTF-16 代码单元),不是 UTF-8 字节、也不是几条消息**' +
-            '(按 UTF-8 字节截会在非 ASCII 正文上截错位置把凭据留在屏上;按消息丢会连合并在同一条消息里的上一段定稿一起删掉),' +
-            '照抄 `已committed正文.slice(0, 长度 - committedPrefixLen) + content`;按**增量拼文**计长、不是 content 上的偏移;④三键全缺席 ⇒ 照旧只当对账/定界,拿 content 再渲一行 = 同一段上屏两遍;⑤`segmentId`(恒在场)= 段身份,与本段已过境的 committed 文本行顶层 `_sema_segment_id` 同值 —— 换掉已提交那截时认行的钥匙是**两把**:行 uuid ∧ 段身份(按字节相等找行会被同后缀的独立行冒充)。' +
-            '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = 前段定稿前缀 + content、其余行空;别整行换首行,提交行可能带上一段定稿),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位;' +
+            '(按 UTF-8 字节截会在非 ASCII 正文上截错位置把凭据留在屏上;按消息丢会连同一条消息里别的段的正文一起删掉),' +
+            '照抄 `已committed正文.slice(0, 长度 - committedPrefixLen) + content`;按**增量拼文**计长、不是 content 上的偏移;④三键全缺席 ⇒ 照旧只当对账/定界,拿 content 再渲一行 = 同一段上屏两遍;⑤`segmentId`(恒在场)= 段身份,与本段**全部** committed 文本行顶层 `_sema_segment_id` 同值(一行恰属一个段;本事件之后紧跟本段末行;段只按这一位认,不按消息界 / 相邻猜)—— 换掉已提交那截时认行的钥匙是**两把**:行 uuid ∧ 段身份(按字节相等找行会被同后缀的独立行冒充)。' +
+            '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = content、其余行空),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位;' +
             '⑦序:该段尾部的活体增量(`stream_delta`)一律先于本事件到达,本事件之后不再有同段增量(下一条增量属于下一段)。',
     },
 };
@@ -189,3 +195,37 @@ export function deriveTranscriptId(frame, ctx, suffix) {
     }
     return ctx.uuid();
 }
+export const SEMA_TERMINAL_OWNER_KEY = '_sema_terminal_owner';
+export function terminalOwnerOf(row) {
+    try {
+        if (typeof row !== 'object' || row === null)
+            return undefined;
+        const d = Object.getOwnPropertyDescriptor(row, SEMA_TERMINAL_OWNER_KEY);
+        if (d === undefined || !Object.hasOwn(d, 'value'))
+            return undefined;
+        const v = d.value;
+        if (typeof v !== 'object' || v === null)
+            return undefined;
+        const own = (k) => {
+            const pd = Object.getOwnPropertyDescriptor(v, k);
+            return pd !== undefined && Object.hasOwn(pd, 'value') && typeof pd.value === 'string' && pd.value.length > 0 ? pd.value : undefined;
+        };
+        const kind = own('kind');
+        if (kind === 'request-not-sent') {
+            const requestId = own('requestId');
+            const heldBy = own('heldBy');
+            return { kind, ...(requestId !== undefined ? { requestId } : {}), ...(heldBy !== undefined ? { heldBy } : {}) };
+        }
+        if (kind === 'followed-run') {
+            const taskId = own('taskId');
+            if (taskId === undefined)
+                return undefined;
+            const runId = own('runId');
+            return { kind, taskId, ...(runId !== undefined ? { runId } : {}) };
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/seatContract.d.ts

@@ -12,6 +12,7 @@ import { type ProbeVerdictWord } from "./modelCapabilityProbe.js";
 import type { SubagentContentEvent } from "./subagentContentStore.js";
 import type { DeviceEnrollTokenOutcome, DeviceListOutcome, DeviceRebindOutcome, DeviceRevokeOutcome, DeviceSessionBindingOutcome, DeviceTransport, DeviceUnarmed, DeviceUnreadable } from "./deviceRebind.js";
 import type { McpPanelView } from "./mcpPanel.js";
+import type { McpToolToggleKey } from "./mcpToolToggles.js";
 export interface SeatValidationFailure {
     reason: string;
     field?: string;
@@ -78,7 +79,52 @@ export interface ToolPermissionRequest {
 declare const SEAT_EVENT_TYPE_TUPLE: readonly ["start", "close", "session_updated", "message", "stream_event", "chrome_event", "error", "tool_permission_resolved", "subagent_content"];
 export type SeatEventType = (typeof SEAT_EVENT_TYPE_TUPLE)[number];
 export declare const SEAT_EVENT_TYPES: readonly SeatEventType[];
-declare const CHROME_EVENT_KIND_TUPLE: readonly ["panel_task", "notification_terminal", "prompt_suggestions", "subagent_lifecycle", "text_segment_end", "thinking_segment_end", "retry_status", "context_usage", "last_turn_usage", "bgshell_register", "bgshell_settle", "memory_saved", "result_replayed", "tool_parked"];
+declare const CHROME_ARM_SEAT_ROUTE: {
+    readonly panel_task: "seat";
+    readonly notification_terminal: "seat";
+    readonly prompt_suggestions: "seat";
+    readonly subagent_lifecycle: "seat";
+    readonly text_segment_end: "seat";
+    readonly thinking_segment_end: "seat";
+    readonly retry_status: "seat";
+    readonly context_usage: "seat";
+    readonly last_turn_usage: "seat";
+    readonly bgshell_register: "seat";
+    readonly bgshell_settle: "seat";
+    readonly memory_saved: "seat";
+    readonly result_replayed: "seat";
+    readonly tool_parked: "seat";
+    readonly compaction_started: "seat";
+    readonly compaction_outcome: "seat";
+    readonly engine_notice: "seat";
+    readonly workflow_notification_enqueue: "host";
+    readonly plan_review_park: "host";
+    readonly approval_request: "host";
+    readonly approval_revoke: "host";
+    readonly task_ledger_sync: "host";
+    readonly inline_task_stats: "host";
+    readonly stream_delta: "host";
+    readonly thinking_activity: "host";
+    readonly request_start: "host";
+    readonly response_metrics: "host";
+    readonly attachment: "host";
+    readonly subagent_turn_usage: "host";
+    readonly run_cost_reconciled: "host";
+    readonly message_committed: "host";
+    readonly human_input: "host";
+    readonly tool_roster_delta: "host";
+    readonly subagent_started: "host";
+    readonly prompt_assembled: "host";
+    readonly tool_disclosure: "host";
+    readonly tool_progress: "host";
+    readonly wiring_manifest: "host";
+    readonly suspended_reopened: "host";
+    readonly result_text_diverged: "host";
+};
+type SeatRoutedKind = {
+    [K in keyof typeof CHROME_ARM_SEAT_ROUTE]: (typeof CHROME_ARM_SEAT_ROUTE)[K] extends "seat" ? K : never;
+}[keyof typeof CHROME_ARM_SEAT_ROUTE];
+declare const CHROME_EVENT_KIND_TUPLE: readonly SeatRoutedKind[];
 export type ChromeEventKind = Extract<ChromeArmKind, (typeof CHROME_EVENT_KIND_TUPLE)[number]>;
 export declare const CHROME_EVENT_KINDS: readonly ChromeEventKind[];
 export interface SeatChromeEnvelopeBase {
@@ -144,7 +190,7 @@ export type SeatStreamReading = {
 };
 export declare function seatStreamDeltaMessage(event: SeatStreamDeltaSource, ids: SeatStreamDeltaIds): SeatStreamEventMessage | undefined;
 export declare function readSeatStreamDelta(message: object): SeatStreamReading;
-export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard"];
+export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles"];
 export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
 export interface SeatCapabilitiesState {
     pickFolder?: boolean;
@@ -154,6 +200,7 @@ export interface SeatCapabilitiesState {
     devices?: boolean;
     engineTarget?: boolean;
     onboard?: boolean;
+    mcpToolToggles?: boolean;
 }
 export type SeatCapabilityReading = {
     readonly kind: "reported";
@@ -207,16 +254,16 @@ export declare const SEAT_TURN_SETTINGS_ORIGINS: Readonly<{
         carriedBy: "renderer";
     }>;
     webSearch: Readonly<{
-        hostSupplied: "联网检索的每请求配置来自宿主的设置源(可能带检索服务的凭据与私网地址);渲染端没有设置文件,也不该持有凭据";
+        hostSupplied: "settings.webSearch";
     }>;
     hooks: Readonly<{
-        hostSupplied: "hooks 表来自宿主的设置文件(宿主经设置端口与 hooksForWire 投影);渲染端没有设置文件、也不执行本机 hook";
+        hostSupplied: "settings.hooks";
     }>;
     resolved: Readonly<{
-        hostSupplied: "设置解析器的生效快照(hooks / env / model / 已解析权限)由宿主跑解析器得出;渲染端没有设置源可解析";
+        hostSupplied: "settings.resolved";
     }>;
     outputStyle: Readonly<{
-        hostSupplied: "输出风格正文由宿主的兜底层随请求带(风格文件在宿主);渲染端只选名字,不持正文";
+        hostSupplied: "settings.outputStyle";
     }>;
 }>;
 export interface SeatRewindIntent {
@@ -542,6 +589,10 @@ export interface OnboardProvidersResult {
 }
 export declare const checkOnboardEntryRequest: (v: unknown) => SeatValidation;
 export declare const checkOnboardApplyRequest: (v: unknown) => SeatValidation;
+export declare const checkMcpToolToggleKey: (v: unknown) => SeatValidation;
+export interface McpToolTogglesResult {
+    off: McpToolToggleKey[];
+}
 export interface LocalSessionsApi {
     start(opts?: StartSessionOptions): Promise<LocalSessionRecord>;
     sendMessage(req: SendMessageRequest): Promise<SendMessageAck>;
@@ -577,6 +628,8 @@ export interface LocalSessionsApi {
     probeOnboardEntry(req: OnboardEntryRequest): Promise<OnboardProbeResult>;
     applyOnboardEntry(req: OnboardApplyRequest): Promise<OnboardApplyResult>;
     readSessionMcpPanel(sessionId: string): Promise<McpPanelView | DeviceUnreadable | DeviceTransport | DeviceUnarmed>;
+    listMcpToolToggles(): Promise<McpToolTogglesResult>;
+    setMcpToolToggle(key: McpToolToggleKey, enabled: boolean): Promise<OkAck>;
     onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
     onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
     sessionsStateStore: EipcStoreClient<SessionsState>;
@@ -620,7 +673,7 @@ export declare const checkSessionRowPatchRequest: (v: unknown) => SeatValidation
 export declare function isSessionRowPatchRequest(v: unknown): v is SessionRowPatchRequest;
 export declare function isSendMessageAck(v: unknown): v is SendMessageAck;
 export declare const LOCAL_SESSIONS_SPEC: EipcServiceSpec;
-export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "onEvent", "onToolPermissionRequest"];
+export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "onEvent", "onToolPermissionRequest"];
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore", "engineTargetStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "error", "errorCategory", "code", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome", "_sema_turnFailure", "subagentContent"];
@@ -808,7 +861,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
     readonly SeatCapabilitiesState: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard"];
+        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles"];
         readonly unchecked: readonly [];
     };
     readonly RecentFoldersResult: {
@@ -848,7 +901,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
 };
 export declare const SEAT_VALIDATOR_COVERAGE_EXEMPT: readonly [...{
-    label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest";
+    label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey";
     check: (v: unknown) => SeatValidation;
     why: string;
 }[], {