@lingxiao-office/sdk 1.0.0

package/dist/llm/StreamingToolCallParser.js

@@ -0,0 +1,294 @@
+/**
+ * StreamingToolCallParser - 流式工具调用健壮解析器
+ *
+ * 基于 qwen-code 的 StreamingToolCallParser 实现，解决流式工具调用中的 JSON 碎片化问题。
+ *
+ * 处理的问题：
+ * - 工具调用以不同 chunk 形状到达（空字符串、部分 JSON、完整对象）
+ * - 工具调用可能缺少 ID、name，或有不一致的 index
+ * - 多个工具调用可同时处理交错 chunk
+ * - index 冲突（同一 index 被不同 tool call 重用）
+ * - JSON 参数跨多个 chunk 碎片化，需要重建
+ *
+ * 参考：/root/lingxiao/qwen-code/packages/core/src/core/openaiContentGenerator/streamingToolCallParser.ts
+ */
+export class StreamingToolCallParser {
+    /** 每个 tool call index 的累积 JSON buffer */
+    buffers = new Map();
+    /** 每个 tool call index 的 JSON 嵌套深度 */
+    depths = new Map();
+    /** 每个 tool call index 是否在字符串字面量内 */
+    inStrings = new Map();
+    /** 每个 tool call index 下一个字符是否应视为转义 */
+    escapes = new Map();
+    /** 每个 tool call index 的元数据（id, name） */
+    toolCallMeta = new Map();
+    /** tool call ID → 实际 index 映射（用于冲突检测） */
+    idToIndexMap = new Map();
+    /** 用于生成新 index 的计数器 */
+    nextAvailableIndex = 0;
+    /**
+     * 流式期间纯拼接入口（热路径）。
+     *
+     * 不逐字符跑 depth/inString/escape 状态机，不尝试 JSON.parse；
+     * 仅维护 ID→index 单调映射 + buffer 拼接 + 元数据。
+     *
+     * 这样大入参（80KB 大型工具调用等）流式期间从 O(N²) 的 JSON.parse 累积
+     * 退化为 O(N) 字符串拼接；最终 parse 在 finalize() 一次性完成。
+     *
+     * ID 冲突策略简化：首次见到 id 分配 nextAvailableIndex；重复 id 复用映射。
+     * OpenAI 流式实际不会复用 index（每个 tool_call.index 唯一），即便残留拼接，
+     * finalize() 的 4 级 fallback 仍能修复。
+     */
+    appendChunk(index, chunk, id, name) {
+        let actualIndex = index;
+        if (id) {
+            const mapped = this.idToIndexMap.get(id);
+            if (mapped !== undefined) {
+                actualIndex = mapped;
+            }
+            else {
+                // 新 id：若 index 已被其他完成 buffer 占用，分配新 index
+                if (this.buffers.has(index)) {
+                    const existingMeta = this.toolCallMeta.get(index);
+                    if (existingMeta?.id && existingMeta.id !== id) {
+                        actualIndex = this.findNextAvailableIndex();
+                    }
+                }
+                this.idToIndexMap.set(id, actualIndex);
+            }
+        }
+        if (!this.buffers.has(actualIndex)) {
+            this.buffers.set(actualIndex, '');
+            this.depths.set(actualIndex, 0);
+            this.inStrings.set(actualIndex, false);
+            this.escapes.set(actualIndex, false);
+            this.toolCallMeta.set(actualIndex, {});
+        }
+        const meta = this.toolCallMeta.get(actualIndex);
+        if (id)
+            meta.id = id;
+        if (name)
+            meta.name = name;
+        if (chunk) {
+            this.buffers.set(actualIndex, this.buffers.get(actualIndex) + chunk);
+        }
+        return { actualIndex };
+    }
+    /**
+     * 流末扫描：把 appendChunk 拼好的 buffer 一次性跑状态机，重算 depth/inString/escape。
+     *
+     * 状态机可交换性：对完整字符串扫描 = 对若干分片连续扫描，结果等价。
+     * 这一步是 finalize() / hasIncompleteAfterFinalize() 的前置。
+     */
+    finalizeStates() {
+        for (const [index, buffer] of this.buffers.entries()) {
+            let depth = 0;
+            let inString = false;
+            let escape = false;
+            for (const char of buffer) {
+                if (!inString) {
+                    if (char === '{' || char === '[')
+                        depth++;
+                    else if (char === '}' || char === ']')
+                        depth--;
+                }
+                if (char === '"' && !escape) {
+                    inString = !inString;
+                }
+                escape = char === '\\' && !escape;
+            }
+            this.depths.set(index, depth);
+            this.inStrings.set(index, inString);
+            this.escapes.set(index, escape);
+        }
+    }
+    /**
+     * 流末一次性产出所有完成的工具调用。
+     *
+     * 行为：先把所有 buffer 跑完状态机 → 再走 getCompletedToolCalls 的 4 级 fallback。
+     */
+    finalize() {
+        this.finalizeStates();
+        return this.getCompletedToolCalls();
+    }
+    /**
+     * 流末截断检测。
+     *
+     * 与 hasIncompleteToolCalls 等价，区别仅在前置一次 finalizeStates 把状态扫到位。
+     */
+    hasIncompleteAfterFinalize() {
+        this.finalizeStates();
+        return this.hasIncompleteToolCalls();
+    }
+    /**
+     * 获取指定 index 的工具调用元数据
+     */
+    getToolCallMeta(index) {
+        return this.toolCallMeta.get(index) || {};
+    }
+    /**
+     * 获取所有已完成的工具调用
+     *
+     * 在流式结束时调用，尝试解析累积的 buffer。
+     */
+    getCompletedToolCalls() {
+        const completed = [];
+        for (const [index, buffer] of this.buffers.entries()) {
+            const meta = this.toolCallMeta.get(index);
+            if (!meta?.name)
+                continue;
+            // 零参函数：name 存在但 buffer 为空 → 可能是合法无参调用（如 get_current_time()），
+            // 也可能是 arguments streaming chunks 丢失/截断导致 buffer 为空。
+            // 标记 emptyArgs=true 让上层决策：若 tool schema 有 required params 应视为截断。
+            if (!buffer.trim()) {
+                completed.push({
+                    id: meta.id,
+                    name: meta.name,
+                    args: {},
+                    index,
+                    emptyArgs: true,
+                });
+                continue;
+            }
+            let args = {};
+            let parseError;
+            let malformed = false;
+            try {
+                args = JSON.parse(buffer);
+            }
+            catch (error) { /* expected: incomplete JSON from streaming — apply repair strategy */
+                parseError = error instanceof Error ? error.message : String(error);
+                // 多级修复策略
+                const inString = this.inStrings.get(index) || false;
+                const depth = this.depths.get(index) || 0;
+                if (inString) {
+                    // 截断在字符串值内部：逐级尝试闭合
+                    // 1. 闭合字符串
+                    try {
+                        args = JSON.parse(buffer + '"');
+                    }
+                    catch { /* expected: need deeper closure */
+                        // 2. 闭合字符串 + 补齐所有未闭合括号
+                        let suffix = '"';
+                        for (let i = 0; i < depth; i++)
+                            suffix += '}';
+                        try {
+                            args = JSON.parse(buffer + suffix);
+                        }
+                        catch { /* expected: use safeJsonParse fallback */
+                            // 3. 最终 fallback
+                            const repaired = this.safeJsonParse(buffer, index, undefined);
+                            if (repaired == null)
+                                malformed = true;
+                            else
+                                args = repaired;
+                        }
+                    }
+                }
+                else {
+                    const repaired = this.safeJsonParse(buffer, index, undefined);
+                    if (repaired == null)
+                        malformed = true;
+                    else
+                        args = repaired;
+                }
+            }
+            completed.push({
+                id: meta.id,
+                name: meta.name,
+                args,
+                index,
+                rawArguments: buffer,
+                parseError,
+                malformed,
+            });
+        }
+        return completed;
+    }
+    /**
+     * 检查是否有任何未完成的工具调用
+     *
+     * 用于检测流式截断：如果流式结束时仍有未完成的 tool call，
+     * 说明输出被截断，应触发重试。
+     */
+    hasIncompleteToolCalls() {
+        for (const [index] of this.buffers.entries()) {
+            const meta = this.toolCallMeta.get(index);
+            if (!meta?.name)
+                continue;
+            const depth = this.depths.get(index) || 0;
+            const inString = this.inStrings.get(index) || false;
+            if (depth > 0 || inString) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 查找下一个可用的 index
+     */
+    findNextAvailableIndex() {
+        while (this.buffers.has(this.nextAvailableIndex)) {
+            const buffer = this.buffers.get(this.nextAvailableIndex);
+            const depth = this.depths.get(this.nextAvailableIndex);
+            const meta = this.toolCallMeta.get(this.nextAvailableIndex);
+            if (!buffer.trim() || depth > 0 || !meta?.id) {
+                return this.nextAvailableIndex;
+            }
+            try {
+                JSON.parse(buffer);
+                if (depth === 0) {
+                    this.nextAvailableIndex++;
+                    continue;
+                }
+            }
+            catch { /* expected: buffer is still incomplete */
+                return this.nextAvailableIndex;
+            }
+            this.nextAvailableIndex++;
+        }
+        return this.nextAvailableIndex++;
+    }
+    /**
+     * 安全的 JSON 解析（降级策略）
+     * 使用 finalizeStates() 已跟踪的精确 depth 而非 regex counting（regex 会误匹配字符串字面量内的括号）
+     */
+    safeJsonParse(text, index, fallback) {
+        try {
+            const trimmed = text.trim();
+            if (!trimmed)
+                return fallback;
+            const depth = this.depths.get(index) || 0;
+            const inString = this.inStrings.get(index) || false;
+            let fixed = trimmed;
+            // 如果截断在字符串值内部，先闭合字符串
+            if (inString) {
+                fixed += '"';
+            }
+            // depth > 0 意味着有未闭合的 { 或 [，逐层补齐
+            for (let i = 0; i < depth; i++)
+                fixed += '}';
+            try {
+                return JSON.parse(fixed);
+            }
+            catch { /* expected: closing braces insufficient — try brackets */
+                // 如果补 } 失败，尝试补 ]（可能是数组未闭合）
+                if (depth > 0) {
+                    let altFixed = inString ? trimmed + '"' : trimmed;
+                    for (let i = 0; i < depth; i++)
+                        altFixed += ']';
+                    try {
+                        return JSON.parse(altFixed);
+                    }
+                    catch { /* fall through */ }
+                }
+                return fallback;
+            }
+        }
+        catch { /* expected: buffer completely unparseable */
+            return fallback;
+        }
+    }
+}
+//# sourceMappingURL=StreamingToolCallParser.js.map

package/dist/llm/StreamingToolCallParser.js.map

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

package/dist/llm/VercelAIContentGenerator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * VercelAIContentGenerator — Unified provider implementation via Vercel AI SDK v5
+ *
+ * Implements the ContentGenerator interface using the `ai` package, supporting
+ * 5+ providers (Anthropic, OpenAI, Google, Bedrock, custom) through a single
+ * code path. Activated via feature flag LINGXIAO_USE_VERCEL_AI=1.
+ *
+ * Key responsibilities:
+ * - Convert Lingxiao's ChatMessage[] to AI SDK ModelMessage[]
+ * - Convert Lingxiao ToolDefinition[] to AI SDK tool format
+ * - Map AI SDK streaming events (TextStreamPart) to Lingxiao StreamEvent
+ * - Handle thinking/reasoning blocks for Anthropic
+ * - Propagate abort signals and token usage
+ */
+import type { ContentGenerator, CountTokensParams, CountTokensResult, GenerateContentParams, StreamEvent } from './ContentGenerator.js';
+import type { ChatResponse, StreamCallbacks } from './types.js';
+import { type VercelAIProviderConfig } from './providers/index.js';
+export declare class VercelAIContentGenerator implements ContentGenerator {
+    private model;
+    private readonly config;
+    constructor(config: VercelAIProviderConfig);
+    /**
+     * 防漂移：推理/编排/判定调用默认采样温度 0(确定性解码)。
+     * 但 Anthropic extended thinking 经 Vercel SDK 转发时同样要求 temperature=1，
+     * thinking 开启时不得下发 temperature(保留 provider 默认)，否则 400。
+     * thinkingActive 三条件：模型支持 + 配置开启 + 本次实际会发 thinking 参数。
+     *
+     * A1 全局兜底：未显式指定 sampling.temperature 时也锁定确定性解码温度(默认 0)，
+     * 避免新调用点漏锁 sampling 静默走 provider 默认(~1.0)导致漂移。
+     */
+    private resolveTemperature;
+    generateContent(params: GenerateContentParams): Promise<ChatResponse>;
+    generateContentStream(params: GenerateContentParams, callbacks?: StreamCallbacks): AsyncGenerator<StreamEvent, ChatResponse, undefined>;
+    generateContentWithCallbacks(params: GenerateContentParams, callbacks?: StreamCallbacks): Promise<ChatResponse>;
+    countTokens(params: CountTokensParams): Promise<CountTokensResult>;
+    close(): Promise<void>;
+    recycle(): void;
+    getProviderKey(model: string): string | null;
+    /**
+     * Split system messages from conversation messages.
+     * AI SDK prefers system as a separate `system` param (first system message),
+     * though subsequent system messages must stay inline with allowSystemInMessages.
+     */
+    private splitSystemMessages;
+    private convertMessage;
+    private convertUserContent;
+    private convertAssistantContent;
+    /**
+     * Convert Lingxiao ToolDefinition[] to AI SDK tool format.
+     * AI SDK tools require an `inputSchema` (via jsonSchema helper) and optionally `execute`.
+     * We provide schema-only tools (no execute) since Lingxiao handles execution externally.
+     */
+    private convertTools;
+    /**
+     * Build provider-specific options (thinking/reasoning),复用 getThinkingParams 单一事实源。
+     *
+     * 与原生 AnthropicContentGenerator / OpenAIContentGenerator 路径对齐(消除漂移):
+     * enable_extended_thinking 默认 true + 家族兜底(claude/o系列/gpt-5),安装即开,
+     * 无需额外配置。映射到 Vercel AI SDK providerOptions 命名约定(camelCase):
+     *   - anthropic thinking_block → { anthropic: { thinking: { type, budgetTokens? } } }
+     *     (snake budget_tokens → camel budgetTokens;adaptive/enabled/disabled 三态透传)
+     *   - openai reasoning_effort → { openai: { reasoningEffort } }
+     */
+    private buildProviderOptions;
+    /**
+     * Convert generateText result to Lingxiao ChatResponse.
+     */
+    private buildChatResponse;
+    private convertUsage;
+}
+//# sourceMappingURL=VercelAIContentGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VercelAIContentGenerator.d.ts","sourceRoot":"","sources":["../../src/llm/VercelAIContentGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAEV,YAAY,EAEZ,eAAe,EAKhB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AASxF,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,MAAM,EAAE,sBAAsB;IAK1C;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAWpB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAqBpE,qBAAqB,CAC1B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC1B,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC;IA6LjD,4BAA4B,CAChC,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,YAAY,CAAC;IAGlB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,IAAI;IAKf,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM5C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,uBAAuB;IA+D/B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAepB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,YAAY;CAgBrB"}