@sema-agent/client-core 0.11.12 → 0.11.13

package/README.md

@@ -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/hitl/askGateWire.js

@@ -297,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.11.12",
+  "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",