houdini-geometry

houdini-geometry

Typed SOP creation and inspection tools for agents. All tools are affinity: main because they call hou. Prefer these over houdini-scripting.execute_python for seeding and querying geometry.

Tool groups

• geometry-create: create_primitive (box/sphere/grid/tube/curve/null/output) and create_curve_guides (bounded inline JSON or JSON-file polyline/NURBS guide topology).
• geometry-query (read-only except cook): get_geometry_info, list_attributes, get_attribute_values, get_primitive_intrinsics, get_primitive_topology, list_groups, get_cook_status.

get_attribute_values supports point, primitive, vertex (linear index), and detail classes. Use next_offset to page through at most 128 elements per call. Each value is bounded to 64 items and 1024 serialized characters and reports truncation. get_primitive_intrinsics reads up to 32 named properties, including packed transforms and bounds. These calls may trigger the SOP's normal cook to obtain geometry, but never change geometry or write files.

get_primitive_topology reads up to 32 primitives and 128 ordered point references per primitive. next_offset pages primitives; vertices_truncated marks incomplete vertex lists. Closure is null for primitive types without a closure query. This is an inspection primitive, not a manifoldness or full-mesh validation result.

Tracer-bullet flow

1. create_primitive(parent_path="/obj/geo1", primitive="box")
2. get_geometry_info → counts and bounds
3. edit with houdini-mesh-ops (transform/merge/blast/group/normal/convert)
4. get_cook_status → verify no cook errors

get_cook_status is async with a timeout hint because heavy SOP graphs can cook slowly.

For guide authoring, pass exactly one of guides or input_file. Each guide declares root-to-tip cvs, guide_id, and cluster_id; optional per-CV widths/colors and cluster_name become typed Houdini attributes. The tool validates the whole bounded payload before creating a Stash SOP and returns the source SHA-256 (for files), enforced limits, counts, bounds, schema, and any rejected-guide diagnostics. It never evaluates Python or VEX from the payload.