@gatanot/qualia_core 0.1.0

package/dist/agent/types.d.ts

@@ -0,0 +1,135 @@
+import type { Usage, Message } from '../ai/index.js';
+import type { PendingConfirmation } from '../tool/index.js';
+/**
+ * AgentLoop 状态机状态枚举
+ *
+ * 每个状态对应循环中的一个确定阶段，状态转换时触发对应的 LoopHooks 回调。
+ */
+export declare enum AgentState {
+    INIT = "INIT",
+    PRE_LLM = "PRE_LLM",
+    LLM_STREAMING = "LLM_STREAMING",
+    POST_LLM = "POST_LLM",
+    LLM_RETRY_WAIT = "LLM_RETRY_WAIT",
+    PRE_TOOL = "PRE_TOOL",
+    TOOL_EXECUTING = "TOOL_EXECUTING",
+    AWAIT_CONFIRM = "AWAIT_CONFIRM",
+    POST_TOOL = "POST_TOOL",
+    PERSIST_TURN = "PERSIST_TURN",
+    DONE = "DONE",
+    ERROR = "ERROR"
+}
+/**
+ * AgentLoop 生命周期钩子
+ *
+ * 在状态转换的关键节点调用，允许 extension 等外部模块注入自定义逻辑。
+ * 所有钩子均为可选，默认无操作。
+ */
+export interface LoopHooks {
+    /** LLM 调用前触发，可修改 messages 数组（返回新数组） */
+    beforeLlmCall?(messages: Message[]): Promise<Message[]>;
+    /** LLM 调用完成后触发 */
+    afterLlmCall?(usage?: Usage): Promise<void>;
+    /** LLM 重试时触发 */
+    onLlmRetry?(attempt: number, maxRetries: number, error: Error): Promise<void>;
+    /** 工具执行前触发，可修改参数（返回新 args） */
+    beforeToolExecution?(name: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** 工具执行完成后触发 */
+    afterToolExecution?(name: string, result: {
+        success: boolean;
+        output: string;
+    }): Promise<void>;
+    /** 需要用户确认时触发 */
+    onConfirmRequired?(confirmation: PendingConfirmation, confirmId: string): Promise<void>;
+    /** 每轮对话结束后触发（persist 之前） */
+    afterTurn?(iteration: number): Promise<void>;
+}
+/**
+ * Agent 运行时流式事件
+ *
+ * API 路由将每种事件通过 SSE 推送到前端。
+ */
+export type AgentEvent = 
+/** 流式文本增量 */
+{
+    type: 'content';
+    text: string;
+}
+/** 流式思维链增量 */
+ | {
+    type: 'reasoning';
+    text: string;
+}
+/** LLM 发起的工具调用 */
+ | {
+    type: 'tool_call';
+    name: string;
+    args: Record<string, unknown>;
+}
+/** 工具执行结果 */
+ | {
+    type: 'tool_result';
+    name: string;
+    success: boolean;
+    output: string;
+}
+/** 工具执行中的流式输出 */
+ | {
+    type: 'tool_execution_update';
+    name: string;
+    text: string;
+}
+/** 需要用户确认的操作 */
+ | {
+    type: 'confirm_required';
+    confirmId: string;
+    confirmation: PendingConfirmation;
+}
+/** 错误 */
+ | {
+    type: 'error';
+    message: string;
+}
+/** 会话分叉 */
+ | {
+    type: 'forked';
+    newSessionId: string;
+}
+/** 本轮对话完成 */
+ | {
+    type: 'done';
+    messageId: string;
+    usage?: Usage;
+    contextWindow?: number;
+}
+/** LLM 调用失败，正在重试 */
+ | {
+    type: 'retrying';
+    attempt: number;
+    maxRetries: number;
+}
+/** 所有重试均已失败 */
+ | {
+    type: 'retry_exhausted';
+    message: string;
+    partialContent: boolean;
+}
+/** 实时干预消息已消费，可从输入队列中移除 */
+ | {
+    type: 'steering_consumed';
+    messageId: string;
+};
+/** ContextBuilder.build() 的返回值 */
+export interface BuildResult {
+    /** 可直接传入 provider.chat 的消息列表 */
+    messages: Message[];
+    /** 当前模型的上下文窗口大小 */
+    contextWindow?: number;
+    /** 如果触发了分叉，包含新会话信息 */
+    forked?: {
+        newSessionId: string;
+    };
+}
+/** 确认回调函数签名 */
+export type ConfirmFn = (confirmation: PendingConfirmation, confirmId: string) => Promise<boolean>;
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

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

package/dist/agent/types.js

@@ -0,0 +1,21 @@
+/**
+ * AgentLoop 状态机状态枚举
+ *
+ * 每个状态对应循环中的一个确定阶段，状态转换时触发对应的 LoopHooks 回调。
+ */
+export var AgentState;
+(function (AgentState) {
+    AgentState["INIT"] = "INIT";
+    AgentState["PRE_LLM"] = "PRE_LLM";
+    AgentState["LLM_STREAMING"] = "LLM_STREAMING";
+    AgentState["POST_LLM"] = "POST_LLM";
+    AgentState["LLM_RETRY_WAIT"] = "LLM_RETRY_WAIT";
+    AgentState["PRE_TOOL"] = "PRE_TOOL";
+    AgentState["TOOL_EXECUTING"] = "TOOL_EXECUTING";
+    AgentState["AWAIT_CONFIRM"] = "AWAIT_CONFIRM";
+    AgentState["POST_TOOL"] = "POST_TOOL";
+    AgentState["PERSIST_TURN"] = "PERSIST_TURN";
+    AgentState["DONE"] = "DONE";
+    AgentState["ERROR"] = "ERROR";
+})(AgentState || (AgentState = {}));
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IACrB,2BAAa,CAAA;IACb,iCAAmB,CAAA;IACnB,6CAA+B,CAAA;IAC/B,mCAAqB,CAAA;IACrB,+CAAiC,CAAA;IACjC,mCAAqB,CAAA;IACrB,+CAAiC,CAAA;IACjC,6CAA+B,CAAA;IAC/B,qCAAuB,CAAA;IACvB,2CAA6B,CAAA;IAC7B,2BAAa,CAAA;IACb,6BAAe,CAAA;AAChB,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB"}

package/dist/ai/base.d.ts

@@ -0,0 +1,19 @@
+import type { ChatRequest, ChatResponse, StreamChunk } from './types.js';
+/**
+ * AI 供应商统一接口
+ *
+ * 所有 LLM API 接入实现此接口，向上层暴露统一的流式/非流式调用方式。
+ */
+export interface AIProvider {
+    /**
+     * 发送非流式聊天请求，等待完整结果后返回
+     * @param request - 聊天请求参数
+     */
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    /**
+     * 发送流式聊天请求，通过 AsyncGenerator 逐块返回增量数据
+     * @param request - 聊天请求参数
+     */
+    chatStream(request: ChatRequest): AsyncGenerator<StreamChunk>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/ai/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;CAC9D"}

package/dist/ai/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/ai/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/ai/base.ts"],"names":[],"mappings":""}

package/dist/ai/deepseek.d.ts

@@ -0,0 +1,15 @@
+import { OpenAIProvider, type OpenAIConfig } from './openai.js';
+import type { ChatRequest } from './types.js';
+export interface DeepSeekConfig extends OpenAIConfig {
+    reasoningEffort?: string;
+    supportsReasoning?: boolean;
+}
+export declare class DeepSeekProvider extends OpenAIProvider {
+    private reasoningEffort?;
+    private supportsReasoning;
+    constructor(config: DeepSeekConfig);
+    protected buildBodyObject(request: ChatRequest & {
+        stream: boolean;
+    }): Record<string, unknown>;
+}
+//# sourceMappingURL=deepseek.d.ts.map

package/dist/ai/deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/ai/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,cAAe,SAAQ,YAAY;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,gBAAiB,SAAQ,cAAc;IACnD,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAU;gBAEvB,MAAM,EAAE,cAAc;IAMlC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAc9F"}

package/dist/ai/deepseek.js

@@ -0,0 +1,24 @@
+import { OpenAIProvider } from './openai.js';
+export class DeepSeekProvider extends OpenAIProvider {
+    reasoningEffort;
+    supportsReasoning;
+    constructor(config) {
+        super(config);
+        this.reasoningEffort = config.reasoningEffort;
+        this.supportsReasoning = config.supportsReasoning || false;
+    }
+    buildBodyObject(request) {
+        const body = super.buildBodyObject(request);
+        if (this.supportsReasoning) {
+            if (this.reasoningEffort) {
+                body.thinking = { type: 'enabled' };
+                body.reasoning_effort = this.reasoningEffort;
+            }
+            else {
+                body.thinking = { type: 'disabled' };
+            }
+        }
+        return body;
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/ai/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/ai/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAQhE,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAC3C,eAAe,CAAU;IACzB,iBAAiB,CAAU;IAEnC,YAAY,MAAsB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;IAC5D,CAAC;IAES,eAAe,CAAC,OAA0C;QACnE,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAE5C,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBACpC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACtC,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/dist/ai/factory.d.ts

@@ -0,0 +1,4 @@
+import type { AIProvider } from './base.js';
+import type { ProviderConfig } from '../config/types.js';
+export declare function createProvider(config: ProviderConfig): AIProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/ai/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/ai/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CA+CjE"}

package/dist/ai/factory.js

@@ -0,0 +1,53 @@
+import { OpenAIProvider } from './openai.js';
+import { DeepSeekProvider } from './deepseek.js';
+import { XiaomiProvider } from './xiaomi.js';
+import { OllamaProvider } from './ollama.js';
+import { getDefaultModels } from './models.js';
+export function createProvider(config) {
+    const activeModel = config.activeModel || '';
+    const modelDefs = getDefaultModels(config.type);
+    const modelDef = modelDefs.find((m) => m.id === activeModel);
+    const supportsReasoning = modelDef?.supportsReasoning || false;
+    switch (config.type) {
+        case 'openai':
+            return new OpenAIProvider({
+                apiKey: config.apiKey,
+                baseURL: config.baseURL,
+                model: activeModel,
+                timeout: config.timeout,
+                maxRetries: config.maxRetries ?? 5
+            });
+        case 'deepseek':
+            return new DeepSeekProvider({
+                apiKey: config.apiKey,
+                baseURL: config.baseURL,
+                model: activeModel,
+                timeout: config.timeout,
+                maxRetries: config.maxRetries ?? 5,
+                reasoningEffort: config.reasoningEffort,
+                supportsReasoning
+            });
+        case 'xiaomi':
+            return new XiaomiProvider({
+                apiKey: config.apiKey,
+                baseURL: config.baseURL,
+                model: activeModel,
+                timeout: config.timeout,
+                maxRetries: config.maxRetries ?? 5,
+                reasoningEffort: config.reasoningEffort,
+                supportsReasoning
+            });
+        case 'ollama':
+            return new OllamaProvider({
+                apiKey: config.apiKey,
+                baseURL: config.baseURL || '',
+                model: activeModel,
+                timeout: config.timeout,
+                maxRetries: config.maxRetries ?? 3,
+                ollamaURL: config.ollamaURL
+            });
+        default:
+            throw new Error(`Unsupported provider type: ${config.type}`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/ai/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/ai/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,cAAc,CAAC,MAAsB;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;IAC7D,MAAM,iBAAiB,GAAG,QAAQ,EAAE,iBAAiB,IAAI,KAAK,CAAC;IAE/D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,QAAQ;YACZ,OAAO,IAAI,cAAc,CAAC;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;aAClC,CAAC,CAAC;QACJ,KAAK,UAAU;YACd,OAAO,IAAI,gBAAgB,CAAC;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;gBAClC,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,iBAAiB;aACjB,CAAC,CAAC;QACJ,KAAK,QAAQ;YACZ,OAAO,IAAI,cAAc,CAAC;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;gBAClC,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,iBAAiB;aACjB,CAAC,CAAC;QACJ,KAAK,QAAQ;YACZ,OAAO,IAAI,cAAc,CAAC;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;gBAC7B,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;gBAClC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC3B,CAAC,CAAC;QACJ;YACC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;AACF,CAAC"}

package/dist/ai/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Provider 模块
+ *
+ * 管理不同来源的 AI API 接入，向上层暴露统一的流式/非流式调用接口。
+ * 当前支持 OpenAI 兼容格式。
+ *
+ * @module ai
+ *
+ * @example 基本用法
+ * ```ts
+ * import { createProvider } from './index.js';
+ *
+ * const ai = createProvider({
+ *   type: 'openai',
+ *   apiKey: 'sk-xxx',
+ *   baseURL: 'https://api.openai.com/v1',
+ *   model: 'gpt-4o'
+ * });
+ *
+ * // 非流式
+ * const result = await ai.chat({ messages: [{ role: 'user', content: 'Hello' }] });
+ *
+ * // 流式
+ * for await (const chunk of ai.chatStream({ messages: [...] })) {
+ *   process.stdout.write(chunk.content);
+ * }
+ * ```
+ */
+export type { AIProvider } from './base.js';
+export type { Message, TextContent, ImageContent, ContentPart, ToolCall, ToolCallDelta, Tool, ChatRequest, ChatResponse, StreamChunk, Usage } from './types.js';
+export { OpenAIProvider } from './openai.js';
+export type { OpenAIConfig } from './openai.js';
+export { DeepSeekProvider } from './deepseek.js';
+export type { DeepSeekConfig } from './deepseek.js';
+export { XiaomiProvider } from './xiaomi.js';
+export type { XiaomiConfig } from './xiaomi.js';
+export { OllamaProvider } from './ollama.js';
+export type { OllamaConfig } from './ollama.js';
+export { createProvider } from './factory.js';
+export type { ModelDef } from './models.js';
+export { getDefaultModels, OPENAI_MODELS, DEEPSEEK_MODELS, XIAOMI_MODELS } from './models.js';
+export { ProviderError, fetchWithRetry, parseSSEStream, parseUsage, sleep } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,EACL,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,36 @@
+/**
+ * Provider 模块
+ *
+ * 管理不同来源的 AI API 接入，向上层暴露统一的流式/非流式调用接口。
+ * 当前支持 OpenAI 兼容格式。
+ *
+ * @module ai
+ *
+ * @example 基本用法
+ * ```ts
+ * import { createProvider } from './index.js';
+ *
+ * const ai = createProvider({
+ *   type: 'openai',
+ *   apiKey: 'sk-xxx',
+ *   baseURL: 'https://api.openai.com/v1',
+ *   model: 'gpt-4o'
+ * });
+ *
+ * // 非流式
+ * const result = await ai.chat({ messages: [{ role: 'user', content: 'Hello' }] });
+ *
+ * // 流式
+ * for await (const chunk of ai.chatStream({ messages: [...] })) {
+ *   process.stdout.write(chunk.content);
+ * }
+ * ```
+ */
+export { OpenAIProvider } from './openai.js';
+export { DeepSeekProvider } from './deepseek.js';
+export { XiaomiProvider } from './xiaomi.js';
+export { OllamaProvider } from './ollama.js';
+export { createProvider } from './factory.js';
+export { getDefaultModels, OPENAI_MODELS, DEEPSEEK_MODELS, XIAOMI_MODELS } from './models.js';
+export { ProviderError, fetchWithRetry, parseSSEStream, parseUsage, sleep } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAgBH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/ai/models.d.ts

@@ -0,0 +1,13 @@
+export interface ModelDef {
+    id: string;
+    name: string;
+    contextWindow: number;
+    supportsReasoning: boolean;
+    reasoningEffortValues: string[];
+    supportsVision: boolean;
+}
+export declare const OPENAI_MODELS: ModelDef[];
+export declare const DEEPSEEK_MODELS: ModelDef[];
+export declare const XIAOMI_MODELS: ModelDef[];
+export declare function getDefaultModels(type: string): ModelDef[];
+//# sourceMappingURL=models.d.ts.map

package/dist/ai/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/ai/models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,EAiBnC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,QAAQ,EAiBrC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAAQ,EAiBnC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAWzD"}

package/dist/ai/models.js

@@ -0,0 +1,67 @@
+export const OPENAI_MODELS = [
+    {
+        id: 'gpt-4o',
+        name: 'GPT-4o',
+        contextWindow: 128_000,
+        supportsReasoning: false,
+        reasoningEffortValues: [],
+        supportsVision: false
+    },
+    {
+        id: 'gpt-4o-mini',
+        name: 'GPT-4o Mini',
+        contextWindow: 128_000,
+        supportsReasoning: false,
+        reasoningEffortValues: [],
+        supportsVision: false
+    }
+];
+export const DEEPSEEK_MODELS = [
+    {
+        id: 'deepseek-v4-pro',
+        name: 'DeepSeek V4 Pro',
+        contextWindow: 1_048_576,
+        supportsReasoning: true,
+        reasoningEffortValues: ['high', 'max'],
+        supportsVision: false
+    },
+    {
+        id: 'deepseek-v4-flash',
+        name: 'DeepSeek V4 Flash',
+        contextWindow: 1_048_576,
+        supportsReasoning: true,
+        reasoningEffortValues: ['high', 'max'],
+        supportsVision: false
+    }
+];
+export const XIAOMI_MODELS = [
+    {
+        id: 'mimo-v2.5',
+        name: 'MiMo V2.5',
+        contextWindow: 1_048_576,
+        supportsReasoning: true,
+        reasoningEffortValues: [],
+        supportsVision: true
+    },
+    {
+        id: 'mimo-v2.5-pro',
+        name: 'MiMo V2.5 Pro',
+        contextWindow: 1_048_576,
+        supportsReasoning: true,
+        reasoningEffortValues: [],
+        supportsVision: false
+    }
+];
+export function getDefaultModels(type) {
+    switch (type) {
+        case 'openai':
+            return [...OPENAI_MODELS];
+        case 'deepseek':
+            return [...DEEPSEEK_MODELS];
+        case 'xiaomi':
+            return [...XIAOMI_MODELS];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/ai/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/ai/models.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,aAAa,GAAe;IACxC;QACC,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,aAAa,EAAE,OAAO;QACtB,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,EAAE;QACzB,cAAc,EAAE,KAAK;KACrB;IACD;QACC,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,aAAa,EAAE,OAAO;QACtB,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,EAAE;QACzB,cAAc,EAAE,KAAK;KACrB;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAe;IAC1C;QACC,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,iBAAiB;QACvB,aAAa,EAAE,SAAS;QACxB,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QACtC,cAAc,EAAE,KAAK;KACrB;IACD;QACC,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,mBAAmB;QACzB,aAAa,EAAE,SAAS;QACxB,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QACtC,cAAc,EAAE,KAAK;KACrB;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAe;IACxC;QACC,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,aAAa,EAAE,SAAS;QACxB,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,EAAE;QACzB,cAAc,EAAE,IAAI;KACpB;IACD;QACC,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,aAAa,EAAE,SAAS;QACxB,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,EAAE;QACzB,cAAc,EAAE,KAAK;KACrB;CACD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,QAAQ;YACZ,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;QAC3B,KAAK,UAAU;YACd,OAAO,CAAC,GAAG,eAAe,CAAC,CAAC;QAC7B,KAAK,QAAQ;YACZ,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;QAC3B;YACC,OAAO,EAAE,CAAC;IACZ,CAAC;AACF,CAAC"}

package/dist/ai/ollama.d.ts

@@ -0,0 +1,13 @@
+import { OpenAIProvider, type OpenAIConfig } from './openai.js';
+export interface OllamaConfig extends OpenAIConfig {
+    ollamaURL?: string;
+}
+export declare class OllamaProvider extends OpenAIProvider {
+    private ollamaURL;
+    constructor(config: OllamaConfig);
+    listModels(): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/ai/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/ai/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,YAAa,SAAQ,YAAY;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAe,SAAQ,cAAc;IACjD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,YAAY;IAa1B,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAahE"}

package/dist/ai/ollama.js

@@ -0,0 +1,32 @@
+import { OpenAIProvider } from './openai.js';
+export class OllamaProvider extends OpenAIProvider {
+    ollamaURL;
+    constructor(config) {
+        const baseURL = config.baseURL || `${config.ollamaURL || 'http://localhost:11434'}/v1`;
+        const normalizedBase = baseURL.endsWith('/v1') ? baseURL : baseURL.replace(/\/+$/, '') + '/v1';
+        super({
+            apiKey: config.apiKey || 'ollama',
+            baseURL: normalizedBase,
+            model: config.model,
+            timeout: config.timeout,
+            maxRetries: config.maxRetries
+        });
+        this.ollamaURL = config.ollamaURL || 'http://localhost:11434';
+    }
+    async listModels() {
+        try {
+            const res = await fetch(`${this.ollamaURL}/api/tags`);
+            if (!res.ok)
+                return [];
+            const json = await res.json();
+            return (json.models || []).map((m) => ({
+                id: m.name,
+                name: m.name
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/ai/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../src/ai/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAMhE,MAAM,OAAO,cAAe,SAAQ,cAAc;IACzC,SAAS,CAAS;IAE1B,YAAY,MAAoB;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,GAAG,MAAM,CAAC,SAAS,IAAI,wBAAwB,KAAK,CAAC;QACvF,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;QAC/F,KAAK,CAAC;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;YACjC,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,wBAAwB,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,WAAW,CAAC,CAAC;YACtD,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAkG,CAAC;YAC9H,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,EAAE,EAAE,CAAC,CAAC,IAAI;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;aACZ,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;CACD"}

package/dist/ai/openai.d.ts

@@ -0,0 +1,46 @@
+import type { AIProvider } from './base.js';
+import type { ChatRequest, ChatResponse } from './types.js';
+/**
+ * OpenAIProvider 初始化参数
+ */
+export interface OpenAIConfig {
+    /** API 密钥 */
+    apiKey: string;
+    /** API 基础地址，例如 https://api.openai.com/v1 */
+    baseURL: string;
+    /** 默认模型名称 */
+    model: string;
+    /** 请求超时（毫秒），默认 60000 */
+    timeout?: number;
+    /** 最大重试次数，默认 2 */
+    maxRetries?: number;
+}
+/**
+ * OpenAI 兼容格式的 AI 供应商实现
+ *
+ * 封装 fetch 调用 /v1/chat/completions 端点，支持：
+ * - 非流式调用（chat）
+ * - SSE 流式调用（chatStream）
+ * - 自动重试（仅 5xx 错误 + 网络错误，指数退避）
+ * - 超时控制（AbortController）
+ * - usage / reasoning_content 透传
+ */
+export declare class OpenAIProvider implements AIProvider {
+    private apiKey;
+    private baseURL;
+    protected model: string;
+    private timeout;
+    private maxRetries;
+    constructor(config: OpenAIConfig);
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    chatStream(request: ChatRequest): AsyncGenerator<import('./types').StreamChunk>;
+    protected buildBodyObject(request: ChatRequest & {
+        stream: boolean;
+    }): Record<string, unknown>;
+    protected buildBody(request: ChatRequest & {
+        stream: boolean;
+    }): string;
+    private doFetch;
+    private parseResponse;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/ai/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/ai/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,UAAU;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,YAAY;IAQ1B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAYhD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC;IAgBtF,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAY9F,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;YAIzD,OAAO;IAoBrB,OAAO,CAAC,aAAa;CAkBrB"}