discover_toolsread-only
Discover full TypeScript signatures for additional sandbox APIs before using them inside execute_typescript. Discoverable tools: [external_read_scene, external_apply_keyframes, external_apply_motion_preset…
toolNames: array
execute_typescriptuntrusted content
Execute TypeScript in an isolated QuickJS sandbox to edit Creator. First use discover_tools for typed external_<tool_name> functions. Await every external_* call; calls are serialized. Return a JSON-serializable…
typescriptCode: string
list_fontsread-onlyuntrusted content
List font families available in the active project — Creator's curated presets, Google Fonts, OS-installed local fonts (when permission has been granted), and project-uploaded font assets. Use this when the user names…
source: string?
list_inputsread-onlyuntrusted content
List the typed inputs (variables) on the active state machine. Inputs are how state machines store runtime values — booleans for toggle state, numerics for progress / counters, strings for labels, and events for…
list_interactionsread-onlyuntrusted content
List the interactions defined on the active state machine. Interactions BIND runtime pointer / state events to actions — usually a `Fire` action that emits a named event a transition listens for.
**Without an…
list_layer_effectsread-onlyuntrusted content
Return the effects currently attached to a layer, with their ids, types, and enabled state. Call this before stacking another effect, before removing one, or whenever you need to know what's already there.
layer_id: string
list_motion_system_itemsread-onlyuntrusted content
Read the user's Motion System library — a separate design library from the file's theme slots. Returns colors / gradients / fonts / easings / durations / motion presets that the user has saved (typically synced from…
type: string?
list_scenesread-onlyuntrusted content
List every scene in the current project plus which one is active. Cheap read. Use when the user refers to scenes by name ('switch to the outro', 'work on the vertical') so you can find the right `scene_id`, or when…
list_segmentsread-onlyuntrusted content
List the named animation segments (markers) on the active scene. Each segment is a name + a frame range (start_frame, end_frame). Segments are used by Lottie players to loop / play named ranges and by dotLottie state…
list_slotsread-onlyuntrusted content
List design-token slots defined in the file. Each slot has ONE stable id (e.g. 'brand-red') but can supply different VALUES per theme — Default theme might have brand-red as crimson, a Dark theme might have it as…
type: string?, theme_id: string?
list_state_machinesread-onlyuntrusted content
List the interactivity state machines defined in this file. Each one is `{ id, name, state_count, transition_count, is_active }`. Returns the active state machine id separately as `active_state_machine_id`. State…
list_statesread-onlyuntrusted content
List the states in the active state machine. Each is `{ id, name, type, segment, autoplay, loop, mode, is_initial, transitions: [{ id, to_state_id, trigger?, type }] }`. Returns `state_machine_id` and…
list_themesread-onlyuntrusted content
List the themes embedded in this file. Themes group design-token slots (brand colors, named text strings, etc.). The Default theme is always present; users can add named alternates (e.g. 'Dark', 'Holiday'). Returns `{…
measure_text_unitsread-onlyuntrusted content
Return per-line, per-word, and per-character bounds for an existing text layer. Uses the same canvas.measureText pipeline that powers `read_scene`'s `measured_bounds`, but exposes the cumulative pen position per glyph…
layer_id: string, granularity: string?
read_keyframesread-onlyuntrusted content
Read the current keyframes on a layer's keyframe-tool properties. Use this whenever the user asks to TUNE, POLISH, or MODIFY an existing animation ('make the bounce snappier', 'slow down the fade', 'shift this 10…
layer_id: string, property: string?
read_sceneread-onlyuntrusted content
Read the current Creator scene. Returns scene dimensions, framerate, duration, all layers, current selection, render order, visual bounds, scene-center deltas, and clipping/off-canvas flags. Call this once at the…