@lingxiao-office/sdk 1.0.0

package/dist/llm/ModelGateway.js

@@ -0,0 +1,261 @@
+import { config as runtimeConfig } from '../config.js';
+import { getModelManager } from '../config/ModelManager.js';
+import { resolvePricing } from './CostService.js';
+import { getModelDevInfo } from './ModelsDevRegistry.js';
+const ROLE_PROFILES = new Set([
+    'research',
+    'verify',
+    'review',
+    'coding',
+]);
+function uniqueNonEmpty(values) {
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        const trimmed = String(value || '').trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function profileFromPurpose(input) {
+    const purpose = input?.purpose;
+    const actorType = input?.actorType;
+    const role = (input?.role || '').toLowerCase();
+    if (purpose === 'local_gateway')
+        return 'local_gateway';
+    if (purpose === 'settings_test')
+        return 'settings_test';
+    if (purpose === 'wiki')
+        return 'wiki';
+    if (purpose === 'summary')
+        return 'summary';
+    if (purpose === 'vision' || input?.required?.vision)
+        return 'vision';
+    if (actorType === 'leader' || purpose === 'leader')
+        return 'leader';
+    if (purpose === 'research')
+        return 'research';
+    if (purpose === 'verify')
+        return 'verify';
+    if (purpose === 'review')
+        return 'review';
+    if (purpose === 'coding')
+        return 'coding';
+    if (ROLE_PROFILES.has(role)) {
+        return role;
+    }
+    if (actorType === 'agent' || purpose === 'agent')
+        return 'agent';
+    return 'generic';
+}
+function configuredRoute(config, profile) {
+    const routes = config.llm.gateway_routes;
+    return routes?.[profile] || routes?.generic;
+}
+function defaultPrimary(config, profile) {
+    if (profile === 'agent' || profile === 'coding' || profile === 'verify' || profile === 'review' || profile === 'research') {
+        return config.llm.agent_model || config.llm.leader_model || '';
+    }
+    if (profile === 'wiki') {
+        return config.llm.wiki_model || config.llm.leader_model || config.llm.agent_model || '';
+    }
+    return config.llm.leader_model || config.llm.agent_model || '';
+}
+function hasThinking(model) {
+    const caps = model.capabilities;
+    if (typeof caps?.thinking_mode === 'string' && caps.thinking_mode)
+        return true;
+    return getModelDevInfo(getProviderModelName(model))?.reasoning === true;
+}
+function getModelId(model) {
+    return 'snapshotId' in model ? model.snapshotId : model.id;
+}
+function getProviderModelName(model) {
+    return model.model || ('modelId' in model ? model.modelId : model.id);
+}
+function getModelModalities(model) {
+    const configured = model.capabilities?.modalities;
+    if (configured)
+        return configured;
+    const devInfo = getModelDevInfo(getProviderModelName(model));
+    if (!devInfo)
+        return undefined;
+    return {
+        image: devInfo.vision,
+        pdf: devInfo.pdf || undefined,
+        audio: devInfo.audio || undefined,
+        video: devInfo.video || undefined,
+    };
+}
+function getContextWindowSize(model) {
+    if ('contextWindowSize' in model && typeof model.contextWindowSize === 'number' && model.contextWindowSize > 0) {
+        return model.contextWindowSize;
+    }
+    const fromCaps = model.capabilities?.contextWindowSize;
+    if (fromCaps && fromCaps > 0)
+        return fromCaps;
+    return getModelDevInfo(getProviderModelName(model))?.contextLimit;
+}
+function modelSupports(modelId, required, modelManager) {
+    const model = modelManager.getModelById(modelId);
+    if (!model) {
+        if (!required?.thinking && !required?.vision && !required?.longContextTokens) {
+            return { ok: true };
+        }
+        return { ok: false, reason: 'not_configured' };
+    }
+    if (required?.thinking && !hasThinking(model))
+        return { ok: false, reason: 'missing_thinking' };
+    if (required?.vision) {
+        const modalities = getModelModalities(model);
+        if (!modalities?.image)
+            return { ok: false, reason: 'missing_vision' };
+    }
+    if (required?.longContextTokens) {
+        const contextWindow = getContextWindowSize(model);
+        if (contextWindow && contextWindow < required.longContextTokens)
+            return { ok: false, reason: 'context_too_small' };
+    }
+    return { ok: true };
+}
+function costAllowed(modelId, maxCostPerMToken) {
+    if (!maxCostPerMToken || maxCostPerMToken <= 0)
+        return { ok: true };
+    const pricing = resolvePricing(modelId);
+    if (!pricing)
+        return { ok: false, reason: 'pricing_missing' };
+    return Math.max(pricing.inputPerMToken, pricing.outputPerMToken) <= maxCostPerMToken
+        ? { ok: true }
+        : { ok: false, reason: 'cost_ceiling' };
+}
+export class ModelGateway {
+    config;
+    modelManager;
+    constructor(config = runtimeConfig, modelManager = getModelManager()) {
+        this.config = config;
+        this.modelManager = modelManager;
+    }
+    decide(input = {}) {
+        const profile = profileFromPurpose(input);
+        const route = configuredRoute(this.config, profile);
+        const requestedModel = input.requestedModel || defaultPrimary(this.config, profile);
+        const primary = route?.primary || requestedModel || defaultPrimary(this.config, profile);
+        const required = {
+            ...(route?.require || {}),
+            ...(input.required || {}),
+        };
+        const candidates = uniqueNonEmpty([primary]);
+        const rejected = [];
+        let selectedModel = '';
+        for (const candidate of candidates) {
+            const supported = modelSupports(candidate, required, this.modelManager);
+            if (!supported.ok) {
+                rejected.push({ model: candidate, reason: supported.reason || 'unsupported' });
+                continue;
+            }
+            const cost = costAllowed(candidate, route?.max_cost_per_mtoken);
+            if (!cost.ok) {
+                rejected.push({ model: candidate, reason: cost.reason || 'cost_ceiling' });
+                continue;
+            }
+            selectedModel = candidate;
+            break;
+        }
+        if (!selectedModel) {
+            selectedModel = primary || requestedModel;
+        }
+        // 显式 fallback 候选：route.fallbacks 优先，其后接全局 gateway_fallback_models。
+        // 与 primary 同样跑能力/成本过滤，剔除 selectedModel 与重复项，保持确定性顺序。
+        const globalFallbacks = this.config.llm.gateway_fallback_models || [];
+        const fallbackCandidates = uniqueNonEmpty([...(route?.fallbacks || []), ...globalFallbacks])
+            .filter((candidate) => candidate !== selectedModel);
+        const fallbackModels = [];
+        for (const candidate of fallbackCandidates) {
+            const supported = modelSupports(candidate, required, this.modelManager);
+            if (!supported.ok) {
+                rejected.push({ model: candidate, reason: supported.reason || 'unsupported' });
+                continue;
+            }
+            const cost = costAllowed(candidate, route?.max_cost_per_mtoken);
+            if (!cost.ok) {
+                rejected.push({ model: candidate, reason: cost.reason || 'cost_ceiling' });
+                continue;
+            }
+            fallbackModels.push(candidate);
+        }
+        return {
+            profile,
+            requestedModel: requestedModel || selectedModel,
+            selectedModel,
+            candidates,
+            fallbackModels,
+            rejected,
+            reason: route ? `profile:${profile}` : `default:${profile}`,
+        };
+    }
+    createTrace(request = {}, decision = this.decide(request)) {
+        return {
+            traceId: `gw_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`,
+            request,
+            decision,
+            attempts: [],
+            startedAt: Date.now(),
+        };
+    }
+    startAttempt(trace, model) {
+        const attemptIndex = trace.attempts.length;
+        trace.attempts.push({
+            model,
+            status: 'started',
+            startedAt: Date.now(),
+        });
+        return { trace, attemptIndex, model };
+    }
+    finishAttempt(handle, input) {
+        const attempt = handle.trace.attempts[handle.attemptIndex];
+        if (!attempt)
+            return;
+        const finishedAt = Date.now();
+        attempt.status = input.status;
+        attempt.errorKind = input.errorKind;
+        attempt.errorMessage = input.errorMessage;
+        attempt.retryable = input.retryable;
+        attempt.finishedAt = finishedAt;
+        attempt.elapsedMs = finishedAt - attempt.startedAt;
+        if (input.status === 'success') {
+            handle.trace.finalStatus = 'success';
+            handle.trace.finalModel = handle.model;
+            handle.trace.finishedAt = finishedAt;
+        }
+    }
+    failTrace(trace) {
+        trace.finalStatus = 'failed';
+        trace.finishedAt = Date.now();
+    }
+    pickFallback(trace, failedModels) {
+        for (const candidate of trace.decision.fallbackModels) {
+            if (!failedModels.has(candidate))
+                return candidate;
+        }
+        return null;
+    }
+}
+let globalGateway = null;
+export function getModelGateway() {
+    if (!globalGateway)
+        globalGateway = new ModelGateway();
+    return globalGateway;
+}
+export function _resetModelGatewayForTests() {
+    globalGateway = null;
+}
+export function modelIdsFromProviders(config = runtimeConfig) {
+    return Object.values(config.llm.model_providers || {})
+        .flat()
+        .map((model) => getModelId(model))
+        .filter(Boolean);
+}
+//# sourceMappingURL=ModelGateway.js.map

package/dist/llm/ModelGateway.js.map

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

package/dist/llm/ModelsDevRegistry.d.ts

@@ -0,0 +1,159 @@
+/**
+ * ModelsDevRegistry — models.dev 模型能力数据库
+ *
+ * 数据来源优先级：
+ *   1. 构建时内嵌的 models-snapshot.json（离线兜底，必选）
+ *   2. 本地缓存 ~/.lingxiao/cache/models.json（TTL 1h）
+ *   3. 运行时从 https://models.dev/api.json 拉取
+ *
+ * 查询接口对调用方透明：数据未就绪时返回 undefined，调用方应显式处理未知模型。
+ */
+/** models.dev 原始 Model 结构（只取我们需要的字段）*/
+export interface ModelDevRaw {
+    id: string;
+    attachment?: boolean;
+    reasoning?: boolean;
+    tool_call?: boolean;
+    temperature?: boolean;
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    limit?: {
+        context?: number;
+        input?: number;
+        output?: number;
+    };
+    /**
+     * 思考/推理控制选项（models.dev reasoning_options）。type 决定控制机制：
+     *   - "effort"        档位控制（OpenAI/GLM/Grok 风格），values 为合法档位值
+     *   - "toggle"        开关控制（Kimi/Qwen/旧 GLM 风格）
+     *   - "budget_tokens" token 预算控制（Anthropic/Gemini 风格），min/max 为预算区间
+     */
+    reasoning_options?: Array<{
+        type?: string;
+        values?: (string | null)[];
+        min?: number;
+        max?: number;
+    }>;
+    /** reasoning 输出字段（models.dev interleaved.field，如 "reasoning_content"）；布尔 true 表示交错但字段未知 */
+    interleaved?: {
+        field?: string;
+    } | boolean;
+    /** 价格（每百万 token 美元；models.dev 提供）*/
+    cost?: {
+        input?: number;
+        output?: number;
+        cache_read?: number;
+        cache_write?: number;
+    };
+}
+/**
+ * 归一化后的思考控制选项。type 必填，其余按机制可选：
+ *   effort        → values（合法档位，已去 null）
+ *   budget_tokens → min/max（预算区间）
+ *   toggle        → 无附加字段
+ */
+export interface ReasoningOption {
+    type: string;
+    values?: string[];
+    min?: number;
+    max?: number;
+}
+/** 经过归一化的模型信息，供内部使用 */
+export interface ModelDevInfo {
+    /** 是否支持图片输入（attachment 或 modalities.input 包含 image）*/
+    vision: boolean;
+    /** 是否支持 PDF 输入 */
+    pdf: boolean;
+    /** 是否支持音频输入 */
+    audio: boolean;
+    /** 是否支持视频输入 */
+    video: boolean;
+    /** 是否支持思考/推理模式 */
+    reasoning: boolean;
+    /** 思考控制选项（来自 models.dev reasoning_options）；undefined 表示 reasoning 不可控/恒开 */
+    reasoningOptions?: ReasoningOption[];
+    /** reasoning 输出字段名（来自 models.dev interleaved.field，如 "reasoning_content"）*/
+    reasoningOutputField?: string;
+    /** 是否支持函数调用 */
+    toolCall: boolean;
+    /** 上下文窗口大小 (tokens) */
+    contextLimit?: number;
+    /** 最大输出 token 数 */
+    outputLimit?: number;
+    /** 价格（美元/百万 token），来自 models.dev cost 字段 */
+    pricing?: {
+        inputPerMToken: number;
+        outputPerMToken: number;
+        cacheReadPerMToken?: number;
+        cacheCreationPerMToken?: number;
+    };
+}
+declare class ModelsDevRegistry {
+    /** 归一化后的模型索引：modelId (小写) → ModelDevInfo */
+    private index;
+    private loaded;
+    private refreshTimer?;
+    constructor();
+    private initAsync;
+    /** 加载构建时内嵌的 snapshot */
+    private loadSnapshot;
+    /**
+     * 同步加载内置 snapshot。
+     *
+     * 构造函数仍会在后台初始化，但 LeaderAgent/ContextManager 创建时会立刻查询
+     * context window。首次查询必须能命中 snapshot，否则会错误回退到 200K。
+     */
+    private loadSnapshotSync;
+    /** 加载本地缓存文件（仅当未过期时）*/
+    private loadCache;
+    /** 从 models.dev 拉取最新数据，写入缓存 */
+    private fetchAndCache;
+    /** 判断缓存是否需要刷新 */
+    private cacheNeedsRefresh;
+    private scheduleRefresh;
+    private buildIndex;
+    private normalize;
+    /**
+     * 按模型 ID 查询能力信息。
+     *
+     * 匹配策略（和 models.dev 一致）：
+     *   1. 精确匹配（小写）
+     *   2. 前缀匹配（从最长 key 开始）
+     */
+    getModelInfo(modelId: string): ModelDevInfo | undefined;
+    /**
+     * 按模型 ID 精确查询能力信息。
+     *
+     * 用于定价等不能容忍前缀猜测的路径；例如 `claude-opus-4` 不应因为
+     * 前缀关系静默套用 `claude-opus-4-20250514` 的价格。
+     */
+    getModelInfoExact(modelId: string): ModelDevInfo | undefined;
+    /** 数据是否已加载（snapshot 或缓存）*/
+    isAvailable(): boolean;
+    /** 当前模型索引规模（用于状态查询）*/
+    size(): number;
+    /** 缓存文件元信息（路径、上次修改时间、是否过期）*/
+    getCacheStatus(): {
+        path: string;
+        mtimeMs?: number;
+        ageMs?: number;
+        ttlMs: number;
+        expired: boolean;
+        exists: boolean;
+    };
+    /** 强制刷新（用于测试或手动触发，返回是否成功拉到新数据）*/
+    refresh(): Promise<{
+        ok: boolean;
+        size: number;
+        error?: string;
+    }>;
+}
+export declare function getModelsDevRegistry(): ModelsDevRegistry;
+/** 直接查询快捷方法 */
+export declare function getModelDevInfo(modelId: string): ModelDevInfo | undefined;
+/** 精确查询快捷方法：不会执行前缀匹配。 */
+export declare function getModelDevInfoExact(modelId: string): ModelDevInfo | undefined;
+export {};
+//# sourceMappingURL=ModelsDevRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModelsDevRegistry.d.ts","sourceRoot":"","sources":["../../src/llm/ModelsDevRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwBH,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,2FAA2F;IAC3F,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC3C,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,uBAAuB;AACvB,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;IACf,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAUD,cAAM,iBAAiB;IACrB,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAiC;;YAUxC,SAAS;IAiBvB,wBAAwB;IACxB,OAAO,CAAC,YAAY;IAUpB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IASxB,sBAAsB;IACtB,OAAO,CAAC,SAAS;IAcjB,+BAA+B;YACjB,aAAa;IA0B3B,iBAAiB;IACjB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,SAAS;IA+CjB;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAwBvD;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAS5D,2BAA2B;IAC3B,WAAW,IAAI,OAAO;IAItB,sBAAsB;IACtB,IAAI,IAAI,MAAM;IAId,6BAA6B;IAC7B,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IAWtH,iCAAiC;IAC3B,OAAO,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAIxE;AAMD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD;AAED,eAAe;AACf,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAED,yBAAyB;AACzB,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE9E"}