@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/engineErrorCodes.d.ts

@@ -1,376 +1,61 @@
-/**
- * src/engineErrorCodes.ts — **引擎 wire 码词表的单一真源**(G1 去字面化,2026-08-04,
- * core 5.10.0 / sdk 6.2.0 消费半场)。
- *
- * ── 为什么要有这个文件 ────────────────────────────────────────────────────────────────────────
- * 引擎的 `errorCode` 是**机器码**(结构位),壳的四条判别链都吃它:终帧 subtype 映射
- * (`adapter/downstream/terminalToSdkResult.ts`)、409 busy 判别(`adapter/runStream.ts`)、
- * `stop.*` 五形分类(`subagent/engineTaskHandleWire.ts`)、限额面文案(`limitsWire.ts`)。
- * 收编前这些码以**裸字面量**散在五个文件、二十余处:core 每次词表迁移(5.8.0 的 `budget.*` →
- * `limits.*`、5.10.0 的 `config.*` 第四波)都要满仓 grep `===` 比较,漏一处的后果不是报错而是
- * **判别链静默走错臂** —— 这正是 [dep-bump-follow-on-checklist] 那类跟车事故的载体。
- *
- * ── 🔴 开集纪律(本文件最重要的一条)──────────────────────────────────────────────────────────
- * **wire 的 `errorCode` 是开集**:引擎完全可能比本包新一版,发一个这里没有的码。所以:
- *   · 本文件的 `ReadonlySet` / 前缀谓词一律是**识别表**(recognition table),回答的是
- *     「我认不认得这个码」,**绝不是**「合法码只有这些」;
- *   · 消费点的 `switch` 必须留 `default`、`if` 必须留 else 臂,未知码一律**原样透传**
- *     + 落诚实兜底臂,绝不塌进任何一个已知形(塌进去 = 替 server 编了一个它没说的原因);
- *   · 唯一的**闭集**是 {@link ModelFallbackReason} —— 它是 core 亲自声明的闭集单成员
- *     ([2577] 定谳),加成员 = BREAKING 清单行,所以它写成 string literal union 而不是 `string`。
- *     这条例外**只此一处**,别照抄到别的码上。
- *
- * ── 命名与来源 ────────────────────────────────────────────────────────────────────────────────
- * 每一族下方注出它的 core 版本与出处帖号;码的字面**永远以引擎为准**,本文件只是镜子。
- * 词表变动集中在一处可数(与 `terminalToSdkResult.ts` 那三个集合原本的立意同),提货批 diff 里
- * 一眼能看出「这一版引擎加了哪几个词」。
- */
-/** token 预算到限。`result` 可能带已产出正文([2489] 明记)。 */
 export declare const LIMITS_MAX_TOKENS_EXCEEDED = "limits.max_tokens_exceeded";
-/** 成本预算到限(唯一一个 CC 有专门 subtype 的预算轴)。 */
 export declare const LIMITS_MAX_COST_EXCEEDED = "limits.max_cost_exceeded";
-/** 轮数预算到限。 */
 export declare const LIMITS_MAX_TURNS_EXCEEDED = "limits.max_turns_exceeded";
-/** 墙钟预算到限(5.8.0 起是**响亮终局** `status:'failed'`;`status:'timeout'` 该终态词整体退役)。 */
 export declare const LIMITS_MAX_WALLTIME_EXCEEDED = "limits.max_walltime_exceeded";
-/**
- * 该码是否属「引擎侧治理限额到限」族。**开集前缀判**(与 {@link isConfigRefusalCode} 同款):
- * core 每加一根新的限额轴(`limits.max_*`)判别自动跟上,按成员判的消费点则要跟车。
- *
- * 🔴 用途边界:这一族回答的是「谁停的这条 run」= **本部署的治理旋钮**,不是 provider/HTTP 故障。
- * 呈现层据此避开 `API Error:` 那个身份声明(见 `adapter/runStream.ts` 的 governance 臂)——
- * 把一次「轮数用光了」说成 API 错误,用户会去查网络/密钥/额度,而真正的把手是 `--max-turns`。
- */
 export declare function isLimitsExceededCode(code: string | undefined): boolean;
-/** 部署级 token 治理窗耗尽。**唯一携带可执行等待量的停因**,与 `retryAfterMs` 配对到货。
- *  5.10.0 起:治理窗与环境寿命同一轮边界到期时,**窗赢**(此前 env-first 报告把它丢了)。 */
 export declare const USAGE_WINDOW_EXHAUSTED = "usage.window_exhausted";
-/** 环境寿命到期(平台侧)。与上一条同轮到期时**让位**给它。 */
 export declare const ENV_LIFETIME_EXPIRED = "env.lifetime_expired";
-/** `TaskRequest.limits` 各门(runTeamDiscussion 累计额 / workflow 治理 TRUSTED 半 /
- *  `resourceSuspend` 四键)拒绝不可求值的值。 */
 export declare const CONFIG_LIMIT_INVALID = "config.limit_invalid";
-/** `StrategyStore.find(scope, query, limit)` 的 limit 非「非负整数或 Infinity」。 */
 export declare const CONFIG_STRATEGY_FIND_LIMIT_INVALID = "config.strategy_find_limit_invalid";
-/** `StrategyStore.prune` / `InMemoryStrategyStore` 构造的容量上限非非负整数(含点名拒 `Infinity`
- *  —— 容量帽可以放宽,不可以关掉)。 */
 export declare const CONFIG_STRATEGY_MAX_SIZE_INVALID = "config.strategy_max_size_invalid";
-/** 未知的 limits 键(5.8.0 起:同时发新旧两代键会在这里当场失败,所以写面只发单一新形)。 */
 export declare const CONFIG_LIMIT_UNKNOWN_KEY = "config.limit_unknown_key";
-/**
- * `RunnerDeps.delegationEntryCaps`(core 5.48.0 / design/323,[4743] @cli 点名件)的坏值拒。
- *
- * 两种拒绝形:成员不是正整数(NaN / 0 / 负数 / 分数 / 非数),或**解出的一对**满足
- * `maxConcurrent > maxCumulativePerSession`(一棵树不可能同时跑得比它这辈子能创建的还多 ——
- * 这是矛盾不是偏好)。缺席成员取 CC 对齐缺省(20 / 200)。
- * 🔴 与本族其余成员同律:**坏旋钮响亮拒,绝不静默折回缺省**。
- */
 export declare const CONFIG_DELEGATION_ENTRY_CAPS = "config.delegation_entry_caps";
-/** 记忆面 project key 的拼写不合法(**400**;构造期拒,什么都没跑)。 */
 export declare const CONFIG_MEMORY_PROJECT_KEY_SPELLING = "config.memory_project_key_spelling";
-/** 这次请求的记忆写入范围与已生效的那一份不一致(**409**;构造期拒,什么都没跑 —— 冲突,不是拼写错)。 */
 export declare const CONFIG_MEMORY_WRITE_SCOPE_MISMATCH = "config.memory_write_scope_mismatch";
-/**
- * 已知的配置拒绝码(**识别表,非白名单**)。判「这是不是一条配置拒绝」请用
- * {@link isConfigRefusalCode} —— 它按 `config.` 前缀判,未来新成员自动落进来。
- */
 export declare const CONFIG_REFUSAL_CODES: ReadonlySet<string>;
-/** 并发帽:这棵树此刻活着的委派席位已达 `delegationEntryCaps.maxConcurrent`(CC 对齐缺省 20)。
- *  🔴 处置 = **可等**(兄弟结束即有位),别渲成「配置要改」。 */
 export declare const DELEGATION_CONCURRENCY_CAP = "delegation.concurrency_cap";
-/** 累计帽:这棵树在 **retained window** 内创建的委派席位已达 `maxCumulativePerSession`
- *  (CC 对齐缺省 200)。🔴 处置 = **复用既有 agent(SendMessage)或候 retention 回收**(行被
- *  reap 后配额恢复 —— core 计数前先剪 ledger,见族注),别渲成「换会话」或「改配置」。 */
 export declare const DELEGATION_SESSION_CAP = "delegation.session_cap";
-/** 委派席位到限码识别表(**开集**:core 可能再加第三根轴)。两员处置不对称,消费点禁合并分支。 */
 export declare const DELEGATION_CAP_CODES: ReadonlySet<string>;
-/** `delegation.` 前缀谓词 —— **开集**判别(与 {@link isConfigRefusalCode} 同款)。缺席/空串 ⇒ false。
- *  🔴 它只回答「这是不是一条委派席位拒绝」;**该等新槽还是该复用既有 agent**必须按成员分
- *  ({@link delegationCapDispositionOf}),见两码各自的注释。 */
 export declare function isDelegationCapCode(code: string | undefined): boolean;
-/**
- * 委派席位到限的**处置轴**(0.39.0 消费件:两员处置不对称的机器可读形)。单源在本包 ——
- * 「哪个码该等、哪个码等也没用」是判定不是文案,端各自再抄一份就回到本文件要根除的散抄病。
- */
-export type DelegationCapDisposition = 
-/** 可等:活着的兄弟结束就有位,同一条命令过一会儿照样成(别渲成「配置要改」)。 */
-'wait-for-slot'
-/** 复用而不是新开:retained-window 计数满了 —— 用 SendMessage 续既有 agent(core 文案的
- *  推荐出路),或候 retention 回收行后配额恢复(别渲成「换会话」/「永久耗尽」)。 */
- | 'reuse-existing-or-await-reap';
-/** 两成员各归各格;未知 `delegation.*` 码(core 的第三根轴)⇒ `undefined` —— 开集纪律:不认得
- *  就不给处置,消费点必须留「只报码不指路」的 default 臂,绝不塌进任何一格替引擎指路。 */
+export type DelegationCapDisposition = 'wait-for-slot' | 'reuse-existing-or-await-reap';
 export declare function delegationCapDispositionOf(code: string | undefined): DelegationCapDisposition | undefined;
-/**
- * 已吊销 MCP server 上的调用被拒。core `dist/core/mcp.js` **三个铸点同码**(远端工具调用 /
- * 资源读取 / 目录列举)。载体与 `delegation.*` 两码同批:`{ error, code }` 双键同值 ⇒
- * `tool_end.errorCode`(core ≥5.50.0;载体门 = engine-vocab G3 腿)。
- * 🔴 **哪个 server 被吊销,今天 wire 上拿不到**(异源对抗复审命中,如实登记):core 的
- * detail 确有 `server` 键,但它是**进程内** result 体 —— 抬升腿只 lift `code`,且该 detail 无
- * `type` 进不了 `structured` ⇒ 端只有码没有名。**别按 output 文案抠 server 名当机器判据**
- * (文案是模型面散文,不是契约);归因渲染候上游补 typed detail / tool_end 字段(诉求已
- * 随 0.39.0 发布帖点名 core,表态制)。
- * 🔴 语义三条,一条都别渲错:
- *   · **请求没发出去**(core 文案原话 "The request was NOT sent")—— 是本地闸,不是远端失败;
- *   · 这不是故障也不是配置坏了,是**操作员的治理动作** —— 别渲成「服务器错误,稍后重试」;
- *   · 同 server 重试**无意义**,直到它被重新批准;工具表在下一 turn 更新(core 文案原话)。
- */
 export declare const MCP_SERVER_REVOKED = "mcp.server_revoked";
-/** `config.` 前缀谓词 —— **开集**判别:5.10.0 之后每一波「不许静默折叠」都会往这一族加词,
- *  按前缀判的消费点不必跟车,按成员判的必须跟车。缺席/空串 ⇒ false。 */
 export declare function isConfigRefusalCode(code: string | undefined): boolean;
-/** 该 call 从未真正开始执行(可安全重发)。 */
 export declare const TOOL_END_INTERRUPTED_NEVER_STARTED = "interrupted_never_started";
-/** 该 call 的结局未知(持有它的进程死了 —— 副作用可能已经发生,**不可**当作没跑过)。 */
 export declare const TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN = "interrupted_outcome_unknown";
-/** 这条 `tool_end` 是不是「中断留下的合成收口帧」。未知码 ⇒ false(开集:不认得就不认得,
- *  绝不猜)。 */
 export declare function isInterruptedToolEndCode(code: string | undefined): boolean;
-/**
- * 提交面的 selfOrchestration 准入拒绝(`POST /v1/tasks` 与同闸的 stream 提交,**501**)。
- *
- * 语义:引擎侧的 workflow 开关是开着的(`SELF_ORCHESTRATION_ENABLED=true`),但这台部署处在
- * **半配置的多租户形态** —— 要求 principal、却没有中心侧的准入解析器,于是它无法判「这一位
- * 调用者能不能用 workflow」,fail-closed 拒。请求带 `selfOrchestration:true` **或**
- * `settings.ultracode:true`(后者由 server 展开成前者)就撞这一条;把这两个键去掉,**同一条
- * 请求照常受理**。
- *
- * 🔴 **这是复用码**:它与其它 `capability.*` 501 共用体形,而处置**不同** —— 别的能力位
- * 缺席时去掉这两个键也不会变成可受理。⇒ 消费点必须按**恰等**判,绝不放宽成 `capability.`
- * 前缀判(那是 `sessionMemoryStatus` 那条读面上的另一件事,两者刻意不合流)。
- * 判型与「去键重发一次」的判定归 `src/selfOrchestrationDenial.ts`(文案归端)。
- * 🔴 非布尔的 `selfOrchestration` 走的是 **400**,不是本码 —— 那是「值不对」不是「不给用」。
- */
 export declare const CAPABILITY_SELF_ORCHESTRATION_REQUIRED = "capability.self_orchestration_required";
-/**
- * 「**门把这次调用 park 了**」的机读码(core 5.52.0 `prepare-task` 的
- * `abortResultDetails: () => ({ code: "gate.parked" })`;[4973] 契约:双短路点同席恒铸)。
- *
- * 🔴 **它是「这次调用没有在这里结算」的第二形**(engine 7.64.0 真机黑盒直证):审批窗走完 300s
- *    未决而走 park 路径时,`tool_end` 帧上**没有 `gate` 字段** —— 只有这个码。门记录缺席在那一形上
- *    **不是**「记录坏了」,是「这次调用根本没结算过什么,它被 park 了」。⇒ 任何要回答「这次调用
- *    settle 了没有」的消费点必须**两形都认**:`gate.settlement` 在场那一形,与本码这一形。
- * 🔴 单源:`hitl/frameRouter.ts` 的连坐/中断判据与 `gateOutcome.ts` 的停驻谓词读的是同一个常量 ——
- *    两处各写一份字面量必漂(而漂的那一天两边对同一帧给出相反的判决)。
- */
 export declare const GATE_PARKED_ERROR_CODE = "gate.parked";
-/** 409 session-busy 的 canonical 码([2377]C-1,server main `049ff2c`,随 5.0.0 发)。 */
 export declare const ACTIVE_RUN_BUSY_ERROR_CODE = "conflict.session_active_run";
-/** 仲裁店不可达 ⇒ **真相未知**(core 1.397 三分的第三形;塌进 `not_landed` 是诚实缺陷)。 */
 export declare const STOP_PARK_ARBITER_UNREACHABLE = "stop.park_arbiter_unreachable";
-/** park 的 resume 赢了这场竞争。 */
 export declare const STOP_PARK_RESUME_WON = "stop.park_resume_won";
-/** kill 没落地。 */
 export declare const STOP_NOT_LANDED = "stop.not_landed";
-/** 该任务不在本副本。 */
 export declare const STOP_NOT_LOCAL = "stop.not_local";
-/** 该任务已 park。 */
 export declare const STOP_PARKED = "stop.parked";
-/**
- * 兜底**字面认码**用的已知集(typed 错误缺席时才走这条回落腿)。
- * 🔴 **顺序即语义**:长码优先 —— `stop.parked` 是 `stop.park_resume_won` 的前缀,顺序反了
- * `detail.includes()` 会让短码抢走长码的命中。数组(有序)不是 Set(无序),这是判据的一部分。
- */
 export declare const STOP_CONFLICT_CODES: readonly ["stop.park_arbiter_unreachable", "stop.park_resume_won", "stop.not_landed", "stop.not_local", "stop.parked"];
-/** `outputSchema` 任务在重试上限内没能产出合法结构化输出(语义字面就是 CC 那个 subtype 的话)。 */
 export declare const OUTPUT_INVALID = "output.invalid";
-/**
- * `resume_at.*` 单族前缀(A-028.11 单源化,#244 族E):壳 `isResumeAtRejection`(Esc 杀锚后的
- * 一次性去锚自动重发判型)此前持裸字面 `'resume_at.'` —— 收编到本表。🔴 它**刻意窄于**
- * {@link REWIND_ERROR_CODE_PREFIXES}(不含 `rewind_snapshot.`):自动重发的安全性论证只对
- * resume_at 族做过(pre-stream 零副作用),扩到全 rewind 族属行为变更,须另立项。
- */
 export declare const RESUME_AT_ERROR_CODE_PREFIX = "resume_at.";
-/**
- * 用户**可自解**的操作性错误的码前缀(选错回退目标 / 回退过根 / 快照缺失)。
- * 消费点把 code 附在 message 后便于对账 —— 这一族是「你的操作有问题」,不是「引擎坏了」。
- * 前缀形(不是成员形)= 开集:这一族里每加一个新码,判别自动跟上。
- */
 export declare const REWIND_ERROR_CODE_PREFIXES: readonly ["resume_at.", "rewind_snapshot."];
-/** 该码是否属 rewind/resume 可自解族。缺席 ⇒ false。 */
 export declare function isRewindFamilyCode(code: string | undefined): boolean;
-/**
- * `resume.usage_window_exhausted`(#449 G1,core 5.60.1;server ≥7.47.0)—— 这一行的账本键上,
- * 本部署的**治理窗**满了。core 铸文的两句不变量:**什么都没消费、什么都没解钉** ⇒ 同一个 token
- * 带同一个决议在窗放开后可**直兑**(所以处置是「等」,不是「重开」也不是「改配置」)。
- * ⚠️ 与 429 的 {@link USAGE_WINDOW_EXHAUSTED}(`usage.window_exhausted`,提交面 pre-admission)
- * **同一本账、不同门、不同码**:本码是 resume/decide 腿的 pre-CAS 拒。别把两者合并判。
- */
 export declare const RESUME_USAGE_WINDOW_EXHAUSTED = "resume.usage_window_exhausted";
-/**
- * `resume.preflight_rejected`(#376,core 5.65 retry-later 形;server ≥7.51.0)—— 部署自己的
- * `RunnerDeps.resumePreflight` 拒了这次 resume(显式拒 / 抛 / 超时 / 答案读不动,四臂一律
- * fail-closed)。它是 CAS 前的**最后一档**,所以什么都没被消费。
- * 🔴 **core 侧另有一条 `terminal` 臂**(行已被这次拒绝的单发 expire CAS 结清、token 不可再赎),
- *    而两臂的**判别位在 message 散文里**。本包**不按文案分臂** —— 按文案分支正是上游改一个词就
- *    静默空转的形。⇒ 消费端能诚实说的只有两臂都成立的那句:「这一拒发生在提交之前,你的决定
- *    没被消费」;「还能不能再赎」交给引擎那行原文去说,别替它下结论。
- */
 export declare const RESUME_PREFLIGHT_REJECTED = "resume.preflight_rejected";
-/**
- * `resume.placement_mismatch`(#376 / core 5.65,design/380 O1③;server ≥7.51.0)—— 这次 resume
- * 显式带的 `internals.placementRoot` 与 suspend 铸点记下的 `CheckpointState.placementRootSessionId`
- * **不同**。目标绑定的 env factory 按那个固定点查 placement,静默换根会把这条腿(以及它往下传的
- * 每一个子代)重新落在**另一台目标**上,而 park 的工作区在原来那台 ⇒ **拒在 CAS 之前**,行仍 `pending`。
- *
- * 🔴 **它不在 {@link RESUME_RETRY_LATER_CODES} 里,而且不该在**:server 只在
- * `resume.usage_window_exhausted` / `resume.preflight_rejected` 两码上铸 `retryAfterSec`
- * (server 7.51.0 `dist/http/server.js` 的 `CheckpointError` 出口逐字),本码恒无窗;更要紧的是
- * **等一会儿对它毫无用处** —— 出路是「用记录里的那个 root 重来,或干脆不传 `internals.placementRoot`
- * 继承记录值」,是**换参数**不是**等时间**。把它放进时间性闭集会让人白等一个永远不会自己好的拒绝。
- * ⇒ 它与 `resume.preflight_rejected` 一起构成**另一个**闭集:{@link import('./resumeRefusalCopy.js').RESUME_REFUSAL_CODES}
- * (「有人话可补」的拒绝),两个闭集刻意分家 —— 一个回答「能不能等」,一个回答「该对人说什么」。
- */
 export declare const RESUME_PLACEMENT_MISMATCH = "resume.placement_mismatch";
-/**
- * 409 `conflict.resume_context_unavailable`(server ≥7.80.1 S-376 起体带结构位;码本身更早就有):**这个批准无处投递** ——
- * 发起这条 run 的会话当前没有可用的上下文来继续它。常见原因是部署按 `REAP_RUN_STALE_SEC` 回收了无活动会话,但 server 在
- * **上下文读取失败**(如存储故障)时也发同一个码,wire 上没有判别位 ⇒ 本包只报事实不推断原因。什么都没被决定,卡仍 pending。
- * 🔴 它不在 `resume.*` 族(前缀是 `conflict.`),也不进 {@link RESUME_RETRY_LATER_CODES} / `RESUME_REFUSAL_CODES`:
- *    能不能等 wire 上没有判别位(回收了就等不回来,读取失败则可能恢复)⇒ 不进「可等」集;出路是「用体上的 `runId` 自己恢复这条 run」,
- *    调大保留时长只能避免以后再发生。
- * 🔴 体上的 `staleAfterSec`(整数秒 = 该部署当下的 `REAP_RUN_STALE_SEC` 真值)是 7.80.1 的 additive 键;sdk 9.6.0 的
- *    `ConflictError` **还没把它带上来**(只带 activeTaskId 三件)⇒ 经 sdk 到端今天恒缺席,sdk 出键之日本包读口自动填满
- *    (读口按结构读 `errorCode` + `staleAfterSec` + `runId`,见 `resumeRefusalCopy.resumeContextUnavailableFromError`)。
- */
 export declare const RESUME_CONTEXT_UNAVAILABLE = "conflict.resume_context_unavailable";
-/**
- * 时间性拒绝族的**闭集**。
- *
- * 🔴 这是本文件的第二个闭集,但闭的**不是**「`resume.*` 一共有几个码」(那仍是开集,新码照旧
- * 落 {@link isRewindFamilyCode} 之外的开集兜底),闭的是「**server 在哪些码上铸 `retryAfterSec`**」:
- * server 的铸键判据逐字 =「本码 ∧ 有限正数」,两码之外恒缺席;SDK 8.1.0 `classifyApiError` 同样
- * 按这**两个具名码**铸 `ResumeRetryLaterError`(具名分支排在 `resume.` 前缀兜底**之前**)。
- * 🔴 **绝不放宽成 `resume.` 前缀判**:那会把 `retain_off` / `evicted` / `row_gone` 这些**等也没用**
- * 的码一起说成「过会儿再试」—— 一半用户白等,另一半白重开(与 `row_recycling`/`row_gone` 禁合并
- * 同一条纪律)。加成员 = 上游真在新码上铸了 `retryAfterSec`,必须同批带判据。
- *
- * 🔴 **为什么是 `Object.freeze` 的数组而不是 `ReadonlySet`**(异源对抗复审 [medium] 采纳,真病;
- * 与 `interactiveHalt.RUN_LEVEL_STOP_ERROR_CODES`(#363 二轮)**同一条已定谳的病形**):
- * `ReadonlySet<string>` 只在**类型面**只读 —— 运行期它就是一只普通 `Set`,而判定查的是**同一个
- * 实例**。任何 JS 消费者(公面上它是导出的)`.add('resume.row_gone')` 之后,一条「等也没用」的
- * 拒绝就会当场变成带窗的 `retry-later`(实测:`row_gone` + `retryAfterSec:30` 从 `row-gone` 翻成
- * `retry-later`)—— 闭集与「只认正向证据」两道约束一起被绕过。冻结数组在**运行期**真的改不动
- * (ESM 恒 strict:`push`/下标赋值直接抛),于是「公开面」与「判定源」可以安全地是同一个物。
- * ⚠️ 判据形随之从 `.has()` 改成 `.includes()`(与 `parkResolver.GATE_FAILURE_CODES` 同姿势;
- *    闭集只有两员,查找成本不是这里的量)。
- * ⚠️ **同形存量登记**(只登记不顺手改):同文件的 `CONFIG_REFUSAL_CODES` / `DELEGATION_CAP_CODES` /
- *    `TOOL_END_INTERRUPTED_CODES` 三张表今天仍是 `ReadonlySet`,同病。它们**已经在公面上**且消费点
- *    用 `.has()` ⇒ 换形是下游 BREAKING(签名从 `ReadonlySet<string>` 变 `readonly string[]`),
- *    不属内容批射程;本条按现状登记,换形另立一批。本位是**新铸**的,所以在出生那天就用对形。
- */
 export declare const RESUME_RETRY_LATER_CODES: readonly string[];
-/**
- * core runtask 在返回这三码的 failed 之前已经 `store.reopen` 了那张 checkpoint ⇒ **卡仍 pending、行重新 park、
- * `/decide` 报 retriable:true**:它们是「再 park」不是终局。下游处置三码逐字同款(重取待批列表、在原工具在场的
- * 部署上重决);族的判别力只在 `errorCode`,server 刻意不给它们各自的 HTTP 状态。
- *  · `resume.env_failed` —— 执行环境没起来;
- *  · `resume.tool_unavailable` —— 批过的那只工具在这条腿上**不在**;
- *  · `resume.tool_contract_mismatch`(core 7.8.0 F2)—— 工具还在,但 contractId / shapeDigest / implementationRevision
- *    任一不同 = 顶着同名的替身。
- * 🔴 sdk d.ts 未建模这三码(只在 core `checkpoint-store.d.ts` / `tool-roster.d.ts` 注释里点名),字面以 server
- *    resume-legs.ts 实装为锚;与 {@link RESUME_RETRY_LATER_CODES}(能不能等)/ `RESUME_REFUSAL_CODES`(该对人说什么)
- *    **两两不交** —— 三种处置三张表。`checkpoint.reopen_failed`(reopen 本身失败 = 终局)刻意不在本族。
- */
 export declare const RESUME_ENV_FAILED = "resume.env_failed";
 export declare const RESUME_TOOL_UNAVAILABLE = "resume.tool_unavailable";
 export declare const RESUME_TOOL_CONTRACT_MISMATCH = "resume.tool_contract_mismatch";
 export declare const RESUME_REOPEN_CODES: readonly string[];
-/**
- * `decide.workflow_host_unknown`(409;sdk README §9.0.0 逐字:「run 上没有发起会话锚 ⇒ 无处投递,
- * **无重试价值**」)。
- * 🔴 出路**不是等**:这条 run 上根本没有可投递的宿主锚,重发一百次也一样。人能做的是据拒体的
- *    `runId` 自己去看那条 run(或换一条路 resume 它)。
- */
 export declare const DECIDE_WORKFLOW_HOST_UNKNOWN = "decide.workflow_host_unknown";
-/**
- * `decide.workflow_remember_unsupported`(400;同上:「本车道 fail-closed 拒 `remember:"session"`」)。
- * 🔴 出路是**去掉 `remember` 重发**,而且 sdk 顶注逐字保证「零副作用」——这一格与另外两个 409
- *    的分法不是严重程度,是**改什么才能过**(改参数 / 等时序 / 没救)。
- */
 export declare const DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED = "decide.workflow_remember_unsupported";
-/**
- * `/decide` workflow 车道的拒绝码**闭集**(两员;0.71.0 CC-20 退役 `host_not_parked` 后从三员收成两员)。
- *
- * 🔴 闭的不是「`decide.*` 一共有几个码」(那仍是开集:`approval_binding_mismatch` /
- *    `approval_stale` / `gate_not_tool_approval` 等都不在本表,它们各有既有处置),闭的是
- *    「**这两个码是 workflow 那条新车道独有的、而且各自有一句人话**」。
- * 🔴 **形制**:`Object.freeze` 的数组,不是 `ReadonlySet`(同 {@link RESUME_RETRY_LATER_CODES} 的
- *    已定谳病形 —— `ReadonlySet` 只在类型面只读,而判定查的就是公面上这同一个实例)。
- * 🔴 加成员必须**同批**补那一句人话 + 判据,不许靠 `decide.` 前缀放宽(前缀下住着三种处置)。
- * 🔴 **删成员义务**(0.71.0 CC-20 补):上游退役某码(sdk errors.d.ts 顶注 ⚰️ RETIRED 无别名)⇒ 同批删常量、出路句、
- *    `resendable` 行,退役词进 census 门登记;decide-receipt 门 E0 对每一员钉「上游仍活着」,上游退役当天先红。
- * 📋 **刻意不镜像**:`decide.workflow_park_identity_lost`(server 7.71.0 引入、7.75.0 退役,sdk 从未建模,继任 `decide.workflow_resume_not_admitted`
- *    家族由 sdk 类承载);端收到未知 `decide.*` 码一律走开集通用行(机器行原样上屏),本表不为已退役码留位。
- */
 export declare const DECIDE_WORKFLOW_LANE_CODES: readonly string[];
-/**
- * workflow **park 真相**拒绝码的闭集(四员;core 7.17.0 `workflow.ts:602` 码集)。
- *
- * 🔴 闭的是「**这四个码是 park 真相这一族独有的**」,不是「`workflow.*` 一共有几个码」——
- *    后者仍是开集(`workflow.governance_key_stripped` / `workflow.agent_option_ignored` 是通告码,
- *    `workflow.journal_incompatible` 是另一族拒绝码,各有各的既有处置)。
- * 🔴 **绝不靠 `workflow.park_` 前缀放宽**:前缀是个命名巧合,不是契约;上游哪天加第五个码,
- *    该在这里显形并被人处置,而不是被一条前缀判据无声吞进来。
- * 🔴 形制:`Object.freeze` 的数组(同 {@link DECIDE_WORKFLOW_LANE_CODES})。
- */
 export declare const WORKFLOW_PARK_REFUSAL_CODES: readonly string[];
-/**
- * 这个码是不是 workflow park 真相族的拒绝码({@link WORKFLOW_PARK_REFUSAL_CODES} 的成员)。
- *
- * 🔴 表外码 ⇒ `false` = 「本端认不出它属于这一族」,**不是**「这次 resume 没问题」。
- * 🔴 非串 / 空串 ⇒ `false`;认**原始值**(消毒只进文案,不进判据)。
- */
 export declare function isWorkflowParkRefusalCode(code: unknown): boolean;
-/**
- * server 温切 drain 门的 pre-stream 拒收码(503 + `errorCode:"draining"`;server 侧
- * `error:"draining"` 是冻结契约,SDK toApiError 盖成 `errorCode`)。此前壳/包注释各持裸字面。
- */
 export declare const DRAINING_ERROR_CODE = "draining";
-/**
- * 场景执法拒绝码(service gateScenarioRequest 的 400;SDK `ScenarioNotAllowedError`)。
- * 判型半场见 wireErrorTriage.scenarioDenyFromError;allowlist 渲染归各端。
- */
 export declare const SCENARIO_NOT_ALLOWED_ERROR_CODE = "scenario_not_allowed";
-/**
- * 15 分钟流帽(server `src/http/sse-log.ts`)。
- * 🔴 **到达 ≠ run 死了** —— 帧自己就说「run 仍然活着」。正确处置 = 按 `Last-Event-ID` 重连续读
- * (`runs.events` 车道由 SDK 内部自动做)。把它当终态渲染会把一条还在跑的任务在 UI 上判死。
- * `errorCode` 整体开集:未知码按「可重连的流控信号」通用降级,不要按成员判死。
- */
 export declare const STREAM_MAX_DURATION = "STREAM_MAX_DURATION";
-/**
- * 🔴 **本文件唯一的闭集**([2577] core 亲自定谳:"closed set, single member today")。
- * 语义 = 请求的模型词**没绑上**(没有 roster / 不在 roster 上),子代跑在继承来的默认模型上。
- * 这**不是错误**:回落行为本身没变,只是现在说出来了。缺席 = 正常绑定,或压根没请求过模型词。
- *
- * 🔴 **加成员 = BREAKING 清单行** —— 所以此处写 string literal union 而不是 `string`:
- * 消费端可以安全地按闭集分臂,而下一次 core 加成员时本包的类型面会**当场编译红**,
- * 逼提货批显式处理,而不是让一个没人认得的原因静默落进 default 臂。
- */
 export type ModelFallbackReason = 'inherit_no_tier_binding';
-/** {@link ModelFallbackReason} 的唯一成员(今天)。 */
 export declare const MODEL_FALLBACK_INHERIT_NO_TIER_BINDING: ModelFallbackReason;
-/** wire 上的 `modelFallback` 窄化:是闭集成员才认,别的一律当缺席(不认得的原因 ≠ 编一个)。 */
 export declare function asModelFallbackReason(v: unknown): ModelFallbackReason | undefined;
-/**
- * 引擎 turn 停止原词的**识别表**(五词;core `StopReason` 归一化后的值集)。
- *
- * 🔴 **它是识别表不是闭集判据**:`turn_end.stopReason` 在 sdk 型面上是开放 `string`(上游刻意让
- *    引擎的 union 保持私有)⇒ 引擎比这一端新时真的会送一个第六个词过来。本表回答的是
- *    「我认不认得这个词」,**绝不是**「合法的词只有这五个」。
- */
 export declare const ENGINE_STOP_REASONS: readonly string[];
-/**
- * 引擎停止原词 → CC `stop_reason` 的**唯一映射口**。**三态**,刻意不合并:
- *  · `string`      —— 映到了一个 CC 词;
- *  · `null`        —— 映到了**诚实缺席**(`error` / `aborted`:CC 没有对应词,不编一个);
- *  · `undefined`   —— **这个词本端不认识**(表外词 / 非串 / 空串)⇒ 调用方按「不映射」走原路。
- *
- * 🔴 `null` 与 `undefined` 必须分开:前者是「我认得这个词,而它的正确渲法就是没有词」,后者是
- *    「我不认得这个词」。合成一个值 ⇒ 引擎加第六个词那天,它会被渲成一次「这一轮没有 stop_reason」
- *    的**肯定事实**,而真相是这一端读不懂 —— 本仓反复在修的那条「把不知道渲成事实」的病。
- * 🔴 **按自有属性查表**(`Object.freeze` 不移除原型):一个来自 wire 的 `constructor` / `toString`
- *    会命中 `Object.prototype` 上的**函数**并被当成一个 CC 词交出去。
- */
 export declare function engineStopReasonToCc(stopReason: unknown): string | null | undefined;