tianxincode 1.0.0

package/dist/lsp/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * LSP 类型定义
+ */
+export interface LSPServerInfo {
+    id: string;
+    name: string;
+    extensions: string[];
+    downloadUrl?: string;
+    downloadType?: "npm" | "github" | "go" | "gem" | "dotnet" | "bun";
+    installCommand?: string[];
+    binaryName: string;
+    rootMarkers: string[];
+    requiresJava?: boolean;
+    minJavaVersion?: number;
+    requiresSystemBinary?: boolean;
+    defaultArgs?: string[];
+}
+export interface LSPConfig {
+    enabled: boolean;
+    autoStart: boolean;
+}
+export interface ServerStatus {
+    status: LSPServerStatus;
+    error?: string;
+    version?: number;
+}
+export declare enum LSPServerStatus {
+    Stopped = "stopped",
+    Running = "running",
+    Downloading = "downloading",
+    DownloadFailed = "download_failed",
+    NotFound = "not_found",
+    VersionError = "version_error"
+}
+export interface LSPClient {
+    serverId: string;
+    connection: any;
+    processes: any[];
+    documentUri?: string;
+}
+export interface LSPServerRecord {
+    id: string;
+    enabled: number;
+    auto_start: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface JavaVersionCheck {
+    valid: boolean;
+    version?: number;
+    error?: string;
+}
+export interface DownloadProgress {
+    serverId: string;
+    progress: number;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lsp/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,cAAc,oBAAoB;IAClC,QAAQ,cAAc;IACtB,YAAY,kBAAkB;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/lsp/types.js

@@ -0,0 +1,13 @@
+/**
+ * LSP 类型定义
+ */
+export var LSPServerStatus;
+(function (LSPServerStatus) {
+    LSPServerStatus["Stopped"] = "stopped";
+    LSPServerStatus["Running"] = "running";
+    LSPServerStatus["Downloading"] = "downloading";
+    LSPServerStatus["DownloadFailed"] = "download_failed";
+    LSPServerStatus["NotFound"] = "not_found";
+    LSPServerStatus["VersionError"] = "version_error";
+})(LSPServerStatus || (LSPServerStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/lsp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lsp/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4BH,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;IACnB,8CAA2B,CAAA;IAC3B,qDAAkC,CAAA;IAClC,yCAAsB,CAAA;IACtB,iDAA8B,CAAA;AAChC,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B"}

package/dist/modules/ai/ai.service.d.ts

@@ -0,0 +1,182 @@
+/**
+ * AI 服务模块
+ *
+ * 本模块是 TXCode 的核心 AI 服务层，负责：
+ * 1. AI Provider 管理 - 创建和管理 OpenAI/自定义 API 提供商
+ * 2. 对话接口 - 提供 chat() 和 chatStream() 方法
+ * 3. ReAct 集成 - 通过 ReActAgent 执行工具调用循环
+ * 4. 上下文管理 - 加载会话历史、项目上下文
+ * 5. 自动压缩 - 当 Token 达到阈值时自动压缩会话历史
+ *
+ * 使用方式：
+ *   import { aiService } from '../modules/ai/index.js';
+ *   const result = await aiService.chatWithReAct("帮我读取文件", { sessionId: "xxx" });
+ */
+import { ConfigService } from '../config/config.service.js';
+import { ChatMessage, ChatOptions, ChatResponse } from './ai.types.js';
+import { ToolService } from '../tools/tool.service.js';
+import { MemoryService } from '../memory/memory.service.js';
+import { ContextService } from '../context/context.service.js';
+import { SkillsManager } from '../skill/skills.manager.js';
+import { ReActResult } from './react/react.types.js';
+/**
+ * AIService 构造函数配置参数
+ */
+export interface AIServiceConfig {
+    /** 配置服务 (AI Provider、模型等配置) */
+    configService?: ConfigService;
+    /** 工具服务 (内置/自定义工具) */
+    toolService?: ToolService;
+    /** 技能管理器 (自定义技能) */
+    skillsManager?: SkillsManager;
+    /** ReAct Agent 最大迭代次数 */
+    maxToolIterations?: number;
+}
+/**
+ * AIService 类
+ *
+ * AI 服务的封装类，提供以下功能：
+ * - chat(): 简单的 AI 对话
+ * - chatStream(): 流式 AI 对话
+ * - chatWithReAct(): 带工具调用的 AI 对话
+ *
+ * 典型使用流程：
+ * 1. 用户发送消息 -> API 路由接收
+ * 2. API 调用 aiService.chatWithReAct()
+ * 3. AIService 获取会话历史，构建消息列表
+ * 4. 创建 ReActAgent 并执行循环
+ * 5. 返回结果给 API
+ * 6. API 返回给客户端
+ */
+export declare class AIService {
+    /** 配置服务实例 */
+    private configService;
+    /** 工具服务实例 */
+    private toolService;
+    /** 会话服务实例 */
+    private sessionService;
+    /** 技能管理器实例 (可选) */
+    private skillsManager?;
+    /** AI Provider 实例 (延迟初始化) */
+    private provider;
+    /** ReAct Agent 最大迭代次数 */
+    private maxToolIterations;
+    /**
+     * 构造函数
+     *
+     * @param config - AIServiceConfig 配置对象
+     *   - 如果不提供配置，使用默认服务实例
+     *   - 允许自定义 ConfigService、ToolService、SkillsManager 等
+     */
+    constructor(config?: AIServiceConfig);
+    /**
+     * 获取 AI Provider 实例
+     *
+     * 使用延迟初始化模式：
+     * - 第一次调用时创建 Provider 实例
+     * - 后续调用直接返回缓存的实例
+     *
+     * Provider 创建流程：
+     * 1. 从配置服务获取默认 AI 提供商
+     * 2. 获取该提供商的模型列表
+     * 3. 找到启用的模型 (或默认使用 gpt-4)
+     * 4. 创建 OpenAIProvider 实例
+     *
+     * @returns {OpenAIProvider} AI Provider 实例
+     * @throws {Error} 如果没有配置默认 AI 提供商
+     */
+    private getProvider;
+    /**
+     * 简单的 AI 对话接口
+     *
+     * 与 chatWithReAct 的区别：
+     * - 不执行 ReAct 循环
+     * - 不支持工具调用
+     * - 适用于简单的问答场景
+     *
+     * @param messages - 消息数组 (包含 role 和 content)
+     * @param options - 可选配置 (temperature, maxTokens, model 等)
+     * @returns {Promise<ChatResponse>} AI 响应
+     */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
+    /**
+     * 带工具调用的 AI 对话接口 (核心方法)
+     *
+     * 这是 TXCode 最核心的方法，执行 ReAct 循环来完成任务
+     *
+     * 执行流程：
+     * 1. 获取/创建 AI Provider
+     * 2. 获取会话历史消息
+     * 3. 创建 ReActAgent
+     * 4. 执行 agent.run() 启动 ReAct 循环
+     * 5. 更新会话 Token 统计
+     * 6. 检查是否需要压缩会话 (自动摘要)
+     * 7. 返回结果
+     *
+     * @param userMessage - 用户输入的消息
+     * @param options - 配置选项
+     *   - sessionId: 会话 ID
+     *   - projectPath: 项目路径
+     *   - memoryService: 记忆服务实例
+     *   - contextService: 上下文服务实例
+     *   - onStep: 每一步执行完的回调
+     * @returns {Promise<ReActResult>} ReAct 执行结果
+     */
+    chatWithReAct(userMessage: string, options?: {
+        sessionId?: string;
+        projectPath?: string;
+        memoryService?: MemoryService;
+        contextService?: ContextService;
+        onStep?: (step: any, iteration: number) => void;
+        onCompact?: (info: {
+            beforeTokens: number;
+            afterTokens: number;
+        }) => void;
+    }): Promise<ReActResult>;
+    /**
+     * 流式 AI 对话接口
+     *
+     * 使用 AsyncGenerator 实现流式响应
+     * 每次 yield 返回一个内容块
+     *
+     * @param messages - 消息数组
+     * @param options - 可选配置
+     * @returns {AsyncGenerator<string>} 异步生成器，逐块返回 AI 响应
+     */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<string, void, unknown>;
+    /**
+     * 设置 API 密钥
+     *
+     * 用于动态更新 AI Provider 的 API 密钥
+     * 调用后会重置 provider 实例
+     *
+     * @param apiKey - 新的 API 密钥
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * 设置 API 基础 URL
+     *
+     * 用于切换到不同的 AI API 端点
+     * 如从 OpenAI 切换到自定义兼容 API
+     *
+     * @param baseUrl - 新的 API 基础 URL
+     */
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * 重置 AI Provider
+     *
+     * 将 provider 设置为 null，下次调用时会重新创建
+     * 用于强制刷新 Provider 配置
+     */
+    resetProvider(): void;
+}
+/**
+ * AI 服务单例实例
+ *
+ * 在整个应用中共享同一个 AIService 实例
+ * 使用方式：
+ *   import { aiService } from '../modules/ai/index.js';
+ *   const result = await aiService.chatWithReAct("问题", { sessionId: "xxx" });
+ */
+export declare const aiService: AIService;
+//# sourceMappingURL=ai.service.d.ts.map

package/dist/modules/ai/ai.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.service.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/ai.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAyC,MAAM,6BAA6B,CAAC;AAGnG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,WAAW,EAAqC,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,sBAAsB;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oBAAoB;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACpB,aAAa;IACb,OAAO,CAAC,aAAa,CAAgB;IACrC,aAAa;IACb,OAAO,CAAC,WAAW,CAAc;IACjC,aAAa;IACb,OAAO,CAAC,cAAc,CAAiB;IACvC,mBAAmB;IACnB,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAA+B;IAC/C,yBAAyB;IACzB,OAAO,CAAC,iBAAiB,CAAS;IAElC;;;;;;OAMG;gBACS,MAAM,CAAC,EAAE,eAAe;IASpC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;;;;;;;;;OAWG;IACG,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC;IAKxB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;QAChD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAC3E,GACA,OAAO,CAAC,WAAW,CAAC;IA6GvB;;;;;;;;;OASG;IACI,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,WAAgB,GACxB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAMxC;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;;OAKG;IACH,aAAa,IAAI,IAAI;CAGtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/modules/ai/ai.service.js

@@ -0,0 +1,280 @@
+/**
+ * AI 服务模块
+ *
+ * 本模块是 TXCode 的核心 AI 服务层，负责：
+ * 1. AI Provider 管理 - 创建和管理 OpenAI/自定义 API 提供商
+ * 2. 对话接口 - 提供 chat() 和 chatStream() 方法
+ * 3. ReAct 集成 - 通过 ReActAgent 执行工具调用循环
+ * 4. 上下文管理 - 加载会话历史、项目上下文
+ * 5. 自动压缩 - 当 Token 达到阈值时自动压缩会话历史
+ *
+ * 使用方式：
+ *   import { aiService } from '../modules/ai/index.js';
+ *   const result = await aiService.chatWithReAct("帮我读取文件", { sessionId: "xxx" });
+ */
+import { configService as defaultConfigService } from '../config/config.service.js';
+import { OpenAIProvider } from './openai.provider.js';
+import { ReActAgent } from './react.agent.js';
+import { toolService as defaultToolService } from '../tools/tool.service.js';
+import { MemoryService } from '../memory/memory.service.js';
+import { sessionService as defaultSessionService } from '../session/session.service.js';
+import { SummarizerService } from './summarizer/index.js';
+import txConfig from '../../config/tx.config.js';
+/**
+ * AIService 类
+ *
+ * AI 服务的封装类，提供以下功能：
+ * - chat(): 简单的 AI 对话
+ * - chatStream(): 流式 AI 对话
+ * - chatWithReAct(): 带工具调用的 AI 对话
+ *
+ * 典型使用流程：
+ * 1. 用户发送消息 -> API 路由接收
+ * 2. API 调用 aiService.chatWithReAct()
+ * 3. AIService 获取会话历史，构建消息列表
+ * 4. 创建 ReActAgent 并执行循环
+ * 5. 返回结果给 API
+ * 6. API 返回给客户端
+ */
+export class AIService {
+    /**
+     * 构造函数
+     *
+     * @param config - AIServiceConfig 配置对象
+     *   - 如果不提供配置，使用默认服务实例
+     *   - 允许自定义 ConfigService、ToolService、SkillsManager 等
+     */
+    constructor(config) {
+        /** AI Provider 实例 (延迟初始化) */
+        this.provider = null;
+        this.configService = config?.configService || defaultConfigService;
+        this.toolService = config?.toolService || defaultToolService;
+        this.sessionService = defaultSessionService;
+        this.skillsManager = config?.skillsManager;
+        // 从配置文件读取最大迭代次数，默认值为 txConfig.maxToolIterations
+        this.maxToolIterations = config?.maxToolIterations || txConfig.maxToolIterations;
+    }
+    /**
+     * 获取 AI Provider 实例
+     *
+     * 使用延迟初始化模式：
+     * - 第一次调用时创建 Provider 实例
+     * - 后续调用直接返回缓存的实例
+     *
+     * Provider 创建流程：
+     * 1. 从配置服务获取默认 AI 提供商
+     * 2. 获取该提供商的模型列表
+     * 3. 找到启用的模型 (或默认使用 gpt-4)
+     * 4. 创建 OpenAIProvider 实例
+     *
+     * @returns {OpenAIProvider} AI Provider 实例
+     * @throws {Error} 如果没有配置默认 AI 提供商
+     */
+    getProvider() {
+        // 延迟初始化：只有当 provider 为 null 时才创建
+        if (!this.provider) {
+            // ========== 获取默认 AI 提供商配置 ==========
+            const providerConfig = this.configService.getDefaultProvider();
+            if (!providerConfig) {
+                throw new Error('No default AI provider configured');
+            }
+            // ========== 获取模型列表 ==========
+            const models = this.configService.getModels(providerConfig.id);
+            // 找到启用的模型，如果没有启用任何模型则默认使用 gpt-4
+            const defaultModel = models.find(m => m.enabled) || { name: 'gpt-4' };
+            // ========== 创建 Provider 实例 ==========
+            this.provider = new OpenAIProvider({
+                apiKey: providerConfig.apiKey, // API 密钥
+                baseUrl: providerConfig.baseUrl, // API 基础 URL
+                defaultModel: defaultModel.name, // 默认模型名称
+            });
+        }
+        return this.provider;
+    }
+    /**
+     * 简单的 AI 对话接口
+     *
+     * 与 chatWithReAct 的区别：
+     * - 不执行 ReAct 循环
+     * - 不支持工具调用
+     * - 适用于简单的问答场景
+     *
+     * @param messages - 消息数组 (包含 role 和 content)
+     * @param options - 可选配置 (temperature, maxTokens, model 等)
+     * @returns {Promise<ChatResponse>} AI 响应
+     */
+    async chat(messages, options = {}) {
+        const provider = this.getProvider();
+        return provider.chat(messages, options);
+    }
+    /**
+     * 带工具调用的 AI 对话接口 (核心方法)
+     *
+     * 这是 TXCode 最核心的方法，执行 ReAct 循环来完成任务
+     *
+     * 执行流程：
+     * 1. 获取/创建 AI Provider
+     * 2. 获取会话历史消息
+     * 3. 创建 ReActAgent
+     * 4. 执行 agent.run() 启动 ReAct 循环
+     * 5. 更新会话 Token 统计
+     * 6. 检查是否需要压缩会话 (自动摘要)
+     * 7. 返回结果
+     *
+     * @param userMessage - 用户输入的消息
+     * @param options - 配置选项
+     *   - sessionId: 会话 ID
+     *   - projectPath: 项目路径
+     *   - memoryService: 记忆服务实例
+     *   - contextService: 上下文服务实例
+     *   - onStep: 每一步执行完的回调
+     * @returns {Promise<ReActResult>} ReAct 执行结果
+     */
+    async chatWithReAct(userMessage, options) {
+        // ========== 步骤 1: 获取 AI Provider ==========
+        const provider = this.getProvider();
+        const sessionId = options?.sessionId;
+        // ========== 步骤 2: 获取会话历史消息 ==========
+        /**
+         * 历史消息获取逻辑：
+         * 1. 如果有 sessionId 和 memoryService
+         * 2. 获取 session 的 summaryMessageId (摘要消息 ID)
+         * 3. 如果有摘要消息 ID，从该消息之后获取消息
+         * 4. 否则获取所有 keepContext=true 的消息
+         * 5. 转换为 ChatMessage 格式
+         */
+        let historyMessages = [];
+        if (sessionId && options?.memoryService) {
+            const session = this.sessionService.get(sessionId);
+            const summaryMessageId = session?.summaryMessageId || null;
+            const msgs = options.memoryService.getMessagesForAI(sessionId, summaryMessageId);
+            historyMessages = msgs.map(m => ({
+                role: m.role,
+                content: m.content,
+            }));
+        }
+        // ========== 步骤 3: 创建 ReAct Agent ==========
+        /**
+         * ReActAgent 初始化参数：
+         * - provider: AI Provider，用于调用 AI API
+         * - toolService: 工具服务，用于执行工具
+         * - skillsManager: 技能管理器，用于加载自定义技能
+         * - memoryService: 记忆服务，用于保存/获取消息
+         * - maxIterations: 最大迭代次数，防止无限循环
+         * - projectPath: 项目路径，提供项目上下文
+         * - sessionId: 会话 ID，关联会话
+         */
+        const agent = new ReActAgent({
+            provider,
+            toolService: this.toolService,
+            skillsManager: this.skillsManager,
+            memoryService: options?.memoryService,
+            maxIterations: this.maxToolIterations,
+            projectPath: options?.projectPath,
+            sessionId,
+        });
+        // ========== 步骤 4: 执行 ReAct 循环 ==========
+        const memoryService = options?.memoryService || new MemoryService();
+        const summarizer = new SummarizerService(this.sessionService, memoryService, this.configService);
+        const wrappedOnStep = options?.onStep
+            ? (step, iteration, usage) => {
+                options.onStep?.(step, iteration);
+                if (sessionId && usage && usage.totalTokens > 0) {
+                    this.sessionService.updateTokenUsage(sessionId, usage.promptTokens, usage.completionTokens);
+                    const check = summarizer.checkNeedsCompact(sessionId);
+                    if (check.needed) {
+                        console.log(`[AutoCompact] ${check.reason}, triggering compaction during iteration ${iteration}...`);
+                        summarizer.compact({ sessionId }).then(() => {
+                            options?.onCompact?.({ beforeTokens: check.totalTokens, afterTokens: 0 });
+                        });
+                    }
+                }
+            }
+            : undefined;
+        const result = await agent.run(userMessage, {
+            onStep: wrappedOnStep,
+            historyMessages,
+        });
+        // ========== 步骤 5: 更新 Token 统计 ==========
+        // 每次对话完成后，更新会话的 Token 使用量统计
+        if (sessionId && result.usage) {
+            this.sessionService.updateTokenUsage(sessionId, result.usage.promptTokens, result.usage.completionTokens);
+            // ========== 步骤 6: 检查是否需要压缩会话 ==========
+            /**
+             * 自动压缩机制：
+             * - 当会话 Token 达到阈值时触发
+             * - 使用 SummarizerService 将旧消息压缩为摘要
+             * - 减少发送给 AI 的上下文大小
+             * - 降低 API 调用成本
+             */
+            const summarizer = new SummarizerService(this.sessionService, options?.memoryService || new MemoryService(), this.configService);
+            const check = summarizer.checkNeedsCompact(sessionId);
+            if (check.needed) {
+                console.log(`[AutoCompact] ${check.reason}, triggering compaction...`);
+                await summarizer.compact({ sessionId });
+            }
+        }
+        // ========== 步骤 7: 返回结果 ==========
+        return result;
+    }
+    /**
+     * 流式 AI 对话接口
+     *
+     * 使用 AsyncGenerator 实现流式响应
+     * 每次 yield 返回一个内容块
+     *
+     * @param messages - 消息数组
+     * @param options - 可选配置
+     * @returns {AsyncGenerator<string>} 异步生成器，逐块返回 AI 响应
+     */
+    async *chatStream(messages, options = {}) {
+        const provider = this.getProvider();
+        // 使用 yield* 将 provider 的生成器直接转发
+        yield* provider.chatStream(messages, options);
+    }
+    /**
+     * 设置 API 密钥
+     *
+     * 用于动态更新 AI Provider 的 API 密钥
+     * 调用后会重置 provider 实例
+     *
+     * @param apiKey - 新的 API 密钥
+     */
+    setApiKey(apiKey) {
+        this.provider = new OpenAIProvider({ apiKey });
+    }
+    /**
+     * 设置 API 基础 URL
+     *
+     * 用于切换到不同的 AI API 端点
+     * 如从 OpenAI 切换到自定义兼容 API
+     *
+     * @param baseUrl - 新的 API 基础 URL
+     */
+    setBaseUrl(baseUrl) {
+        const providerConfig = this.configService.getDefaultProvider();
+        this.provider = new OpenAIProvider({
+            apiKey: providerConfig?.apiKey || '',
+            baseUrl,
+        });
+    }
+    /**
+     * 重置 AI Provider
+     *
+     * 将 provider 设置为 null，下次调用时会重新创建
+     * 用于强制刷新 Provider 配置
+     */
+    resetProvider() {
+        this.provider = null;
+    }
+}
+/**
+ * AI 服务单例实例
+ *
+ * 在整个应用中共享同一个 AIService 实例
+ * 使用方式：
+ *   import { aiService } from '../modules/ai/index.js';
+ *   const result = await aiService.chatWithReAct("问题", { sessionId: "xxx" });
+ */
+export const aiService = new AIService();
+//# sourceMappingURL=ai.service.js.map

package/dist/modules/ai/ai.service.js.map

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

package/dist/modules/ai/ai.types.d.ts

@@ -0,0 +1,54 @@
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ChatOptions {
+    temperature?: number;
+    maxTokens?: number;
+    model?: string;
+    tools?: ToolDefinition[];
+}
+export interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+    };
+}
+export interface ChatResponse {
+    content: string;
+    finishReason: 'stop' | 'length' | 'tool_calls';
+    toolCalls?: ToolCall[];
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface ReActState {
+    thought: string;
+    action: string;
+    actionInput: string;
+    observation?: string;
+    answer?: string;
+    keepContext?: boolean;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export { ReActStep, ReActResult } from './react/react.types.js';
+//# sourceMappingURL=ai.types.d.ts.map

package/dist/modules/ai/ai.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.types.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/ai.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC/C,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/modules/ai/ai.types.js

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

package/dist/modules/ai/ai.types.js.map

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

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

@@ -0,0 +1,6 @@
+export { AIService, aiService } from './ai.service.js';
+export { OpenAIProvider } from './openai.provider.js';
+export { ReActAgent } from './react.agent.js';
+export type { ChatMessage, ChatOptions, ChatResponse, ToolCall, ToolDefinition, ReActState, ReActStep, ReActResult, } from './ai.types.js';
+export * from './react/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,cAAc,kBAAkB,CAAC"}

package/dist/modules/ai/index.js

@@ -0,0 +1,5 @@
+export { AIService, aiService } from './ai.service.js';
+export { OpenAIProvider } from './openai.provider.js';
+export { ReActAgent } from './react.agent.js';
+export * from './react/index.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAW9C,cAAc,kBAAkB,CAAC"}