import type { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
import type { z } from "zod";
import type { ILogger } from "../core/logger.js";
import { createNode as apiCreateNode, deleteNode as apiDeleteNode, execNodeMethod as apiExecNodeMethod, execPythonScript as apiExecPythonScript, getModuleHelp as apiGetModuleHelp, getNodeDetail as apiGetNodeDetail, getNodeErrors as apiGetNodeErrors, getNodes as apiGetNodes, getTdInfo as apiGetTdInfo, getTdPythonClassDetails as apiGetTdPythonClassDetails, getTdPythonClasses as apiGetTdPythonClasses, updateNode as apiUpdateNode, type CreateNodeBody, type DeleteNodeParams, type ExecNodeMethodBody, type ExecPythonScriptBody, type GetModuleHelpParams, type GetNodeDetailParams, type GetNodeErrorsParams, type GetNodesParams, type UpdateNodeBody } from "../gen/endpoints/TouchDesignerAPI.js";
/**
 * Interface for TouchDesignerClient HTTP operations
 */
export interface ITouchDesignerApi {
    execNodeMethod: typeof apiExecNodeMethod;
    execPythonScript: typeof apiExecPythonScript;
    getTdInfo: typeof apiGetTdInfo;
    getNodes: typeof apiGetNodes;
    getNodeDetail: typeof apiGetNodeDetail;
    getNodeErrors: typeof apiGetNodeErrors;
    createNode: typeof apiCreateNode;
    updateNode: typeof apiUpdateNode;
    deleteNode: typeof apiDeleteNode;
    getTdPythonClasses: typeof apiGetTdPythonClasses;
    getTdPythonClassDetails: typeof apiGetTdPythonClassDetails;
    getModuleHelp: typeof apiGetModuleHelp;
}
export type TdResponse<T> = {
    success: boolean;
    data: T | null;
    error: string | null;
};
export type ErrorResult<E = Error> = {
    success: false;
    error: E;
};
export type SuccessResult<T> = {
    success: true;
    data: NonNullable<T>;
};
export type Result<T, E = Error> = SuccessResult<T> | ErrorResult<E>;
export declare const ERROR_CACHE_TTL_MS: number;
export declare const SUCCESS_CACHE_TTL_MS: number;
export declare class TouchDesignerClient {
    private readonly logger;
    private readonly api;
    private verifiedCompatibilityError;
    private cachedCompatibilityCheck;
    private errorCacheTimestamp;
    private successCacheTimestamp;
    private compatibilityNotice;
    /**
     * Initialize TouchDesigner client with optional dependencies
     */
    constructor(params?: {
        logger?: ILogger;
        httpClient?: ITouchDesignerApi;
    });
    /**
     * Log debug message
     */
    private logDebug;
    /**
     * Check if the cached error should be cleared (TTL expired)
     */
    private shouldClearErrorCache;
    /**
     * Check whether the cached successful compatibility check is still valid
     */
    private hasValidSuccessCache;
    /**
     * Force the next API call to re-run compatibility verification.
     * Useful when the user explicitly requests version information.
     */
    private invalidateCompatibilityCache;
    getAdditionalToolResultContents(): z.infer<typeof CallToolResultSchema>["content"] | null;
    /**
     * Verify compatibility with the TouchDesigner server
     */
    private verifyCompatibility;
    /**
     * Wrapper for API calls that require compatibility verification
     * @private
     */
    private apiCall;
    /**
     * Execute a node method
     */
    execNodeMethod<DATA extends NonNullable<{
        result: unknown;
    }>>(params: ExecNodeMethodBody): Promise<Result<DATA, Error>>;
    /**
     * Execute a script in TouchDesigner
     */
    execPythonScript<DATA extends {
        result: unknown;
    }>(params: ExecPythonScriptBody): Promise<Result<DATA, Error>>;
    /**
     * Get TouchDesigner server information
     */
    getTdInfo(): Promise<Result<{
        mcpApiVersion: string;
        osName: string;
        osVersion: string;
        server: string;
        version: string;
    }, Error>>;
    /**
     * Get list of nodes
     */
    getNodes(params: GetNodesParams): Promise<Result<{
        nodes?: import("../gen/endpoints/TouchDesignerAPI.js").TdNode[];
    }, Error>>;
    /**
     * Get node properties
     */
    getNodeDetail(params: GetNodeDetailParams): Promise<Result<import("../gen/endpoints/TouchDesignerAPI.js").TdNode, Error>>;
    /**
     * Get node error information
     */
    getNodeErrors(params: GetNodeErrorsParams): Promise<Result<import("../gen/endpoints/TouchDesignerAPI.js").TdNodeErrorReport, Error>>;
    /**
     * Create a new node
     */
    createNode(params: CreateNodeBody): Promise<Result<{
        result?: import("../gen/endpoints/TouchDesignerAPI.js").TdNode;
    }, Error>>;
    /**
     * Update node properties
     */
    updateNode(params: UpdateNodeBody): Promise<Result<{
        path?: string;
        updated?: string[];
        failed?: import("../gen/endpoints/TouchDesignerAPI.js").UpdateNode200DataFailedItem[];
        message?: string;
    }, Error>>;
    /**
     * Delete a node
     */
    deleteNode(params: DeleteNodeParams): Promise<Result<{
        deleted?: boolean;
        node?: import("../gen/endpoints/TouchDesignerAPI.js").TdNode;
    }, Error>>;
    /**
     * Get list of available Python classes/modules in TouchDesigner
     */
    getClasses(): Promise<Result<{
        classes?: import("../gen/endpoints/TouchDesignerAPI.js").TdPythonClassInfo[];
    }, Error>>;
    /**
     * Get details of a specific class/module
     */
    getClassDetails(className: string): Promise<Result<import("../gen/endpoints/TouchDesignerAPI.js").TdPythonClassDetails, Error>>;
    /**
     * Retrieve Python help() documentation for modules/classes
     */
    getModuleHelp(params: GetModuleHelpParams): Promise<Result<import("../gen/endpoints/TouchDesignerAPI.js").ModuleHelp, Error>>;
    verifyVersionCompatibility(): Promise<{
        success: false;
        error: Error;
    } | {
        success: true;
        data: {
            level: "info" | "warning";
            message: string;
        };
    }>;
    /**
     * Format connection errors with helpful messages
     */
    private formatConnectionError;
    private checkVersionCompatibility;
}