@sema-agent/client-core 0.11.7 → 0.11.8

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

@@ -49,9 +49,11 @@
  * timeout salvage:写出窗兑现的 r.result(非空)骑 additive `result` 字段——CC error 帧无
  * result,但把引擎已救回的最终文本静默丢弃对 -p 消费者是净损失。
  *
- * costUsd === 0 is AMBIGUOUS (free vs. no MODEL_COST_* configured): disambiguate
- * upstream via Capabilities.pricingConfigured (contract 02 §2.10 VERIFY); this
- * projector passes the number through verbatim.
+ * 成本取数 = `TaskStats.costMicroUsd`(整数 micro-USD 单轨,SDK 1.0.0 / server 1.319.0 /
+ * core 2.0.0 起;legacy float `costUsd` 已删,见 costOrNull 头注)。零成本 is AMBIGUOUS
+ * (free vs. no MODEL_COST_* configured): disambiguate upstream via
+ * Capabilities.pricingConfigured (contract 02 §2.10 VERIFY); this projector converts
+ * the integer to USD (/1e6) and passes it through verbatim otherwise.
  */
 import type { AgentEvent } from '@sema-agent/sdk';
 import { type SDKMessage, type EmitContext } from '../types.js';

package/dist/adapter/downstream/terminalToSdkResult.js

@@ -21,14 +21,41 @@ function elapsedMs(ctx) {
     return typeof ctx.startedAtMs === 'number' ? Math.max(0, Date.now() - ctx.startedAtMs) : 0;
 }
 /**
- * P1-5 — `total_cost_usd` truthfulness: `costUsd === 0` is AMBIGUOUS (free vs. no MODEL_COST_* configured
+ * micro-USD → USD。引擎账面的成本单位是 **micro-USD**(百万分之一美元,整数轨:1e6 micro = 1 USD;
+ * 整数是为了不吃 FP 漂移)。CC 的输出面字段 `total_cost_usd` / `costUSD` 单位是 **USD**(字段名即
+ * 单位),所以出口一律 `/1e6`。非有限值(NaN/Infinity)不上账 —— Infinity 比 undefined 更糟,它会被
+ * 当成真数字参与求和,把一条离谱账悄悄摊进总计(与 SDK `taskCostMicroUsd()` 的规约逐条同义;
+ * `mapModelUsage()` 里的 `costMicroUsd / 1e6` 是同一换算的既有用法,两处此后共用本函数)。
+ *
+ * 为什么不直接调 SDK 的 `taskCostMicroUsd()`:本文件在 `runStream` **可移植闭包**内,portability 门
+ * 对该闭包断言「值级外部包 = 空集」(EXPECTED_PACKAGES_KERNEL),值级 import SDK 会当场红。故就地
+ * 复刻规约,单一真源以 SDK 那份注释为准。
+ */
+function microUsdToUsd(micro) {
+    return typeof micro === 'number' && Number.isFinite(micro) ? micro / 1e6 : null;
+}
+/**
+ * P1-5 — `total_cost_usd` truthfulness: 成本 `0` is AMBIGUOUS (free vs. no MODEL_COST_* configured
  * on the worker — the local TOC engine ships unconfigured, so `-p --output-format json` was reporting a
  * fake `0`). Emit the number only when it is a REAL positive cost; otherwise `null` (JSON consumers see
  * "unknown", never a fabricated zero). CC's schema field is numeric — number-guarded readers
  * (replEntry cost fold) already treat non-number as absent.
+ *
+ * 🔴 键迁移([2006] cli 自查最重命中,2026-07-29):取数源从 legacy float `TaskStats.costUsd` 换成
+ * 整数 `TaskStats.costMicroUsd`。`costUsd` 已被 **core 2.0.0 / server 1.319.0 / SDK 1.0.0 同批删除**
+ * (发端、适配、类型三层),对 core 2.0.0+ 引擎该键恒 undefined ⇒ 本函数恒 null ⇒ `sema -p
+ * --output-format json` 的 `total_cost_usd` **恒 null**,而账其实一直在 `costMicroUsd` 上
+ * (本文件 `mapModelUsage()` 早就在读它 = 两代键并存的实锤)。devDep 此前钉 SDK `^0.1.7`(0.x 的 caret 是精确锁)
+ * ⇒ 类型层看到的还是「两轨都在」的旧声明,对 1.0.0 才报 TS2345 —— 校旧物的门抓不住这类断链,故
+ * 另有 `run-sdk-floor-test.mjs` 断言实装 SDK 地板 ≥ 1.1。
+ *
+ * 老引擎只发 float `costUsd` 时**不做兼容换算**:单轨之后读到 undefined(当场可见「不知道」)好过
+ * 把一笔来源可疑的账静默吸收成看起来正常的数字(SDK normalize.ts 的 BREAKING 留档同款裁定;
+ * 本仓 [clean-cut-no-legacy-compat])。
  */
-function costOrNull(costUsd) {
-    return typeof costUsd === 'number' && costUsd > 0 ? costUsd : null;
+function costOrNull(stats) {
+    const usd = microUsdToUsd(stats?.costMicroUsd);
+    return usd !== null && usd > 0 ? usd : null;
 }
 // 件2a(中断事故修复批 G,2026-07-15,症状2 第一环):参数放宽 TaskStats | undefined + 全链守卫。
 // 409 active-run 拒绝时引擎的 done 帧本体是 {status:'failed', errorMessage, activeTaskId} —— NO stats
@@ -51,7 +78,7 @@ function mapModelUsage(stats) {
             cacheReadInputTokens: num(m.cacheReadTokens),
             cacheCreationInputTokens: num(m.cacheWriteTokens),
             webSearchRequests: 0,
-            costUSD: num(m.costMicroUsd) / 1e6,
+            costUSD: microUsdToUsd(m.costMicroUsd) ?? 0, // ⇐ 与 costOrNull 同一个换算口(旧写法 num(...)/1e6 逐值等价)
             contextWindow: 0,
             maxOutputTokens: 0,
         };
@@ -79,7 +106,11 @@ export function doneToSdkResult(ev, ctx) {
         modelUsage = {
             [r.model]: {
                 ...usage,
-                costUSD: typeof stats?.costUsd === 'number' ? stats.costUsd : 0,
+                // 键迁移(见 costOrNull 头注):legacy float `costUsd` → 整数 `costMicroUsd`(/1e6 → USD)。
+                // ⚠️ 这一处**类型门抓不到**:TaskStats 带 `[key: string]: unknown` 开集索引,`typeof
+                // stats?.costUsd === 'number'` 的旧写法在 SDK 1.x 下照样编译得过,只是恒假 ⇒ 合成行的
+                // costUSD 静默恒 0(比报错更隐蔽)。tsc 只红了 6 处直传,这处靠人核。
+                costUSD: microUsdToUsd(stats?.costMicroUsd) ?? 0,
                 contextWindow: 0,
                 maxOutputTokens: 0,
             },
@@ -129,7 +160,7 @@ export function doneToSdkResult(ev, ctx) {
             is_error: true,
             num_turns: stats?.turns ?? 0,
             stop_reason: null,
-            total_cost_usd: costOrNull(stats?.costUsd), // P1-5: null when unknown, never a fake 0
+            total_cost_usd: costOrNull(stats), // P1-5: null when unknown, never a fake 0
             usage,
             modelUsage,
             permission_denials: [],
@@ -178,7 +209,7 @@ export function doneToSdkResult(ev, ctx) {
             is_error: true,
             num_turns: stats?.turns ?? 0,
             stop_reason: null,
-            total_cost_usd: costOrNull(stats?.costUsd),
+            total_cost_usd: costOrNull(stats),
             usage,
             modelUsage,
             permission_denials: [],
@@ -207,7 +238,7 @@ export function doneToSdkResult(ev, ctx) {
             is_error: true,
             num_turns: stats?.turns ?? 0,
             stop_reason: null,
-            total_cost_usd: costOrNull(stats?.costUsd),
+            total_cost_usd: costOrNull(stats),
             usage,
             modelUsage,
             permission_denials: [],
@@ -256,7 +287,7 @@ export function doneToSdkResult(ev, ctx) {
             is_error: true,
             num_turns: stats?.turns ?? 0, // 件2a 同款守卫 —— park 帧多数不带 stats,不炸
             stop_reason: null,
-            total_cost_usd: costOrNull(stats?.costUsd),
+            total_cost_usd: costOrNull(stats),
             usage,
             modelUsage,
             permission_denials: [],
@@ -280,7 +311,7 @@ export function doneToSdkResult(ev, ctx) {
             is_error: true,
             num_turns: stats?.turns ?? 0,
             stop_reason: null,
-            total_cost_usd: costOrNull(stats?.costUsd),
+            total_cost_usd: costOrNull(stats),
             usage,
             modelUsage,
             permission_denials: [],
@@ -308,7 +339,7 @@ export function doneToSdkResult(ev, ctx) {
         })(),
         ...degradedField,
         stop_reason: null, // dropped (contract 02 §2.10)
-        total_cost_usd: costOrNull(stats?.costUsd), // P1-5: costUsd===0 is "unconfigured pricing" → null, never a fake 0
+        total_cost_usd: costOrNull(stats), // P1-5: 零成本 = "unconfigured pricing" → null, never a fake 0
         usage,
         // MF-25/P1-5 — the per-model usage split (wire `stats.modelUsage`, or the synthesized current-model row).
         modelUsage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.11.7",
+  "version": "0.11.8",
   "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",
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@sema-agent/agent-types": "^0.2.0",
-    "@sema-agent/sdk": "^0.1.7",
+    "@sema-agent/sdk": "^1.1.0",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"
   }