@sema-agent/client-core 0.71.4 → 0.72.1

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/resumeRefusalCopy.d.ts

@@ -1,3 +1,44 @@
+/**
+ * src/resumeRefusalCopy.ts — resume 族**拒绝文案的三端单一铸点**(L-102 下半场,0.58.0)。
+ *
+ * ── 这一件上收的是什么 ──────────────────────────────────────────────────────────────────────
+ * 0.57.0 已经把 L-102 的**事实读数**上收了({@link resumeRetryLaterFromError}:命中哪个码、
+ * server 给没给窗、等一会儿有没有用)。留在壳里的另一半是**人话** —— cli 1.0.x 的
+ * `src/sema/resumeRefusalCopy.ts` 自铸了一份判型 + 三句 `·` 分段文案,而 web-client / desktop
+ * 各自要么没有、要么将来会再抄一份。三端各抄一份文案 = 同一次拒绝在三个端上说三句不一样的话,
+ * 而这三句话回答的是**同一个安全问题**:「这次拒绝有没有消费掉我的决定 / 这张卡还能不能再决」。
+ * ⇒ 文案与判型同属**判定归包、呈现归端**里的「判定」那一半,本模块是它的单一铸点。
+ *
+ * ── 与 0.57.0 §21 那一口的分工(两个闭集刻意分家)──────────────────────────────────────────
+ * · {@link RESUME_RETRY_LATER_CODES}(engineErrorCodes.ts,0.57.0)闭的是「**server 在哪些码上铸
+ *   `retryAfterSec`**」——它回答**能不能等**;
+ * · {@link RESUME_REFUSAL_CODES}(本文件)闭的是「**哪些 resume 拒绝有人话可补**」——它回答
+ *   **该对人说什么**。
+ * 两集**交于** `resume.preflight_rejected` 一码、**各有**一个独占成员
+ * (`resume.usage_window_exhausted` 只在前者 / `resume.placement_mismatch` 只在后者),所以它们
+ * 不是同一张表的两个名字。🔴 **本模块不复制判定**:`preflight_rejected` 的窗与可等性一律**转调**
+ * `resumeRetryLaterFromError`,本文件里没有第二个 `retryAfterSec` 窄读器
+ * ([paired-mechanisms-must-share-premise]:两处各自判必然在某一格上分叉)。
+ *
+ * ── `retryAfterSec` 的窄读域比 cli 1.0.x 现行的更窄(端提货时要知道的差分)──────────────────
+ * cli 那份自铸读器收的是「有限数 ∧ ≥0」;本口沿用 §21 的域 =「**整数 ∧ ≥1**」,坏值一律降缺席:
+ *   · server 的铸键逐字是「ms → 秒**向上取整**、**下限 1**」⇒ 真供给里不存在 0 / 负数 / 小数;
+ *   · 放行 `0` 就是对端说「立刻重试」,而 resume 是 AT-MOST-ONCE 的**有副作用**动作(叫醒 = 真跑
+ *     一轮)—— 一个 0 会把「等一会儿」变成热循环;
+ *   · 放行小数会让端渲出「等 0.4 秒」这种上游从未说过的量。
+ * ⇒ 壳提货后在这三形上的**行为会变**(从「渲一个 0 秒等待」变成「不渲等待行」),这是**修好**
+ * 不是回归([verdict-must-accept-stronger-form])。
+ *
+ * ── 开集纪律(与 cli 那份逐字同律)────────────────────────────────────────────────────────
+ * 🔴 判型是**闭集**的(只认下面两个码),消费面是**开集**的:不认识的码一律 `null` ⇒ 端一个字
+ *    都不补 ⇒ 机器可读那一行(`API Error: <status> <errorCode> · <msg>`)原样上屏。
+ *    **绝不按前缀/子串猜一族码的语义** —— `resume.` 前缀下同时住着「等就好」「换参数」「没救了」
+ *    三种处置。
+ * 🔴 文案**不复述** server 的 message(那一行已经在屏上了),只补 message 里没有的那件事。
+ * 🔴 文案里**不铸等待的秒数**:那一行由端用 {@link ResumeRefusalDetail.retryAfterSec} 单独渲
+ *    (cli 的 `retryAfterHint` 是那一位的唯一取值口),在这里再说一遍就是同一个数字上屏两遍。
+ */
+import { RESUME_CONTEXT_UNAVAILABLE } from './engineErrorCodes.js';
 /**
  * 本模块认识的 resume 拒绝码(**闭集**)—— 「有人话可补」的那两个。
  *
@@ -83,3 +124,36 @@ export declare function resumeReopenFromError(err: unknown): ResumeReopenDetail
  * 🔴 零内部车道词(DS-04):只说用户能做的事;不复述 server 的 message(那一行已在屏上)。
  */
 export declare function resumeReopenContent(detail: ResumeReopenDetail): string;
+/** {@link resumeContextUnavailableFromError} 的结构化读数。 */
+export interface ResumeContextUnavailableDetail {
+    /** 恒为 {@link RESUME_CONTEXT_UNAVAILABLE}(留字段是为了与本文件其它读数同形,消费端可按 `code` 分派)。 */
+    code: typeof RESUME_CONTEXT_UNAVAILABLE;
+    /**
+     * 该部署当下的会话保留时长(整数秒;server 逐字 = `REAP_RUN_STALE_SEC` 真值,与回收器用的是同一个值)。
+     * 🔴 窄读域 = 整数 ∧ ≥1(与 `retryAfterSec` 同律);坏值**降缺席**不降 0。
+     * 🔴 缺席 = **没读到**:老 server(<7.80.1)不铸这一位,**sdk 9.6.0 也还没把它带到错误对象上**
+     *    (`ConflictError` 只带 activeTaskId 三件)⇒ 经 sdk 的端今天恒缺席;这不是「保留时长为零」,
+     *    端渲「部署保留时长」那一行时缺席就**不渲**([honest-absence-not-fabricated-zero])。
+     */
+    staleAfterSec?: number;
+    /** 这条 run 的 id(体上既有键;非空串才在场)—— 出路①「自己恢复这条 run」用的句柄。缺席同上(sdk 未带)。 */
+    runId?: string;
+}
+/**
+ * 被 catch 的错误 → 「批准无处投递:上下文当前不可用」读数;不是本码 ⇒ `null`(绝不误吃别的 `conflict.*`)。
+ *
+ * 🔴 duck-typed 不 `instanceof`、键位只认 `errorCode`(与 {@link resumeRefusalFromError} 同律;退役 `code` 槽不做兼容)。
+ * 🔴 **本码不进两个 resume 闭集**:server 在上下文被回收 **或读取失败** 时都发它,能不能等 wire 上没有判别位 ⇒ 不进「可等」集;
+ *    也不是「换参数重来」⇒ 不进 refusal 集;出路见文案第三句(按 `runId` 在场与否)。
+ * 🔴 `staleAfterSec` / `runId` 都按结构读:server 铸在体上、sdk 今天没搬上来 ⇒ 缺席;sdk 出键当天自动填满,本包零改动。
+ */
+export declare function resumeContextUnavailableFromError(err: unknown): ResumeContextUnavailableDetail | null;
+/**
+ * 读数 → 人话三句(`·` 分段,与 {@link resumeRefusalContent} 同形):①发生了什么 · ②你的决定没被消费 · ③出路。
+ * 🔴 **只凭码不推断原因**(异源对抗复审实抓):server 在「上下文被回收」与「上下文读取失败(如存储故障)」两种情况下
+ *    都返回本码,wire 上没有判别位 ⇒ 第一句只说「当前没有可用的上下文来继续它」,不说「等得太久 / 已被回收」。
+ * 🔴 **调大保留时长救不回这一次**(上下文已删就是删了),它只能避免以后再发生 ⇒ 第三句按 `runId` 在场与否给恢复指引,
+ *    保留时长只作预防句。零内部车道词;不铸秒数(保留时长由端按 {@link ResumeContextUnavailableDetail.staleAfterSec}
+ *    单独渲,缺席就不渲)。
+ */
+export declare function resumeContextUnavailableContent(d: ResumeContextUnavailableDetail): string;

package/dist/resumeRefusalCopy.js

@@ -38,7 +38,7 @@
  * 🔴 文案里**不铸等待的秒数**:那一行由端用 {@link ResumeRefusalDetail.retryAfterSec} 单独渲
  *    (cli 的 `retryAfterHint` 是那一位的唯一取值口),在这里再说一遍就是同一个数字上屏两遍。
  */
-import { RESUME_PLACEMENT_MISMATCH, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_ENV_FAILED, RESUME_TOOL_UNAVAILABLE, } from './engineErrorCodes.js';
+import { RESUME_CONTEXT_UNAVAILABLE, RESUME_PLACEMENT_MISMATCH, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_ENV_FAILED, RESUME_TOOL_UNAVAILABLE, } from './engineErrorCodes.js';
 import { resumeRetryLaterFromError } from './wireErrorTriage.js';
 /**
  * 本模块认识的 resume 拒绝码(**闭集**)—— 「有人话可补」的那两个。
@@ -157,3 +157,44 @@ export function resumeReopenContent(detail) {
         'Re-fetch the pending approvals and decide again on an engine where the same tool is available',
     ].join(' · ');
 }
+/**
+ * 被 catch 的错误 → 「批准无处投递:上下文当前不可用」读数;不是本码 ⇒ `null`(绝不误吃别的 `conflict.*`)。
+ *
+ * 🔴 duck-typed 不 `instanceof`、键位只认 `errorCode`(与 {@link resumeRefusalFromError} 同律;退役 `code` 槽不做兼容)。
+ * 🔴 **本码不进两个 resume 闭集**:server 在上下文被回收 **或读取失败** 时都发它,能不能等 wire 上没有判别位 ⇒ 不进「可等」集;
+ *    也不是「换参数重来」⇒ 不进 refusal 集;出路见文案第三句(按 `runId` 在场与否)。
+ * 🔴 `staleAfterSec` / `runId` 都按结构读:server 铸在体上、sdk 今天没搬上来 ⇒ 缺席;sdk 出键当天自动填满,本包零改动。
+ */
+export function resumeContextUnavailableFromError(err) {
+    if (typeof err !== 'object' || err === null)
+        return null;
+    const e = err;
+    if (e.errorCode !== RESUME_CONTEXT_UNAVAILABLE)
+        return null;
+    const sec = e.staleAfterSec;
+    const staleSec = typeof sec === 'number' && Number.isInteger(sec) && sec >= 1 ? sec : undefined;
+    const runId = typeof e.runId === 'string' && e.runId.length > 0 ? e.runId : undefined;
+    return {
+        code: RESUME_CONTEXT_UNAVAILABLE,
+        ...(staleSec !== undefined ? { staleAfterSec: staleSec } : {}),
+        ...(runId !== undefined ? { runId } : {}),
+    };
+}
+/**
+ * 读数 → 人话三句(`·` 分段,与 {@link resumeRefusalContent} 同形):①发生了什么 · ②你的决定没被消费 · ③出路。
+ * 🔴 **只凭码不推断原因**(异源对抗复审实抓):server 在「上下文被回收」与「上下文读取失败(如存储故障)」两种情况下
+ *    都返回本码,wire 上没有判别位 ⇒ 第一句只说「当前没有可用的上下文来继续它」,不说「等得太久 / 已被回收」。
+ * 🔴 **调大保留时长救不回这一次**(上下文已删就是删了),它只能避免以后再发生 ⇒ 第三句按 `runId` 在场与否给恢复指引,
+ *    保留时长只作预防句。零内部车道词;不铸秒数(保留时长由端按 {@link ResumeContextUnavailableDetail.staleAfterSec}
+ *    单独渲,缺席就不渲)。
+ */
+export function resumeContextUnavailableContent(d) {
+    const third = d.runId !== undefined
+        ? '错误里带了这条运行的 id,请用它自己恢复这条运行再决;调大会话保留时长只能避免以后再发生,救不回这一次'
+        : '错误里没有带运行 id,请回到运行列表找到这条运行自己恢复它再决;调大会话保留时长只能避免以后再发生,救不回这一次';
+    return [
+        '这个批准无处投递:发起这次运行的会话当前没有可用的上下文来继续它',
+        '什么都没有被决定,你的决定没有被消费,这张卡仍在等待',
+        third,
+    ].join(' · ');
+}

package/dist/skillsWireCaps.d.ts

@@ -77,4 +77,34 @@ export declare function toCappedSpec(name: string, description: string, whenToUs
  * unit-testable. Only MODEL-INVOCABLE prompt skills are sent — UI-only / `disableModelInvocation` commands
  * are excluded (engine injection feeds the model's Skill tool, not the slash menu).
  */
-export declare function skillCommandsToSpecs(cmds: SkillCmdLike[], resolveBody: (cmd: SkillCmdLike) => string | null): SkillSpec[];
+/** `SkillSpec` 上 wire 的形:0.72.1 起可带 `baseDir`(server ≥7.80.1 / core 7.20.0 #799;sdk 9.6.0 的 `SkillSpec` 还没声明它,
+ *  所以本包用交叉型出口 —— 赋给 `TaskRequestBody.skills: SkillSpec[]` 零摩擦)。 */
+export type SkillSpecOnWire = SkillSpec & {
+    baseDir?: string;
+};
+/** {@link skillCommandsToSpecs} 的开关。 */
+export interface SkillSpecsOptions {
+    /**
+     * 工具是否跑在**加载这些技能的这台机器**上(单用户 host 车道 = true)。
+     * 🔴 只有 true 才带 `baseDir`:它是「工具执行环境那台机器上的坐标」,沙箱 / 远端车道(k8s / e2b / ssh / device)上
+     *    本机路径在那边不存在,带过去只是假线索 ⇒ 缺席(fail-closed,与 server 出厂自扫技能在那些车道上不带同律)。
+     *    缺席 = 引擎不加首行、不做 `${SKILL_ROOT}` 替换,结果与 0.72.0 之前逐字节相同。
+     */
+    toolsRunHere?: boolean;
+    /**
+     * server 判 `baseDir` 用的是它自己那台机器上的 `node:path.isAbsolute`(平台相关):Linux / macOS 上 `C:\\x` **不是**绝对路径
+     * (整条提交 400),Windows 上 UNC `\\\\host\\share\\x` 才算。本包不知道 server 跑在哪个平台 ⇒ 由调用方声明;缺席 = `'posix'`
+     * (server 出厂镜像与三端 host 车道的常态)。声明错 = server 400 整拒,不是静默降级。
+     */
+    platform?: 'posix' | 'win32';
+}
+/**
+ * `SkillSpec.baseDir` 的窄读:与 server 顶层门**同一只**结构判据(绝对路径、无 `..` 段、无 NUL、≤ 4096 字符;**不做存在性检查**)。
+ * 🔴 「绝对路径」按 **server 所在平台**的 `node:path.isAbsolute` 判(异源对抗复审实抓:此前把盘符路径在 posix 上也放行 = 送出去必 400):
+ *    · `'posix'`(默认):只有 `/…` 算;`C:\\x` / `\\\\host\\share` 都不算;
+ *    · `..` 段检查两个平台都按 `/` **与** `\\` 拆(server `isValidCwd` 在所有平台都这么拆);
+ *    · `'win32'`:`X:\\…` / `X:/…` 与 UNC `\\\\host\\share\\…` 算;段按 `\\` 与 `/` 切。
+ * 不合判据 ⇒ `undefined`(不发假坐标;在本包拦下比让 server 400 整拒更诚实)。
+ */
+export declare function skillBaseDirOf(skillRoot: string | undefined, platform?: 'posix' | 'win32'): string | undefined;
+export declare function skillCommandsToSpecs(cmds: SkillCmdLike[], resolveBody: (cmd: SkillCmdLike) => string | null, opts?: SkillSpecsOptions): SkillSpecOnWire[];

package/dist/skillsWireCaps.js

@@ -39,13 +39,33 @@ export function toCappedSpec(name, description, whenToUse, body) {
     return { name: n, description: desc, content: c };
 }
 /**
- * PURE projection: loaded skill commands → `SkillSpec[]` (content-capped, deduped by name; 0.70.0: NO item cap —
- * every eligible skill goes on the wire, the engine budgets the listing). `resolveBody`
- * supplies each command's raw SKILL.md body (null ⇒ skip); injecting it keeps this function IO-free and
- * unit-testable. Only MODEL-INVOCABLE prompt skills are sent — UI-only / `disableModelInvocation` commands
- * are excluded (engine injection feeds the model's Skill tool, not the slash menu).
+ * `SkillSpec.baseDir` 的窄读:与 server 顶层门**同一只**结构判据(绝对路径、无 `..` 段、无 NUL、≤ 4096 字符;**不做存在性检查**)。
+ * 🔴 「绝对路径」按 **server 所在平台**的 `node:path.isAbsolute` 判(异源对抗复审实抓:此前把盘符路径在 posix 上也放行 = 送出去必 400):
+ *    · `'posix'`(默认):只有 `/…` 算;`C:\\x` / `\\\\host\\share` 都不算;
+ *    · `..` 段检查两个平台都按 `/` **与** `\\` 拆(server `isValidCwd` 在所有平台都这么拆);
+ *    · `'win32'`:`X:\\…` / `X:/…` 与 UNC `\\\\host\\share\\…` 算;段按 `\\` 与 `/` 切。
+ * 不合判据 ⇒ `undefined`(不发假坐标;在本包拦下比让 server 400 整拒更诚实)。
  */
-export function skillCommandsToSpecs(cmds, resolveBody) {
+export function skillBaseDirOf(skillRoot, platform = 'posix') {
+    if (skillRoot === undefined || skillRoot.length === 0 || skillRoot.length > 4096)
+        return undefined;
+    if (skillRoot.includes('\u0000'))
+        return undefined;
+    if (platform === 'win32') {
+        if (!(/^[A-Za-z]:[\\/]/.test(skillRoot) || /^\\\\[^\\/]+[\\/][^\\/]+/.test(skillRoot)))
+            return undefined;
+        if (skillRoot.split(/[\\/]/).includes('..'))
+            return undefined;
+        return skillRoot;
+    }
+    if (!skillRoot.startsWith('/'))
+        return undefined;
+    // `..` 段两种分隔符都拆(server isValidCwd 在所有平台都按 /[/\\]/ 拆段;POSIX 文件名可含反斜杠 —— 复审第 2 轮实抓)
+    if (skillRoot.split(/[\\/]/).includes('..'))
+        return undefined;
+    return skillRoot;
+}
+export function skillCommandsToSpecs(cmds, resolveBody, opts) {
     const specs = [];
     const seen = new Set();
     for (const cmd of cmds) {
@@ -58,7 +78,8 @@ export function skillCommandsToSpecs(cmds, resolveBody) {
         if (!spec || seen.has(spec.name))
             continue;
         seen.add(spec.name);
-        specs.push(spec);
+        const baseDir = opts?.toolsRunHere === true ? skillBaseDirOf(cmd.skillRoot, opts.platform ?? 'posix') : undefined;
+        specs.push(baseDir !== undefined ? { ...spec, baseDir } : spec);
     }
     return specs;
 }

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]);