Hiero product, version, mode (Hiero / Nuke Studio), Python version and open projects.

All image formats Hiero knows about (name, width, height, pixel aspect).

Run Python inside Hiero's main thread for anything the other tools do not cover.

`hiero` is pre-imported (hiero.core, hiero.ui). Assign to a variable named `result`
to return a JSON-serialisable value; stdout, stderr and any traceback are returned too.

Open projects with path, unsaved-changes flag and counts of sequences and clips.

Project settings: frame rate, output format, OCIO, views, export root, undo/redo state, sequences.

Create a new empty project.

Open a .hrox project from disk.

Save a project, or save it to a new .hrox path ("save as") when path is given.

Close a project. Refuses if it has unsaved changes unless save is true.

Undo the last action in a project.

Redo the last undone action in a project.

Tree of bins, clips, sequences and tags under a bin ("" is the project root).

Create a bin, including any missing parent bins (e.g. "Footage/Day1").

Import files or folders (image sequences, movies) as clips into a bin, creating it if needed.

Clip details: media path, resolution, timecode, versions, tags and media metadata.

`clip` is a bin path ("Footage/A001"), a clip name or a GUID.

Rename a bin, clip or sequence by its bin path.

Move a bin, clip or sequence into another bin ("" is the project root).

Remove a bin, clip or sequence from the project (undoable).

Change a clip's active version: "up", "down", "max", "min" or a version index.

Reconnect offline media for a clip, or for every clip in a sequence, from a folder.

Sequences in one project (or all open projects) with duration, frame rate and format.

Sequence details and tracks; with include_items also every track item and soft effect.

Create a sequence in a bin. format is a name from list_formats; timecode_start is in frames.

Rename a sequence or change its frame rate, format, start timecode or in/out points.

Add a video or audio track to a sequence.

Rename, enable/disable, lock/unlock a track; set blend mode (video) or volume 0-1 (audio).

Remove a track and everything on it (undoable).

Shots on one track, or on every track of kind, with timeline and source ranges.

Full shot details: ranges, handles, speed, media, versions, linked items, tags, metadata.

Cut a clip into a track at timeline_in (default: after the last item). Overlapping items are overwritten.

Edit a shot: rename, enable, retime, move (move_to = new timeline in, keeps duration), trim, version, swap clip.

Trims keep playback speed: `timeline_in`/`timeline_out` and `source_in`/`source_out` trim the head or tail.
Source frames are relative to the start of the clip (0 = first frame of the media).

Remove shots from a track (undoable).

Cut every unlocked track (or one track) at a frame.

Add a soft effect (Nuke node class, e.g. "Grade", "Transform", "Text2") over a shot or a frame range.

`knobs` sets node knob values, e.g. {"white": 1.2}. Without item or range it covers the whole sequence.

Tags available to the project: its own Tags bin plus Hiero's preset tags (Status, Review, Shots...).

Tag a clip, sequence, track or shot. Reuses a project tag of the same name if it exists.

Target: `clip`; or `sequence` alone; or `sequence`+`track`; or `sequence`+`track`+`item`.

Remove a tag (by name or GUID) from a clip, sequence, track or shot.

What the artist has selected in the active timeline and in the project bin.

Select shots in the timeline. items: [{"track": 0, "item": "shot010", "kind": "video"}].

Open a sequence or clip in a timeline tab.

Show a sequence or clip in the viewer.

Current viewer frame and the sequence being viewed.

Move the viewer playhead to a frame.

Export (processor) presets available locally and in the project.

Export a sequence, or selected shots, with a named export preset (may overwrite files on disk).

track_items: [{"track": 0, "item": "shot010"}]. `export_root` overrides the preset's root for this run only.
Asynchronous by default; Hiero's export queue shows progress.