@lingxiao-office/sdk 1.0.0

package/dist/llm/CostService.d.ts

@@ -0,0 +1,121 @@
+/**
+ * CostService — 模型定价与费用计算
+ *
+ * 基于 token usage 计算费用，支持 cache-aware 计价：
+ * - cache_read 通常比普通 input 便宜 90%（Anthropic）或免费（OpenAI）
+ * - cache_creation 通常比普通 input 贵 25%（Anthropic）
+ * - 净输入 = input - cache_read - cache_creation（避免重复计费）
+ *
+ * 价格来源（按优先级）：
+ *   1. runtimeConfig.llm.model_providers / ModelManager 精确配置
+ *   2. ModelsDevRegistry 精确模型数据
+ *   3. 未命中时明确标记 pricingMissing，不再套用估算默认价
+ */
+export interface ModelPricing {
+    /** 每百万 input token 价格（美元） */
+    inputPerMToken: number;
+    /** 每百万 output token 价格（美元） */
+    outputPerMToken: number;
+    /** 每百万 cache read token 价格（美元） */
+    cacheReadPerMToken: number;
+    /** 每百万 cache creation token 价格（美元） */
+    cacheCreationPerMToken: number;
+}
+export type ModelPricingResolution = ModelPricing & {
+    estimated: false;
+    /**
+     * cache 子价（cacheReadPerMToken / cacheCreationPerMToken）缺失，被静默回退为
+     * inputPerMToken 计价。会让 cache_read 段费用看起来 ≈ input 段，丢失真实节省幅度。
+     * UI 应当把这种"部分定价"显式标记为 estimated / partial,避免伪精确。
+     * 仅在 resolvePricing() 解析路径上设置,coerceModelPricing 内部旧实现保持行为不变以
+     * 不破坏其他调用方。
+     */
+    pricingPartial?: boolean;
+};
+export interface CostBreakdown {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    /** 净输入（扣除 cache 部分） */
+    netInputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    cacheReadCost: number;
+    cacheCreationCost: number;
+    totalCost: number;
+    /** 完整定价缺失（无 input/output 价格）— 费用全为 0 */
+    pricingMissing?: boolean;
+    /**
+     * 仅 cache 子价（read/creation）被回退为 inputPerMToken。input/output 价格精确,
+     * 但 cache 段费用是兜底估算 — 应在 UI 标记为"partial estimated"。
+     */
+    pricingPartial?: boolean;
+}
+export interface SessionCostSummary {
+    models: CostBreakdown[];
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheReadTokens: number;
+    totalCacheCreationTokens: number;
+    totalCost: number;
+    cacheHitRate: number;
+    cacheSavings: number;
+    /** 任一模型 cache 子价被回退为 input 价 — UI 应展示 partial 标签 */
+    pricingPartial?: boolean;
+    /** 任一模型完整定价缺失 — UI 应展示 unavailable 标签 */
+    pricingMissing?: boolean;
+}
+interface CoercedPricing {
+    pricing: ModelPricing | null;
+    /** input/output 价格齐全，但 cache 子价（read/creation）缺失并被回退为 input */
+    pricingPartial: boolean;
+}
+/**
+ * 从结构化注册表精确查找模型定价。
+ *
+ * 保持向后兼容:只返回价格或 null。partial 状态通过
+ * {@link getPricingFromRegistryDetailed} 暴露。
+ */
+export declare function getPricingFromRegistry(modelId: string): ModelPricing | null;
+/**
+ * 同 getPricingFromRegistry,但额外返回 cache 子价是否被回退为 input 价。
+ */
+export declare function getPricingFromRegistryDetailed(modelId: string): CoercedPricing;
+/**
+ * 获取模型定价解析结果。
+ *
+ * 解析顺序：
+ *   1. runtimeConfig.llm.model_providers / ModelManager / ModelsDevRegistry 精确查找
+ *   2. 未命中返回 null
+ */
+export declare function resolvePricing(modelName: string): ModelPricingResolution | null;
+/**
+ * 计算单个模型的费用明细
+ */
+export declare function calculateModelCost(modelName: string, inputTokens: number, outputTokens: number, cacheReadTokens: number, cacheCreationTokens: number): CostBreakdown;
+/**
+ * 计算会话总费用
+ */
+export declare function calculateSessionCost(modelStats: Array<{
+    name: string;
+    totalPrompt: number;
+    totalCompletion: number;
+    cacheRead?: number;
+    cacheCreation?: number;
+}>): SessionCostSummary;
+/**
+ * 格式化 token 数量（自动选择 K/M 单位）
+ */
+export declare function formatTokens(n: number): string;
+/**
+ * 格式化费用（美元）
+ */
+export declare function formatCost(cost: number): string;
+/**
+ * 格式化 /cost 命令输出
+ */
+export declare function formatCostReport(summary: SessionCostSummary): string;
+export {};
+//# sourceMappingURL=CostService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CostService.d.ts","sourceRoot":"","sources":["../../src/llm/CostService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG;IAClD,SAAS,EAAE,KAAK,CAAC;IACjB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAKD,UAAU,cAAc;IACtB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;CACzB;AA4DD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAsB9E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAc/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,MAAM,GAC1B,aAAa,CA6Cf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,GACD,kBAAkB,CAwDpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAkCpE"}

package/dist/llm/CostService.js

@@ -0,0 +1,287 @@
+/**
+ * CostService — 模型定价与费用计算
+ *
+ * 基于 token usage 计算费用，支持 cache-aware 计价：
+ * - cache_read 通常比普通 input 便宜 90%（Anthropic）或免费（OpenAI）
+ * - cache_creation 通常比普通 input 贵 25%（Anthropic）
+ * - 净输入 = input - cache_read - cache_creation（避免重复计费）
+ *
+ * 价格来源（按优先级）：
+ *   1. runtimeConfig.llm.model_providers / ModelManager 精确配置
+ *   2. ModelsDevRegistry 精确模型数据
+ *   3. 未命中时明确标记 pricingMissing，不再套用估算默认价
+ */
+import { coreLogger } from '../core/Log.js';
+import { config as runtimeConfig } from '../config.js';
+import { getModelManager } from '../config/ModelManager.js';
+import { getModelDevInfoExact } from './ModelsDevRegistry.js';
+const warnedPricingMisses = new Set();
+const warnedPricingPartial = new Set();
+function coerceModelPricingWithDetails(value) {
+    if (!value || typeof value !== 'object')
+        return { pricing: null, pricingPartial: false };
+    const raw = value;
+    const input = raw.inputPerMToken;
+    const output = raw.outputPerMToken;
+    if (typeof input !== 'number' || input <= 0 || typeof output !== 'number' || output <= 0) {
+        return { pricing: null, pricingPartial: false };
+    }
+    const hasRead = typeof raw.cacheReadPerMToken === 'number';
+    const hasCreation = typeof raw.cacheCreationPerMToken === 'number';
+    return {
+        pricing: {
+            inputPerMToken: input,
+            outputPerMToken: output,
+            cacheReadPerMToken: hasRead ? raw.cacheReadPerMToken : input,
+            cacheCreationPerMToken: hasCreation ? raw.cacheCreationPerMToken : input,
+        },
+        pricingPartial: !(hasRead && hasCreation),
+    };
+}
+function coerceModelPricing(value) {
+    return coerceModelPricingWithDetails(value).pricing;
+}
+function warnPricingMiss(modelId) {
+    if (!modelId || warnedPricingMisses.has(modelId))
+        return;
+    warnedPricingMisses.add(modelId);
+    coreLogger.warn('no-pricing-for-model', { modelId });
+}
+function warnPricingPartial(modelId) {
+    if (!modelId || warnedPricingPartial.has(modelId))
+        return;
+    warnedPricingPartial.add(modelId);
+    coreLogger.warn('partial-pricing-for-model', {
+        modelId,
+        reason: 'cache_read/cache_creation sub-price missing; falling back to inputPerMToken — cache segment cost is estimated',
+    });
+}
+function getPricingFromRuntimeConfigDetailed(modelId) {
+    for (const models of Object.values(runtimeConfig.llm.model_providers || {})) {
+        for (const model of models) {
+            if (model.id !== modelId)
+                continue;
+            const configured = coerceModelPricingWithDetails(model.pricing);
+            if (configured.pricing)
+                return configured;
+            const providerModelId = model.model;
+            if (providerModelId && providerModelId !== modelId) {
+                const provider = coerceModelPricingWithDetails(getModelDevInfoExact(providerModelId)?.pricing);
+                if (provider.pricing)
+                    return provider;
+            }
+            return { pricing: null, pricingPartial: false };
+        }
+    }
+    return { pricing: null, pricingPartial: false };
+}
+/**
+ * 从结构化注册表精确查找模型定价。
+ *
+ * 保持向后兼容:只返回价格或 null。partial 状态通过
+ * {@link getPricingFromRegistryDetailed} 暴露。
+ */
+export function getPricingFromRegistry(modelId) {
+    return getPricingFromRegistryDetailed(modelId).pricing;
+}
+/**
+ * 同 getPricingFromRegistry,但额外返回 cache 子价是否被回退为 input 价。
+ */
+export function getPricingFromRegistryDetailed(modelId) {
+    const id = modelId.trim();
+    if (!id)
+        return { pricing: null, pricingPartial: false };
+    const runtimeConfigured = getPricingFromRuntimeConfigDetailed(id);
+    if (runtimeConfigured.pricing)
+        return runtimeConfigured;
+    try {
+        const configured = getModelManager().getModelById(id);
+        const configuredPricing = coerceModelPricingWithDetails(configured?.pricing);
+        if (configuredPricing.pricing)
+            return configuredPricing;
+        const providerModelId = configured?.model;
+        if (providerModelId && providerModelId !== id) {
+            const providerPricing = coerceModelPricingWithDetails(getModelDevInfoExact(providerModelId)?.pricing);
+            if (providerPricing.pricing)
+                return providerPricing;
+        }
+    }
+    catch {
+        // ModelManager can throw while resolving incomplete local credentials; pricing lookup must stay non-fatal.
+    }
+    return coerceModelPricingWithDetails(getModelDevInfoExact(id)?.pricing);
+}
+/**
+ * 获取模型定价解析结果。
+ *
+ * 解析顺序：
+ *   1. runtimeConfig.llm.model_providers / ModelManager / ModelsDevRegistry 精确查找
+ *   2. 未命中返回 null
+ */
+export function resolvePricing(modelName) {
+    const modelId = modelName.trim();
+    if (!modelId) {
+        return null;
+    }
+    const registry = getPricingFromRegistryDetailed(modelId);
+    if (registry.pricing) {
+        if (registry.pricingPartial)
+            warnPricingPartial(modelId);
+        return { ...registry.pricing, estimated: false, ...(registry.pricingPartial ? { pricingPartial: true } : {}) };
+    }
+    warnPricingMiss(modelId);
+    return null;
+}
+/**
+ * 计算单个模型的费用明细
+ */
+export function calculateModelCost(modelName, inputTokens, outputTokens, cacheReadTokens, cacheCreationTokens) {
+    const pricing = resolvePricing(modelName);
+    // 净输入 = 总输入 - cache_read - cache_creation（避免重复计费）。
+    // usageExtractor 已统一把所有 provider 的 input 归一为「毛输入」（含 cache
+    // 两部分），因此这里对全 provider 都成立，不再有 Anthropic 双扣减问题。
+    const netInputTokens = Math.max(0, inputTokens - cacheReadTokens - cacheCreationTokens);
+    if (!pricing) {
+        return {
+            model: modelName,
+            inputTokens,
+            outputTokens,
+            cacheReadTokens,
+            cacheCreationTokens,
+            netInputTokens,
+            inputCost: 0,
+            outputCost: 0,
+            cacheReadCost: 0,
+            cacheCreationCost: 0,
+            totalCost: 0,
+            pricingMissing: true,
+        };
+    }
+    const inputCost = (netInputTokens / 1_000_000) * pricing.inputPerMToken;
+    const outputCost = (outputTokens / 1_000_000) * pricing.outputPerMToken;
+    const cacheReadCost = (cacheReadTokens / 1_000_000) * pricing.cacheReadPerMToken;
+    const cacheCreationCost = (cacheCreationTokens / 1_000_000) * pricing.cacheCreationPerMToken;
+    const totalCost = inputCost + outputCost + cacheReadCost + cacheCreationCost;
+    return {
+        model: modelName,
+        inputTokens,
+        outputTokens,
+        cacheReadTokens,
+        cacheCreationTokens,
+        netInputTokens,
+        inputCost,
+        outputCost,
+        cacheReadCost,
+        cacheCreationCost,
+        totalCost,
+        ...(pricing.pricingPartial ? { pricingPartial: true } : {}),
+    };
+}
+/**
+ * 计算会话总费用
+ */
+export function calculateSessionCost(modelStats) {
+    const models = [];
+    let totalInput = 0;
+    let totalOutput = 0;
+    let totalCacheRead = 0;
+    let totalCacheCreation = 0;
+    let totalCost = 0;
+    for (const stat of modelStats) {
+        const breakdown = calculateModelCost(stat.name, stat.totalPrompt, stat.totalCompletion, stat.cacheRead ?? 0, stat.cacheCreation ?? 0);
+        models.push(breakdown);
+        totalInput += stat.totalPrompt;
+        totalOutput += stat.totalCompletion;
+        totalCacheRead += stat.cacheRead ?? 0;
+        totalCacheCreation += stat.cacheCreation ?? 0;
+        totalCost += breakdown.totalCost;
+    }
+    const cacheHitRate = totalInput > 0 ? (totalCacheRead / totalInput) * 100 : 0;
+    // 汇总 partial / missing:任一模型 partial/missing,整体即标 partial/missing,
+    // UI 用作"整体估算"标签。
+    const pricingPartial = models.some((m) => m.pricingPartial);
+    const pricingMissing = models.some((m) => m.pricingMissing);
+    // 节省金额 = 无缓存时的输入侧费用 − 有缓存时的实际输入侧费用。
+    //   inputTokens 已是毛输入（含 cache_read + cache_creation），无缓存时全部
+    //   按 inputPerMToken 计价；实际费用 = 净输入 + 缓存读 + 缓存写三段单价之和。
+    //   两边都只算输入侧（output 费用一致，不参与节省比较）。
+    //   注意:遇到 pricingPartial 的模型,节省额本身也是估算（按 input 价算），公式仍成立。
+    const cacheSavings = models.reduce((sum, m) => {
+        const pricing = resolvePricing(m.model);
+        if (!pricing)
+            return sum;
+        const costWithoutCache = (m.inputTokens / 1_000_000) * pricing.inputPerMToken;
+        const actualInputCost = m.inputCost + m.cacheReadCost + m.cacheCreationCost;
+        return sum + (costWithoutCache - actualInputCost);
+    }, 0);
+    return {
+        models,
+        totalInputTokens: totalInput,
+        totalOutputTokens: totalOutput,
+        totalCacheReadTokens: totalCacheRead,
+        totalCacheCreationTokens: totalCacheCreation,
+        totalCost,
+        cacheHitRate,
+        cacheSavings,
+        ...(pricingPartial ? { pricingPartial: true } : {}),
+        ...(pricingMissing ? { pricingMissing: true } : {}),
+    };
+}
+/**
+ * 格式化 token 数量（自动选择 K/M 单位）
+ */
+export function formatTokens(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}k`;
+    return String(n);
+}
+/**
+ * 格式化费用（美元）
+ */
+export function formatCost(cost) {
+    if (cost >= 1)
+        return `$${cost.toFixed(2)}`;
+    if (cost >= 0.01)
+        return `$${cost.toFixed(3)}`;
+    if (cost > 0)
+        return `$${cost.toFixed(4)}`;
+    return '$0.00';
+}
+/**
+ * 格式化 /cost 命令输出
+ */
+export function formatCostReport(summary) {
+    const lines = [];
+    for (const m of summary.models) {
+        lines.push(`${m.model}:`);
+        lines.push(`  ${formatTokens(m.inputTokens)} input, ${formatTokens(m.outputTokens)} output, ${formatTokens(m.cacheReadTokens)} cache read, ${formatTokens(m.cacheCreationTokens)} cache write`);
+        lines.push(`  ${formatCost(m.inputCost)} + ${formatCost(m.outputCost)} + ${formatCost(m.cacheReadCost)} + ${formatCost(m.cacheCreationCost)} = ${formatCost(m.totalCost)}`);
+        if (m.pricingMissing) {
+            lines.push('  pricing unavailable — set model_providers.<provider>.pricing to enable cost tracking');
+        }
+        else if (m.pricingPartial) {
+            lines.push('  pricing partial — cache read/write sub-price missing, cache segment cost is estimated using input rate');
+        }
+    }
+    if (summary.models.length > 1) {
+        lines.push('');
+        lines.push('Total:');
+        lines.push(`  ${formatTokens(summary.totalInputTokens)} input, ${formatTokens(summary.totalOutputTokens)} output, ${formatTokens(summary.totalCacheReadTokens)} cache read, ${formatTokens(summary.totalCacheCreationTokens)} cache write`);
+    }
+    lines.push('');
+    lines.push(`Total cost: ${formatCost(summary.totalCost)}`);
+    if (summary.pricingMissing) {
+        lines.push('(pricing unavailable for some models — totals are incomplete)');
+    }
+    else if (summary.pricingPartial) {
+        lines.push('(pricing partial — cache sub-prices missing, cache segment is estimated)');
+    }
+    if (summary.totalCacheReadTokens > 0) {
+        lines.push(`Cache hit rate: ${summary.cacheHitRate.toFixed(1)}%`);
+        lines.push(`Cache savings: ${formatCost(summary.cacheSavings)}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=CostService.js.map

package/dist/llm/CostService.js.map

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

package/dist/llm/LoggingContentGenerator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * LoggingContentGenerator — 装饰器模式
+ *
+ * 参考 qwen-code loggingContentGenerator.ts，包装任意 ContentGenerator 实现，
+ * 在不污染 provider 逻辑的前提下添加：
+ * - 请求/响应审计日志
+ * - 延迟测量（TTFT / 总耗时）
+ * - 错误分类与记录
+ */
+import type { ContentGenerator, ContentGeneratorConfig, CountTokensParams, CountTokensResult, GenerateContentParams, StreamEvent } from './ContentGenerator.js';
+import type { ChatResponse, StreamCallbacks } from './types.js';
+export declare class LoggingContentGenerator implements ContentGenerator {
+    private readonly wrapped;
+    private readonly config;
+    constructor(wrapped: ContentGenerator, config: ContentGeneratorConfig);
+    generateContent(params: GenerateContentParams): Promise<ChatResponse>;
+    generateContentStream(params: GenerateContentParams, callbacks?: StreamCallbacks): AsyncGenerator<StreamEvent, ChatResponse, undefined>;
+    countTokens(params: CountTokensParams): Promise<CountTokensResult>;
+    generateContentWithCallbacks(params: GenerateContentParams, callbacks?: StreamCallbacks): Promise<ChatResponse>;
+    close(): Promise<void>;
+    warmup(): Promise<void>;
+    recycle(): void;
+    getProviderKey(model: string): string | null;
+}
+//# sourceMappingURL=LoggingContentGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingContentGenerator.d.ts","sourceRoot":"","sources":["../../src/llm/LoggingContentGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGhE,qBAAa,uBAAwB,YAAW,gBAAgB;IAE5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,sBAAsB;IAG3C,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BpE,qBAAqB,CAC1B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC1B,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC;IA8CjD,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIlE,4BAA4B,CAChC,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,YAAY,CAAC;IAIlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,OAAO,IAAI,IAAI;IAIf,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAG7C"}

package/dist/llm/LoggingContentGenerator.js

@@ -0,0 +1,82 @@
+/**
+ * LoggingContentGenerator — 装饰器模式
+ *
+ * 参考 qwen-code loggingContentGenerator.ts，包装任意 ContentGenerator 实现，
+ * 在不污染 provider 逻辑的前提下添加：
+ * - 请求/响应审计日志
+ * - 延迟测量（TTFT / 总耗时）
+ * - 错误分类与记录
+ */
+import { consumeGeneratorToResponse } from './ContentGenerator.js';
+import { llmLogger } from '../core/Log.js';
+export class LoggingContentGenerator {
+    wrapped;
+    config;
+    constructor(wrapped, config) {
+        this.wrapped = wrapped;
+        this.config = config;
+    }
+    async generateContent(params) {
+        const startTime = Date.now();
+        llmLogger.debug(`[LLM:req] model=${params.model} messages=${params.messages.length} tools=${params.tools?.length ?? 0}`);
+        try {
+            const response = await this.wrapped.generateContent(params);
+            const elapsed = Date.now() - startTime;
+            llmLogger.debug(`[LLM:res] model=${response.model ?? params.model} elapsed=${elapsed}ms ` +
+                `tokens=${response.usage?.total_tokens ?? '?'} finish=${response.finish_reason ?? '?'}`);
+            return response;
+        }
+        catch (error) {
+            const elapsed = Date.now() - startTime;
+            llmLogger.warn(`[LLM:err] model=${params.model} elapsed=${elapsed}ms error=${error.message}`);
+            throw error;
+        }
+    }
+    async *generateContentStream(params, callbacks) {
+        const startTime = Date.now();
+        let firstChunkTime;
+        llmLogger.debug(`[LLM:stream:req] model=${params.model} messages=${params.messages.length} tools=${params.tools?.length ?? 0}`);
+        try {
+            const stream = this.wrapped.generateContentStream(params, callbacks);
+            let result;
+            while (!(result = await stream.next()).done) {
+                const event = result.value;
+                if (!firstChunkTime && (event.type === 'text' || event.type === 'thinking')) {
+                    firstChunkTime = Date.now();
+                    llmLogger.debug(`[LLM:stream:ttft] model=${params.model} ttft=${firstChunkTime - startTime}ms`);
+                }
+                yield event;
+            }
+            // Generator return value is the final ChatResponse
+            const response = result.value;
+            const elapsed = Date.now() - startTime;
+            llmLogger.debug(`[LLM:stream:res] model=${response.model ?? params.model} elapsed=${elapsed}ms ` +
+                `tokens=${response.usage?.total_tokens ?? '?'} finish=${response.finish_reason ?? '?'}`);
+            return response;
+        }
+        catch (error) {
+            const elapsed = Date.now() - startTime;
+            llmLogger.warn(`[LLM:stream:err] model=${params.model} elapsed=${elapsed}ms error=${error.message}`);
+            throw error;
+        }
+    }
+    async countTokens(params) {
+        return this.wrapped.countTokens(params);
+    }
+    async generateContentWithCallbacks(params, callbacks) {
+        return consumeGeneratorToResponse(this.generateContentStream(params, callbacks));
+    }
+    async close() {
+        await this.wrapped.close();
+    }
+    async warmup() {
+        await this.wrapped.warmup?.();
+    }
+    recycle() {
+        this.wrapped.recycle?.();
+    }
+    getProviderKey(model) {
+        return this.wrapped.getProviderKey?.(model) ?? null;
+    }
+}
+//# sourceMappingURL=LoggingContentGenerator.js.map

package/dist/llm/LoggingContentGenerator.js.map

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

package/dist/llm/ModelGateway.d.ts

@@ -0,0 +1,88 @@
+import { type Config } from '../config.js';
+import { type ModelManager } from '../config/ModelManager.js';
+export type GatewayPurpose = 'leader' | 'agent' | 'research' | 'coding' | 'verify' | 'review' | 'summary' | 'vision' | 'local_gateway' | 'settings_test' | 'wiki' | 'generic';
+export type GatewayLatencyClass = 'interactive' | 'batch' | 'background';
+export type GatewayDataPolicy = 'standard' | 'local_only' | 'zdr_required' | 'redact_sensitive';
+export interface GatewayRequiredCapabilities {
+    thinking?: boolean;
+    vision?: boolean;
+    longContextTokens?: number;
+}
+export interface GatewayRequestContext {
+    actorLabel?: string;
+    actorType?: 'leader' | 'agent' | 'external' | 'local_gateway' | 'system';
+    sessionId?: string;
+    agentId?: string;
+    agentName?: string;
+    taskId?: string;
+    role?: string;
+    purpose?: GatewayPurpose;
+    required?: GatewayRequiredCapabilities;
+    latencyClass?: GatewayLatencyClass;
+    dataPolicy?: GatewayDataPolicy;
+    maxInputTokens?: number;
+    requestedModel?: string;
+}
+export interface GatewayRouteConfig {
+    primary?: string;
+    fallbacks?: string[];
+    require?: GatewayRequiredCapabilities;
+    max_cost_per_mtoken?: number;
+    data_policy?: GatewayDataPolicy;
+}
+export interface GatewayDecision {
+    profile: string;
+    requestedModel: string;
+    selectedModel: string;
+    candidates: string[];
+    fallbackModels: string[];
+    rejected: Array<{
+        model: string;
+        reason: string;
+    }>;
+    reason: string;
+}
+export interface GatewayTrace {
+    traceId: string;
+    request: GatewayRequestContext;
+    decision: GatewayDecision;
+    attempts: Array<{
+        model: string;
+        status: 'started' | 'success' | 'failed' | 'skipped';
+        errorKind?: string;
+        errorMessage?: string;
+        retryable?: boolean;
+        elapsedMs?: number;
+        startedAt: number;
+        finishedAt?: number;
+    }>;
+    startedAt: number;
+    finishedAt?: number;
+    finalModel?: string;
+    finalStatus?: 'success' | 'failed';
+}
+export interface GatewayAttemptHandle {
+    trace: GatewayTrace;
+    attemptIndex: number;
+    model: string;
+}
+export declare class ModelGateway {
+    private readonly config;
+    private readonly modelManager;
+    constructor(config?: Config, modelManager?: ModelManager);
+    decide(input?: GatewayRequestContext): GatewayDecision;
+    createTrace(request?: GatewayRequestContext, decision?: GatewayDecision): GatewayTrace;
+    startAttempt(trace: GatewayTrace, model: string): GatewayAttemptHandle;
+    finishAttempt(handle: GatewayAttemptHandle, input: {
+        status: 'success' | 'failed' | 'skipped';
+        errorKind?: string;
+        errorMessage?: string;
+        retryable?: boolean;
+    }): void;
+    failTrace(trace: GatewayTrace): void;
+    pickFallback(trace: GatewayTrace, failedModels: Set<string>): string | null;
+}
+export declare function getModelGateway(): ModelGateway;
+export declare function _resetModelGatewayForTests(): void;
+export declare function modelIdsFromProviders(config?: Config): string[];
+//# sourceMappingURL=ModelGateway.d.ts.map

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

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