@lingxiao-office/sdk 1.0.0

package/dist/llm/token_counter.js

@@ -0,0 +1,184 @@
+import { contentToPlainText, thinkingBlocksToText } from './types.js';
+import { getCachedEncoder } from '../core/TiktokenCache.js';
+import { llmLogger } from '../core/Log.js';
+/** once-flag: 避免 tiktoken 不可用时每次调用都打印 warn */
+let _warnedTiktokenUnavailable = false;
+/**
+ * Token 计数器 - 完整复刻 Python 版本
+ *
+ * 提供粗略和精确的 token 计数功能
+ */
+/**
+ * 粗略估计 token 数量
+ * 中文约 1.5 字符/token，英文约 4 字符/token
+ */
+export function countTokens(text) {
+    if (!text)
+        return 0;
+    const encoder = getCachedEncoder('cl100k_base');
+    if (encoder) {
+        try {
+            return encoder.encode(text).length;
+        }
+        catch (err) {
+            // tiktoken 编码失败时降级为启发式，仅首次打印 warn
+            if (!_warnedTiktokenUnavailable) {
+                _warnedTiktokenUnavailable = true;
+                llmLogger.warn('[token_counter] tiktoken encode failed, falling back to heuristic:', err);
+            }
+        }
+    }
+    else {
+        // encoder 未能加载（tiktoken wasm 初始化失败），仅首次打印 warn
+        if (!_warnedTiktokenUnavailable) {
+            _warnedTiktokenUnavailable = true;
+            llmLogger.warn('[token_counter] tiktoken encoder unavailable, using heuristic estimate');
+        }
+    }
+    // 分类统计 CJK 字符（中文、日文假名、韩文）和其他字符
+    let cjkChars = 0;
+    for (const c of text) {
+        const code = c.codePointAt(0);
+        // CJK 统一汉字
+        if (code >= 0x4e00 && code <= 0x9fff)
+            cjkChars++;
+        // 日文平假名 + 片假名
+        else if (code >= 0x3040 && code <= 0x30ff)
+            cjkChars++;
+        // 韩文音节
+        else if (code >= 0xac00 && code <= 0xd7af)
+            cjkChars++;
+    }
+    const otherChars = text.length - cjkChars;
+    // CJK ~1.5 chars/token, 其他 ~4 chars/token
+    return Math.floor(cjkChars / 1.5 + otherChars / 4);
+}
+/** 每个 tool_call 的结构开销（JSON 包裹 id/type/function 字段等），约 4 token */
+const TOOL_CALL_STRUCTURE_OVERHEAD = 4;
+export function countMessagesTokens(messages) {
+    let total = 0;
+    for (const msg of messages) {
+        // 计算内容 token
+        if (msg.content) {
+            total += countTokens(contentToPlainText(msg.content));
+        }
+        // 工具调用也计入：函数名、调用 id、参数体，以及每个 tool_call 的结构开销。
+        // 仅计 arguments 会系统性低估 → 压缩触发偏晚。
+        if (msg.tool_calls) {
+            for (const tc of msg.tool_calls) {
+                if (tc.function?.name) {
+                    total += countTokens(tc.function.name);
+                }
+                if (tc.id) {
+                    total += countTokens(tc.id);
+                }
+                if (tc.function?.arguments) {
+                    total += countTokens(tc.function.arguments);
+                }
+                // 每个 tool_call 的 JSON 结构包裹开销（type/function 等字段）
+                total += TOOL_CALL_STRUCTURE_OVERHEAD;
+            }
+        }
+        // tool-result 消息的 tool_call_id（回传给 provider 时计入请求体）
+        if (msg.tool_call_id) {
+            total += countTokens(msg.tool_call_id);
+        }
+        // 消息 name 字段（function/tool 名等）
+        if (msg.name) {
+            total += countTokens(msg.name);
+        }
+        // thinking blocks 计入
+        if (msg.thinking && msg.thinking.length > 0) {
+            total += countTokens(thinkingBlocksToText(msg.thinking));
+        }
+        // 角色开销（每条消息约 4 tokens）
+        total += 4;
+    }
+    return total;
+}
+/**
+ * 计算消息的 token 数量（单个消息）
+ */
+export function countMessageTokens(message) {
+    return countMessagesTokens([message]);
+}
+/**
+ * Token 计数器类 - 提供更精确的计数
+ */
+export class TokenCounter {
+    totalPrompt = 0;
+    totalCompletion = 0;
+    /**
+     * 记录 token 使用
+     */
+    addUsage(promptTokens, completionTokens) {
+        this.totalPrompt += promptTokens;
+        this.totalCompletion += completionTokens;
+    }
+    /**
+     * 获取总 prompt token
+     */
+    getTotalPrompt() {
+        return this.totalPrompt;
+    }
+    /**
+     * 获取总 completion token
+     */
+    getTotalCompletion() {
+        return this.totalCompletion;
+    }
+    /**
+     * 获取总 token
+     */
+    getTotal() {
+        return this.totalPrompt + this.totalCompletion;
+    }
+    /**
+     * 重置计数器
+     */
+    reset() {
+        this.totalPrompt = 0;
+        this.totalCompletion = 0;
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        return {
+            prompt: this.totalPrompt,
+            completion: this.totalCompletion,
+            total: this.getTotal(),
+        };
+    }
+}
+// 全局 Token 计数器实例
+let globalCounter = null;
+/**
+ * 获取全局 Token 计数器
+ */
+export function getTokenCounter() {
+    if (!globalCounter) {
+        globalCounter = new TokenCounter();
+    }
+    return globalCounter;
+}
+/**
+ * 快速估算文本 token 数
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    if (typeof text === 'string') {
+        return countTokens(text);
+    }
+    return countTokens(JSON.stringify(text));
+}
+export default {
+    countTokens,
+    countMessagesTokens,
+    countMessageTokens,
+    TokenCounter,
+    getTokenCounter,
+    estimateTokens,
+};
+//# sourceMappingURL=token_counter.js.map

package/dist/llm/token_counter.js.map

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

package/dist/llm/types.d.ts

@@ -0,0 +1,192 @@
+/**
+ * LLM 客户端类型定义
+ */
+import { contentToPlainText, extractAgentMention, hasImageContent, isContentPartArray, isEmptyContent, normalizeMessageContent, thinkingBlocksToText } from '../contracts/types/Message.js';
+import type { BaseMessage, LlmThinkingBlock } from '../contracts/types/Message.js';
+import type { MessageContent, TextContentPart, TokenUsage as CanonicalTokenUsage, ModelCapabilitySpec } from '../types/canonical.js';
+import type { ToolDefinition } from '../contracts/types/Tool.js';
+/**
+ * 模型支持的输入模态
+ * 省略或 false 表示该模型不支持对应输入类型
+ */
+export type InputModalities = {
+    image?: boolean;
+    pdf?: boolean;
+    audio?: boolean;
+    video?: boolean;
+};
+export type { TextContentPart };
+export type { ImageBlobRefContentPart, ImageUrlContentPart, McpAppContentPart, MessageContent, MessageContentPart, } from '../types/canonical.js';
+export { contentToPlainText, extractAgentMention, hasImageContent, isContentPartArray, isEmptyContent, normalizeMessageContent, };
+/**
+ * 结构化 thinking / reasoning block
+ *
+ * 替代旧的 `reasoning_content: string`，能够保留 Anthropic thinking block
+ * 必需的 `signature` 字段以及 `redacted_thinking` 形态。
+ *
+ * - `thinking`：明文推理；`signature` 来自 Anthropic（重要！服务端校验需要原样回传）
+ * - `redacted_thinking`：服务端加密的推理（不可读），仅承载 `data` 用于回传
+ */
+export type ThinkingBlock = LlmThinkingBlock;
+/**
+ * 工具方法：将 ThinkingBlock 数组拼成纯文本（用于 UI 展示 / token 计数 / 日志）
+ */
+export { thinkingBlocksToText };
+/**
+ * 结构化消息种类（discriminated by metadata.kind）。
+ *
+ * 用于上下文压缩器等下游按结构化字段判定消息用途，而非字符串内容嗅探
+ * （禁止启发式：不用 text.includes/startsWith 关键词判结构）。
+ *
+ * - context_summary：压缩器注入的「上下文压缩摘要」消息
+ * - context_file_snapshot：压缩器注入的「上下文文件快照」消息
+ * - task_board_snapshot：TaskBoard 快照注入消息
+ * - agent_report：Agent 进展汇报注入消息
+ */
+export type ChatMessageKind = 'context_summary' | 'context_file_snapshot' | 'task_board_snapshot' | 'agent_report';
+/**
+ * ChatMessage 结构化元数据。kind 为判别字段，下游按 kind 走确定性分支。
+ */
+export interface ChatMessageMetadata {
+    kind?: ChatMessageKind;
+    [key: string]: unknown;
+}
+export interface ChatMessage extends Pick<BaseMessage, 'role'> {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: MessageContent;
+    name?: string;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    /**
+     * 结构化 thinking blocks（替代 reasoning_content）。
+     * 仅 assistant 消息会携带；多轮调用时必须原样回传给上游 thinking-mode API。
+     */
+    thinking?: ThinkingBlock[];
+    timestamp?: number;
+    /**
+     * 结构化元数据：判别字段 kind 标识消息用途（压缩摘要 / 文件快照 / 任务看板快照 / Agent 汇报）。
+     * 下游（如上下文压缩器）按 kind 字段判定结构，禁止用文本内容前缀嗅探（违反禁止启发式）。
+     */
+    metadata?: ChatMessageMetadata;
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export type { ToolDefinition };
+export type TokenUsage = CanonicalTokenUsage;
+/**
+ * 流式工具调用入参增量。
+ * Anthropic 的 input_json_delta / OpenAI 的 delta.tool_calls[].function.arguments 都会触发。
+ * 用于让前端在 LLM 还没结束这一轮工具调用前就先看到"参数生成中"，避免长 JSON 期间 UI 静默。
+ */
+export interface ToolCallDeltaInfo {
+    /** provider 内部的 tool_call index（同一轮可能有多个并行工具调用） */
+    index: number;
+    /** tool_call id（首次出现时携带，后续 chunk 可省略） */
+    id?: string;
+    /** 工具名（首次出现时携带，后续 chunk 可省略） */
+    name?: string;
+    /** 这一帧到达的 JSON 片段（可能为空，仅作 start marker） */
+    partialJson: string;
+}
+export type LlmRoundEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'thinking';
+    thinking: string;
+} | {
+    type: 'tool_call';
+    toolCall: ToolCall;
+} | {
+    type: 'tool_call_delta';
+    delta: ToolCallDeltaInfo;
+} | {
+    type: 'usage';
+    usage: TokenUsage;
+} | {
+    type: 'progress';
+    progress: {
+        elapsed: number;
+        status: string;
+    };
+} | {
+    type: 'retry';
+    attempt: number;
+    error: Error;
+} | {
+    type: 'stream_retry';
+    attempt: number;
+    error: Error;
+} | {
+    type: 'first_token';
+} | {
+    type: 'error';
+    error: Error;
+};
+export interface ChatResponse {
+    content: MessageContent;
+    thinking?: ThinkingBlock[];
+    tool_calls?: ToolCall[];
+    usage?: TokenUsage;
+    model?: string;
+    finish_reason?: string;
+    was_output_truncated?: boolean;
+    gateway?: {
+        traceId: string;
+        profile: string;
+        selectedModel: string;
+        finalModel?: string;
+        fallbackModels: string[];
+        attempts: Array<{
+            model: string;
+            status: 'started' | 'success' | 'failed' | 'skipped';
+            errorKind?: string;
+            errorMessage?: string;
+            retryable?: boolean;
+            elapsedMs?: number;
+        }>;
+    };
+}
+export interface StreamCallbacks {
+    onText?: (text: string) => void;
+    onThinking?: (thinking: string) => void;
+    onToolCall?: (toolCall: ToolCall) => void;
+    /**
+     * 流式工具入参增量回调。
+     * 在 LLM 仍在生成 tool 参数 JSON 时按 chunk 触发，让上层把"参数生成中"事件
+     * 推到前端，避免长 JSON 期间 UI 完全静默。
+     * 触发时机：Anthropic input_json_delta / OpenAI delta.tool_calls[].arguments。
+     * 触发时 onToolCall 还未触发（onToolCall 仅在该 tool_call 流式完成时一次性触发）。
+     */
+    onToolCallDelta?: (delta: ToolCallDeltaInfo) => void;
+    onUsage?: (usage: TokenUsage) => void;
+    onError?: (error: Error) => void;
+    onRetry?: (attempt: number, error: Error) => void;
+    /** 进度心跳回调，每 3s 触发一次，携带已耗时和状态文本 */
+    onProgress?: (progress: {
+        elapsed: number;
+        status: string;
+    }) => void;
+    /**
+     * audit-2026-05-15：流式重试前通知上层丢弃已渲染的部分输出。
+     * 参考 qwen-code StreamEventType.RETRY + turn.ts:286-296。
+     * 上层收到此回调后应 rollback 半截 assistant turn（清空 pendingText/toolCalls）。
+     */
+    onStreamRetry?: (attempt: number, error: Error) => void;
+    /**
+     * 首个有效 token 到达回调。
+     * 用于精确切换 model_requesting → streaming 阶段（对齐 CodeBuddy TTFT 感知）。
+     * 仅在流式期间第一个 text/thinking/tool_call_delta 到达时触发一次。
+     */
+    onFirstToken?: () => void;
+}
+import type { ContentGenerator } from './ContentGenerator.js';
+export type LLMClient = ContentGenerator;
+export type ModelCapability = ModelCapabilitySpec;
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

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

package/dist/llm/types.js

@@ -0,0 +1,10 @@
+/**
+ * LLM 客户端类型定义
+ */
+import { contentToPlainText, extractAgentMention, hasImageContent, isContentPartArray, isEmptyContent, normalizeMessageContent, thinkingBlocksToText, } from '../contracts/types/Message.js';
+export { contentToPlainText, extractAgentMention, hasImageContent, isContentPartArray, isEmptyContent, normalizeMessageContent, };
+/**
+ * 工具方法：将 ThinkingBlock 数组拼成纯文本（用于 UI 展示 / token 计数 / 日志）
+ */
+export { thinkingBlocksToText };
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAmCvC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,CAAC;AAaF;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/llm/usageExtractor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * extractTokenUsage — 统一从 LLM 原始 usage 对象中提取 TokenUsage。
+ *
+ * 历史上每个 provider 各有一份字段映射：
+ *   - Anthropic: input_tokens / output_tokens / cache_creation_input_tokens / cache_read_input_tokens
+ *   - OpenAI:    prompt_tokens / completion_tokens / prompt_tokens_details.cached_tokens
+ *   - Claude Code (CLI 流转 Anthropic schema): 同 Anthropic
+ *   - Codex (Agents API): input_tokens / output_tokens / cached_input_tokens
+ *   - OpenAI-compatible gateways: prompt_cache_hit_tokens / prompt_cache_write_tokens /
+ *     completion_tokens_details.reasoning_tokens / completion_thinking_tokens / credit
+ *
+ * 这里收口成一个工具函数，所有 provider 走同一份字段探测。
+ */
+import type { TokenUsage } from './types.js';
+export type UsageProvider = 'anthropic' | 'openai' | 'claude_code' | 'codex';
+/**
+ * 把 provider 原始 usage 抽成统一 TokenUsage。
+ *
+ * @param raw provider SDK 直接给出的 usage 对象（可能是流式累计值）
+ * @param delta 流式 message_delta 时的增量 usage（仅 Anthropic 用，其他 provider 传 undefined）
+ * @returns TokenUsage 或 undefined（raw 不可识别 / 不含 prompt 字段）
+ */
+export declare function extractTokenUsage(raw: unknown, delta?: Record<string, unknown> | undefined): TokenUsage | undefined;
+/**
+ * Driver 使用的简化 usage 三元组（含 cache）。供 ClaudeCodeDriver / CodexDriver 用。
+ */
+export interface DriverUsage {
+    prompt: number;
+    completion: number;
+    total: number;
+    cacheRead: number;
+    cacheCreation: number;
+    reasoning?: number;
+}
+export declare function extractDriverUsage(raw: unknown): DriverUsage | undefined;
+//# sourceMappingURL=usageExtractor.d.ts.map

package/dist/llm/usageExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageExtractor.d.ts","sourceRoot":"","sources":["../../src/llm/usageExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,CAAC;AAsI7E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,UAAU,GAAG,SAAS,CAiCxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAYxE"}

package/dist/llm/usageExtractor.js

@@ -0,0 +1,156 @@
+/**
+ * extractTokenUsage — 统一从 LLM 原始 usage 对象中提取 TokenUsage。
+ *
+ * 历史上每个 provider 各有一份字段映射：
+ *   - Anthropic: input_tokens / output_tokens / cache_creation_input_tokens / cache_read_input_tokens
+ *   - OpenAI:    prompt_tokens / completion_tokens / prompt_tokens_details.cached_tokens
+ *   - Claude Code (CLI 流转 Anthropic schema): 同 Anthropic
+ *   - Codex (Agents API): input_tokens / output_tokens / cached_input_tokens
+ *   - OpenAI-compatible gateways: prompt_cache_hit_tokens / prompt_cache_write_tokens /
+ *     completion_tokens_details.reasoning_tokens / completion_thinking_tokens / credit
+ *
+ * 这里收口成一个工具函数，所有 provider 走同一份字段探测。
+ */
+function asNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string') {
+        const n = Number(value);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function firstNumber(...values) {
+    for (const value of values) {
+        const n = asNumber(value);
+        if (n !== undefined)
+            return n;
+    }
+    return undefined;
+}
+/**
+ * 从原始 usage 对象中提取归一化字段。
+ *
+ * 统一口径（关键）：promptTokens 一律为「毛输入」——包含 cache_read 与
+ * cache_creation；totalTokens = promptTokens + completionTokens。这样
+ * 无论哪个 provider，prompt / total 都自洽且都包含缓存，下游 /stats、
+ * TUI header、CostService 拿到的都是真实消耗。
+ *
+ * 各 provider 的输入语义差异：
+ *   - Anthropic / Claude Code：input_tokens 是「净输入」，不含 cache_read /
+ *     cache_creation；真实总输入 = input_tokens + cache_read + cache_creation。
+ *   - OpenAI chat：prompt_tokens 已是毛输入，prompt_tokens_details.cached_tokens
+ *     只是其子集。
+ *   - OpenAI responses / Codex：input_tokens 已是毛输入，cached_input_tokens /
+ *     input_tokens_details.cached_tokens 是其子集。
+ */
+function normalize(raw) {
+    const promptDetails = asRecord(raw['prompt_tokens_details']);
+    const inputDetails = asRecord(raw['input_tokens_details']);
+    const completionDetails = asRecord(raw['completion_tokens_details']);
+    // cache_read / prompt-cache-hit 别名（覆盖各 provider schema）。不要累加多个别名，
+    // 它们通常表示同一批缓存命中 tokens。
+    const cacheRead = firstNumber(raw.cache_read_input_tokens, raw['prompt_cache_hit_tokens'], raw['cached_input_tokens'], promptDetails?.cached_tokens, inputDetails?.cached_tokens, raw['cached_tokens'], raw['cacheRead']) ?? 0;
+    // cache_creation / prompt-cache-write 别名。prompt_cache_miss_tokens 不是 write，
+    // 只在缺少 prompt/input 时参与 prompt 兜底推导，避免双算。
+    const cacheCreation = firstNumber(raw.cache_creation_input_tokens, raw['prompt_cache_write_tokens'], raw['cacheCreation']) ?? 0;
+    const reasoningTokens = firstNumber(completionDetails?.reasoning_tokens, raw['reasoning_tokens'], raw['completion_thinking_tokens'], raw['thinking_tokens']) ?? 0;
+    // 判定输入计数是否为「净输入」（需补回 cache 才是毛输入）。
+    // cache_read_input_tokens / cache_creation_input_tokens 是 Anthropic schema
+    // 独有字段名，据此识别 Anthropic / Claude Code 的净输入语义。
+    // 同时排除「已归一化结果再次进入」——归一化结果带 prompt_tokens（毛输入），
+    // 若再次叠加 cache 会双计。
+    const hasAnthropicCacheFields = 'cache_read_input_tokens' in raw || 'cache_creation_input_tokens' in raw;
+    const alreadyGrossPrompt = asNumber(raw.prompt_tokens) !== undefined;
+    const isNetInput = hasAnthropicCacheFields && !alreadyGrossPrompt;
+    const rawPrompt = firstNumber(raw.prompt_tokens, raw.input_tokens, raw['inputTokens']);
+    const cacheMiss = firstNumber(raw['prompt_cache_miss_tokens']) ?? 0;
+    const fallbackPrompt = cacheRead > 0 || cacheMiss > 0
+        ? cacheRead + cacheMiss
+        : cacheCreation > 0
+            ? cacheCreation
+            : undefined;
+    if (rawPrompt === undefined && fallbackPrompt === undefined)
+        return undefined;
+    const promptTokens = rawPrompt === undefined
+        ? fallbackPrompt
+        : isNetInput
+            ? rawPrompt + cacheRead + cacheCreation
+            : rawPrompt;
+    const completionTokens = firstNumber(raw.completion_tokens, raw.output_tokens, raw['outputTokens']) ?? 0;
+    // total 一律重算为毛 prompt + completion；reasoningTokens 是 completion 的子集。
+    const totalTokens = promptTokens + completionTokens;
+    return {
+        promptTokens,
+        completionTokens,
+        totalTokens,
+        cacheReadInputTokens: cacheRead,
+        cacheCreationInputTokens: cacheCreation,
+        reasoningTokens,
+        credit: asNumber(raw['credit']),
+    };
+}
+/**
+ * 把 provider 原始 usage 抽成统一 TokenUsage。
+ *
+ * @param raw provider SDK 直接给出的 usage 对象（可能是流式累计值）
+ * @param delta 流式 message_delta 时的增量 usage（仅 Anthropic 用，其他 provider 传 undefined）
+ * @returns TokenUsage 或 undefined（raw 不可识别 / 不含 prompt 字段）
+ */
+export function extractTokenUsage(raw, delta) {
+    if ((!raw || typeof raw !== 'object') && !delta)
+        return undefined;
+    const base = (raw && typeof raw === 'object' ? raw : {});
+    const normalized = normalize(base);
+    if (!normalized)
+        return undefined;
+    // Anthropic 流式：completion 来自 message_delta.usage.output_tokens
+    let completion = normalized.completionTokens;
+    if (delta) {
+        const deltaCompletion = firstNumber(delta.output_tokens, delta.completion_tokens);
+        if (deltaCompletion !== undefined)
+            completion = deltaCompletion;
+    }
+    // total 统一为「毛输入 + 输出」，与 normalize 口径一致。
+    // 流式 delta 仅用于刷新 completion，prompt 端不变。
+    const result = {
+        prompt_tokens: normalized.promptTokens,
+        completion_tokens: completion,
+        total_tokens: normalized.promptTokens + completion,
+    };
+    if (normalized.cacheCreationInputTokens > 0) {
+        result.cache_creation_input_tokens = normalized.cacheCreationInputTokens;
+    }
+    if (normalized.cacheReadInputTokens > 0) {
+        result.cache_read_input_tokens = normalized.cacheReadInputTokens;
+    }
+    if (normalized.reasoningTokens > 0) {
+        result.reasoning_tokens = normalized.reasoningTokens;
+    }
+    if (normalized.credit !== undefined) {
+        result.credit = normalized.credit;
+    }
+    return result;
+}
+export function extractDriverUsage(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const normalized = normalize(raw);
+    if (!normalized)
+        return undefined;
+    return {
+        prompt: normalized.promptTokens,
+        completion: normalized.completionTokens,
+        total: normalized.totalTokens,
+        cacheRead: normalized.cacheReadInputTokens,
+        cacheCreation: normalized.cacheCreationInputTokens,
+        reasoning: normalized.reasoningTokens,
+    };
+}
+//# sourceMappingURL=usageExtractor.js.map

package/dist/llm/usageExtractor.js.map

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

package/dist/mcp-servers/browser-server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * lingxiao-browser — MCP Server (Node.js stdio)
+ *
+ * Native MCP Server exposing LingXiao browser automation capabilities.
+ * Tools: browser_action, visual_verify, screenshot, navigate, click, fill,
+ *        get_text, scroll, press_key
+ *
+ * Uses BrowserManager.ensureBrowser() to get a Playwright Page instance,
+ * then calls Playwright Page API directly for DOM interactions.
+ */
+export {};
+//# sourceMappingURL=browser-server.d.ts.map

package/dist/mcp-servers/browser-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-server.d.ts","sourceRoot":"","sources":["../../src/mcp-servers/browser-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}