@deepwhale/coding-agent 1.0.0

package/dist/tools/edit-file.d.ts

@@ -0,0 +1,22 @@
+/**
+ * edit_file 工具 — 通过 EditEngine 抽象修改文件
+ *
+ * Sprint 0.2 关键设计：edit_file 内部**不直接 import hashline**，
+ * 只走 EditEngine 接口（createDefaultEngine 工厂）。
+ * 这是 arch §2.3.2 抽象不破的核心证据。
+ *
+ * Sprint 0.2 范围：单文件 edit（patch 文本含 file path）
+ * Sprint 1 扩展：Recovery 3-way + multi-block + 跨文件 batch
+ */
+import type { ToolName } from '@deepwhale/core';
+import type { Tool, ToolInputSchema, ToolResult } from '../types.js';
+export declare class EditFileTool implements Tool {
+    readonly name: ToolName;
+    readonly description = "Edit a local file using a hashline-format patch (3-hex TAG anchors). The patch is applied through the EditEngine abstraction \u2014 engine can be swapped via EDIT_ENGINE env var.";
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly schema: ToolInputSchema;
+    /** Sprint 0.2 工厂：默认用 hashline，未来走 createEngine(name) */
+    private engine;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=edit-file.d.ts.map

package/dist/tools/edit-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../src/tools/edit-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,qBAAa,YAAa,YAAW,IAAI;IACvC,QAAQ,CAAC,IAAI,EAAkB,QAAQ,CAAC;IACxC,QAAQ,CAAC,WAAW,wLAC8J;IAClL,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAY;IAEpD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAO9B;IAEF,wDAAwD;IACxD,OAAO,CAAC,MAAM;IAIR,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAmDnE"}

package/dist/tools/edit-file.js

@@ -0,0 +1,79 @@
+/**
+ * edit_file 工具 — 通过 EditEngine 抽象修改文件
+ *
+ * Sprint 0.2 关键设计：edit_file 内部**不直接 import hashline**，
+ * 只走 EditEngine 接口（createDefaultEngine 工厂）。
+ * 这是 arch §2.3.2 抽象不破的核心证据。
+ *
+ * Sprint 0.2 范围：单文件 edit（patch 文本含 file path）
+ * Sprint 1 扩展：Recovery 3-way + multi-block + 跨文件 batch
+ */
+import { promises as fs } from 'node:fs';
+import { createDefaultEngine } from '@deepwhale/edit-engine';
+export class EditFileTool {
+    name = 'edit_file';
+    description = 'Edit a local file using a hashline-format patch (3-hex TAG anchors). The patch is applied through the EditEngine abstraction — engine can be swapped via EDIT_ENGINE env var.';
+    risk = 'medium';
+    schema = {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Absolute path to the file to edit' },
+            patch: { type: 'string', description: 'Hashline-format patch (use edit_engine to generate)' },
+        },
+        required: ['path', 'patch'],
+    };
+    /** Sprint 0.2 工厂：默认用 hashline，未来走 createEngine(name) */
+    engine() {
+        return createDefaultEngine();
+    }
+    async execute(input) {
+        const path = input['path'];
+        const patch = input['patch'];
+        if (typeof path !== 'string' || path.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: path is required' };
+        }
+        if (typeof patch !== 'string' || patch.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: patch is required' };
+        }
+        let original;
+        try {
+            original = await fs.readFile(path, 'utf8');
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === 'ENOENT') {
+                return { success: false, content: '', error: `not-found: ${path}` };
+            }
+            return { success: false, content: '', error: `io-error: ${e.message}`, meta: { path } };
+        }
+        const target = { path, text: original };
+        const result = this.engine().apply(target, patch);
+        if (!result.ok) {
+            return {
+                success: false,
+                content: '',
+                error: `apply-${result.error.kind}: ${JSON.stringify(result.error)}`,
+                meta: { engine: this.engine().name },
+            };
+        }
+        // Sprint 1 加原子写（write to tmp + rename）。Sprint 0.2 简化：直接写。
+        try {
+            await fs.writeFile(path, result.newText, 'utf8');
+            return {
+                success: true,
+                content: `Applied patch via ${result.engine}. ${original.length} → ${result.newText.length} bytes.`,
+                meta: {
+                    path,
+                    engine: result.engine,
+                    bytesBefore: original.length,
+                    bytesAfter: result.newText.length,
+                },
+            };
+        }
+        catch (err) {
+            const e = err;
+            return { success: false, content: '', error: `io-error: ${e.message}`, meta: { path } };
+        }
+    }
+}
+//# sourceMappingURL=edit-file.js.map

package/dist/tools/edit-file.js.map

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

package/dist/tools/find.d.ts

@@ -0,0 +1,21 @@
+/**
+ * find 工具 — 文件系统查找
+ *
+ * Sprint 0.2 范围：跨平台 Node 实现（不走 find/ripgrep，避开 Windows find.exe 陷阱）
+ * Sprint 2+ 候选：换成 napi natives（Node 实现 + Profile 验证瓶颈）
+ *
+ * 设计：基于 fs.lstatSync（不跟随 symlink）+ readdirSync。lstat 而非 stat 是关键：
+ * - stat 跟随 symlink，type='l' 分支永远 false，且 visited 拿不到 realdir 去重
+ * - lstat 给出 link 自身属性，type='l' 才能正确命中
+ * - 递归不跟随 symlink 目录：避免 symlink 环路 + 减少越界
+ */
+import type { ToolName } from '@deepwhale/core';
+import type { Tool, ToolInputSchema, ToolResult } from '../types.js';
+export declare class FindTool implements Tool {
+    readonly name: ToolName;
+    readonly description = "Find files by name pattern in a directory tree. Cross-platform Node implementation (no shell).";
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly schema: ToolInputSchema;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=find.d.ts.map

package/dist/tools/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/tools/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKrE,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,IAAI,EAAa,QAAQ,CAAC;IACnC,QAAQ,CAAC,WAAW,oGAC+E;IACnG,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAS;IAEjD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAa9B;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAgHnE"}

package/dist/tools/find.js

@@ -0,0 +1,168 @@
+/**
+ * find 工具 — 文件系统查找
+ *
+ * Sprint 0.2 范围：跨平台 Node 实现（不走 find/ripgrep，避开 Windows find.exe 陷阱）
+ * Sprint 2+ 候选：换成 napi natives（Node 实现 + Profile 验证瓶颈）
+ *
+ * 设计：基于 fs.lstatSync（不跟随 symlink）+ readdirSync。lstat 而非 stat 是关键：
+ * - stat 跟随 symlink，type='l' 分支永远 false，且 visited 拿不到 realdir 去重
+ * - lstat 给出 link 自身属性，type='l' 才能正确命中
+ * - 递归不跟随 symlink 目录：避免 symlink 环路 + 减少越界
+ */
+import { lstatSync, readdirSync, realpathSync } from 'node:fs';
+import { resolve, join, relative } from 'node:path';
+import process from 'node:process';
+const MAX_DEPTH_DEFAULT = 10;
+const MAX_RESULTS_DEFAULT = 1000;
+export class FindTool {
+    name = 'find';
+    description = 'Find files by name pattern in a directory tree. Cross-platform Node implementation (no shell).';
+    risk = 'low';
+    schema = {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory to search (default: cwd)' },
+            name: { type: 'string', description: 'Filename pattern (glob, e.g. *.ts)' },
+            type: {
+                type: 'string',
+                description: 'File type filter',
+                enum: ['f', 'd', 'l'],
+            },
+            maxDepth: { type: 'number', description: 'Max depth (default: 10)' },
+        },
+        required: ['path', 'name'],
+    };
+    async execute(input) {
+        const path = input['path'];
+        const name = input['name'];
+        const type = input['type'];
+        const maxDepth = typeof input['maxDepth'] === 'number' && input['maxDepth'] >= 0
+            ? Math.floor(input['maxDepth'])
+            : MAX_DEPTH_DEFAULT;
+        if (typeof path !== 'string' || path.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: path is required' };
+        }
+        if (typeof name !== 'string' || name.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: name is required' };
+        }
+        const rootPath = resolve(path);
+        let rootStat;
+        try {
+            rootStat = lstatSync(rootPath);
+        }
+        catch (err) {
+            const e = err;
+            return {
+                success: false,
+                content: '',
+                error: `not-found: ${e.message} (${e.code ?? 'UNKNOWN'})`,
+            };
+        }
+        if (!rootStat.isDirectory()) {
+            return {
+                success: false,
+                content: '',
+                error: `not-a-directory: '${path}' is not a directory`,
+            };
+        }
+        const wantFile = type === 'f';
+        const wantDir = type === 'd';
+        const wantLink = type === 'l';
+        const typeFilter = type === undefined ? null : { wantFile, wantDir, wantLink };
+        let regex;
+        try {
+            regex = globToRegExp(name);
+        }
+        catch (err) {
+            return {
+                success: false,
+                content: '',
+                error: `invalid-input: name glob invalid: ${err.message}`,
+            };
+        }
+        const matches = [];
+        // visited 用 realpath 算：symlink 指向的目录必须按真实路径去重，
+        // 否则 `dir -> /elsewhere/loop` 这类环会死循环 / 重复遍历。
+        const visited = new Set();
+        const walk = (dir, depth) => {
+            if (matches.length >= MAX_RESULTS_DEFAULT)
+                return;
+            // realpath 会跟随 symlink,realpathSync 失败（ENOENT 等）就跳过
+            let realDir;
+            try {
+                realDir = realpathSync(dir);
+            }
+            catch {
+                return;
+            }
+            if (visited.has(realDir))
+                return;
+            visited.add(realDir);
+            let entries;
+            try {
+                // 指定 encoding='utf8' 让 @types/node 推出 string[]（避免 Dirent<NonSharedBuffer> 分支）
+                entries = readdirSync(dir, { encoding: 'utf8' });
+            }
+            catch {
+                return; // 跳过无权限 / 已删除目录
+            }
+            for (const name of entries) {
+                if (matches.length >= MAX_RESULTS_DEFAULT)
+                    return;
+                const full = join(dir, name);
+                // lstatSync 不跟随 symlink — 这正是 type='l' 能正确命中的关键
+                const st = lstatSyncSafe(full);
+                if (st === null)
+                    continue;
+                const isFile = st.isFile();
+                const isDir = st.isDirectory();
+                const isLink = st.isSymbolicLink();
+                const passType = typeFilter === null
+                    ? true
+                    : (typeFilter.wantFile && isFile) ||
+                        (typeFilter.wantDir && isDir) ||
+                        (typeFilter.wantLink && isLink);
+                if (passType && regex.test(name)) {
+                    matches.push(relative(process.cwd(), full) || full);
+                }
+                // 只递归真实目录（不跟随 symlink 目录），避开环路 + 越界
+                if (isDir && !isLink && depth < maxDepth) {
+                    walk(full, depth + 1);
+                }
+            }
+        };
+        walk(rootPath, 0);
+        return {
+            success: true,
+            content: matches.join('\n'),
+            meta: {
+                path,
+                name,
+                count: matches.length,
+                truncated: matches.length >= MAX_RESULTS_DEFAULT,
+            },
+        };
+    }
+}
+/**
+ * 把 `*.ts` 这类 glob 转成正则。Sprint 0.2 简化版只支持 `*` 和 `?`。
+ * Sprint 1+ 考虑 minimatch 之类。
+ */
+function globToRegExp(glob) {
+    // 转义所有 regex 特殊字符，再把 `\*` 和 `\?` 还原
+    const escaped = glob
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`);
+}
+/** 静默 lstatSync 失败（无权限 / 路径已消失），返回 null 让 caller 跳过。 */
+function lstatSyncSafe(p) {
+    try {
+        return lstatSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=find.js.map

package/dist/tools/find.js.map

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

package/dist/tools/grep.d.ts

@@ -0,0 +1,19 @@
+/**
+ * grep 工具 — 文本搜索
+ *
+ * Sprint 0.2 范围：跨平台 Node 实现（不走 GNU grep，避开 Windows 缺失问题）
+ * Sprint 2+ 候选：ripgrep 子进程（oh-my-pi 借鉴）/ Rust napi
+ *
+ * 实现策略：基于 fs.readdirSync({ recursive: true }) + 行级正则匹配。
+ * 比 GNU grep 慢，但 v1.0 单人本地够用，跨平台 0 依赖。
+ */
+import type { ToolName } from '@deepwhale/core';
+import type { Tool, ToolInputSchema, ToolResult } from '../types.js';
+export declare class GrepTool implements Tool {
+    readonly name: ToolName;
+    readonly description = "Search for a text pattern in files. Cross-platform Node implementation (no shell). Supports include glob for file filtering.";
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly schema: ToolInputSchema;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=grep.d.ts.map

package/dist/tools/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKrE,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,IAAI,EAAa,QAAQ,CAAC;IACnC,QAAQ,CAAC,WAAW,kIAC6G;IACjI,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAS;IAEjD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAU9B;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAgGnE"}

package/dist/tools/grep.js

@@ -0,0 +1,170 @@
+/**
+ * grep 工具 — 文本搜索
+ *
+ * Sprint 0.2 范围：跨平台 Node 实现（不走 GNU grep，避开 Windows 缺失问题）
+ * Sprint 2+ 候选：ripgrep 子进程（oh-my-pi 借鉴）/ Rust napi
+ *
+ * 实现策略：基于 fs.readdirSync({ recursive: true }) + 行级正则匹配。
+ * 比 GNU grep 慢，但 v1.0 单人本地够用，跨平台 0 依赖。
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { resolve, join, relative } from 'node:path';
+const MAX_RESULTS_DEFAULT = 100;
+const MAX_FILE_BYTES = 2 * 1024 * 1024; // 2MB 文本上限（Sprint 0.2 简化：大文件直接跳过）
+export class GrepTool {
+    name = 'grep';
+    description = 'Search for a text pattern in files. Cross-platform Node implementation (no shell). Supports include glob for file filtering.';
+    risk = 'low';
+    schema = {
+        type: 'object',
+        properties: {
+            pattern: { type: 'string', description: 'Search pattern (regex supported with regex=true)' },
+            path: { type: 'string', description: 'Directory or file to search (default: cwd)' },
+            include: { type: 'string', description: 'File glob filter, e.g. *.ts' },
+            regex: { type: 'boolean', description: 'Treat pattern as extended regex (default: true)' },
+            maxResults: { type: 'number', description: 'Cap number of matching lines (default: 100)' },
+        },
+        required: ['pattern'],
+    };
+    async execute(input) {
+        const pattern = input['pattern'];
+        const path = input['path'];
+        const include = input['include'];
+        const useRegex = input['regex'] !== false; // default true
+        const maxResults = typeof input['maxResults'] === 'number' && input['maxResults'] > 0
+            ? Math.floor(input['maxResults'])
+            : MAX_RESULTS_DEFAULT;
+        if (typeof pattern !== 'string' || pattern.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: pattern is required' };
+        }
+        const searchPath = typeof path === 'string' && path.length > 0 ? path : '.';
+        const rootPath = resolve(searchPath);
+        let re;
+        try {
+            re = useRegex ? new RegExp(pattern) : escapeLiteralRegex(pattern);
+        }
+        catch (err) {
+            return {
+                success: false,
+                content: '',
+                error: `invalid-input: pattern is not a valid regex: ${err.message}`,
+            };
+        }
+        const includeRe = typeof include === 'string' ? globToRegExp(include) : null;
+        let rootStat;
+        try {
+            rootStat = statSync(rootPath);
+        }
+        catch (err) {
+            const e = err;
+            return {
+                success: false,
+                content: '',
+                error: `not-found: ${e.message} (${e.code ?? 'UNKNOWN'})`,
+            };
+        }
+        const matches = [];
+        const filesToScan = [];
+        if (rootStat.isFile()) {
+            filesToScan.push(rootPath);
+        }
+        else if (rootStat.isDirectory()) {
+            collectFiles(rootPath, filesToScan, includeRe, 0, 10);
+        }
+        else {
+            return {
+                success: false,
+                content: '',
+                error: `not-searchable: '${searchPath}' is not a file or directory`,
+            };
+        }
+        for (const file of filesToScan) {
+            if (matches.length >= maxResults)
+                break;
+            let text;
+            try {
+                const st = statSync(file);
+                if (st.size > MAX_FILE_BYTES)
+                    continue; // 跳过超大文件
+                text = readFileSync(file, 'utf8');
+            }
+            catch {
+                continue; // 二进制 / 无权限 / race condition
+            }
+            // 检测 BOM。split 用 /\r?\n/：文件原文用什么换行就按什么切，
+            // 避免在 Windows 上 EOL='\r\n' 时把 LF 文件整段当一行（用户报告 P2-1）。
+            if (text.charCodeAt(0) === 0xfeff)
+                text = text.slice(1);
+            const lines = text.split(/\r?\n/);
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i] ?? '';
+                if (re.test(line)) {
+                    matches.push(`${relative(process.cwd(), file) || file}:${i + 1}:${line}`);
+                    if (matches.length >= maxResults)
+                        break;
+                }
+            }
+        }
+        const truncated = matches.length >= maxResults;
+        const content = truncated
+            ? matches.join('\n') + `\n\n[truncated to ${maxResults} matches]`
+            : matches.join('\n');
+        return {
+            success: true,
+            content,
+            meta: {
+                pattern,
+                searchPath,
+                matchCount: matches.length,
+                truncated,
+                filesScanned: filesToScan.length,
+            },
+        };
+    }
+}
+function collectFiles(dir, out, includeRe, depth, maxDepth) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { encoding: 'utf8' });
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        const full = join(dir, name);
+        const st = statSyncSafe(full);
+        if (st === null)
+            continue;
+        if (st.isFile()) {
+            if (includeRe === null || includeRe.test(name)) {
+                out.push(full);
+            }
+        }
+        else if (st.isDirectory() && depth < maxDepth) {
+            // 跳过常见噪声目录
+            if (name === 'node_modules' || name === '.git' || name === 'dist')
+                continue;
+            collectFiles(full, out, includeRe, depth + 1, maxDepth);
+        }
+    }
+}
+/** 静默 statSync 失败（无权限 / 路径已消失），返回 null 让 caller 跳过。 */
+function statSyncSafe(p) {
+    try {
+        return statSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+function escapeLiteralRegex(s) {
+    return new RegExp(s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+}
+function globToRegExp(glob) {
+    const escaped = glob
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`);
+}
+//# sourceMappingURL=grep.js.map

package/dist/tools/grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAc,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIpD,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,kCAAkC;AAE1E,MAAM,OAAO,QAAQ;IACV,IAAI,GAAG,MAAkB,CAAC;IAC1B,WAAW,GAClB,8HAA8H,CAAC;IACxH,IAAI,GAA8B,KAAK,CAAC;IAExC,MAAM,GAAoB;QACjC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;YAC5F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACnF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;YAC1F,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;SAC3F;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,eAAe;QAC1D,MAAM,UAAU,GACd,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;YAChE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC,CAAC,mBAAmB,CAAC;QAE1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QACtF,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAErC,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACH,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,gDAAiD,GAAa,CAAC,OAAO,EAAE;aAChF,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE7E,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAAgC,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,cAAc,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI,SAAS,GAAG;aAC1D,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACtB,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YAClC,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,oBAAoB,UAAU,8BAA8B;aACpE,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;gBAAE,MAAM;YACxC,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1B,IAAI,EAAE,CAAC,IAAI,GAAG,cAAc;oBAAE,SAAS,CAAC,SAAS;gBACjD,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,6BAA6B;YACzC,CAAC;YACD,yCAAyC;YACzC,qDAAqD;YACrD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClB,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;oBAC1E,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;wBAAE,MAAM;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;QAC/C,MAAM,OAAO,GAAG,SAAS;YACvB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,qBAAqB,UAAU,WAAW;YACjE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI,EAAE;gBACJ,OAAO;gBACP,UAAU;gBACV,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,SAAS;gBACT,YAAY,EAAE,WAAW,CAAC,MAAM;aACjC;SACF,CAAC;IACJ,CAAC;CACF;AAED,SAAS,YAAY,CACnB,GAAW,EACX,GAAa,EACb,SAAwB,EACxB,KAAa,EACb,QAAgB;IAEhB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAa,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,IAAI;YAAE,SAAS;QAC1B,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;YAChB,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YAChD,WAAW;YACX,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;gBAAE,SAAS;YAC5E,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,OAAO,GAAG,IAAI;SACjB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 6 工具（v1.0 Sprint 1 范围）
+ */
+export { ReadFileTool } from './read-file.js';
+export { WriteFileTool } from './write-file.js';
+export { EditFileTool } from './edit-file.js';
+export { BashTool } from './bash.js';
+export { FindTool } from './find.js';
+export { GrepTool } from './grep.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,10 @@
+/**
+ * 6 工具（v1.0 Sprint 1 范围）
+ */
+export { ReadFileTool } from './read-file.js';
+export { WriteFileTool } from './write-file.js';
+export { EditFileTool } from './edit-file.js';
+export { BashTool } from './bash.js';
+export { FindTool } from './find.js';
+export { GrepTool } from './grep.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/read-file.d.ts

@@ -0,0 +1,18 @@
+/**
+ * read_file 工具 — 读取本地文件
+ *
+ * Sprint 0.2 范围：单文件 + offset/limit
+ * Sprint 1 扩展：行号 + 编码探测
+ *
+ * 沙箱：v1.0 本地直接读，Sprint 2 接入 Docker
+ */
+import type { ToolName } from '@deepwhale/core';
+import type { Tool, ToolInputSchema, ToolResult } from '../types.js';
+export declare class ReadFileTool implements Tool {
+    readonly name: ToolName;
+    readonly description = "Read a local file. Returns file content with line numbers. Use offset/limit to read a slice.";
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly schema: ToolInputSchema;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,qBAAa,YAAa,YAAW,IAAI;IACvC,QAAQ,CAAC,IAAI,EAAkB,QAAQ,CAAC;IACxC,QAAQ,CAAC,WAAW,kGAC6E;IACjG,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAS;IAEjD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAQ9B;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA4BnE"}

package/dist/tools/read-file.js

@@ -0,0 +1,52 @@
+/**
+ * read_file 工具 — 读取本地文件
+ *
+ * Sprint 0.2 范围：单文件 + offset/limit
+ * Sprint 1 扩展：行号 + 编码探测
+ *
+ * 沙箱：v1.0 本地直接读，Sprint 2 接入 Docker
+ */
+import { promises as fs } from 'node:fs';
+export class ReadFileTool {
+    name = 'read_file';
+    description = 'Read a local file. Returns file content with line numbers. Use offset/limit to read a slice.';
+    risk = 'low';
+    schema = {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Absolute path to the file' },
+            offset: { type: 'number', description: 'Starting line (0-indexed, default 0)' },
+            limit: { type: 'number', description: 'Max lines to read (default: all)' },
+        },
+        required: ['path'],
+    };
+    async execute(input) {
+        const path = input['path'];
+        if (typeof path !== 'string' || path.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: path is required' };
+        }
+        const offset = typeof input['offset'] === 'number' ? input['offset'] : 0;
+        const limit = typeof input['limit'] === 'number' ? input['limit'] : Infinity;
+        try {
+            const text = await fs.readFile(path, 'utf8');
+            const lines = text.split('\n');
+            const slice = lines.slice(offset, offset + limit);
+            const numbered = slice
+                .map((l, i) => `${String(offset + i + 1).padStart(6, ' ')}\t${l}`)
+                .join('\n');
+            return {
+                success: true,
+                content: numbered,
+                meta: { totalLines: lines.length, readLines: slice.length },
+            };
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === 'ENOENT') {
+                return { success: false, content: '', error: `not-found: ${path}` };
+            }
+            return { success: false, content: '', error: `io-error: ${e.message}`, meta: { path } };
+        }
+    }
+}
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAIzC,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,WAAuB,CAAC;IAC/B,WAAW,GAClB,8FAA8F,CAAC;IACxF,IAAI,GAA8B,KAAK,CAAC;IAExC,MAAM,GAAoB;QACjC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAClE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC/E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;QACnF,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE7E,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,KAAK;iBACnB,GAAG,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;iBACjF,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;aAC5D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAAkE,CAAC;YAC7E,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC;YACtE,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;CACF"}