/**
 * 文件工具内部错误。
 *
 * 关键点（中文）
 * - 内部流程通过类型化错误中断，tool 边界再统一转换为结构化失败结果。
 * - 不把 Node.js 原始错误码直接暴露为公共协议。
 */
import type { FileEditDetail, FileToolErrorCode, FileToolFailure } from "../../types/workspace/FileTool.js";
/** 文件工具可识别的内部错误。 */
export declare class FileToolRuntimeError extends Error {
    /** 稳定的公共错误码。 */
    readonly error_code: FileToolErrorCode;
    /** 已完成解析时的目标绝对路径。 */
    readonly file_path?: string;
    /** 编辑失败时的匹配详情。 */
    readonly details?: FileEditDetail[];
    constructor(params: {
        /** 稳定的公共错误码。 */
        error_code: FileToolErrorCode;
        /** 人类可读错误信息。 */
        message: string;
        /** 已完成解析时的目标绝对路径。 */
        file_path?: string;
        /** 编辑失败时的匹配详情。 */
        details?: FileEditDetail[];
    });
}
/** 把内部或 Node.js 错误转换为稳定失败结果。 */
export declare function to_file_tool_failure(error: unknown, fallback_file_path?: string): FileToolFailure;
//# sourceMappingURL=FileToolError.d.ts.map