touchdesigner-mcp-server 1.1.1 → 1.1.2

package/dist/features/tools/presenter/templates/markdown/classListSummary.md

@@ -0,0 +1,7 @@
+## TouchDesigner Classes ({{classCount}})
+{{#classes}}- `{{name}}` — {{{description}}}
+{{/classes}}
+
+## Modules ({{moduleCount}})
+{{#modules}}- `{{.}}`
+{{/modules}}

package/dist/features/tools/presenter/templates/markdown/default.md

@@ -0,0 +1,3 @@
+## {{title}}
+
+{{{text}}}

package/dist/features/tools/presenter/templates/markdown/detailedPayload.md

@@ -0,0 +1,5 @@
+## {{title}}
+
+```{{payloadFormat}}
+{{{payload}}}
+```

package/dist/features/tools/presenter/templates/markdown/nodeDetailsSummary.md

@@ -0,0 +1,10 @@
+## Node {{nodePath}}
+- Type: `{{type}}` (ID: {{id}})
+- Properties shown: {{displayed}} / {{total}}
+
+| Property | Value |
+| --- | --- |
+{{#properties}}| {{name}} | {{{value}}} |
+{{/properties}}
+
+{{#truncated}}_💡 {{omittedCount}} more properties omitted._{{/truncated}}

package/dist/features/tools/presenter/templates/markdown/nodeListSummary.md

@@ -0,0 +1,8 @@
+## Nodes in {{{parentPath}}} ({{totalCount}} total)
+{{#groups}}
+### {{type}} ({{count}})
+{{#nodes}}- **{{name}}** — `{{{path}}}`
+{{/nodes}}
+
+{{/groups}}
+{{#truncated}}_💡 {{omittedCount}} more node(s) omitted. Use `limit` or `detailLevel=detailed` to view all._{{/truncated}}

package/dist/features/tools/presenter/templates/markdown/scriptSummary.md

@@ -0,0 +1,15 @@
+## Script Result
+- Snippet: `{{{snippet}}}`
+- Return type: {{resultType}}
+{{#hasOutput}}- Output type: {{outputType}}
+{{/hasOutput}}
+
+```text
+{{{resultPreview}}}
+```
+
+{{#outputPreview}}
+```text
+{{{outputPreview}}}
+```
+{{/outputPreview}}

package/dist/features/tools/presenter/toolMetadataFormatter.js

@@ -0,0 +1,118 @@
+import { finalizeFormattedText, mergeFormatterOptions, } from "./responseFormatter.js";
+export function formatToolMetadata(entries, options) {
+    const { detailLevel, responseFormat } = mergeFormatterOptions(options);
+    if (entries.length === 0) {
+        return finalizeFormattedText("No tools matched the requested criteria.", { detailLevel, responseFormat }, {
+            context: { totalTools: 0, filter: options?.filter },
+        });
+    }
+    const sortedEntries = [...entries].sort((a, b) => a.modulePath.localeCompare(b.modulePath));
+    const structured = sortedEntries.map((entry) => ({
+        tool: entry.tool,
+        modulePath: entry.modulePath,
+        functionName: entry.functionName,
+        description: entry.description,
+        category: entry.category,
+        parameters: entry.parameters,
+        returns: entry.returns,
+        notes: entry.notes,
+    }));
+    const text = buildText(sortedEntries, detailLevel);
+    return finalizeFormattedText(text, { detailLevel, responseFormat }, {
+        structured,
+        context: {
+            totalTools: sortedEntries.length,
+            filter: options?.filter,
+        },
+        template: detailLevel === "detailed" ? "detailedPayload" : undefined,
+    });
+}
+function buildText(entries, detailLevel) {
+    switch (detailLevel) {
+        case "minimal":
+            return formatTree(entries);
+        case "detailed":
+            return formatDetailed(entries);
+        default:
+            return formatSummary(entries);
+    }
+}
+function formatTree(entries) {
+    const segmentsList = entries.map((entry) => entry.modulePath.replace(/^\.\//, "").split("/"));
+    const commonSegments = findCommonDirectorySegments(segmentsList);
+    const basePath = commonSegments.length > 0 ? `${commonSegments.join("/")}/` : "./";
+    const relativePaths = entries.map((entry, index) => {
+        const segments = segmentsList[index];
+        const relative = segments.slice(commonSegments.length).join("/");
+        const connector = index === entries.length - 1 ? "└──" : "├──";
+        return `${connector} ${relative} — ${entry.description}`;
+    });
+    return ["Filesystem blueprint:", basePath, ...relativePaths].join("\n");
+}
+function formatSummary(entries) {
+    return entries
+        .map((entry) => {
+        const params = entry.parameters.length > 0
+            ? entry.parameters
+                .map((param) => `- ${param.name}${param.required ? "" : "?"} (${param.type})${param.description ? ` — ${param.description}` : ""}`)
+                .join("\n")
+            : "- (no parameters)";
+        return `${entry.functionName} (${entry.modulePath})
+Tool: ${entry.tool}
+Category: ${entry.category}
+Description: ${entry.description}
+Parameters:
+${params}
+Returns: ${entry.returns}`;
+    })
+        .join("\n\n");
+}
+function formatDetailed(entries) {
+    return entries
+        .map((entry) => {
+        const params = entry.parameters.length > 0
+            ? entry.parameters
+                .map((param) => `- ${param.name}${param.required ? "" : "?"} (${param.type})${param.description ? ` — ${param.description}` : ""}`)
+                .join("\n")
+            : "- (no parameters)";
+        const sections = [
+            `### ${entry.functionName} (${entry.tool})`,
+            `Module: ${entry.modulePath}`,
+            `Category: ${entry.category}`,
+            `Description: ${entry.description}`,
+            "Parameters:",
+            params,
+            `Returns: ${entry.returns}`,
+            "Example:",
+            "```ts",
+            entry.example.trim(),
+            "```",
+        ];
+        if (entry.notes) {
+            sections.push(`Notes: ${entry.notes}`);
+        }
+        return sections.join("\n");
+    })
+        .join("\n\n---\n\n");
+}
+function findCommonDirectorySegments(segmentsList) {
+    if (segmentsList.length === 0) {
+        return [];
+    }
+    const directories = segmentsList.map((parts) => parts.slice(0, Math.max(parts.length - 1, 0)));
+    let prefix = directories[0];
+    for (let i = 1; i < directories.length; i += 1) {
+        const current = directories[i];
+        let j = 0;
+        while (j < prefix.length &&
+            j < current.length &&
+            prefix[j] === current[j]) {
+            j += 1;
+        }
+        prefix = prefix.slice(0, j);
+        if (prefix.length === 0) {
+            break;
+        }
+    }
+    return prefix;
+}

package/dist/features/tools/types.js

@@ -1 +1,26 @@
-"use strict";
+import { z } from "zod";
+/**
+ * Shared Zod schemas for MCP tool formatting parameters.
+ * These stay on the TypeScript side only and are not sent to TouchDesigner.
+ */
+export const detailLevelSchema = z
+    .enum(["minimal", "summary", "detailed"])
+    .describe("Response detail level for tool output (minimal, summary, or detailed)");
+export const limitSchema = z
+    .number()
+    .int()
+    .min(1)
+    .max(500)
+    .describe("Maximum number of items to include in formatted output");
+export const presenterFormatSchema = z
+    .enum(["json", "yaml", "markdown"])
+    .describe("Structured output format for formatted responses");
+export const detailOnlyFormattingSchema = z.object({
+    detailLevel: detailLevelSchema.optional(),
+    responseFormat: presenterFormatSchema.optional(),
+});
+export const formattingOptionsSchema = z.object({
+    detailLevel: detailLevelSchema.optional(),
+    limit: limitSchema.optional(),
+    responseFormat: presenterFormatSchema.optional(),
+});

package/dist/gen/endpoints/TouchDesignerAPI.js

@@ -3,7 +3,7 @@
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
- * OpenAPI spec version: 1.1.1
+ * OpenAPI spec version: 1.1.2
  */
 import { customInstance } from '../../api/customInstance.js';
 // eslint-disable-next-line @typescript-eslint/no-redeclare

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

@@ -3,7 +3,7 @@
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
- * OpenAPI spec version: 1.1.1
+ * OpenAPI spec version: 1.1.2
  */
 import { z as zod } from 'zod';
 /**

package/dist/server/touchDesignerServer.js

@@ -18,7 +18,7 @@ export class TouchDesignerServer {
     constructor() {
         this.server = new McpServer({
             name: "TouchDesigner",
-            version: "1.1.1",
+            version: "1.1.2",
         }, {
             capabilities: {
                 prompts: {},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "touchdesigner-mcp-server",
-	"version": "1.1.1",
+	"version": "1.1.2",
 	"description": "MCP server for TouchDesigner",
 	"repository": {
 		"type": "git",
@@ -29,23 +29,24 @@
 		"@types/ws": "^8.18.1",
 		"@types/yargs": "^17.0.33",
 		"axios": "^1.12.2",
+		"mustache": "^4.2.0",
+		"yaml": "^2.8.1",
 		"zod": "3.25.76"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.2.4",
 		"@openapitools/openapi-generator-cli": "^2.23.1",
 		"@types/jsdom": "^21.1.7",
+		"@types/mustache": "^4.2.6",
 		"@types/node": "^24.4.0",
 		"@vitest/coverage-v8": "^3.2.4",
 		"archiver": "^7.0.1",
 		"msw": "^2.11.2",
-		"mustache": "^4.2.0",
 		"npm-run-all": "^4.1.5",
 		"orval": "^7.11.2",
 		"shx": "^0.4.0",
 		"typescript": "^5.9.2",
-		"vitest": "^3.2.4",
-		"yaml": "^2.8.1"
+		"vitest": "^3.2.4"
 	},
 	"type": "module",
 	"exports": {
@@ -61,7 +62,7 @@
 	"scripts": {
 		"build": "run-s build:*",
 		"build:gen": "npm run gen",
-		"build:dist": "tsc && shx chmod +x dist/*.js",
+		"build:dist": "tsc && shx chmod +x dist/*.js && shx cp -r src/features/tools/presenter/templates dist/features/tools/presenter/",
 		"build:dxt": "npx @anthropic-ai/dxt pack dxt/ touchdesigner-mcp.dxt",
 		"lint": "run-p lint:*",
 		"lint:biome": "biome check",