opc-agent 5.0.0-rc.21 → 5.0.0-rc.22

package/TASK.md

@@ -1,42 +1,38 @@
-# TASK.md — P1 批量任务
-
-## 项目信息
-- 路径: C:\Users\mingjwan\opc-agent
-- 构建: `npx tsc --noEmit`（必须通过）
-- 风格: CommonJS, TypeScript 5.x, ES2022
-- 每个功能完成后 git commit
-
-## 任务清单
-
-### 1. gpt-4o-mini 硬编码改为 Ollama-first（5min）
-搜索所有 `gpt-4o-mini` 硬编码，改为先检测本地 Ollama 可用模型，fallback 到 `gpt-4o-mini`。
-- `src/` 目录全文搜索 `gpt-4o-mini`
-- 替换为: 读取 oad.yaml 配置的 model，如果没配就用 auto-detect（先 Ollama 再 OpenAI）
-
-### 2. handleMessageStream 走完整 pipeline（10min）
-`src/core/agent.ts` 中 `handleMessageStream` 需要和 `handleMessage` 一样走完整的 pipeline：
-- Memory Prefetch（提取关键词 → 搜索记忆 → 注入 system message）
-- Memory Sync（检测记忆触发词 → 保存）
-- Context Window Guard（检查 token 数 → 截断）
-- OutputGuard（过滤 `<think>` 标签等）
-- 如果 handleMessageStream 不存在或是 stub，确认 handleMessage 已覆盖所有 pipeline 步骤
-
-### 3. Provider Failover（10min）
-在 `src/providers/` 中实现 provider failover：
-- 如果当前 provider 返回 429/500/502/503，自动切换到下一个可用 provider
-- Provider 优先级: oad.yaml 显式配置 > config.json > env > auto-detect
-- 实现 `FailoverProvider` wrapper：接受 provider 数组，逐个尝试
-- 在 `createProvider` 中，如果检测到多个可用 provider，用 FailoverProvider 包装
-
-### 4. `opc studio` 命令在 help 中显示（2min）
-检查 `src/cli/` 目录，确保 `studio` 子命令注册到 commander program 中，`opc --help` 能看到。
-
-### 5. License 修复（2min）
-- `package.json` 中 license 字段确认是 `Apache-2.0`
-- 如果存在 `LICENSE` 文件，确认内容正确
-
-## 约束
-- 每个功能改完后 `npx tsc --noEmit` 必须通过
-- 不引入新依赖
-- 每个功能完成后 `git add -A && git commit`
-- 不修改测试文件（避免破坏现有测试）
+# TASK: Add read_file + write_file builtin tools
+
+## Goal
+Add two new builtin tools so the Agent can read and write files on the local filesystem during conversations.
+
+## Requirements
+
+### 1. `read_file` tool (`src/tools/builtin/read-file.ts`)
+- Parameters: `path` (string, required), `offset` (number, optional, line to start from), `limit` (number, optional, max lines)
+- Returns file content as string
+- Security: resolve path relative to agent workspace (cwd), reject `..` traversal outside workspace
+- Handle errors gracefully (file not found, permission denied)
+- For binary files, return a message saying "Binary file, cannot display"
+- Max read size: 100KB, truncate with message if exceeded
+
+### 2. `write_file` tool (`src/tools/builtin/write-file.ts`)
+- Parameters: `path` (string, required), `content` (string, required), `append` (boolean, optional, default false)
+- Creates parent directories automatically (`mkdirSync recursive`)
+- Security: same path restriction as read_file
+- Returns confirmation with bytes written and absolute path
+
+### 3. Register both tools
+- Add to the builtin tools registry (check how existing tools like `web_search.ts`, `execute_code.ts` are registered)
+- Follow the exact same pattern/interface as existing builtin tools
+
+### 4. Format
+- Follow the existing builtin tool format in `src/tools/builtin/`
+- Use `BuiltinTool` interface (or whatever interface the existing tools use)
+- CommonJS compatible (module.exports or export)
+
+## Constraints
+- TypeScript, CommonJS (module: commonjs, target: ES2022)
+- No new dependencies
+- Must pass `npx tsc --noEmit`
+
+## After completing
+1. Run `npx tsc --noEmit` to verify
+2. Run `git add -A && git commit -m "feat: read_file + write_file builtin tools"`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opc-agent",
-  "version": "5.0.0-rc.21",
+  "version": "5.0.0-rc.22",
   "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",