@sema-agent/client-core 0.71.3 → 0.72.0

package/dist/hitl/gateIdentity.d.ts

@@ -20,12 +20,8 @@
  *
  * 🔴 零 import 纯函数叶(portability:不进任何闭包新边;index 闭包 +1 文件已登记)。
  */
-/** overlay 问答帧的 ask-gate 命名空间前缀(`parkResolver.surfaceGateAndDecide` 合成帧 id 用)。 */
-export declare const HITL_ASK_QUESTION_ID_PREFIX = "hitl-ask:";
 /** plan_review 审批卡的合成 questionId 前缀(`planReviewWire` 首次 arm 与重开腿共用)。 */
 export declare const PLAN_REVIEW_QUESTION_ID_PREFIX = "plan-review:";
-/** live `tool_approval` 帧腿的卡口 callKey 前缀(帧上无 gatedCallId 可对齐,以 approvalId 铸)。 */
-export declare const HITL_FRAME_CALL_KEY_PREFIX = "hitl-frame:";
 /** 重开腿铸新身份的尾分隔符(`…#reopen-<suffix>`);键归一时从这里剥尾,首呈与重开落同一键。 */
 export declare const REOPEN_ID_TAIL = "#reopen-";
 /**

package/dist/hitl/gateIdentity.js

@@ -21,11 +21,11 @@
  * 🔴 零 import 纯函数叶(portability:不进任何闭包新边;index 闭包 +1 文件已登记)。
  */
 /** overlay 问答帧的 ask-gate 命名空间前缀(`parkResolver.surfaceGateAndDecide` 合成帧 id 用)。 */
-export const HITL_ASK_QUESTION_ID_PREFIX = 'hitl-ask:';
+const HITL_ASK_QUESTION_ID_PREFIX = 'hitl-ask:';
 /** plan_review 审批卡的合成 questionId 前缀(`planReviewWire` 首次 arm 与重开腿共用)。 */
 export const PLAN_REVIEW_QUESTION_ID_PREFIX = 'plan-review:';
 /** live `tool_approval` 帧腿的卡口 callKey 前缀(帧上无 gatedCallId 可对齐,以 approvalId 铸)。 */
-export const HITL_FRAME_CALL_KEY_PREFIX = 'hitl-frame:';
+const HITL_FRAME_CALL_KEY_PREFIX = 'hitl-frame:';
 /** 重开腿铸新身份的尾分隔符(`…#reopen-<suffix>`);键归一时从这里剥尾,首呈与重开落同一键。 */
 export const REOPEN_ID_TAIL = '#reopen-';
 /**

package/dist/hitl/hitlBridge.d.ts

@@ -69,8 +69,6 @@ import type { AgentEvent, ApprovalDecision, ApprovalStaleError, PendingCheckpoin
 import type { ApprovalsListEnvelope } from './crashConverged.js';
 /** durable `/decide` 腿的既有缺省拒因(不带归因时逐字不变 —— 0.27.0 及之前的 wire 字节)。 */
 export declare const DEFAULT_DENY_REASON = "The user rejected this tool use";
-/** server 两条腿共用的 reason 字符上限(超限 413,决断被打回)。 */
-export declare const MAX_DENY_REASON_CHARS = 4096;
 /**
  * 归因原文 → 可上 wire 的形。缺席/非串/纯空白 ⇒ `undefined`(调用方自定回落:deny 腿落
  * {@link DEFAULT_DENY_REASON},plan-review 腿键不落);超上限 ⇒ 截到上限并 debug 留痕。

package/dist/hitl/hitlBridge.js

@@ -11,7 +11,7 @@ import { abortableSleep } from '../abortableSleep.js';
 /** durable `/decide` 腿的既有缺省拒因(不带归因时逐字不变 —— 0.27.0 及之前的 wire 字节)。 */
 export const DEFAULT_DENY_REASON = 'The user rejected this tool use';
 /** server 两条腿共用的 reason 字符上限(超限 413,决断被打回)。 */
-export const MAX_DENY_REASON_CHARS = 4096;
+const MAX_DENY_REASON_CHARS = 4096;
 /**
  * 归因原文 → 可上 wire 的形。缺席/非串/纯空白 ⇒ `undefined`(调用方自定回落:deny 腿落
  * {@link DEFAULT_DENY_REASON},plan-review 腿键不落);超上限 ⇒ 截到上限并 debug 留痕。

package/dist/hitl/planReviewWire.d.ts

@@ -65,8 +65,6 @@ export declare function planReviewDecisionFromAnswer(answer: QuestionAnswer | nu
  * (它们没有 dismissed 臂会到达记账行)。
  */
 export declare function notePlanReviewAnsweredIfDecisive(questionId: unknown, answer: QuestionAnswer | null | undefined): void;
-/** W1 带 key 变体。 */
-export declare function notePlanReviewAnsweredIfDecisiveFor(sessionKey: string, questionId: unknown, answer: QuestionAnswer | null | undefined): void;
 /**
  * done 帧的 plan_review park 形状(结构性读,别的终局一律 false)。
  *

package/dist/hitl/planReviewWire.js

@@ -89,7 +89,7 @@ export function notePlanReviewAnsweredIfDecisive(questionId, answer) {
     notePlanReviewAnsweredIfDecisiveFor(DEFAULT_SESSION_KEY, questionId, answer);
 }
 /** W1 带 key 变体。 */
-export function notePlanReviewAnsweredIfDecisiveFor(sessionKey, questionId, answer) {
+function notePlanReviewAnsweredIfDecisiveFor(sessionKey, questionId, answer) {
     if (planReviewDecisionFromAnswer(answer ?? { answers: [] }) === 'dismissed')
         return;
     notePlanReviewAnsweredFor(sessionKey, questionId);

package/dist/model/catalogLoader.d.ts

@@ -56,12 +56,6 @@ export declare const DEFAULT_CATALOG_SOURCES: readonly string[];
 export declare const CATALOG_DEFAULT_HOSTS: readonly string[];
 /** 候选链的 env 键(一键安装脚本改这里;settings.json `env` 块同名同义,见 design/166 §2)。 */
 export declare const CATALOG_SOURCES_ENV = "SEMA_CATALOG_SOURCES";
-/** 每源传输预算(design/166 §1:onboard 不能被网络拖住)。 */
-export declare const DEFAULT_CATALOG_TIMEOUT_MS = 3500;
-/** 缓存相对 configHome 的落点(design/166 §3)。 */
-export declare const CATALOG_CACHE_RELATIVE_PATH = "cache/model-catalog.json";
-/** 缓存陈旧阈值:30 天(照用,但如实标 stale)。 */
-export declare const CATALOG_CACHE_STALE_MS: number;
 /**
  * 单源的**传输层**结局。
  *

package/dist/model/catalogLoader.js

@@ -59,11 +59,11 @@ export const CATALOG_DEFAULT_HOSTS = ['raw.githubusercontent.com', 'cdn.jsdelivr
 /** 候选链的 env 键(一键安装脚本改这里;settings.json `env` 块同名同义,见 design/166 §2)。 */
 export const CATALOG_SOURCES_ENV = 'SEMA_CATALOG_SOURCES';
 /** 每源传输预算(design/166 §1:onboard 不能被网络拖住)。 */
-export const DEFAULT_CATALOG_TIMEOUT_MS = 3500;
+const DEFAULT_CATALOG_TIMEOUT_MS = 3500;
 /** 缓存相对 configHome 的落点(design/166 §3)。 */
-export const CATALOG_CACHE_RELATIVE_PATH = 'cache/model-catalog.json';
+const CATALOG_CACHE_RELATIVE_PATH = 'cache/model-catalog.json';
 /** 缓存陈旧阈值:30 天(照用,但如实标 stale)。 */
-export const CATALOG_CACHE_STALE_MS = 30 * 24 * 60 * 60 * 1000;
+const CATALOG_CACHE_STALE_MS = 30 * 24 * 60 * 60 * 1000;
 /** 单源允许的重定向跳数上限(有界:302 环不许把 onboard 转死)。 */
 const MAX_REDIRECTS = 5;
 /** 异常 → 短 detail(只取 message 前段,绝不带栈、绝不带载荷;与 catalog.ts 同一口径)。 */

package/dist/model/providerAuth.d.ts

@@ -131,14 +131,6 @@ export interface DeviceCodeAuthOptions {
     /** 单次 HTTP 预算(缺省 `DEVICE_CODE_HTTP_TIMEOUT_MS`)。 */
     timeoutMs?: number;
 }
-/** 轮询间隔下限(RFC 8628 建议 5s;服务端给更大的值时听服务端的)。 */
-export declare const DEVICE_CODE_MIN_INTERVAL_MS = 5000;
-/** 会话墙钟上限(design/166 §5:15min)。服务端 `expires_in` 更短时听服务端的。 */
-export declare const DEVICE_CODE_MAX_LIFETIME_MS: number;
-/** 429 / slow_down 的退避增量(RFC 8628 §3.5 就是「加 5 秒」)。 */
-export declare const DEVICE_CODE_BACKOFF_STEP_MS = 5000;
-/** 单次 HTTP 预算。 */
-export declare const DEVICE_CODE_HTTP_TIMEOUT_MS = 10000;
 /**
  * 开一次设备码会话 —— **端点由调用方给**(包内表里那一行,或门的合成 descriptor)。
  * 🔴 端点是**编译进包的常量**,不是远端数据,所以本函数不对它再做白名单;真正的门是

package/dist/model/providerAuth.js

@@ -28,13 +28,13 @@ export function providerAuthMethods(preset) {
     return out;
 }
 /** 轮询间隔下限(RFC 8628 建议 5s;服务端给更大的值时听服务端的)。 */
-export const DEVICE_CODE_MIN_INTERVAL_MS = 5000;
+const DEVICE_CODE_MIN_INTERVAL_MS = 5000;
 /** 会话墙钟上限(design/166 §5:15min)。服务端 `expires_in` 更短时听服务端的。 */
-export const DEVICE_CODE_MAX_LIFETIME_MS = 15 * 60 * 1000;
+const DEVICE_CODE_MAX_LIFETIME_MS = 15 * 60 * 1000;
 /** 429 / slow_down 的退避增量(RFC 8628 §3.5 就是「加 5 秒」)。 */
-export const DEVICE_CODE_BACKOFF_STEP_MS = 5000;
+const DEVICE_CODE_BACKOFF_STEP_MS = 5000;
 /** 单次 HTTP 预算。 */
-export const DEVICE_CODE_HTTP_TIMEOUT_MS = 10_000;
+const DEVICE_CODE_HTTP_TIMEOUT_MS = 10_000;
 /** 异常 → 短 detail(绝不带栈、绝不带响应体)。 */
 function shortError(e) {
     return (e instanceof Error ? e.message : String(e)).slice(0, 160);

package/dist/model/providerCatalog.d.ts

@@ -47,8 +47,6 @@ export interface ProviderCatalogRow {
     /** 没账号时的注册入口;缺席 = 用 consoleUrl 那条 */
     signupUrl?: string;
 }
-/** api 家族的行内短名(目录行/芯片行两端同一个词,不各自缩写)。 */
-export declare const providerApiShortName: (api: ProviderPreset["api"]) => string;
 /**
  * 全表 → 目录行。**顺序 = 表序**(约束②):这里没有 filter,也没有 sort。
  * `presets` 入参只给测试用(注入一张小表),产品路径恒走 `PROVIDER_PRESETS`。

package/dist/model/providerCatalog.js

@@ -34,7 +34,7 @@ const hostOf = (u) => {
     }
 };
 /** api 家族的行内短名(目录行/芯片行两端同一个词,不各自缩写)。 */
-export const providerApiShortName = (api) => api === 'anthropic-messages' ? 'anthropic' : 'openai';
+const providerApiShortName = (api) => api === 'anthropic-messages' ? 'anthropic' : 'openai';
 /**
  * 全表 → 目录行。**顺序 = 表序**(约束②):这里没有 filter,也没有 sort。
  * `presets` 入参只给测试用(注入一张小表),产品路径恒走 `PROVIDER_PRESETS`。

package/dist/modelCapabilityProbe.d.ts

@@ -186,10 +186,6 @@ export interface ModelProbeResult {
     verdict: string;
     evidence: ModelProbeEvidence;
 }
-/** 固定题面 —— 短、无歧义、任何模型都答得出,且答案长度可判。 */
-export declare const PROBE_PROMPT = "Reply with exactly OK";
-/** 输出上限:够答一句 `OK`,又不至于让一台在思考的网关烧掉一整个预算。 */
-export declare const PROBE_MAX_TOKENS = 64;
 /**
  * 铸一只探测请求体。
  * @param entry  被探测的条目(只取 `id`)

package/dist/modelCapabilityProbe.js

@@ -95,9 +95,9 @@ export const MODEL_PROBE_VERDICTS = Object.freeze([
     'inconclusive',
 ]);
 /** 固定题面 —— 短、无歧义、任何模型都答得出,且答案长度可判。 */
-export const PROBE_PROMPT = 'Reply with exactly OK';
+const PROBE_PROMPT = 'Reply with exactly OK';
 /** 输出上限:够答一句 `OK`,又不至于让一台在思考的网关烧掉一整个预算。 */
-export const PROBE_MAX_TOKENS = 64;
+const PROBE_MAX_TOKENS = 64;
 /**
  * 铸一只探测请求体。
  * @param entry  被探测的条目(只取 `id`)

package/dist/oneShotWireCaps.d.ts

@@ -29,8 +29,6 @@
  * 那个)。PURE — callers pass `env`;caller gates to LIVE mode(mock request shape 不变)。
  */
 import { type EnvLike } from './hostEnv.js';
-/** The env key the shell reads(SEMA_ 命名空间;`-p` 车道 per-request 意图面,非引擎部署面)。 */
-export declare const ONE_SHOT_ENV: "SEMA_HEADLESS_ONE_SHOT";
 /**
  * ENV source → `true`(缺省 ON = `-p` 提交的一次性本性),只有显式 falsy 逃生口
  * ({@link envFlagOff} 拼写集)⇒ `undefined`(不 stamp ⇒ 引擎缺省交互态指引)。

package/dist/oneShotWireCaps.js

@@ -31,7 +31,7 @@
 import { hostEnv } from './hostEnv.js';
 import { envFlagOff } from './envFlag.js';
 /** The env key the shell reads(SEMA_ 命名空间;`-p` 车道 per-request 意图面,非引擎部署面)。 */
-export const ONE_SHOT_ENV = 'SEMA_HEADLESS_ONE_SHOT';
+const ONE_SHOT_ENV = 'SEMA_HEADLESS_ONE_SHOT';
 /**
  * ENV source → `true`(缺省 ON = `-p` 提交的一次性本性),只有显式 falsy 逃生口
  * ({@link envFlagOff} 拼写集)⇒ `undefined`(不 stamp ⇒ 引擎缺省交互态指引)。

package/dist/peerFrames.d.ts

@@ -89,17 +89,6 @@ export type PeerFrameProjection = AgentMessageFrame | CrossSessionMessageFrame |
  * 后者是一张 15 键白名单,这三条载体一个都不在里面。
  */
 export declare function classifyPeerNotification(n: Record<string, unknown>): PeerFrameProjection | null;
-/**
- * core `ENGINE_AUTHORITY_ENVELOPE_TAGS` 的镜像(`core/untrusted-text.ts::ENGINE_ENVELOPES` 里 kind="authority" 的标签):
- * 这些信封在模型面/转录面代表**引擎权威**,一段同事正文里出现它们就是伪造。core 的 `neutralizePeerBody`
- * (= `sanitizeUntrustedText(body, PEER_BODY_ENVELOPE_TAGS)`)在渲染信封**之前**先把它们拆火(`<` 后插 ZWSP),
- * 本模块首版只抄了后一步(同名信封拆火)——异源发包扫描 [high] 实证:子代正文里一段
- * `<task-notification><task-id>victim</task-id><status>completed</status>…` 会原样进转录 block,
- * 宿主 resume 时 `parseTranscriptNotificationSeeds` 把它读成真完成通知 ⇒ 去重台账被毒化,受害 run 的
- * 真完成通知随后被跨通道臂整条吞掉。这里补上那一步,并与 core 同形(`<\s*\/?\s*(tag)(\s[^>]*)?>` 全大小写)。
- * 🔴 单向(与 core 一致):端的解析腿**不**还原 ZWSP —— 拆掉的权威标签就该永远是拆掉的。
- */
-export declare const AUTHORITY_ENVELOPE_TAGS: readonly ["system-reminder", "task-notification", "new-diagnostics", "user_memory", "scope", "skills", "total_tokens", "instruction-files"];
 /**
  * 投影 → 转录行文本(端的消息面按标签分派的那一份)。
  *

package/dist/peerFrames.js

@@ -225,7 +225,7 @@ export function classifyPeerNotification(n) {
  * 真完成通知随后被跨通道臂整条吞掉。这里补上那一步,并与 core 同形(`<\s*\/?\s*(tag)(\s[^>]*)?>` 全大小写)。
  * 🔴 单向(与 core 一致):端的解析腿**不**还原 ZWSP —— 拆掉的权威标签就该永远是拆掉的。
  */
-export const AUTHORITY_ENVELOPE_TAGS = Object.freeze([
+const AUTHORITY_ENVELOPE_TAGS = Object.freeze([
     'system-reminder',
     'task-notification',
     'new-diagnostics',

package/dist/promptProfileWireCaps.d.ts

@@ -12,6 +12,5 @@
  * 同款)。CALLER 前置 live 门(mock 形不变)。
  */
 import { type EnvLike } from './hostEnv.js';
-export declare const PROMPT_PROFILE_ENV: "SEMA_PROMPT_PROFILE";
 export type PromptProfile = 'simple' | 'classic';
 export declare function promptProfileFromEnv(env?: EnvLike): PromptProfile | undefined;

package/dist/promptProfileWireCaps.js

@@ -12,7 +12,7 @@
  * 同款)。CALLER 前置 live 门(mock 形不变)。
  */
 import { hostEnv } from './hostEnv.js';
-export const PROMPT_PROFILE_ENV = 'SEMA_PROMPT_PROFILE';
+const PROMPT_PROFILE_ENV = 'SEMA_PROMPT_PROFILE';
 export function promptProfileFromEnv(env = hostEnv()) {
     const raw = env[PROMPT_PROFILE_ENV];
     const s = typeof raw === 'string' ? raw.trim().toLowerCase() : '';

package/dist/seam.d.ts

@@ -9,7 +9,7 @@
 import type { ModelUsage, SDKMessage } from '@sema-agent/agent-types';
 import type { EngineTurnUsage } from './adapter/downstream/turnUsageToModelUsage.js';
 import type { RunCostReconcile } from './adapter/downstream/terminalToSdkResult.js';
-import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestHookEntryView, WiringManifestLspSeamView, ContextUsageSectionView } from './adapter/downstream/eventToSdkMessage.js';
+import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestHookEntryView, WiringManifestLspSeamView, WiringManifestWriteProtectionView, ContextUsageSectionView } from './adapter/downstream/eventToSdkMessage.js';
 import type { ToolRosterView, ToolRosterDeltaView } from './toolRoster.js';
 /**
  * `AbortSignal` 的结构型(B3 扩容,SEAM-GAP-4)。
@@ -593,6 +593,8 @@ export interface WiringManifestChromeEvent {
     hooks?: readonly WiringManifestHookEntryView[];
     /** CC-08 ①:第六段 —— LSP 接缝(在场 iff 解析出了 manager 席;`mounted` 与 `lane` 禁合读)。 */
     lsp?: WiringManifestLspSeamView;
+    /** core 7.20.1(0.71.4):第七段 —— 写保护判官自报 targetView(present-iff 编译出判官;🔴 缺席 = 第三态,不折 spelling-only)。 */
+    writeProtection?: WiringManifestWriteProtectionView;
     /** core 铸的事件身份(uuidv7 形);wire 未必带 ⇒ 缺席时本键不在场。 */
     eventId?: string;
 }

package/dist/toolResult.d.ts

@@ -107,23 +107,6 @@ export type ModelFacingTaskOutput = {
 export declare function parseModelFacingTaskOutput(text: string): ModelFacingTaskOutput;
 export declare function backgroundReceiptParseCalls(): number;
 export declare function _resetBackgroundReceiptParseCountForTest(): void;
-/**
- * T14 回落 —— 后台回执**三代文案**正则(#117a:core ≥1.283 的 `Command running in background` 是
- * 第三代)。structured bash 在场时由 `background`/`task_id` 位取代(见 `wireOutputToBody`)——
- * **该函数在 structured 权威时必须零调用**(`wireOutputToBody` 的 T14 分支已经这样接线;
- * `backgroundReceiptParseCalls()` 是这条不变量的仪器)。
- * 🔴 legacy 回落登记(REF-CC-域词表-04):三代并列是本函数唯一存在的理由 —— 旧分支不能删,
- * 是因为不知道哪个仍在跑的引擎版本还只发这三代文案里的某一代。**何时可删**:当
- * `run-engine-vocab-floor-test.mjs`(engine-vocab 门)确认全部受支持的引擎地板版本都已发
- * `structured.type === 'bash'` 的 `task_id`/`background.task_id` 位(即 structured 白名单成为
- * **唯一**判据,不再有 tolerate-absent 的老引擎在保修窗内)时,本函数随之退役;
- * `detectEngineBgShellReceipt`(#117a 面板探测器,复用同一份 `THREE_GEN_BG_RECEIPT_RE`)另行
- * 评估——它的存在理由不是「structured 回落」而是「引擎侧秒关该卡、只能靠回执文案桥」,
- * 不随本函数退役自动失效。
- */
-export declare function parseBackgroundReceipt(text: string): {
-    taskId: string;
-} | null;
 /**
  * T8 —— 压平非均匀 §E1 `output`(`string` | `(Text|Image)[]`)。
  * ⚠️ 真源在 adapt.ts(A 层 settle 报告也用同一份),本文件只 import,别再写第二份。

package/dist/toolResult.js

@@ -327,7 +327,7 @@ export function _resetBackgroundReceiptParseCountForTest() {
  * 评估——它的存在理由不是「structured 回落」而是「引擎侧秒关该卡、只能靠回执文案桥」,
  * 不随本函数退役自动失效。
  */
-export function parseBackgroundReceipt(text) {
+function parseBackgroundReceipt(text) {
     backgroundReceiptParseCount++;
     const bg = THREE_GEN_BG_RECEIPT_RE.exec(text);
     return bg?.[1] !== undefined ? { taskId: bg[1] } : null;

package/dist/ultracodeWireCaps.d.ts

@@ -56,9 +56,6 @@ export declare function ultracodeFromInput(humanInput: string | undefined): true
  */
 export declare function ultracodeForRequest(humanInput: string | undefined): true | undefined;
 export declare function workflowFromInput(humanInput: string | undefined): true | undefined;
-/** Env escape hatch for the deferred-Workflow factory default: `SEMA_WORKFLOW_DEFER=0/false/no/off` restores the
- *  pre-[1052] always-exposed shape (schema bytes back in the prefix). Anything else (incl. unset) = defer ON. */
-export declare const WORKFLOW_DEFER_ENV: "SEMA_WORKFLOW_DEFER";
 /**
  * [1052]① 收官形(clay 裁 B 的 core deferred 机制件,cli 接线半场):Workflow「全局默认开但不暴露」——
  * 未命中激活源的 TaskRequest 带 `deferTools:["Workflow"]`(core 1.314 对已挂载工具做 design/36 延迟披露:

package/dist/ultracodeWireCaps.js

@@ -87,7 +87,7 @@ export function workflowFromInput(humanInput) {
 }
 /** Env escape hatch for the deferred-Workflow factory default: `SEMA_WORKFLOW_DEFER=0/false/no/off` restores the
  *  pre-[1052] always-exposed shape (schema bytes back in the prefix). Anything else (incl. unset) = defer ON. */
-export const WORKFLOW_DEFER_ENV = 'SEMA_WORKFLOW_DEFER';
+const WORKFLOW_DEFER_ENV = 'SEMA_WORKFLOW_DEFER';
 /** 拼写集 = {@link envFlagOff}(REF-CC-141 dup-02 单源)。 */
 function deferOptedOut(env) {
     return envFlagOff(env[WORKFLOW_DEFER_ENV]);