execute_houdini_code
Run custom Python code in Houdini to handle operations beyond dedicated tool coverage, with tiered safety policies for controlled execution.
Instructions
Execute arbitrary Python code in Houdini's environment. LAST RESORT:
prefer the dedicated tools (connect_nodes, set_parameters, create_wrangle,
get_geometry_info, ...) — they validate input, report structured errors
and are undoable as a single step. Use this only for operations no
dedicated tool covers.
Args:
code: Python source to exec inside Houdini.
policy: "read-only" / "normal" / "privileged" (PR 4 safety policy).
allow_dangerous: explicit per-call dangerous-code override (privileged only).
allow_heavy_geometry: explicit per-call heavy-geometry override.
capture_diff: when True, server snapshots scene state before & after.
Returns status, any stdout/stderr, and an optional audit block.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| policy | No | normal | |
| capture_diff | No | ||
| allow_dangerous | No | ||
| allow_heavy_geometry | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |