hyacinth-ai 0.9.6

package/dist/tools/diagnostics.js

@@ -0,0 +1,111 @@
+/**
+ * diagnostics — 代码修改后自动运行类型检查/编译检查
+ *
+ * 在 write/edit/multi_edit 工具执行后自动检测项目类型并运行对应的
+ * 类型检查命令，结果在下轮对话中注入供 LLM 参考。
+ *
+ * 设计原则：
+ *   - 不影响工具执行流（结果通过 pending 机制在下轮注入）
+ *   - 超时保护（默认 15 秒，防止阻塞）
+ *   - 静默降级（无已知项目类型时跳过）
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import fs from 'node:fs';
+import path from 'node:path';
+const execFileAsync = promisify(execFile);
+/** 检测当前工作目录的项目类型 */
+export function detectProjectType(cwd) {
+    // TypeScript / JavaScript
+    if (fs.existsSync(path.join(cwd, 'tsconfig.json'))) {
+        return 'typescript';
+    }
+    // Go
+    if (fs.existsSync(path.join(cwd, 'go.mod'))) {
+        return 'go';
+    }
+    // Rust
+    if (fs.existsSync(path.join(cwd, 'Cargo.toml'))) {
+        return 'rust';
+    }
+    // Python
+    if (fs.existsSync(path.join(cwd, 'pyproject.toml')) || fs.existsSync(path.join(cwd, 'setup.py'))) {
+        return 'python';
+    }
+    return null;
+}
+/** 获取项目类型对应的诊断命令 */
+export function getDiagnosticsCommand(type) {
+    switch (type) {
+        case 'typescript':
+            return { cmd: 'npx', args: ['tsc', '--noEmit', '--pretty', 'false'] };
+        case 'go':
+            return { cmd: 'go', args: ['build', './...'] };
+        case 'rust':
+            return { cmd: 'cargo', args: ['check', '--message-format', 'short'] };
+        case 'python':
+            return { cmd: 'python', args: ['-m', 'compileall', '-q', '.'] };
+    }
+}
+// ── 执行 & 格式化 ────────────────────────────────────────────
+/**
+ * 运行诊断命令并返回格式化结果。
+ *
+ * @param cwd     工作目录
+ * @param timeout 超时时间（毫秒），默认 15000
+ * @returns 格式化的诊断结果字符串，超时或无法运行时返回 null
+ */
+export async function runDiagnostics(cwd, timeout = 15000) {
+    const projectType = detectProjectType(cwd);
+    if (!projectType)
+        return null;
+    const { cmd, args } = getDiagnosticsCommand(projectType);
+    try {
+        // 对于 npx，Windows 上需要 .cmd 后缀
+        const resolvedCmd = process.platform === 'win32' && cmd === 'npx'
+            ? 'npx.cmd'
+            : cmd;
+        const { stdout, stderr } = await execFileAsync(resolvedCmd, args, {
+            cwd,
+            timeout,
+            maxBuffer: 256 * 1024, // 256 KB
+            env: { ...process.env, NO_COLOR: '1', FORCE_COLOR: '0' },
+        });
+        const output = (stderr + stdout).trim();
+        // 区分"检查通过"和"有错误"
+        if (!output) {
+            return `[Diagnostics] ${typeLabel(projectType)} check passed — no errors.`;
+        }
+        // 截断过长输出
+        const maxLen = 2000;
+        const truncated = output.length > maxLen
+            ? output.slice(0, maxLen) + `\n... (truncated, ${output.length - maxLen} more chars)`
+            : output;
+        return `[Diagnostics] ${typeLabel(projectType)} check results:\n${truncated}`;
+    }
+    catch (err) {
+        // execFile 在非零退出码时会 throw
+        const execErr = err;
+        if (execErr.killed) {
+            return `[Diagnostics] ${typeLabel(projectType)} check timed out (>${timeout / 1000}s).`;
+        }
+        const errOutput = ((execErr.stderr || '') + (execErr.stdout || '')).trim();
+        if (!errOutput) {
+            return `[Diagnostics] ${typeLabel(projectType)} check failed (exit code ${execErr.code}).`;
+        }
+        const maxLen = 2000;
+        const truncated = errOutput.length > maxLen
+            ? errOutput.slice(0, maxLen) + `\n... (truncated, ${errOutput.length - maxLen} more chars)`
+            : errOutput;
+        return `[Diagnostics] ${typeLabel(projectType)} check found errors:\n${truncated}`;
+    }
+}
+function typeLabel(type) {
+    switch (type) {
+        case 'typescript': return 'TypeScript (tsc)';
+        case 'go': return 'Go (go build)';
+        case 'rust': return 'Rust (cargo check)';
+        case 'python': return 'Python (py_compile)';
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/tools/diff-channel.d.ts

@@ -0,0 +1,9 @@
+import type { DiffLine } from '../utils/diff.js';
+interface DiffEntry {
+    filePath: string;
+    lines: DiffLine[];
+}
+export declare function pushDiff(filePath: string, lines: DiffLine[]): void;
+export declare function popDiff(filePath: string): DiffEntry | undefined;
+export {};
+//# sourceMappingURL=diff-channel.d.ts.map

package/dist/tools/diff-channel.js

@@ -0,0 +1,17 @@
+/**
+ * 共享 Diff 通道 — edit/write 工具计算 diff 后写入，executor 读取并通知 UI
+ * 按 filePath 索引
+ */
+import path from 'node:path';
+const channel = new Map();
+export function pushDiff(filePath, lines) {
+    channel.set(path.normalize(filePath), { filePath, lines });
+}
+export function popDiff(filePath) {
+    const key = path.normalize(filePath);
+    const d = channel.get(key);
+    if (d)
+        channel.delete(key);
+    return d;
+}
+//# sourceMappingURL=diff-channel.js.map

package/dist/tools/diff-files.d.ts

@@ -0,0 +1,17 @@
+import type { Tool } from './interface.js';
+/**
+ * DiffFilesTool — 比较两个文件的行级差异
+ *
+ * 参数：
+ * - file1 (必需): 第一个文件路径
+ * - file2 (必需): 第二个文件路径
+ *
+ * 返回统一的 diff 格式，每行标记 + / - / 不变。
+ */
+export declare class DiffFilesTool implements Tool {
+    readonly name = "diff_files";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=diff-files.d.ts.map

package/dist/tools/diff-files.js

@@ -0,0 +1,88 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { diffLines } from 'diff';
+/**
+ * DiffFilesTool — 比较两个文件的行级差异
+ *
+ * 参数：
+ * - file1 (必需): 第一个文件路径
+ * - file2 (必需): 第二个文件路径
+ *
+ * 返回统一的 diff 格式，每行标记 + / - / 不变。
+ */
+export class DiffFilesTool {
+    name = 'diff_files';
+    description = 'Compare two files line by line and return the diff with line numbers. ' +
+        'Returns unified diff format: lines prefixed with + (added), - (removed), or space (unchanged). ' +
+        'Supports both absolute and relative paths.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            file1: { type: 'string', description: 'Path to the first file (absolute or relative to cwd)' },
+            file2: { type: 'string', description: 'Path to the second file (absolute or relative to cwd)' },
+        },
+        required: ['file1', 'file2'],
+    };
+    async execute(args) {
+        const file1 = args.file1;
+        const file2 = args.file2;
+        if (!file1 || !file2)
+            return 'Error: Both file1 and file2 are required.';
+        const cwd = process.cwd();
+        const resolve = (p) => path.isAbsolute(p) ? p : path.resolve(cwd, p);
+        const abs1 = resolve(file1);
+        const abs2 = resolve(file2);
+        let content1, content2;
+        try {
+            content1 = fs.readFileSync(abs1, 'utf-8');
+        }
+        catch {
+            return `Error: Cannot read file1: ${abs1}`;
+        }
+        try {
+            content2 = fs.readFileSync(abs2, 'utf-8');
+        }
+        catch {
+            return `Error: Cannot read file2: ${abs2}`;
+        }
+        const changes = diffLines(content1, content2);
+        if (changes.length === 1 && !changes[0].added && !changes[0].removed) {
+            return 'Files are identical.';
+        }
+        const lines = [`--- ${abs1}`, `+++ ${abs2}`];
+        let lineNum1 = 1;
+        let lineNum2 = 1;
+        for (const change of changes) {
+            const value = change.value.replace(/\n$/, '');
+            const changeLines = value ? value.split('\n') : [];
+            if (change.added) {
+                for (const l of changeLines) {
+                    lines.push(`+ ${String(lineNum2).padStart(4, ' ')} | ${l}`);
+                    lineNum2++;
+                }
+            }
+            else if (change.removed) {
+                for (const l of changeLines) {
+                    lines.push(`- ${String(lineNum1).padStart(4, ' ')} | ${l}`);
+                    lineNum1++;
+                }
+            }
+            else {
+                for (const l of changeLines) {
+                    // Only show context lines near changes; skip large unchanged blocks
+                    lines.push(`  ${String(lineNum1).padStart(4, ' ')} | ${l}`);
+                    lineNum1++;
+                    lineNum2++;
+                }
+            }
+        }
+        const MAX_LINES = 5000; // ToolResultBuffer handles context protection
+        if (lines.length > MAX_LINES + 2) {
+            const truncated = lines.slice(0, MAX_LINES);
+            truncated.push(`... (truncated, ${lines.length - MAX_LINES - 2} more lines)`);
+            return truncated.join('\n');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=diff-files.js.map

package/dist/tools/disk-usage.d.ts

@@ -0,0 +1,34 @@
+import type { Tool } from './interface.js';
+/**
+ * DiskUsageTool — 磁盘空间与目录大小分析。
+ *
+ * 不走 bash 沙箱，直接用系统原生方式获取数据：
+ * - Windows: PowerShell 脚本 → Get-CimInstance / Get-ChildItem
+ * - Unix: du / df 命令
+ *
+ * 参数：
+ * - path: 目标目录，默认当前工作目录
+ * - top: 展示前 N 项，默认 20
+ * - depth: 递归深度（1=仅直接子项，0=不限制），默认 1
+ * - mode: "free" | "dirs" | "files" | "all"，默认 "all"
+ */
+export declare class DiskUsageTool implements Tool {
+    readonly name = "disk_usage";
+    readonly description = "Analyze disk space and directory sizes. Mode \"free\" shows drive/volume free space. Mode \"dirs\" ranks subdirectories by total size. Mode \"files\" ranks individual files. Mode \"all\" shows both.";
+    readonly inputSchema: Record<string, unknown>;
+    private cwd;
+    constructor(cwd?: string);
+    setCwd(cwd: string): void;
+    execute(args: Record<string, unknown>): Promise<string>;
+    private executeWindows;
+    private buildWindowsScript;
+    private runPowerShell;
+    private executeUnix;
+    /** 解析 du -h 输出并按大小降序取前 N */
+    private sortDuOutput;
+    /** 解析 find -printf '%s\t%p' 输出并按大小降序取前 N */
+    private sortFindOutput;
+    /** 解析 du -h 的人类可读大小 (K/M/G) → 字节数 */
+    private parseHumanSize;
+}
+//# sourceMappingURL=disk-usage.d.ts.map

package/dist/tools/disk-usage.js

@@ -0,0 +1,258 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * DiskUsageTool — 磁盘空间与目录大小分析。
+ *
+ * 不走 bash 沙箱，直接用系统原生方式获取数据：
+ * - Windows: PowerShell 脚本 → Get-CimInstance / Get-ChildItem
+ * - Unix: du / df 命令
+ *
+ * 参数：
+ * - path: 目标目录，默认当前工作目录
+ * - top: 展示前 N 项，默认 20
+ * - depth: 递归深度（1=仅直接子项，0=不限制），默认 1
+ * - mode: "free" | "dirs" | "files" | "all"，默认 "all"
+ */
+export class DiskUsageTool {
+    name = 'disk_usage';
+    description = 'Analyze disk space and directory sizes. Mode "free" shows drive/volume free space. Mode "dirs" ranks subdirectories by total size. Mode "files" ranks individual files. Mode "all" shows both.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Target directory. Default: current working directory.',
+            },
+            top: {
+                type: 'number',
+                description: 'Show top N largest items. Default: 20. Max: 200.',
+            },
+            depth: {
+                type: 'number',
+                description: 'Recursion depth for directory size calculation. 1 = direct children only, 0 = unlimited. Default: 1.',
+            },
+            mode: {
+                type: 'string',
+                description: '"free" = drive free space, "dirs" = rank subdirectories by size, "files" = rank files by size, "all" = dirs + files + free space. Default: "all".',
+            },
+        },
+        required: [],
+    };
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd ?? process.cwd();
+    }
+    setCwd(cwd) {
+        this.cwd = cwd;
+    }
+    async execute(args) {
+        const targetPath = args.path ?? this.cwd;
+        const top = Math.min(args.top ?? 20, 200);
+        const depth = args.depth ?? 1;
+        const mode = args.mode ?? 'all';
+        const isWin = process.platform === 'win32';
+        if (isWin) {
+            return this.executeWindows(targetPath, top, depth, mode);
+        }
+        return this.executeUnix(targetPath, top, depth, mode);
+    }
+    // ── Windows ────────────────────────────────────────────────────────
+    executeWindows(targetPath, top, depth, mode) {
+        const script = this.buildWindowsScript(targetPath, top, depth, mode);
+        return this.runPowerShell(script);
+    }
+    buildWindowsScript(targetPath, top, depth, mode) {
+        const lines = [
+            '$ErrorActionPreference = "Stop"',
+            `$target = "${targetPath.replace(/\\/g, '\\\\')}"`,
+            `$top = ${top}`,
+            `$depth = ${depth}`,
+            `$mode = "${mode}"`,
+            '',
+        ];
+        // "free" or "all" → show drive info
+        if (mode === 'free' || mode === 'all') {
+            lines.push('# ── 驱动器空间 ──', '$disks = Get-CimInstance Win32_LogicalDisk -Filter "DriveType=3" | ForEach-Object {', '  $sizeGB  = if ($_.Size) { [math]::Round($_.Size/1GB, 1) } else { 0 }', '  $freeGB  = if ($_.FreeSpace) { [math]::Round($_.FreeSpace/1GB, 1) } else { 0 }', '  $usedGB  = $sizeGB - $freeGB', '  $pctFree = if ($sizeGB -gt 0) { [math]::Round($freeGB/$sizeGB*100, 1) } else { 0 }', '  [PSCustomObject]@{ Drive=$_.DeviceID; TotalGB=$sizeGB; UsedGB=$usedGB; FreeGB=$freeGB; PctFree=$pctFree }', '}', 'if ($disks) {', '  "--- Drive Free Space ---"', '  $disks | Format-Table Drive, TotalGB, UsedGB, FreeGB, PctFree -AutoSize | Out-String | ForEach-Object { $_.TrimEnd() }', '} else {', '  "No fixed drives found."', '}', '');
+        }
+        // "dirs" or "all" → rank subdirectories by total size
+        if (mode === 'dirs' || mode === 'all') {
+            lines.push('# ── 目录大小排名 ──', 'if (Test-Path $target) {', '  $recurseDepth = if ($depth -eq 0) { $null } else { $depth }', '  $dirs = Get-ChildItem $target -Directory -ErrorAction SilentlyContinue | ForEach-Object {', '    $size = (Get-ChildItem $_.FullName -Recurse' + (depth === 0 ? '' : ' -Depth ($recurseDepth - 1)') + ' -File -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum).Sum', '    $sizeMB = if ($size) { [math]::Round($size/1MB, 1) } else { 0 }', '    [PSCustomObject]@{ Name=$_.Name; SizeMB=$sizeMB }', '  } | Sort-Object SizeMB -Descending | Select-Object -First $top', '  if ($dirs) {', '    "`n--- Directories by Size ---"', '    $dirs | Format-Table Name, @{N="SizeMB";E={$_.SizeMB};Width=12} -AutoSize | Out-String | ForEach-Object { $_.TrimEnd() }', '  } else {', '    "`nNo subdirectories found in target."', '  }', '} else {', '  "Path not found: $target"', '}', '');
+        }
+        // "files" or "all" → rank files by size
+        if (mode === 'files' || mode === 'all') {
+            lines.push('# ── 文件大小排名 ──', 'if (Test-Path $target) {', '  $files = Get-ChildItem $target -File -ErrorAction SilentlyContinue | Sort-Object Length -Descending | Select-Object -First $top | ForEach-Object {', '    $sizeMB = if ($_.Length) { [math]::Round($_.Length/1MB, 1) } else { 0 }', '    [PSCustomObject]@{ Name=$_.Name; SizeMB=$sizeMB }', '  }', '  if ($files) {', '    "`n--- Files by Size (top $top) ---"', '    $files | Format-Table Name, @{N="SizeMB";E={$_.SizeMB};Width=12} -AutoSize | Out-String | ForEach-Object { $_.TrimEnd() }', '  } else {', '    "`nNo files found in target."', '  }', '}', '');
+        }
+        return lines.join('\n');
+    }
+    runPowerShell(script) {
+        return new Promise((resolve, reject) => {
+            const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-du-'));
+            const psFile = path.join(tmpDir, 'script.ps1');
+            const preambleDU = [
+                '[Console]::OutputEncoding = [Text.Encoding]::UTF8',
+                '[Console]::InputEncoding  = [Text.Encoding]::UTF8',
+                '$OutputEncoding = [Text.Encoding]::UTF8',
+                'chcp 65001 > $null',
+            ].join('\n');
+            fs.writeFileSync(psFile, '' + preambleDU + '\n' + script + '\n', 'utf-8');
+            const child = spawn('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-ExecutionPolicy', 'Bypass',
+                '-File', psFile,
+            ], {
+                cwd: this.cwd,
+                env: process.env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true,
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (data) => { stdout += data.toString(); });
+            child.stderr.on('data', (data) => { stderr += data.toString(); });
+            const timer = setTimeout(() => {
+                try {
+                    child.kill();
+                }
+                catch { }
+            }, 120000); // 2 min timeout for disk scans
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                try {
+                    fs.rmSync(tmpDir, { recursive: true, force: true });
+                }
+                catch { }
+                if (code === 0 && stdout.trim()) {
+                    resolve(stdout.trim());
+                }
+                else if (code === 0) {
+                    resolve('No output — the target path may be empty or inaccessible.');
+                }
+                else {
+                    reject(new Error(stderr.trim() || `PowerShell exited with code ${code}`));
+                }
+            });
+            child.on('error', (err) => {
+                clearTimeout(timer);
+                try {
+                    fs.rmSync(tmpDir, { recursive: true, force: true });
+                }
+                catch { }
+                reject(new Error(`Failed to start PowerShell: ${err.message}`));
+            });
+        });
+    }
+    // ── Unix ───────────────────────────────────────────────────────────
+    // 不用 shell 管道，spawn 直接调命令，Node 侧排序取 top N
+    executeUnix(targetPath, top, depth, mode) {
+        return new Promise((resolve) => {
+            const parts = [];
+            let remaining = 0;
+            let done = false;
+            const finish = () => {
+                if (done)
+                    return;
+                resolve(parts.join('\n') || 'No output.');
+                done = true;
+            };
+            const addSegment = (label, content) => {
+                if (content.trim()) {
+                    parts.push(`--- ${label} ---\n${content.trim()}`);
+                }
+            };
+            // df — disk free space (no sorting needed)
+            if (mode === 'free' || mode === 'all') {
+                remaining++;
+                const df = spawn('df', ['-h', targetPath], { env: process.env, stdio: ['ignore', 'pipe', 'pipe'] });
+                let out = '';
+                df.stdout.on('data', (d) => { out += d.toString(); });
+                df.on('close', () => { addSegment('Disk Free Space', out); remaining--; if (remaining === 0)
+                    finish(); });
+                df.on('error', () => { remaining--; if (remaining === 0)
+                    finish(); });
+            }
+            // du — directory sizes, sort by size desc, take top N
+            if (mode === 'dirs' || mode === 'all') {
+                remaining++;
+                const maxDepth = depth === 0 ? undefined : `--max-depth=${depth}`;
+                const duArgs = ['-h', targetPath];
+                if (maxDepth)
+                    duArgs.unshift(maxDepth);
+                const du = spawn('du', duArgs, { env: process.env, stdio: ['ignore', 'pipe', 'pipe'] });
+                let out = '';
+                du.stdout.on('data', (d) => { out += d.toString(); });
+                du.on('close', () => {
+                    const sorted = this.sortDuOutput(out, top);
+                    addSegment(`Directories by Size (top ${top})`, sorted);
+                    remaining--;
+                    if (remaining === 0)
+                        finish();
+                });
+                du.on('error', () => { remaining--; if (remaining === 0)
+                    finish(); });
+            }
+            // find — files by size, sort desc, take top N
+            if (mode === 'files' || mode === 'all') {
+                remaining++;
+                const find = spawn('find', [targetPath, '-maxdepth', '1', '-type', 'f', '-printf', '%s\t%p\n'], {
+                    env: process.env,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                let out = '';
+                find.stdout.on('data', (d) => { out += d.toString(); });
+                find.on('close', () => {
+                    const sorted = this.sortFindOutput(out, top);
+                    addSegment(`Files by Size (top ${top})`, sorted);
+                    remaining--;
+                    if (remaining === 0)
+                        finish();
+                });
+                find.on('error', () => { remaining--; if (remaining === 0)
+                    finish(); });
+            }
+            if (remaining === 0)
+                finish();
+        });
+    }
+    /** 解析 du -h 输出并按大小降序取前 N */
+    sortDuOutput(raw, top) {
+        const lines = raw.trim().split('\n').filter(Boolean);
+        const parsed = lines.map(line => {
+            const m = line.match(/^(\S+)\s+(.+)/);
+            if (!m)
+                return { sizeRaw: line, sizeBytes: 0, path: line };
+            const sizeStr = m[1];
+            return { sizeRaw: sizeStr, sizeBytes: this.parseHumanSize(sizeStr), path: m[2], line };
+        });
+        parsed.sort((a, b) => b.sizeBytes - a.sizeBytes);
+        return parsed.slice(0, top).map(p => p.line).join('\n');
+    }
+    /** 解析 find -printf '%s\t%p' 输出并按大小降序取前 N */
+    sortFindOutput(raw, top) {
+        const lines = raw.trim().split('\n').filter(Boolean);
+        const parsed = lines.map(line => {
+            const idx = line.indexOf('\t');
+            if (idx < 0)
+                return { sizeBytes: 0, label: line };
+            const sizeBytes = parseInt(line.substring(0, idx), 10) || 0;
+            const fpath = line.substring(idx + 1);
+            const sizeMB = (sizeBytes / 1024 / 1024).toFixed(1);
+            return { sizeBytes, label: `${sizeMB.padStart(10)} MB  ${fpath}` };
+        });
+        parsed.sort((a, b) => b.sizeBytes - a.sizeBytes);
+        return parsed.slice(0, top).map(p => p.label).join('\n');
+    }
+    /** 解析 du -h 的人类可读大小 (K/M/G) → 字节数 */
+    parseHumanSize(s) {
+        const m = s.match(/^([\d.]+)\s*([KMGT]?)/i);
+        if (!m)
+            return 0;
+        const num = parseFloat(m[1]);
+        const unit = (m[2] || '').toUpperCase();
+        const mult = { '': 1, K: 1024, M: 1024 ** 2, G: 1024 ** 3, T: 1024 ** 4 };
+        return Math.round(num * (mult[unit] || 1));
+    }
+}
+//# sourceMappingURL=disk-usage.js.map

package/dist/tools/edit.d.ts

@@ -0,0 +1,30 @@
+import type { Tool } from './interface.js';
+/**
+ * EditTool — 在文件中精确替换匹配的字符串 或 按行号替换
+ *
+ * 支持两种模式（互斥）：
+ *
+ * 模式一：字符串替换（原有逻辑）
+ * - old_string (必需): 要被替换的字符串
+ * - new_string (必需): 替换后的字符串
+ * - replace_all (可选): 是否替换所有匹配，默认 false
+ *
+ * 模式二：行号替换（新增）
+ * - line_start (必需): 替换起始行号 (1-based)
+ * - line_count (可选): 替换行数，默认 1
+ * - new_string (必需): 替换后的内容
+ */
+export declare class EditTool implements Tool {
+    readonly name = "edit";
+    readonly description: string;
+    readonly companionDescription = "\u5F97\u6539\u4E00\u4E0B\u4E86\u3002";
+    readonly inputSchema: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<string>;
+    private executeLineReplace;
+    private executeStringReplace;
+    /**
+     * 统计字符串在文本中出现的次数
+     */
+    private countOccurrences;
+}
+//# sourceMappingURL=edit.d.ts.map