@deepwhale/llm 1.0.0

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @deepwhale/llm — OpenAI 兼容 LLM 客户端
+ *
+ * Sprint 0.3 落地：
+ * - DeepSeek OpenAI 兼容 HTTP 客户端（chat/非流式/abort/timeout）
+ * - 4 种 LLMError 子类（APIKeyMissing / RateLimit / Auth / Network / Unknown）
+ * - fetch 注入 → 单测 100% mock
+ *
+ * Sprint 1a 扩展：流式 + tool_calls + retry/backoff + usage + 6 个 LLMError 子类
+ * Sprint 1b 再加：cache_hit_rate、canonical schema
+ * Sprint 1b.5: pricing config.toml 化 — CostBreakdown / computeCostBreakdown
+ *   从 types.js 整体迁移到 pricing-config.js (per-model currency, R7 缺失定价中间路径).
+ */
+export const DEEPWHALE_LLM_VERSION = '0.1.0';
+export { DeepSeekClient, DEEPSEEK_BASE_URL, DEEPSEEK_DEFAULT_MODEL } from './deepseek-client.js';
+// Sprint 1b.5 Step 2: Anthropic provider (走 /anthropic endpoint, DeepSeek shim)
+// - D1 拍板: 用官方 @anthropic-ai/sdk 实例发请求, 手写 parseAnthropic* 翻译
+// - X3 拍板: Step 2 不接真, 测试用 mock fetch
+export { AnthropicClient, DEEPSEEK_ANTHROPIC_BASE_URL, ANTHROPIC_DEFAULT_MODEL } from './anthropic-client.js';
+export { canonicalizeSchema } from './canonicalize-schema.js';
+// Sprint 1b.5 Step 2: 抽出来给 AnthropicClient 复用. parseOai* 处理 OAI-shape 协议
+// (DeepSeek 直接返 + DeepSeek shim 接 /anthropic 路径时也返 OAI-shape).
+export { isSseDoneSentinel, parseOaiChatCompletion, parseSseEvent, parseSseUsageField } from './parse.js';
+export { parsePricingConfig, loadPricingConfig, computeCost, PricingConfigParseError, } from './pricing-config.js';
+export { isLLMError } from './types.js';
+export { APIKeyMissingError, LLMRateLimitError, LLMAuthError, LLMNetworkError, LLMUnknownError, LLMStreamError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEjG,gFAAgF;AAChF,8DAA8D;AAC9D,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAE9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,yEAAyE;AACzE,+DAA+D;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAoB7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @deepwhale/llm — OpenAI-shape 协议解析层
+ *
+ * Sprint 1b.5 Step 2 抽出来: 之前这些 module-level fn 在 deepseek-client.ts 里,
+ * Step 2 起 AnthropicClient (走 /anthropic endpoint, DeepSeek shim 返 OpenAI-shape)
+ * 也需要复用, 抽到 parse.ts 当共享解析层.
+ *
+ * 设计原则:
+ * - 纯函数, 零副作用 (无 console / 无 I/O)
+ * - pricing/model 都是 optional, 缺时走 R7 中间路径 (base 2 字段, cost 字段 absent)
+ * - 不假设 caller 是 deepseek / anthropic, 任何返 OpenAI-shape JSON 的协议都走这层
+ *
+ * 不在这层的:
+ * - SSE 协议层 (data:/event:/id:/retry: 协议) — 留在 deepseek-client.ts:isSseDoneSentinel
+ * - HTTP / fetch / retry — caller 负责
+ * - request 编组 (ChatMessage → wire JSON) — 留 caller (toWireMessage 是 deepseek 私货)
+ */
+import type { ChatResult, ChatChunk, ModelId, Usage } from './types.js';
+import type { PricingConfig } from './pricing-config.js';
+/**
+ * 解析 OAI chat completion 完整响应 JSON 为 ChatResult.
+ * 返 null 表示响应结构无效 (缺 choices[0].message), caller 决定抛什么错.
+ *
+ * @param fallbackModel - 响应里没 model 字段时用的 fallback (避免 "unknown model" 传播)
+ * @param pricing - 可选, 用于算 cost_turn + cost_currency. undefined 走 R7 中间路径.
+ */
+export declare function parseOaiChatCompletion(json: unknown, fallbackModel: ModelId, pricing?: PricingConfig): ChatResult | null;
+/**
+ * 判断 SSE event raw text 是否是 OAI 协议的 [DONE] 终止 marker.
+ * 在 parseSseEvent 之前调用, 确保 [DONE] sentinel 不被算作 parse failure
+ * (P2-D follow-up: 之前会被静默归入 sseParseFailures++, 正常流也刷 warn).
+ *
+ * 容忍: data: [DONE] / data:[DONE] / 多个 data: 行 / 前后空白 / CRLF.
+ */
+export declare function isSseDoneSentinel(eventRaw: string): boolean;
+/**
+ * 解析单个 SSE event (`data: {...}\n`).
+ * 返回 null 表示跳过该 event (heartbeat / comment / 解析失败).
+ *
+ * 注意:[DONE] sentinel 由 isSseDoneSentinel 在调用方提前拦截,
+ * 本函数不再处理,避免重复路径让 caller 误算 parse failure.
+ */
+export declare function parseSseEvent(eventRaw: string, pricing?: PricingConfig, model?: ModelId): ChatChunk | null;
+/**
+ * 从 SSE event JSON 顶层 usage 字段解析出标准化的 Usage 结构,
+ * 顺手算 Sprint 1b 的 cache_hit_rate / cost_turn / tokens_uncached.
+ *
+ * 返回 undefined 表示该 event 不带 usage (OAI 标准: 只在 stream 末尾出现).
+ *
+ * P1 fix (2026-06-03): 抽出避免在 choices=[] 和 choices=[...] 两条路径上重复解析。
+ */
+export declare function parseSseUsageField(obj: Record<string, unknown>, pricing?: PricingConfig, model?: ModelId): Usage | undefined;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAY,KAAK,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,UAAU,GAAG,IAAI,CAkFnB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc3D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,OAAO,GACd,SAAS,GAAG,IAAI,CA2FlB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,OAAO,GACd,KAAK,GAAG,SAAS,CA+BnB"}

package/dist/parse.js

@@ -0,0 +1,285 @@
+/**
+ * @deepwhale/llm — OpenAI-shape 协议解析层
+ *
+ * Sprint 1b.5 Step 2 抽出来: 之前这些 module-level fn 在 deepseek-client.ts 里,
+ * Step 2 起 AnthropicClient (走 /anthropic endpoint, DeepSeek shim 返 OpenAI-shape)
+ * 也需要复用, 抽到 parse.ts 当共享解析层.
+ *
+ * 设计原则:
+ * - 纯函数, 零副作用 (无 console / 无 I/O)
+ * - pricing/model 都是 optional, 缺时走 R7 中间路径 (base 2 字段, cost 字段 absent)
+ * - 不假设 caller 是 deepseek / anthropic, 任何返 OpenAI-shape JSON 的协议都走这层
+ *
+ * 不在这层的:
+ * - SSE 协议层 (data:/event:/id:/retry: 协议) — 留在 deepseek-client.ts:isSseDoneSentinel
+ * - HTTP / fetch / retry — caller 负责
+ * - request 编组 (ChatMessage → wire JSON) — 留 caller (toWireMessage 是 deepseek 私货)
+ */
+import { computeCost } from './pricing-config.js';
+/**
+ * 解析 OAI chat completion 完整响应 JSON 为 ChatResult.
+ * 返 null 表示响应结构无效 (缺 choices[0].message), caller 决定抛什么错.
+ *
+ * @param fallbackModel - 响应里没 model 字段时用的 fallback (避免 "unknown model" 传播)
+ * @param pricing - 可选, 用于算 cost_turn + cost_currency. undefined 走 R7 中间路径.
+ */
+export function parseOaiChatCompletion(json, fallbackModel, pricing) {
+    if (typeof json !== 'object' || json === null)
+        return null;
+    const obj = json;
+    const choices = obj['choices'];
+    if (!Array.isArray(choices) || choices.length === 0)
+        return null;
+    const first = choices[0];
+    if (typeof first !== 'object' || first === null)
+        return null;
+    const firstObj = first;
+    const message = firstObj['message'];
+    if (typeof message !== 'object' || message === null)
+        return null;
+    const msg = message;
+    // 机制 3：reasoning_content 不暴露给 caller（session 内部如果要保留,sprint 1b 再加）
+    // 这里直接忽略 reasoning_content 字段,只取 content
+    const content = typeof msg['content'] === 'string' ? msg['content'] : '';
+    // 解析 tool_calls
+    let toolCalls;
+    const rawTc = msg['tool_calls'];
+    if (Array.isArray(rawTc) && rawTc.length > 0) {
+        toolCalls = [];
+        for (const tc of rawTc) {
+            if (typeof tc !== 'object' || tc === null)
+                continue;
+            const tcObj = tc;
+            const fn = tcObj['function'];
+            if (typeof fn !== 'object' || fn === null)
+                continue;
+            const fnObj = fn;
+            const name = typeof fnObj['name'] === 'string' ? fnObj['name'] : '';
+            const argsStr = typeof fnObj['arguments'] === 'string' ? fnObj['arguments'] : '{}';
+            let args = {};
+            try {
+                const parsed = JSON.parse(argsStr);
+                if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                    args = parsed;
+                }
+            }
+            catch {
+                // args 解析失败,留空对象。caller 看到 args={} 通常意味着 LLM 输出格式错误。
+            }
+            const id = typeof tcObj['id'] === 'string' ? tcObj['id'] : '';
+            toolCalls.push({ id, name, args });
+        }
+    }
+    // usage
+    let usage;
+    const rawUsage = obj['usage'];
+    if (typeof rawUsage === 'object' && rawUsage !== null) {
+        const u = rawUsage;
+        const prompt = typeof u['prompt_tokens'] === 'number' ? u['prompt_tokens'] : 0;
+        const completion = typeof u['completion_tokens'] === 'number' ? u['completion_tokens'] : 0;
+        const total = typeof u['total_tokens'] === 'number' ? u['total_tokens'] : prompt + completion;
+        const cached = typeof u['prompt_cache_hit_tokens'] === 'number' ? u['prompt_cache_hit_tokens'] : undefined;
+        usage = { prompt_tokens: prompt, completion_tokens: completion, total_tokens: total };
+        if (cached !== undefined)
+            usage.cached_tokens = cached;
+        // Sprint 1b.5: 改用 pricing-config.computeCost, 接 PricingConfig + ModelId,
+        // 返 CostBreakdownResult (undefined / base 2 字段 / 完整 4 字段 3 种).
+        // 公式不变 (V4-Flash pricing 在 default.toml 跟旧 hardcode 一致).
+        // parseOaiChatCompletion 是 module-level, 从参数接 pricing + fallbackModel.
+        const breakdown = computeCost(pricing, fallbackModel, prompt, completion, cached);
+        if (breakdown !== undefined) {
+            usage.cache_hit_rate = breakdown.cache_hit_rate;
+            if (breakdown.cost_turn !== undefined)
+                usage.cost_turn = breakdown.cost_turn;
+            if (breakdown.cost_currency !== undefined)
+                usage.cost_currency = breakdown.cost_currency;
+            usage.tokens_uncached = breakdown.tokens_uncached;
+        }
+    }
+    // finish_reason
+    const rawFr = firstObj['finish_reason'];
+    const finishReason = rawFr === 'stop' || rawFr === 'tool_calls' || rawFr === 'length' || rawFr === 'content_filter'
+        ? rawFr
+        : undefined;
+    const modelRaw = obj['model'];
+    const model = typeof modelRaw === 'string' ? modelRaw : fallbackModel;
+    const result = { model, content };
+    if (toolCalls)
+        result.tool_calls = toolCalls;
+    if (usage)
+        result.usage = usage;
+    if (finishReason)
+        result.finish_reason = finishReason;
+    return result;
+}
+/**
+ * 判断 SSE event raw text 是否是 OAI 协议的 [DONE] 终止 marker.
+ * 在 parseSseEvent 之前调用, 确保 [DONE] sentinel 不被算作 parse failure
+ * (P2-D follow-up: 之前会被静默归入 sseParseFailures++, 正常流也刷 warn).
+ *
+ * 容忍: data: [DONE] / data:[DONE] / 多个 data: 行 / 前后空白 / CRLF.
+ */
+export function isSseDoneSentinel(eventRaw) {
+    // 扫所有 data: 行,看是否有且只有 [DONE]
+    let sawDataLine = false;
+    for (const ln of eventRaw.split('\n')) {
+        if (!ln.startsWith('data:'))
+            continue;
+        const payload = ln.slice(5).trimStart();
+        if (payload === '[DONE]') {
+            sawDataLine = true;
+        }
+        else {
+            // [DONE] event 不应混入别的 data
+            return false;
+        }
+    }
+    return sawDataLine;
+}
+/**
+ * 解析单个 SSE event (`data: {...}\n`).
+ * 返回 null 表示跳过该 event (heartbeat / comment / 解析失败).
+ *
+ * 注意:[DONE] sentinel 由 isSseDoneSentinel 在调用方提前拦截,
+ * 本函数不再处理,避免重复路径让 caller 误算 parse failure.
+ */
+export function parseSseEvent(eventRaw, pricing, model) {
+    const lines = eventRaw.split('\n');
+    const dataLines = [];
+    for (const ln of lines) {
+        if (ln.startsWith('data:')) {
+            dataLines.push(ln.slice(5).trimStart());
+        }
+        // event:/id:/retry: 忽略
+    }
+    if (dataLines.length === 0)
+        return null;
+    const data = dataLines.join('\n');
+    // [DONE] sentinel 已被 isSseDoneSentinel 提前拦截,这里不再判断。
+    let json;
+    try {
+        json = JSON.parse(data);
+    }
+    catch {
+        return null; // 解析失败静默跳过（Sprint 1a 简化,Sprint 1b 加重试日志）
+    }
+    if (typeof json !== 'object' || json === null)
+        return null;
+    const obj = json;
+    // P1 fix (2026-06-03): 之前 usage 解析只在 choices=[] 分支走, 但 OAI/DeepSeek
+    // stream 协议允许最后一个 chunk 同时带 choices (e.g. {delta:{}, finish_reason:"stop"})
+    // 和顶层 usage, 此时 usage 会被丢弃 → 状态栏拿不到 cache/cost 数据。
+    // 改成先解析顶层 usage, 任何 chunk 类型都挂上。
+    // usage-only chunk (choices=[]) 路径保留作为 fallback, 服务端历史兼容。
+    // Sprint 1b.5: 把 pricing + model 透传给 parseSseUsageField.
+    const topLevelUsage = parseSseUsageField(obj, pricing, model);
+    const choices = obj['choices'];
+    if (!Array.isArray(choices) || choices.length === 0) {
+        if (topLevelUsage !== undefined) {
+            return { delta: {}, usage: topLevelUsage };
+        }
+        return null;
+    }
+    const first = choices[0];
+    if (typeof first !== 'object' || first === null)
+        return null;
+    const firstObj = first;
+    const rawDelta = firstObj['delta'];
+    if (typeof rawDelta !== 'object' || rawDelta === null)
+        return null;
+    const deltaObj = rawDelta;
+    // 机制 3：reasoning_content 不暴露
+    const content = typeof deltaObj['content'] === 'string' ? deltaObj['content'] : undefined;
+    // tool_calls 增量(DeepSeek V4 stream 一次性给完整,这里当 full 处理)
+    let toolCalls;
+    const rawTc = deltaObj['tool_calls'];
+    if (Array.isArray(rawTc) && rawTc.length > 0) {
+        toolCalls = [];
+        for (const tc of rawTc) {
+            if (typeof tc !== 'object' || tc === null)
+                continue;
+            const tcObj = tc;
+            const fn = tcObj['function'];
+            if (typeof fn !== 'object' || fn === null)
+                continue;
+            const fnObj = fn;
+            const name = typeof fnObj['name'] === 'string' ? fnObj['name'] : '';
+            const argsStr = typeof fnObj['arguments'] === 'string' ? fnObj['arguments'] : '{}';
+            let args = {};
+            try {
+                const parsed = JSON.parse(argsStr);
+                if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                    args = parsed;
+                }
+            }
+            catch {
+                /* leave {} */
+            }
+            const id = typeof tcObj['id'] === 'string' ? tcObj['id'] : '';
+            const idx = typeof tcObj['index'] === 'number' ? tcObj['index'] : 0;
+            // Sprint 1a 简化：按 index 收集,最终输出合并
+            toolCalls.push({ id: id || `${idx}`, name, args });
+        }
+    }
+    // finish_reason
+    const rawFr = firstObj['finish_reason'];
+    const finishReason = rawFr === 'stop' || rawFr === 'tool_calls' || rawFr === 'length' || rawFr === 'content_filter'
+        ? rawFr
+        : undefined;
+    const delta = {};
+    if (content !== undefined)
+        delta.content = content;
+    if (toolCalls !== undefined)
+        delta.tool_calls = toolCalls;
+    const chunk = { delta };
+    if (finishReason)
+        chunk.finish_reason = finishReason;
+    // P1 fix (2026-06-03): 顶层 usage 在 choices 路径同样挂上,
+    // 让 final chunk (带 finish_reason="stop" + 顶层 usage) 能把 usage 透出。
+    if (topLevelUsage !== undefined)
+        chunk.usage = topLevelUsage;
+    return chunk;
+}
+/**
+ * 从 SSE event JSON 顶层 usage 字段解析出标准化的 Usage 结构,
+ * 顺手算 Sprint 1b 的 cache_hit_rate / cost_turn / tokens_uncached.
+ *
+ * 返回 undefined 表示该 event 不带 usage (OAI 标准: 只在 stream 末尾出现).
+ *
+ * P1 fix (2026-06-03): 抽出避免在 choices=[] 和 choices=[...] 两条路径上重复解析。
+ */
+export function parseSseUsageField(obj, pricing, model) {
+    const rawUsage = obj['usage'];
+    if (typeof rawUsage !== 'object' || rawUsage === null)
+        return undefined;
+    const u = rawUsage;
+    const prompt = typeof u['prompt_tokens'] === 'number' ? u['prompt_tokens'] : 0;
+    const completion = typeof u['completion_tokens'] === 'number' ? u['completion_tokens'] : 0;
+    const total = typeof u['total_tokens'] === 'number' ? u['total_tokens'] : prompt + completion;
+    const cached = typeof u['prompt_cache_hit_tokens'] === 'number'
+        ? u['prompt_cache_hit_tokens']
+        : undefined;
+    const usage = {
+        prompt_tokens: prompt,
+        completion_tokens: completion,
+        total_tokens: total,
+    };
+    if (cached !== undefined)
+        usage.cached_tokens = cached;
+    // Sprint 1b.5: 改用 pricing-config.computeCost, 公式不变 (default.toml V4-Flash).
+    // parseSseUsageField 是 module-level fn, 不持有 this.pricing. pricing/model 可选
+    // — undefined 时走 R7 中间路径 (base 2 字段, cost 字段 absent, 不静默 fallback).
+    // model undefined 时也安全: computeCost 内部 pricing.models[model] 返 undefined
+    // → 走 base 2 字段分支, cost 字段 absent. 不需要 throw.
+    const breakdown = computeCost(pricing, model, prompt, completion, cached);
+    if (breakdown !== undefined) {
+        usage.cache_hit_rate = breakdown.cache_hit_rate;
+        if (breakdown.cost_turn !== undefined)
+            usage.cost_turn = breakdown.cost_turn;
+        if (breakdown.cost_currency !== undefined)
+            usage.cost_currency = breakdown.cost_currency;
+        usage.tokens_uncached = breakdown.tokens_uncached;
+    }
+    return usage;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}

package/dist/pricing-config.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @deepwhale/llm — Pricing 配置 (Sprint 1b.5 Step 1)
+ *
+ * 把原本 hardcode 在 `types.ts:computeCostBreakdown` 的 V4-Flash pricing 抽到
+ * ship-in + 用户可覆盖的 TOML 配置。Per-model currency (DeepSeek CNY, Anthropic USD),
+ * 不在 UI 层做汇率换算 — UI 从 `cost_currency` 字段读 symbol (¥ / $)。
+ *
+ * ## 设计原则 (R7 / Step 0 拍板, 2026-06-03)
+ *
+ * 1. `loadPricingConfig(userPath)`:
+ *    - 显式传 `userPath` 但文件不存在或非法 → **抛 PricingConfigParseError** (不静默)
+ *    - 不传 → 加载 ship-in `pricing.default.toml`
+ *
+ * 2. `computeCost(pricing, model, ...)` 是**纯函数**: 无 console / 无 logger / 无 IO。
+ *    3 种返回路径 (`CostBreakdownResult` 联合类型):
+ *    - 整体 `undefined`: 没 `cached_tokens` → 4 字段全 absent
+ *    - `{ base, no cost }`: 有 cache 但 pricing 找不到 model → 有 cache_hit_rate / tokens_uncached, 缺 cost
+ *    - 完整 4 字段: 找到
+ *
+ * 3. Warning 责任在 caller (client/mode 边界), 纯函数零副作用。
+ *
+ * 4. UI/RPC: `cost_turn` absent 时字段不显示 (absent 不是 null), 读 `cost_currency` 决 symbol。
+ */
+import type { ModelId } from './types.js';
+/**
+ * 单个模型的定价。Currency 跟价格数字绑定, UI 层不做汇率换算。
+ */
+export interface ModelPricing {
+    /** 缓存未命中 input 价格, /M tokens. */
+    cache_miss_per_m: number;
+    /** 缓存命中 input 价格, /M tokens. */
+    cache_hit_per_m: number;
+    /** 输出价格, /M tokens. */
+    completion_per_m: number;
+    /** Currency 跟价格数字绑定, 不在 UI 层做汇率换算. */
+    currency: 'CNY' | 'USD';
+}
+/**
+ * 完整的 pricing 配置 (TOML 解析后).
+ *
+ * `models` 必须非空. 找不到 model 时**不静默 fallback** (见 R7).
+ */
+export interface PricingConfig {
+    models: Record<string, ModelPricing>;
+}
+/**
+ * `computeCost` 的 3 种返回结果 (联合类型).
+ *
+ * - `undefined`: 没 `cached_tokens` (Provider 也不支持 cache) → 4 字段全 absent
+ * - `{ base, no cost }`: 有 cache 但 pricing 找不到 model 或 pricing 本身 undefined
+ *   → 有 cache_hit_rate + tokens_uncached, 缺 cost_turn + cost_currency
+ * - 完整 4 字段: 找到 model → cost_turn 和 cost_currency 同步存在 (不变量)
+ */
+export type CostBreakdownResult = undefined | {
+    cache_hit_rate: number;
+    tokens_uncached: number;
+    /** cost_turn 存在时 cost_currency 必须也存在 (类型不变量). */
+    cost_turn?: number;
+    cost_currency?: 'CNY' | 'USD';
+};
+/**
+ * pricing TOML 解析/加载错误. `userPath` 显式传但文件不存在/非法时抛.
+ */
+export declare class PricingConfigParseError extends Error {
+    readonly userPath: string;
+    readonly name: "PricingConfigParseError";
+    constructor(message: string, userPath: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * 解析 TOML string → PricingConfig. 纯函数, 无 IO.
+ *
+ * 校验:
+ * - 必须有 `[models.xxx]` 块 (至少 1 个)
+ * - 每个 model 4 字段全必填 (cache_miss_per_m / cache_hit_per_m / completion_per_m / currency)
+ * - currency 必须在 'CNY' | 'USD' enum
+ * - 价格数字必须非负有限
+ *
+ * @throws PricingConfigParseError — malformed / 缺字段 / currency 错 / 数字非有限
+ */
+export declare function parsePricingConfig(toml: string): PricingConfig;
+/**
+ * 纯函数, 无 console / 无 logger / 无 IO. 3 种返回路径见 `CostBreakdownResult`.
+ *
+ * 公式: tokens_uncached = max(0, prompt - cached)
+ *       cache_hit_rate  = cached / prompt  (prompt=0 时 0, 避免除零)
+ *       cost_turn       = tokens_uncached * cache_miss_per_m/1e6
+ *                        + cached * cache_hit_per_m/1e6
+ *                        + completion * completion_per_m/1e6
+ *
+ * 把 /M 转 /token 必须除 1e6, 不要直接当 /token 用 (会大 1000×).
+ */
+export declare function computeCost(pricing: PricingConfig | undefined, model: ModelId | undefined, promptTokens: number, completionTokens: number, cachedTokens: number | undefined): CostBreakdownResult;
+/**
+ * 加载 pricing config. 三种来源优先级 (高→低):
+ * 1. `userPath` 显式指定且存在 → 解析用户文件
+ * 2. `userPath` 显式指定但不存在或非法 → **抛 PricingConfigParseError** (不静默 fallback)
+ * 3. `userPath` 未传 → 加载 ship-in `pricing.default.toml`
+ *
+ * hot path 不应调 (走 client.pricing 字段). Step 2 的 AnthropicClient 启动时调一次.
+ */
+export declare function loadPricingConfig(userPath?: string): Promise<PricingConfig>;
+//# sourceMappingURL=pricing-config.d.ts.map

package/dist/pricing-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-config.d.ts","sourceRoot":"","sources":["../src/pricing-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT;IACE,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC/B,CAAC;AAEN;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAI9C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAH3B,SAAkB,IAAI,EAAG,yBAAyB,CAAU;gBAE1D,OAAO,EAAE,MAAM,EACN,QAAQ,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAOhC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAmE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,mBAAmB,CA6BrB;AAID;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CASjF"}