@sema-agent/client-core 0.2.0 → 0.4.0

package/dist/forkWireCaps.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/forkWireCaps.ts 逐字搬入(零依赖)。
+ */
+/**
+ * src/sema/forkWireCaps.ts — Fork wire projection: the top-level `TaskRequest.enableFork` boolean →
+ * core fork governance → the model's Agent(subagent_type:"fork") availability (core 1.257 撤除独立
+ * Fork 工具,能力收编进 Agent;CC `subagent_type:fork`: the model forks ITSELF into a subagent that
+ * INHERITS the parent context + shares the prompt cache, vs Task's clean-context subagent).
+ *
+ * DEFAULT = CC parity(clay 2026-07-08 拍板,订正:此前壳里引用的「默认对 LLM 不开」是过时拍板):
+ * core ≥1.257 的 fork 治理是 opt-OUT——enableFork 缺省 = GRANTED(与 CC 一致)。壳默认 **不 stamp**,
+ * 让引擎默认生效(模型默认可用 Agent-fork)。`SEMA_ENABLE_FORK` 保留为显式开关:truthy ⇒ stamp true
+ * (对老引擎 <1.257 也点亮),显式 falsy('0'/'false'/'no'/'off')⇒ stamp false(用户关闭的口子,
+ * service [503]② 的 fail-OPEN 教训:关必须显式 false,缺省不再是"关")。
+ *
+ * PURE — no env/file IO of its OWN (callers pass `env`), so it bundles + unit-tests without the
+ * settings graph. The CALLER (seamQuery / the -p ask) gates the env read to LIVE mode so the mock
+ * request shape never changes.
+ */
+import { type EnvLike } from './hostEnv.js';
+/** The env key the shell reads. SEMA_-namespaced so it never collides with a worker's own deploy env. */
+export declare const ENABLE_FORK_ENV: "SEMA_ENABLE_FORK";
+/** ENV source → explicit `true`/`false` when the user set SEMA_ENABLE_FORK either way, else
+ *  `undefined` (⇒ no stamp ⇒ the engine default applies — GRANTED on core ≥1.257, CC parity). */
+export declare function enableForkFromEnv(env?: EnvLike): boolean | undefined;

package/dist/forkWireCaps.js

@@ -0,0 +1,42 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/forkWireCaps.ts 逐字搬入(零依赖)。
+ */
+/**
+ * src/sema/forkWireCaps.ts — Fork wire projection: the top-level `TaskRequest.enableFork` boolean →
+ * core fork governance → the model's Agent(subagent_type:"fork") availability (core 1.257 撤除独立
+ * Fork 工具,能力收编进 Agent;CC `subagent_type:fork`: the model forks ITSELF into a subagent that
+ * INHERITS the parent context + shares the prompt cache, vs Task's clean-context subagent).
+ *
+ * DEFAULT = CC parity(clay 2026-07-08 拍板,订正:此前壳里引用的「默认对 LLM 不开」是过时拍板):
+ * core ≥1.257 的 fork 治理是 opt-OUT——enableFork 缺省 = GRANTED(与 CC 一致)。壳默认 **不 stamp**,
+ * 让引擎默认生效(模型默认可用 Agent-fork)。`SEMA_ENABLE_FORK` 保留为显式开关:truthy ⇒ stamp true
+ * (对老引擎 <1.257 也点亮),显式 falsy('0'/'false'/'no'/'off')⇒ stamp false(用户关闭的口子,
+ * service [503]② 的 fail-OPEN 教训:关必须显式 false,缺省不再是"关")。
+ *
+ * PURE — no env/file IO of its OWN (callers pass `env`), so it bundles + unit-tests without the
+ * settings graph. The CALLER (seamQuery / the -p ask) gates the env read to LIVE mode so the mock
+ * request shape never changes.
+ */
+import { hostEnv } from './hostEnv.js';
+/** The env key the shell reads. SEMA_-namespaced so it never collides with a worker's own deploy env. */
+export const ENABLE_FORK_ENV = 'SEMA_ENABLE_FORK';
+function isTruthy(v) {
+    const s = v.trim().toLowerCase();
+    return s === '1' || s === 'true' || s === 'yes' || s === 'on';
+}
+function isFalsy(v) {
+    const s = v.trim().toLowerCase();
+    return s === '0' || s === 'false' || s === 'no' || s === 'off';
+}
+/** ENV source → explicit `true`/`false` when the user set SEMA_ENABLE_FORK either way, else
+ *  `undefined` (⇒ no stamp ⇒ the engine default applies — GRANTED on core ≥1.257, CC parity). */
+export function enableForkFromEnv(env = hostEnv()) {
+    const raw = env[ENABLE_FORK_ENV];
+    if (typeof raw !== 'string' || raw.trim() === '')
+        return undefined;
+    if (isTruthy(raw))
+        return true;
+    if (isFalsy(raw))
+        return false;
+    return undefined; // unrecognized spelling — don't guess, let the engine default apply
+}

package/dist/hostEnv.d.ts

@@ -0,0 +1,16 @@
+/**
+ * hostEnv.ts — B2 批引入的**唯一**宿主环境读口(多端改造设计稿 §5.2 浏览器可移植性)。
+ *
+ * 为什么需要:搬入的 `*WireCaps` 族有 11 个函数签名是 `(env: NodeJS.ProcessEnv = process.env)`
+ * —— 两个问题:① `NodeJS` 命名空间在本包(tsconfig `types: []`、无 @types/node)不存在;
+ * ② 浏览器里 `process` 未定义,**不传参调用会 ReferenceError**(不是类型问题,是运行时崩)。
+ *
+ * 🔴 等价性记账(逐字):Node 下 `hostEnv()` 返回的就是 `process.env` 那个**同一对象**
+ * (`globalThis.process === process`),所以壳侧既有「不传 env 参数」的调用点行为一字节不变;
+ * 浏览器/worker 下返回 `{}` —— 相当于「所有 env 旋钮未设置」,即各函数自己的缺省档。
+ * `EnvLike` 与 `NodeJS.ProcessEnv`(= `Dict<string>`)结构等价,壳侧传 `process.env` 照样过型。
+ */
+/** `process.env` 的结构等价形(`NodeJS.ProcessEnv` 的包内替身)。 */
+export type EnvLike = Record<string, string | undefined>;
+/** 宿主 env(Node = 真 `process.env` 同一对象;无 process 的宿主 = 空表)。 */
+export declare function hostEnv(): EnvLike;

package/dist/hostEnv.js

@@ -0,0 +1,17 @@
+/**
+ * hostEnv.ts — B2 批引入的**唯一**宿主环境读口(多端改造设计稿 §5.2 浏览器可移植性)。
+ *
+ * 为什么需要:搬入的 `*WireCaps` 族有 11 个函数签名是 `(env: NodeJS.ProcessEnv = process.env)`
+ * —— 两个问题:① `NodeJS` 命名空间在本包(tsconfig `types: []`、无 @types/node)不存在;
+ * ② 浏览器里 `process` 未定义,**不传参调用会 ReferenceError**(不是类型问题,是运行时崩)。
+ *
+ * 🔴 等价性记账(逐字):Node 下 `hostEnv()` 返回的就是 `process.env` 那个**同一对象**
+ * (`globalThis.process === process`),所以壳侧既有「不传 env 参数」的调用点行为一字节不变;
+ * 浏览器/worker 下返回 `{}` —— 相当于「所有 env 旋钮未设置」,即各函数自己的缺省档。
+ * `EnvLike` 与 `NodeJS.ProcessEnv`(= `Dict<string>`)结构等价,壳侧传 `process.env` 照样过型。
+ */
+/** 宿主 env(Node = 真 `process.env` 同一对象;无 process 的宿主 = 空表)。 */
+export function hostEnv() {
+    const p = globalThis.process;
+    return p?.env ?? {};
+}

package/dist/imagesWireCaps.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/imagesWireCaps.ts 逐字搬入(零依赖)。
+ */
+/**
+ * src/sema/imagesWireCaps.ts — PURE projection of a CC user message's IMAGE content blocks → engine ImageInput[]
+ * (CC paste-image / drag-image parity). seamQuery imports it.
+ *
+ * The signature "壳渲染后端空" hole: REPL.tsx:3444 builds Anthropic image blocks
+ *   { type:'image', source:{ type:'base64', media_type, data } }  (or { type:'url', url })
+ * into the user message's `content` block array, but seamQuery.objectiveFromMessage kept ONLY `type==='text'`
+ * blocks — so pasted images RENDERED but never reached the live engine. core/service already consume
+ * `body.images` (main.ts:1296 → core `TaskSpec.images?: ImageInput[]`, types.ts:416 + brain toUserBlocks); this
+ * is purely the missing shell-side projection. config-class (model-content the caller chose for their OWN turn).
+ *
+ * core ImageInput = `{ data: base64, mimeType } | { url }`. We map the Anthropic base64 source
+ * (`source.media_type`/`source.data`) → `{ data, mimeType }`, and a url source → `{ url }`.
+ */
+export type ImageInput = {
+    data: string;
+    mimeType: string;
+} | {
+    url: string;
+};
+/**
+ * Extract the IMAGE blocks of a CC user message → ImageInput[]. Reads `message.content` (string | block[]) the
+ * same way objectiveFromMessage reads its text; a bare-string content has no images ⇒ []. Malformed blocks drop.
+ */
+export declare function imagesFromMessage(msg: unknown): ImageInput[];

package/dist/imagesWireCaps.js

@@ -0,0 +1,49 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/imagesWireCaps.ts 逐字搬入(零依赖)。
+ */
+/**
+ * src/sema/imagesWireCaps.ts — PURE projection of a CC user message's IMAGE content blocks → engine ImageInput[]
+ * (CC paste-image / drag-image parity). seamQuery imports it.
+ *
+ * The signature "壳渲染后端空" hole: REPL.tsx:3444 builds Anthropic image blocks
+ *   { type:'image', source:{ type:'base64', media_type, data } }  (or { type:'url', url })
+ * into the user message's `content` block array, but seamQuery.objectiveFromMessage kept ONLY `type==='text'`
+ * blocks — so pasted images RENDERED but never reached the live engine. core/service already consume
+ * `body.images` (main.ts:1296 → core `TaskSpec.images?: ImageInput[]`, types.ts:416 + brain toUserBlocks); this
+ * is purely the missing shell-side projection. config-class (model-content the caller chose for their OWN turn).
+ *
+ * core ImageInput = `{ data: base64, mimeType } | { url }`. We map the Anthropic base64 source
+ * (`source.media_type`/`source.data`) → `{ data, mimeType }`, and a url source → `{ url }`.
+ */
+/** Map one Anthropic image block's `source` → ImageInput, or null if malformed/unsupported. */
+function sourceToImageInput(source) {
+    if (typeof source !== 'object' || source === null)
+        return null;
+    const s = source;
+    if (s.type === 'base64' && typeof s.data === 'string' && s.data.length > 0) {
+        return { data: s.data, mimeType: typeof s.media_type === 'string' && s.media_type ? s.media_type : 'image/png' };
+    }
+    if (s.type === 'url' && typeof s.url === 'string' && s.url.length > 0) {
+        return { url: s.url };
+    }
+    return null;
+}
+/**
+ * Extract the IMAGE blocks of a CC user message → ImageInput[]. Reads `message.content` (string | block[]) the
+ * same way objectiveFromMessage reads its text; a bare-string content has no images ⇒ []. Malformed blocks drop.
+ */
+export function imagesFromMessage(msg) {
+    const m = msg;
+    const content = m?.message?.content ?? m?.content;
+    if (!Array.isArray(content))
+        return [];
+    const out = [];
+    for (const block of content) {
+        if (block && typeof block === 'object' && block.type === 'image') {
+            const img = sourceToImageInput(block.source);
+            if (img)
+                out.push(img);
+        }
+    }
+    return out;
+}

package/dist/index.d.ts

@@ -4,7 +4,27 @@
  * seam 设计对签:[1651]/[1652]/[1653];依赖方向:sdk(wire)+agent-types(词汇表)→ 本包,永不反向。
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
- * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包)。
+ * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.4.0 = **B2 批**(设计稿 §3 B2):通知族三文件合并进 notifications.ts(engineTaskNotification 全文 +
+ *   taskNotificationErrorSupplement 全文 + hookNoticeStore 判定半场)· 17 个 `*WireCaps` + engineWireSdk +
+ *   sseIdleTriage + classifierVerdictWire 判定半场 + controlRouter + 模型面纯逻辑 4 件 + 新写 hostEnv;
+ *   宿主耦合的 6 件(hooksWireCaps/scratchpadWireCaps/liveInitToolFace/engineSessionParam/
+ *   modelContextResolver/agentModelResolver)**本批不搬**,原因逐条见交接报告。
+ * 0.3.0 = **B1 批**(多端改造设计稿 §3 批次表第二批):纯函数/台账 11 文件 + 1 纯类型文件搬入
+ *   (壳侧 shim 替换随后批)。B1 只搬现行为、零收编、零行为改动;唯一的形状订正是 workflow.ts
+ *   补齐 `agent_runs[].errorCode` 类型位(0.2.0 抄件漏项)。
+ *
+ * 🔴 **单实例纪律**(B1 起本包不再只有纯函数):下列模块持 module 级可变状态,写方与读方必须解析到
+ * **同一个包实例** —— 壳侧本地旧副本与 npm 包同时进 bundle = 状态分裂(台账写进一份、读另一份,
+ * 症状是「台账恒空」的静默失效,不报错)。清单见各文件头 🔴 段:
+ *   workflow.ts(workflowAgentTaskIds)· subagentContentStore.ts · engineAgentPanelStore.ts ·
+ *   fleetAgentPanelProjection.ts · liveQuestionStore.ts · engineInlineTaskStats.ts ·
+ *   engineCapsCache.ts · engineToolLabelStore.ts
+ *   —— B2 新增:notifications.ts(11 个通知台账 + 队列 port + 两个 probe 槽)·
+ *   agentsWireCaps.ts(prepare 缓存/投影闭包/一次性告警集)· liveModelCatalog.ts(目录 + refresher)·
+ *   sessionModelLatch.ts(三个 latch)· ultracodeWireCaps.ts(sticky preset)。
+ * 🔴 **宿主装配**(B2 起本包有必须由宿主注入才完整的口):`installNotificationQueuePort()` ——
+ *   不装 = task-notification 投递静默丢失(`notificationQueuePortMisses()` 恒应为 0)。
  */
 export * from './seam.js';
 export * from './workflow.js';
@@ -13,3 +33,38 @@ export * from './steering.js';
 export * from './diagnostics.js';
 export * from './retryStatus.js';
 export * from './adapt.js';
+export * from './subagentContentStore.js';
+export * from './engineAgentPanelStore.js';
+export * from './fleetAgentPanelProjection.js';
+export * from './liveQuestionStore.js';
+export * from './engineInlineTaskStats.js';
+export * from './printToolResultFrame.js';
+export * from './engineCapsCache.js';
+export * from './engineToolLabelStore.js';
+export * from './fleetTaskDesc.js';
+export type * from './types/engineState.js';
+export * from './hostEnv.js';
+export * from './controlRouter.js';
+export * from './sseIdleTriage.js';
+export * from './engineWireSdk.js';
+export * from './classifierVerdictWire.js';
+export * from './agentsWireCaps.js';
+export * from './attachmentsWireCaps.js';
+export * from './clientContextWireCaps.js';
+export * from './cloudConfigWireCaps.js';
+export * from './forkWireCaps.js';
+export * from './imagesWireCaps.js';
+export * from './mcpWireCaps.js';
+export * from './modelWireCaps.js';
+export * from './permissionWireCaps.js';
+export * from './promptProfileWireCaps.js';
+export * from './retainBackgroundWireCaps.js';
+export * from './rewindWireCaps.js';
+export * from './selfOrchestrationWireCaps.js';
+export * from './skillsWireCaps.js';
+export * from './ultracodeWireCaps.js';
+export * from './webSearchWireCaps.js';
+export * from './liveModelCatalog.js';
+export * from './modelBudgetRule.js';
+export * from './sessionModelLatch.js';
+export * from './effortWire.js';

package/dist/index.js

@@ -4,7 +4,27 @@
  * seam 设计对签:[1651]/[1652]/[1653];依赖方向:sdk(wire)+agent-types(词汇表)→ 本包,永不反向。
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
- * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包)。
+ * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.4.0 = **B2 批**(设计稿 §3 B2):通知族三文件合并进 notifications.ts(engineTaskNotification 全文 +
+ *   taskNotificationErrorSupplement 全文 + hookNoticeStore 判定半场)· 17 个 `*WireCaps` + engineWireSdk +
+ *   sseIdleTriage + classifierVerdictWire 判定半场 + controlRouter + 模型面纯逻辑 4 件 + 新写 hostEnv;
+ *   宿主耦合的 6 件(hooksWireCaps/scratchpadWireCaps/liveInitToolFace/engineSessionParam/
+ *   modelContextResolver/agentModelResolver)**本批不搬**,原因逐条见交接报告。
+ * 0.3.0 = **B1 批**(多端改造设计稿 §3 批次表第二批):纯函数/台账 11 文件 + 1 纯类型文件搬入
+ *   (壳侧 shim 替换随后批)。B1 只搬现行为、零收编、零行为改动;唯一的形状订正是 workflow.ts
+ *   补齐 `agent_runs[].errorCode` 类型位(0.2.0 抄件漏项)。
+ *
+ * 🔴 **单实例纪律**(B1 起本包不再只有纯函数):下列模块持 module 级可变状态,写方与读方必须解析到
+ * **同一个包实例** —— 壳侧本地旧副本与 npm 包同时进 bundle = 状态分裂(台账写进一份、读另一份,
+ * 症状是「台账恒空」的静默失效,不报错)。清单见各文件头 🔴 段:
+ *   workflow.ts(workflowAgentTaskIds)· subagentContentStore.ts · engineAgentPanelStore.ts ·
+ *   fleetAgentPanelProjection.ts · liveQuestionStore.ts · engineInlineTaskStats.ts ·
+ *   engineCapsCache.ts · engineToolLabelStore.ts
+ *   —— B2 新增:notifications.ts(11 个通知台账 + 队列 port + 两个 probe 槽)·
+ *   agentsWireCaps.ts(prepare 缓存/投影闭包/一次性告警集)· liveModelCatalog.ts(目录 + refresher)·
+ *   sessionModelLatch.ts(三个 latch)· ultracodeWireCaps.ts(sticky preset)。
+ * 🔴 **宿主装配**(B2 起本包有必须由宿主注入才完整的口):`installNotificationQueuePort()` ——
+ *   不装 = task-notification 投递静默丢失(`notificationQueuePortMisses()` 恒应为 0)。
  */
 export * from './seam.js';
 export * from './workflow.js';
@@ -13,3 +33,44 @@ export * from './steering.js';
 export * from './diagnostics.js';
 export * from './retryStatus.js';
 export * from './adapt.js';
+// ── B1 批:纯函数 / 侧信道台账 / 投影闸(2026-07-27)──────────────────────────────────────────
+export * from './subagentContentStore.js';
+export * from './engineAgentPanelStore.js';
+export * from './fleetAgentPanelProjection.js';
+export * from './liveQuestionStore.js';
+export * from './engineInlineTaskStats.js';
+export * from './printToolResultFrame.js';
+export * from './engineCapsCache.js';
+export * from './engineToolLabelStore.js';
+export * from './fleetTaskDesc.js';
+// ── B2 批:通知族合并 / caps-wire 门族 / 模型面纯逻辑 / control 路由(2026-07-27)──────────────
+// 通知族(engineTaskNotification + taskNotificationErrorSupplement + hookNoticeStore 判定半场)
+// 已并入 notifications.js,不需要新增导出行。
+export * from './hostEnv.js';
+export * from './controlRouter.js';
+export * from './sseIdleTriage.js';
+export * from './engineWireSdk.js';
+export * from './classifierVerdictWire.js';
+// caps / wire 门族(17 个 *WireCaps —— 壳侧 hooksWireCaps / scratchpadWireCaps 因宿主耦合未搬,
+// 见 README 的 B2 记账)
+export * from './agentsWireCaps.js';
+export * from './attachmentsWireCaps.js';
+export * from './clientContextWireCaps.js';
+export * from './cloudConfigWireCaps.js';
+export * from './forkWireCaps.js';
+export * from './imagesWireCaps.js';
+export * from './mcpWireCaps.js';
+export * from './modelWireCaps.js';
+export * from './permissionWireCaps.js';
+export * from './promptProfileWireCaps.js';
+export * from './retainBackgroundWireCaps.js';
+export * from './rewindWireCaps.js';
+export * from './selfOrchestrationWireCaps.js';
+export * from './skillsWireCaps.js';
+export * from './ultracodeWireCaps.js';
+export * from './webSearchWireCaps.js';
+// 模型面纯逻辑族
+export * from './liveModelCatalog.js';
+export * from './modelBudgetRule.js';
+export * from './sessionModelLatch.js';
+export * from './effortWire.js';

package/dist/liveModelCatalog.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/liveModelCatalog.ts 逐字搬入(零依赖;🔴 catalog/refresher 是单实例态 —— 写口 setLiveModelCatalog/installer 与读口 getLiveModelCatalog 必须同实例)。
+ */
+/**
+ * src/sema/liveModelCatalog.ts — the LIVE model-catalog singleton (TEAM-C / clay decision #1 = A).
+ *
+ * WHY THIS FILE EXISTS
+ * --------------------
+ * The `/model` picker, the header model line, the /status "Model" row, and the picker's ✔ are all stuck on
+ * a STATIC opus[1m] / a STATIC fictional catalog (mock/control/modelOptionsSeam.ts). The live engine actually
+ * serves a different fleet — `client.models.list()` returns `{ models, default }` (the REAL catalog), and
+ * `done.result.model` echoes the REAL served model (MF-25). This module is the one-shot, process-wide bridge
+ * between the LIVE wire read (done once at boot in replEntry's live block) and the SYNCHRONOUS render-time
+ * readers (getModelOptions, called inside the picker's React render — it cannot await).
+ *
+ * SINGLE INSTANCE (build discipline): replEntry.tsx (build-src/src/sema/replEntry.tsx) SETS the catalog and
+ * mock/control/modelOptionsSeam.ts (build-src/mock/control/…, the aliased getModelOptions target) READS it.
+ * Both resolve this module to ONE staged path (build-src/src/sema/liveModelCatalog.ts), so the singleton is
+ * shared — the same single-instance invariant the seam-module fix in scripts/build.sema.mjs guarantees.
+ *
+ * MOCK PATH UNCHANGED: with SEMA_LIVE_BASEURL unset, no one calls setLiveModelCatalog → the catalog stays
+ * null → getModelOptions falls back to the static fleetModels mock and the boot keeps opus[1m]. So the
+ * cell-exact mock parity (the /model picker mock rows, the opus[1m] header/status, the /context 20-glyph
+ * grid driven by has1mContext('opus[1m]')) is preserved byte-for-byte.
+ */
+/** The neutral wire shape of one model-catalog row (a structural subset of @sema-ai/sdk ModelInfo +
+ *  mock/control/modelSelect.ts ModelInfo — name/id/provider/reasoning/vision drive the picker badges). */
+export interface LiveModelInfo {
+    name: string;
+    id?: string;
+    provider?: string;
+    reasoning?: boolean;
+    vision?: boolean;
+    [k: string]: unknown;
+}
+/** The `GET /v1/models` envelope: the catalog rows + the deployment default model id (display-only). */
+export interface LiveModelCatalog {
+    models: LiveModelInfo[];
+    /** The served-by-default model id (models.list().default) — the boot mainLoopModel + the picker default desc. */
+    default: string;
+}
+/** Install the live catalog (called once at boot from replEntry's live block). null clears it. */
+export declare function setLiveModelCatalog(next: LiveModelCatalog | null): void;
+/** boot 注册的重取器(与 boot fetch 同参)。k3 案(clay 2026-07-20):/config 改 Model ID 后
+ *  同会话 /model 仍显旧目录名——目录只在 boot 拉一次。Hub 保存/面板打开时经此重取。 */
+export declare function setLiveModelCatalogRefresher(fn: (() => Promise<LiveModelCatalog | null>) | null): void;
+/** Re-fetch the live catalog (boot 参数);成功即替换 singleton 并返回 true。mock 路径(无
+ *  refresher)/拉取失败 → false,现值不动(fail-soft,绝不用 null 清掉可用旧目录)。 */
+export declare function refreshLiveModelCatalog(): Promise<boolean>;
+/** Read the live catalog (null = mock path / live read failed → callers fall back to the static mock). */
+export declare function getLiveModelCatalog(): LiveModelCatalog | null;
+/**
+ * 件4/MOD-6(F1 模型面批):id/name 双键归一。目录行有两个可寻址键 —— `name`(池 entry id,
+ * /model 面板行的 value、@mention 的 handle)和 `id`(上游 modelId);/v1/models 的 `default`
+ * 与 boot 回读可能给 id,面板/appState 用 name ⇒ 单键比对时 id≠name 的行匹配不上,面板追加
+ * 合成 "Current model" 重复行、✔ 落错行。归一规则:ref 已是某行 name ⇒ 原样;否则命中某行
+ * id ⇒ 归一到该行 name;目录缺失(mock 路径)/未命中 ⇒ 原样返回(mock parity 零影响)。
+ */
+export declare function normalizeLiveModelRef(ref: string): string;
+/** 件4(S2 回显):目录 default 的用户名 —— name(池 entry id)优先,id 兜底;null=无目录
+ *  (mock 路径,调用方回落 CC 字面护 parity)。 */
+export declare function liveDefaultModelName(): string | null;

package/dist/liveModelCatalog.js

@@ -0,0 +1,79 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/liveModelCatalog.ts 逐字搬入(零依赖;🔴 catalog/refresher 是单实例态 —— 写口 setLiveModelCatalog/installer 与读口 getLiveModelCatalog 必须同实例)。
+ */
+/**
+ * src/sema/liveModelCatalog.ts — the LIVE model-catalog singleton (TEAM-C / clay decision #1 = A).
+ *
+ * WHY THIS FILE EXISTS
+ * --------------------
+ * The `/model` picker, the header model line, the /status "Model" row, and the picker's ✔ are all stuck on
+ * a STATIC opus[1m] / a STATIC fictional catalog (mock/control/modelOptionsSeam.ts). The live engine actually
+ * serves a different fleet — `client.models.list()` returns `{ models, default }` (the REAL catalog), and
+ * `done.result.model` echoes the REAL served model (MF-25). This module is the one-shot, process-wide bridge
+ * between the LIVE wire read (done once at boot in replEntry's live block) and the SYNCHRONOUS render-time
+ * readers (getModelOptions, called inside the picker's React render — it cannot await).
+ *
+ * SINGLE INSTANCE (build discipline): replEntry.tsx (build-src/src/sema/replEntry.tsx) SETS the catalog and
+ * mock/control/modelOptionsSeam.ts (build-src/mock/control/…, the aliased getModelOptions target) READS it.
+ * Both resolve this module to ONE staged path (build-src/src/sema/liveModelCatalog.ts), so the singleton is
+ * shared — the same single-instance invariant the seam-module fix in scripts/build.sema.mjs guarantees.
+ *
+ * MOCK PATH UNCHANGED: with SEMA_LIVE_BASEURL unset, no one calls setLiveModelCatalog → the catalog stays
+ * null → getModelOptions falls back to the static fleetModels mock and the boot keeps opus[1m]. So the
+ * cell-exact mock parity (the /model picker mock rows, the opus[1m] header/status, the /context 20-glyph
+ * grid driven by has1mContext('opus[1m]')) is preserved byte-for-byte.
+ */
+let catalog = null;
+let refresher = null;
+/** Install the live catalog (called once at boot from replEntry's live block). null clears it. */
+export function setLiveModelCatalog(next) {
+    catalog = next;
+}
+/** boot 注册的重取器(与 boot fetch 同参)。k3 案(clay 2026-07-20):/config 改 Model ID 后
+ *  同会话 /model 仍显旧目录名——目录只在 boot 拉一次。Hub 保存/面板打开时经此重取。 */
+export function setLiveModelCatalogRefresher(fn) {
+    refresher = fn;
+}
+/** Re-fetch the live catalog (boot 参数);成功即替换 singleton 并返回 true。mock 路径(无
+ *  refresher)/拉取失败 → false,现值不动(fail-soft,绝不用 null 清掉可用旧目录)。 */
+export async function refreshLiveModelCatalog() {
+    if (!refresher)
+        return false;
+    try {
+        const next = await refresher();
+        if (next && Array.isArray(next.models) && next.models.length > 0) {
+            catalog = next;
+            return true;
+        }
+    }
+    catch {
+        /* fail-soft */
+    }
+    return false;
+}
+/** Read the live catalog (null = mock path / live read failed → callers fall back to the static mock). */
+export function getLiveModelCatalog() {
+    return catalog;
+}
+/**
+ * 件4/MOD-6(F1 模型面批):id/name 双键归一。目录行有两个可寻址键 —— `name`(池 entry id,
+ * /model 面板行的 value、@mention 的 handle)和 `id`(上游 modelId);/v1/models 的 `default`
+ * 与 boot 回读可能给 id,面板/appState 用 name ⇒ 单键比对时 id≠name 的行匹配不上,面板追加
+ * 合成 "Current model" 重复行、✔ 落错行。归一规则:ref 已是某行 name ⇒ 原样;否则命中某行
+ * id ⇒ 归一到该行 name;目录缺失(mock 路径)/未命中 ⇒ 原样返回(mock parity 零影响)。
+ */
+export function normalizeLiveModelRef(ref) {
+    if (!catalog || !ref)
+        return ref;
+    if (catalog.models.some(m => m.name === ref))
+        return ref;
+    const row = catalog.models.find(m => typeof m.id === 'string' && m.id === ref);
+    return row?.name || ref;
+}
+/** 件4(S2 回显):目录 default 的用户名 —— name(池 entry id)优先,id 兜底;null=无目录
+ *  (mock 路径,调用方回落 CC 字面护 parity)。 */
+export function liveDefaultModelName() {
+    if (!catalog?.default)
+        return null;
+    return normalizeLiveModelRef(catalog.default);
+}

package/dist/liveQuestionStore.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ⇄ 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).
+ *
+ * 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.
+ */
+/** One option of an AskUserQuestion question (CC AskUserQuestionTool option shape). */
+export interface AskQuestionOption {
+    /** EXACT display label — the answer echoes labels verbatim (core fences `selected ⊆ options`). */
+    label: string;
+    description?: string;
+}
+/** One model-authored question (UNTRUSTED: render-only, never re-fed to a model). */
+export interface AskQuestion {
+    /** The question text (the CC dialog keys its answers Record by this). */
+    question: string;
+    /** Short header — the WIRE answer is keyed by this (see {@link QuestionAnswer}). */
+    header: string;
+    options: AskQuestionOption[];
+    multiSelect: boolean;
+}
+/** A demuxed/synthetic live question frame (legacy 1.61 wire payload `{type,questionId,questions?,outcome?}`;
+ *  today also synthesized locally by liveHitlAskWire (`hitl-ask:*`) and planReviewWire (`plan-review:*`)).
+ *  `question` opens the dialog overlay; `question_complete` dismisses a still-open one. */
+export interface QuestionFrame {
+    type: 'question' | 'question_complete';
+    questionId: string;
+    /** Present on `question` frames; may be absent when the service dropped an over-cap payload. */
+    questions?: AskQuestion[];
+    /** `question_complete` only (legacy wire): why the ask was released (answered/expired/aborted). */
+    outcome?: string;
+}
+/** The answer the overlay sends back — keyed by HEADER; `selected` echoes exact option labels
+ *  (`selected ⊆ options`, core's fence); off-list / free-text input rides `note` (untrusted-fenced).
+ *  Entry shape === hitlBridge's AskAnswer (the T23 ApprovalDecision.answer leg consumes it as-is). */
+export interface QuestionAnswer {
+    answers: Array<{
+        header: string;
+        selected: string[];
+        note?: string;
+    }>;
+}
+type QuestionFrameHandler = (frame: QuestionFrame) => void;
+type RespondFn = (id: string, answer: QuestionAnswer, opts?: {
+    signal?: AbortSignal;
+}) => Promise<unknown>;
+/** Register a one-shot local responder for a SYNTHETIC question frame (e.g. `plan-review:<taskId>`).
+ *  Returns an unregister fn (dialog dismissed without answering ⇒ caller cleans up). */
+export declare function registerLocalQuestionResponder(id: string, fn: RespondFn): () => void;
+/**
+ * Publish a demuxed live question frame (called from liveClient's demuxQuestionFrames on each
+ * `question`/`question_complete`). Best-effort: a UI handler error is swallowed so a broken overlay can NEVER
+ * 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;
+/** 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;
+/** Subscribe the UI overlay to live question frames. Returns an unsubscribe. Last writer wins (one overlay). */
+export declare function onQuestionFrame(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;
+/**
+ * Answer a parked live question (POST /v1/questions/:id/respond via the live client). Rejects when no live
+ * client is wired (offline/mock) so the overlay can fall back / dismiss. The 404 (answered/expired/wrong
+ * replica) surfaces as a thrown ApiError — the overlay treats it as "already released", never a retry.
+ */
+export declare function respondToQuestion(id: string, answer: QuestionAnswer, opts?: {
+    signal?: AbortSignal;
+}): Promise<unknown>;
+/** Test-only reset. */
+export declare function _resetLiveQuestionStore(): void;
+export {};