tianxincode 1.0.0

package/dist/modules/ai/react/react.parser.js

@@ -0,0 +1,278 @@
+/**
+ * ReAct 响应解析器
+ *
+ * 本模块负责解析 AI 返回的文本内容
+ * AI 返回的是包含 Thought、Action、Observation 等字段的文本
+ * 需要从中提取出结构化的步骤信息
+ *
+ * 解析流程：
+ * 1. splitBlocks() - 按 "---" 分隔符分割文本为多个块
+ * 2. 识别每块的类型：
+ *    - content: 大文本内容 (用于占位符替换)
+ *    - step: 步骤块 (包含 thought, action, action_input, final_answer 等)
+ *    - observation: 观察结果块
+ * 3. replacePlaceholders() - 替换占位符 (如 $content:1)
+ * 4. 返回结构化的 steps 数组和 finalAnswer
+ *
+ * AI 输出格式示例（XML）：
+ * ```xml
+ * <react>
+ *   <thought>我需要读取文件</thought>
+ *   <action>readFile</action>
+ *   <action_input>
+ *     <path>/path/to/file</path>
+ *   </action_input>
+ *   <keep_context>true</keep_context>
+ * </react>
+ * ---
+ * <react>
+ *   <thought>需要创建一个组件</thought>
+ *   <action>write_file</action>
+ *   <action_input>
+ *     <path>src/Hello.tsx</path>
+ *     <content><![CDATA[import React from 'react';]]></content>
+ *   </action_input>
+ * </react>
+ * ---
+ * Tool Result:
+ * ---
+ * 观察结果
+ * ---
+ * ```
+ */
+/**
+ * ReActParser 类
+ *
+ * 将 AI 返回的文本解析为结构化的 ReActStep 数组
+ */
+export class ReActParser {
+    parse(content) {
+        const blocks = this.splitBlocks(content);
+        const steps = [];
+        const contentMap = new Map();
+        let finalAnswer = '';
+        for (const block of blocks) {
+            if (block.type === 'content') {
+                contentMap.set(block.contentKey, block.content || '');
+            }
+            else if (block.type === 'step') {
+                const data = block.data;
+                const replacedInput = this.replacePlaceholders(data.action_input, contentMap);
+                if (data.final_answer) {
+                    finalAnswer = data.final_answer;
+                    steps.push({
+                        thought: data.thought || '',
+                        action: '',
+                        actionInput: {},
+                        final_answer: data.final_answer,
+                    });
+                }
+                else {
+                    steps.push({
+                        thought: data.thought || '',
+                        action: data.action || '',
+                        actionInput: replacedInput,
+                        keepContext: data.keep_context || false,
+                    });
+                }
+            }
+            else if (block.type === 'observation') {
+                const lastStep = steps[steps.length - 1];
+                if (lastStep) {
+                    lastStep.observation = block.data;
+                }
+            }
+        }
+        return { steps, finalAnswer };
+    }
+    splitBlocks(content) {
+        const blocks = [];
+        const parts = content.split(/\n---\n/);
+        for (const part of parts) {
+            const trimmed = part.trim();
+            if (!trimmed)
+                continue;
+            const contentMatch = trimmed.match(/^\$(\S+)\n([\s\S]*)$/);
+            if (contentMatch) {
+                blocks.push({
+                    type: 'content',
+                    contentKey: contentMatch[1],
+                    content: contentMatch[2],
+                });
+                continue;
+            }
+            // 尝试解析 XML 格式
+            const xmlResult = this.parseXMLBlock(trimmed);
+            if (xmlResult) {
+                blocks.push(xmlResult);
+                continue;
+            }
+            // 尝试解析 JSON 格式
+            try {
+                const json = JSON.parse(trimmed);
+                if (json.observation !== undefined) {
+                    blocks.push({ type: 'observation', data: json.observation });
+                }
+                else {
+                    blocks.push({ type: 'step', data: json });
+                }
+            }
+            catch {
+                // 尝试提取 JSON 代码块
+                const jsonBlockMatch = trimmed.match(/```json\s*([\s\S]*?)```/);
+                if (jsonBlockMatch) {
+                    try {
+                        const json = JSON.parse(jsonBlockMatch[1].trim());
+                        if (json.observation !== undefined) {
+                            blocks.push({ type: 'observation', data: json.observation });
+                        }
+                        else {
+                            blocks.push({ type: 'step', data: json });
+                        }
+                    }
+                    catch {
+                        // 忽略解析失败
+                    }
+                }
+            }
+        }
+        return blocks;
+    }
+    /**
+     * 解析 XML 格式的块
+     */
+    parseXMLBlock(content) {
+        // 匹配 <react>...</react> 块
+        const reactMatch = content.match(/<react>([\s\S]*?)<\/react>/i);
+        if (!reactMatch)
+            return null;
+        const inner = reactMatch[1];
+        const data = {};
+        // 解析 thought
+        const thoughtMatch = inner.match(/<thought>([\s\S]*?)<\/thought>/i);
+        if (thoughtMatch) {
+            data.thought = thoughtMatch[1].trim();
+        }
+        // 解析 final_answer（可能包含 CDATA）
+        const finalAnswerMatch = inner.match(/<final_answer>([\s\S]*?)<\/final_answer>/i);
+        if (finalAnswerMatch) {
+            data.final_answer = this.extractCDATAOrText(finalAnswerMatch[1]);
+            return { type: 'step', data };
+        }
+        // 解析 action
+        const actionMatch = inner.match(/<action>([\s\S]*?)<\/action>/i);
+        if (actionMatch) {
+            data.action = actionMatch[1].trim();
+        }
+        // 解析 keep_context
+        const keepContextMatch = inner.match(/<keep_context>([\s\S]*?)<\/keep_context>/i);
+        if (keepContextMatch) {
+            data.keep_context = keepContextMatch[1].trim().toLowerCase() === 'true';
+        }
+        // 解析 action_input 内的所有参数
+        const actionInputMatch = inner.match(/<action_input>([\s\S]*?)<\/action_input>/i);
+        if (actionInputMatch) {
+            data.action_input = this.parseXMLParams(actionInputMatch[1]);
+        }
+        return { type: 'step', data };
+    }
+    /**
+     * 解析 XML 参数节点
+     */
+    parseXMLParams(xml) {
+        const params = {};
+        // 匹配所有 <param_name>...</param_name> 或 <param_name/>
+        const paramRegex = /<(\w+)>([\s\S]*?)<\/\1>/gi;
+        let match;
+        while ((match = paramRegex.exec(xml)) !== null) {
+            const paramName = match[1];
+            const paramValue = match[2];
+            params[paramName] = this.extractCDATAOrText(paramValue);
+        }
+        return params;
+    }
+    /**
+     * 从 XML 内容中提取纯文本，处理 CDATA
+     */
+    extractCDATAOrText(content) {
+        // 匹配 CDATA
+        const cdataMatch = content.match(/<!\[CDATA\[([\s\S]*?)\]\]>/);
+        if (cdataMatch) {
+            return cdataMatch[1];
+        }
+        return content.trim();
+    }
+    replacePlaceholders(obj, contentMap) {
+        if (!obj)
+            return {};
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === 'string') {
+                const match = value.match(/^\$(\S+)$/);
+                if (match) {
+                    const placeholderKey = match[1];
+                    const replacement = contentMap.get(placeholderKey);
+                    if (replacement !== undefined) {
+                        result[key] = replacement;
+                    }
+                    else {
+                        result[key] = value;
+                    }
+                }
+                else if (this.isEncodedContent(value)) {
+                    result[key] = this.decodeContent(value);
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+            else if (typeof value === 'object' && value !== null) {
+                result[key] = this.replacePlaceholders(value, contentMap);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    isEncodedContent(value) {
+        if (value.startsWith('$$content:') || value.includes('$content:2')) {
+            return true;
+        }
+        const dollarCount = (value.match(/\$/g) || []).length;
+        if (dollarCount > 3 && value.includes('content:')) {
+            return true;
+        }
+        return false;
+    }
+    decodeContent(value) {
+        const decodedParts = [];
+        const regex = /\$\$?content:(\d+)([a-zA-Z])/g;
+        let match;
+        while ((match = regex.exec(value)) !== null) {
+            decodedParts.push(match[2]);
+        }
+        return decodedParts.length > 0 ? decodedParts.join('') : value;
+    }
+    hasFinalAnswer(steps) {
+        return steps.some(s => s.final_answer !== undefined);
+    }
+    formatObservation(observation) {
+        if (typeof observation === 'string') {
+            return observation;
+        }
+        return JSON.stringify(observation, null, 2);
+    }
+    buildObservationResponse(observation) {
+        const formattedObs = typeof observation === 'string'
+            ? `<![CDATA[${observation}]]>`
+            : `<![CDATA[${JSON.stringify(observation, null, 2)}]]>`;
+        return `---
+<react>
+  <observation>${formattedObs}</observation>
+</react>
+---`;
+    }
+}
+export const reactParser = new ReActParser();
+//# sourceMappingURL=react.parser.js.map

package/dist/modules/ai/react/react.parser.js.map

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

package/dist/modules/ai/react/react.prompts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ReAct 提示词模块
+ *
+ * 本模块定义了 AI Agent 的系统提示词模板
+ *
+ * ReAct (Reasoning + Acting) 模式：
+ * 1. Thought - AI 分析当前情况，进行思考
+ * 2. Action - AI 选择并执行一个工具
+ * 3. Observation - AI 观察工具执行结果
+ * 4. 重复直到得到最终答案
+ *
+ * 提示词结构：
+ * 1. 角色定义 - AI 身份和工作职责
+ * 2. 运行环境 - 操作系统、工作目录
+ * 3. 工作模式 - ReAct 循环说明
+ * 4. 上下文管理 - keep_context 机制
+ * 5. 输出格式 - JSON 格式要求
+ * 6. 工具定义 - 内置工具列表
+ * 7. 技能系统 - skill 工具说明
+ */
+import { ToolDefinition, SkillInfo } from './react.types.js';
+export declare function buildReActPrompt(builtinTools: ToolDefinition[], _skills: SkillInfo[], maxIterations?: number, options?: {
+    platform?: string;
+    workdir?: string;
+}): Promise<string>;
+//# sourceMappingURL=react.prompts.d.ts.map

package/dist/modules/ai/react/react.prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.prompts.d.ts","sourceRoot":"","sources":["../../../../src/modules/ai/react/react.prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA+I7D,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,cAAc,EAAE,EAC9B,OAAO,EAAE,SAAS,EAAE,EACpB,aAAa,GAAE,MAAW,EAC1B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/modules/ai/react/react.prompts.js

@@ -0,0 +1,180 @@
+/**
+ * ReAct 提示词模块
+ *
+ * 本模块定义了 AI Agent 的系统提示词模板
+ *
+ * ReAct (Reasoning + Acting) 模式：
+ * 1. Thought - AI 分析当前情况，进行思考
+ * 2. Action - AI 选择并执行一个工具
+ * 3. Observation - AI 观察工具执行结果
+ * 4. 重复直到得到最终答案
+ *
+ * 提示词结构：
+ * 1. 角色定义 - AI 身份和工作职责
+ * 2. 运行环境 - 操作系统、工作目录
+ * 3. 工作模式 - ReAct 循环说明
+ * 4. 上下文管理 - keep_context 机制
+ * 5. 输出格式 - JSON 格式要求
+ * 6. 工具定义 - 内置工具列表
+ * 7. 技能系统 - skill 工具说明
+ */
+import { buildAvailableSkillsPrompt } from '../../skill/skill.tool.js';
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+async function loadRoleTemplate() {
+    try {
+        return await fs.readFile(path.join(__dirname, 'prompt', 'role.txt'), 'utf-8');
+    }
+    catch {
+        return '你是 txcode，一个帮助用户完成软件工程任务的交互式命令行工具。';
+    }
+}
+function getReActPromptTemplate(roleTemplate) {
+    return `${roleTemplate}
+
+你必须按照 ReAct (Reasoning + Acting) 模式工作：
+
+1. **Thought**: 分析当前情况，思考下一步应该做什么
+2. **Action**: 选择并执行一个工具
+3. **Observation**: 观察工具执行结果，判断是否重要
+4. 重复步骤 1-3 直到得到答案
+5. **Final Answer**: 给出最终回答
+
+## 上下文管理（重要）
+
+每轮工具执行后，你需要判断这个结果是否需要传递给下一轮：
+
+**需要传递（keep_context: true）- 永久记忆：**
+- 这个结果会影响你后续的决策
+- 用户可能后续会问关于这个结果的问题
+- 这是完成任务的必要中间信息
+- 创建/修改了重要文件
+- 发现了项目关键信息（技术栈、依赖、配置）
+
+**不需要传递（keep_context: false）- 临时记忆：**
+- 只是探索性查看，后续不会再用到
+- 纯调试性输出
+- 已经完成的任务，后续不需要再提及
+
+## 输出格式（重要）
+
+输出格式必须是有效的 XML，不要包含其他文本：
+
+**调用工具时：**
+\`\`\`xml
+<react>
+  <thought>你的思考过程</thought>
+  <action>工具名称</action>
+  <action_input>
+    <参数名>参数值</参数名>
+  </action_input>
+  <keep_context>true</keep_context>
+</react>
+\`\`\`
+
+**需要写入/编辑文件时，内容使用 CDATA 包裹：**
+\`\`\`xml
+<react>
+  <thought>需要创建一个组件</thought>
+  <action>write_file</action>
+  <action_input>
+    <path>src/components/Hello.tsx</path>
+    <content><![CDATA[import React from 'react';
+export const Hello = () => {
+  return <div>Hello World</div>;
+};]]></content>
+  </action_input>
+  <keep_context>true</keep_context>
+</react>
+\`\`\`
+
+**返回最终答案时：**
+\`\`\`xml
+<react>
+  <thought>任务已完成</thought>
+  <final_answer><![CDATA[详细的完成结果]]></final_answer>
+</react>
+\`\`\`
+
+## 字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| \`thought\` | string | 你的思考过程 |
+| \`action\` | string | 要执行的工具名称 |
+| \`action_input\` | object | 工具参数 |
+| \`keep_context\` | boolean | 是否将此结果永久记忆并传递给下一轮（默认 false） |
+| \`final_answer\` | string | 最终回答（仅在任务完成时使用），使用 CDATA 包裹 |
+| \`content\` | string | write_file/edit_file 的文件内容，使用 CDATA 包裹 |
+
+## 内置工具
+
+<builtin_tools>
+{builtinTools}
+</builtin_tools>
+
+## skill 工具
+
+在执行特定任务前，可以使用 skill 工具加载相关的 Skill 指南，了解该领域的约束、最佳实践和操作方法：
+
+\`\`\`xml
+<react>
+  <thought>用户要求创建发布版本，我需要先查看 git-release Skill</thought>
+  <action>skill</action>
+  <action_input>
+    <name>git-release</name>
+  </action_input>
+</react>
+\`\`\`
+
+skill 参数：
+<tool>
+  <name>skill</name>
+  <description>加载一个 Skill，获取其完整内容和使用说明</description>
+  <parameters>
+    <name type="string">Skill 名称（必填），例如：git-release, testing-guide, code-review 等</name>
+  </parameters>
+</tool>
+
+加载成功后，返回该 Skill 的完整内容。AI 会根据 Skill 中的指南来执行任务，确保遵循最佳实践和约束。
+
+## 可用 Skills
+
+{skills}
+
+## 重要规则
+
+- 优先使用内置工具
+- 在执行任务前，先使用 skill 加载相关 Skill 指南了解约束和最佳实践
+- 加载 Skill 后，其提供的工具会自动可用
+- 每个步骤后用 \\n---\\n 分隔
+- 如果工具执行失败，思考原因并尝试其他方法
+- 谨慎设置 keep_context=true，只对需要传递给下一轮的重要结果设置
+- 最大迭代次数: {maxIterations}
+`;
+}
+export async function buildReActPrompt(builtinTools, _skills, maxIterations = 10, options) {
+    const platform = options?.platform || process.platform;
+    const workdir = options?.workdir || process.cwd();
+    const platformName = platform === 'win32' ? 'Windows'
+        : platform === 'darwin' ? 'macOS'
+            : platform === 'linux' ? 'Linux'
+                : platform;
+    const builtinToolsDesc = builtinTools.map(t => {
+        const params = Object.entries(t.parameters.properties).map(([name, prop]) => `    <${name} type="${prop.type}">${prop.description}</${name}>`).join('\n');
+        return `<tool>\n  <name>${t.name}</name>\n  <description>${t.description}</description>\n  <parameters>\n${params}\n  </parameters>\n</tool>`;
+    }).join('\n');
+    const skillsPrompt = await buildAvailableSkillsPrompt();
+    const roleTemplate = await loadRoleTemplate();
+    const template = getReActPromptTemplate(roleTemplate);
+    return template
+        .replace('{platform}', platformName)
+        .replace('{workdir}', workdir)
+        .replace('{builtinTools}', builtinToolsDesc || '（无）')
+        .replace('{skills}', skillsPrompt)
+        .replace('{maxIterations}', String(maxIterations));
+}
+//# sourceMappingURL=react.prompts.js.map

package/dist/modules/ai/react/react.prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.prompts.js","sourceRoot":"","sources":["../../../../src/modules/ai/react/react.prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,KAAK,UAAU,gBAAgB;IAC7B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,oCAAoC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAoB;IAClD,OAAO,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHvB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA8B,EAC9B,OAAoB,EACpB,gBAAwB,EAAE,EAC1B,OAAiD;IAEjD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAElD,MAAM,YAAY,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS;QACnD,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO;YACjC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO;gBAChC,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAC1E,QAAQ,IAAI,UAAU,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,KAAK,IAAI,GAAG,CACjE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,mBAAmB,CAAC,CAAC,IAAI,2BAA2B,CAAC,CAAC,WAAW,mCAAmC,MAAM,4BAA4B,CAAC;IAChJ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,YAAY,GAAG,MAAM,0BAA0B,EAAE,CAAC;IACxD,MAAM,YAAY,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAEtD,OAAO,QAAQ;SACZ,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC;SACnC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC;SAC7B,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,IAAI,KAAK,CAAC;SACpD,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;SACjC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,47 @@
+export interface ToolParameterProperty {
+    type: string;
+    description: string;
+}
+export interface ToolParameters {
+    type: 'object';
+    properties: Record<string, ToolParameterProperty>;
+    required: string[];
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: ToolParameters;
+}
+export interface ReActStep {
+    thought: string;
+    action: string;
+    actionInput: Record<string, any>;
+    observation?: any;
+    error?: string;
+    keepContext?: boolean;
+    final_answer?: string;
+}
+export interface ReActResult {
+    answer: string;
+    steps: ReActStep[];
+    iterations: number;
+    success: boolean;
+    error?: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface ParsedBlock {
+    type: 'step' | 'observation' | 'content';
+    data?: any;
+    contentKey?: string;
+    content?: string;
+}
+export interface SkillInfo {
+    path: string;
+    name: string;
+    description: string;
+}
+//# sourceMappingURL=react.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react.types.d.ts","sourceRoot":"","sources":["../../../../src/modules/ai/react/react.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACzC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

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

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

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

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

package/dist/modules/ai/react.agent.d.ts

@@ -0,0 +1,40 @@
+import { OpenAIProvider } from './openai.provider.js';
+import { ChatMessage } from './ai.types.js';
+import { ToolService } from '../tools/tool.service.js';
+import { SkillsManager } from '../skill/skills.manager.js';
+import { MemoryService } from '../memory/memory.service.js';
+import { ReActStep, ReActResult } from './react/react.types.js';
+export interface ReActAgentConfig {
+    provider: OpenAIProvider;
+    toolService: ToolService;
+    skillsManager?: SkillsManager;
+    memoryService?: MemoryService;
+    maxIterations?: number;
+    projectPath?: string;
+    sessionId?: string;
+}
+export interface ReActRunOptions {
+    onStep?: (step: ReActStep, iteration: number, usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }) => void;
+    historyMessages?: ChatMessage[];
+}
+export declare class ReActAgent {
+    private provider;
+    private toolService;
+    private skillsManager?;
+    private memoryService?;
+    private sessionService;
+    private maxIterations;
+    private projectPath?;
+    private sessionId?;
+    constructor(config: ReActAgentConfig);
+    run(userMessage: string, options?: ReActRunOptions): Promise<ReActResult>;
+    private executeTool;
+    private getBuiltinTools;
+    private getAvailableSkills;
+    private addMessage;
+}
+//# sourceMappingURL=react.agent.d.ts.map

package/dist/modules/ai/react.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.agent.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/react.agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,OAAO,EAAE,SAAS,EAAE,WAAW,EAA6B,MAAM,wBAAwB,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvI,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;CACjC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,EAAE,gBAAgB;IAW9B,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,WAAW,CAAC;YAyGT,WAAW;YAeX,eAAe;YAqBf,kBAAkB;IAYhC,OAAO,CAAC,UAAU;CAInB"}