SSHOW

Apply an ordered list of project mutations — the `op` values (create_object, update_object, delete_object, create_scene, …, see the schema) are ops of this one tool, not tools. Commits as ONE undo step (the user can Cmd+Z it; you can call undo). Malformed actions are skipped and reported in `skipped` (index, op, id, reason); the valid ones in the same call still apply, and nothing applying is an error — `atomic:true` applies nothing if any action would be skipped, `dryRun:true` compiles and reports without committing. A create's config.id is an alias for THIS call — the engine assigns the real id and returns the mapping in `ids`; use those ids in later calls. The result also lists the scenes the call touched (`scenes`), the geometry of every object it touched (`objects`: bounds, offCanvas, textOverflow for fixed-size text on screen) and `warnings` (e.g. a fontFamily nobody has). Read get_guide('apply') first for the rules, then the sections for the config shapes you need.

apply_actions

Engine guide for authoring actions. Read topic 'apply' once before your first apply_actions — the protocol rules and action recipes (build each object fully in one create, set.style replaces, anchors, decks) — then fetch only the sections you need. Call with no topic for the outline: every section and subsection title; a topic matches any title (case-insensitive substring) and returns that section with its subsections, e.g. 'apply', 'text' (the text rules and F1–F17 formulas), 'style', 'motion', 'object types', 'deck' (a multi-slide recipe).

get_guide

Find objects by a substring of their name or text content — every scene (or one), nested children included — without paging get_scene. Up to 50 matches in scene order: id, sceneId, type, name, text.

find_objects

Fonts a text may name: the registerable catalog (family, languages, weights, hint) and the faces already registered in this project. A fontFamily outside both falls back to the system font — apply_actions warns when that happens.

get_fonts

Navigate the user's editor to a scene (keeps their screen in sync with your edits).

set_active_scene

Bring an image, video or audio file into the project as an asset and get the `asset://` src to put in create_object / update_object (data.src, image fills) — use it in your next apply_actions (an asset nothing references is garbage-collected). `url` is fetched by the user's editor in the browser: a data: URL always works; an https URL must allow cross-origin reads. Returns id, uri, type, mimeType, size.

import_asset

List the projects the user has open right now — each open editor is a target. Call this first to discover projectIds.

list_projects

Cheap first read of one project: canvas size, scene list (id/name/visible/object count/type histogram), active scene, current selection, the viewport (the canvas area on the user's screen), variables (id/name/type/value), registered fonts (family/weights/styles), document notes. Drill into a scene with get_scene.

get_project_overview

One scene: its own fields (name, description, notes, visible, style, data.clip, motion — what update_scene can set) and its object tree in compact form (engine defaults omitted, long text/path/src elided). Default = the active scene. Use get_object for one object's full detail.

get_scene

One object's full serialized detail (style/motion/data; long asset src elided), the sceneId it lives in and its bounds on the canvas (x/y/width/height, document coordinates).

get_object