@sema-agent/client-core 0.11.11 → 0.11.13

package/README.md

@@ -23,7 +23,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.11.11
+**Version:** 0.11.12
 
 - **Today** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
   B/D/E tool-card layers), the notification/caps/model families, the adapter kernel (stream driver
@@ -213,6 +213,7 @@ itself (FAILED names + skipped names + arithmetic reconciliation). All-SKIP repo
 | `scripts/run-print-bash-iserror-test.mjs` | The print lane's Bash `is_error` authority (structured over regex) |
 | `scripts/run-sdk-floor-test.mjs` | The SDK version floor — and, more to the point, that the *installed* type declarations still carry the keys this package reads |
 | `scripts/run-engine-vocab-floor-test.mjs` | Engine-mirrored vocabularies (structured card whitelist, self-reported tool face, control verbs, recogniser sets) against the *installed* `@sema-agent/core` |
+| `scripts/run-streamjson-timing-honesty-test.mjs` | Stream timing & terminal honesty ([2084]): held errored fs-write results release on model progress; wall-clock timeout maps to `error_during_execution` with a truthful salvage note; the synthetic API-error assistant row carries the `<synthetic>` in-message sentinel |
 | `scripts/run-public-surface-test.mjs` | The outward promises: the npm export surface baseline, the peer floor witness, and this README's claims |
 
 Each suite carries a floor that only moves up — a refactor that stops executing a group of

package/dist/adapter/downstream/terminalToSdkResult.d.ts

@@ -35,9 +35,11 @@
  *   failed          limit.max_turns               → 'error_max_turns'             true
  *   failed          output.invalid                → 'error_max_structured_output_retries' true
  *   failed          其余(含 cancelled/conflict…) → 'error_during_execution'      true
- *   timeout         limit.timeout                 → 'error_max_turns'             true
- *                   (CC 无 wall-clock deadline 概念;词表内最贴 = 唯一 run-limit 族词
- *                    error_max_turns。真实语义靠 errors[] 文案 + errorCode 透传辨认。)
+ *   timeout         limit.timeout                 → 'error_during_execution'      true
+ *                   (CC 无 wall-clock deadline 概念。曾选 error_max_turns「唯一 run-limit 族词」,
+ *                    [2084]②a 定谳那是帧内自相矛盾(errorCode=limit.timeout+num_turns 远小于上限)
+ *                    且对墙钟停指错旋钮(max-turns 是可恢复失败)⇒ 改诚实兜底词。
+ *                    真实语义靠 errors[] 文案 + errorCode 透传辨认,不变。)
  *   blocked         —(engine 只给 blockedReason)→ 'error_during_execution'      true
  *   suspended       —                             → 'error_during_execution'      true([884]A1)
  *   needs_review    review.pending                → 'error_during_execution'      true([884]A1)

package/dist/adapter/downstream/terminalToSdkResult.js

@@ -203,7 +203,14 @@ export function doneToSdkResult(ev, ctx) {
             uuid: undefined,
             session_id: undefined,
             type: 'result',
-            subtype: 'error_max_turns',
+            // [2084]②a(2026-07-30,repro/cli-walltime-timeout-reported-as-max-turns):此前硬编码
+            // error_max_turns(选型理由是「CC 词表唯一 run-limit 族词」),但那让同一帧自相矛盾
+            // (errorCode=limit.timeout + num_turns 远小于上限,test 实测 num_turns:2 且根本没设
+            // --max-turns),而且 max-turns 是**可恢复失败**——标准应对是调大 --max-turns 重试,对
+            // 墙钟停这恰好是那个帮不上忙的旋钮。改 error_during_execution(CC 词表内的诚实兜底);
+            // 真实语义仍靠 errorCode:"limit.timeout" + errors[] 文案判别(原设计轴不动)。
+            // 副产品:真 limit.max_turns 停(failed 臂)与墙钟停在 subtype 上重新可分。
+            subtype: 'error_during_execution',
             duration_ms: durationMs,
             duration_api_ms: durationMs,
             is_error: true,
@@ -213,8 +220,11 @@ export function doneToSdkResult(ev, ctx) {
             usage,
             modelUsage,
             permission_denials: [],
+            // [2084]②b:引擎的 cutoff 句承诺「cut off to preserve a write-out window」,但 pre-call
+            // throw 路径上写出窗可能零兑现(core dist/brain/stream-engine 五处 throw,载体天生空)。
+            // 抢救为空时补诚实尾注——每一层都复述没兑现的承诺,消费者就无从分辨救没救回来。
             errors: [
-                `${rr.errorMessage ?? 'run hit its wall-clock deadline and was finalized by the engine'} (${rr.errorCode ?? 'limit.timeout'})`,
+                `${rr.errorMessage ?? 'run hit its wall-clock deadline and was finalized by the engine'} (${rr.errorCode ?? 'limit.timeout'})${salvaged === undefined ? ' — no output survived the cutoff' : ''}`,
             ],
             ...errorCodeField,
             // 写出窗 salvage(additive seam 字段):deadline 前引擎救回的最终文本非空时随帧带出——

package/dist/adapter/runStream.js

@@ -149,7 +149,11 @@ async function* runStreamInner(events, ctx, handle = {}) {
                     session_id: ctx.sessionId ?? '',
                     uuid: `err-${Date.now().toString(36)}`,
                     type: 'assistant',
-                    message: { role: 'assistant', content: [{ type: 'text', text: rowText }] },
+                    // [2084]③:message 内部要有判别哨兵——外层 isApiErrorMessage/err- uuid 只护住读信封的
+                    // 消费者,而转录回喂/摘要器/评分器读的是 message 本体,没有 in-message 标记就会把这句
+                    // 引擎文案当成模型自己说的话。CC 2.1.220 同款哨兵 = model:'<synthetic>'(下游投影层对
+                    // string 型 model 原样保留,不再回填真模型名)。
+                    message: { role: 'assistant', model: '<synthetic>', content: [{ type: 'text', text: rowText }] },
                     parent_tool_use_id: null,
                     isApiErrorMessage: true,
                 };

package/dist/headlessReconnectWire.js

@@ -100,7 +100,7 @@ export async function* withHeadlessR1Reconnect(live, deps) {
                 if (t === 'error') {
                     // STREAM_MAX_DURATION cap 帧(server streamSseLog):SDK parseSse 已锁存 Last-Event-ID
                     // 并自动重开(同一次 openEvents 内部,计入同一次预算)——本帧是车道协议杂音,不下发。
-                    debugLog(`runs.events lane frame type=error code=${String(rec?.code ?? '')} — SDK resumes with Last-Event-ID internally`);
+                    debugLog(`runs.events lane frame type=error code=${String(rec?.errorCode ?? rec?.code ?? '')} — SDK resumes with Last-Event-ID internally`);
                     continue;
                 }
                 const seq = typeof rec?.id === 'string' && /^\d+$/.test(rec.id) ? Number(rec.id) : undefined;

package/dist/hitl/askGateWire.js

@@ -140,6 +140,10 @@ export function observeCancelByDeny(settle, taskId) {
         hostLog('debug', `[hitl-ask] cancel-by-deny settled for run ${taskId} (session unlocked)`);
     })
         .catch((e) => {
+        // ⚠️ 这里的 `.code` 是 **client-core 自家 HitlSafetyError 的契约属性**(hitlBridge.ts,词表
+        // binding_mismatch|no_pending|wrong_gate|bad_plan_edit)—— 不是 SDK 错误的 `errorCode`。
+        // 2026-07-30 `.code` 普查曾把本处误判成 SDK 属性名病改成 errorCode,pure 门 B7 腿当场拦下
+        // (反向修复);判 `.code` 读点的病与否,先看**谁抛的**,别按属性名模式匹配。
         if (e?.code === 'no_pending') {
             hostLog('debug', `[hitl-ask] cancel-by-deny no_pending for run ${taskId} (benign — already resolved)`);
             return;
@@ -293,6 +297,21 @@ export async function* bridgeAskUserQuestionGates(source, deps, opts) {
             const seq = ev.id;
             if (typeof seq === 'string' && seq.length > 0)
                 lastSeq = seq;
+            // ── [2084]① 扣留帧「模型推进即放行」(2026-07-30)─────────────────────────────────────
+            // HOLD 的本意只护 park 窗口:毒化 tool_end 与 park 信号(suspended/done-park/approval 帧)
+            // 之间只会隔 sibling tool_end 与通知类帧——引擎 park 时模型**不可能**推进。反之,host-lane
+            // 的 text_delta/reasoning_delta/tool_start/turn_end 任一到达 = 没有 park 会来,扣着的是
+            // **真工具错**,立即放行。修前真错只能等终帧 flush ⇒ `-p` stream-json 里 errored Edit/Write
+            // 结果滞后无上界(test 生产轨迹最大 195 行,repro/cli-tool-streamjson-failed-result-delayed)。
+            // parentToolCallId 在场 = sub-agent 行帧,park 期间孙代照常说话,不算 host 推进(负控①C)。
+            if (heldAskEnds.size > 0 &&
+                (ev.type === 'text_delta' ||
+                    ev.type === 'reasoning_delta' ||
+                    ev.type === 'tool_start' ||
+                    ev.type === 'turn_end') &&
+                ev.parentToolCallId === undefined) {
+                yield* flushHeld();
+            }
             // ── server 1.191 同步帧腿([830]①):`tool_approval` 帧 → 三选卡 → respond ────────────────
             // 引擎此刻同步阻塞在帧上(fail-closed:无 respond/TTL 5min/abort ⇒ deny),await 卡决断安全。
             // 帧是 HITL 词汇非 AgentEvent arm——两种帧都不外泄到渲染管道。

package/dist/subagent/engineTaskHandleWire.js

@@ -134,10 +134,14 @@ export function mergeTaskOutput(prev, fresh) {
  */
 export function classifyTaskStopConflict(e) {
     const detail = e instanceof Error ? e.message : String(e);
-    const raw = e?.code;
-    // typed 优先:SDK ≥0.0.11x 恒给 TaskStopConflictError 且 `code` 是 errorCode 原文。
-    // 兜底(老 SDK / 非 typed 抛点):code 非串时从 message 里认字面 —— 与手抄版同姿势,只是
-    // 现在是**回落**而不是主判据。
+    const raw = e?.errorCode;
+    // typed 优先:SDK typed 错误(APIError 族)的机器码属性是 **`errorCode`**(peer 地板 >=2.0.0 恒有)。
+    // 🔴 2026-07-30 提货批实锤:此前这里读 `.code` —— 那是 0.x SDK 的属性名,1.0.0 错误层级重做后
+    //   typed 类只带 `.errorCode`,于是五形分类整体塌 `unknown_conflict`。本仓 pure 门没抓到,因为
+    //   测试 fixture 也是手搓 `{status, code}` 老形 —— 实现与 fixture 同错互证(假绿)。壳的
+    //   run-bulk-stop-engine-rows 门用**真 SDK** 打假 HTTP 引擎才现形(跨仓交叉验证)。修后 fixture
+    //   改锚实装 SDK 的 TaskStopConflictError 真类,fixture 再也漂不动。
+    // 兜底(非 typed 抛点):errorCode 非串时从 message 里认字面 —— 回落,不是主判据。
     const code = typeof raw === 'string'
         ? raw
         : (STOP_CONFLICT_CODES.find(c => detail.includes(c)) ?? '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.11.11",
+  "version": "0.11.13",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",