Plan a visual from a description
plan_visualRead-only
Generate a read-only TouchDesigner build plan from a visual description. Use deterministic planning by default, or opt into a bounded LLM plan with validated recipes and operators.
Instructions
Turn a visual description into a read-only build plan. The deterministic planner remains the default and creates nothing. Set planner='llm' to opt into one bounded completion grounded in compact editor/project/recipe/operator evidence; every suggested tool, recipe and operator is validated, and any unavailable or invalid LLM path falls back deterministically without mutating TouchDesigner.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| planner | No | Use the deterministic keyword planner (default), or explicitly request one bounded, grounded LLM completion with deterministic fallback. | deterministic |
| root_path | No | Optional TouchDesigner root used only for bounded read-only grounding in planner='llm'. | |
| description | Yes | Natural-language description of the visual you want. | |
| llm_timeout_ms | No | Bound the single LLM completion to 1000-10000 ms. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| steps | Yes | ||
| warnings | Yes | ||
| grounding | Yes | ||
| operators | Yes | ||
| recipe_id | Yes | ||
| planner_used | Yes | ||
| interpretation | Yes | ||
| schema_version | Yes | ||
| fallback_reason | Yes | ||
| recommended_tool | Yes | ||
| planner_requested | Yes |