@lingxiao-office/sdk 1.0.0

package/dist/llm/Client.js

@@ -0,0 +1,174 @@
+import { config as _cachedConfig, getConfigValue, } from '../config.js';
+import { getModelManager } from '../config/ModelManager.js';
+import { applyLocalVisionFallback } from './local_vision_fallback.js';
+import { normalizeImageRetainRounds, rehydrateRecentImageBlobRefs } from './image_blob_store.js';
+import { createContentGenerator } from './ContentGenerator.js';
+import { rebuildSharedFetch } from './http_dispatcher.js';
+/**
+ * LLMClientManager v4 — 实现 ContentGenerator 接口
+ *
+ * 解析规则（简洁无歧义）：
+ * 1. 传入 modelId → ModelManager.getModelByIdStrict(modelId) → 用 model.apiKey + model.baseUrl
+ * 2. 找不到 → 抛出 ModelNotFoundError（明确提示用户配置）
+ * 3. 不再有全局 provider 凭据/地址回退
+ *
+ * 热更新：model_providers 里的 envKey 每次调用时重新 resolve（ModelManager 实时读 credentials）。
+ */
+export class LLMClientManager {
+    provider;
+    generator;
+    runtimeConfig;
+    modelId;
+    modelConfig;
+    constructor(modelOrProvider) {
+        this.runtimeConfig = _cachedConfig;
+        // 确定 modelId
+        const modelId = (!modelOrProvider || modelOrProvider === 'auto' || modelOrProvider === 'openai' || modelOrProvider === 'anthropic')
+            ? (this.runtimeConfig.llm.leader_model || '')
+            : modelOrProvider;
+        this.modelId = modelId;
+        if (!modelId) {
+            throw new Error('未配置 leader_model。请在 settings.json 中设置 llm.leader_model，' +
+                '并确保 llm.model_providers 中存在对应的模型条目。');
+        }
+        // 严格查找，找不到抛 ModelNotFoundError
+        this.modelConfig = getModelManager().getModelByIdStrict(modelId);
+        this.provider = this.modelConfig.provider;
+        this.generator = this.createGenerator();
+    }
+    createGenerator() {
+        if (!this.modelConfig.apiKey) {
+            throw new Error(`模型 '${this.modelId}' 的 apiKey 为空。` +
+                ` 请检查 credentials 中是否存在对应的 envKey，或直接在 model_providers 中配置 apiKey。`);
+        }
+        const config = {
+            modelId: this.modelId,
+            apiModelName: this.modelConfig.model || this.modelId,
+            provider: this.provider,
+            apiKey: this.modelConfig.apiKey,
+            baseUrl: this.modelConfig.baseUrl,
+        };
+        return createContentGenerator(config);
+    }
+    /**
+     * 重新从 ModelManager 获取最新模型配置。
+     * 当 session 热切换模型时必须同步切换 provider/baseUrl/apiKey。
+     */
+    refreshModelConfig(model) {
+        const targetModelId = model || this.modelId;
+        const latest = getModelManager().getModelByIdStrict(targetModelId);
+        const latestProvider = latest.provider;
+        if (targetModelId !== this.modelId ||
+            latestProvider !== this.provider ||
+            latest.model !== this.modelConfig.model ||
+            latest.apiKey !== this.modelConfig.apiKey ||
+            latest.baseUrl !== this.modelConfig.baseUrl) {
+            this.modelId = targetModelId;
+            this.modelConfig = latest;
+            this.provider = latestProvider;
+            this.generator = this.createGenerator();
+        }
+    }
+    /**
+     * 解析实际发送给 API 的模型名。
+     */
+    resolveApiModelName(model) {
+        const targetModelId = model || this.modelId;
+        // 当前 modelConfig：优先 model（ModelProviderConfig），再 modelId（RuntimeModelSnapshot 真实模型名）。
+        if (targetModelId === this.modelId) {
+            const current = this.modelConfig;
+            if (current.model)
+                return current.model;
+            if (current.modelId)
+                return current.modelId;
+        }
+        const config = getModelManager().getModelByIdStrict(targetModelId);
+        // ModelProviderConfig 用 model 字段；RuntimeModelSnapshot 用 modelId 存实际发送给 API 的模型名。
+        if (config.model)
+            return config.model;
+        if (config.modelId)
+            return config.modelId;
+        return targetModelId;
+    }
+    getModelId() {
+        return this.modelId;
+    }
+    imageHistoryRetainRounds() {
+        const configured = Number(getConfigValue('advanced.image_history_retain_rounds'));
+        return normalizeImageRetainRounds(configured);
+    }
+    // ─── ContentGenerator 接口实现 ─────────────────────────────────────────
+    async generateContent(params) {
+        this.refreshModelConfig(params.model);
+        const apiModelName = this.resolveApiModelName(params.model);
+        const rehydratedMessages = await rehydrateRecentImageBlobRefs(params.messages, this.imageHistoryRetainRounds());
+        const preparedMessages = await applyLocalVisionFallback(rehydratedMessages, apiModelName);
+        return this.generator.generateContent({ ...params, messages: preparedMessages, model: apiModelName });
+    }
+    async *generateContentStream(params, callbacks) {
+        this.refreshModelConfig(params.model);
+        const apiModelName = this.resolveApiModelName(params.model);
+        const rehydratedMessages = await rehydrateRecentImageBlobRefs(params.messages, this.imageHistoryRetainRounds());
+        const preparedMessages = await applyLocalVisionFallback(rehydratedMessages, apiModelName, callbacks?.onProgress);
+        return yield* this.generator.generateContentStream({ ...params, messages: preparedMessages, model: apiModelName }, callbacks);
+    }
+    async generateContentWithCallbacks(params, callbacks) {
+        this.refreshModelConfig(params.model);
+        const apiModelName = this.resolveApiModelName(params.model);
+        const rehydratedMessages = await rehydrateRecentImageBlobRefs(params.messages, this.imageHistoryRetainRounds());
+        const preparedMessages = await applyLocalVisionFallback(rehydratedMessages, apiModelName, callbacks?.onProgress);
+        return this.generator.generateContentWithCallbacks({ ...params, messages: preparedMessages, model: apiModelName }, callbacks);
+    }
+    async countTokens(params) {
+        return this.generator.countTokens(params);
+    }
+    async close() {
+        await this.generator.close();
+    }
+    async warmup() {
+        await this.generator.warmup?.();
+    }
+    /**
+     * 强制丢弃当前 generator + 共享 HTTP dispatcher，下一次调用重建。
+     * 配合 LlmGuard 在 request_timeout / network_error 等强信号下使用，
+     * 避免 keep-alive 半开 socket 把 leader 长时间钉死。
+     *
+     * **顺序很重要**：必须先 rebuildSharedFetch() 销毁旧 undici Agent，再 createGenerator()
+     * 让新 SDK client 在构造时拿到新的 fetch；否则新 client 会捕获旧的 _cachedCustomFetch
+     * 引用，继续走那个已经半死的 socket 池 — 那是用户报"recycle 没效果，5 次都同样错"
+     * 的根因。
+     */
+    recycle() {
+        // 1) 释放当前 generator 内部 SDK client（best-effort）
+        try {
+            this.generator.recycle?.();
+        }
+        catch { /* tolerate */ }
+        // 2) 同步销毁旧 undici Agent + 清缓存：下次 getSharedFetch() 一定构造新 dispatcher
+        try {
+            rebuildSharedFetch();
+        }
+        catch { /* tolerate */ }
+        // 3) 重建 generator —— 此时 getSharedFetch() 会返回新 dispatcher 上的 fetch，
+        //    新 SDK client 在构造时捕获新 fetch 引用，彻底切断旧 socket 池
+        try {
+            this.generator = this.createGenerator();
+        }
+        catch { /* tolerate — 下次 generateContent 时 refreshModelConfig 还会再试 */ }
+    }
+    getProviderKey(model) {
+        this.refreshModelConfig(model);
+        return this.generator.getProviderKey?.(model) ?? null;
+    }
+}
+/**
+ * 创建 ContentGenerator 实例（同步工厂）。
+ *
+ * 从 ModelManager 解析模型配置，返回实现 ContentGenerator 接口的 LLMClientManager。
+ * 这是所有上层代码获取 LLM 客户端的唯一入口。
+ */
+export function createLLMClient(modelOrProvider) {
+    return new LLMClientManager(modelOrProvider);
+}
+export default LLMClientManager;
+//# sourceMappingURL=Client.js.map

package/dist/llm/Client.js.map

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

package/dist/llm/ContentGenerationPipeline.d.ts

@@ -0,0 +1,104 @@
+/**
+ * ContentGenerationPipeline — provider-stream 共享工具
+ *
+ * Anthropic / OpenAI 两个 ContentGenerator 的流式实现差异主要在
+ *   - 协议事件类型（Anthropic: content_block_start/_delta/_stop；OpenAI: choices[].delta）
+ *   - thinking 表示形态（Anthropic: 多个 ThinkingBlock；OpenAI: reasoning_content 字符串）
+ * 但**生命周期外壳**完全一致：
+ *   1. 创建 heartbeat + parser
+ *   2. 每个 chunk 入口 heartbeat reset
+ *   3. 流末 parser.finalize() + 截断软标志
+ *   4. 把 CompletedToolCall 映射成 ToolCall
+ *   5. 异常路径 classifyLLMError + yield error + throw
+ *
+ * 2026-05-27：删除应用层 stream timeout（chunk-idle / first-token guard）。
+ * 之前我们自己叠了一层心跳超时，120s 没收到 chunk 就 abort，导致 thinking
+ * 模型偶发 ~107s 卡顿被误判失败、刷出大量 retry 死循环。现在让 SDK 的
+ * `timeout`（默认 600s 与 OpenAI/Anthropic SDK 默认对齐）作为唯一权威
+ * socket-level 兜底；其它情况严格依赖 API 信号。
+ */
+import type { ToolCall, StreamCallbacks } from './types.js';
+import { StreamingToolCallParser } from './StreamingToolCallParser.js';
+import { type HeartbeatTimer } from './provider_runtime.js';
+import { type LLMError } from './errors.js';
+/**
+ * Provider-stream 运行时：parser + heartbeat 一次性打包，
+ * caller 通过 tickAtChunk() 在每个 chunk 入口刷新 UI 心跳，finishStream() 结束清理。
+ */
+export interface ProviderStreamRuntime {
+    /** 工具调用流式拼接器，由 caller 在 chunk 处理中 appendChunk，流末在 finalizeProviderStream 中 finalize */
+    readonly parser: StreamingToolCallParser;
+    /** UI 心跳进度回调器 */
+    readonly heartbeat: HeartbeatTimer;
+    /** 在每个 stream chunk 处理之前调用：刷新 UI 心跳进度 */
+    tickAtChunk(): void;
+    /** 在所有 chunk 处理完毕、进入 finalize 之前调用：清 heartbeat */
+    finishStream(): void;
+}
+export interface CreateProviderStreamRuntimeOptions {
+    /**
+     * 该模型是否支持 thinking。当前仅作为信息字段保留，应用层不再据此设置首 token 超时；
+     * SDK 自身的 request timeout 是唯一权威。
+     */
+    supportsThinking: boolean;
+    /** 透传给 heartbeat 的 callbacks，用于 UI 进度反馈 */
+    callbacks?: StreamCallbacks;
+}
+export declare function createProviderStreamRuntime(options: CreateProviderStreamRuntimeOptions): ProviderStreamRuntime;
+/**
+ * finalizeProviderStream 输入：caller 在流末把已聚集的 fullContent / thinking
+ * 是否非空 / finishReason / usage 等汇总传入。
+ */
+export interface FinalizeProviderStreamInput {
+    runtime: ProviderStreamRuntime;
+    provider: 'anthropic' | 'openai';
+    model: string;
+    /** 当前流期间累计的纯文本（用于 hasUsefulPayload 判断） */
+    fullContent: string;
+    /**
+     * 当前流是否产出过 thinking。
+     * Anthropic 传 thinkingBlocks.length > 0；
+     * OpenAI 传 reasoningContent.trim().length > 0。
+     */
+    hasThinking: boolean;
+    /**
+     * 该 provider 表示"输出被截断"的 finish_reason 字面量值。
+     * Anthropic = 'max_tokens'；OpenAI = 'length'。
+     * 用于把权威截断信号提升为 was_output_truncated。
+     */
+    truncationFinishReason: string;
+    finishReason: string | undefined;
+}
+export interface FinalizeProviderStreamOutput {
+    /** 流末汇总后的 ToolCall 数组（已补齐 id） */
+    toolCalls: ToolCall[];
+    /** parser 状态机判断"流末仍未闭合"，作为兜底软标志 */
+    wasIncompleteAtFinalize: boolean;
+    /** ChatResponse.was_output_truncated 应取的值（finish_reason 截断 || finalize 不完整） */
+    wasOutputTruncated: boolean;
+}
+/**
+ * 流末通用收尾：runtime.finishStream → parser.finalize → toolCalls 生成 →
+ * was_output_truncated 计算。
+ *
+ * 关键规则（P0 #5/#6）：
+ *   - 截断不再 throw parse_error。`hasIncompleteToolCalls()` 仅作为软标志，
+ *     上抛 was_output_truncated=true，让 ToolCallSafety 兜底拒掉文件编辑类工具，
+ *     其它工具仍照常执行。
+ *   - 空流不在此处抛错；caller（OpenAI/Anthropic generator）在自己的流末
+ *     做空流检测并抛 network_error，由 LlmGuard recycle 旧 socket 后重发。
+ *
+ * 不在此 helper 内 yield 任何 StreamEvent —— 由 caller 顺序调用 onToolCall +
+ * yield，保留对协议特异 thinking 提取的插入点。
+ */
+export declare function finalizeProviderStream(input: FinalizeProviderStreamInput): FinalizeProviderStreamOutput;
+/**
+ * Provider-stream 异常包装：当 chunk 循环或 finalize 抛错时统一处理：
+ *   1. 关闭 runtime 的 guard / heartbeat（避免泄漏定时器）
+ *   2. classifyLLMError 标准化错误形态
+ *
+ * 注意：caller 仍需自己 yield { type: 'error', error } + throw，
+ * 因为 yield 必须在 generator 内部，不能跨 helper 边界。
+ */
+export declare function classifyProviderStreamError(error: unknown, runtime: ProviderStreamRuntime, provider: 'anthropic' | 'openai', model: string): LLMError;
+//# sourceMappingURL=ContentGenerationPipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentGenerationPipeline.d.ts","sourceRoot":"","sources":["../../src/llm/ContentGenerationPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,yCAAyC;IACzC,WAAW,IAAI,IAAI,CAAC;IACpB,kDAAkD;IAClD,YAAY,IAAI,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,qBAAqB,CAiBvB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC3C,iCAAiC;IACjC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,mCAAmC;IACnC,uBAAuB,EAAE,OAAO,CAAC;IACjC,+EAA+E;IAC/E,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,4BAA4B,CAsB9B;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,WAAW,GAAG,QAAQ,EAChC,KAAK,EAAE,MAAM,GACZ,QAAQ,CAGV"}

package/dist/llm/ContentGenerationPipeline.js

@@ -0,0 +1,85 @@
+/**
+ * ContentGenerationPipeline — provider-stream 共享工具
+ *
+ * Anthropic / OpenAI 两个 ContentGenerator 的流式实现差异主要在
+ *   - 协议事件类型（Anthropic: content_block_start/_delta/_stop；OpenAI: choices[].delta）
+ *   - thinking 表示形态（Anthropic: 多个 ThinkingBlock；OpenAI: reasoning_content 字符串）
+ * 但**生命周期外壳**完全一致：
+ *   1. 创建 heartbeat + parser
+ *   2. 每个 chunk 入口 heartbeat reset
+ *   3. 流末 parser.finalize() + 截断软标志
+ *   4. 把 CompletedToolCall 映射成 ToolCall
+ *   5. 异常路径 classifyLLMError + yield error + throw
+ *
+ * 2026-05-27：删除应用层 stream timeout（chunk-idle / first-token guard）。
+ * 之前我们自己叠了一层心跳超时，120s 没收到 chunk 就 abort，导致 thinking
+ * 模型偶发 ~107s 卡顿被误判失败、刷出大量 retry 死循环。现在让 SDK 的
+ * `timeout`（默认 600s 与 OpenAI/Anthropic SDK 默认对齐）作为唯一权威
+ * socket-level 兜底；其它情况严格依赖 API 信号。
+ */
+import { StreamingToolCallParser } from './StreamingToolCallParser.js';
+import { createHeartbeatTimerWithReset, } from './provider_runtime.js';
+import { classifyLLMError } from './errors.js';
+export function createProviderStreamRuntime(options) {
+    // supportsThinking 当前仅保留语义；不再用于首 token 超时。读一下避免 noUnusedLocals。
+    void options.supportsThinking;
+    const heartbeat = createHeartbeatTimerWithReset({ onProgress: options.callbacks?.onProgress });
+    const heartbeatHelpers = heartbeat.helpers();
+    const parser = new StreamingToolCallParser();
+    return {
+        parser,
+        heartbeat,
+        tickAtChunk() {
+            heartbeatHelpers.onText?.();
+        },
+        finishStream() {
+            heartbeat.clear();
+        },
+    };
+}
+/**
+ * 流末通用收尾：runtime.finishStream → parser.finalize → toolCalls 生成 →
+ * was_output_truncated 计算。
+ *
+ * 关键规则（P0 #5/#6）：
+ *   - 截断不再 throw parse_error。`hasIncompleteToolCalls()` 仅作为软标志，
+ *     上抛 was_output_truncated=true，让 ToolCallSafety 兜底拒掉文件编辑类工具，
+ *     其它工具仍照常执行。
+ *   - 空流不在此处抛错；caller（OpenAI/Anthropic generator）在自己的流末
+ *     做空流检测并抛 network_error，由 LlmGuard recycle 旧 socket 后重发。
+ *
+ * 不在此 helper 内 yield 任何 StreamEvent —— 由 caller 顺序调用 onToolCall +
+ * yield，保留对协议特异 thinking 提取的插入点。
+ */
+export function finalizeProviderStream(input) {
+    const { runtime, truncationFinishReason, finishReason } = input;
+    const completedToolCalls = runtime.parser.finalize();
+    const wasIncompleteAtFinalize = runtime.parser.hasIncompleteToolCalls();
+    runtime.finishStream();
+    const toolCalls = completedToolCalls.map((tc) => ({
+        id: tc.id || `call_${tc.index}_${Date.now()}`,
+        type: 'function',
+        function: {
+            name: tc.name || '',
+            arguments: tc.malformed ? (tc.rawArguments || '') : JSON.stringify(tc.args),
+        },
+    }));
+    return {
+        toolCalls,
+        wasIncompleteAtFinalize,
+        wasOutputTruncated: finishReason === truncationFinishReason || wasIncompleteAtFinalize,
+    };
+}
+/**
+ * Provider-stream 异常包装：当 chunk 循环或 finalize 抛错时统一处理：
+ *   1. 关闭 runtime 的 guard / heartbeat（避免泄漏定时器）
+ *   2. classifyLLMError 标准化错误形态
+ *
+ * 注意：caller 仍需自己 yield { type: 'error', error } + throw，
+ * 因为 yield 必须在 generator 内部，不能跨 helper 边界。
+ */
+export function classifyProviderStreamError(error, runtime, provider, model) {
+    runtime.finishStream();
+    return classifyLLMError(error, { provider, model });
+}
+//# sourceMappingURL=ContentGenerationPipeline.js.map

package/dist/llm/ContentGenerationPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentGenerationPipeline.js","sourceRoot":"","sources":["../../src/llm/ContentGenerationPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,6BAA6B,GAE9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AA2B9D,MAAM,UAAU,2BAA2B,CACzC,OAA2C;IAE3C,gEAAgE;IAChE,KAAK,OAAO,CAAC,gBAAgB,CAAC;IAC9B,MAAM,SAAS,GAAG,6BAA6B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/F,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE7C,OAAO;QACL,MAAM;QACN,SAAS;QACT,WAAW;YACT,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,CAAC;QACD,YAAY;YACV,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAoCD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAkC;IAElC,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAEhE,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrD,MAAM,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;IAExE,OAAO,CAAC,YAAY,EAAE,CAAC;IAEvB,MAAM,SAAS,GAAe,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5D,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QAC7C,IAAI,EAAE,UAAmB;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE;YACnB,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC;SAC5E;KACF,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,SAAS;QACT,uBAAuB;QACvB,kBAAkB,EAAE,YAAY,KAAK,sBAAsB,IAAI,uBAAuB;KACvF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,OAA8B,EAC9B,QAAgC,EAChC,KAAa;IAEb,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,OAAO,gBAAgB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/llm/ContentGenerator.d.ts

@@ -0,0 +1,137 @@
+/**
+ * ContentGenerator 统一抽象层
+ *
+ * 参考 qwen-code contentGenerator.ts 设计，为 lingxiao 提供统一的 LLM 内容生成接口。
+ * 所有 provider（OpenAI/Anthropic/未来扩展）都实现此接口，上层调用者无需关心底层差异。
+ *
+ * 架构：
+ *   ContentGenerator (接口)
+ *     ├─ OpenAIContentGenerator (实现)
+ *     ├─ AnthropicContentGenerator (实现)
+ *     └─ LoggingContentGenerator (装饰器，包装任意实现)
+ */
+import type { ChatMessage, ChatResponse, StreamCallbacks, ToolDefinition, TokenUsage } from './types.js';
+export interface GenerateContentParams {
+    messages: ChatMessage[];
+    model: string;
+    tools?: ToolDefinition[];
+    signal?: AbortSignal;
+    /** 覆盖默认 max_tokens */
+    maxTokens?: number;
+    /** 采样参数覆盖 */
+    sampling?: {
+        temperature?: number;
+        top_p?: number;
+    };
+}
+export type StreamEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'thinking';
+    text: string;
+} | {
+    type: 'tool_call';
+    toolCall: import('./types.js').ToolCall;
+} | {
+    type: 'tool_call_delta';
+    delta: import('./types.js').ToolCallDeltaInfo;
+} | {
+    type: 'usage';
+    usage: TokenUsage;
+} | {
+    type: 'finish';
+    finishReason: string;
+} | {
+    type: 'error';
+    error: Error;
+};
+export interface CountTokensParams {
+    messages: ChatMessage[];
+    model: string;
+    tools?: ToolDefinition[];
+}
+export interface CountTokensResult {
+    totalTokens: number;
+    /** 各消息的 token 数（可选，用于压缩决策） */
+    perMessage?: number[];
+}
+export interface ContentGenerator {
+    /**
+     * 非流式生成（一次性返回完整结果）
+     */
+    generateContent(params: GenerateContentParams): Promise<ChatResponse>;
+    /**
+     * 流式生成（返回 AsyncGenerator，逐 chunk 产出事件）
+     *
+     * 调用者可通过 for-await-of 消费，也可传入 callbacks 接收聚合事件。
+     * 两种消费方式互不冲突：callbacks 在 generator 内部触发，
+     * yield 的事件供上层做更精细的控制（如 retry rollback）。
+     */
+    generateContentStream(params: GenerateContentParams, callbacks?: StreamCallbacks): AsyncGenerator<StreamEvent, ChatResponse, undefined>;
+    /**
+     * 便捷方法：流式生成 + 自动消费 generator + 触发 callbacks + 返回最终结果。
+     *
+     * 内部调用 generateContentStream 并 for-await-of 消费，最终返回 ChatResponse。
+     */
+    generateContentWithCallbacks(params: GenerateContentParams, callbacks?: StreamCallbacks): Promise<ChatResponse>;
+    /**
+     * Token 计数（用于上下文压缩决策）
+     */
+    countTokens(params: CountTokensParams): Promise<CountTokensResult>;
+    /**
+     * 释放资源（连接池等）
+     */
+    close(): Promise<void>;
+    /**
+     * 强制回收并重建底层 SDK 客户端。
+     *
+     * 长跑场景下偶发 provider socket 半开 / keep-alive 死连接 — 单纯重试无法救活，
+     * 必须丢弃旧 client + dispatcher。此方法应该：
+     *   1. 重新构造底层 OpenAI/Anthropic SDK 实例
+     *   2. 触发 http_dispatcher.rebuildSharedFetch()（由 caller 视情况调）
+     * 装饰器（Logging/Caching/Client）应转发给内部 generator。
+     *
+     * 实现要保证幂等 + 安全：调用时不应抛出。
+     */
+    recycle?(): void;
+    /**
+     * 预热连接
+     */
+    warmup?(): Promise<void>;
+    /**
+     * 返回 Provider key（baseUrl::model），供 CircuitBreaker 跨流式/非流式路径共享熔断状态。
+     * 装饰器（Caching/Logging/Client）应转发给内部 generator。
+     */
+    getProviderKey?(model: string): string | null;
+}
+export interface ContentGeneratorConfig {
+    /** 模型 ID（配置中的标识符） */
+    modelId: string;
+    /** 实际发送给 API 的模型名 */
+    apiModelName: string;
+    /** Provider 类型 */
+    provider: 'openai' | 'anthropic';
+    /** API Key */
+    apiKey: string;
+    /** Base URL */
+    baseUrl: string;
+    /** 强制使用 Vercel AI SDK 统一实现（也可通过 LINGXIAO_USE_VERCEL_AI=1 环境变量启用） */
+    useVercelAI?: boolean;
+}
+/**
+ * 同步创建 ContentGenerator 实例。
+ *
+ * 根据 provider 类型创建对应实现，并用 LoggingContentGenerator 包装。
+ * 这是上层代码获取 ContentGenerator 的唯一入口。
+ *
+ * Feature flag: 设置 LINGXIAO_USE_VERCEL_AI=1 或 config.useVercelAI=true
+ * 使用 Vercel AI SDK 统一实现（支持 OpenAI/Anthropic/Google/Bedrock/custom）。
+ */
+export declare function createContentGenerator(config: ContentGeneratorConfig): ContentGenerator;
+/**
+ * 消费 AsyncGenerator 并返回最终 ChatResponse。
+ * 供各实现类的 generateContentWithCallbacks 复用。
+ */
+export declare function consumeGeneratorToResponse(generator: AsyncGenerator<StreamEvent, ChatResponse, undefined>): Promise<ChatResponse>;
+//# sourceMappingURL=ContentGenerator.d.ts.map

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

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

package/dist/llm/ContentGenerator.js

@@ -0,0 +1,49 @@
+/**
+ * ContentGenerator 统一抽象层
+ *
+ * 参考 qwen-code contentGenerator.ts 设计，为 lingxiao 提供统一的 LLM 内容生成接口。
+ * 所有 provider（OpenAI/Anthropic/未来扩展）都实现此接口，上层调用者无需关心底层差异。
+ *
+ * 架构：
+ *   ContentGenerator (接口)
+ *     ├─ OpenAIContentGenerator (实现)
+ *     ├─ AnthropicContentGenerator (实现)
+ *     └─ LoggingContentGenerator (装饰器，包装任意实现)
+ */
+// ─── 工厂函数 ────────────────────────────────────────────────────────────────
+import { OpenAIContentGenerator } from './OpenAIContentGenerator.js';
+import { AnthropicContentGenerator } from './AnthropicContentGenerator.js';
+import { LoggingContentGenerator } from './LoggingContentGenerator.js';
+import { VercelAIContentGenerator } from './VercelAIContentGenerator.js';
+/**
+ * 同步创建 ContentGenerator 实例。
+ *
+ * 根据 provider 类型创建对应实现，并用 LoggingContentGenerator 包装。
+ * 这是上层代码获取 ContentGenerator 的唯一入口。
+ *
+ * Feature flag: 设置 LINGXIAO_USE_VERCEL_AI=1 或 config.useVercelAI=true
+ * 使用 Vercel AI SDK 统一实现（支持 OpenAI/Anthropic/Google/Bedrock/custom）。
+ */
+export function createContentGenerator(config) {
+    // Vercel AI SDK unified path (feature-flagged)
+    if (process.env.LINGXIAO_USE_VERCEL_AI === '1' || config.useVercelAI) {
+        return new LoggingContentGenerator(new VercelAIContentGenerator(config), config);
+    }
+    const generator = config.provider === 'anthropic'
+        ? new AnthropicContentGenerator(config)
+        : new OpenAIContentGenerator(config);
+    return new LoggingContentGenerator(generator, config);
+}
+// ─── 默认实现辅助：消费 generator 返回 ChatResponse ─────────────────────────
+/**
+ * 消费 AsyncGenerator 并返回最终 ChatResponse。
+ * 供各实现类的 generateContentWithCallbacks 复用。
+ */
+export async function consumeGeneratorToResponse(generator) {
+    let result;
+    while (!(result = await generator.next()).done) {
+        // events already dispatched via callbacks inside the generator
+    }
+    return result.value;
+}
+//# sourceMappingURL=ContentGenerator.js.map

package/dist/llm/ContentGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentGenerator.js","sourceRoot":"","sources":["../../src/llm/ContentGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqIH,4EAA4E;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA8B;IAE9B,+CAA+C;IAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACrE,OAAO,IAAI,uBAAuB,CAAC,IAAI,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,SAAS,GACb,MAAM,CAAC,QAAQ,KAAK,WAAW;QAC7B,CAAC,CAAC,IAAI,yBAAyB,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO,IAAI,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,oEAAoE;AAEpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAA+D;IAE/D,IAAI,MAAiD,CAAC;IACtD,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,+DAA+D;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}