touchdesigner-mcp-server 1.4.8 → 1.4.10

package/dist/gen/mcp/touchDesignerAPI.zod.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Generated by orval v8.17.0 🍺
+ * Do not edit manually.
+ * TouchDesigner API
+ * OpenAPI schema for generating TouchDesigner API client code
+ * OpenAPI spec version: 1.4.3
+ */
+import * as zod from 'zod';
+/**
+ * @summary Get nodes in the path
+ */
+export declare const getNodesQueryPatternDefault = "*";
+export declare const getNodesQueryIncludePropertiesDefault = false;
+export declare const GetNodesQueryParams: zod.ZodObject<{
+    parentPath: zod.ZodString;
+    pattern: zod.ZodDefault<zod.ZodString>;
+    includeProperties: zod.ZodDefault<zod.ZodBoolean>;
+}, zod.z.core.$strip>;
+export declare const GetNodesResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        nodes: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+            id: zod.ZodNumber;
+            opType: zod.ZodString;
+            name: zod.ZodString;
+            path: zod.ZodString;
+            properties: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+        }, zod.z.core.$strip>>>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * @summary Create a new node
+ */
+export declare const CreateNodeBody: zod.ZodObject<{
+    parentPath: zod.ZodString;
+    nodeType: zod.ZodString;
+    nodeName: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strip>;
+export declare const CreateNodeResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        result: zod.ZodOptional<zod.ZodObject<{
+            id: zod.ZodNumber;
+            opType: zod.ZodString;
+            name: zod.ZodString;
+            path: zod.ZodString;
+            properties: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+        }, zod.z.core.$strip>>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * @summary Delete an existing node
+ */
+export declare const DeleteNodeQueryParams: zod.ZodObject<{
+    nodePath: zod.ZodString;
+}, zod.z.core.$strip>;
+export declare const DeleteNodeResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        deleted: zod.ZodOptional<zod.ZodBoolean>;
+        node: zod.ZodOptional<zod.ZodObject<{
+            id: zod.ZodNumber;
+            opType: zod.ZodString;
+            name: zod.ZodString;
+            path: zod.ZodString;
+            properties: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+        }, zod.z.core.$strip>>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Retrieves detailed information about a specific node including its properties, parameters and connections
+ * @summary Get node detail
+ */
+export declare const GetNodeDetailQueryParams: zod.ZodObject<{
+    nodePath: zod.ZodString;
+}, zod.z.core.$strip>;
+export declare const GetNodeDetailResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        id: zod.ZodNumber;
+        opType: zod.ZodString;
+        name: zod.ZodString;
+        path: zod.ZodString;
+        properties: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * @summary Update node properties
+ */
+export declare const UpdateNodeBody: zod.ZodObject<{
+    nodePath: zod.ZodString;
+    properties: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+}, zod.z.core.$strip>;
+export declare const UpdateNodeResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        path: zod.ZodOptional<zod.ZodString>;
+        updated: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
+        failed: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+            name: zod.ZodOptional<zod.ZodString>;
+            reason: zod.ZodOptional<zod.ZodString>;
+        }, zod.z.core.$strip>>>;
+        message: zod.ZodOptional<zod.ZodString>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Collects TouchDesigner error messages for a node and its children
+ * @summary Get node errors
+ */
+export declare const GetNodeErrorsQueryParams: zod.ZodObject<{
+    nodePath: zod.ZodString;
+}, zod.z.core.$strip>;
+export declare const GetNodeErrorsResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodObject<{
+        nodePath: zod.ZodString;
+        nodeName: zod.ZodString;
+        opType: zod.ZodString;
+        errorCount: zod.ZodNumber;
+        hasErrors: zod.ZodBoolean;
+        errors: zod.ZodArray<zod.ZodObject<{
+            nodePath: zod.ZodString;
+            nodeName: zod.ZodString;
+            opType: zod.ZodString;
+            message: zod.ZodString;
+        }, zod.z.core.$strip>>;
+    }, zod.z.core.$strip>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Returns a list of Python classes, modules, and functions available in TouchDesigner
+ * @summary Get a list of Python classes and modules
+ */
+export declare const GetTdPythonClassesResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        classes: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+            name: zod.ZodString;
+            type: zod.ZodEnum<{
+                object: "object";
+                function: "function";
+                class: "class";
+                module: "module";
+            }>;
+            description: zod.ZodOptional<zod.ZodString>;
+        }, zod.z.core.$strip>>>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Returns detailed information about a specific Python class, module, or function including methods, properties, and documentation
+ * @summary Get details of a specific Python class or module
+ */
+export declare const GetTdPythonClassDetailsParams: zod.ZodObject<{
+    className: zod.ZodString;
+}, zod.z.core.$strip>;
+export declare const GetTdPythonClassDetailsResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        name: zod.ZodString;
+        type: zod.ZodEnum<{
+            object: "object";
+            function: "function";
+            class: "class";
+            module: "module";
+        }>;
+        description: zod.ZodOptional<zod.ZodString>;
+        methods: zod.ZodArray<zod.ZodObject<{
+            name: zod.ZodString;
+            signature: zod.ZodOptional<zod.ZodString>;
+            description: zod.ZodOptional<zod.ZodString>;
+        }, zod.z.core.$strip>>;
+        properties: zod.ZodArray<zod.ZodObject<{
+            name: zod.ZodString;
+            type: zod.ZodString;
+            value: zod.ZodOptional<zod.ZodNullable<zod.ZodObject<{}, zod.z.core.$loose>>>;
+        }, zod.z.core.$strip>>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Retrieve Python help() documentation for TouchDesigner modules, classes, or utilities like tdu.
+ * @summary Get module/class Python help documentation
+ */
+export declare const GetModuleHelpQueryParams: zod.ZodObject<{
+    moduleName: zod.ZodString;
+}, zod.z.core.$strip>;
+export declare const GetModuleHelpResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        moduleName: zod.ZodString;
+        helpText: zod.ZodString;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Call a method on the node at the specified path (e.g., /project1).
+ * This allows operations equivalent to TouchDesigner's Python API such as
+ * `parent_comp = op('/project1')` and `parent_comp.create('textTOP', 'myText')`.
+ * @summary Call a method of the specified node
+ */
+export declare const ExecNodeMethodBody: zod.ZodObject<{
+    nodePath: zod.ZodString;
+    method: zod.ZodString;
+    args: zod.ZodOptional<zod.ZodArray<zod.ZodUnion<readonly [zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>>>;
+    kwargs: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+}, zod.z.core.$strip>;
+export declare const ExecNodeMethodResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        result: zod.ZodUnknown;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Execute a Python script directly in TouchDesigner.
+ * Multiline scripts and scripts containing comments are supported.
+ * The script can optionally set a `result` variable to explicitly return a value.
+ * This endpoint allows you to interact with TouchDesigner nodes programmatically.
+ * @summary Execute python code on the server
+ */
+export declare const ExecPythonScriptBody: zod.ZodObject<{
+    script: zod.ZodString;
+}, zod.z.core.$strip>;
+export declare const ExecPythonScriptResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        result: zod.ZodObject<{
+            value: zod.ZodOptional<zod.ZodUnknown>;
+        }, zod.z.core.$strip>;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;
+/**
+ * Returns information about the TouchDesigner
+ * @summary Get TouchDesigner information
+ */
+export declare const GetTdInfoResponse: zod.ZodObject<{
+    success: zod.ZodBoolean;
+    data: zod.ZodNullable<zod.ZodObject<{
+        mcpApiVersion: zod.ZodString;
+        osName: zod.ZodString;
+        osVersion: zod.ZodString;
+        server: zod.ZodString;
+        version: zod.ZodString;
+    }, zod.z.core.$strip>>;
+    error: zod.ZodNullable<zod.ZodString>;
+}, zod.z.core.$strip>;

package/dist/gen/mcp/touchDesignerAPI.zod.js

@@ -1,31 +1,11 @@
 /**
- * Generated by orval v8.16.0 🍺
+ * Generated by orval v8.17.0 🍺
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
  * OpenAPI spec version: 1.4.3
  */
 import * as zod from 'zod';
-/**
- * @summary Delete an existing node
- */
-export const DeleteNodeQueryParams = zod.object({
-    "nodePath": zod.string().describe('Path to the node to delete. e.g., \"\/project1\/geo1\"')
-});
-export const DeleteNodeResponse = zod.object({
-    "success": zod.boolean().describe('Whether the operation was successful'),
-    "data": zod.object({
-        "deleted": zod.boolean().optional().describe('Whether the node was successfully deleted'),
-        "node": zod.object({
-            "id": zod.number(),
-            "opType": zod.string(),
-            "name": zod.string(),
-            "path": zod.string(),
-            "properties": zod.record(zod.string(), zod.unknown())
-        }).optional().describe('Information about a TouchDesigner node')
-    }).nullable(),
-    "error": zod.string().nullable().describe('Error message if the operation was not successful')
-});
 /**
  * @summary Get nodes in the path
  */
@@ -66,7 +46,27 @@ export const CreateNodeResponse = zod.object({
             "name": zod.string(),
             "path": zod.string(),
             "properties": zod.record(zod.string(), zod.unknown())
-        }).optional().describe('Information about a TouchDesigner node')
+        }).optional().describe('Result of the execution')
+    }).nullable(),
+    "error": zod.string().nullable().describe('Error message if the operation was not successful')
+});
+/**
+ * @summary Delete an existing node
+ */
+export const DeleteNodeQueryParams = zod.object({
+    "nodePath": zod.string().describe('Path to the node to delete. e.g., \"\/project1\/geo1\"')
+});
+export const DeleteNodeResponse = zod.object({
+    "success": zod.boolean().describe('Whether the operation was successful'),
+    "data": zod.object({
+        "deleted": zod.boolean().optional().describe('Whether the node was successfully deleted'),
+        "node": zod.object({
+            "id": zod.number(),
+            "opType": zod.string(),
+            "name": zod.string(),
+            "path": zod.string(),
+            "properties": zod.record(zod.string(), zod.unknown())
+        }).optional().describe('Information about the deleted node')
     }).nullable(),
     "error": zod.string().nullable().describe('Error message if the operation was not successful')
 });
@@ -85,7 +85,7 @@ export const GetNodeDetailResponse = zod.object({
         "name": zod.string(),
         "path": zod.string(),
         "properties": zod.record(zod.string(), zod.unknown())
-    }).describe('Information about a TouchDesigner node'),
+    }).nullable().describe('Information about a TouchDesigner node'),
     "error": zod.string().nullable().describe('Error message if the operation was not successful')
 });
 /**
@@ -170,7 +170,7 @@ export const GetTdPythonClassDetailsResponse = zod.object({
             "type": zod.string().describe('Type of the property'),
             "value": zod.looseObject({}).nullish().describe('Current value of the property (if serializable)')
         }).describe('Information about a Python property')).describe('List of properties available in the class or module')
-    }).describe('Detailed information about a Python class or module'),
+    }).nullable().describe('Detailed information about a Python class or module'),
     "error": zod.string().nullable().describe('Error message if the operation was not successful')
 });
 /**
@@ -185,7 +185,7 @@ export const GetModuleHelpResponse = zod.object({
     "data": zod.object({
         "moduleName": zod.string().describe('Normalized module\/class name the help text was generated for'),
         "helpText": zod.string().describe('Captured output from Python\'s help() function')
-    }).describe('Raw Python help() output for a TouchDesigner module or class'),
+    }).nullable().describe('Raw Python help() output for a TouchDesigner module or class'),
     "error": zod.string().nullable().describe('Error message if the operation was not successful')
 });
 /**
@@ -203,7 +203,7 @@ export const ExecNodeMethodBody = zod.object({
 export const ExecNodeMethodResponse = zod.object({
     "success": zod.boolean().describe('Whether the operation was successful'),
     "data": zod.object({
-        "result": zod.looseObject({}).describe('Result of the method call. Can be any type (equivalent to unknown in TypeScript).')
+        "result": zod.unknown().describe('Result of the method call. Can be any type (equivalent to unknown in TypeScript).')
     }).nullable(),
     "error": zod.string().nullable().describe('Error message if the operation was not successful')
 });
@@ -221,7 +221,7 @@ export const ExecPythonScriptResponse = zod.object({
     "success": zod.boolean().describe('Whether the operation was successful'),
     "data": zod.object({
         "result": zod.object({
-            "value": zod.looseObject({}).optional().describe('Return value of the executed script, can be any serializable value')
+            "value": zod.unknown().optional().describe('Return value of the executed script, can be any serializable value')
         }).describe('Result of the executed script')
     }).nullable(),
     "error": zod.string().nullable().describe('Error message if the operation was not successful')

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { startServer } from "./cli.js";
+export { TouchDesignerServer } from "./server/touchDesignerServer.js";
+export { createTouchDesignerClient, TouchDesignerClient, } from "./tdClient/index.js";

package/dist/server/connectionManager.d.ts

@@ -0,0 +1,25 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { ILogger } from "../core/logger.js";
+import type { Result } from "../core/result.js";
+/**
+ * Manages the connection between TouchDesignerServer and MCP transport
+ */
+export declare class ConnectionManager {
+    private readonly server;
+    private readonly logger;
+    private transport;
+    constructor(server: McpServer, logger: ILogger);
+    /**
+     * Connect to MCP transport
+     */
+    connect(transport: Transport): Promise<Result<void, Error>>;
+    /**
+     * Disconnect from MCP transport
+     */
+    disconnect(): Promise<Result<void, Error>>;
+    /**
+     * Check if connected to MCP transport
+     */
+    isConnected(): boolean;
+}

package/dist/server/touchDesignerServer.d.ts

@@ -0,0 +1,59 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { ILogger } from "../core/logger.js";
+import type { Result } from "../core/result.js";
+import type { TouchDesignerClient } from "../tdClient/touchDesignerClient.js";
+/**
+ * Capabilities supported by TouchDesigner MCP Server
+ */
+export interface TouchDesignerCapabilities {
+    logging: Record<string, never>;
+    prompts: Record<string, never>;
+    tools: Record<string, never>;
+}
+/**
+ * TouchDesigner MCP Server implementation
+ */
+export declare class TouchDesignerServer {
+    readonly server: McpServer;
+    readonly logger: ILogger;
+    readonly tdClient: TouchDesignerClient;
+    private readonly connectionManager;
+    /**
+     * Initialize TouchDesignerServer with proper dependency injection
+     */
+    constructor();
+    /**
+     * Create a new TouchDesignerServer instance
+     *
+     * Factory method for creating server instances in multi-session scenarios.
+     * Each session should have its own server instance to maintain independent MCP protocol state.
+     *
+     * @returns McpServer instance ready for connection to a transport
+     *
+     * @example
+     * ```typescript
+     * // In TransportRegistry
+     * const serverFactory = () => TouchDesignerServer.create();
+     * const transport = await registry.getOrCreate(sessionId, body, serverFactory);
+     * ```
+     */
+    static create(): McpServer;
+    /**
+     * Connect to MCP transport
+     */
+    connect(transport: Transport): Promise<Result<void, Error>>;
+    /**
+     * Disconnect from MCP transport
+     */
+    disconnect(): Promise<Result<void, Error>>;
+    /**
+     * Check if connected to MCP transport
+     */
+    isConnectedToMCP(): boolean;
+    /**
+     * Register all features with the server
+     * Only called after all dependencies are initialized
+     */
+    private registerAllFeatures;
+}

package/dist/tdClient/index.d.ts

@@ -0,0 +1,7 @@
+import type { ILogger } from "../core/logger.js";
+import { TouchDesignerClient } from "./touchDesignerClient.js";
+export interface CreateTouchDesignerClientParams {
+    logger: ILogger;
+}
+export declare function createTouchDesignerClient(params: CreateTouchDesignerClientParams): TouchDesignerClient;
+export { TouchDesignerClient } from "./touchDesignerClient.js";

package/dist/tdClient/touchDesignerClient.d.ts

@@ -0,0 +1,167 @@
+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;
+}