Propose Host-Authored TD Brain Draft
td_brain_proposeRead-only
Validate a draft candidate graph into an executable BrainPlan. Accepts drafts matching the authoring contract and returns ready-to-run plans or machine-readable rejections for fixes.
Instructions
Use this when you have authored a draft candidate graph from a td_brain_ground grounding pack and need TDPilot to validate it into an executable BrainPlan. It is read-only and never mutates TouchDesigner: accepted drafts are compiled, gated by parameter semantics, and cached server-side so td_brain_execute(plan_id=...) can run them immediately; rejected drafts return machine-readable rejections to fix and retry.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft | Yes | Host-authored draft candidate graph matching the td_brain_ground authoring_contract draft_schema (label, concepts, edges, required_ops, ...). | |
| intent | No | Original natural-language intent behind the draft. Defaults to the draft label so the same intent used for td_brain_ground can be carried through. | |
| target_root | No | Absolute TD parent/root path the plan will build inside. | /project1 |
| detail_level | No | Response detail: 'full' (compatibility default) or 'summary'. | full |
| grounding_id | No | Optional grounding_id from td_brain_ground; binds review to the original task facets. | |
| validation_profile | No | Validation profile. 'auto' resolves to structural_visual_safe. | auto |
| draft_schema_version | No | Draft contract version: '2' (default) or legacy '1'. | 2 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||