@sema-agent/client-core 0.11.15 → 0.11.16

package/README.md

@@ -23,7 +23,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.11.15
+**Version:** 0.11.16
 
 - **Today** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
   B/D/E tool-card layers), the notification/caps/model families, the adapter kernel (stream driver
@@ -214,6 +214,7 @@ itself (FAILED names + skipped names + arithmetic reconciliation). All-SKIP repo
 | `scripts/run-sdk-floor-test.mjs` | The SDK version floor — and, more to the point, that the *installed* type declarations still carry the keys this package reads |
 | `scripts/run-engine-vocab-floor-test.mjs` | Engine-mirrored vocabularies (structured card whitelist, self-reported tool face, control verbs, recogniser sets) against the *installed* `@sema-agent/core` |
 | `scripts/run-streamjson-timing-honesty-test.mjs` | Stream timing & terminal honesty ([2084]): held errored fs-write results release on model progress; wall-clock timeout maps to `error_during_execution` with a truthful salvage note; the synthetic API-error assistant row carries the `<synthetic>` in-message sentinel |
+| `scripts/run-background-view-test.mjs` | `createBackgroundView` lifecycle: polling/notify pairing, per-source degrade (`501 → not-configured` vs `unavailable`), the capabilities `scheduler` probe, and dispose really aborting the in-flight fleet snapshot (pure projection lives in the pure suite's W-A segment) |
 | `scripts/run-public-surface-test.mjs` | The outward promises: the npm export surface baseline, the peer floor witness, and this README's claims |
 
 Each suite carries a floor that only moves up — a refactor that stops executing a group of

package/dist/agentSession/backgroundView.d.ts

@@ -0,0 +1,76 @@
+/**
+ * backgroundView — design/161 平行入口 `createBackgroundView(client)` 的实现(实现批 A,2026-07-30)。
+ *
+ * 契约锚 = ./contract.ts(类型已冻结,clay 二裁/终裁):`assistant.tasks` 与 `fleet` 都是**会话外
+ * 读面**(assistant 跨 session;fleet 是 idle 壳唯一保持订阅的常驻 SSE),生命周期不绑任何会话的
+ * dispose(),所以归一投影在 createAgentSession 之外单开一门。
+ *
+ * ── 两源两张映射表(第三套中性 7 值词表,不用任一方词表)────────────────────────────────────
+ *   · assistant(SDK types.d.ts AssistantTask.status,3 值闭集):活跃调度行词表 —— 无终态臂。
+ *   · fleet(SDK resources/fleet.d.ts FleetTaskStatus,9 值 wire 闭集 / 读侧开)。
+ *   两张表各自显式穷举 + `never` 卫兵:上游加词当天**编译红**,不静默落兜底;wire 真发了未知词
+ *   (更新的 server × 旧 SDK)时走注释里的 open-set 回落 —— 与 workflowClient coerce 族同姿势。
+ *
+ * ── 拉取姿势(照 workflowClient 0.11.15 的订阅纪律)─────────────────────────────────────────
+ *   · 轮询(可配 intervalMs 缺省 2000)+ **解析即通知**(首帧不等宿主 tick)+ **订阅即对账**
+ *     (已解析后订阅同步补一发 —— 配对机制必须共享前提);订阅者抛异常吞;dispose abort 在飞
+ *     请求(含 fleet.snapshot 的 SSE 短连)并停循环。
+ *   · 两源**独立拉取独立降级**:一源挂另一源照常;本源绝不 throw 进宿主。
+ *   · fleet 快照走 SDK `fleet.snapshot()`(G19 一次性快照 verb:开流取首 snapshot 帧即断 ——
+ *     fleet 面无独立 REST 快照端点,这是契约形不是绕路)。
+ *
+ * ── 'not-configured' 判别(诚实缺席纪律)────────────────────────────────────────────────────
+ *   · fleet:面 gated off 时路由在任何帧之前答 **501**(typed)—— 501 ⇒ 'not-configured',
+ *     其它错 ⇒ 'unavailable'(拒绝形分档;错误判型走 controlRouter.errCodes 单源)。
+ *   · assistant:无 TiDB run store 时 worker 回 `{tasks:[]}` **原样透传** —— wire 上与真空
+ *     不可区分。能探则探:`GET /v1/capabilities` 的 `scheduler` 位(server `schedulerEnabled &&
+ *     requirePrincipal!==true && remoteExec==="host"` 三与)为 false/缺席 ⇒ 'not-configured';
+ *     caps 面自己不可达 ⇒ 判别缺席,**如实回 'ok'**(绝不编造判别)。🔴 残余缺口候引擎位:
+ *     scheduler:true 而 run store 未配的 `{tasks:[]}` 仍与真空同形 —— 需要 wire 长出判别位
+ *     (caps 或响应信封)才能收口,本实现不猜。
+ *
+ * 字段纪律:缺席=键不在场(undefined),🔴 绝不 `?? 0` / `?? false`;ISO→epoch ms 只在
+ * assistant 行边界转一次;fleet 复合 id("<runId> <taskId>")整串不拆;fleet 子行(parentId
+ * 在场)不进 rows(子代不是用户的独立后台任务)。
+ */
+import type { AgentClient, AssistantTask, FleetTaskRow, FleetTaskStatus } from '@sema-agent/sdk';
+import type { BackgroundRow, BackgroundSourceHealth, BackgroundStatus, BackgroundView, CreateBackgroundView } from './contract.js';
+/** assistant 3 值 → 中性 7 值。suspended(durable HITL park)与 needs_review(plan_review/dry-run
+ *  park)都是「引擎停着等人」⇒ 同落 'waiting-on-human'(区分度由行上 gate.kind 携带,不铸新词)。 */
+export declare function backgroundStatusFromAssistant(s: AssistantTask['status']): BackgroundStatus;
+/** fleet 9 值 → 中性 7 值。'waiting'(durable suspend)与 'awaiting approval'(needs-review /
+ *  plan-approval park)都在等人;'idle' 是「活着但此刻没在推进」—— 中性词表无此臂,按活跃行渲
+ *  'running'(诚实取舍:它既不 queued 也不终态,更不是在等人)。 */
+export declare function backgroundStatusFromFleet(s: FleetTaskStatus): BackgroundStatus;
+/** 一行 AssistantTask → BackgroundRow。gate 是 `AssistantGate | null`(wire 显式 null 形)——
+ *  null 折成键缺席,非 null 原引用透传(契约位是 unknown,包不重构造)。 */
+export declare function assistantTaskToBackgroundRow(t: AssistantTask): BackgroundRow;
+/** 一行 FleetTaskRow → BackgroundRow;子行(parentId 在场)⇒ null(调用方剔除)。
+ *  复合 id 不拆;`currentTool` 契约位是一行字符串 —— 优先 server 已 redact 的 `currentAction`
+ *  原文,缺席时从结构化 `currentTool` 合成;`needsAttention` fleet wire 无显式位,从 park 态
+ *  推导(awaiting approval / awaitingPlanApproval / waiting),非 park 行键缺席(缺席≠false)。 */
+export declare function fleetTaskToBackgroundRow(r: FleetTaskRow): BackgroundRow | null;
+export interface BackgroundViewInputs {
+    readonly assistant: {
+        readonly health: BackgroundSourceHealth;
+        readonly tasks: readonly AssistantTask[];
+    };
+    readonly fleet: {
+        readonly health: BackgroundSourceHealth;
+        readonly tasks: readonly FleetTaskRow[];
+    };
+}
+/** 纯组合:两源(各带三态健康位)→ BackgroundView。行序 = assistant 先(core 已按 triage 排,
+ *  消费方不再排)、fleet 后(帧到达序);非 'ok' 源的行不出(那份列表不是证词);sources 三态
+ *  恒在场 —— 源不可用/未配置与「空列表」是三件事,端必须渲它。 */
+export declare function projectBackgroundView(i: BackgroundViewInputs): BackgroundView;
+export interface BackgroundViewOptions {
+    /** 轮询间隔(缺省 2000ms)。 */
+    readonly intervalMs?: number;
+}
+/**
+ * createBackgroundView(client, opts?) — 后台任务归一视图(契约 `CreateBackgroundView`;第二参是
+ * 实现旋钮,可选参不缩窄契约形)。生命周期:构造即起后台轮询;`snapshot()` 首解析前 null;
+ * `subscribe` 解析即通知 + 订阅即对账;`dispose()` abort 在飞请求、停循环、清订阅。
+ */
+export declare function createBackgroundView(client: AgentClient, opts?: BackgroundViewOptions): ReturnType<CreateBackgroundView>;

package/dist/agentSession/backgroundView.js

@@ -0,0 +1,254 @@
+import { errCodes } from '../controlRouter.js';
+import { engineWireDebugEnabled } from '../engineWireTarget.js';
+import { hostLog } from '../host.js';
+// ── status 映射表 ×2(显式穷举 + never 卫兵)──────────────────────────────────────────────────
+/** assistant 3 值 → 中性 7 值。suspended(durable HITL park)与 needs_review(plan_review/dry-run
+ *  park)都是「引擎停着等人」⇒ 同落 'waiting-on-human'(区分度由行上 gate.kind 携带,不铸新词)。 */
+export function backgroundStatusFromAssistant(s) {
+    switch (s) {
+        case 'running':
+            return 'running';
+        case 'suspended':
+            return 'waiting-on-human';
+        case 'needs_review':
+            return 'waiting-on-human';
+        default: {
+            const exhaustive = s; // 上游加词 ⇒ 这里编译红(闭集穷举卫兵)
+            void exhaustive;
+            // wire 开集回落:assistant.tasks 只列活跃调度行,未知新词按「活着」渲(同 workflowClient coerce 族)。
+            return 'running';
+        }
+    }
+}
+/** fleet 9 值 → 中性 7 值。'waiting'(durable suspend)与 'awaiting approval'(needs-review /
+ *  plan-approval park)都在等人;'idle' 是「活着但此刻没在推进」—— 中性词表无此臂,按活跃行渲
+ *  'running'(诚实取舍:它既不 queued 也不终态,更不是在等人)。 */
+export function backgroundStatusFromFleet(s) {
+    switch (s) {
+        case 'queued':
+            return 'queued';
+        case 'running':
+            return 'running';
+        case 'waiting':
+            return 'waiting-on-human';
+        case 'stopping':
+            return 'stopping';
+        case 'awaiting approval':
+            return 'waiting-on-human';
+        case 'idle':
+            return 'running';
+        case 'completed':
+            return 'done';
+        case 'failed':
+            return 'failed';
+        case 'killed':
+            return 'stopped';
+        default: {
+            const exhaustive = s; // 上游加词 ⇒ 编译红;wire 未知词(读侧开集)⇒ 按活跃行回落
+            void exhaustive;
+            return 'running';
+        }
+    }
+}
+// ── 行投影 ×2 ────────────────────────────────────────────────────────────────────────────────
+/** ISO 串 → epoch ms,只在这一处转;烂串 ⇒ undefined(诚实缺席,绝不 NaN/0 外泄)。 */
+function isoToEpochMs(iso) {
+    const ms = Date.parse(iso);
+    return Number.isFinite(ms) ? ms : undefined;
+}
+/** 一行 AssistantTask → BackgroundRow。gate 是 `AssistantGate | null`(wire 显式 null 形)——
+ *  null 折成键缺席,非 null 原引用透传(契约位是 unknown,包不重构造)。 */
+export function assistantTaskToBackgroundRow(t) {
+    const updatedAtMs = isoToEpochMs(t.updatedAt);
+    return {
+        key: { source: 'assistant', taskId: t.taskId },
+        status: backgroundStatusFromAssistant(t.status),
+        ...(updatedAtMs !== undefined ? { updatedAtMs } : {}),
+        needsAttention: t.needsAttention,
+        ...(t.gate !== null ? { gate: t.gate } : {}),
+    };
+}
+/** 一行 FleetTaskRow → BackgroundRow;子行(parentId 在场)⇒ null(调用方剔除)。
+ *  复合 id 不拆;`currentTool` 契约位是一行字符串 —— 优先 server 已 redact 的 `currentAction`
+ *  原文,缺席时从结构化 `currentTool` 合成;`needsAttention` fleet wire 无显式位,从 park 态
+ *  推导(awaiting approval / awaitingPlanApproval / waiting),非 park 行键缺席(缺席≠false)。 */
+export function fleetTaskToBackgroundRow(r) {
+    if (typeof r.parentId === 'string' && r.parentId !== '')
+        return null;
+    const currentTool = typeof r.currentAction === 'string' && r.currentAction !== ''
+        ? r.currentAction
+        : r.currentTool !== undefined
+            ? `${r.currentTool.toolName}${r.currentTool.target !== undefined ? ` ${r.currentTool.target}` : ''}`
+            : undefined;
+    const parked = r.status === 'awaiting approval' || r.status === 'waiting' || r.awaitingPlanApproval === true;
+    return {
+        key: { source: 'fleet', rowId: r.id },
+        status: backgroundStatusFromFleet(r.status),
+        ...(parked ? { needsAttention: true } : {}),
+        ...(typeof r.name === 'string' && r.name !== '' ? { name: r.name } : {}),
+        ...(typeof r.description === 'string' && r.description !== '' ? { description: r.description } : {}),
+        ...(typeof r.tokens === 'number' ? { tokens: r.tokens } : {}),
+        ...(typeof r.toolUses === 'number' ? { toolUses: r.toolUses } : {}),
+        ...(currentTool !== undefined ? { currentTool } : {}),
+    };
+}
+/** 纯组合:两源(各带三态健康位)→ BackgroundView。行序 = assistant 先(core 已按 triage 排,
+ *  消费方不再排)、fleet 后(帧到达序);非 'ok' 源的行不出(那份列表不是证词);sources 三态
+ *  恒在场 —— 源不可用/未配置与「空列表」是三件事,端必须渲它。 */
+export function projectBackgroundView(i) {
+    const rows = [];
+    if (i.assistant.health === 'ok') {
+        for (const t of i.assistant.tasks)
+            rows.push(assistantTaskToBackgroundRow(t));
+    }
+    if (i.fleet.health === 'ok') {
+        for (const r of i.fleet.tasks) {
+            const row = fleetTaskToBackgroundRow(r);
+            if (row !== null)
+                rows.push(row);
+        }
+    }
+    return {
+        sources: { assistant: i.assistant.health, fleet: i.fleet.health },
+        rows,
+    };
+}
+/** 501 判读走 errCodes 单源(SDK typed APIError 的 status;`statusCode` 变体同吃)。 */
+function isNotImplemented(err) {
+    const { status } = errCodes(err);
+    return status === 501;
+}
+function debugLog(msg) {
+    if (engineWireDebugEnabled())
+        hostLog('debug', `[client-core][backgroundView] ${msg}`);
+}
+/**
+ * createBackgroundView(client, opts?) — 后台任务归一视图(契约 `CreateBackgroundView`;第二参是
+ * 实现旋钮,可选参不缩窄契约形)。生命周期:构造即起后台轮询;`snapshot()` 首解析前 null;
+ * `subscribe` 解析即通知 + 订阅即对账;`dispose()` abort 在飞请求、停循环、清订阅。
+ */
+export function createBackgroundView(client, opts) {
+    const intervalMs = opts?.intervalMs ?? 2000;
+    let disposed = false;
+    let current = null;
+    let lastSerialized = null;
+    /** caps 探针结果:null = 还没探到/caps 面不可达(判别缺席);boolean = scheduler 位。 */
+    let capsScheduler = null;
+    const listeners = new Set();
+    const abort = new AbortController();
+    function notify() {
+        if (disposed)
+            return;
+        for (const l of [...listeners]) {
+            try {
+                l();
+            }
+            catch (err) {
+                debugLog(`subscriber threw (ignored): ${String(err)}`);
+            }
+        }
+    }
+    /** caps 只需探到一次;失败保持 null 下轮重试(caps 面挂 ≠ assistant 面挂,判别缺席不编造)。 */
+    async function probeCaps() {
+        if (capsScheduler !== null)
+            return;
+        try {
+            const caps = await client.capabilities({ signal: abort.signal });
+            capsScheduler = caps.scheduler === true;
+        }
+        catch (err) {
+            debugLog(`caps probe unavailable (scheduler 判别缺席,保持 ok 口径): ${String(err)}`);
+        }
+    }
+    async function pullAssistant() {
+        try {
+            const { tasks } = await client.assistant.tasks({ signal: abort.signal });
+            return { health: capsScheduler === false ? 'not-configured' : 'ok', tasks: tasks ?? [] };
+        }
+        catch (err) {
+            debugLog(`assistant.tasks degrade: ${String(err)}`);
+            const health = capsScheduler === false || isNotImplemented(err) ? 'not-configured' : 'unavailable';
+            return { health, tasks: [] };
+        }
+    }
+    async function pullFleet() {
+        try {
+            // G19 一次性快照 verb:SDK 内部开 SSE 流取首 snapshot 帧即断;abort.signal 直通 ⇒ dispose 能掐在飞连接。
+            const { tasks } = await client.fleet.snapshot({ signal: abort.signal });
+            return { health: 'ok', tasks: tasks ?? [] };
+        }
+        catch (err) {
+            debugLog(`fleet.snapshot degrade: ${String(err)}`);
+            return { health: isNotImplemented(err) ? 'not-configured' : 'unavailable', tasks: [] };
+        }
+    }
+    async function pollOnce() {
+        await probeCaps();
+        // 两源并行、各自 try/catch —— 独立拉取独立降级,一源挂另一源照常。
+        const [assistant, fleet] = await Promise.all([pullAssistant(), pullFleet()]);
+        if (disposed || abort.signal.aborted)
+            return;
+        current = projectBackgroundView({ assistant, fleet });
+        const serialized = JSON.stringify(current);
+        if (serialized !== lastSerialized) {
+            lastSerialized = serialized;
+            notify();
+        }
+    }
+    /** abort 感知的 sleep:dispose 立即唤醒并清定时器(不留悬挂 timer 拖住宿主进程)。 */
+    function sleep(ms) {
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                abort.signal.removeEventListener('abort', onAbort);
+                resolve();
+            }, ms);
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            abort.signal.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+    async function loop() {
+        while (!disposed && !abort.signal.aborted) {
+            try {
+                await pollOnce();
+            }
+            catch (err) {
+                // pullAssistant/pullFleet 各自兜底,这里只剩投影/通知的意外 —— 记录不外抛(本源绝不 throw 进宿主)。
+                debugLog(`poll cycle error (kept alive): ${String(err)}`);
+            }
+            if (disposed || abort.signal.aborted)
+                return;
+            await sleep(intervalMs);
+        }
+    }
+    void loop();
+    return {
+        snapshot() {
+            return current;
+        },
+        subscribe(onChange) {
+            listeners.add(onChange);
+            // 订阅即对账:订阅前已解析的话,notify 那一发已经打空 —— 同步补一发,宿主不用白等一个 tick。
+            if (current !== null && !disposed) {
+                try {
+                    onChange();
+                }
+                catch (err) {
+                    debugLog(`subscriber threw on reconcile (ignored): ${String(err)}`);
+                }
+            }
+            return () => {
+                listeners.delete(onChange);
+            };
+        },
+        dispose() {
+            disposed = true;
+            abort.abort();
+            listeners.clear();
+        },
+    };
+}
+// 契约锚(编译期钉):实现必须可赋给冻结契约形 —— 参数缩窄/返回面缺员在这里红,不等运行期。
+void createBackgroundView;

package/dist/agentSession/contract.d.ts

@@ -0,0 +1,152 @@
+/**
+ * design/161 — client-core 顶层单入口:**契约收敛物**(纯类型,零运行时;实现分批跟进)。
+ *
+ * 这是立项的唯一权威签名源(clay 三裁 2026-07-30 + 对抗复审 r1 收敛;两份文档签名互不相容的
+ * 教训 = 收敛物必须是 tsc 管得住的代码,见 sema-internal design-161-review-r1.md §〇)。
+ * 实现工单以本文件为锚:W1 per-session 化 → 入口实现 → W5 冷接 → 三端迁移(desktop → sema-web
+ * 聊天区 → web-client)。**本文件不进 index.ts barrel,实现落地一件出口一件。**
+ *
+ * ══ 三个入口,不是一个 ═══════════════════════════════════════════════════════════════════
+ * 1. `createAgentSession(config)` —— per-session 会话流面(AgentEvent → SDKMessage + HITL 桥 +
+ *    终态投影)。wire 只有一种:SDK 的 `AgentClientConfig` 判别联合(client/relay 本就是它的两臂,
+ *    r1 E3 —— 在这里再判一次就是复制 SDK)。
+ * 2. `attachSeatSession(seatApi)` —— 层 2 远程代理:座位(Electron renderer / web seat lane)侧
+ *    **没有 AgentEvent 流**(收到的已是 main 进程 adapt 后的 SDKMessage,seatContract:49-56),
+ *    所以它不是第三个 wire 臂,是层 1 返回面的**同型转发**(内部零 wire、零 adapt)。
+ * 3. `createBackgroundView(client)` —— 平行入口(clay 二裁 2026-07-30):`assistant.tasks` 与
+ *    `fleet` 都是**会话外读面**(assistant 跨 session;fleet 是 idle 壳唯一保持订阅的常驻 SSE),
+ *    生命周期不该绑在某个会话的 dispose() 上,所以归一投影不进 createAgentSession。
+ */
+import type { AgentClient, AgentClientConfig } from '@sema-agent/sdk';
+/**
+ * 已构造 client 的接入臂 **必须同时带构造参数** —— `AgentClient.config` 是 private
+ * (sdk client.d.ts:124),包拿不回 baseUrl/authToken/principal,而入口要用它们做四件事:
+ * caps 探针 kick ×2、task-agents wire 预备、durable 读面的 client 另建(planReview 同款)。
+ * 不带这三样的「裸 client」臂在 r1 E3-2 已证伪。
+ */
+export interface ProvidedClientWire {
+    readonly client: AgentClient;
+    readonly baseUrl: string;
+    readonly authToken: AgentClientConfig['authToken'];
+    readonly principal?: string;
+}
+/** wire 入参:给配置则入口自建 client;给 ProvidedClientWire 则复用宿主的(参数齐备)。 */
+export type AgentSessionWire = AgentClientConfig | ProvidedClientWire;
+export interface AgentSessionHostSurface {
+    /** 转录消费口(SDKMessage 流的宿主端)。缺席 ⇒ 入口拒绝启动(没有它整个入口无意义)。 */
+    onTranscript(msg: unknown): void;
+    /**
+     * chrome 装饰臂(seam.ts CHROME_ARMS 表)。缺席的 required 臂 = 功能静默不出现
+     * (desktop 今天缺 7/8,r1 E8c)——所以本口的自检是**表驱动**的:实现必须提供
+     * `chromeArmMisses()`,对 `required:true` 且未被消费的臂逐臂计数,门断言恒 0。
+     */
+    onChrome?(event: unknown): void;
+    /**
+     * 工具审批卡口。两条腿:
+     *   sync-frame 腿:缺席 ⇒ 主动 respond deny(现行为,保留);
+     *   durable-park 腿:缺席 ⇒ 🔴 **主动 decide deny + 一条诚实告知行**(行为变更,替换今天的
+     *     fail-stuck;candidates 见下方 OPEN-1 —— headless「留 park 待接手」场景是否豁免候 clay)。
+     */
+    approvalCard?: unknown;
+    /** AskUserQuestion overlay 口。durable 腿缺席后果同上(deny 语义 = respond 取消形)。 */
+    askQuestion?: unknown;
+    /**
+     * plan review 口。缺席 ⇒ 今天是「卡永不出现且静默」(planReviewWire.ts:77 fail-soft)——
+     * 改为:至少产出一条可见终态行(引擎在等,人必须知道)。卡的**皮肤归端**(desktop 的
+     * ExitPlanMode 权限卡形 vs cli 的 overlay 形都合法,包只出数据与决断口;OPEN-2)。
+     */
+    planReview?: unknown;
+    /** 通知队列口(缺席=计 miss,静默可接受 —— 引擎不等)。 */
+    notify?: unknown;
+    /** 后台任务转发口(会话自己流上的 task_notification / subagent_lifecycle;跨会话视图归 createBackgroundView)。 */
+    onBackgroundTask?(event: unknown): void;
+    /** 身份采集口(meta.taskId + done.result.sessionId;三端各写一份的第 5 缺口)。 */
+    onIdentity?(identity: AgentSessionIdentity): void;
+    /** 未知帧告警口(包内四层 default 静默的补偿;milestone 节流姿势收编 web-client frame-warnings)。 */
+    onUnknownFrame?(frame: unknown): void;
+    /** turn 级错误口(9 类 taxonomy + 状态码链 + wire-code 闭集表 —— 收编 web-client 三件套并接
+     *  controlRouter.errCodes 单源,r1 E7:不是「三分诊」)。 */
+    onTurnError?(err: unknown): void;
+}
+export interface AgentSessionIdentity {
+    readonly taskId?: string;
+    readonly engineSessionId?: string;
+}
+export interface AgentSessionConfig {
+    readonly wire: AgentSessionWire;
+    /** 请求车道(taskRequest.ts 的 RequestLane;web 传输 lane 是另一个轴,别混,r1 角度2)。 */
+    readonly lane: 'interactive' | 'print';
+    readonly hostSurface: AgentSessionHostSurface;
+    /**
+     * per-session 键(W1):包内单槽位全部改「sessionKey → 注册表」,零参旧 API = default-key
+     * 兼容层(cli 的 module-load 装配不动)。多会话宿主(desktop)每会话一键,互不顶盖。
+     */
+    readonly sessionKey?: string;
+}
+export interface AgentSession {
+    /** 发起一个 turn(内部:buildTaskRequest 唯一构造口 + runStream 内建去重 + HITL 桥)。 */
+    query(input: unknown): AsyncIterable<unknown>;
+    /**
+     * 冷接(W5,r1 E9):按调用方给的 id 接上一个**不是本进程发起**的在飞 run(页面刷新 / 桌面
+     * 重启 / 跨端接手)。与 query() 同一消费面;park 帧在冷接腿上同样可决断。
+     * 这是 sema-web stream-core 旧腿退役的前置能力 —— 没有它退役 = 删掉唯一的刷新恢复路径。
+     */
+    attach(target: {
+        taskId: string;
+        sessionId?: string;
+    }): AsyncIterable<unknown>;
+    interrupt(): Promise<void>;
+    steer(text: string): Promise<void>;
+    resumeAfterDecision(): Promise<void>;
+    /** 面缺席自检出口(测试面,恒 0 断言;不是运行期告警 —— Ink 吞 console,r1 E6)。 */
+    surfaceMisses(): Readonly<Record<string, number>>;
+    identity(): AgentSessionIdentity;
+    dispose(): void;
+}
+/** 层 1:唯一的 wire 入口。 */
+export type CreateAgentSession = (config: AgentSessionConfig) => AgentSession;
+/**
+ * 层 2:座位远程代理 —— 与 AgentSession **同型**(同一个接口),内部把每个方法转发给座位 IPC
+ * (seatContract 的 verb 面),零 wire 零 adapt。座位可达字段集是 9 键闭集(< interactive 的
+ * ~25 键)—— 该不对称必须**显式暴露**(supportedFields),端上的控件按它显隐,不许各自再判。
+ */
+export type AttachSeatSession = (seatApi: unknown) => AgentSession & {
+    readonly supportedFields: readonly string[];
+};
+export type BackgroundSource = 'assistant' | 'fleet';
+/** not-configured = assistant 无 TiDB 时的 `{tasks:[]}` 形 —— 与「真没有任务」必须可区分。 */
+export type BackgroundSourceHealth = 'ok' | 'unavailable' | 'not-configured';
+/** 第三套中性词表(不用任一方词表:3 值压不住 9 值,9 值会造 assistant 侧不存在的态)。 */
+export type BackgroundStatus = 'running' | 'waiting-on-human' | 'queued' | 'stopping' | 'done' | 'failed' | 'stopped';
+export interface BackgroundRow {
+    /** 带来源判别;fleet 复合 id("<runId> <taskId>")不拆 —— 裸 id union 会重复计数。 */
+    readonly key: {
+        readonly source: 'assistant';
+        readonly taskId: string;
+    } | {
+        readonly source: 'fleet';
+        readonly rowId: string;
+    };
+    readonly status: BackgroundStatus;
+    /** 统一 epoch ms;assistant 的 ISO 串只在边界转一次。 */
+    readonly updatedAtMs?: number;
+    readonly needsAttention?: boolean;
+    readonly name?: string;
+    readonly description?: string;
+    readonly parentId?: string;
+    readonly tokens?: number;
+    readonly toolUses?: number;
+    readonly currentTool?: string;
+    readonly gate?: unknown;
+}
+export interface BackgroundView {
+    /** 🔴 一等返回位,端必须渲它 —— 源不可用/未配置与「空列表」是三件事。 */
+    readonly sources: Readonly<Record<BackgroundSource, BackgroundSourceHealth>>;
+    /** fleet 子行(parentId 在场)不进跨 session 视图(子代不是用户的独立后台任务)。 */
+    readonly rows: readonly BackgroundRow[];
+}
+export type CreateBackgroundView = (client: AgentClient) => {
+    snapshot(): BackgroundView | null;
+    subscribe(onChange: () => void): () => void;
+    dispose(): void;
+};

package/dist/agentSession/contract.js

@@ -0,0 +1,13 @@
+export {};
+// ── 已裁定(clay 终裁 2026-07-31,档 sema-internal e2b874c;实现必须遵守)──────────────────────
+// RULED-1 durable park 腿面缺席 = **分形**:
+//   · 面「注册过但坏了」(卡口异常)→ 主动 decide deny + 诚实告知行(解锁优先);
+//   · 面「从未注册」(print/headless 本无卡口)→ 保留 park + 打印含 resume 指令的告知行
+//     (接手优先 —— headless 故意留 park 换 REPL/desktop 决断是合法场景)。
+//   🔴 附加不变式(clay 原话「danger 权限保证全部畅通即可」):bypassPermissions/danger 模式下
+//   审批链全程畅通 —— 零 park、零卡、零 deny,本缺席矩阵整表不适用;实现必带一条 danger-lane
+//   e2e 断言(danger 会话跑到审批点零停顿直通)。
+// RULED-2 plan review 卡形 = **皮肤归端**:包只出数据+决断口;desktop 保持 ExitPlanMode 权限
+//   卡形(CC 对位),cli 保持 overlay 形,不强制统一 UI。
+// OPEN-3(实现期):file_link / live elicitation 两条 wire 缺口先补进 adapt(E8a/E8b,
+//   elicitation 方向 = 把 desktop/web 那份**上交**成包件)。

package/dist/controlRouter.d.ts

@@ -189,3 +189,11 @@ export declare class ControlRouter {
     }): Promise<RunReceipt | null>;
     private nextId;
 }
+/** Read a normalized error code/status off any SDK error shape variant (errorCode / code / name / status).
+ *  design/161 批 A 起导出:错误判型单源 —— 包内新读面(backgroundView 等)一律吃这一口,不再各自手摸
+ *  `(e as any).status`。 */
+export declare function errCodes(e: unknown): {
+    code?: unknown;
+    name?: unknown;
+    status?: unknown;
+};

package/dist/controlRouter.js

@@ -214,8 +214,10 @@ function uuid() {
         return v.toString(16);
     });
 }
-/** Read a normalized error code/status off any SDK error shape variant (errorCode / code / name / status). */
-function errCodes(e) {
+/** Read a normalized error code/status off any SDK error shape variant (errorCode / code / name / status).
+ *  design/161 批 A 起导出:错误判型单源 —— 包内新读面(backgroundView 等)一律吃这一口,不再各自手摸
+ *  `(e as any).status`。 */
+export function errCodes(e) {
     if (!e || typeof e !== 'object')
         return {};
     const o = e;

package/dist/engineWireTarget.d.ts

@@ -5,10 +5,17 @@ export interface EngineWireTarget {
 }
 /** 装/卸引擎 wire 目标。传 null 卸回 env 派生。返回还原函数。 */
 export declare function installEngineWireTarget(t: EngineWireTarget | null): () => void;
+/** W1 带 key 变体:装/卸某会话的引擎 wire 目标(多会话宿主每会话一键,互不顶盖)。 */
+export declare function installEngineWireTargetFor(sessionKey: string, t: EngineWireTarget | null): () => void;
 /**
  * 当前引擎 wire 目标。null = 无 wire(离线/mock/浏览器未装)—— 调用方走各自的回落路径,
  * **不是**错误态。
  */
 export declare function engineWireTarget(): EngineWireTarget | null;
+/**
+ * W1 带 key 变体。env 派生回落是**进程级**(键无关):该键未显式装过 ⇒ 与零参同一条 env
+ * 回落路径(Node 壳单会话语义不变;浏览器宿主 env 恒空 ⇒ null)。
+ */
+export declare function engineWireTargetFor(sessionKey: string): EngineWireTarget | null;
 /** 诊断开关(壳侧 `process.env.SEMA_DEBUG` 的等价读;本包零 process)。 */
 export declare function engineWireDebugEnabled(): boolean;

package/dist/engineWireTarget.js

@@ -18,14 +18,20 @@
  *    ⚠️ web/桌面宿主要用这条 wire,**不能靠 env** —— 用 `installEngineWireTarget()` 显式装。
  */
 import { hostEnv } from './hostEnv.js';
-/** 显式装配(非 Node 宿主唯一的入口;装了就**优先于** env,便于桌面/web 一页多引擎)。 */
-let installed = null;
+import { createSessionSlot, DEFAULT_SESSION_KEY } from './sessionSlot.js';
+/** 显式装配(非 Node 宿主唯一的入口;装了就**优先于** env,便于桌面/web 一页多引擎)。
+ *  W1(design/161):sessionKey → 注册表;零参 API = DEFAULT_SESSION_KEY 兼容层。 */
+const installedByKey = createSessionSlot();
 /** 装/卸引擎 wire 目标。传 null 卸回 env 派生。返回还原函数。 */
 export function installEngineWireTarget(t) {
-    const prev = installed;
-    installed = t;
+    return installEngineWireTargetFor(DEFAULT_SESSION_KEY, t);
+}
+/** W1 带 key 变体:装/卸某会话的引擎 wire 目标(多会话宿主每会话一键,互不顶盖)。 */
+export function installEngineWireTargetFor(sessionKey, t) {
+    const prev = installedByKey.get(sessionKey);
+    installedByKey.set(sessionKey, t);
     return () => {
-        installed = prev;
+        installedByKey.set(sessionKey, prev);
     };
 }
 /**
@@ -33,6 +39,14 @@ export function installEngineWireTarget(t) {
  * **不是**错误态。
  */
 export function engineWireTarget() {
+    return engineWireTargetFor(DEFAULT_SESSION_KEY);
+}
+/**
+ * W1 带 key 变体。env 派生回落是**进程级**(键无关):该键未显式装过 ⇒ 与零参同一条 env
+ * 回落路径(Node 壳单会话语义不变;浏览器宿主 env 恒空 ⇒ null)。
+ */
+export function engineWireTargetFor(sessionKey) {
+    const installed = installedByKey.get(sessionKey) ?? null;
     if (installed !== null)
         return installed;
     const env = hostEnv();

package/dist/hitl/askGateWire.d.ts

@@ -77,8 +77,14 @@ export interface HitlHostSurface {
 }
 /** 装 HITL 宿主面(传 null 卸)。返回还原函数。 */
 export declare function installHitlHostSurface(surface: HitlHostSurface | null): () => void;
+/** W1 带 key 变体:装/卸某会话的 HITL 宿主面(多会话宿主每会话一键,互不顶盖)。 */
+export declare function installHitlHostSurfaceFor(sessionKey: string, surface: HitlHostSurface | null): () => void;
 /** 🔴 宿主自检:恒应为 0。非 0 = 有 HITL 副作用发生时口不在,那一行 warn / 那条记账丢了。 */
 export declare function hitlHostSurfaceMisses(): number;
+/** W1 带 key 变体(miss 计数逐键)。 */
+export declare function hitlHostSurfaceMissesFor(sessionKey: string): number;
+/** W1 读端:某会话的 HITL 宿主面(未装 = null;**不计 miss** —— miss 只在副作用真发生时计)。 */
+export declare function hitlHostSurfaceFor(sessionKey: string): HitlHostSurface | null;
 /** 测试钩:卸口 + 清计数。 */
 export declare function _resetHitlHostSurfaceForTest(): void;
 /**

package/dist/hitl/askGateWire.js

@@ -1,30 +1,46 @@
 import { HitlBridge } from './hitlBridge.js';
 import { publishQuestionFrame, registerLocalQuestionResponder, hasQuestionOverlay, } from '../liveQuestionStore.js';
 import { hostLog } from '../host.js';
+import { createSessionSlot, DEFAULT_SESSION_KEY } from '../sessionSlot.js';
 import { isFsApprovalGate, toolNameIsFsWrite, surfaceFsApprovalAndDecide, isToolApprovalFrame, isFromSubagent, surfaceToolApprovalFrameAndRespond, } from './toolApprovalWire.js';
 import { classifierDenyFromToolEnd } from '../classifierVerdictWire.js';
-let hostSurface = null;
-let hostSurfaceMisses = 0;
+// W1(design/161):sessionKey → 注册表;零参 API = DEFAULT_SESSION_KEY 兼容层(cli 装配不动)。
+const hostSurfaceByKey = createSessionSlot();
+const hostSurfaceMissesByKey = new Map();
 /** 装 HITL 宿主面(传 null 卸)。返回还原函数。 */
 export function installHitlHostSurface(surface) {
-    const prev = hostSurface;
-    hostSurface = surface;
+    return installHitlHostSurfaceFor(DEFAULT_SESSION_KEY, surface);
+}
+/** W1 带 key 变体:装/卸某会话的 HITL 宿主面(多会话宿主每会话一键,互不顶盖)。 */
+export function installHitlHostSurfaceFor(sessionKey, surface) {
+    const prev = hostSurfaceByKey.get(sessionKey);
+    hostSurfaceByKey.set(sessionKey, surface);
     return () => {
-        hostSurface = prev;
+        hostSurfaceByKey.set(sessionKey, prev);
     };
 }
 /** 🔴 宿主自检:恒应为 0。非 0 = 有 HITL 副作用发生时口不在,那一行 warn / 那条记账丢了。 */
 export function hitlHostSurfaceMisses() {
-    return hostSurfaceMisses;
+    return hitlHostSurfaceMissesFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体(miss 计数逐键)。 */
+export function hitlHostSurfaceMissesFor(sessionKey) {
+    return hostSurfaceMissesByKey.get(sessionKey) ?? 0;
+}
+/** W1 读端:某会话的 HITL 宿主面(未装 = null;**不计 miss** —— miss 只在副作用真发生时计)。 */
+export function hitlHostSurfaceFor(sessionKey) {
+    return hostSurfaceByKey.get(sessionKey) ?? null;
 }
 /** 测试钩:卸口 + 清计数。 */
 export function _resetHitlHostSurfaceForTest() {
-    hostSurface = null;
-    hostSurfaceMisses = 0;
+    hostSurfaceByKey.clear();
+    hostSurfaceMissesByKey.clear();
 }
 function surface() {
-    if (hostSurface === null)
-        hostSurfaceMisses++;
+    const hostSurface = hitlHostSurfaceFor(DEFAULT_SESSION_KEY);
+    if (hostSurface === null) {
+        hostSurfaceMissesByKey.set(DEFAULT_SESSION_KEY, (hostSurfaceMissesByKey.get(DEFAULT_SESSION_KEY) ?? 0) + 1);
+    }
     return hostSurface;
 }
 /**

package/dist/hitl/toolApprovalWire.d.ts

@@ -61,10 +61,18 @@ export interface ApprovalCardRequest {
 export type ApprovalCardPort = (req: ApprovalCardRequest) => Promise<ApprovalCardDecision>;
 /** 装卡口(传 null 卸)。返回还原函数。 */
 export declare function installApprovalCardPort(port: ApprovalCardPort | null): () => void;
+/** W1 带 key 变体:装/卸某会话的卡口(多会话宿主每会话一键,互不顶盖)。 */
+export declare function installApprovalCardPortFor(sessionKey: string, port: ApprovalCardPort | null): () => void;
 /** 🔴 宿主自检:恒应为 0。非 0 = 有 gate 到达时卡口不在,那次审批走了 fail-closed 路径。 */
 export declare function approvalCardPortMisses(): number;
+/** W1 带 key 变体(miss 计数逐键)。 */
+export declare function approvalCardPortMissesFor(sessionKey: string): number;
 /** 卡口在不在(壳原文 `getLeaderToolUseConfirmQueue()` 那个存在性判据的等价物)。 */
 export declare function hasApprovalCardPort(): boolean;
+/** W1 带 key 变体。 */
+export declare function hasApprovalCardPortFor(sessionKey: string): boolean;
+/** W1 读端:某会话的卡口(未装 = null;**不计 miss** —— miss 只在决断腿真到达时计)。 */
+export declare function approvalCardPortFor(sessionKey: string): ApprovalCardPort | null;
 /** 测试钩:卸口 + 清计数(只卸口不清计数会让「未装配时 misses 为 0」的断言恒假 —— host.ts 同款教训)。 */
 export declare function _resetApprovalCardPortForTest(): void;
 /**

package/dist/hitl/toolApprovalWire.js

@@ -1,5 +1,6 @@
 import { HitlBridge } from './hitlBridge.js';
 import { hostLog } from '../host.js';
+import { createSessionSlot, DEFAULT_SESSION_KEY } from '../sessionSlot.js';
 import { readEngineActiveBgTasks } from '../fleet/fleetLedger.js';
 /** fs 写权限 gate 判定:未来的一等 kind(tool_approval)或按 toolName(server 桥首批=fs 写三件,
  *  [820] 表)。AskUserQuestion 永不进这里(ask 桥先判)。 */
@@ -36,28 +37,48 @@ export function structurallyEqual(a, b) {
         return false;
     return ka.every(k => structurallyEqual(a[k], b[k]));
 }
-let cardPort = null;
-let cardPortMisses = 0;
+// W1(design/161):sessionKey → 注册表;零参 API = DEFAULT_SESSION_KEY 兼容层(cli 装配不动)。
+const cardPortByKey = createSessionSlot();
+const cardPortMissesByKey = new Map();
+function bumpCardPortMiss(sessionKey) {
+    cardPortMissesByKey.set(sessionKey, (cardPortMissesByKey.get(sessionKey) ?? 0) + 1);
+}
 /** 装卡口(传 null 卸)。返回还原函数。 */
 export function installApprovalCardPort(port) {
-    const prev = cardPort;
-    cardPort = port;
+    return installApprovalCardPortFor(DEFAULT_SESSION_KEY, port);
+}
+/** W1 带 key 变体:装/卸某会话的卡口(多会话宿主每会话一键,互不顶盖)。 */
+export function installApprovalCardPortFor(sessionKey, port) {
+    const prev = cardPortByKey.get(sessionKey);
+    cardPortByKey.set(sessionKey, port);
     return () => {
-        cardPort = prev;
+        cardPortByKey.set(sessionKey, prev);
     };
 }
 /** 🔴 宿主自检:恒应为 0。非 0 = 有 gate 到达时卡口不在,那次审批走了 fail-closed 路径。 */
 export function approvalCardPortMisses() {
-    return cardPortMisses;
+    return approvalCardPortMissesFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体(miss 计数逐键)。 */
+export function approvalCardPortMissesFor(sessionKey) {
+    return cardPortMissesByKey.get(sessionKey) ?? 0;
 }
 /** 卡口在不在(壳原文 `getLeaderToolUseConfirmQueue()` 那个存在性判据的等价物)。 */
 export function hasApprovalCardPort() {
-    return cardPort !== null;
+    return hasApprovalCardPortFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体。 */
+export function hasApprovalCardPortFor(sessionKey) {
+    return approvalCardPortFor(sessionKey) !== null;
+}
+/** W1 读端:某会话的卡口(未装 = null;**不计 miss** —— miss 只在决断腿真到达时计)。 */
+export function approvalCardPortFor(sessionKey) {
+    return cardPortByKey.get(sessionKey) ?? null;
 }
 /** 测试钩:卸口 + 清计数(只卸口不清计数会让「未装配时 misses 为 0」的断言恒假 —— host.ts 同款教训)。 */
 export function _resetApprovalCardPortForTest() {
-    cardPort = null;
-    cardPortMisses = 0;
+    cardPortByKey.clear();
+    cardPortMissesByKey.clear();
 }
 /**
  * 共享卡面:弹 vendored CC 三选卡(PermissionRequest)→ 等用户决断。两条腿共用:
@@ -67,8 +88,9 @@ export function _resetApprovalCardPortForTest() {
  * (accept-session 升 intent,[816] 壳侧承诺② —— 与决断通道无关,两腿都要)由**宿主卡口**做。
  */
 export function surfaceApprovalCard(req) {
+    const cardPort = approvalCardPortFor(DEFAULT_SESSION_KEY);
     if (cardPort === null) {
-        cardPortMisses++;
+        bumpCardPortMiss(DEFAULT_SESSION_KEY);
         return Promise.resolve({
             kind: 'failed',
             reason: 'no approval card port installed (print/non-REPL mode, or host forgot installApprovalCardPort)',
@@ -85,7 +107,7 @@ export function surfaceApprovalCard(req) {
  */
 export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signal) {
     if (!hasApprovalCardPort()) {
-        cardPortMisses++;
+        bumpCardPortMiss(DEFAULT_SESSION_KEY);
         return { kind: 'failed', reason: 'no approval card port installed (print/non-REPL mode)' };
     }
     // pending 行 = gate 的权威源 + D-1 绑定 surface(与 ask 桥同姿势)。

package/dist/host.d.ts

@@ -96,23 +96,39 @@ export interface HostPorts {
  * 返回一个还原函数(测试/热重载用)。
  */
 export declare function installHost(ports: HostPorts): () => void;
+/**
+ * W1 带 key 变体:装配某会话的宿主口(多会话宿主每会话一键,互不顶盖;合并语义与零参同)。
+ * ⚠️ 入参不含 `queue` —— 通知队列在 W1 仍是包级单例(notifications.ts 不在五槽位切口内),
+ * per-session 队列归后续工单;要装队列走零参 `installHost({ queue })`。
+ */
+export declare function installHostFor(sessionKey: string, ports: Omit<HostPorts, 'queue'>): () => void;
 /** 日志(缺席 = 静默,**不计 miss**:诊断面本就是可选的)。 */
 export declare function hostLog(level: AdapterLogLevel, msg: string, data?: unknown): void;
 /** 行式探针(缺席 = 静默,不计 miss:同上)。 */
 export declare function hostProbe(channel: string, line: string): void;
 /** settings 口(缺席 = undefined + 计 miss:漏装会让 hooks 整条 wire 静默空掉)。 */
 export declare function hostSettings(): SettingsPort | undefined;
+/** W1 带 key 变体(缺席语义与零参同:undefined + 计该键 miss)。 */
+export declare function hostSettingsFor(sessionKey: string): SettingsPort | undefined;
 /** fs 口(缺席 = undefined + 计 miss)。 */
 export declare function hostFs(): FsPort | undefined;
+/** W1 带 key 变体。 */
+export declare function hostFsFor(sessionKey: string): FsPort | undefined;
 /** 定时器口(缺席 = undefined,不计 miss:T40 竞速本就允许不启用)。 */
 export declare function hostTimers(): TimersPort | undefined;
+/** W1 带 key 变体(同零参:不计 miss)。 */
+export declare function hostTimersFor(sessionKey: string): TimersPort | undefined;
 /** session 口(缺席 = undefined + 计 miss:漏装会让整条 durable 子代读面 404 静默哑掉)。 */
 export declare function hostSession(): SessionPort | undefined;
+/** W1 带 key 变体。 */
+export declare function hostSessionFor(sessionKey: string): SessionPort | undefined;
 /**
  * 🔴 宿主自检出口 —— 恒应为空对象。非空 = 有口漏装,**对应的面已经在静默失效**。
  * 含通知队列的 miss(从 notifications.ts 汇过来,宿主只需看这一个数)。
  */
 export declare function hostPortMisses(): Record<string, number>;
+/** W1 带 key 变体。⚠️ 通知队列是包级单例,其 miss 只折进 DEFAULT_SESSION_KEY 键的视图。 */
+export declare function hostPortMissesFor(sessionKey: string): Record<string, number>;
 /**
  * 测试钩:清空装配与计数。
  * 🔴 队列那一路必须走 `_resetNotificationQueuePortForTest()` 而不是 `installNotificationQueuePort(null)`

package/dist/host.js

@@ -1,11 +1,19 @@
+import { DEFAULT_SESSION_KEY } from './sessionSlot.js';
 import { _resetNotificationQueuePortForTest, installNotificationQueuePort, notificationQueuePortMisses, } from './notifications.js';
-let host = {};
-const misses = Object.create(null);
-const warned = new Set();
-function miss(name) {
-    misses[name] = (misses[name] ?? 0) + 1;
-    if (!warned.has(name)) {
-        warned.add(name);
+const hostByKey = new Map();
+function hostSlot(sessionKey) {
+    let slot = hostByKey.get(sessionKey);
+    if (!slot) {
+        slot = { state: {}, misses: Object.create(null), warned: new Set() };
+        hostByKey.set(sessionKey, slot);
+    }
+    return slot;
+}
+function miss(sessionKey, name) {
+    const slot = hostSlot(sessionKey);
+    slot.misses[name] = (slot.misses[name] ?? 0) + 1;
+    if (!slot.warned.has(name)) {
+        slot.warned.add(name);
         // eslint-disable-next-line no-console
         console.error(`[client-core] host port "${name}" NOT installed — the surface it drives is silently inert. ` +
             'Host must call installHost({ ' +
@@ -21,58 +29,90 @@ function miss(name) {
  * 返回一个还原函数(测试/热重载用)。
  */
 export function installHost(ports) {
-    const prev = { ...host };
+    const restore = installHostFor(DEFAULT_SESSION_KEY, ports);
+    if ('queue' in ports)
+        installNotificationQueuePort(ports.queue ?? null);
+    return restore;
+}
+/**
+ * W1 带 key 变体:装配某会话的宿主口(多会话宿主每会话一键,互不顶盖;合并语义与零参同)。
+ * ⚠️ 入参不含 `queue` —— 通知队列在 W1 仍是包级单例(notifications.ts 不在五槽位切口内),
+ * per-session 队列归后续工单;要装队列走零参 `installHost({ queue })`。
+ */
+export function installHostFor(sessionKey, ports) {
+    const slot = hostSlot(sessionKey);
+    const prev = { ...slot.state };
     if ('log' in ports)
-        host.log = ports.log;
+        slot.state.log = ports.log;
     if ('probe' in ports)
-        host.probe = ports.probe;
+        slot.state.probe = ports.probe;
     if ('timers' in ports)
-        host.timers = ports.timers;
+        slot.state.timers = ports.timers;
     if ('settings' in ports)
-        host.settings = ports.settings;
+        slot.state.settings = ports.settings;
     if ('fs' in ports)
-        host.fs = ports.fs;
+        slot.state.fs = ports.fs;
     if ('session' in ports)
-        host.session = ports.session;
-    if ('queue' in ports)
-        installNotificationQueuePort(ports.queue ?? null);
+        slot.state.session = ports.session;
     return () => {
-        host = prev;
+        slot.state = prev;
     };
 }
 /** 日志(缺席 = 静默,**不计 miss**:诊断面本就是可选的)。 */
 export function hostLog(level, msg, data) {
-    host.log?.(level, msg, data);
+    hostSlot(DEFAULT_SESSION_KEY).state.log?.(level, msg, data);
 }
 /** 行式探针(缺席 = 静默,不计 miss:同上)。 */
 export function hostProbe(channel, line) {
-    host.probe?.(channel, line);
+    hostSlot(DEFAULT_SESSION_KEY).state.probe?.(channel, line);
 }
 /** settings 口(缺席 = undefined + 计 miss:漏装会让 hooks 整条 wire 静默空掉)。 */
 export function hostSettings() {
-    return host.settings ?? miss('settings');
+    return hostSettingsFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体(缺席语义与零参同:undefined + 计该键 miss)。 */
+export function hostSettingsFor(sessionKey) {
+    return hostSlot(sessionKey).state.settings ?? miss(sessionKey, 'settings');
 }
 /** fs 口(缺席 = undefined + 计 miss)。 */
 export function hostFs() {
-    return host.fs ?? miss('fs');
+    return hostFsFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体。 */
+export function hostFsFor(sessionKey) {
+    return hostSlot(sessionKey).state.fs ?? miss(sessionKey, 'fs');
 }
 /** 定时器口(缺席 = undefined,不计 miss:T40 竞速本就允许不启用)。 */
 export function hostTimers() {
-    return host.timers;
+    return hostTimersFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体(同零参:不计 miss)。 */
+export function hostTimersFor(sessionKey) {
+    return hostSlot(sessionKey).state.timers;
 }
 /** session 口(缺席 = undefined + 计 miss:漏装会让整条 durable 子代读面 404 静默哑掉)。 */
 export function hostSession() {
-    return host.session ?? miss('session');
+    return hostSessionFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体。 */
+export function hostSessionFor(sessionKey) {
+    return hostSlot(sessionKey).state.session ?? miss(sessionKey, 'session');
 }
 /**
  * 🔴 宿主自检出口 —— 恒应为空对象。非空 = 有口漏装,**对应的面已经在静默失效**。
  * 含通知队列的 miss(从 notifications.ts 汇过来,宿主只需看这一个数)。
  */
 export function hostPortMisses() {
-    const out = { ...misses };
-    const q = notificationQueuePortMisses();
-    if (q > 0)
-        out.queue = q;
+    return hostPortMissesFor(DEFAULT_SESSION_KEY);
+}
+/** W1 带 key 变体。⚠️ 通知队列是包级单例,其 miss 只折进 DEFAULT_SESSION_KEY 键的视图。 */
+export function hostPortMissesFor(sessionKey) {
+    const out = { ...hostSlot(sessionKey).misses };
+    if (sessionKey === DEFAULT_SESSION_KEY) {
+        const q = notificationQueuePortMisses();
+        if (q > 0)
+            out.queue = q;
+    }
     return out;
 }
 /**
@@ -82,9 +122,6 @@ export function hostPortMisses() {
  * 让「未装配时 misses 为空」这类断言恒假(B4 首写时就撞上了)。
  */
 export function _resetHostForTest() {
-    host = {};
-    for (const k of Object.keys(misses))
-        delete misses[k];
-    warned.clear();
+    hostByKey.clear();
     _resetNotificationQueuePortForTest();
 }

package/dist/index.d.ts

@@ -182,6 +182,7 @@ export * from './adapter/runStream.js';
 export * from './request/taskRequest.js';
 export * from './clientSlice.js';
 export * from './host.js';
+export { DEFAULT_SESSION_KEY } from './sessionSlot.js';
 export * from './scratchpadWireCaps.js';
 export * from './toolResult.js';
 export * from './diff/patch.js';
@@ -217,3 +218,5 @@ export * from './hitl/approvalsFeed.js';
 export * from './compensations.js';
 export * from './request/printNotification.js';
 export * from './seatContract.js';
+export * from './agentSession/contract.js';
+export * from './agentSession/backgroundView.js';

package/dist/index.js

@@ -197,6 +197,10 @@ export * from './clientSlice.js';
 // 包级宿主装配(per-turn 的 AdapterContext 之外的那一层:settings / fs / queue / timers)。
 // 🔴 `installNotificationQueuePort` 仍是队列的真源出口,`installHost({queue})` 只是直通它。
 export * from './host.js';
+// W1(design/161):五个模块级单槽位的 per-session 注册表键。零参旧 API 全部等价于用这个键调
+// `*For(sessionKey, …)` 变体;多会话宿主(desktop)每会话一键。`createSessionSlot` 是包内实现件,
+// 刻意不出 barrel(公面只承诺键与各槽位的 *For API)。
+export { DEFAULT_SESSION_KEY } from './sessionSlot.js';
 // B2 判给 B4 的宿主耦合件之一(小的那件,同时是 FsPort 的端到端证明)。
 export * from './scratchpadWireCaps.js';
 // ── B5 批:工具结果卡 B/D/E 层 + T20 客户端 diff(2026-07-27)────────────────────────────────
@@ -290,3 +294,11 @@ export * from './request/printNotification.js';
 //    → `LOCAL_SESSIONS_SPEC` 键集(run-seat-contract-keys-test 运行期对账)。加 verb 忘了加 SPEC
 //    的后果不是报错而是 preload 不注册 channel、渲染端读到 undefined(假 affordance 家族)。
 export * from './seatContract.js';
+// ── design/161 实现批 A:后台任务归一视图平行入口(2026-07-30)────────────────────────────────
+// 契约收敛物 contract.ts 随首件实现落地转正常出口(「实现落地一件出口一件」——
+// createBackgroundView 是第一件;portability 门 TYPE_ONLY_MODULES 同批摘除该登记)。
+// contract.ts 仍是纯类型零运行时,`export *` 在 dist 里是空转发 —— 类型面从此进公面。
+export * from './agentSession/contract.js';
+// 两源(assistant.tasks 跨 session 调度总览 + fleet 常驻 SSE 快照)独立拉取独立降级的归一投影;
+// 两张 status 映射表 never 卫兵穷举;'not-configured' 判别姿势见文件头注。
+export * from './agentSession/backgroundView.js';

package/dist/liveQuestionStore.d.ts

@@ -1,8 +1,3 @@
-/**
- * ⇄ B1 批搬迁(2026-07-27,多端改造设计稿 §2.4.1-B):cli src/sema/liveQuestionStore.ts 逐字搬入(零依赖;壳侧改 re-export)。
- * 本模块自持 AskUserQuestion 的 wire 词汇(SDK 0.0.44 删掉了 questions 资源导出),搬入后这套
- * 类型随包发布 —— web/桌面端的 HITL 覆盖层与 TUI 共用同一份 QuestionFrame/QuestionAnswer 形。
- */
 /**
  * src/sema/liveQuestionStore.ts — the SIDE-CHANNEL for §4④ live-stream AskUserQuestion (the conversation-seam
  * twin of liveSessionStore.ts).
@@ -80,11 +75,18 @@ export declare function registerLocalQuestionResponder(id: string, fn: RespondFn
  * break the live stream drain (the run must keep flowing; a lost frame just headless-defaults the ask).
  */
 export declare function publishQuestionFrame(frame: QuestionFrame): void;
+/** W1 keyed variant: publish to ONE session's overlay (multi-session hosts demux by their own key). */
+export declare function publishQuestionFrameFor(sessionKey: string, frame: QuestionFrame): void;
 /** Whether a UI overlay is currently subscribed (liveHitlAskWire gates on this: print/non-REPL mode has no
  *  dialog to park on, so the suspended terminal must fall through honestly instead of hanging the stream). */
 export declare function hasQuestionOverlay(): boolean;
+/** W1 keyed variant. */
+export declare function hasQuestionOverlayFor(sessionKey: string): boolean;
 /** Subscribe the UI overlay to live question frames. Returns an unsubscribe. Last writer wins (one overlay). */
 export declare function onQuestionFrame(handler: QuestionFrameHandler): () => void;
+/** W1 keyed variant: one overlay PER sessionKey (last writer wins within a key; keys never clobber
+ *  each other — the r1 E2 dual-session hazard this registry exists to close). */
+export declare function onQuestionFrameFor(sessionKey: string, handler: QuestionFrameHandler): () => void;
 /** Publish the live client's `questions.respond` binding (called from createLiveConversationClient). `null`
  *  clears it (offline/mock → respondToQuestion rejects cleanly). */
 export declare function setQuestionRespond(fn: RespondFn | null): void;

package/dist/liveQuestionStore.js

@@ -3,43 +3,10 @@
  * 本模块自持 AskUserQuestion 的 wire 词汇(SDK 0.0.44 删掉了 questions 资源导出),搬入后这套
  * 类型随包发布 —— web/桌面端的 HITL 覆盖层与 TUI 共用同一份 QuestionFrame/QuestionAnswer 形。
  */
-/**
- * src/sema/liveQuestionStore.ts — the SIDE-CHANNEL for §4④ live-stream AskUserQuestion (the conversation-seam
- * twin of liveSessionStore.ts).
- *
- * WHY THIS EXISTS
- * ---------------
- * In TOC (two-process) the MODEL runs in the engine; its `AskUserQuestion` tool fires on core's
- * `RunnerDeps.onQuestion` seam and the service (question.ts, 1.61.0) emits a NAMED SSE frame
- * (`event: question` / `event: question_complete`) that INTERLEAVES on the same live token stream as the
- * AgentEvents. That frame is NOT an AgentEvent arm (it is a DISTINCT vocabulary, exactly like elicitation) —
- * so it must be DEMUXED out of the transcript-render pipeline and routed to an interactive DIALOG overlay
- * instead. This tiny, dependency-FREE module is that route: liveClient WRITES the demuxed frame here (on each
- * `question`/`question_complete`) and publishes its `client.questions.respond` binding; the UI overlay
- * (main.tsx / REPL) READS the frames and answers via `respondToQuestion`. Same shape as liveSessionStore /
- * rewindAnchorStore — the overlay stays testable (no @sema-ai/sdk graph) and seamQuery/normalizeToolNames are
- * untouched.
- *
- * 🔴 LIVE-ONLY + SAME-REPLICA (the `steer()`-class of HITL): the service parks the answer promise in-memory,
- * so a respond that lands after the TTL (5 min) / after answer / on another replica → 404. No durable resume
- * anchor — a mid-question disconnect just lets the run proceed with the headless default (the model never
- * hangs). The overlay must therefore treat `respondToQuestion` as best-effort (a 404 = "already released",
- * dismiss the dialog, never retry).
- *
- * 🔴 UNTRUSTED: the `questions` payload is model-authored (service secret-redacted, but still UNTRUSTED for
- * display). The overlay RENDERS it; it must NEVER be re-fed to a model. The answer the overlay sends back is
- * fenced by CORE (`selected ⊆ options`, `note` untrusted-fenced) — the overlay must echo the EXACT option
- * labels the user saw, never fabricate one.
- */
-/* ── LOCAL wire types (owned HERE, not @sema-ai/sdk) ─────────────────────────────────────────────
- * SDK 0.0.44 DELETED the `questions` resource (engine 1.163 parks the run `suspended` instead of
- * emitting `question` SSE frames — see liveHitlAskWire.ts), and with it the QuestionFrame /
- * QuestionAnswer / AskQuestion exports. The shell still speaks this vocabulary INTERNALLY (synthetic
- * frames from liveHitlAskWire / planReviewWire + the legacy 1.61-era SSE demux in liveClient), so the
- * types now live in THIS dependency-free module — the store this whole seam already routes through.
- * Shapes are the ones the shell actually produces/consumes (askq-wire-probe + overlay usage), byte-
- * compatible with the old wire payload `{type,questionId,questions?,outcome?}`. */
-let frameHandler = null;
+import { createSessionSlot, DEFAULT_SESSION_KEY } from './sessionSlot.js';
+// W1(design/161):frameHandler 槽位改 sessionKey → 注册表;零参 API = DEFAULT_SESSION_KEY
+// 兼容层(cli 装配不动)。respondFn / localResponders 不在 W1 五槽位切口内,维持原样。
+const frameHandlerByKey = createSessionSlot();
 let respondFn = null;
 /** SHELL-LOCAL question responders (plan-review approval cards etc. — synthetic frames whose id does
  *  NOT exist engine-side, so POST /v1/questions/:id/respond would 404). Registered per-questionId by
@@ -59,6 +26,11 @@ export function registerLocalQuestionResponder(id, fn) {
  * break the live stream drain (the run must keep flowing; a lost frame just headless-defaults the ask).
  */
 export function publishQuestionFrame(frame) {
+    publishQuestionFrameFor(DEFAULT_SESSION_KEY, frame);
+}
+/** W1 keyed variant: publish to ONE session's overlay (multi-session hosts demux by their own key). */
+export function publishQuestionFrameFor(sessionKey, frame) {
+    const frameHandler = frameHandlerByKey.get(sessionKey);
     if (!frameHandler)
         return;
     try {
@@ -71,14 +43,23 @@ export function publishQuestionFrame(frame) {
 /** Whether a UI overlay is currently subscribed (liveHitlAskWire gates on this: print/non-REPL mode has no
  *  dialog to park on, so the suspended terminal must fall through honestly instead of hanging the stream). */
 export function hasQuestionOverlay() {
-    return frameHandler !== null;
+    return hasQuestionOverlayFor(DEFAULT_SESSION_KEY);
+}
+/** W1 keyed variant. */
+export function hasQuestionOverlayFor(sessionKey) {
+    return frameHandlerByKey.get(sessionKey) !== undefined;
 }
 /** Subscribe the UI overlay to live question frames. Returns an unsubscribe. Last writer wins (one overlay). */
 export function onQuestionFrame(handler) {
-    frameHandler = handler;
+    return onQuestionFrameFor(DEFAULT_SESSION_KEY, handler);
+}
+/** W1 keyed variant: one overlay PER sessionKey (last writer wins within a key; keys never clobber
+ *  each other — the r1 E2 dual-session hazard this registry exists to close). */
+export function onQuestionFrameFor(sessionKey, handler) {
+    frameHandlerByKey.set(sessionKey, handler);
     return () => {
-        if (frameHandler === handler)
-            frameHandler = null;
+        if (frameHandlerByKey.get(sessionKey) === handler)
+            frameHandlerByKey.set(sessionKey, undefined);
     };
 }
 /** Publish the live client's `questions.respond` binding (called from createLiveConversationClient). `null`
@@ -104,6 +85,6 @@ export function respondToQuestion(id, answer, opts) {
 }
 /** Test-only reset. */
 export function _resetLiveQuestionStore() {
-    frameHandler = null;
+    frameHandlerByKey.clear();
     respondFn = null;
 }

package/dist/request/taskRequest.d.ts

@@ -81,6 +81,8 @@ export interface TaskRequestInput {
     attachments?: Record<string, unknown>;
     /** 预上传附件句柄(`uploadAttachment` 回执 id)。空数组 = 没带附件 ⇒ 整键不 stamp。 */
     attachmentIds?: readonly string[];
+    /** 排除工具名单(SDK 真 wire 键;desktop 座位面在发)。空数组 = 不排除 ⇒ 整键不 stamp。 */
+    excludeTools?: readonly string[];
     finalVerification?: boolean;
     limits?: Record<string, unknown>;
     interactiveTools?: false;

package/dist/request/taskRequest.js

@@ -34,6 +34,7 @@ export const REQUEST_FIELD_MATRIX = [
     //    B4 从壳的三个构造器逐行读出来的,那时这条车道只有壳一个消费者。`attachmentIds` 是**反过来**
     //    的第一条:它今天只有 web/desktop 在发,壳反而没有这个入口。别把本节读成「壳独有」。
     { field: 'attachmentIds', lanes: ['interactive'], live: true, why: '附件**字节通道**(uploadAttachment 回执 id;server ≥1.289 绑定会话并把文件物化进 run 的 attachments/)。有上传入口的端才有 id 可引用:web/desktop 有,壳走 images / 本地文件路径,`-p` 车道连 uploadAttachment 都没有 ⇒ print 缺席是**没有来源**,不是漏。🔴 与上面的 `attachments` 同名不同物(那是 turn 边界的配置键),两条永远不许合并' },
+    { field: 'excludeTools', lanes: ['interactive'], live: true, why: 'design/161 W3(2026-07-30):真 wire 键(SDK types `excludeTools`)且早在 seatContract `START_SESSION_OPTION_KEYS` 里,却是 desktop 手写 taskReq 的第 9 键、矩阵外——而 stamp 门对未登记键**静默丢弃**,真实危险形=「用户显式排除的工具被静默放回」(权限方向回归,类型层不报)。今天只有 desktop 在发;壳的工具面走 roster/interactiveTools 另一条路,print 无排除入口' },
     { field: 'settings.ultracode', lanes: ['interactive'], live: true, why: 'design/111:sticky `/effort ultracode` 拨盘 + 当轮关键词嗅探,两个来源都只在交互面存在', gap: true },
     { field: 'systemPrompt', lanes: ['interactive'], live: false, why: 'CC QueryParams.systemPrompt;print 腿的 params 没有这一位' },
     { field: 'reasoningEffort', lanes: ['interactive'], live: false, why: '`/effort` 拨盘存在 AppState,print 无 AppState', gap: true },
@@ -115,6 +116,10 @@ export function buildTaskRequest(input, lane) {
         ...(on('attachmentIds', input.attachmentIds) && (input.attachmentIds?.length ?? 0) > 0
             ? { attachmentIds: [...(input.attachmentIds ?? [])] }
             : {}),
+        // 同款空数组语义:「不排除任何工具」不 stamp(缺席与空排除在 wire 上等价,发小的那个)。
+        ...(on('excludeTools', input.excludeTools) && (input.excludeTools?.length ?? 0) > 0
+            ? { excludeTools: [...(input.excludeTools ?? [])] }
+            : {}),
         ...(on('clientContext', input.clientContext) ? { clientContext: input.clientContext } : {}),
         ...(on('scratchpadDir', input.scratchpadDir) ? { scratchpadDir: input.scratchpadDir } : {}),
         ...(on('finalVerification', input.finalVerification)

package/dist/sessionSlot.d.ts

@@ -0,0 +1,26 @@
+/**
+ * sessionSlot.ts — W1(design/161):包内「模块级可变单槽位」的 per-session 注册表最小工厂。
+ *
+ * 背景(design/161 复审 r1 E2):包内五个模块级单槽位(host.ts `host` / askGateWire
+ * `hostSurface` / toolApprovalWire `cardPort` / liveQuestionStore `frameHandler` /
+ * engineWireTarget `installed`)与多会话宿主(desktop)正面冲突 —— 两个并行会话互相顶盖
+ * (A 会话的审批卡弹到 B 的面上 / B 的 responder 覆盖 A 的)。W1 把这五个槽位改成
+ * `Map<sessionKey, T>` 注册表:
+ *   · **零参旧 API = DEFAULT_SESSION_KEY 兼容层**(cli 的 module-load 装配一行不动,
+ *     default 键路径与改前单变量行为逐字节等价);
+ *   · 带 key 的 `*For(sessionKey, …)` 变体给多会话宿主用,每会话一键,互不顶盖。
+ * 契约锚 = `agentSession/contract.ts` 的 `AgentSessionConfig.sessionKey`。
+ *
+ * 🔴 本文件只管「存取」,不带任何业务语义 —— miss 计数、fail-soft 文言、还原/合并语义都留在
+ * 各槽位模块里(五个槽位形状略异,强行归一就是过度设计)。
+ */
+/** 零参旧 API 的兼容键(cli 单会话装配走它;多会话宿主每会话一键,别用这个值当会话 id)。 */
+export declare const DEFAULT_SESSION_KEY = "__default__";
+/** per-session 槽位存取面。`get` 未装过 = undefined(各槽位模块自己 `?? null` 归一)。 */
+export interface SessionSlot<T> {
+    get(key: string): T | undefined;
+    /** `undefined` = 卸下该键(与「从未装过」同态 —— 槽位模块的 prev-还原语义靠它闭合)。 */
+    set(key: string, value: T | undefined): void;
+    clear(): void;
+}
+export declare function createSessionSlot<T>(): SessionSlot<T>;

package/dist/sessionSlot.js

@@ -0,0 +1,31 @@
+/**
+ * sessionSlot.ts — W1(design/161):包内「模块级可变单槽位」的 per-session 注册表最小工厂。
+ *
+ * 背景(design/161 复审 r1 E2):包内五个模块级单槽位(host.ts `host` / askGateWire
+ * `hostSurface` / toolApprovalWire `cardPort` / liveQuestionStore `frameHandler` /
+ * engineWireTarget `installed`)与多会话宿主(desktop)正面冲突 —— 两个并行会话互相顶盖
+ * (A 会话的审批卡弹到 B 的面上 / B 的 responder 覆盖 A 的)。W1 把这五个槽位改成
+ * `Map<sessionKey, T>` 注册表:
+ *   · **零参旧 API = DEFAULT_SESSION_KEY 兼容层**(cli 的 module-load 装配一行不动,
+ *     default 键路径与改前单变量行为逐字节等价);
+ *   · 带 key 的 `*For(sessionKey, …)` 变体给多会话宿主用,每会话一键,互不顶盖。
+ * 契约锚 = `agentSession/contract.ts` 的 `AgentSessionConfig.sessionKey`。
+ *
+ * 🔴 本文件只管「存取」,不带任何业务语义 —— miss 计数、fail-soft 文言、还原/合并语义都留在
+ * 各槽位模块里(五个槽位形状略异,强行归一就是过度设计)。
+ */
+/** 零参旧 API 的兼容键(cli 单会话装配走它;多会话宿主每会话一键,别用这个值当会话 id)。 */
+export const DEFAULT_SESSION_KEY = '__default__';
+export function createSessionSlot() {
+    const values = new Map();
+    return {
+        get: (key) => values.get(key),
+        set: (key, value) => {
+            if (value === undefined)
+                values.delete(key);
+            else
+                values.set(key, value);
+        },
+        clear: () => values.clear(),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.11.15",
+  "version": "0.11.16",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",