@mingyuxu/ai 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @mingyuxu/ai
+
+doccheck-agent 的统一模型访问层，提供 OpenAI-compatible Provider、多轮工具调用、流式输出、调用预算、用量账本、超时和重试。
+
+通常不需要单独安装；使用 `vet` 请安装 [`doccheck-agent`](https://www.npmjs.com/package/doccheck-agent)。
+
+完整文档与源码：[doccheck-agent](https://github.com/Mingyu-Xu-98/doccheck-agent)

package/dist/budget.d.ts

@@ -0,0 +1,17 @@
+/** Budget 护栏 —— LLM 调用/token 硬顶。触顶 → 熔断（可 resume）。 */
+export declare class BudgetExceeded extends Error {
+    constructor(message: string);
+}
+export declare class Budget {
+    maxLlmCalls: number | null;
+    maxTokens: number | null;
+    private calls;
+    private tokens;
+    constructor(opts?: {
+        maxLlmCalls?: number | null;
+        maxTokens?: number | null;
+    });
+    charge(calls?: number, tokens?: number): void;
+    static fromSpec(budget: Record<string, number>): Budget;
+}
+//# sourceMappingURL=budget.d.ts.map

package/dist/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,MAAM;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;gBAEP,IAAI,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO;IAKjF,MAAM,CAAC,KAAK,SAAI,EAAE,MAAM,SAAI,GAAG,IAAI;IAWnC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;CAMxD"}

package/dist/budget.js

@@ -0,0 +1,34 @@
+/** Budget 护栏 —— LLM 调用/token 硬顶。触顶 → 熔断（可 resume）。 */
+export class BudgetExceeded extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BudgetExceeded";
+    }
+}
+export class Budget {
+    maxLlmCalls;
+    maxTokens;
+    calls = 0;
+    tokens = 0;
+    constructor(opts = {}) {
+        this.maxLlmCalls = opts.maxLlmCalls ?? null;
+        this.maxTokens = opts.maxTokens ?? null;
+    }
+    charge(calls = 0, tokens = 0) {
+        this.calls += calls;
+        this.tokens += tokens;
+        if (this.maxLlmCalls !== null && this.calls > this.maxLlmCalls) {
+            throw new BudgetExceeded(`LLM calls ${this.calls} > ${this.maxLlmCalls}`);
+        }
+        if (this.maxTokens !== null && this.tokens > this.maxTokens) {
+            throw new BudgetExceeded(`tokens ${this.tokens} > ${this.maxTokens}`);
+        }
+    }
+    static fromSpec(budget) {
+        return new Budget({
+            maxLlmCalls: budget.max_llm_calls_per_doc ?? null,
+            maxTokens: budget.max_tokens_per_run ?? null,
+        });
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,MAAM;IACjB,WAAW,CAAgB;IAC3B,SAAS,CAAgB;IACjB,KAAK,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,CAAC,CAAC;IAEnB,YAAY,OAAmE,EAAE;QAC/E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QACtB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/D,MAAM,IAAI,cAAc,CAAC,aAAa,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5D,MAAM,IAAI,cAAc,CAAC,UAAU,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,MAA8B;QAC5C,OAAO,IAAI,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC,qBAAqB,IAAI,IAAI;YACjD,SAAS,EAAE,MAAM,CAAC,kBAAkB,IAAI,IAAI;SAC7C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,46 @@
+import type { Message, ToolSchema, ToolCall, ChatResult } from "./providers/base.js";
+import { Ledger } from "./ledger.js";
+/** 7 条铁律 —— worker system 前缀，pack 只能追加不能削弱。 */
+export declare const IRON_RULES: string;
+export type LLMMode = "mock" | "real" | "dry";
+export interface LLMClientOptions {
+    mode?: LLMMode;
+    baseUrl?: string;
+    apiKey?: string;
+    model?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    ledger?: Ledger;
+    provider?: string;
+}
+export type MockFn = () => Record<string, unknown>;
+/** 测试可注入的 chat mock：按当前消息/工具返回本轮助手文本与工具调用。 */
+export type MockChatFn = (messages: Message[], tools: ToolSchema[]) => {
+    text?: string;
+    toolCalls?: ToolCall[];
+};
+export declare class LLMClient {
+    mode: LLMMode;
+    model: string;
+    ledger?: Ledger;
+    readonly providerName: string;
+    private timeoutMs;
+    private maxRetries;
+    private provider;
+    constructor(opts?: LLMClientOptions);
+    completeJson(system: string, user: string, mockFn?: MockFn): Promise<Record<string, unknown>>;
+    /**
+     * 多轮对话 + 原生 tool_calls（通用 agent 循环用）。
+     * real 走 provider.chat；mock 走注入的 mockFn（驱动确定性测试）；dry 返回空。
+     * onDelta 提供则请求流式（仅 real 生效）。
+     */
+    chat(messages: Message[], opts?: {
+        tools?: ToolSchema[];
+        onDelta?: (t: string) => void;
+        onNotice?: (m: string) => void;
+        mock?: MockChatFn;
+    }): Promise<ChatResult>;
+    private charge;
+}
+export declare function parseJsonLoose(text: string): Record<string, unknown>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,+CAA+C;AAC/C,eAAO,MAAM,UAAU,QAQL,CAAC;AAEnB,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAEjH,qBAAa,SAAS;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,IAAI,GAAE,gBAAqB;IAejC,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkBnC;;;;OAIG;IACG,IAAI,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,UAAU,CAAA;KAAO,GACpH,OAAO,CAAC,UAAU,CAAC;IAwBtB,OAAO,CAAC,MAAM;CAGf;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASpE"}

package/dist/client.js

@@ -0,0 +1,102 @@
+/**
+ * 统一 LLM 客户端（对标 pi-ai 的统一 API）—— real | mock | dry 三态，provider 可换。
+ * 从 Python client.py 忠实移植。completeJson(system, user, mockFn?) 是主接口。
+ */
+import { getProvider } from "./providers/index.js";
+/** 7 条铁律 —— worker system 前缀，pack 只能追加不能削弱。 */
+export const IRON_RULES = "你是抽取/核查 worker。严格遵守：\n" +
+    "1. 只输出 JSON，不要多余文字。\n" +
+    "2. 无严格匹配则返回空值，绝不臆造。\n" +
+    "3. 逐字复制原文，不改写。\n" +
+    "4. 各结果字段相互独立。\n" +
+    "5. 去重。\n" +
+    "6. 不回显模板占位符。\n" +
+    "7. 穷尽扫描给定证据。\n";
+export class LLMClient {
+    mode;
+    model;
+    ledger;
+    providerName;
+    timeoutMs;
+    maxRetries;
+    provider = null;
+    constructor(opts = {}) {
+        this.mode = opts.mode ?? "mock";
+        this.model = opts.model ?? "";
+        this.ledger = opts.ledger;
+        this.timeoutMs = opts.timeoutMs ?? 120_000;
+        this.maxRetries = opts.maxRetries ?? 6;
+        this.providerName = opts.provider ?? "openai_compatible";
+        if (this.mode === "real") {
+            this.provider = getProvider(this.providerName, {
+                baseUrl: opts.baseUrl,
+                apiKey: opts.apiKey,
+            });
+        }
+    }
+    async completeJson(system, user, mockFn) {
+        if (this.mode === "dry")
+            return {};
+        if (this.mode === "mock") {
+            const out = mockFn ? mockFn() : {};
+            this.charge("mock", system.length + user.length, 0);
+            return out;
+        }
+        const { content, usage } = await this.provider.complete({
+            system,
+            user,
+            model: this.model,
+            timeoutMs: this.timeoutMs,
+            maxRetries: this.maxRetries,
+        });
+        this.charge(this.model, usage.promptTokens, usage.completionTokens);
+        return parseJsonLoose(content);
+    }
+    /**
+     * 多轮对话 + 原生 tool_calls（通用 agent 循环用）。
+     * real 走 provider.chat；mock 走注入的 mockFn（驱动确定性测试）；dry 返回空。
+     * onDelta 提供则请求流式（仅 real 生效）。
+     */
+    async chat(messages, opts = {}) {
+        const tools = opts.tools ?? [];
+        if (this.mode === "dry")
+            return { text: "", toolCalls: [], usage: { promptTokens: 0, completionTokens: 0 } };
+        if (this.mode === "mock") {
+            const out = opts.mock ? opts.mock(messages, tools) : {};
+            const chars = messages.reduce((n, m) => n + ("content" in m ? String(m.content).length : 0), 0);
+            this.charge("mock", chars, 0);
+            if (opts.onDelta && out.text)
+                opts.onDelta(out.text); // mock 也模拟流式（整段一次增量），行为与 real 一致
+            return { text: out.text ?? "", toolCalls: out.toolCalls ?? [], usage: { promptTokens: chars, completionTokens: 0 } };
+        }
+        if (!this.provider.chat)
+            throw new Error(`provider ${this.providerName} 不支持 chat（多轮/tool_calls）`);
+        const res = await this.provider.chat({
+            messages,
+            tools,
+            model: this.model,
+            timeoutMs: this.timeoutMs,
+            maxRetries: this.maxRetries,
+            onDelta: opts.onDelta,
+            onNotice: opts.onNotice,
+        });
+        this.charge(this.model, res.usage.promptTokens, res.usage.completionTokens);
+        return res;
+    }
+    charge(model, p, c) {
+        this.ledger?.record(model, p, c);
+    }
+}
+export function parseJsonLoose(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        const i = text.indexOf("{");
+        const j = text.lastIndexOf("}");
+        if (i >= 0 && j > i)
+            return JSON.parse(text.slice(i, j + 1));
+        throw new Error(`not JSON: ${text.slice(0, 80)}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @mingyuxu/ai —— 统一多 provider LLM 层（对标 @earendil-works/pi-ai）。
+ * 分层底座，零内部依赖（叶子层）。core/check/cli 只依赖这层的 LLMClient/Budget/Ledger。
+ */
+export { LLMClient, IRON_RULES, parseJsonLoose } from "./client.js";
+export type { LLMClientOptions, LLMMode, MockFn, MockChatFn } from "./client.js";
+export type { Message, ToolSchema, ToolCall, ChatArgs, ChatResult } from "./providers/base.js";
+export { stripToolTags } from "./providers/openai-compatible.js";
+export { Budget, BudgetExceeded } from "./budget.js";
+export { Ledger } from "./ledger.js";
+export type { LedgerSummary } from "./ledger.js";
+export { getProvider, register, providers, LLMError } from "./providers/index.js";
+export type { Provider, ProviderFactory } from "./providers/index.js";
+export type { CompleteArgs, Usage } from "./providers/base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAClF,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @mingyuxu/ai —— 统一多 provider LLM 层（对标 @earendil-works/pi-ai）。
+ * 分层底座，零内部依赖（叶子层）。core/check/cli 只依赖这层的 LLMClient/Budget/Ledger。
+ */
+export { LLMClient, IRON_RULES, parseJsonLoose } from "./client.js";
+export { stripToolTags } from "./providers/openai-compatible.js";
+export { Budget, BudgetExceeded } from "./budget.js";
+export { Ledger } from "./ledger.js";
+export { getProvider, register, providers, LLMError } from "./providers/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/ledger.d.ts

@@ -0,0 +1,24 @@
+/** Token / cost 账本。See it to optimize it —— 每次 LLM 调用记 usage。 */
+export interface LedgerSummary {
+    calls: number;
+    promptTokens: number;
+    completionTokens: number;
+    byModel: Record<string, {
+        calls: number;
+        prompt: number;
+        completion: number;
+    }>;
+}
+export declare class Ledger {
+    calls: number;
+    promptTokens: number;
+    completionTokens: number;
+    byModel: Record<string, {
+        calls: number;
+        prompt: number;
+        completion: number;
+    }>;
+    record(model: string, promptTokens?: number, completionTokens?: number): void;
+    summary(): LedgerSummary;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/dist/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAED,qBAAa,MAAM;IACjB,KAAK,SAAK;IACV,YAAY,SAAK;IACjB,gBAAgB,SAAK;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAEpF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAI,EAAE,gBAAgB,SAAI,GAAG,IAAI;IAUnE,OAAO,IAAI,aAAa;CAQzB"}

package/dist/ledger.js

@@ -0,0 +1,25 @@
+/** Token / cost 账本。See it to optimize it —— 每次 LLM 调用记 usage。 */
+export class Ledger {
+    calls = 0;
+    promptTokens = 0;
+    completionTokens = 0;
+    byModel = {};
+    record(model, promptTokens = 0, completionTokens = 0) {
+        this.calls += 1;
+        this.promptTokens += promptTokens;
+        this.completionTokens += completionTokens;
+        const m = (this.byModel[model] ??= { calls: 0, prompt: 0, completion: 0 });
+        m.calls += 1;
+        m.prompt += promptTokens;
+        m.completion += completionTokens;
+    }
+    summary() {
+        return {
+            calls: this.calls,
+            promptTokens: this.promptTokens,
+            completionTokens: this.completionTokens,
+            byModel: this.byModel,
+        };
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA,iEAAiE;AASjE,MAAM,OAAO,MAAM;IACjB,KAAK,GAAG,CAAC,CAAC;IACV,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,OAAO,GAA0E,EAAE,CAAC;IAEpF,MAAM,CAAC,KAAa,EAAE,YAAY,GAAG,CAAC,EAAE,gBAAgB,GAAG,CAAC;QAC1D,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC;QAClC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC;QACzB,CAAC,CAAC,UAAU,IAAI,gBAAgB,CAAC;IACnC,CAAC;IAED,OAAO;QACL,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/base.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Provider 抽象面（对标 pi-ai/api/*：一文件一 provider）。
+ *
+ * 一个 Provider = 对接一族 LLM API 的适配器。complete() 返回 {content, usage}。
+ * 新增 provider = 加一个适配文件 + register，不动 client/core/check。
+ */
+export declare class LLMError extends Error {
+    constructor(message: string);
+}
+export interface Usage {
+    promptTokens: number;
+    completionTokens: number;
+}
+export interface CompleteArgs {
+    system: string;
+    user: string;
+    model: string;
+    timeoutMs: number;
+    maxRetries: number;
+}
+/** 一个工具的可调用契约（OpenAI function schema：name/description/JSON-Schema 参数）。 */
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** 模型发起的一次工具调用（arguments 已从 JSON 文本解析为对象）。 */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** 对话消息。assistant 可带 toolCalls；tool 回执用 toolCallId 关联。 */
+export type Message = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string;
+} | {
+    role: "assistant";
+    content: string;
+    toolCalls?: ToolCall[];
+} | {
+    role: "tool";
+    toolCallId: string;
+    content: string;
+};
+export interface ChatArgs {
+    messages: Message[];
+    tools?: ToolSchema[];
+    model: string;
+    timeoutMs: number;
+    maxRetries: number;
+    /** 提供则请求流式，每段增量文本回调（工具调用不流式，整体解析）。 */
+    onDelta?: (text: string) => void;
+    /** 限流/重试等运行期提示（让上层能显示，不至于静默假死）。 */
+    onNotice?: (msg: string) => void;
+}
+export interface ChatResult {
+    /** 本轮助手的自然语言文本（可能为空，若模型只调工具）。 */
+    text: string;
+    /** 本轮模型请求的工具调用（可能为空，若模型只说话）。 */
+    toolCalls: ToolCall[];
+    usage: Usage;
+}
+export interface Provider {
+    readonly name: string;
+    /** 返回 JSON 文本 + usage。传输/协议级失败抛 LLMError。 */
+    complete(args: CompleteArgs): Promise<{
+        content: string;
+        usage: Usage;
+    }>;
+    /** 多轮 + 原生 tool_calls。可选：老 provider 不实现则通用 agent 不可用。 */
+    chat?(args: ChatArgs): Promise<ChatResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,0DAA0D;AAC1D,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IACzE,yDAAyD;IACzD,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5C"}

package/dist/providers/base.js

@@ -0,0 +1,13 @@
+/**
+ * Provider 抽象面（对标 pi-ai/api/*：一文件一 provider）。
+ *
+ * 一个 Provider = 对接一族 LLM API 的适配器。complete() 返回 {content, usage}。
+ * 新增 provider = 加一个适配文件 + register，不动 client/core/check。
+ */
+export class LLMError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LLMError";
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Provider 注册表（对标 pi-ai 的多 provider 面）。
+ * 新增 provider：写一个 providers/<name>.ts 实现 Provider，然后 register(name, factory)。
+ * core/check/cli 只认统一的 LLMClient，加 provider 零波及上层。
+ */
+import { Provider } from "./base.js";
+export type ProviderFactory = (cfg: {
+    baseUrl?: string;
+    apiKey?: string;
+}) => Provider;
+export declare function register(name: string, factory: ProviderFactory): void;
+export declare function getProvider(name: string, cfg?: {
+    baseUrl?: string;
+    apiKey?: string;
+}): Provider;
+export declare function providers(): string[];
+export { Provider, LLMError } from "./base.js";
+export type { CompleteArgs, Usage } from "./base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAY,MAAM,WAAW,CAAC;AAG/C,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,QAAQ,CAAC;AAIvF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAErE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,QAAQ,CAQnG;AAED,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAKD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,25 @@
+/**
+ * Provider 注册表（对标 pi-ai 的多 provider 面）。
+ * 新增 provider：写一个 providers/<name>.ts 实现 Provider，然后 register(name, factory)。
+ * core/check/cli 只认统一的 LLMClient，加 provider 零波及上层。
+ */
+import { LLMError } from "./base.js";
+import { OpenAICompatibleProvider } from "./openai-compatible.js";
+const REGISTRY = new Map();
+export function register(name, factory) {
+    REGISTRY.set(name, factory);
+}
+export function getProvider(name, cfg = {}) {
+    const factory = REGISTRY.get(name);
+    if (!factory) {
+        throw new LLMError(`未知 provider ${name}（已注册：${[...REGISTRY.keys()].sort().join(", ")}）——新增 provider 需写适配文件并 register。`);
+    }
+    return factory(cfg);
+}
+export function providers() {
+    return [...REGISTRY.keys()].sort();
+}
+register("openai_compatible", (cfg) => new OpenAICompatibleProvider(cfg));
+// 未来：register("anthropic", ...) / register("google", ...)
+export { LLMError } from "./base.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAY,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAwB;IAC7D,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAA6C,EAAE;IACvF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAChB,eAAe,IAAI,QAAQ,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,QAAQ,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1E,0DAA0D;AAE1D,OAAO,EAAY,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/providers/openai-compatible.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OpenAI 兼容 provider —— /chat/completions，temperature 0，json_object，分型退避。
+ * 用 Node 全局 fetch（零第三方依赖）。SiliconFlow / DeepSeek / vLLM 等都走这里。
+ * 从 Python openai_compatible.py 忠实移植（重试语义一致）。
+ */
+import { Provider, CompleteArgs, Usage, ChatArgs, ChatResult } from "./base.js";
+export declare class OpenAICompatibleProvider implements Provider {
+    readonly name = "openai_compatible";
+    private baseUrl;
+    private apiKey;
+    constructor(cfg?: {
+        baseUrl?: string;
+        apiKey?: string;
+    });
+    complete(args: CompleteArgs): Promise<{
+        content: string;
+        usage: Usage;
+    }>;
+    chat(args: ChatArgs): Promise<ChatResult>;
+    /** 解析 SSE 流：累积文本增量与分片到达的 tool_calls（按 index 归并 arguments）。 */
+    private readStream;
+}
+/**
+ * 去掉部分模型（如 SiliconFlow 上的 Qwen）漏进 content 的工具调用碎片：
+ * 成对 <tool_call>…</tool_call>、未闭合的尾部 <tool_call>…、以及落单的 </tool_call>。
+ * 原生 tool_calls 字段才是我们执行的依据，这些文本是冗余噪声。
+ */
+export declare function stripToolTags(s: string): string;
+//# sourceMappingURL=openai-compatible.d.ts.map

package/dist/providers/openai-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../src/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAY,QAAQ,EAAE,UAAU,EAAqB,MAAM,WAAW,CAAC;AAI7G,qBAAa,wBAAyB,YAAW,QAAQ;IACvD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,GAAG,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAKrD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IA0DxE,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IA2C/C,8DAA8D;YAChD,UAAU;CAkDzB;AA+BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/dist/providers/openai-compatible.js

@@ -0,0 +1,267 @@
+/**
+ * OpenAI 兼容 provider —— /chat/completions，temperature 0，json_object，分型退避。
+ * 用 Node 全局 fetch（零第三方依赖）。SiliconFlow / DeepSeek / vLLM 等都走这里。
+ * 从 Python openai_compatible.py 忠实移植（重试语义一致）。
+ */
+import { LLMError } from "./base.js";
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export class OpenAICompatibleProvider {
+    name = "openai_compatible";
+    baseUrl;
+    apiKey;
+    constructor(cfg = {}) {
+        this.baseUrl = (cfg.baseUrl ?? "").replace(/\/+$/, "");
+        this.apiKey = cfg.apiKey ?? "";
+    }
+    async complete(args) {
+        const body = JSON.stringify({
+            model: args.model,
+            temperature: 0,
+            response_format: { type: "json_object" },
+            messages: [
+                { role: "system", content: args.system },
+                { role: "user", content: args.user },
+            ],
+        });
+        let last = null;
+        for (let attempt = 0; attempt <= args.maxRetries; attempt++) {
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), args.timeoutMs);
+            try {
+                const resp = await fetch(`${this.baseUrl}/chat/completions`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body,
+                    signal: ctrl.signal,
+                });
+                if (!resp.ok) {
+                    if (resp.status === 429) {
+                        await sleep(retryAfter(resp, attempt) * 1000);
+                        last = new Error(`HTTP 429`);
+                        continue;
+                    }
+                    if (resp.status >= 500 && resp.status < 600) {
+                        await sleep(2 ** attempt * 1000);
+                        last = new Error(`HTTP ${resp.status}`);
+                        continue;
+                    }
+                    throw new LLMError(`HTTP ${resp.status}: ${resp.statusText}`); // 4xx: no retry
+                }
+                const data = await resp.json();
+                const usage = data.usage ?? {};
+                const content = data.choices?.[0]?.message?.content ?? "";
+                return {
+                    content,
+                    usage: {
+                        promptTokens: usage.prompt_tokens ?? 0,
+                        completionTokens: usage.completion_tokens ?? 0,
+                    },
+                };
+            }
+            catch (e) {
+                if (e instanceof LLMError)
+                    throw e;
+                last = e; // network / abort → 退避重试
+                await sleep(2 ** attempt * 1000);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        throw new LLMError(`exhausted retries: ${String(last)}`);
+    }
+    async chat(args) {
+        const stream = Boolean(args.onDelta);
+        const payload = {
+            model: args.model,
+            temperature: 0,
+            messages: args.messages.map(toApiMessage),
+            stream,
+        };
+        if (args.tools?.length) {
+            payload.tools = args.tools.map((t) => ({ type: "function", function: { name: t.name, description: t.description, parameters: t.parameters } }));
+            payload.tool_choice = "auto";
+        }
+        if (stream)
+            payload.stream_options = { include_usage: true };
+        const body = JSON.stringify(payload);
+        let last = null;
+        for (let attempt = 0; attempt <= args.maxRetries; attempt++) {
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), args.timeoutMs);
+            try {
+                const resp = await fetch(`${this.baseUrl}/chat/completions`, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` },
+                    body,
+                    signal: ctrl.signal,
+                });
+                if (!resp.ok) {
+                    if (resp.status === 429) {
+                        const w = retryAfter(resp, attempt);
+                        args.onNotice?.(`服务端限流（429），${w}s 后重试（${attempt + 1}/${args.maxRetries + 1}）`);
+                        await sleep(w * 1000);
+                        last = new Error("HTTP 429");
+                        continue;
+                    }
+                    if (resp.status >= 500 && resp.status < 600) {
+                        const w = Math.min(2 ** attempt * 2, 20);
+                        args.onNotice?.(`服务端 ${resp.status}，${w}s 后重试（${attempt + 1}/${args.maxRetries + 1}）`);
+                        await sleep(w * 1000);
+                        last = new Error(`HTTP ${resp.status}`);
+                        continue;
+                    }
+                    throw new LLMError(`HTTP ${resp.status}: ${resp.statusText}`); // 4xx: no retry
+                }
+                return stream ? await this.readStream(resp, args.onDelta) : parseChatBody(await resp.json());
+            }
+            catch (e) {
+                if (e instanceof LLMError)
+                    throw e;
+                last = e;
+                await sleep(2 ** attempt * 1000);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        throw new LLMError(`exhausted retries: ${String(last)}`);
+    }
+    /** 解析 SSE 流：累积文本增量与分片到达的 tool_calls（按 index 归并 arguments）。 */
+    async readStream(resp, onDelta) {
+        const reader = resp.body?.getReader();
+        if (!reader)
+            throw new LLMError("流式响应无 body");
+        const decoder = new TextDecoder();
+        let buf = "";
+        let raw = ""; // 原始 content 累积（含可能的 <tool_call> 噪声）
+        let shown = 0; // 已 onDelta 出去的干净文本长度
+        const GUARD = 12; // 尾部留一小段不发，避免把半个 <tool_call> 标签当正文吐出
+        const emit = (final) => {
+            const clean = stripToolTags(raw);
+            const to = final ? clean.length : Math.max(shown, clean.length - GUARD);
+            if (to > shown) {
+                onDelta(clean.slice(shown, to));
+                shown = to;
+            }
+        };
+        const calls = new Map();
+        let usage = { promptTokens: 0, completionTokens: 0 };
+        let done = false;
+        // 见到 [DONE] 立即收尾并 cancel（有些 OpenAI 兼容服务 keep-alive，不主动关流，
+        // 若只等 reader 结束会永久阻塞）。
+        outer: for (;;) {
+            const { done: streamEnd, value } = await reader.read();
+            if (streamEnd)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let nl;
+            while ((nl = buf.indexOf("\n")) >= 0) {
+                const line = buf.slice(0, nl).trim();
+                buf = buf.slice(nl + 1);
+                if (!line.startsWith("data:"))
+                    continue;
+                const data = line.slice(5).trim();
+                if (data === "[DONE]") {
+                    done = true;
+                    break outer;
+                }
+                let chunk;
+                try {
+                    chunk = JSON.parse(data);
+                }
+                catch {
+                    continue;
+                }
+                if (chunk.usage)
+                    usage = { promptTokens: chunk.usage.prompt_tokens ?? 0, completionTokens: chunk.usage.completion_tokens ?? 0 };
+                const delta = chunk.choices?.[0]?.delta;
+                if (!delta)
+                    continue;
+                if (typeof delta.content === "string" && delta.content) {
+                    raw += delta.content;
+                    emit(false);
+                }
+                for (const tc of delta.tool_calls ?? []) {
+                    const slot = calls.get(tc.index) ?? { id: "", name: "", args: "" };
+                    if (tc.id)
+                        slot.id = tc.id;
+                    if (tc.function?.name)
+                        slot.name = tc.function.name;
+                    if (tc.function?.arguments)
+                        slot.args += tc.function.arguments;
+                    calls.set(tc.index, slot);
+                }
+            }
+        }
+        if (done) {
+            try {
+                await reader.cancel();
+            }
+            catch { /* 已关则忽略 */ }
+        }
+        emit(true); // flush 尾部保留窗口
+        const toolCalls = [...calls.values()].filter((c) => c.name)
+            .map((c, i) => ({ id: c.id || `call_${i}`, name: c.name, arguments: parseArgs(c.args) }));
+        return { text: stripToolTags(raw), toolCalls, usage };
+    }
+}
+/** kc 内部 Message → OpenAI /chat/completions 消息格式。 */
+function toApiMessage(m) {
+    if (m.role === "assistant") {
+        const out = { role: "assistant", content: m.content || null };
+        if (m.toolCalls?.length) {
+            out.tool_calls = m.toolCalls.map((t) => ({ id: t.id, type: "function", function: { name: t.name, arguments: JSON.stringify(t.arguments) } }));
+        }
+        return out;
+    }
+    if (m.role === "tool")
+        return { role: "tool", tool_call_id: m.toolCallId, content: m.content };
+    return { role: m.role, content: m.content };
+}
+/** 非流式响应体 → ChatResult。 */
+function parseChatBody(data) {
+    const msg = data.choices?.[0]?.message ?? {};
+    const u = data.usage ?? {};
+    const toolCalls = (msg.tool_calls ?? []).map((t, i) => ({
+        id: t.id || `call_${i}`,
+        name: t.function?.name ?? "",
+        arguments: parseArgs(t.function?.arguments ?? "{}"),
+    })).filter((t) => t.name);
+    return {
+        text: stripToolTags(msg.content ?? ""),
+        toolCalls,
+        usage: { promptTokens: u.prompt_tokens ?? 0, completionTokens: u.completion_tokens ?? 0 },
+    };
+}
+/**
+ * 去掉部分模型（如 SiliconFlow 上的 Qwen）漏进 content 的工具调用碎片：
+ * 成对 <tool_call>…</tool_call>、未闭合的尾部 <tool_call>…、以及落单的 </tool_call>。
+ * 原生 tool_calls 字段才是我们执行的依据，这些文本是冗余噪声。
+ */
+export function stripToolTags(s) {
+    return s
+        .replace(/<tool_call>[\s\S]*?<\/tool_call>/g, "")
+        .replace(/<tool_call>[\s\S]*$/g, "")
+        .replace(/<\/tool_call>/g, "");
+}
+function parseArgs(s) {
+    if (!s)
+        return {};
+    try {
+        const v = JSON.parse(s);
+        return v && typeof v === "object" ? v : {};
+    }
+    catch {
+        return {};
+    }
+}
+function retryAfter(resp, attempt) {
+    const h = resp.headers.get("retry-after");
+    const n = h ? Number(h) : NaN;
+    return Number.isFinite(n) ? n : Math.min(5 * (attempt + 1), 20); // 无 Retry-After：5,10,15,20,20,20（交互可接受）
+}
+//# sourceMappingURL=openai-compatible.js.map

package/dist/providers/openai-compatible.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mingyuxu/ai",
+  "version": "0.1.0",
+  "description": "统一多 provider LLM 层（对标 @earendil-works/pi-ai）",
+  "keywords": ["agent", "llm", "tool-calling", "openai-compatible"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mingyu-Xu-98/doccheck-agent.git",
+    "directory": "packages/ai"
+  },
+  "homepage": "https://github.com/Mingyu-Xu-98/doccheck-agent#readme",
+  "bugs": { "url": "https://github.com/Mingyu-Xu-98/doccheck-agent/issues" },
+  "engines": { "node": ">=20" },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}