@sema-agent/client-core 0.11.1 → 0.11.3

package/dist/controlRouter.js

@@ -219,7 +219,8 @@ function errCodes(e) {
     if (!e || typeof e !== 'object')
         return {};
     const o = e;
-    return { code: o.errorCode ?? o.code, name: o.name, status: o.status ?? o.statusCode };
+    // [1912] errorCode 恒在(server ≥1.302 canonical)——`?? o.code` 老兜底已清;status 双键保留(HTTP 层形非 wire 键)。
+    return { code: o.errorCode, name: o.name, status: o.status ?? o.statusCode };
 }
 /** 409 `steering.not_running` / `SteeringNotRunningError` — the run is suspended/terminal (runs.ts:45). */
 function isSteeringNotRunning(e) {

package/dist/hitl/hitlBridge.js

@@ -248,7 +248,8 @@ function isBindingMismatch(e) {
     if (!e || typeof e !== 'object')
         return false;
     const o = e;
-    const code = o.errorCode ?? o.code;
+    // [1912] errorCode 恒在(server ≥1.302 canonical;全端引擎达标线 ≥1.303)——`?? o.code` 老兜底已清。
+    const code = o.errorCode;
     if (code === 'approval_binding_mismatch')
         return true;
     // SDK throws a named ApprovalBindingMismatchError (index.ts:19).

package/dist/hitl/toolApprovalWire.d.ts

@@ -88,6 +88,12 @@ export interface ToolApprovalFrame {
     type: 'tool_approval' | 'tool_approval_complete';
     approvalId: string;
     toolName?: string;
+    /** server ≥1.307([1940] 兑现 [1939],ADDITIVE):引擎 tool-call id——与 assistant 消息
+     *  `tool_use` block 的 `call_…` 同一枚。**审批卡锚这个**,不锚 approvalId(现铸 uuidv7,流上
+     *  再无人提起 ⇒ 按它键的卡永不被回收)也不锚「最近一次 tool_start」(审批帧先于 tool_start
+     *  到达,契约 §4a-bis 实测 4020ms vs 4142ms)。`tool_approval_complete` 上刻意不带(免多锚
+     *  歧义)。旧 server 缺席 ⇒ 消费方保留 approvalId 兜底但必须能被真 id 收敛。 */
+    toolCallId?: string;
     message?: string;
     args?: unknown;
     argsOmitted?: boolean;
@@ -102,6 +108,12 @@ export interface ToolApprovalFrame {
     /** core 1.378 RB-39②:展示身份(UNTRUSTED-for-display,server redact 后上帧)——徽章名一手源。 */
     sourceAgentName?: string;
 }
+/**
+ * 本地值拷贝的**运行时键集镜像**([1950]② 建议形):对账测试拿它与 SDK 0.1.6+ 的同源锚
+ * `TOOL_APPROVAL_FRAME_KEYS` 比对——SDK additive 增键时对账当天红,不再人肉追平。
+ * 下面两个类型钉保证镜像与 interface 本身不可能漂移(少键/多键都是编译错)。
+ */
+export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "outcome"];
 /** 子代帧判别:显式键 fromSubagent(core 1.378 RB-39②)优先;缺席退 sourceTaskId 在场性权宜式
  *  (server 1.258 [1549]①3,旧代际兼容)。 */
 export declare function isFromSubagent(frame: ToolApprovalFrame): boolean;

package/dist/hitl/toolApprovalWire.js

@@ -158,6 +158,26 @@ export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signa
             }
     }
 }
+/**
+ * 本地值拷贝的**运行时键集镜像**([1950]② 建议形):对账测试拿它与 SDK 0.1.6+ 的同源锚
+ * `TOOL_APPROVAL_FRAME_KEYS` 比对——SDK additive 增键时对账当天红,不再人肉追平。
+ * 下面两个类型钉保证镜像与 interface 本身不可能漂移(少键/多键都是编译错)。
+ */
+export const TOOL_APPROVAL_FRAME_KEYS_MIRROR = [
+    'type',
+    'approvalId',
+    'toolCallId',
+    'toolName',
+    'sourceTaskId',
+    'fromSubagent',
+    'sourceAgentName',
+    'message',
+    'args',
+    'argsOmitted',
+    'outcome',
+];
+const _mirrorPin = [true, true];
+void _mirrorPin;
 /** 子代帧判别:显式键 fromSubagent(core 1.378 RB-39②)优先;缺席退 sourceTaskId 在场性权宜式
  *  (server 1.258 [1549]①3,旧代际兼容)。 */
 export function isFromSubagent(frame) {

package/dist/printToolResultFrame.d.ts

@@ -47,6 +47,8 @@ export interface ToolEndResultArmLike {
     toolName?: unknown;
     isError?: unknown;
     output?: unknown;
+    /** 引擎 CC-shaped details(core 1.199+ AgentToolResult.details;Bash 时带 exitCode)。 */
+    structured?: unknown;
     truncated?: unknown;
     parentToolCallId?: unknown;
     uuid?: unknown;

package/dist/printToolResultFrame.js

@@ -25,12 +25,21 @@ export function flattenToolOutput(output) {
  * Bash 臂的 is_error 派生(真行为实证,2026-07-16):引擎 tool_end.isError 语义 = 「工具本身
  * 是否执行失败」——命令非零退出时工具照常返回模型面框架文本(core runShell `exit code: N\n---
  * stdout ---…`)且 isError:false。CC 2.1.207 的 Bash tool_result 对非零退出置 is_error:true;
- * 交互 REPL 桥已按同款派生(upstreamBridge.ts:384 `failed = isError || exitCode !== 0`)。
- * 这里对 Bash 输出的框架头做同源轻量嗅探(不拖 REPL 桥的重 import 图)。
+ * 交互 REPL 桥按同款派生。
+ *
+ * 🔴 语序与 toolResult.ts T11 逐字同款([1948] E4 / core RB-257,2026-07-29):
+ * **structured.exitCode 在场 ⇒ 权威直读;缺席 ⇒ 正则反解兜底**。此前只有正则——输出超
+ * 30000 字符溢写成 persisted-output 引用后,前缀把 `exit code: N` 挤出行首,锚失配 ⇒
+ * 非零退出照样 is_error:false(test AI 生产轨迹 2/2 命中);而 structured 字段在溢写时
+ * **完好保留**,正是为这种形准备的。兜底失锚时如实 false,绝不按内容嗅探瞎猜
+ * (与 core [1951] 同判断:拿前缀猜 isError = 用一个谎换另一个谎)。
  */
-function bashExitCodeFailed(toolName, text) {
+function bashExitCodeFailed(toolName, text, structured) {
     if (typeof toolName !== 'string' || toolName.toLowerCase() !== 'bash')
         return false;
+    const ec = structured?.exitCode;
+    if (typeof ec === 'number')
+        return ec !== 0;
     const m = /^exit code: (\d+)\b/.exec(text);
     return m !== null && m[1] !== '0';
 }
@@ -52,7 +61,7 @@ export function toolEndResultToUserFrame(arm) {
                     tool_use_id: arm.toolCallId,
                     // truncated 输出如实标注(观察面注记;截断体绝不回喂模型——upstreamBridge 同款)。
                     content: arm.truncated === true ? `${text}\n…(truncated)` : text,
-                    is_error: arm.isError === true || bashExitCodeFailed(arm.toolName, text),
+                    is_error: arm.isError === true || bashExitCodeFailed(arm.toolName, text, arm.structured),
                 },
             ],
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "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",
@@ -14,7 +14,7 @@
   "sideEffects": false,
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "node scripts/run-client-core-pure-test.mjs && node scripts/run-client-core-portability-test.mjs && node scripts/run-client-core-diff-test.mjs"
+    "test": "node scripts/run-client-core-pure-test.mjs && node scripts/run-client-core-portability-test.mjs && node scripts/run-client-core-diff-test.mjs && node scripts/run-print-bash-iserror-test.mjs && node scripts/run-approval-frame-keys-test.mjs"
   },
   "dependencies": {
     "diff": "^9.0.0"
@@ -25,7 +25,7 @@
   },
   "devDependencies": {
     "@sema-agent/agent-types": "^0.2.0",
-    "@sema-agent/sdk": "^0.1.0",
+    "@sema-agent/sdk": "^0.1.7",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"
   }