import type { Tool } from '@modelcontextprotocol/sdk/types.js';
import type { ToolContext, ToolResult } from '../types.js';
export declare const TYPE_WHITELIST: readonly ["Node3D", "MeshInstance3D", "StaticBody3D", "RigidBody3D", "CharacterBody3D", "Camera3D", "Light3D", "DirectionalLight3D", "OmniLight3D", "SpotLight3D", "CollisionShape3D", "RayCast3D", "Area3D", "Marker3D", "PathFollow3D", "VisibleOnScreenNotifier3D"];
export declare const ERROR_CODES: {
    readonly INVALID_PATH: "INVALID_PATH";
    readonly NODE_NOT_FOUND: "NODE_NOT_FOUND";
    readonly INVALID_VECTOR: "INVALID_VECTOR";
    readonly INVALID_TYPE: "INVALID_TYPE";
    readonly INVALID_SIGNAL: "INVALID_SIGNAL";
    readonly SCRIPT_EXEC_FAILED: "SCRIPT_EXEC_FAILED";
    readonly AUDIO_NOT_FOUND: "AUDIO_NOT_FOUND";
};
export declare function normalizeNodePath(input: string): string;
export declare function gdEscape(s: string): string;
export declare function validateVector3(v: unknown): {
    x: number;
    y: number;
    z: number;
};
export declare function genSignalConnectScript(sourcePath: string, signalName: string, targetPath: string, methodName: string, flags?: number): string;
export declare function genSignalDisconnectScript(sourcePath: string, signalName: string, targetPath: string, methodName: string): string;
export declare function genSignalEmitScript(sourcePath: string, signalName: string, args?: unknown[]): string;
export declare function genSignalListScript(nodePath: string): string;
export declare function genRaycastScript(from: {
    x: number;
    y: number;
    z: number;
}, to: {
    x: number;
    y: number;
    z: number;
}, collisionMask?: number, excludePaths?: string[]): string;
export declare function genBodyInfoScript(bodyPath: string): string;
export declare function genDiagnosePhysicsScript(bodyPath: string): string;
export declare function genQuerySpatialScript(center: {
    x: number;
    y: number;
    z: number;
}, radius: number, collisionMask?: number): string;
export declare function genCollisionOverlayScript(parentPath: string, colorOverride?: string): string;
export declare function genCreate3DScript(nodeType: string, nodeName: string, parentPath: string, position?: {
    x: number;
    y: number;
    z: number;
}, rotation?: {
    x: number;
    y: number;
    z: number;
}, scale?: {
    x: number;
    y: number;
    z: number;
}, properties?: Record<string, unknown>): string;
export declare function genNavQueryScript(startPos: {
    x: number;
    y: number;
    z: number;
}, endPos: {
    x: number;
    y: number;
    z: number;
}, navigationRegion?: string): string;
export declare function genAudioPlayScript(nodePath: string, streamPath?: string, volumeDb?: number, pitchScale?: number, bus?: string, fromPosition?: number): string;
export declare function genAudioStopScript(nodePath: string): string;
export declare function genAudioSetParamScript(nodePath: string, param: 'volume_db' | 'pitch_scale' | 'bus', value: number | string): string;
export declare function genAudioQueryScript(nodePath: string): string;
export declare function getToolDefinitions(): Tool[];
export declare function handleTool(name: string, args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult | null>;
export declare const TOOL_META: Record<string, {
    readonly: boolean;
    long_running: boolean;
}>;