import type { ExecuteGdscriptResult } from '../../gdscript-executor.js';
import type { ToolResult } from '../../types.js';
/** Common error codes shared across tool modules. */
export declare const COMMON_ERROR_CODES: {
    readonly INVALID_PARAMS: "INVALID_PARAMS";
    readonly NODE_NOT_FOUND: "NODE_NOT_FOUND";
    readonly SCRIPT_EXEC_FAILED: "SCRIPT_EXEC_FAILED";
    readonly INVALID_TYPE: "INVALID_TYPE";
    readonly INVALID_VALUE: "INVALID_VALUE";
};
export declare const NON_PERSIST = "\u8FD0\u884C\u65F6\u64CD\u4F5C\uFF0C\u4EC5\u5F71\u54CD\u5F53\u524D\u6267\u884C\u4E0A\u4E0B\u6587\u3002\u5982\u9700\u6301\u4E45\u5316\uFF0C\u8BF7\u7F16\u8F91 .tscn \u6587\u4EF6\u3002";
export declare function opsSuccess(data: unknown, warnings?: string[]): {
    success: boolean;
    data: unknown;
    warnings: string[];
};
export declare function opsError(errorCode: string, message: string, opts?: {
    suggestion?: string;
    retryable?: boolean;
    errorCategory?: string;
    traceId?: string;
}): {
    trace_id?: string | undefined;
    error_category?: string | undefined;
    retryable?: boolean | undefined;
    suggestion?: string | undefined;
    success: boolean;
    error: string;
    error_code: string;
    warnings: string[];
};
export declare function opsErrorResult(errorCode: string, message: string, opts?: {
    suggestion?: string;
    retryable?: boolean;
    errorCategory?: string;
    traceId?: string;
}): ToolResult;
export declare function parseGdscriptResult(result: ExecuteGdscriptResult, paramWarnings?: string[], errorMapper?: (errorMsg: string) => string, errorOpts?: {
    suggestion?: string;
}): ToolResult;