openmatrix 0.1.0

package/dist/agents/impl/coder-agent.d.ts

@@ -0,0 +1,17 @@
+import type { Task, AgentType, AgentResult } from '../../types/index.js';
+/**
+ * Coder Agent - 代码编写
+ *
+ * 职责：
+ * - 根据任务描述编写代码
+ * - 遵循项目代码规范
+ * - 编写必要的注释
+ * - 确保代码可编译
+ */
+export declare class CoderAgent {
+    readonly type: AgentType;
+    readonly capabilities: string[];
+    execute(task: Task): Promise<AgentResult>;
+    private buildCoderPrompt;
+    private generateRunId;
+}

package/dist/agents/impl/coder-agent.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoderAgent = void 0;
+/**
+ * Coder Agent - 代码编写
+ *
+ * 职责：
+ * - 根据任务描述编写代码
+ * - 遵循项目代码规范
+ * - 编写必要的注释
+ * - 确保代码可编译
+ */
+class CoderAgent {
+    type = 'coder';
+    capabilities = ['code', 'refactor', 'debug', 'implement'];
+    async execute(task) {
+        const startTime = Date.now();
+        try {
+            const prompt = this.buildCoderPrompt(task);
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'coder',
+                status: 'completed',
+                output: prompt,
+                artifacts: [],
+                needsApproval: false,
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+        catch (error) {
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'coder',
+                status: 'failed',
+                output: '',
+                artifacts: [],
+                needsApproval: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+    }
+    buildCoderPrompt(task) {
+        return `
+# 编码任务
+
+## 任务描述
+
+${task.description}
+
+## 编码要求
+
+1. **代码风格**
+   - 遵循项目现有代码风格
+   - 使用项目配置的 linter
+   - 添加必要的类型定义
+
+2. **最佳实践**
+   - 单一职责原则
+   - 避免重复代码
+   - 合理的错误处理
+   - 适当的注释
+
+3. **安全性**
+   - 验证输入参数
+   - 避免注入攻击
+   - 保护敏感数据
+
+4. **可测试性**
+   - 依赖注入
+   - 纯函数优先
+   - 可 mock 的接口
+
+## 输出要求
+
+请实现代码，确保：
+
+- [ ] 代码可编译
+- [ ] 遵循项目规范
+- [ ] 添加必要的测试
+- [ ] 更新相关文档
+
+## 开始实现
+
+请阅读相关代码文件，然后实现功能。
+`;
+    }
+    generateRunId() {
+        return `coder-${Date.now().toString(36)}`;
+    }
+}
+exports.CoderAgent = CoderAgent;

package/dist/agents/impl/executor-agent.d.ts

@@ -0,0 +1,32 @@
+import type { Task, AgentType, AgentResult } from '../../types/index.js';
+/**
+ * Executor Agent - 命令执行
+ *
+ * 职责：
+ * - 执行构建命令
+ * - 运行测试
+ * - 部署应用
+ * - 清理环境
+ *
+ * 安全约束：
+ * - 不执行危险命令
+ * - 不暴露敏感信息
+ * - 验证命令参数
+ * - 记录执行日志
+ */
+export declare class ExecutorAgent {
+    readonly type: AgentType;
+    readonly capabilities: string[];
+    private readonly FORBIDDEN_PATTERNS;
+    execute(task: Task): Promise<AgentResult>;
+    /**
+     * 验证任务安全性
+     */
+    private validateTask;
+    /**
+     * 判断是否需要审批
+     */
+    private needsApproval;
+    private buildExecutorPrompt;
+    private generateRunId;
+}

package/dist/agents/impl/executor-agent.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutorAgent = void 0;
+/**
+ * Executor Agent - 命令执行
+ *
+ * 职责：
+ * - 执行构建命令
+ * - 运行测试
+ * - 部署应用
+ * - 清理环境
+ *
+ * 安全约束：
+ * - 不执行危险命令
+ * - 不暴露敏感信息
+ * - 验证命令参数
+ * - 记录执行日志
+ */
+class ExecutorAgent {
+    type = 'executor';
+    capabilities = ['build', 'test', 'deploy', 'clean', 'run'];
+    // 禁止执行的命令模式
+    FORBIDDEN_PATTERNS = [
+        /rm\s+-rf\s+\//, // rm -rf /
+        /rm\s+-rf\s+~/, // rm -rf ~
+        /:\(\)\{.*;\};/, // Fork bomb
+        />\s*\/dev\/sd/, // 写入磁盘
+        /dd\s+if=.*of=\/dev/, // dd 写入设备
+        /mkfs/, // 格式化
+        /shutdown/, // 关机
+        /reboot/, // 重启
+        /init\s+0/, // 关机
+    ];
+    async execute(task) {
+        const startTime = Date.now();
+        try {
+            // 安全检查
+            this.validateTask(task);
+            const prompt = this.buildExecutorPrompt(task);
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'executor',
+                status: 'completed',
+                output: prompt,
+                artifacts: [],
+                needsApproval: this.needsApproval(task),
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+        catch (error) {
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'executor',
+                status: 'failed',
+                output: '',
+                artifacts: [],
+                needsApproval: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+    }
+    /**
+     * 验证任务安全性
+     */
+    validateTask(task) {
+        const content = task.description.toLowerCase();
+        for (const pattern of this.FORBIDDEN_PATTERNS) {
+            if (pattern.test(content)) {
+                throw new Error(`安全限制: 检测到禁止执行的命令模式`);
+            }
+        }
+    }
+    /**
+     * 判断是否需要审批
+     */
+    needsApproval(task) {
+        const approvalKeywords = ['deploy', 'publish', 'release', 'production'];
+        const content = task.description.toLowerCase();
+        return approvalKeywords.some(kw => content.includes(kw));
+    }
+    buildExecutorPrompt(task) {
+        return `
+# 执行任务
+
+## 执行内容
+
+${task.description}
+
+## 安全约束
+
+⚠️ **重要安全规则**
+
+1. **禁止执行**
+   - 删除系统文件的命令
+   - 格式化磁盘的命令
+   - 关机/重启命令
+   - 任意代码注入
+
+2. **执行前确认**
+   - 检查命令参数
+   - 确认目标路径
+   - 备份重要数据
+
+3. **执行后验证**
+   - 检查执行结果
+   - 验证预期效果
+   - 记录执行日志
+
+## 执行步骤
+
+1. **环境检查**
+   \`\`\`bash
+   # 检查当前环境
+   pwd
+   node --version
+   npm --version
+   \`\`\`
+
+2. **执行命令**
+   \`\`\`bash
+   # 在此执行任务中的命令
+   \`\`\`
+
+3. **验证结果**
+   \`\`\`bash
+   # 检查执行结果
+   \`\`\`
+
+## 输出格式
+
+\`\`\`markdown
+# 执行报告
+
+## 命令
+\`\`\`bash
+[执行的命令]
+\`\`\`
+
+## 输出
+\`\`\`
+[命令输出]
+\`\`\`
+
+## 状态
+[✅ 成功 / ❌ 失败]
+
+## 耗时
+X 秒
+
+## 错误 (如有)
+[错误信息]
+\`\`\`
+
+## 开始执行
+
+请按步骤执行命令并记录结果。
+`;
+    }
+    generateRunId() {
+        return `executor-${Date.now().toString(36)}`;
+    }
+}
+exports.ExecutorAgent = ExecutorAgent;

package/dist/agents/impl/index.d.ts

@@ -0,0 +1,6 @@
+export { PlannerAgent } from './planner-agent.js';
+export { CoderAgent } from './coder-agent.js';
+export { TesterAgent } from './tester-agent.js';
+export { ReviewerAgent } from './reviewer-agent.js';
+export { ResearcherAgent } from './researcher-agent.js';
+export { ExecutorAgent } from './executor-agent.js';

package/dist/agents/impl/index.js

@@ -0,0 +1,17 @@
+"use strict";
+// src/agents/impl/index.ts
+// 导出所有 Agent 实现
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutorAgent = exports.ResearcherAgent = exports.ReviewerAgent = exports.TesterAgent = exports.CoderAgent = exports.PlannerAgent = void 0;
+var planner_agent_js_1 = require("./planner-agent.js");
+Object.defineProperty(exports, "PlannerAgent", { enumerable: true, get: function () { return planner_agent_js_1.PlannerAgent; } });
+var coder_agent_js_1 = require("./coder-agent.js");
+Object.defineProperty(exports, "CoderAgent", { enumerable: true, get: function () { return coder_agent_js_1.CoderAgent; } });
+var tester_agent_js_1 = require("./tester-agent.js");
+Object.defineProperty(exports, "TesterAgent", { enumerable: true, get: function () { return tester_agent_js_1.TesterAgent; } });
+var reviewer_agent_js_1 = require("./reviewer-agent.js");
+Object.defineProperty(exports, "ReviewerAgent", { enumerable: true, get: function () { return reviewer_agent_js_1.ReviewerAgent; } });
+var researcher_agent_js_1 = require("./researcher-agent.js");
+Object.defineProperty(exports, "ResearcherAgent", { enumerable: true, get: function () { return researcher_agent_js_1.ResearcherAgent; } });
+var executor_agent_js_1 = require("./executor-agent.js");
+Object.defineProperty(exports, "ExecutorAgent", { enumerable: true, get: function () { return executor_agent_js_1.ExecutorAgent; } });

package/dist/agents/impl/planner-agent.d.ts

@@ -0,0 +1,24 @@
+import type { Task, AgentType, AgentResult } from '../../types/index.js';
+/**
+ * Planner Agent - 任务规划
+ *
+ * 职责：
+ * - 分析任务需求
+ * - 拆解为子任务
+ * - 识别依赖关系
+ * - 制定执行计划
+ * - 评估风险和资源
+ */
+export declare class PlannerAgent {
+    readonly type: AgentType;
+    readonly capabilities: string[];
+    /**
+     * 执行规划任务
+     */
+    execute(task: Task): Promise<AgentResult>;
+    /**
+     * 构建规划提示词
+     */
+    private buildPlanPrompt;
+    private generateRunId;
+}

package/dist/agents/impl/planner-agent.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlannerAgent = void 0;
+/**
+ * Planner Agent - 任务规划
+ *
+ * 职责：
+ * - 分析任务需求
+ * - 拆解为子任务
+ * - 识别依赖关系
+ * - 制定执行计划
+ * - 评估风险和资源
+ */
+class PlannerAgent {
+    type = 'planner';
+    capabilities = ['plan', 'decompose', 'analyze', 'estimate'];
+    /**
+     * 执行规划任务
+     */
+    async execute(task) {
+        const startTime = Date.now();
+        try {
+            // 构建规划提示词
+            const prompt = this.buildPlanPrompt(task);
+            // 返回结果（实际执行由 Subagent 完成）
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'planner',
+                status: 'completed',
+                output: prompt,
+                artifacts: [],
+                needsApproval: true, // 计划需要审批
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+        catch (error) {
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'planner',
+                status: 'failed',
+                output: '',
+                artifacts: [],
+                needsApproval: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+    }
+    /**
+     * 构建规划提示词
+     */
+    buildPlanPrompt(task) {
+        return `
+# 任务规划
+
+## 原始需求
+
+${task.description}
+
+## 分析任务
+
+1. 理解核心目标
+2. 识别关键功能点
+3. 确定技术约束
+4. 评估复杂度
+
+## 输出计划
+
+请输出：
+
+\`\`\`markdown
+# 执行计划
+
+## 1. 任务概述
+[简要描述任务目标]
+
+## 2. 子任务拆解
+
+### Phase 1: [阶段名]
+- TASK-XXX-1: [任务描述]
+  - 预计时间: X min
+  - 依赖: 无
+
+- TASK-XXX-2: [任务描述]
+  - 预计时间: X min
+  - 依赖: TASK-XXX-1
+
+### Phase 2: [阶段名]
+...
+
+## 3. 依赖关系图
+
+\`\`\`
+TASK-001 ──┬──> TASK-002 ──> TASK-004
+           └──> TASK-003 ────────┘
+\`\`\`
+
+## 4. 风险评估
+
+| 风险 | 影响 | 缓解措施 |
+|-----|------|---------|
+| ... | 高/中/低 | ... |
+
+## 5. 资源需求
+
+- 开发时间: X 小时
+- 测试时间: Y 小时
+- 审查时间: Z 小时
+
+## 6. 审批点
+
+- [ ] 计划审批
+- [ ] 合并审批 (如需要)
+- [ ] 部署审批 (如需要)
+\`\`\`
+`;
+    }
+    generateRunId() {
+        return `planner-${Date.now().toString(36)}`;
+    }
+}
+exports.PlannerAgent = PlannerAgent;

package/dist/agents/impl/researcher-agent.d.ts

@@ -0,0 +1,17 @@
+import type { Task, AgentType, AgentResult } from '../../types/index.js';
+/**
+ * Researcher Agent - 调研分析
+ *
+ * 职责：
+ * - 搜索相关资料
+ * - 分析技术方案
+ * - 总结最佳实践
+ * - 提供决策建议
+ */
+export declare class ResearcherAgent {
+    readonly type: AgentType;
+    readonly capabilities: string[];
+    execute(task: Task): Promise<AgentResult>;
+    private buildResearchPrompt;
+    private generateRunId;
+}

package/dist/agents/impl/researcher-agent.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResearcherAgent = void 0;
+/**
+ * Researcher Agent - 调研分析
+ *
+ * 职责：
+ * - 搜索相关资料
+ * - 分析技术方案
+ * - 总结最佳实践
+ * - 提供决策建议
+ */
+class ResearcherAgent {
+    type = 'researcher';
+    capabilities = ['search', 'analyze', 'summarize', 'recommend'];
+    async execute(task) {
+        const startTime = Date.now();
+        try {
+            const prompt = this.buildResearchPrompt(task);
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'researcher',
+                status: 'completed',
+                output: prompt,
+                artifacts: [],
+                needsApproval: false,
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+        catch (error) {
+            return {
+                runId: this.generateRunId(),
+                taskId: task.id,
+                agentType: 'researcher',
+                status: 'failed',
+                output: '',
+                artifacts: [],
+                needsApproval: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime,
+                completedAt: new Date().toISOString()
+            };
+        }
+    }
+    buildResearchPrompt(task) {
+        return `
+# 调研任务
+
+## 调研问题
+
+${task.description}
+
+## 调研步骤
+
+1. **搜索资料**
+   - 官方文档
+   - 技术博客
+   - GitHub 仓库
+   - Stack Overflow
+
+2. **分析方案**
+   - 功能对比
+   - 性能对比
+   - 社区支持
+   - 学习曲线
+
+3. **总结发现**
+   - 关键信息
+   - 优缺点
+   - 适用场景
+
+## 输出格式
+
+\`\`\`markdown
+# 调研报告
+
+## 问题
+[调研的核心问题]
+
+## 调研方法
+- 搜索关键词: ...
+- 参考来源: ...
+
+## 发现
+
+### 方案 A: [名称]
+- 描述: ...
+- 优点:
+  - ...
+- 缺点:
+  - ...
+- 适用场景: ...
+
+### 方案 B: [名称]
+- 描述: ...
+- 优点:
+  - ...
+- 缺点:
+  - ...
+- 适用场景: ...
+
+## 方案对比
+
+| 维度 | 方案 A | 方案 B |
+|-----|--------|--------|
+| 性能 | ⭐⭐⭐ | ⭐⭐ |
+| 易用性 | ⭐⭐ | ⭐⭐⭐ |
+| 社区 | ⭐⭐⭐ | ⭐ |
+
+## 建议
+
+**推荐方案**: [方案 X]
+
+**理由**:
+1. ...
+2. ...
+
+## 参考资料
+1. [标题](链接)
+\`\`\`
+
+## 开始调研
+
+请使用 WebSearch 和 WebFetch 工具搜索相关信息。
+`;
+    }
+    generateRunId() {
+        return `researcher-${Date.now().toString(36)}`;
+    }
+}
+exports.ResearcherAgent = ResearcherAgent;

package/dist/agents/impl/reviewer-agent.d.ts

@@ -0,0 +1,17 @@
+import type { Task, AgentType, AgentResult } from '../../types/index.js';
+/**
+ * Reviewer Agent - 代码审查
+ *
+ * 职责：
+ * - 代码质量审查
+ * - 安全性检查
+ * - 性能评估
+ * - 最佳实践建议
+ */
+export declare class ReviewerAgent {
+    readonly type: AgentType;
+    readonly capabilities: string[];
+    execute(task: Task): Promise<AgentResult>;
+    private buildReviewerPrompt;
+    private generateRunId;
+}