Get operator runtime state
get_node_state_runtimeInspect runtime telemetry for a single TouchDesigner operator, including cook time, count, resolution, GPU memory, and errors, to diagnose per-node performance issues.
Instructions
Read-only: inspect a single operator's runtime telemetry — cook time, cook count, last-cook frame, resolution (TOPs), channel/sample counts (CHOPs), GPU memory usage, and cook errors. Complements get_td_performance (which aggregates cook times across a network) by providing deep per-op detail for the 'why is it black / why is it slow' diagnostic loop. Returns {path, type, family, cook_time_ms, cook_count, last_cook_frame, resolution, num_chans, num_samples, gpu_memory, errors[], warnings[], extra}. Attribute names are flagged UNVERIFIED and vary by TD build; the extra map records which attrs were actually present for live confirmation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Full path of the operator to inspect (e.g. '/project1/noise1'). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Echoed operator path. | |
| type | Yes | Operator type string (e.g. 'noiseTOP'). | |
| family | No | Operator family: TOP, CHOP, SOP, DAT, COMP, MAT, etc. | |
| cook_time_ms | No | Last cook duration in milliseconds (op.cookTime * 1000). UNVERIFIED attr name. | |
| cook_count | No | Total number of times the op has cooked (op.totalCooks / op.cookCount). UNVERIFIED. | |
| last_cook_frame | No | Absolute frame number of the last cook (op.cookAbsFrame). UNVERIFIED attr name. | |
| resolution | No | [width, height] for TOPs (op.width, op.height). UNVERIFIED. | |
| num_chans | No | Number of channels for CHOPs (op.numChans). UNVERIFIED. | |
| num_samples | No | Number of samples per channel for CHOPs (op.numSamples). UNVERIFIED. | |
| gpu_memory | No | GPU memory used in bytes for TOPs (op.gpuMemory). UNVERIFIED attr name. | |
| errors | Yes | Cook errors from op.errors(recurse=False). | |
| warnings | Yes | Bridge-level warnings about unreadable attributes. | |
| extra | No | Additional Info attributes found via getattr probing — allows live-validation to confirm real attr names. |