touchdesigner-mcp-server 1.2.0 → 1.3.1

package/dist/features/tools/handlers/tdTools.js

@@ -1,19 +1,21 @@
 import { z } from "zod";
 import { REFERENCE_COMMENT, TOOL_NAMES } from "../../../core/constants.js";
 import { handleToolError } from "../../../core/errorHandling.js";
-import { createNodeBody, deleteNodeQueryParams, execNodeMethodBody, execPythonScriptBody, getNodeDetailQueryParams, getNodesQueryParams, getTdPythonClassDetailsParams, updateNodeBody, } from "../../../gen/mcp/touchDesignerAPI.zod.js";
+import { createNodeBody, deleteNodeQueryParams, execNodeMethodBody, execPythonScriptBody, getModuleHelpQueryParams, getNodeDetailQueryParams, getNodeErrorsQueryParams, getNodesQueryParams, getTdPythonClassDetailsParams, updateNodeBody, } from "../../../gen/mcp/touchDesignerAPI.zod.js";
 import { getTouchDesignerToolMetadata } from "../metadata/touchDesignerToolMetadata.js";
-import { formatClassDetails, formatClassList, formatCreateNodeResult, formatDeleteNodeResult, formatExecNodeMethodResult, formatNodeDetails, formatNodeList, formatScriptResult, formatTdInfo, formatToolMetadata, formatUpdateNodeResult, } from "../presenter/index.js";
+import { formatClassDetails, formatClassList, formatCreateNodeResult, formatDeleteNodeResult, formatExecNodeMethodResult, formatModuleHelp, formatNodeDetails, formatNodeErrors, formatNodeList, formatScriptResult, formatTdInfo, formatToolMetadata, formatUpdateNodeResult, } from "../presenter/index.js";
 import { detailOnlyFormattingSchema, formattingOptionsSchema, } from "../types.js";
 const execPythonScriptToolSchema = execPythonScriptBody.extend(detailOnlyFormattingSchema.shape);
 const tdInfoToolSchema = detailOnlyFormattingSchema;
 const getNodesToolSchema = getNodesQueryParams.extend(formattingOptionsSchema.shape);
 const getNodeDetailToolSchema = getNodeDetailQueryParams.extend(formattingOptionsSchema.shape);
+const getNodeErrorsToolSchema = getNodeErrorsQueryParams.extend(formattingOptionsSchema.shape);
 const createNodeToolSchema = createNodeBody.extend(detailOnlyFormattingSchema.shape);
 const updateNodeToolSchema = updateNodeBody.extend(detailOnlyFormattingSchema.shape);
 const deleteNodeToolSchema = deleteNodeQueryParams.extend(detailOnlyFormattingSchema.shape);
 const classListToolSchema = formattingOptionsSchema;
 const classDetailToolSchema = getTdPythonClassDetailsParams.extend(formattingOptionsSchema.shape);
+const moduleHelpToolSchema = getModuleHelpQueryParams.extend(detailOnlyFormattingSchema.shape);
 const execNodeMethodToolSchema = execNodeMethodBody.extend(detailOnlyFormattingSchema.shape);
 const describeToolsSchema = detailOnlyFormattingSchema.extend({
     filter: z
@@ -38,22 +40,22 @@ export function registerTdTools(server, logger, tdClient) {
                 return {
                     content: [
                         {
-                            type: "text",
                             text: message,
+                            type: "text",
                         },
                     ],
                 };
             }
             const formattedText = formatToolMetadata(filteredEntries, {
                 detailLevel: detailLevel ?? (filter ? "summary" : "minimal"),
-                responseFormat,
                 filter: normalizedFilter,
+                responseFormat,
             });
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -76,8 +78,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -89,7 +91,10 @@ export function registerTdTools(server, logger, tdClient) {
     server.tool(TOOL_NAMES.EXECUTE_PYTHON_SCRIPT, "Execute a Python script in TouchDesigner (detailLevel=minimal|summary|detailed, responseFormat=json|yaml|markdown)", execPythonScriptToolSchema.strict().shape, async (params) => {
         try {
             const { detailLevel, responseFormat, ...scriptParams } = params;
-            logger.debug(`Executing script: ${scriptParams.script}`);
+            logger.sendLog({
+                data: `Executing script: ${scriptParams.script}`,
+                level: "debug",
+            });
             const result = await tdClient.execPythonScript(scriptParams);
             if (!result.success) {
                 throw result.error;
@@ -102,8 +107,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -126,8 +131,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -150,8 +155,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -179,8 +184,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -205,8 +210,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -215,6 +220,31 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_NODE_PARAMETERS, REFERENCE_COMMENT);
         }
     });
+    server.tool(TOOL_NAMES.GET_TD_NODE_ERRORS, "Check node and descendant errors reported by TouchDesigner", getNodeErrorsToolSchema.strict().shape, async (params) => {
+        try {
+            const { detailLevel, limit, responseFormat, ...queryParams } = params;
+            const result = await tdClient.getNodeErrors(queryParams);
+            if (!result.success) {
+                throw result.error;
+            }
+            const formattedText = formatNodeErrors(result.data, {
+                detailLevel: detailLevel ?? "summary",
+                limit,
+                responseFormat,
+            });
+            return {
+                content: [
+                    {
+                        text: formattedText,
+                        type: "text",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error, logger, TOOL_NAMES.GET_TD_NODE_ERRORS, REFERENCE_COMMENT);
+        }
+    });
     server.tool(TOOL_NAMES.UPDATE_TD_NODE_PARAMETERS, "Update parameters of a specific node in TouchDesigner", updateNodeToolSchema.strict().shape, async (params) => {
         try {
             const { detailLevel, responseFormat, ...updateParams } = params;
@@ -229,8 +259,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -247,18 +277,21 @@ export function registerTdTools(server, logger, tdClient) {
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatExecNodeMethodResult(result.data, { nodePath, method, args, kwargs }, { detailLevel: detailLevel ?? "summary", responseFormat });
+            const formattedText = formatExecNodeMethodResult(result.data, { args, kwargs, method, nodePath }, { detailLevel: detailLevel ?? "summary", responseFormat });
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
         }
         catch (error) {
-            logger.error(error);
+            logger.sendLog({
+                data: error,
+                level: "error",
+            });
             return handleToolError(error, logger, TOOL_NAMES.EXECUTE_NODE_METHOD, REFERENCE_COMMENT);
         }
     });
@@ -277,8 +310,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -303,8 +336,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -313,6 +346,30 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_CLASS_DETAILS, REFERENCE_COMMENT);
         }
     });
+    server.tool(TOOL_NAMES.GET_TD_MODULE_HELP, "Retrieve Python help() text for a TouchDesigner module or class", moduleHelpToolSchema.strict().shape, async (params) => {
+        try {
+            const { detailLevel, moduleName, responseFormat } = params;
+            const result = await tdClient.getModuleHelp({ moduleName });
+            if (!result.success) {
+                throw result.error;
+            }
+            const formattedText = formatModuleHelp(result.data, {
+                detailLevel: detailLevel ?? "summary",
+                responseFormat,
+            });
+            return {
+                content: [
+                    {
+                        text: formattedText,
+                        type: "text",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error, logger, TOOL_NAMES.GET_TD_MODULE_HELP);
+        }
+    });
 }
 function matchesMetadataFilter(entry, keyword) {
     const normalizedKeyword = keyword.toLowerCase();