List TouchDesigner nodes
get_td_nodesBrowse a TouchDesigner network one level at a time by listing the direct child nodes of a COMP, with pattern filtering and summary or full detail.
Instructions
Read-only: list the DIRECT child nodes of one COMP. Defaults to a compact summary (count + type breakdown + sample paths); pass detail_level:"full" or path_only:true for the complete list, and pattern to filter by name. Returns {count, by_type/sample or paths/nodes}. Use this to browse one level; use find_td_nodes to search recursively and by operator type, or get_td_topology when you also need the connections between nodes. Token economy: keep the default compact summary and scope with pattern; only request the full list when you truly need every path, and avoid re-listing a path you already inspected.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Cap the number of nodes returned. | |
| pattern | No | Case-insensitive filter on node name/path. Supports '*' wildcards (e.g. 'text*', '*noise*'). | |
| path_only | No | Return only the list of node paths, dropping type/name. | |
| parent_path | No | Parent COMP whose direct children should be listed. | /project1 |
| detail_level | No | 'summary' (default) returns a count, a type breakdown and the first few paths; 'full' returns every node. Use 'full' (or path_only) when you need the complete list. | summary |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | Summary mode: note that the list was sampled, with how to get all of it. | |
| count | Yes | Number of children matched (before any limit truncation). | |
| nodes | No | Full mode: every matched node as {path, name, type}. | |
| paths | No | path_only mode: the matched node paths and nothing else. | |
| sample | No | Summary mode: paths of the first few matched nodes. | |
| by_type | No | Summary mode: count of matched nodes per operator type. | |
| truncated | Yes | True if `limit` cut the list short of the full match count. | |
| parent_path | Yes | The parent COMP whose children were listed. | |
| detail_level | Yes | Which detail level produced this result, echoing the request. |