@dpantani/tdmcp 0.4.0 → 0.6.1

package/README.md

@@ -2,7 +2,11 @@
 
 [![CI](https://github.com/Pantani/tdmcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Pantani/tdmcp/actions/workflows/ci.yml)
 [![Docs](https://github.com/Pantani/tdmcp/actions/workflows/docs.yml/badge.svg)](https://pantani.github.io/tdmcp/)
+[![npm version](https://img.shields.io/npm/v/@dpantani/tdmcp?logo=npm&color=cb3837)](https://www.npmjs.com/package/@dpantani/tdmcp)
+[![Node.js](https://img.shields.io/node/v/@dpantani/tdmcp?logo=nodedotjs&color=339933)](https://nodejs.org)
+[![MCP server](https://img.shields.io/badge/MCP-server-000?logo=modelcontextprotocol&logoColor=white)](https://modelcontextprotocol.io)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![tdmcp MCP server](https://glama.ai/mcp/servers/Pantani/tdmcp/badges/score.svg)](https://glama.ai/mcp/servers/Pantani/tdmcp)
 
 **tdmcp is a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server
 for [TouchDesigner](https://derivative.ca)** — build TouchDesigner from plain
@@ -34,9 +38,10 @@ Full guides and reference live on the **docs site → <https://pantani.github.io
 | [What is tdmcp?](https://pantani.github.io/tdmcp/guide/what-is-tdmcp) | [Architecture](https://pantani.github.io/tdmcp/reference/architecture) |
 | [Install (no terminal)](https://pantani.github.io/tdmcp/guide/install) | [Tools reference](https://pantani.github.io/tdmcp/reference/tools) |
 | [Your first visual](https://pantani.github.io/tdmcp/guide/first-visual) | [Environment variables](https://pantani.github.io/tdmcp/reference/environment) |
-| [Prompt cookbook](https://pantani.github.io/tdmcp/guide/prompt-cookbook) | [CLI & local copilot](https://pantani.github.io/tdmcp/reference/cli) |
-| [Recipe gallery](https://pantani.github.io/tdmcp/guide/recipes) | [Bridge & REST API](https://pantani.github.io/tdmcp/reference/bridge-api) |
-| [Troubleshooting](https://pantani.github.io/tdmcp/guide/troubleshooting) | [Roadmap](docs/ROADMAP.md) · [Deployment](docs/DEPLOYMENT.md) |
+| [Shader Park](https://pantani.github.io/tdmcp/guide/shader-park) | [CLI & local copilot](https://pantani.github.io/tdmcp/reference/cli) |
+| [Prompt cookbook](https://pantani.github.io/tdmcp/guide/prompt-cookbook) | [Bridge & REST API](https://pantani.github.io/tdmcp/reference/bridge-api) |
+| [Recipe gallery](https://pantani.github.io/tdmcp/guide/recipes) | [Roadmap](docs/ROADMAP.md) |
+| [Troubleshooting](https://pantani.github.io/tdmcp/guide/troubleshooting) | [Deployment](docs/DEPLOYMENT.md) |
 
 🇧🇷 **Documentação em português:** <https://pantani.github.io/tdmcp/pt/>
 
@@ -66,7 +71,7 @@ Three pieces talk to each other on your computer:
 
 Node.js is only needed for the build-from-source path (**[Node 20+](https://nodejs.org)**).
 The one-click Claude Desktop extension needs nothing extra — the server is bundled
-inside the `.dxt`.
+inside the `.mcpb` (formerly `.dxt`; legacy `.dxt` files still install).
 
 ## Get started
 
@@ -77,16 +82,16 @@ You set up **two sides**: your **AI** (so it gets the tdmcp tools) and
 **Cursor**? Paste this one message in:
 
 ```text
-Install and connect tdmcp for me by reading and following
-https://raw.githubusercontent.com/Pantani/tdmcp/main/tdmcp-install-prompt.md
+Install and connect tdmcp for me using the official install guide:
+https://pantani.github.io/tdmcp/guide/install
 Do every step yourself; only stop when you need me to paste one line into TouchDesigner.
 ```
 
 It clones, builds and wires everything up; the only manual step is pasting one
 line into TouchDesigner (Step 2 below).
 
-**🟢 Claude Desktop — one-click `.dxt` (no terminal, no Node).** Download
-**[tdmcp.dxt](https://github.com/Pantani/tdmcp/releases/latest/download/tdmcp.dxt)**,
+**🟢 Claude Desktop — one-click `.mcpb` (no terminal, no Node).** Download
+**[tdmcp.mcpb](https://github.com/Pantani/tdmcp/releases/latest/download/tdmcp.mcpb)**,
 then in Claude Desktop open **Settings → Extensions** and install it (drag it in or
 **Install from file**). Leave host/port at `127.0.0.1` / `9980`. Full walkthrough:
 [the install guide](https://pantani.github.io/tdmcp/guide/install).
@@ -105,7 +110,7 @@ Open TouchDesigner, open the **Textport** (`Dialogs → Textport and DATs`), pas
 this **one line** and press Enter:
 
 ```python
-import urllib.request; exec(urllib.request.urlopen("https://raw.githubusercontent.com/Pantani/tdmcp/main/td/bootstrap.py").read().decode())
+import urllib.request; exec(urllib.request.urlopen("https://github.com/Pantani/tdmcp/raw/main/td/bootstrap.py").read().decode())
 ```
 
 You should see `[tdmcp] bridge running on port 9980 (/project1/tdmcp_bridge)`. ✅
@@ -131,7 +136,7 @@ the [prompt cookbook](https://pantani.github.io/tdmcp/guide/prompt-cookbook).
 
 ## What you can do
 
-**102+ tools** across three layers, plus an Obsidian vault integration — from
+**179 tools** across three layers, plus library/packaging and Obsidian vault integrations — from
 one-line artist generators (`create_feedback_network`, `create_audio_reactive`,
 `create_particle_system`, `create_generative_art`, …) to building blocks
 (`create_control_panel`, `animate_parameter`, `create_external_io` for

package/dist/cli/agent.d.ts

@@ -278,9 +278,9 @@ declare const RecipeSchema: z.ZodObject<{
         node: z.ZodString;
         name: z.ZodString;
         kind: z.ZodDefault<z.ZodEnum<{
+            color: "color";
             float: "float";
             vec: "vec";
-            color: "color";
         }>>;
         value: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
         label: z.ZodOptional<z.ZodString>;
@@ -441,6 +441,26 @@ declare class TouchDesignerClient {
         outputs?: string[] | undefined;
         family?: string | undefined;
         errors?: string[] | undefined;
+        flags?: {
+            bypass?: boolean | undefined;
+            render?: boolean | undefined;
+            display?: boolean | undefined;
+            lock?: boolean | undefined;
+            allowCooking?: boolean | undefined;
+            cloneImmune?: boolean | undefined;
+            is_clone?: boolean | undefined;
+            clone?: string | null | undefined;
+        } | undefined;
+        wires_in?: {
+            in_index: number | null;
+            from: string;
+            out_index: number;
+        }[] | undefined;
+        nodeX?: number | undefined;
+        nodeY?: number | undefined;
+        comment?: string | undefined;
+        color?: number[] | undefined;
+        tags?: string[] | undefined;
     }>;
     updateNodeParameters(path: string, parameters: Record<string, unknown>): Promise<{
         path: string;
@@ -452,6 +472,26 @@ declare class TouchDesignerClient {
         outputs?: string[] | undefined;
         family?: string | undefined;
         errors?: string[] | undefined;
+        flags?: {
+            bypass?: boolean | undefined;
+            render?: boolean | undefined;
+            display?: boolean | undefined;
+            lock?: boolean | undefined;
+            allowCooking?: boolean | undefined;
+            cloneImmune?: boolean | undefined;
+            is_clone?: boolean | undefined;
+            clone?: string | null | undefined;
+        } | undefined;
+        wires_in?: {
+            in_index: number | null;
+            from: string;
+            out_index: number;
+        }[] | undefined;
+        nodeX?: number | undefined;
+        nodeY?: number | undefined;
+        comment?: string | undefined;
+        color?: number[] | undefined;
+        tags?: string[] | undefined;
     }>;
     executePythonScript(script: string, returnOutput?: boolean): Promise<{
         result?: unknown;
@@ -514,6 +554,71 @@ declare class TouchDesignerClient {
         total_cook_time_ms?: number | undefined;
         gpu_memory_mb?: number | undefined;
     }>;
+    connectNodes(sourcePath: string, targetPath: string, sourceOutput?: number, targetInput?: number): Promise<{
+        source_path: string;
+        target_path: string;
+        source_output: number;
+        connected: boolean;
+        requested_input?: number | undefined;
+        actual_input?: number | undefined;
+    }>;
+    disconnectNodes(toPath: string, fromPath?: string, toInput?: number): Promise<{
+        to_path: string;
+        removed: {
+            input: number;
+            from: string;
+        }[];
+        warnings: string[];
+        from_path?: string | null | undefined;
+        to_input?: number | null | undefined;
+    }>;
+    readParameterModes(path: string, keys?: string[], nonDefaultOnly?: boolean): Promise<{
+        path: string;
+        type: string;
+        name: string;
+        parameters: {
+            name: string;
+            mode: string;
+            value?: unknown;
+            expr?: string | undefined;
+            bind_expr?: string | undefined;
+            export_op?: string | undefined;
+        }[];
+        warnings: string[];
+    }>;
+    setParameterMode(path: string, param: string, mode: string, expr?: string, value?: unknown): Promise<{
+        path: string;
+        param: string;
+        mode: string;
+        readback_mode: string;
+        readback_expr: string;
+    }>;
+    getDatText(path: string): Promise<{
+        path: string;
+        text: string;
+        is_table: boolean;
+        num_rows: number;
+        num_cols: number;
+    }>;
+    putDatText(path: string, text: string): Promise<{
+        path: string;
+        old_length: number;
+        new_length: number;
+    }>;
+    getLogs(severity?: string, maxLines?: number, scope?: string): Promise<{
+        lines: {
+            source: string;
+            message: string;
+            severity: string;
+            type: string;
+            absframe?: number | undefined;
+            frame?: number | undefined;
+        }[];
+        count: number;
+        available: boolean;
+        warnings: string[];
+        error_dat?: string | undefined;
+    }>;
 }
 
 /** Shared dependencies injected into every tool handler (keeps handlers testable). */
@@ -529,6 +634,11 @@ interface ToolContext {
      * allowed (the default); only an explicit `false` locks them out.
      */
     allowRawPython?: boolean;
+    /**
+     * Tool exposure profile. `"safe"` hides destructive/raw-code tools.
+     * Undefined means `"full"` (the default).
+     */
+    toolProfile?: "full" | "safe";
 }
 
 declare const ConfigSchema: z.ZodObject<{
@@ -555,6 +665,10 @@ declare const ConfigSchema: z.ZodObject<{
         on: "on";
         off: "off";
     }>>;
+    toolProfile: z.ZodDefault<z.ZodEnum<{
+        full: "full";
+        safe: "safe";
+    }>>;
     bridgeToken: z.ZodOptional<z.ZodString>;
     llmBaseUrl: z.ZodDefault<z.ZodString>;
     llmModel: z.ZodDefault<z.ZodString>;
@@ -577,6 +691,10 @@ declare function runCli(argv: string[], opts?: RunCliOptions): Promise<CliResult
 interface RunWatchOptions {
     config?: TdmcpConfig;
     includeHighFrequency?: boolean;
+    /** Only emit events whose `type` is in this list (e.g. ["beat","onset"]). */
+    filter?: string[];
+    /** Drop events whose `type` is in this list (e.g. ["timeline.frame"]). */
+    exclude?: string[];
     /** Where each event line goes; defaults to stdout. Overridable for tests. */
     write?: (line: string) => void;
     /** Inject a stream factory for tests; defaults to a real `TdEventStream`. */