import type { ToolResult } from '../../types.js';
export interface RunOpsScriptOptions {
    godot: string;
    projectPath: string;
    script: string;
    loadAutoloads: boolean;
    errorMapper: (msg: string) => string;
    /** appendRuntimePersistWarning 的 action 参数(持久化提示中引用的 action 名) */
    action: string;
    /** 不传则用 executeGdscript 内部默认(解构默认 30s) */
    timeoutSec?: number;
    paramWarnings?: string[];
    /** true 时包 appendRuntimePersistWarning(运行时改动不落盘提示);
     *  条件 warn 的工具(physics/navigation 按 PERSIST_ACTIONS 集合判定)传计算值 */
    warnRuntimePersist?: boolean;
    /** parseGdscriptResult 第 4 参(errorOpts.suggestion),仅 node-3d-ops 使用 */
    errorOpts?: {
        suggestion?: string;
    };
    /** true 走 executeGdscriptTrusted(全沙箱豁免,uid-ops 写 .uid 需 FileAccess.WRITE);
     *  默认 false = executeGdscriptRuntime 通道(仅跳 Phase 3,保留危险 API 正则防线) */
    trusted?: boolean;
}
export declare function runOpsScript(opts: RunOpsScriptOptions): Promise<ToolResult>;