@sema-agent/client-core 0.11.15 → 0.11.17

package/dist/fleetAgentPanelProjection.d.ts

@@ -17,6 +17,9 @@ export interface FleetAgentRowLike {
         toolName: string;
         target?: string;
     };
+    /** server 1.250 起行带的 launch 真锚(epoch ms)。R4(clay 五报 07-31):此前投影载荷丢弃它,
+     *  详情页 elapsed 只能锚「壳建行时刻」——遗留行上渲出 1h+ 的假时长。缺席=老引擎,消费端保持现状。 */
+    startedAt?: number;
 }
 /** 行从投影集消失多久之后按 completed 兜底 settle(重连空窗 / snapshot 清表远小于此)。 */
 export declare const ABSENT_SETTLE_MS = 30000;

package/dist/fleetAgentPanelProjection.js

@@ -80,6 +80,7 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
         // 🔴 三态直取:`row.toolUses` 缺席就是 undefined,这里**不许**兜 0(见 FleetAgentRowLike 注)。
         const toolUses = typeof row.toolUses === 'number' ? row.toolUses : undefined;
         const transcriptId = row.transcriptId || undefined;
+        const startedAt = typeof row.startedAt === 'number' && row.startedAt > 0 ? row.startedAt : undefined;
         const currentTool = currentToolKeyOf(row.currentTool) !== undefined ? row.currentTool : undefined;
         const currentToolKey = currentToolKeyOf(row.currentTool);
         const prev = seen.get(taskId);
@@ -89,7 +90,8 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
                 // 终态行也把最后一拍的累计工具数/转录锚带上:详情页在行翻终态后仍要显示真计数与
                 // 委派 prompt,而终态帧常常是这一行**唯一**带全 usage 的一帧(bg lane 只在活动边界发行帧)。
                 if ((toolUses !== undefined && prev?.toolUses !== toolUses) ||
-                    (transcriptId !== undefined && prev?.transcriptId !== transcriptId)) {
+                    (transcriptId !== undefined && prev?.transcriptId !== transcriptId) ||
+                    (startedAt !== undefined && prev?.startedAt !== startedAt)) {
                     publishEngineAgentPanelEvent({
                         kind: 'fleet-row',
                         taskId,
@@ -98,6 +100,7 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
                         totalTokens: tokens,
                         ...(toolUses !== undefined ? { toolUses } : {}),
                         ...(transcriptId !== undefined ? { transcriptId } : {}),
+                        ...(startedAt !== undefined ? { startedAt } : {}),
                     });
                 }
                 publishEngineAgentPanelEvent({
@@ -111,6 +114,7 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
                 tokens,
                 toolUses: toolUses !== undefined ? toolUses : prev?.toolUses,
                 transcriptId: transcriptId !== undefined ? transcriptId : prev?.transcriptId,
+                startedAt: startedAt !== undefined ? startedAt : prev?.startedAt,
                 currentToolKey: currentToolKey !== undefined ? currentToolKey : prev?.currentToolKey,
                 lastSeenAt: nowMs,
                 settled: true,
@@ -127,6 +131,7 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
             prev.tokens !== tokens ||
             (toolUses !== undefined && prev.toolUses !== toolUses) ||
             (transcriptId !== undefined && prev.transcriptId !== transcriptId) ||
+            (startedAt !== undefined && prev.startedAt !== startedAt) ||
             (currentToolKey !== undefined && prev.currentToolKey !== currentToolKey)) {
             publishEngineAgentPanelEvent({
                 kind: 'fleet-row',
@@ -137,6 +142,7 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
                 // 🔴 缺席即不落键(消费端据「键在不在」判三态)。
                 ...(toolUses !== undefined ? { toolUses } : {}),
                 ...(transcriptId !== undefined ? { transcriptId } : {}),
+                ...(startedAt !== undefined ? { startedAt } : {}),
                 ...(currentTool !== undefined ? { currentTool } : {}),
             });
         }
@@ -146,6 +152,7 @@ export function projectFleetAgentRows(rows, nowMs = Date.now()) {
             tokens,
             toolUses: toolUses !== undefined ? toolUses : prev?.toolUses,
             transcriptId: transcriptId !== undefined ? transcriptId : prev?.transcriptId,
+            startedAt: startedAt !== undefined ? startedAt : prev?.startedAt,
             currentToolKey: currentToolKey !== undefined ? currentToolKey : prev?.currentToolKey,
             lastSeenAt: nowMs,
             settled: false,

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 { isFsApprovalGate, toolNameIsFsWrite, surfaceFsApprovalAndDecide, isToolApprovalFrame, isFromSubagent, surfaceToolApprovalFrameAndRespond, } from './toolApprovalWire.js';
+import { createSessionSlot, DEFAULT_SESSION_KEY } from '../sessionSlot.js';
+import { isToolApprovalGate, 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;
 }
 /**
@@ -53,8 +69,9 @@ function isAskGatePark(result) {
         typeof r.taskId === 'string' &&
         r.taskId.length > 0);
 }
-/** done 帧的 fs 写权限 park 形状([816] 放宽腿):status suspended + checkpointGate 指 fs 写工具
- *  (Write/Edit/NotebookEdit)或一等 kind==='tool_approval'。Ask gate 恒先判(问答 overlay 原路)。 */
+/** done 帧的工具审批 park 形状([816] 放宽腿 + [2150] Bash 半场):status suspended +
+ *  checkpointGate 指 fs 写三件 / Bash / 一等 kind==='tool_approval'(超集谓词 isToolApprovalGate,
+ *  decide 腿对两族同构、卡形归壳分发)。Ask gate 恒先判(问答 overlay 原路)。 */
 function isFsApprovalPark(result) {
     const r = result;
     return (!!r &&
@@ -62,7 +79,7 @@ function isFsApprovalPark(result) {
         typeof r.taskId === 'string' &&
         r.taskId.length > 0 &&
         !isAskTool(r.checkpointGate?.toolName) &&
-        isFsApprovalGate(r.checkpointGate));
+        isToolApprovalGate(r.checkpointGate));
 }
 /** 把 wire 答案({answers:[{header,selected,note?}]})折回 CC 卡片的 Record<question,string> 形状
  *  (multiSelect 与对话框同款 ", " lossy join;note → annotations.notes)。 */
@@ -461,7 +478,7 @@ export async function* bridgeAskUserQuestionGates(source, deps, opts) {
                     park = { gate: 'ask' };
                     break;
                 }
-                if (ev.gate && isFsApprovalGate(ev.gate) && realTaskId) {
+                if (ev.gate && isToolApprovalGate(ev.gate) && realTaskId) {
                     park = { gate: 'fs' };
                     break;
                 }

package/dist/hitl/toolApprovalWire.d.ts

@@ -6,6 +6,17 @@ export declare function isFsApprovalGate(gate: {
     toolName?: unknown;
 } | undefined | null): boolean;
 export declare function toolNameIsFsWrite(name: string): boolean;
+/** shell 执行工具判定(Bash)。[2150] S1 半场:引擎对 Bash 发 durable park 时,fs 谓词不认 ⇒
+ *  park 落「其余 gate 透传」= run 留 suspended、session 锁死(r1 E5 fail-stuck 实例)。 */
+export declare function toolNameIsShellExec(name: string): boolean;
+/** 工具审批 gate 判定(durable park 分诊用的**超集**谓词):一等 kind / fs 写三件 / shell 执行。
+ *  decide 腿(approvals.decide)对两族同构;卡形分发归壳 ApprovalCardPort(toolForName 已含
+ *  bash → BashPermissionRequest 映射,sema-cli a35e2b2)。`isFsApprovalGate` 保留原语义不动
+ *  (公开面消费者按 fs 写理解它,把 Bash 塞进去是撒谎)。 */
+export declare function isToolApprovalGate(gate: {
+    kind?: unknown;
+    toolName?: unknown;
+} | undefined | null): boolean;
 export type FsApprovalOutcome = {
     kind: 'decided';
     gatedCallId?: string;
@@ -61,10 +72,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 桥先判)。 */
@@ -14,6 +15,20 @@ export function toolNameIsFsWrite(name) {
     const n = name.replace(/[\s_-]+/g, '').toLowerCase();
     return (n === 'write' || n === 'filewrite' || n === 'edit' || n === 'fileedit' || n === 'multiedit' || n === 'notebookedit');
 }
+/** shell 执行工具判定(Bash)。[2150] S1 半场:引擎对 Bash 发 durable park 时,fs 谓词不认 ⇒
+ *  park 落「其余 gate 透传」= run 留 suspended、session 锁死(r1 E5 fail-stuck 实例)。 */
+export function toolNameIsShellExec(name) {
+    return name.replace(/[\s_-]+/g, '').toLowerCase() === 'bash';
+}
+/** 工具审批 gate 判定(durable park 分诊用的**超集**谓词):一等 kind / fs 写三件 / shell 执行。
+ *  decide 腿(approvals.decide)对两族同构;卡形分发归壳 ApprovalCardPort(toolForName 已含
+ *  bash → BashPermissionRequest 映射,sema-cli a35e2b2)。`isFsApprovalGate` 保留原语义不动
+ *  (公开面消费者按 fs 写理解它,把 Bash 塞进去是撒谎)。 */
+export function isToolApprovalGate(gate) {
+    if (isFsApprovalGate(gate))
+        return true;
+    return typeof gate?.toolName === 'string' && toolNameIsShellExec(gate.toolName);
+}
 /** 结构等值(键序无关深比较)——updatedInput「真编辑过」判定用。zod parse 会产新引用与重排,
  *  引用比较/JSON.stringify 串比较都会假报「编辑过」。 */
 export function structurallyEqual(a, b) {
@@ -36,28 +51,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 +102,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 +121,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 桥同姿势)。
@@ -93,7 +129,7 @@ export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signa
     try {
         const rows = (await deps.client.approvals.list(signal ? { signal } : undefined)).pending;
         pending =
-            rows.find(r => r.taskId === taskId && typeof r.toolName === 'string' && toolNameIsFsWrite(r.toolName)) ??
+            rows.find(r => r.taskId === taskId && typeof r.toolName === 'string' && (toolNameIsFsWrite(r.toolName) || toolNameIsShellExec(r.toolName))) ??
                 rows.find(r => r.taskId === taskId);
     }
     catch (e) {

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;