@lingxiao-office/sdk 1.0.0

package/dist/llm/ModelsDevRegistry.js

@@ -0,0 +1,301 @@
+/**
+ * ModelsDevRegistry — models.dev 模型能力数据库
+ *
+ * 数据来源优先级：
+ *   1. 构建时内嵌的 models-snapshot.json（离线兜底，必选）
+ *   2. 本地缓存 ~/.lingxiao/cache/models.json（TTL 1h）
+ *   3. 运行时从 https://models.dev/api.json 拉取
+ *
+ * 查询接口对调用方透明：数据未就绪时返回 undefined，调用方应显式处理未知模型。
+ */
+import { readFileSync, writeFileSync, statSync, mkdirSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { buildLingxiaoComponentUserAgent } from '../version.js';
+// ── 常量 ──────────────────────────────────────────────────────────────────
+const MODELS_DEV_URL = 'https://models.dev/api.json';
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 小时
+const FETCH_TIMEOUT_MS = 10_000;
+const MODELS_DEV_USER_AGENT = buildLingxiaoComponentUserAgent('models.dev registry');
+// 缓存文件路径（与项目其他缓存同目录）
+function getCachePath() {
+    const cacheDir = join(homedir(), '.lingxiao', 'cache');
+    if (!existsSync(cacheDir))
+        mkdirSync(cacheDir, { recursive: true });
+    return join(cacheDir, 'models.json');
+}
+// ── ModelsDevRegistry 类 ───────────────────────────────────────────────────
+class ModelsDevRegistry {
+    /** 归一化后的模型索引：modelId (小写) → ModelDevInfo */
+    index = new Map();
+    loaded = false;
+    refreshTimer;
+    constructor() {
+        // ★ 推迟初始化到下一个事件循环 tick，避免阻塞主请求链路。
+        // 模型能力数据未就绪时 getModelInfo() 返回 undefined，调用方应显式处理未知模型。
+        setImmediate(() => this.initAsync());
+    }
+    // ── 初始化 ───────────────────────────────────────────────────────────────
+    async initAsync() {
+        // 1. 优先加载构建时 snapshot
+        this.loadSnapshotSync();
+        // 2. 尝试加载本地缓存（覆盖 snapshot，如果缓存更新）
+        const cached = this.loadCache();
+        if (cached) {
+            this.buildIndex(cached);
+            this.loaded = true;
+        }
+        // 3. 后台刷新（如果缓存过期或不存在）
+        this.scheduleRefresh();
+    }
+    // ── 数据加载 ─────────────────────────────────────────────────────────────
+    /** 加载构建时内嵌的 snapshot */
+    loadSnapshot() {
+        try {
+            const currentDir = dirname(fileURLToPath(import.meta.url));
+            const raw = readFileSync(join(currentDir, 'models-snapshot.json'), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch { /* expected: operation may fail gracefully */
+            return null;
+        }
+    }
+    /**
+     * 同步加载内置 snapshot。
+     *
+     * 构造函数仍会在后台初始化，但 LeaderAgent/ContextManager 创建时会立刻查询
+     * context window。首次查询必须能命中 snapshot，否则会错误回退到 200K。
+     */
+    loadSnapshotSync() {
+        if (this.loaded && this.index.size > 0)
+            return;
+        const snapshotData = this.loadSnapshot();
+        if (snapshotData) {
+            this.buildIndex(snapshotData);
+            this.loaded = true;
+        }
+    }
+    /** 加载本地缓存文件（仅当未过期时）*/
+    loadCache() {
+        try {
+            const cachePath = getCachePath();
+            const stat = statSync(cachePath);
+            const age = Date.now() - stat.mtimeMs;
+            if (age > CACHE_TTL_MS)
+                return null; // 已过期，不用旧缓存覆盖 snapshot
+            const raw = readFileSync(cachePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch { /* expected: operation may fail gracefully */
+            return null;
+        }
+    }
+    /** 从 models.dev 拉取最新数据，写入缓存 */
+    async fetchAndCache() {
+        try {
+            const res = await fetch(MODELS_DEV_URL, {
+                headers: { 'User-Agent': MODELS_DEV_USER_AGENT },
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            });
+            if (!res.ok)
+                return { ok: false, error: `HTTP ${res.status}` };
+            const text = await res.text();
+            const data = JSON.parse(text);
+            // 写缓存
+            try {
+                writeFileSync(getCachePath(), text, 'utf-8');
+            }
+            catch { /* 写缓存失败无副作用 */ }
+            // 更新索引
+            this.buildIndex(data);
+            this.loaded = true;
+            return { ok: true };
+        }
+        catch (err) {
+            // 网络失败 — 静默，继续使用 snapshot / 旧缓存
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    /** 判断缓存是否需要刷新 */
+    cacheNeedsRefresh() {
+        try {
+            const cachePath = getCachePath();
+            const stat = statSync(cachePath);
+            return Date.now() - stat.mtimeMs > CACHE_TTL_MS;
+        }
+        catch { /* expected: fallback to default */
+            return true; // 缓存不存在
+        }
+    }
+    scheduleRefresh() {
+        // 启动时如果缓存过期，立即后台拉取
+        if (this.cacheNeedsRefresh()) {
+            void this.fetchAndCache();
+        }
+        // 每小时刷新一次（不阻塞进程退出）
+        this.refreshTimer = setInterval(() => {
+            void this.fetchAndCache();
+        }, CACHE_TTL_MS);
+        this.refreshTimer.unref?.();
+    }
+    // ── 索引构建 ─────────────────────────────────────────────────────────────
+    buildIndex(data) {
+        const newIndex = new Map();
+        const setIfBetter = (key, info) => {
+            const existing = newIndex.get(key);
+            if (!existing) {
+                newIndex.set(key, info);
+                return;
+            }
+            // 多个 provider 有同名模型时，取能力更丰富的那个：
+            // reasoning=true > false，vision=true > false
+            if (!existing.reasoning && info.reasoning)
+                newIndex.set(key, info);
+            else if (!existing.vision && info.vision)
+                newIndex.set(key, info);
+        };
+        for (const provider of Object.values(data)) {
+            if (!provider?.models)
+                continue;
+            for (const [rawId, model] of Object.entries(provider.models)) {
+                const info = this.normalize(model);
+                setIfBetter(rawId.toLowerCase(), info);
+                if (model.id && model.id.toLowerCase() !== rawId.toLowerCase()) {
+                    setIfBetter(model.id.toLowerCase(), info);
+                }
+            }
+        }
+        this.index = newIndex;
+    }
+    normalize(model) {
+        const inputModalities = model.modalities?.input ?? [];
+        const cost = model.cost;
+        let pricing;
+        if (cost && (typeof cost.input === 'number' || typeof cost.output === 'number')) {
+            pricing = {
+                inputPerMToken: typeof cost.input === 'number' ? cost.input : 0,
+                outputPerMToken: typeof cost.output === 'number' ? cost.output : 0,
+                cacheReadPerMToken: typeof cost.cache_read === 'number' ? cost.cache_read : undefined,
+                cacheCreationPerMToken: typeof cost.cache_write === 'number' ? cost.cache_write : undefined,
+            };
+        }
+        // 思考控制选项：只保留有 type 的条目；effort 的 values 去 null 收敛为 string[]。
+        const reasoningOptions = Array.isArray(model.reasoning_options)
+            ? model.reasoning_options
+                .map((o) => ({
+                type: typeof o?.type === 'string' ? o.type : '',
+                values: Array.isArray(o?.values)
+                    ? o.values.filter((v) => typeof v === 'string')
+                    : undefined,
+                min: typeof o?.min === 'number' ? o.min : undefined,
+                max: typeof o?.max === 'number' ? o.max : undefined,
+            }))
+                .filter((o) => o.type.length > 0)
+            : undefined;
+        // reasoning 输出字段：interleaved 可能是 {field} 对象或布尔 true（字段未知）。
+        const reasoningOutputField = model.interleaved && typeof model.interleaved === 'object' && typeof model.interleaved.field === 'string'
+            ? model.interleaved.field
+            : undefined;
+        return {
+            vision: (model.attachment ?? false) || inputModalities.includes('image'),
+            pdf: inputModalities.includes('pdf'),
+            audio: inputModalities.includes('audio'),
+            video: inputModalities.includes('video'),
+            reasoning: model.reasoning ?? false,
+            reasoningOptions,
+            reasoningOutputField,
+            toolCall: model.tool_call ?? true,
+            contextLimit: model.limit?.context,
+            outputLimit: model.limit?.output,
+            pricing,
+        };
+    }
+    // ── 公共查询接口 ─────────────────────────────────────────────────────────
+    /**
+     * 按模型 ID 查询能力信息。
+     *
+     * 匹配策略（和 models.dev 一致）：
+     *   1. 精确匹配（小写）
+     *   2. 前缀匹配（从最长 key 开始）
+     */
+    getModelInfo(modelId) {
+        if (!this.loaded || this.index.size === 0) {
+            this.loadSnapshotSync();
+        }
+        if (!this.loaded || this.index.size === 0)
+            return undefined;
+        const id = modelId.trim().toLowerCase();
+        // 1. 精确匹配
+        const exact = this.index.get(id);
+        if (exact)
+            return exact;
+        // 2. 前缀匹配：找最长匹配的 key
+        let bestKey = '';
+        let bestInfo;
+        for (const [key, info] of this.index) {
+            if (id.startsWith(key) && key.length > bestKey.length) {
+                bestKey = key;
+                bestInfo = info;
+            }
+        }
+        return bestInfo;
+    }
+    /**
+     * 按模型 ID 精确查询能力信息。
+     *
+     * 用于定价等不能容忍前缀猜测的路径；例如 `claude-opus-4` 不应因为
+     * 前缀关系静默套用 `claude-opus-4-20250514` 的价格。
+     */
+    getModelInfoExact(modelId) {
+        if (!this.loaded || this.index.size === 0) {
+            this.loadSnapshotSync();
+        }
+        if (!this.loaded || this.index.size === 0)
+            return undefined;
+        const id = modelId.trim().toLowerCase();
+        return this.index.get(id);
+    }
+    /** 数据是否已加载（snapshot 或缓存）*/
+    isAvailable() {
+        return this.loaded;
+    }
+    /** 当前模型索引规模（用于状态查询）*/
+    size() {
+        return this.index.size;
+    }
+    /** 缓存文件元信息（路径、上次修改时间、是否过期）*/
+    getCacheStatus() {
+        const path = getCachePath();
+        try {
+            const stat = statSync(path);
+            const ageMs = Date.now() - stat.mtimeMs;
+            return { path, mtimeMs: stat.mtimeMs, ageMs, ttlMs: CACHE_TTL_MS, expired: ageMs > CACHE_TTL_MS, exists: true };
+        }
+        catch { /* expected: fallback to default */
+            return { path, ttlMs: CACHE_TTL_MS, expired: true, exists: false };
+        }
+    }
+    /** 强制刷新（用于测试或手动触发，返回是否成功拉到新数据）*/
+    async refresh() {
+        const result = await this.fetchAndCache();
+        return { ok: result.ok, size: this.index.size, error: result.error };
+    }
+}
+// ── 全局单例 ──────────────────────────────────────────────────────────────
+let registry = null;
+export function getModelsDevRegistry() {
+    if (!registry) {
+        registry = new ModelsDevRegistry();
+    }
+    return registry;
+}
+/** 直接查询快捷方法 */
+export function getModelDevInfo(modelId) {
+    return getModelsDevRegistry().getModelInfo(modelId);
+}
+/** 精确查询快捷方法：不会执行前缀匹配。 */
+export function getModelDevInfoExact(modelId) {
+    return getModelsDevRegistry().getModelInfoExact(modelId);
+}
+//# sourceMappingURL=ModelsDevRegistry.js.map

package/dist/llm/ModelsDevRegistry.js.map

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

package/dist/llm/OpenAIContentGenerator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * OpenAIContentGenerator — OpenAI API provider 的 ContentGenerator 实现
+ *
+ * 参考 qwen-code openaiContentGenerator/pipeline.ts 的 5 阶段管道设计：
+ *   1. buildRequest — 构建请求参数
+ *   2. createStream — 发起 HTTP 请求
+ *   3. processStream — 逐 chunk 解析与转换
+ *   4. handleErrors — 错误检测与分类
+ *   5. yieldResult — 产出最终结果
+ *
+ * 将原 OpenAIProvider.chatStream 的 800+ 行逻辑拆解为清晰的管道阶段。
+ */
+import type { ContentGenerator, ContentGeneratorConfig, CountTokensParams, CountTokensResult, GenerateContentParams, StreamEvent } from './ContentGenerator.js';
+import { type ChatResponse, type StreamCallbacks } from './types.js';
+export declare class OpenAIContentGenerator implements ContentGenerator {
+    private client;
+    private readonly modelId;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(config: ContentGeneratorConfig);
+    private buildClient;
+    /** 销毁旧 SDK client，下次请求走新 client + 共享 dispatcher（已被 caller rebuildSharedFetch） */
+    recycle(): void;
+    private buildRequest;
+    private classifyStreamChunkError;
+    generateContent(params: GenerateContentParams): Promise<ChatResponse>;
+    /**
+     * 流式生成内容。
+     *
+     * 注意：流式请求不在 generator 层重试。一旦流开始消费字节，遇到的错误
+     * （如连接中断）会直接向上抛出，由上层 executeLlmRound
+     * 通过 onStreamRetry 回调决定是否重启整轮。这是有意的设计取舍——已经
+     * yield 出去的 token 无法撤回，generator 层无法安全地自动重试。
+     * 非流式的 generateContent 同样不在 generator 层重试（2026-05-29 收口到 LlmGuard）。
+     */
+    generateContentStream(params: GenerateContentParams, callbacks?: StreamCallbacks): AsyncGenerator<StreamEvent, ChatResponse, undefined>;
+    generateContentWithCallbacks(params: GenerateContentParams, callbacks?: StreamCallbacks): Promise<ChatResponse>;
+    countTokens(params: CountTokensParams): Promise<CountTokensResult>;
+    close(): Promise<void>;
+    /** Provider key 用于 CircuitBreaker 跨流式/非流式路径共享熔断状态 */
+    getProviderKey(model: string): string;
+    warmup(): Promise<void>;
+    private parseNonStreamingResponse;
+    private tryEscalate;
+    private extractToolCalls;
+    private extractUsage;
+    private sanitizeMessages;
+    private convertTools;
+    private normalizeOpenAIToolParameters;
+    private toOpenAIContentParts;
+    private toMessageParam;
+    private applyOpenAICompatibleThinkingParams;
+    private applyModelGenerationConfig;
+    private wrapReasoningText;
+}
+//# sourceMappingURL=OpenAIContentGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIContentGenerator.d.ts","sourceRoot":"","sources":["../../src/llm/OpenAIContentGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAOL,KAAK,YAAY,EAIjB,KAAK,eAAe,EAIrB,MAAM,YAAY,CAAC;AAqEpB,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,sBAAsB;IAS1C,OAAO,CAAC,WAAW;IAgBnB,iFAAiF;IACjF,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY;IA0DpB,OAAO,CAAC,wBAAwB;IAmD1B,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8C3E;;;;;;;;OAQG;IACI,qBAAqB,CAC1B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC1B,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC;IAyMjD,4BAA4B,CAChC,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,YAAY,CAAC;IAgBlB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuBlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,qDAAqD;IACrD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAe7B,OAAO,CAAC,yBAAyB;YA2DnB,WAAW;IAuBzB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,6BAA6B;IAQrC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,mCAAmC;IAe3C,OAAO,CAAC,0BAA0B;IAiBlC,OAAO,CAAC,iBAAiB;CAM1B"}