Check that Cavalry is running and the bridge is reachable. Returns bridge and Cavalry versions.

Describe the open scene: file path, unsaved state, current frame, compositions, and the active composition's resolution / frame range / fps when available. Call this first to orient yourself.

Move the playhead of the active composition to a frame.

Start or stop playback in the viewport.

List layers in the active composition with their id, name, type and parent.

Return the layers currently selected in Cavalry, in hierarchy order.

Replace the current selection with the given layers.

Create a primitive shape layer (e.g. "rectangle", "ellipse", "star", "polygon") and optionally set attributes in the same call, e.g. {"generator.dimensions": [400, 200], "position": [0, 0], "material.materialColor": "#00c2ff"}.

Create a layer of any Cavalry type (e.g. "null", "group", "textShape", "duplicator", "colorMaterial", "javaScript") and optionally set attributes in the same call.

Duplicate a layer. Returns the ids of the newly created layers.

Change a layer's display name.

Parent a layer under another layer (e.g. a group), or pass parentId null to un-parent it.

Delete one or more layers. Ids that do not exist are reported back instead of failing.

List every attribute path available on a layer, optionally with data types.

Read the current values of one or more attributes on a layer.

Set one or more attribute values on a layer at the current frame (does not create keyframes). Every path is checked first, because Cavalry silently ignores writes to unknown paths. In 2D, rotate with "rotation.z".

Return a layer's bounding box (x, y, width, height, centre, left/right/top/bottom). Use it to lay out, align and check that layers fit inside the composition.

List a layer's incoming and outgoing attribute connections, to understand an existing node graph.

Add a dynamic attribute to layers that support them (e.g. JavaScript layers). Returns the new array count; use cavalry_list_attributes to find the new attribute path.

Swap the generator on a layer, e.g. set a Duplicator's "generator" to "circleDistribution" or a Basic Shape's to "ellipse".

Set (or clear, with an empty string) a JavaScript expression on an attribute.

Connect an output to an input. A layer's main output is its "id" attribute, e.g. connect shape "id" -> duplicator "shapes", or colorMaterial "id" -> shape "material" with force=true.

Remove a connection between two attributes.

Create keyframes on a layer. Each keyframe sets one or more attribute values at a frame and can apply a Magic Easing to the keyframes it creates. Example: [{"frame": 0, "values": {"position.x": -300}, "easing": "SlowOut"}, {"frame": 30, "values": {"position.x": 300}}].

Delete keyframes on an attribute at specific frames, or all of its animation when frames is omitted.

Render the active composition to a PNG file on the local machine (useful for checking your work visually). Use an absolute path; the .png extension is added automatically.

Save the scene in place, or to a new .cv path when filePath is given.

Open a .cv scene file. Unless force is true, Cavalry may ask the user about unsaved changes in the current scene.

Run several operations in one round-trip, in order. Stops at the first failure; earlier operations are NOT rolled back. Each item is {"op": "", "args": {...}} where op is the tool name without the "cavalry_" prefix. Reference earlier results with "$" strings: "$0" is the id created by operation 0, "$2.created.0.id" walks into a result. Example: [{"op": "create_primitive", "args": {"shape": "ellipse"}}, {"op": "set_keyframes", "args": {"layerId": "$0", "keyframes": [...]}}].