@sema-agent/client-core 0.3.0 → 0.5.0

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

@@ -5,6 +5,17 @@
  * 沿革:@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.5.0 = **B3 批**(设计稿 §3 B3):`AdapterContext` 扩容(log/probe/signal/setTimer/clearTimer/
+ *   coalesceIntervalMs,**只加可选位 = minor 不 BREAKING**)· 适配内核搬入(`adapter/types` 运行时
+ *   半场 + `adapter/downstream` 三件 + `adapter/runStream`)· runStream **两条外向边切除**
+ *   (lastTurnUsageStore / planReviewWire ⇒ `last_turn_usage` / `plan_review_park` 两个 chrome 臂)·
+ *   T38 三清第三清 + T40 IDLE-FLUSH + T57 第五处断闸 + T58 iterator cleanup + T59 abort + T60 收尾腿。
+ *   🆕 第三道守卫 `scripts/run-client-core-portability-test.mjs`(内核闭包 1571 文件 → **6 文件**)。
+ * 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 抄件漏项)。
@@ -15,6 +26,17 @@
  *   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)。
+ *   —— B3 新增:adapter/runStream.ts(`inFlightTurns` 计数,读口 `isRunStreamActive()`;
+ *   两份实例 = 引擎滚动升级门恒读 false ⇒ **turn 中途热换引擎**,正是它当初要防的事)。
+ * 🔴 **宿主装配**(B2 起本包有必须由宿主注入才完整的口):`installNotificationQueuePort()` ——
+ *   不装 = task-notification 投递静默丢失(`notificationQueuePortMisses()` 恒应为 0)。
+ *   —— B3 新增(可选口,缺席 = 对应 UI 面在该宿主上是哑的,不是报错):`ctx.emitChrome`
+ *   (runStream 的两条切边:statusline 真 usage / plan-review 审批卡)· `ctx.setTimer`
+ *   (T40 IDLE-FLUSH,不给 = 长工具参数生成期已生成内容仍押到下一帧才上屏)· `ctx.signal`
+ *   (Esc 中断)· `ctx.log` / `ctx.probe`(诊断面)。
  */
 export * from './seam.js';
 export * from './workflow.js';
@@ -33,3 +55,33 @@ 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';
+export * from './adapter/types.js';
+export * from './adapter/downstream/turnUsageToModelUsage.js';
+export * from './adapter/downstream/eventToSdkMessage.js';
+export * from './adapter/downstream/terminalToSdkResult.js';
+export * from './adapter/runStream.js';

package/dist/index.js

@@ -5,6 +5,17 @@
  * 沿革:@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.5.0 = **B3 批**(设计稿 §3 B3):`AdapterContext` 扩容(log/probe/signal/setTimer/clearTimer/
+ *   coalesceIntervalMs,**只加可选位 = minor 不 BREAKING**)· 适配内核搬入(`adapter/types` 运行时
+ *   半场 + `adapter/downstream` 三件 + `adapter/runStream`)· runStream **两条外向边切除**
+ *   (lastTurnUsageStore / planReviewWire ⇒ `last_turn_usage` / `plan_review_park` 两个 chrome 臂)·
+ *   T38 三清第三清 + T40 IDLE-FLUSH + T57 第五处断闸 + T58 iterator cleanup + T59 abort + T60 收尾腿。
+ *   🆕 第三道守卫 `scripts/run-client-core-portability-test.mjs`(内核闭包 1571 文件 → **6 文件**)。
+ * 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 抄件漏项)。
@@ -15,6 +26,17 @@
  *   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)。
+ *   —— B3 新增:adapter/runStream.ts(`inFlightTurns` 计数,读口 `isRunStreamActive()`;
+ *   两份实例 = 引擎滚动升级门恒读 false ⇒ **turn 中途热换引擎**,正是它当初要防的事)。
+ * 🔴 **宿主装配**(B2 起本包有必须由宿主注入才完整的口):`installNotificationQueuePort()` ——
+ *   不装 = task-notification 投递静默丢失(`notificationQueuePortMisses()` 恒应为 0)。
+ *   —— B3 新增(可选口,缺席 = 对应 UI 面在该宿主上是哑的,不是报错):`ctx.emitChrome`
+ *   (runStream 的两条切边:statusline 真 usage / plan-review 审批卡)· `ctx.setTimer`
+ *   (T40 IDLE-FLUSH,不给 = 长工具参数生成期已生成内容仍押到下一帧才上屏)· `ctx.signal`
+ *   (Esc 中断)· `ctx.log` / `ctx.probe`(诊断面)。
  */
 export * from './seam.js';
 export * from './workflow.js';
@@ -33,3 +55,43 @@ 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';
+// ── B3 批:适配内核(增量合并 + 计量 + 流驱动)(2026-07-27)──────────────────────────────────
+// M/adapter 的 downstream 三件 + types 运行时半场 + runStream 整搬(设计稿 §3 B3)。
+// 🔴 runStream.ts 持 module 级 `inFlightTurns` 计数(isRunStreamActive 的读口)——单例清单新增项:
+//    写方=runStream 自己,读方=壳的引擎滚动升级门(turn 中途绝不热换引擎)。两份实例 = 门恒读 false。
+export * from './adapter/types.js';
+export * from './adapter/downstream/turnUsageToModelUsage.js';
+export * from './adapter/downstream/eventToSdkMessage.js';
+export * from './adapter/downstream/terminalToSdkResult.js';
+export * from './adapter/runStream.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/mcpWireCaps.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/mcpWireCaps.ts 逐字搬入(只 import SDK)。
+ */
+/**
+ * src/sema/mcpWireCaps.ts — PURE projection: CC `.mcp.json` server config → core `McpServerSpec` (the wire
+ * shape `TaskRequest.mcpServers` carries). Split from mcpWire.ts so it's testable without the heavy
+ * `.mcp.json` loader graph (services/mcp/config.ts). Imports only the SDK type (erased at build).
+ *
+ * core `McpServerSpec.transport` supports ONLY `stdio` + `http` (StreamableHTTP). CC also has sse/sse-ide/
+ * ws/ws-ide — core can't mount those (the SSE/WS transport gap, tracked separately) → we SKIP them here
+ * (returning null) rather than mis-map. stdio→stdio, http→http; name = the `.mcp.json` record key.
+ *
+ * Trust: the SHELL only PROJECTS the user's local config; the SERVICE single-user gate (mcpInjectionHonored
+ * = requirePrincipal!==true) decides whether to honor it (fail-closed on multi-tenant). So projecting is safe.
+ */
+import type { TaskRequest } from '@sema-agent/sdk';
+/** The wire shape `TaskRequest.mcpServers` carries. SDK 0.0.44's index no longer re-exports the
+ *  `McpServerSpec` interface by name (types.d.ts still defines it), so derive it STRUCTURALLY from the
+ *  exported `TaskRequest` — always exactly what the wire accepts, no drift. Re-exported for the shell
+ *  (mcpWire.ts / seamQuery.ts import it from HERE, not @sema-ai/sdk). */
+export type McpServerSpec = NonNullable<TaskRequest['mcpServers']>[number];
+/** Server caps mirror the service merge cap (task-mcp.ts: ≤32, fail-closed on malformed). */
+export declare const MCP_CAPS: {
+    readonly items: 32;
+};
+/** Structural subset of CC's `McpServerConfig` union (services/mcp/types.ts) this projection reads. */
+export interface McpConfigLike {
+    /** discriminator; absent ⇒ stdio (CC: type optional for stdio, back-compat). */
+    type?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    allowTools?: string[];
+}
+/** Map one CC `.mcp.json` server → core `McpServerSpec`, or null when the transport isn't core-supported
+ *  (sse/sse-ide/ws/ws-ide) or required fields are missing. */
+export declare function mcpConfigToSpec(name: string, c: McpConfigLike): McpServerSpec | null;
+/** Project a `.mcp.json` server map → capped `McpServerSpec[]` (skips unsupported transports + malformed). */
+export declare function mcpConfigsToSpecs(servers: Record<string, McpConfigLike> | undefined): McpServerSpec[];

package/dist/mcpWireCaps.js

@@ -0,0 +1,51 @@
+/** Server caps mirror the service merge cap (task-mcp.ts: ≤32, fail-closed on malformed). */
+export const MCP_CAPS = { items: 32 };
+/** Map one CC `.mcp.json` server → core `McpServerSpec`, or null when the transport isn't core-supported
+ *  (sse/sse-ide/ws/ws-ide) or required fields are missing. */
+export function mcpConfigToSpec(name, c) {
+    const n = (name ?? '').trim();
+    if (!n)
+        return null;
+    const kind = c.type ?? 'stdio'; // stdio default (CC: `type` optional for stdio)
+    if (kind === 'stdio') {
+        if (!c.command)
+            return null;
+        return {
+            name: n,
+            transport: {
+                kind: 'stdio',
+                command: c.command,
+                ...(c.args && c.args.length > 0 ? { args: c.args } : {}),
+                ...(c.env ? { env: c.env } : {}),
+            },
+            ...(c.allowTools && c.allowTools.length > 0 ? { allowTools: c.allowTools } : {}),
+        };
+    }
+    if (kind === 'http') {
+        if (!c.url)
+            return null;
+        return {
+            name: n,
+            transport: {
+                kind: 'http',
+                url: c.url,
+                ...(c.headers ? { headers: c.headers } : {}),
+            },
+            ...(c.allowTools && c.allowTools.length > 0 ? { allowTools: c.allowTools } : {}),
+        };
+    }
+    // sse / sse-ide / ws / ws-ide → core McpServerSpec has no such transport (StreamableHTTP only) → skip.
+    return null;
+}
+/** Project a `.mcp.json` server map → capped `McpServerSpec[]` (skips unsupported transports + malformed). */
+export function mcpConfigsToSpecs(servers) {
+    const out = [];
+    for (const [name, c] of Object.entries(servers ?? {})) {
+        if (out.length >= MCP_CAPS.items)
+            break;
+        const spec = mcpConfigToSpec(name, c);
+        if (spec)
+            out.push(spec);
+    }
+    return out;
+}

package/dist/modelBudgetRule.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/modelBudgetRule.ts 逐字搬入(零依赖,纯规则)。
+ */
+/**
+ * modelBudgetRule.ts — max-output-tokens 中央规则(clay 2026-07-15 拍板,F2 maxTokens 裁决批)。
+ *
+ * 裁决(逐字):
+ *   · 上下文窗口:预设/家族表能匹配用匹配值;匹配不上默认 200000(FALLBACK_CONTEXT_WINDOW)。
+ *   · maxTokens 默认:32000;上下文窗口 ≥500000 → 64000;恒受两道封顶:
+ *       ① per-model 已知 cap(providerPresets 精确表,inferFamily 第①层命中带 perModelCap);
+ *       ② 上下文窗口 ÷ 4(向下取整)。
+ *   · UI 四档(超集):16K / 32K(默认)/ 64K / 128K;档位 > 上下文窗口÷4 的禁用/跳过
+ *     (例:128K 上下文 → 顶 32K;1M → 全档可用)。
+ *   · env 显式值恒赢:CLAUDE_CODE_MAX_OUTPUT_TOKENS 映射与显式 MODEL_MAX_TOKENS 既有行为不动
+ *     (本模块只算默认,不碰覆盖层 —— 见 ccConfigFallback.applyModelEnvFamilyFallback)。
+ *
+ * CC 对照锚(有意偏离,记忆档 max-tokens-ruling-deviate-cc):CC 2.1.207 per-model 表
+ * `max_output_tokens:{default:32000,upper:64000}`(源 13760)+ CLAUDE_CODE_MAX_OUTPUT_TOKENS env
+ * 钳制(源 529278),无 UI 档位、无 ÷4 封顶。sema 面对任意三方模型/网关,家族表大数直接当默认会
+ * 超供应商 cap(400)或单轮吃穿预算 —— 故默认收敛到 CC 口径 32K/64K,并加 ÷4 与 per-model 封顶;
+ * UI 档位是超集便利面。
+ *
+ * 注意:providerPresets.json 精确表 / modelFamilies.json 家族表的 maxTokens 字段【保留】——
+ * 只作 cap 参考(perModelCap / 显示),不再直接当默认 stamp 值。
+ */
+/** 裁决:预设/家族都匹配不上时的上下文窗口默认(=CC 的 200k 口径)。 */
+export declare const FALLBACK_CONTEXT_WINDOW = 200000;
+/** UI 四档(超集):16K / 32K(默认)/ 64K / 128K。十进制(与 CC 32000/64000 同基)。 */
+export declare const MAXTOK_TIERS: readonly [16000, 32000, 64000, 128000];
+/**
+ * 默认 max tokens = min( ctx>=500000 ? 64000 : 32000 , floor(ctx/4) , perModelCap ?? ∞ )。
+ * contextWindow 传 null/undefined/非法 = 匹配不上 → 按 200000 算(→ 32000)。
+ */
+export declare function defaultMaxTokensFor(contextWindow: number | null | undefined, perModelCap?: number | null): number;
+/**
+ * 该上下文窗口下可用的 UI 档位(> ctx÷4 的禁用/跳过)。可能为空(ctx < 64000,如 32K 上下文
+ * 连 16K 档都超 ÷4)—— UI 调用方对空列表降级(提示用 M 自由输入),规则函数不瞎补。
+ */
+export declare function tierChoicesFor(contextWindow: number | null | undefined): number[];
+/**
+ * 档位循环:当前值在档内 → 下一档(循环);不在档内(自由输入/家族值)→ 大于当前的最小档,
+ * 都不大于则回第一档(与 modelCtxOverride.nextStep 同语义)。无可用档 → null(调用方降级)。
+ */
+export declare function nextMaxTokTier(current: number | null | undefined, contextWindow: number | null | undefined): number | null;