@sema-agent/client-core 0.59.2 → 0.61.0

package/dist/adapter/downstream/terminalToSdkResult.js

@@ -1,4 +1,6 @@
 import { stamp } from '../types.js';
+// 0.60.0(engine ≥7.64.0 / sdk 8.4.0):终局读数的**单一读器**(两代字节 → 一个带标因由)。
+import { isReviewPark, readRunTerminal, runTerminalCode, runTerminalGateToolName, } from '../../runTerminal.js';
 import { toCcModelUsage } from './turnUsageToModelUsage.js';
 // G1 去字面化(2026-08-04):到限/结构化输出/rewind 三族的码字面收编进单一真源,本文件只 import。
 // 开集纪律不变——下面三个集合仍是**识别表**,`subtypeForErrorCode` 的 default 臂才是开集的兑现处。
@@ -273,11 +275,19 @@ export function doneToSdkResult(ev, ctx) {
     // looked like a widening but wasn't one. `Omit` the narrow key first so the added wider
     // `status?: string` actually applies — that is also what keeps the 未知终态 defensive arm below
     // expressible at all.
-    const rr = r;
+    // 🔴 0.60.0(engine ≥7.64.0 / sdk 8.4.0):终局分流的判据从**八个平面键**换成**一条带标因由**
+    //    (`result.terminal`)。读法单源在 `runTerminal.readRunTerminal` —— 本文件一个 `status` 字面
+    //    都不再比较(平面形的两个来源、以及「不认识的终态词绝不落成功」那条不变量,全在读器里)。
+    //    `null` = 这份载体上连终态词都没有(mock 车道 / 不带 status 的旧合成帧)⇒ 维持成功臂,
+    //    与形变前逐字节同行为。
+    const terminal = readRunTerminal(rRaw);
     const durationMs = elapsedMs(ctx);
     // [909]B1 — errorCode 透传(additive seam 字段;CC schema 无此键,与 success 臂 `model` 同款超集
     // 姿势):引擎值原样,绝不铸造。所有 error 臂共用(`errorResult` 信封负责 stamp)。
-    const errorCode = typeof rr.errorCode === 'string' && rr.errorCode.length > 0 ? rr.errorCode : undefined;
+    // 🔴 因由形下「码属于失败」是**形状**:paused / blocked 上引擎写不出码 ⇒ 这两臂的 `errorCode`
+    //    从 0.60.0 起恒缺席(此前 `review.pending` 骑在 park 帧的平面 errorCode 上)。扁平形回放的
+    //    历史行仍带得动它(读器在那三臂上保留 `code`),所以盘上真有的事实不丢。
+    const errorCode = runTerminalCode(terminal);
     // TaskResult 五键最小消费批([1543] SDK-M,2026-07-23):additive seam 字段——
     //  · degraded = 模型降级链实录,**各终态恒 additive 附上**(见 `degradedOf` 头注 / REF-CC-056);
     //  · structuredOutput = outputSchema 任务的结构化产出(success 臂);
@@ -286,32 +296,34 @@ export function doneToSdkResult(ev, ctx) {
     const degraded = degradedOf(r);
     /** 四个 error 臂共享的固定位(信封其余 13 位见 `errorResult`)。 */
     const errorBase = { durationMs, stats, model: r.model, errorCode, degraded };
-    if (rr.status === 'failed') {
+    if (terminal?.kind === 'failed') {
         // [909]B1 — failed 臂 subtype 语义化(见文件头对表);core 5.8.0([2489])起到限码全部改名,
         // 映射本身已收进单点 `subtypeForErrorCode`(退役批后只认新码)。
         // 5.8.0 的「截断」族到限(token/墙钟):subtype 只能落诚实兜底词,但这两种停因**可能已产出正文**
         // —— [2489] 对 limits.max_tokens_exceeded 明记「result 带已产出正文」,墙钟停是既有写出窗语义,
         // 两族共用 `cutoffParts`(salvage + 零抢救诚实尾注)。
-        const failedSubtype = subtypeForErrorCode(rr.errorCode);
-        if (rr.errorCode !== undefined && CUTOFF_EXCEEDED_CODES.has(rr.errorCode)) {
+        const failedCode = terminal.code;
+        const failedMessage = terminal.message;
+        const failedSubtype = subtypeForErrorCode(failedCode);
+        if (failedCode !== undefined && CUTOFF_EXCEEDED_CODES.has(failedCode)) {
             return errorResult(ctx, {
                 ...errorBase,
                 subtype: failedSubtype,
-                ...cutoffParts(r, rr.errorMessage, rr.errorCode === LIMITS_MAX_TOKENS_EXCEEDED
+                ...cutoffParts(r, failedMessage, failedCode === LIMITS_MAX_TOKENS_EXCEEDED
                     ? 'run exhausted its token budget'
-                    : 'run hit its wall-clock limit', rr.errorCode),
+                    : 'run hit its wall-clock limit', failedCode),
             });
         }
         return errorResult(ctx, {
             ...errorBase,
             subtype: failedSubtype,
             // rewind 族错误码透传(server 1.192 [838]③ 实测:stream 腿把 resume_at.before_* /
-            // rewind_snapshot.unresolvable 骑在 done{status:"failed"} 帧的 errorCode 上,非 `failed` 帧)——
-            // 与 failedToSdkResult 的同款 append 对齐,message 后附 code 便于对账。
+            // rewind_snapshot.unresolvable 骑在失败因由的码上)—— 与 failedToSdkResult 的同款 append
+            // 对齐,message 后附 code 便于对账。
             errors: [
-                isRewindFamilyCode(rr.errorCode) && rr.errorMessage
-                    ? `${rr.errorMessage} (${rr.errorCode})`
-                    : (rr.errorMessage ?? 'run failed'),
+                isRewindFamilyCode(failedCode) && failedMessage
+                    ? `${failedMessage} (${failedCode})`
+                    : (failedMessage ?? 'run failed'),
             ],
         });
     }
@@ -324,13 +336,13 @@ export function doneToSdkResult(ev, ctx) {
     // [909]B1 — blocked 终态:agent 自报无法推进(assemble-result.js:99,只带 blockedReason 无
     // errorCode)。此前落 success 臂(TB db-wal-recovery__uuH5cAg 实证:引擎终态 blocked、帧却
     // subtype:success)。≠空成功 → SDKResultError,blockedReason 如实进 errors[]。
-    if (rr.status === 'blocked') {
-        const blockedReason = r.blockedReason;
+    if (terminal?.kind === 'blocked') {
+        const blockedReason = terminal.reason;
         return errorResult(ctx, {
             ...errorBase,
             subtype: 'error_during_execution',
             errors: [
-                typeof blockedReason === 'string' && blockedReason.length > 0
+                blockedReason !== undefined
                     ? `Run blocked: ${blockedReason}`
                     : 'Run blocked (the agent reported it cannot proceed)',
             ],
@@ -350,20 +362,20 @@ export function doneToSdkResult(ev, ctx) {
     // CC 对照:CC 2.1.207 AskUserQuestion.isEnabled 在非交互且无 SDK permissionPromptTool 时
     // return false = 模型源头看不到该工具;core [884] 自领 1.296 加同款非交互闸(roster 源头不进)。
     // 本分流是闸到货后的防御纵深:即便引擎吐了 suspended,壳也不许洗成空成功。
-    if (rr.status === 'suspended' || rr.status === 'needs_review') {
+    if (terminal?.kind === 'paused') {
         const parked = r;
         const runId = typeof parked.taskId === 'string' && parked.taskId.length > 0 ? parked.taskId : undefined;
-        const gateTool = typeof parked.checkpointGate?.toolName === 'string' && parked.checkpointGate.toolName.length > 0
-            ? parked.checkpointGate.toolName
-            : undefined;
+        // 🔴 0.60.0:两句措辞的判据从退役的 `status` 五词换成**门种**(因由形下 park 只带 gate)——
+        //    单源 `runTerminal.isReviewPark`(词表 ⊇ 重开臂路由表,包含关系由常驻门钉)。
+        const gateTool = runTerminalGateToolName(terminal);
+        const review = isReviewPark(terminal);
         const sid = typeof ctx.sessionId === 'string' && ctx.sessionId.length > 0 ? ctx.sessionId : undefined;
-        const awaiting = rr.status === 'needs_review'
-            ? 'a plan review'
-            : `an interactive answer${gateTool ? ` (${gateTool})` : ''}`;
-        const wayOut = rr.status === 'needs_review'
+        const awaiting = review ? 'a plan review' : `an interactive answer${gateTool ? ` (${gateTool})` : ''}`;
+        const wayOut = review
             ? `Review the plan in the interactive REPL${sid ? ` (sema --resume ${sid})` : ''}.`
             : `Answer it in the interactive REPL${sid ? ` (sema --resume ${sid})` : ''}, or decide the pending approval via the engine approvals API${sid ? ` (POST /v1/approvals/${sid}/decide)` : ''}.`;
-        // [909]B1 — needs_review 帧带 review.pending;errorCode 由信封原样透传。
+        // [909]B1 — 平面形回放的 needs_review 行仍带 review.pending;因由形下 park **写不出**码
+        // (见上方 errorCode 头注),两代都由信封原样透传。
         return errorResult(ctx, {
             ...errorBase,
             subtype: 'error_during_execution',
@@ -372,16 +384,21 @@ export function doneToSdkResult(ev, ctx) {
             ],
         });
     }
-    // [909]B1 — 防御臂:词表外的未知非 completed 终态(core 未来加词/未知 wire 变形)绝不洗成
-    // 空成功——error_during_execution + errors[] 如实报出该 status 字面。absent status(mock 车道 /
-    // 旧引擎 done 帧不带 status)维持 success 臂,零行为变化。
-    if (typeof rr.status === 'string' && rr.status.length > 0 && rr.status !== 'completed') {
+    // [909]B1 — 防御臂:四臂之外的未知终态词(core 未来加因由臂 / 未知 wire 变形)绝不洗成空成功
+    // —— error_during_execution + errors[] 如实报出那个词的字面。读器把两代字节的这一格都归到
+    // `unknown` 臂(因由形取 `terminal.kind`,扁平形取 `status`),所以本臂对两代同样有效。
+    // 🔴 **终态词整个缺席**(mock 车道 / 旧合成帧;读器返 `null`)维持 success 臂,零行为变化。
+    if (terminal?.kind === 'unknown') {
         return errorResult(ctx, {
             ...errorBase,
             subtype: 'error_during_execution',
             errors: [
-                rr.errorMessage ??
-                    `run ended with terminal status "${rr.status}" (not a success; this CLI predates that status word)`,
+                terminal.message ??
+                    (terminal.word !== undefined
+                        ? `run ended with terminal cause "${terminal.word}" (not a success; this CLI predates that terminal word)`
+                        : // 🔴 因由座在场却整个读不出(坏形 / 混合载体)—— 说的是「读不出」,不是「没有终局」,
+                            // 更不是成功。诚实缺席优先于编一个词([honest-absence-not-fabricated-zero])。
+                            'run ended with a terminal cause this client could not read (not a success; the engine sent a malformed terminal record)'),
             ],
         });
     }

package/dist/adapter/runStream.js

@@ -8,6 +8,8 @@ import { coerceOutput, publishSubagentContentEvent } from '../subagentContentSto
  * G1 去字面化(2026-08-04):字面收编进 `engineErrorCodes.ts` 单一真源,本文件只 import。
  */
 import { ACTIVE_RUN_BUSY_ERROR_CODE, OUTPUT_INVALID, isLimitsExceededCode } from '../engineErrorCodes.js';
+// 0.60.0(engine ≥7.64.0 / sdk 8.4.0):终局读数的单一读器(纯叶子:零 Node、零宿主端口)。
+import { isReviewPark, readRunTerminal, runTerminalCode } from '../runTerminal.js';
 /** 本文件发的 chrome 事件全在 leader lane(子代内容在上面就被 divert 走了)。 */
 const MAIN = { lane: 'main' };
 /**
@@ -378,7 +380,10 @@ async function* runStreamInner(events, ctx, handle = {}) {
             // (interactive REPL 不渲染 result 帧)= 上游 4xx/欠费/超限对用户完全静默。这里
             // 额外合成一条 assistant 错误消息(CC 的 isApiErrorMessage 红字渲染线现成),
             // 用户永远能看到 turn 为什么失败。
-            const failedResult = ev.type === 'done' ? ev.result : null;
+            // 🔴 0.60.0(engine ≥7.64.0 / sdk 8.4.0):done 帧的终局读数换成带标因由,读法单源
+            //    `runTerminal.readRunTerminal`(它同时认扁平形的**三个**来源:读盘回放的历史行 /
+            //    server 自己的 409 拒绝信封 / 同步提交腿的 park 体)。本文件从此一个平面键都不直读。
+            const doneTerminal = ev.type === 'done' ? readRunTerminal(ev.result) : null;
             // [909]B1 — failed/blocked 终态同享可见性行(此前只 status:'failed' 有行,墙钟停/blocked
             // 在 REPL 面完全静默)。park(suspended/needs_review)不进此行:有各自 overlay/文案线,
             // 非 provider 故障([884]A1 断言零 assistant 行)。
@@ -390,11 +395,11 @@ async function* runStreamInner(events, ctx, handle = {}) {
             // 上 wire,该腿随之删除,不留静默缺口。
             const errText = ev.type === 'failed'
                 ? (ev.errorMessage ?? ev.errorCode ?? 'run failed')
-                : failedResult?.status === 'failed'
-                    ? (failedResult.errorMessage ?? failedResult.errorCode ?? 'run failed')
-                    : failedResult?.status === 'blocked'
-                        ? (failedResult.blockedReason
-                            ? `Run blocked: ${failedResult.blockedReason}`
+                : doneTerminal?.kind === 'failed'
+                    ? (doneTerminal.message ?? doneTerminal.code ?? 'run failed')
+                    : doneTerminal?.kind === 'blocked'
+                        ? (doneTerminal.reason
+                            ? `Run blocked: ${doneTerminal.reason}`
                             : 'Run blocked (the agent reported it cannot proceed)')
                         : null;
             if (errText) {
@@ -407,12 +412,14 @@ async function* runStreamInner(events, ctx, handle = {}) {
                 // suspended/needs_review 就地终态化 ⇒ claim 释放),所以文案指的就是那个端点;
                 // 自愈分诊腿(重开卡把决定权还给用户;cancel+重发臂已退役)在 `adapter/activeRunSelfHeal.ts`
                 // (A-028.1 上收,宿主经 deps 注入重开口),本层只负责:识别 + 说真话。
-                const activeTaskId = failedResult?.activeTaskId ??
+                // `activeTaskId` 是**拒绝信封自己的**位(server 的 409 帧,不是引擎结果)⇒ 照旧从帧体直读,
+                // 不经因由读器(因由里没有这一位,也不该有)。
+                const activeTaskId = (ev.type === 'done' ? ev.result?.activeTaskId : undefined) ??
                     (ev.type === 'failed' ? ev.activeTaskId : undefined);
                 // REF-CC-054:判别**结构位两腿**(errorCode → activeTaskId;文案兜底腿 2026-08-03 已退役),
                 // 判别体见文件上方 `classifyActiveRunBusy`。
                 const busy = classifyActiveRunBusy({
-                    errorCode: ev.type === 'failed' ? ev.errorCode : failedResult?.errorCode,
+                    errorCode: ev.type === 'failed' ? ev.errorCode : runTerminalCode(doneTerminal),
                     activeTaskId,
                 });
                 // 件14 rev2 (2026-07-14): provider max_tokens cap rejection (e.g. glm-5.2 preset 131072 >
@@ -442,9 +449,12 @@ async function* runStreamInner(events, ctx, handle = {}) {
                 //    不是模型说的话」),不是「这是 provider API 错误」的断言 —— 可见性过滤
                 //    (`Messages.filterForBriefTool`)、-p 契约投影、tick 熔断都读它,撤掉 = 这一行在
                 //    brief 模式里静默消失。改的是**身份文案**,不是行类。
+                // 🔴 `isGovernanceTerminal` 的入参仍是**词面**(它是一个纯谓词,公面签名不动)——
+                //    因由形下「被治理挡下」这件事由 `kind === 'blocked'` 承载,喂给它那一个词即可;
+                //    其余臂喂 `undefined`(码那一半照旧走 errorCode 腿)。
                 const governance = isGovernanceTerminal({
-                    status: ev.type === 'failed' ? undefined : failedResult?.status,
-                    errorCode: ev.type === 'failed' ? ev.errorCode : failedResult?.errorCode,
+                    status: ev.type === 'failed' ? undefined : doneTerminal?.kind === 'blocked' ? 'blocked' : undefined,
+                    errorCode: ev.type === 'failed' ? ev.errorCode : runTerminalCode(doneTerminal),
                 });
                 const busyHandle = busy.handle;
                 const rowText = busy.busy
@@ -475,7 +485,13 @@ async function* runStreamInner(events, ctx, handle = {}) {
             // B3 切边:此前是 `await import('../../sema/planReviewWire.js')` —— **整棵 CC 树进闭包的
             // 那一行**(设计稿 §5.2 根因链)。改成 chrome 事件;`await` 保留(cli 原本就在终帧**之前**
             // 同步等 arm 完成,卡片先于完成行出现),sink 失败 fail-soft 照常投影终帧。
-            if (ev.type === 'done' && failedResult?.status === 'needs_review' && ctx.emitChrome) {
+            // 🔴 0.60.0:判据换成 `isReviewPark`,它**两个来源合读**(因由形的门种 ∪ 扁平形的 status 词)。
+            //    ⚠️ **扁平那一半是必须的,不是残留**(server 回帖确认):同步提交腿命中 park 时,server 自造
+            //    的 200 体是 `{taskId, sessionId, status:"suspended"|"needs_review"}` —— **既没有退役的八个
+            //    平面键、也没有 `terminal`、连门都不带**,它不是 `TaskResult` 而是独立于它的另一只形。
+            //    在那一形上 `status:"needs_review"` 是「这是一次复核」的**唯一**信号;只读门种会让整条
+            //    同步 park 腿的 plan-review 卡不弹。因由形那一半覆盖 done 帧的引擎结果,两半各管一条腿。
+            if (ev.type === 'done' && isReviewPark(doneTerminal) && ctx.emitChrome) {
                 try {
                     await ctx.emitChrome({ kind: 'plan_review_park', laneProof: MAIN, result: ev.result });
                 }

package/dist/engineCapsCache.d.ts

@@ -25,6 +25,33 @@
  * restartEngine)在重启后调用 —— 缓存自己无从分辨「同一个 baseUrl 后面还是不是同一个引擎」,
  * 猜(TTL / 每次构造清)只会把一个确定事实换成一个定时器。
  */
+/**
+ * 该 base 的**当代号**(公面读口;0.60.0)。
+ *
+ * ── 它解决的是哪一件事(异源对抗复审 [medium] 采纳,真病)────────────────────────────────────
+ * {@link kickEngineCapsProbe} 的代际闸挡的是「旧探测写脏 `capsByBase`」,而那道闸在 **probe 返回
+ * 之后**才跑。宿主的 caps 探测闭包里通常还挂着若干**读面 tee**(`noteEngineCapsForSqlEngine` /
+ * `noteEngineCapsForWriteProtection` …),它们是**在 probe 内部**、也就是在那道闸之前落地的 ⇒
+ * 一次慢的旧探测可以在 `invalidateEngineCaps` + 新探测都走完之后才返回,把**上一台引擎**的读数
+ * 重新写进那些 tee 表。屏面上的形态最坏:一行**肯定句**(「这台部署有 12 行写保护」)说的却是
+ * 一台已经不在的引擎。
+ *
+ * ── 用法(宿主侧)──────────────────────────────────────────────────────────────────────────
+ * 在**起探测的那一刻**抓一份号,tee 落地时原样交回:
+ * ```ts
+ * const gen = engineCapsGeneration(baseUrl)
+ * kickEngineCapsProbe(baseUrl, async () => {
+ *   const caps = await client.capabilities()
+ *   noteEngineCapsForWriteProtection(baseUrl, caps, { generation: gen })   // 陈旧 ⇒ 这一发被丢掉
+ *   return caps
+ * })
+ * ```
+ * 🔴 **不传 = 与本位到货之前逐字节同行为**(照写),所以它是 additive 供给、不是强制门 —— 端没跟上
+ * 之前不会有任何东西变坏,跟上之后那条竞态才真正关掉。
+ * 🔴 **tee 自己抓号是假判据**:陈旧那一发在 tee 时读到的是**新**代号,看起来永远是当代的。
+ *    号必须在**探测出生**那一刻抓。
+ */
+export declare function engineCapsGeneration(baseUrl: string): number;
 /** 构造期 kick(async 幂等);probe = client.capabilities 薄闭包。 */
 export declare function kickEngineCapsProbe(baseUrl: string, probe: () => Promise<unknown>): void;
 /**

package/dist/engineCapsCache.js

@@ -53,6 +53,35 @@ const genByBase = new Map();
 function capsGeneration(baseUrl) {
     return genByBase.get(baseUrl) ?? 0;
 }
+/**
+ * 该 base 的**当代号**(公面读口;0.60.0)。
+ *
+ * ── 它解决的是哪一件事(异源对抗复审 [medium] 采纳,真病)────────────────────────────────────
+ * {@link kickEngineCapsProbe} 的代际闸挡的是「旧探测写脏 `capsByBase`」,而那道闸在 **probe 返回
+ * 之后**才跑。宿主的 caps 探测闭包里通常还挂着若干**读面 tee**(`noteEngineCapsForSqlEngine` /
+ * `noteEngineCapsForWriteProtection` …),它们是**在 probe 内部**、也就是在那道闸之前落地的 ⇒
+ * 一次慢的旧探测可以在 `invalidateEngineCaps` + 新探测都走完之后才返回,把**上一台引擎**的读数
+ * 重新写进那些 tee 表。屏面上的形态最坏:一行**肯定句**(「这台部署有 12 行写保护」)说的却是
+ * 一台已经不在的引擎。
+ *
+ * ── 用法(宿主侧)──────────────────────────────────────────────────────────────────────────
+ * 在**起探测的那一刻**抓一份号,tee 落地时原样交回:
+ * ```ts
+ * const gen = engineCapsGeneration(baseUrl)
+ * kickEngineCapsProbe(baseUrl, async () => {
+ *   const caps = await client.capabilities()
+ *   noteEngineCapsForWriteProtection(baseUrl, caps, { generation: gen })   // 陈旧 ⇒ 这一发被丢掉
+ *   return caps
+ * })
+ * ```
+ * 🔴 **不传 = 与本位到货之前逐字节同行为**(照写),所以它是 additive 供给、不是强制门 —— 端没跟上
+ * 之前不会有任何东西变坏,跟上之后那条竞态才真正关掉。
+ * 🔴 **tee 自己抓号是假判据**:陈旧那一发在 tee 时读到的是**新**代号,看起来永远是当代的。
+ *    号必须在**探测出生**那一刻抓。
+ */
+export function engineCapsGeneration(baseUrl) {
+    return capsGeneration(baseUrl);
+}
 /** 构造期 kick(async 幂等);probe = client.capabilities 薄闭包。 */
 export function kickEngineCapsProbe(baseUrl, probe) {
     if (!baseUrl || capsByBase.has(baseUrl) || inFlight.has(baseUrl))

package/dist/engineErrorCodes.d.ts

@@ -145,6 +145,18 @@ export declare function isInterruptedToolEndCode(code: string | undefined): bool
  * 🔴 非布尔的 `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` 是诚实缺陷)。 */

package/dist/engineErrorCodes.js

@@ -199,6 +199,19 @@ export function isInterruptedToolEndCode(code) {
  * 🔴 非布尔的 `selfOrchestration` 走的是 **400**,不是本码 —— 那是「值不对」不是「不给用」。
  */
 export 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 const GATE_PARKED_ERROR_CODE = 'gate.parked';
 // ── 会话冲突族 ────────────────────────────────────────────────────────────────────────────────
 /** 409 session-busy 的 canonical 码([2377]C-1,server main `049ff2c`,随 5.0.0 发)。 */
 export const ACTIVE_RUN_BUSY_ERROR_CODE = 'conflict.session_active_run';

package/dist/gateOutcome.d.ts

@@ -0,0 +1,157 @@
+/**
+ * src/gateOutcome.ts — 一次工具门通过的**整条记录**:`tool_end.gate` 的三端共用窄读器(0.60.0)。
+ *
+ * ── 上游形变(engine ≥7.64.0 / sdk 8.4.0;wire BREAKING)────────────────────────────────────
+ * 7.63.0 及以前,一次调用怎么过门要从**四个正交可选词**里拼:`settledBy` / `resolution` /
+ * `autoDenied` / `approver`。那四个词的配对规则只活在注释里,消费端要靠**缺席**推语义(「有
+ * `timeout` 没有 `resolution` ⇒ 耐久 park 过期」)。7.64.0 起它是一条记录 {@link GateOutcomeView}:
+ *   · `disposition` —— 放行,或被**哪一层**拒(`deniedBy` 八词);
+ *   · `settlement?` —— 这次消费掉的等待**怎么结束的**(十二词 `kind`、形由词决定的 `who`、`when`,
+ *     人的拒绝另带 `note?`);
+ *   · `origin?`     —— 谁**问**的。
+ * `settlement` 与 `origin` **同在同缺**(它们说的是同一只 ask)。四个旧词**全删,无 alias**。
+ *
+ * ── 本模块存在的理由:判定归包,端不许自拼 ───────────────────────────────────────────────────
+ * 旧形上,「这一次是不是**审批窗自己走完**的拒绝」这个判定是端各自拼的一个两键合取
+ * (`settledBy === 'timeout' && resolution === 'window_expired'`),而拼错的方式有好几种、错法
+ * 静默(单锚 `settledBy` 会把「审批方违约」误收进来;写成不等式会把「不知道怎么拒的」折成
+ * 「窗自然结束」)。形变把这些配对规则搬进了**形状**,正是把判定收进包里的时机 ——
+ * 端从此调 {@link isApprovalWindowExpiredGate} / {@link isDenialLimitAutoDeniedGate},不再自拼。
+ *
+ * ── 判据纪律 ────────────────────────────────────────────────────────────────────────────────
+ * 🔴 **缺席不是关于这次调用的事实**,禁读出任何语义。上游逐字列了**四种**在 wire 上不可分辨的
+ *    成因:①门根本没看见这次调用(未武装的门)/ ②延后重发 / ③reconcile 捡回的孤儿 / ④那条记录
+ *    过不了引擎的不变量筛、server **整条不上帧**。⇒ 一律退回 `isError` + 文案。
+ *    ⚠️ **真机黑盒补的第五种成因**(engine 7.64.0 三路独立构造直证,与上面四种不同 —— 它有一个
+ *    **可读的正面标记**):审批窗走完未决而走 **park** 路径时,`tool_end` 帧上没有 `gate`,只有
+ *    `errorCode: "gate.parked"`。那一形不是「记录坏了」,是「这次调用根本没结算过什么」——
+ *    它由 {@link isGateParkedToolEnd} 单独回答,见那一处。
+ * 🔴 **开集读**:`settlement.kind` / `origin` / `deniedBy` 的词表属主都是 core。`deniedBy` 在
+ *    wire 上确实是闭集(出集的记录 server 整条不投),但**本包不据此收窄**:窄读成枚举会在 core
+ *    加员当天把一个合法值判没,而端拿到的是「一个陌生的词」远好过「这一位不见了」。三处一律
+ *    「非空串即原样透传」,端的 `switch` **必须带 `default`**。
+ * 🔴 **`who` 的形由 `kind` 决定,本读器不重铸那张配对表**:它按结构原样窄读(`party` 非空串、
+ *    `approver` / `window` 各自可选),把配对规则留在**引擎**那一侧。抄一份配对表 = 给自己立
+ *    第二个判官,而上游明说这张表是它的不变量。
+ * 🔴 `approver` 是 **UNTRUSTED-for-display**:转录不是认证(引擎只筛形,不鉴别、不比对、不回读),
+ *    可信度 = 那条审批通道的可信度;只渲染,绝不回喂模型/工具入参,更不许当鉴权判据。
+ *    `note`(拒批人自己写的自由文本)同待遇。
+ *
+ * ── 🔴 同名不同义警告([same-name-different-meaning-crosses-layers])──────────────────────────
+ * 本包 `hitl/parkResolver.ts` 另有一个导出型也叫 `GateOutcome`,说的是**本包决断腿的结局**
+ * (`decided` / `aborted` / `failed`),与 sdk 的 `GateOutcome`(**引擎的门记录**)是两个语义面。
+ * 本模块的公面型因此一律带 `View` 后缀,两者在任何一处都不许互相赋值 —— 合并它们会让「这次门怎么
+ * 过的」与「这条决断链怎么收的」同形。
+ */
+import type { DeniedBy, Settlement } from '@sema-agent/sdk';
+/**
+ * 这次门通过的**最终处置**。`deniedBy` 按**开集**读(型面用 sdk 的闭八词并 `string` 放宽,理由见
+ * 模块顶注)——`policy` / `hook` / `org` / `classifier` / `plan_mode` / `compliance` /
+ * `write_protection` / `ask_resolution`。
+ */
+export type GateDispositionView = {
+    kind: 'allowed';
+} | {
+    kind: 'denied';
+    deniedBy: DeniedBy | (string & {});
+};
+/** 结算方的身份座(形由 {@link SettlementView.kind} 决定,本读器不重铸那张配对表)。 */
+export interface SettlementWhoView {
+    /** `person` / `engine` / `host` / `none`(开集读)。 */
+    party: string;
+    /** 审批通道**自报**的身份串;UNTRUSTED-for-display,缺席 = 通道没报名字。 */
+    approver?: string;
+    /** 引擎侧是**哪一只窗**(`approval_factory` / `denial_limit`);非引擎方恒缺席。 */
+    window?: string;
+}
+/** 一只 ask 在等的那次等待**怎么结束的**。 */
+export interface SettlementView {
+    /** 闭十二词(core `SETTLEMENT_KINDS`),**按开集读**。 */
+    kind: Settlement['kind'] | (string & {});
+    who: SettlementWhoView;
+    /** epoch ms,写在结算发生的那一处。非有限数 ⇒ 缺席(绝不铸一个 0 时刻)。 */
+    when?: number;
+    /** 拒批人附的那句话。**没有 note 的拒 = 一句干脆的「不」**,不是「没说理由」。UNTRUSTED。 */
+    note?: string;
+}
+/** 一次工具门通过的整条记录(sdk `GateOutcome` 的**防御读**视图)。 */
+export interface GateOutcomeView {
+    disposition: GateDispositionView;
+    /** 只在**这次通过真的结算了一只 ask** 时在场。与 {@link origin} 同在同缺。 */
+    settlement?: SettlementView;
+    /** 谁**问**的(core `ASK_ORIGINS`,7.6.0 起十词;**按开集读**)。与 {@link settlement} 同在同缺。 */
+    origin?: string;
+}
+/**
+ * `tool_end` 帧(或本包投影出的 `tool_end_result` 内部臂、耐久行的 resolved outcome)→ 门记录。
+ *
+ * 入参是**帧**而不是 `frame.gate`,刻意如此:端不必知道这条记录挂在哪个键上(那正是下一次形变
+ * 会动的东西),也不必自己判「这一帧带不带门」。
+ *
+ * 🔴 `disposition` 是**唯一的承重座**:它读不出来 ⇒ 整只 `undefined`。一条只有 `settlement` 而
+ *    说不出「放行还是拒了」的记录,消费端能从它得到的只有误导。
+ * 🔴 **不校 I1–I4 那四条不变量**(`settlement` ⇔ `origin` 同在、`ask_resolution` ⇒ 有拒绝类结算……):
+ *    筛子的属主是引擎,server 对过不了筛的记录**整条不投**。包再校一遍,只会在上游合法演进的当天
+ *    把一条真记录判没,而本层给不出比「原样交给端」更好的降级动作(`wiring_manifest.autoMode`
+ *    那一段的反向先例是**同一条帧上的段内自洽**,不是跨系统的不变量,两者刻意不同处置)。
+ */
+export declare function gateOutcomeOf(frame: unknown): GateOutcomeView | undefined;
+/**
+ * 这次调用是**被门 park 了**吗 —— 「没在这里结算」的**第二形**(engine 7.64.0 真机黑盒直证)。
+ *
+ * 🔴 **为什么非有它不可**:审批窗走完(默认 300s)未决而走 park 路径时,`tool_end` 帧上
+ *    **没有 `gate` 字段** —— 只有 `errorCode: "gate.parked"`。⇒ 单锚 {@link gateOutcomeOf} 的
+ *    消费点在这一形上什么都读不到,而这一形**恰恰是端最想说一句话的那一格**(「已转后台候批」)。
+ * 🔴 **两形合起来才是「这次调用没在这里结算」的完整判据**,端要判这件事写:
+ *    `isApprovalWindowExpiredGate(gateOutcomeOf(f)) || isGateParkedToolEnd(f)`。
+ *    两形语义**不同**、不许互相顶替:前者是「窗走完了,拒了」,后者是「park 了,还没人决」。
+ * 🔴 **入参是整只帧**(与 {@link gateOutcomeOf} 同姿势):端不必知道这一位挂在哪个键上。
+ * 🔴 缺席不带语义:大多数 `tool_end` 都不带这个码,缺席 ≠「已经结算过了」。
+ */
+export declare function isGateParkedToolEnd(frame: unknown): boolean;
+/** 这次门是不是**拒**(缺席 ⇒ `false` —— 缺席不带语义,见模块顶注)。 */
+export declare function isDeniedGate(g: GateOutcomeView | undefined): boolean;
+/** 拒这次的是**哪一层**(`policy` / `hook` / `org` / …;开集)。非拒 / 缺席 ⇒ `undefined`。 */
+export declare function gateDeniedBy(g: GateOutcomeView | undefined): string | undefined;
+/**
+ * 这次结算是**谁**的(审批通道自报的身份串)。UNTRUSTED-for-display。
+ * 🔴 缺席 = 通道没报名字 —— 永不意味「没人批」,也永不意味「有人批」。
+ */
+export declare function gateApprover(g: GateOutcomeView | undefined): string | undefined;
+/**
+ * 这次拒是**审批窗自己走完**的吗 —— 端此前自拼的那个两键合取(`settledBy === 'timeout' &&
+ * resolution === 'window_expired'`)的**继任单源**。
+ *
+ * 判据 = `settlement.kind === 'approval_window_expired'`(引擎自己的审批工厂窗,或同步宿主
+ * approver 报「我的窗到了」)。
+ * 🔴 **刻意不含另外两条窗词**:`denial_limit_window_expired` 是**分类器限额回落**的自动拒窗
+ * (端要渲的是另一句话,见 {@link isDenialLimitAutoDeniedGate}),`park_sla_expired` 是**耐久 park**
+ * 的 SLA 到期(结束它的是宿主的扫,不是这次调用在等的那只审批窗)。旧形上这三件事共用一个
+ * `settledBy:"timeout"`,分不出来正是要靠 `resolution` 补第二个键的原因;形变把它们分成了三个词,
+ * 合并读回去等于把刚修好的判别力扔掉。
+ * 🔴 **正面匹配,绝不写不等式**:不等式对缺席与任何未来新词都为真。
+ */
+export declare function isApprovalWindowExpiredGate(g: GateOutcomeView | undefined): boolean;
+/**
+ * 这次拒是**引擎的限额回落窗自己拒的**吗(不是人拒的)—— 端此前读的 `tool_end.autoDenied === true`
+ * 的**继任单源**。
+ *
+ * 判据 = `settlement.kind === 'denial_limit_window_expired'`(auto 模式分类器的拒绝上限回落窗:
+ * 那张必须真人批的卡在 `autoDenyAfterMs` 走完之后由**引擎**判 deny)。
+ * 🔴 它答的正是 {@link isApprovalWindowExpiredGate} 答不了的那一问:「这一次到期是**自动拒**收的场,
+ *    还是 park 了等人」。端要渲的两句话(「自动拒(限额回落)」vs「已转后台候批」)卡在这一格上。
+ * 🔴 **不据它自铸第二只定时器/第二张资格表**:窗的执行全在引擎,本位是**事后**的判别位。
+ */
+export declare function isDenialLimitAutoDeniedGate(g: GateOutcomeView | undefined): boolean;
+/**
+ * 这次结算是**耐久 park 的 SLA 到期**被宿主的扫判成拒的吗。
+ * 🔴 与上面两条并列而不合并:它说的是「那一行在队列里坐过了 deadline」,与「这次调用在等的审批窗
+ *    走完了」是两件不同的事,出路也不同(前者要重新提这一步,后者可以再决一次)。
+ */
+export declare function isParkSlaExpiredGate(g: GateOutcomeView | undefined): boolean;
+/**
+ * 这次门记录是**人**做的决定吗(`human_allowed` / `human_refused`)。
+ * 🔴 「人批了之后被复查否决」(上游不变量 I3)在这里读作:本谓词为 `true` **且** {@link isDeniedGate}
+ *    也为 `true` —— 那时 `deniedBy` 指的是复查那一层,approver 留在结算上,**不是** approver 的拒。
+ */
+export declare function isHumanSettledGate(g: GateOutcomeView | undefined): boolean;