A rendering engine an agent can read the whole of.

What ShellX Motion is

A local-first motion-graphics and video rendering engine built to be driven by an AI agent. Every capability is a typed, discoverable command with a declared permission tier and a receipt. There is no cloud service, no account and no upload.

1. Motion runs on your hardware; project files stay on the machine.
2. The same typed contracts serve the CLI, the local Workbench, connected agents, ShellX Cut and Design Studio.
3. A Motion project is a package: a folder holding motion.json, manifest.json, assets/, data/ and receipts/.

NoteHosted or SaaS execution is not part of the current product. The server binds loopback only.

It ships as a source release

You get the repository tree, build it, and run it from there. There is no npm install step and no prebuilt binary for 0.1.0.

1. Clone or download the repository.
2. Run pnpm install at the repository root.
3. Run pnpm build.

Notepnpm install must run esbuild's postinstall script. The repository declares that in pnpm-workspace.yaml; an ERR_PNPM_IGNORED_BUILDS error means your pnpm is not reading the declaration.

Start Motion (the normal entry point)

pnpm start creates one private per-user access key, starts Motion with local create/edit/render access, publishes the live loopback port for agent bridges, and opens an already-unlocked Workbench in your browser.

1. Run pnpm start from the repository root.
2. The Workbench opens already authenticated; the first tab receives the key through a one-use launch exchange.
3. Open the Workbench Connections page to add Motion to an agent, or to copy the MCP command for another client.

NoteStart Motion grants write_local and does not enable remote publishing.

The two CLI invocation forms

Which form is correct depends only on where you are. In this source checkout every command takes the pnpm --filter @shellx-motion/cli run cli -- prefix. From an installed build of the packed @shellx-motion/cli package the same command is shellx-motion <command>.

1. Source checkout: pnpm --filter @shellx-motion/cli run cli -- doctor
2. Installed build: shellx-motion doctor
3. Nothing puts shellx-motion on your PATH inside the workspace, and running packages/cli/dist/main.js directly fails as well.

NoteThere is no motion binary in either form. Dotted names such as motion.render.final are Debug API / MCP command ids, not shell commands.

Verify the install

Two commands prove the toolchain is sound: doctor prints per-operation readiness, and validate on the bundled fixture should answer "ok": true.

1. pnpm --filter @shellx-motion/cli run cli -- doctor
2. pnpm --filter @shellx-motion/cli run cli -- validate fixtures/packages/lower-third
3. A true answer from validate means the engine can read a package.

Notevalidate writes no receipt. It returns identity, layer count, hosts and lanes in the JSON envelope and creates no receipts/ directory.

Verify the installed (packed) form

pnpm run build:verify is the only check that exercises what an npm consumer would actually receive. It packs every package, installs the CLI tarball into a throwaway project, and runs shellx-motion there through both the npm and pnpm bin shims.

1. Run pnpm run build:verify from the repository root.
2. It covers publishConfig exports, the bin shebang, the files allowlist and workspace:* version rewriting.

NoteThis cannot be exercised from inside the workspace, because the workspace exports deliberately point at TypeScript source.

Discover before you mutate

Action discovery answers "what can I do about this?" with a callable plan, so an agent never has to guess a command or a mutation sequence.

1. actions find "add a cinematic snow environment" returns a matching action id.
2. actions guide motion.timeline.layer.rich.set returns the workflow for one action.
3. actions plan "change snow intensity and preview it" returns each planned step with its arguments, required set and allowed values.

Node.js >=24.0.0

The engine declares engines.node = >=24.0.0 and CI runs Node 24. The README records the tested runtimes as 24.14 on Linux and 24.15 on Windows.

pnpm >=10.6.0

The engine declares engines.pnpm = >=10.6.0. Below 10.6 the workspace build-script declaration is not read, so esbuild's postinstall is skipped and the TypeScript runner has no platform binary.

Notepnpm 11.x is compatible.

The reproducible pnpm identity is [email protected]

packageManager names what the lockfile and every green gate were actually produced with, as opposed to what engines.pnpm merely permits. CI does not repeat the number — pnpm/action-setup reads this field.

Notepnpm-lock.yaml is lockfileVersion 9.0. Use pnpm install --frozen-lockfile to resolve the same tree.

FFmpeg — required for video render

FFmpeg encodes final media: MP4, WebM, GIF, stills and image sequences. It does not ship with Motion. The README records testing on 6.1.1 and 8.1.2.

1. Motion resolves ffmpeg from PATH by default.
2. Point at an explicit executable with the SHELLX_MOTION_FFMPEG environment variable.
3. Validation, inspection and still previews work without it.

NoteMotion invokes FFmpeg with shell:false through argument arrays and validates input/output roots and preset extensions.

FFprobe — required for quality-check

FFprobe reads encoded media back for quality checks and media evidence. Encoding works without it; quality-check does not.

1. Motion resolves ffprobe from PATH by default.
2. Point at an explicit executable with the SHELLX_MOTION_FFPROBE environment variable.

Chrome or Chromium — the default frame lane

render rasterizes frames in a real browser by default (render --frame-lane browser), and preview --lane browser does the same. Any current Chrome or Chromium build works; npx playwright-core install chromium gets one.

1. Motion resolves a browser from PATH by default.
2. Pin an explicit binary with the SHELLX_MOTION_BROWSER environment variable.
3. preview defaults to --lane native and needs no browser.

Noteplaywright-core ships no browser of its own. An explicit SHELLX_MOTION_BROWSER pin that names a missing path fails closed rather than silently falling back.

Rendering without a browser: the native frame lane

render --frame-lane native encodes from natively drawn frames instead of browser frames. The lane is narrow on purpose: it has no font rasterizer, so it refuses to deliver any package whose text is lowercase or names a font family.

NoteSuited to text-free packages, not a general substitute for the browser lane.

doctor reports what this machine can actually do

One call answers it: motion.platform.requirements, or doctor on the CLI. It reports per-tool readiness and distinguishes "cannot do this at all" from "cannot do it the default way, and here is the flag".

1. Read satisfied as "runs the way you are about to invoke it".
2. Read possible as "runs at all".
3. When the two differ, alternative names the flag that would work.

NoteThe Workbench About page, the render dialog, the CLI and any MCP client all read the same answer — this is the readiness-parity invariant.

Ports, loopback and the access key

The debug, SDK and MCP server binds 127.0.0.1 only; direct non-loopback binding is disabled. Everything except GET /health and the static Workbench shell requires a capability token.

1. HTTP callers send Authorization: Bearer <token>; WebSocket callers use the authenticated subprotocol.
2. Start Motion creates one private per-user key, reuses it across restarts, and stores it outside project directories with user-only permissions.
3. An advanced direct launch stores an ephemeral key file instead, or reads SHELLX_MOTION_DEBUG_TOKEN.
4. The startup manifest prints url, workbenchUrl, the granted tier, the transports and auth.tokenFile.

NoteNever place the key in project files, shell history, logs or URLs. The server also rejects forged Host and unapproved Origin values and bounds request and WebSocket size and concurrency.

Transports an agent can use

The same command contracts are reachable over four transports plus the CLI.

1. POST /debug — native {command, args, requestedTier?} dispatch.
2. POST /rpc — JSON-RPC discovery and MCP tool dispatch.
3. WS /ws — authenticated persistent JSON-RPC.
4. POST /sdk — typed local SDK operation dispatch for trusted hosts.
5. GET /debug/contracts — the authenticated command/domain/tier/mutation registry.

NoteMCP supports two protocol eras: modern 2026-07-28 clients call server/discover without initialize; legacy 2025-06-18 clients keep initialize/list/call. Both enforce the same server grant.

Native file pickers per platform

The Workbench Browse buttons open the operating system's own chooser through the server, because a browser page cannot hand a real filesystem path to a local engine.

1. Windows and macOS use the operating-system picker (macOS through osascript).
2. Linux uses zenity, and falls back to kdialog.
3. If neither is installed, Motion reports that no supported Linux file chooser is available.

NoteNative pickers need a desktop session. A headless server has no picker.

The per-job memory ceiling

A browser render reuses one Chromium session for the whole sequence, so peak resident memory grows with frame count, and effects.motionBlur.samples multiplies it. The governor aborts a job at a 6 GiB default ceiling with job_rss_limit_exceeded.

1. Measured: 450 frames at 1080p30 with two environment layers and 3-sample blur peaked at 5.07 GiB of 6.
2. The ceiling is configurable through SHELLX_MOTION_MAX_JOB_RSS_BYTES.
3. Budget the piece before authoring it.

NoteThrough the CLI this is a non-zero exit and a stack trace, not a JSON error envelope.

The update channel

The standalone CLI checks the configured GitHub release channel at startup and every 30 minutes. The About page reads that cached result, Check now refreshes it, and MCP/JSON-RPC discovery reports the same checkedAt, latestVersion and updateAvailable fields to agents.

1. The check sends only the release-feed request: no project content, prompts, receipts, usage data or telemetry.
2. A host can disable or override the channel; a disabled channel returns an explicit "not configured" state.
3. A network or parse failure returns an honest error, never a fabricated "up to date".

NoteApplying an update reports the truthful install state. A source checkout is updated through git; there is no signed in-place binary channel yet, so the server will not download and run unverified release bytes.

Claiming a platform requires running the ladder on it

Motion publishes a reusable platform-verification ladder. A source build, or a result from another host, is not substitute evidence for a platform claim.

1. Run the required command list on every operating system and architecture the release will claim.
2. The runner records host identity, command plan, outcomes and artifact paths in one receipt.
3. pnpm run platform:verify drives it.

The six permission tiers, in order

read_motion < draft_motion < render_motion < edit_motion < write_local < push_remote. The tier the server is launched with is a ceiling: a request may ask for a lower or equal tier, never a higher one, and package data or prompts cannot elevate themselves.

NoteThe per-command tier is contract data, not prose. schemas/debug.json carries the permission of every command.

write_local ranks ABOVE edit_motion

The intuitive reading is the wrong one and it costs a session. edit_motion mutates a package that already exists. write_local creates files outside an existing package — so making a NEW package needs write_local.

1. motion.package.create needs write_local, together with every importer, exporter, connector and archive command.
2. Starting the server at --tier edit_motion and then calling motion.package.create is refused, correctly.
3. Start at --tier write_local if the agent has to create packages.

Anything above read_motion needs --trusted-local-tier

read_motion is the default for a direct server launch. Raising the grant is deliberate: the launch must also pass --trusted-local-tier, so a higher grant is never something a caller can drift into.

1. pnpm --filter @shellx-motion/debug-server run serve -- --tier render_motion --trusted-local-tier
2. The startup manifest prints the tier it actually granted.
3. pnpm start is the normal human path and grants write_local with this flag already applied.

push_remote is reserved and never automatic

It is the top tier and it exists so a future hosted or repository-handoff surface can refuse it explicitly without inventing a new gate. The server requires a separate --allow-push-remote opt-in on top of a push_remote grant.

1. Motion never infers permission for remote publish or hosted rendering.
2. Today a request that would push remote is refused by design.
3. No shipped command declares push_remote: all 169 carry a lower tier.

NoteMotion keeps all execution local.

Tier 1 of 6: read_motion

Read-only. The default grant for a direct server launch, and the only tier that needs no --trusted-local-tier. 54 of the 169 shipped Debug API commands declare read_motion as their required tier.

1. Example commands: motion.state, motion.open, motion.select, motion.highlight.

Tier 2 of 6: draft_motion

Draft-level agent work: queueing, cancelling and retrying prompt jobs. 6 of the 169 shipped Debug API commands declare draft_motion as their required tier.

1. Example commands: motion.prompt.cancel, motion.prompt.retry, motion.prompt.run, motion.timeline.playhead.set.

Tier 3 of 6: render_motion

Producing evidence: preview frames, final media, quality checks and batch renders. 11 of the 169 shipped Debug API commands declare render_motion as their required tier.

1. Example commands: motion.preview.frame, motion.preview.playhead, motion.preview.strip, motion.render.final.

Tier 4 of 6: edit_motion

Mutating a package that already exists — layers, keyframes, curves, tracks, captions. 75 of the 169 shipped Debug API commands declare edit_motion as their required tier.

1. Example commands: motion.analysis.tracking.apply, motion.analysis.tracking.detach, motion.keying.apply, motion.keying.remove.

Tier 5 of 6: write_local

Creating files outside an existing package: motion.package.create, every importer, exporter, connector and archive command. 23 of the 169 shipped Debug API commands declare write_local as their required tier.

1. Example commands: motion.package.create, motion.agent.revision.plan, motion.script.compile, motion.analysis.tracking.request.

Tier 6 of 6: push_remote

Reserved. Requires a separate --allow-push-remote opt-in and is never inferred. 0 of the 169 shipped Debug API commands declare push_remote as their required tier.

Engine Room: five pages, one engine

Motion is not headless. Its debug server serves a local browser UI over the same Debug API contracts the agents use — Inspector, History, Connections, Docs and About — reached from one persistent navigation strip.

1. /workbench — Inspector: open a package, scrub it, preview a frame, render final media.
2. /workbench/history — receipts history.
3. /workbench/connections — add Motion to an agent, or copy the local addresses and key.
4. /workbench/docs — the shipped documentation set, read in place.
5. /workbench/about — engine identity, external-tool readiness and update status.

NoteThe Workbench does not maintain a second project model. There is no template gallery page: the 12 template families are reference material for agents and hosts through the CLI, SDK and MCP.

Connect and the local access key

Start Motion authenticates the first tab automatically. Any other tab, or a manual Debug API session, connects by pasting the same local access key into the Connect dialog.

1. Click Connect to open the dialog.
2. Paste the local access key (minimum 32 characters).
3. The key is kept in that browser tab's sessionStorage and nowhere else.

NoteThe same private key protects the Workbench, MCP and the Debug API. A rejected key reports an error in the dialog rather than failing silently.

Session state and granted tier

The header shows the live connection state, and every page except Inspector also shows a tier chip naming the access the server granted this session.

NoteThe tier shown is the server's ceiling, not a request. It cannot be raised from the page.

Document identity

The header names the open package and its canvas and frame rate, so a render is never started against a package you thought you had closed.

Choosing a package with Browse

The Motion package field takes a real filesystem path. Browse opens the operating system's native folder chooser through the server rather than a browser upload dialog.

1. Click Browse and pick the package root folder.
2. Motion loads the package, lists it, and renders a first preview frame.
3. Refresh package state re-reads it from disk.

NoteBrowse needs a desktop session. On Linux it needs zenity or kdialog.

The package list

Every package the Workbench has loaded appears in the rail with its layer count and duration. Clicking a row reloads that package.

The preview stage

Preview frames render on this machine and are served back through the authenticated artifact route. The stage switches between a black and a neutral background so alpha and light work can be judged honestly.

1. Use Black or Neutral to change the stage background.
2. Refresh frame re-renders the current playhead position.
3. The frame size is shown next to the background switch.

NoteThe default preview lane is native. A browser-lane preview needs Chromium.

Transport and playhead

Play, the timecode readout and the scrubber move the playhead. Moving it re-renders the preview at the new timestamp.

1. Play or pause with the transport button.
2. Drag the scrubber to a timestamp; the preview refreshes when it settles.
3. The right-hand timecode is the package duration.

The timeline

Layer timing is drawn as rows with a ruler and a playhead. Clicking a layer label or clip selects that layer and fills the Inspector panel.

1. Click a label or a clip to select the layer.
2. Zoom in and out with the timeline zoom control.
3. The toolbar summarises layer count and duration.

Inspector, Queue and Receipts tabs

The right rail carries three panels: Inspector for the current selection, Queue for receipt-backed render jobs, and Receipts for the receipts under a chosen location.

1. Inspector shows the selection's package id, motion id, canvas, duration, frame rate, layer, scene and safe-area counts.
2. Queue lists receipt-backed render jobs and refreshes on demand.
3. Receipts takes a receipt location through Browse and summarises what it found.

NoteQueue is derived from receipt files on disk. It does not see work in flight — use motion.job.get for that.

Diagnostics

The Inspector panel ends with diagnostics from the last operation — for example a note that the browser renderer used a font fallback for a text layer.

NoteA diagnostic is evidence, not decoration. A font fallback changes the delivered pixels.

The render dialog

Render… opens a dialog that collects the output path, the export preset, an optional quality manifest and the motion gate, then reports readiness BEFORE submitting rather than an FFmpeg error afterwards.

1. Choose the output destination with Browse; the extension follows the preset.
2. Pick a preset: MP4 H.264, WebM VP9, animated GIF or a PNG still frame.
3. Optionally attach a quality manifest and require frame-to-frame motion.
4. Start render. Closing the progress view does not cancel it — the render continues in the background under the shown job id.

NoteThe readiness line is filled from motion.platform.requirements — the same answer doctor gives.

The status bar

The status bar is the honest running commentary: what the engine last did, and the standing reminder that project content stays on this machine.

Receipts history

Every Motion operation writes a durable receipt whose inputs and outputs are recorded as SHA-256 hashes. History is the regression trail: what ran, when, who or what triggered it, whether the quality gates passed, and where the output artifacts landed on disk.

NoteReceipts are not cryptographically signed — the hashes prove an artifact still matches what the operation recorded, not who wrote the file.

Choosing a receipt location

History reads a receipt root from disk. Browse picks it with the native chooser; Load receipts reads it.

1. Browse to the receipts root (the default is .scratch/receipts).
2. Click Load receipts.
3. The status bar reports how many receipts were loaded.

NoteHistory is read-only.

Filtering the receipt timeline

Filter by package, by operation, and by result — passed, warning, failed or not run — with a live shown-of-total count.

Reading a receipt card

A card names the operation, the package, the actor that triggered it, the renderer and encoder actually used, and the output artifact with its dimensions and duration.

1. Check the actor badge: it distinguishes a human, a local integration and an agent.
2. Check the renderer and encoder chips against what you asked for — a software fallback is recorded, not hidden.
3. Open the containing folder from the output row.
4. Details opens the full receipt, with a raw JSON toggle.

NotePassed with warnings is not a pass. Inspect the named gate before treating the artifact as approved.

Adding Motion to an agent

Choose the agent you use and click Configure; Motion adds itself. The setup command stays visible so you can review or copy it instead.

1. Codex, Claude Code and Grok have one-click Configure buttons.
2. Any other MCP client copies the local stdio command.
3. Open a new agent session after configuring.

NoteMotion must be running while the agent uses its tools. Agent setup uses Motion's local bridge, so the key is not written into agent configuration.

MCP and Debug API addresses

The connection details panel shows the live loopback MCP address, the Debug API address, and the single local access key, each with a copy button.

1. Copy the MCP address for a client that speaks JSON-RPC over HTTP.
2. Copy the Debug API address for direct POST /debug calls.
3. Reveal shows the access key; Copy puts it on the clipboard.

NoteThe same private key protects the Workbench, MCP and the Debug API. Treat it like any other local secret — theft by another local process would grant that process Motion's filesystem and render authority.

The Docs page

Motion serves its own shipped documentation set from the running engine, so the pages you read always match the build you are running.

1. Start here: Quickstart and Connect an agent.
2. Using ShellX Motion: Agent integration, Rendering lanes, Cut and Design Studio, Host integration.
3. Trust and security: Receipts and trust, Security model, Binary asset provenance.

Engine identity

About states which Motion this is: the running version, the access the session was granted, that processing happens on this machine, and that results are receipt-backed.

External tool readiness

Identity alone answers "which Motion is this", never "can it encode". The readiness block reads motion.platform.requirements and reports FFmpeg, FFprobe and Chromium, so a missing tool is visible before a render fails instead of after.

NoteThe block always renders. An absent block would read as a healthy machine.

Software update

About reads the shared cached update status — the same result startup checks, periodic checks and connected agents see. Check now refreshes it immediately.

1. The badge states whether an update is available.
2. View release notes opens the release page.
3. Update options reports the truthful install state for this installation.

NoteMotion checks the official release channel at startup and every 30 minutes. No project content or telemetry is sent.

Most of a package is data and cannot run

Shapes, text, keyframes, environments, particles and fixed 3D scenes declare what to draw. They cannot execute arbitrary source code, fetch remote assets implicitly, or raise host resource limits.

1. Shaders are a validated GLSL-ES subset with no loops, branches, helper functions, samplers or network access.
2. 3D scenes are Motion-owned primitives with bounded counts.
3. Environments run fixed, package-code-free host shaders.

NoteA construct the contract does not allow is refused. That is never a reason to hand-inject code or URLs into package JSON.

web, html and canvas layers DO execute JavaScript

This is the one deliberate exception, and it is the part worth knowing before you render something a stranger gave you. A web, html or canvas layer names an HTML file inside the package, and Motion loads it into Chromium WITH JAVASCRIPT ENABLED. Rendering such a package runs that script.

1. The execution is fenced: network denied by default, service workers blocked, secondary pages refused, file reads confined to the package root.
2. The fence bounds what the code can reach, not whether it runs.
3. Treat a package from a source you do not trust as a script from that source.

NoteEarlier Motion documentation said a package "cannot execute arbitrary code" without this qualification. That was wrong for this layer family and is corrected here.

The importer strips scripts; the render path does not

Foreign HTML brought in through motion.html.snippet.import is stripped of <script> and reported as lossy, so the import path is the safe one for markup you did not write.

1. The bounded importer reads declared layer metadata and a small inline CSS subset without executing scripts, handlers or stylesheets.
2. Image and video src values must be supported package-relative paths beside the source HTML.
3. Imported assets are copied into the new package, hashed in the receipt, bounded by per-file and total limits, and checked against traversal, symlink escape and executable or external SVG syntax.

NoteAgent-authored scripts inside a package are allowed. External script import is not enabled in 0.1.0.

Two native parsers consume untrusted bytes

Chromium and FFmpeg run with your OS privileges and parse whatever a package contains. Motion bounds them rather than pretending they are inert.

1. Chromium runs in a bounded render session with service workers, WebSockets, WebRTC, external files and undeclared origins blocked; package-local file URLs and data/blob URLs are allowed.
2. FFmpeg and FFprobe are invoked with shell:false through argument arrays, with validated input/output roots and preset extensions and bounded diagnostic output.
3. Render and agent subprocesses are contained in process groups (Unix) or Job Objects (Windows), so a deadline or cancellation terminates the whole tree.

NoteWhere Motion cannot prove kernel-level sandbox enforcement, its receipts say so (status: requested) rather than claiming a guarantee it has not verified.

Network access is denied by default

Motion does not reach the network as a side effect of rendering. A package's allowedOrigins entries are requests, not authority — the host must separately approve an exact origin.

1. When network access is deliberately used, every hostname is resolved first and private or reserved addresses are rejected.
2. One public address is pinned into the connection, redirects are revalidated and HTTPS downgrade is refused.
3. Response bytes, content types, time and concurrency are bounded.

Every operation writes a receipt

A receipt records the package identity, input and output hashes, renderer, encoder, dimensions, duration, quality checks, warnings and actor evidence. When an agent claims it rendered something, the receipt is how you check.

1. Match the package: confirm the package id and inputs are the ones you intended.
2. Read the result: a warning is not a pass — inspect the named gate and fallback.
3. Match the output: confirm the file path and SHA-256 hash before delivery.

NoteReceipts are not cryptographically signed. The hashes prove an artifact still matches what the operation recorded, not who wrote the file.

Reporting something this model says cannot happen

If you find behaviour the security model says is impossible, that is a vulnerability report. SECURITY.md at the repository root states how to send it privately, what is in scope, and what to expect back.

NoteSame-user malware with arbitrary file read or process inspection is treated as an OS-account compromise, which is outside what Motion can defend.

The contract, counted

Motion 0.1.0 ships 169 typed Debug API commands across 7 domains. 155 of them are also discoverable actions in schemas/actions.json, each with natural-language aliases; the remaining 14 are callable but carry no action entry. 115 commands are classified as mutations.

1. GET /debug/contracts returns the same registry at runtime.
2. motion.actions.find, .guide and .plan return the callable plan for a described intent.
3. If prose and a schema differ, the schema wins — repair the drift before mutating.

NoteA command that renders or writes a derived artifact is classified as a mutation even when the source package itself is unchanged.

motion.timeline.panel

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 1

Discovery phrases: show timeline panel, timeline panel, open timeline panel, show scene layer timeline, show scene and layer timeline, show timeline layers

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline panel returns playhead controls, scene and layer rows, markers, tracks, and suggested actions.

motion.timeline.inspect

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 1

Discovery phrases: inspect scenes tracks and timeline markers, inspect timeline, show timeline tracks, show timeline markers, list scenes and tracks, timeline metadata

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline inspect result includes scenes, tracks, markers, and layer track refs.

motion.timeline.playhead.set

Tier draft_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier draft_motion
• domain timeline
• mutates yes
• arguments 4

Discovery phrases: set timeline playhead to 2 seconds, set timeline playhead, move timeline playhead, scrub timeline playhead, jump playhead, set playhead, move playhead, scrub to timestamp

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline playhead receipt includes old/new playhead, state path, duration guard, and host receipt evidence.

motion.timeline.range.select

Tier draft_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier draft_motion
• domain timeline
• mutates yes
• arguments 4

Discovery phrases: select timeline range, set timeline range selection, select range on timeline, mark timeline range, set in and out points, select in out range, choose timeline segment

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline range receipt includes selected start/end, previous range, state path, and duration guard.

motion.timeline.viewport.set

Tier draft_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier draft_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: zoom timeline viewport, set timeline viewport, change timeline zoom, zoom timeline, pan timeline viewport, fit timeline range, set timeline pixels per second

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline viewport receipt includes start/end, zoom, pixels-per-second, previous viewport, and state path.

motion.timeline.duration.policy

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 1

Discovery phrases: show protected intro outro regions, show duration policy, inspect duration policy, read duration policy, show protected regions, list protected timeline regions, show intro outro locks, inspect protected duration regions

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Duration policy read returns min/max duration, resize mode, protected regions, and package duration.

motion.timeline.duration.policy.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 5

Discovery phrases: set protected intro outro duration policy, set duration policy, edit duration policy, set protected regions, protect intro outro regions, protect intro and outro, lock intro and outro duration, set timeline protected duration regions, set intro outro locks

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Duration policy receipt includes protected regions, min/max duration, resize mode, changed path, and validation result.

motion.timeline.scene.create

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 15

Discovery phrases: add storyboard scene, add timeline scene, add scene, create timeline scene, create scene, insert storyboard scene, insert timeline scene, new storyboard section, new scene, add outro scene

3 further optional arguments: receiptsRoot, trackId, trackIds. The complete contract, including descriptions and allowed values, is schemas/debug.json.

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline scene create receipt includes scene id, timing, optional layer/track/marker refs, changed paths, scene counts, duration evidence, and validation result.

motion.timeline.scene.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 5

Discovery phrases: delete storyboard scene, delete timeline scene, delete scene, remove storyboard scene, remove timeline scene, remove scene, drop storyboard scene, drop timeline scene, clear storyboard section, remove outro scene

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline scene delete receipt includes scene id, removed scene, changed paths, scene counts, non-destructive duration evidence, and validation result.

motion.timeline.scene.reorder

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: reorder storyboard scene, reorder timeline scene, reorder scene, move storyboard scene, move timeline scene, move scene row, move scene in storyboard, move outro scene before intro, send scene to top, move scene order

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline scene reorder receipt includes scene id, old/new index, old/new scene order, changed paths, non-destructive duration evidence, and validation result.

motion.timeline.scene.resize

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: resize intro scene duration with ripple, resize scene duration, set scene duration, change scene duration, extend scene with ripple, shorten scene with ripple, ripple scene duration, retime scene

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline scene resize receipt includes scene id, old/new duration, ripple flag, shifted scenes/layers/markers, changed paths, and validation result.

motion.timeline.scene.name.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: rename selected scene, rename scene, rename timeline scene, set scene name, set selected scene name, change scene name, change selected scene name, edit scene name, label selected scene, set scene display name

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline scene name receipt includes scene id, old/new display name, changed paths, action, and validation result.

motion.timeline.marker.upsert

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 11

Discovery phrases: add timeline marker at playhead, add timeline marker, set timeline marker, update timeline marker, change timeline marker, edit timeline marker, move timeline marker, modify timeline marker, add marker, set marker, update marker, change marker, edit marker, move marker, modify marker, update marker label, edit marker label, add beat marker, add cue marker, attach marker to scene

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline marker receipt includes marker id, timestamp, changed paths, scene ref updates, and validation result.

motion.timeline.marker.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 5

Discovery phrases: delete timeline marker at playhead, delete timeline marker, remove timeline marker, delete marker, remove marker, clear marker, delete beat marker, delete cue marker

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline marker delete receipt includes marker id, removed marker, changed paths, removed scene refs, and validation result.

motion.timeline.keyframe.upsert

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 9

Discovery phrases: add opacity keyframe with ease out, add timeline keyframe, set keyframe, update keyframe, change easing, add transform keyframe, keyframe opacity, keyframe position, animate title color keyframes, animate text color, keyframe fill color, keyframe style color, animate blur effect, keyframe visual effect, animate brightness, keyframe playback rate, animate mask crop keyframes, animate image crop keyframes, animate video crop keyframes, keyframe image crop, keyframe video crop, keyframe source crop, keyframe mask inset, animate crop reveal, keyframe clip mask, add spring keyframe, keyframe with spring easing, animate with spring physics

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe receipt includes layer id, target, timestamp, easing, changed path, target-specific value validation, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: easing, keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: delete opacity keyframe at playhead, delete timeline keyframe, remove keyframe, remove opacity keyframe, delete transform keyframe, clear keyframe

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe delete receipt includes layer id, target, timestamp, removed value, changed path, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.range.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 8

Discovery phrases: delete selected keyframes, remove selected keyframes, delete keyframe range, remove keyframe range, clear selected keyframes, clear keyframe range, delete opacity keyframes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe range delete receipt includes layer id, target, affected timestamp range, removed keyframes, changed paths, remaining count, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.move

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 8

Discovery phrases: move opacity keyframe, move timeline keyframe, move keyframe, retime keyframe, shift keyframe, nudge keyframe, change keyframe time, move transform keyframe

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe move receipt includes layer id, target, old/new timestamps, moved keyframe value/easing, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.easing.apply

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 10

Discovery phrases: apply ease in out to selected keyframes, apply easing to selected keyframes, apply easing preset to keyframes, set selected keyframe easing, change selected keyframe easing, set keyframe easing range, apply cubic bezier to keyframes, apply spring easing to keyframes, make selected keyframes bouncy

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe easing apply receipt includes layer id, target, easing preset, affected timestamp range, changed paths, updated count, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: easing, keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.shift

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 9

Discovery phrases: nudge selected keyframes, shift selected keyframes, shift keyframe range, move keyframe range, nudge keyframe range, slide keyframes, offset selected keyframes, shift opacity keyframes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe shift receipt includes layer id, target, delta, affected timestamp range, shifted keyframes, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.scale

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 10

Discovery phrases: stretch selected keyframes, scale selected keyframes, compress selected keyframes, stretch keyframe range, scale keyframe range, retime selected keyframes, change selected keyframe timing, spread keyframes around playhead

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe scale receipt includes layer id, target, scale factor, origin, affected timestamp range, scaled keyframes, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.duplicate

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 9

Discovery phrases: duplicate selected keyframes, copy selected keyframes, duplicate keyframe range, copy keyframe range, repeat selected keyframes, repeat keyframe animation, paste keyframes later, copy opacity keyframes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe duplicate receipt includes layer id, target, delta, affected timestamp range, duplicated keyframes, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.distribute

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 8

Discovery phrases: distribute selected keyframes, distribute keyframes evenly, evenly space selected keyframes, space keyframes evenly, equalize keyframe spacing, distribute opacity keyframes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe distribute receipt includes layer id, target, affected timestamp range, spacing, distributed keyframes, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.reverse

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 8

Discovery phrases: reverse selected keyframes, reverse keyframe range, mirror selected keyframes, mirror keyframe range, flip keyframe timing, reverse opacity keyframes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe reverse receipt includes layer id, target, affected timestamp range, reversed keyframes, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.keyframe.snap

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 10

Discovery phrases: snap selected keyframes to frames, snap keyframes to frame grid, align selected keyframes to frames, frame snap keyframes, snap opacity keyframes to frames, align keyframe timing to frame grid

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline keyframe snap receipt includes layer id, target, fps, snap mode, affected timestamp range, snapped keyframes, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: keyframeSnapMode, keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.spatial.position.upsert

Tier edit_motion. Mutates. No action entry — call it directly.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 10
• action entry none

Any other argument is rejected: the call fails with invalid_args and the command does not run.

Named value sets used here: easing. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.spatial.position.move

Tier edit_motion. Mutates. No action entry — call it directly.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7
• action entry none

Any other argument is rejected: the call fails with invalid_args and the command does not run.

motion.timeline.spatial.position.delete

Tier edit_motion. Mutates. No action entry — call it directly.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6
• action entry none

Any other argument is rejected: the call fails with invalid_args and the command does not run.

motion.timeline.keyframes.panel

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 4

Discovery phrases: show keyframe panel, keyframe panel, show keyframes panel, timeline keyframes panel, inspect keyframe panel, show animated keyframes, inspect timeline keyframes, show easing keyframes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Keyframe panel returns animated layers, target ranges, easing usage, preset counts, and suggested keyframe actions.

Named value sets used here: keyframeTarget. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.transitions.panel

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 4

Discovery phrases: show timeline transition panel, timeline transition panel, show transition panel, transition panel, show transitions panel, timeline transitions panel, inspect transition panel, show enter exit transitions, inspect timeline transitions, show transition easing

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Transition panel returns layers with enter/exit transitions, timing windows, easing usage, type counts, and suggested transition actions.

motion.timeline.easing.panel

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 2

Discovery phrases: show easing panel, show timeline easing panel, show timeline easing curves, inspect easing curves, inspect animation curves, show keyframe easing usage, show transition easing usage, review easing usage

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Easing panel returns sampled curves, keyframe and transition usage, custom easing detection, and suggested animation actions.

motion.timeline.easing.presets

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 0

Discovery phrases: show easing presets, list easing presets, easing preset discovery, show animation easing presets, what easing presets are available, list spring easing presets, show spring presets

Takes no arguments.

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Easing preset response includes named and cubic-bezier presets usable by keyframes and transitions.
2. Easing preset response includes spring presets (spring-gentle, spring-snappy, spring-bouncy) resolving to damped-spring param sets.

motion.timeline.animation.presets

Tier read_motion. Read-only. Discoverable as an action on the timeline, prompt surfaces.

• tier read_motion
• domain timeline
• mutates no
• arguments 0

Discovery phrases: show animation presets, list animation presets, animation preset discovery, show motion animation presets, what animation presets are available, list entrance and exit animations

Takes no arguments.

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Animation preset response includes entrance and exit presets with target keyframe coverage.

motion.timeline.animation.preset.apply

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 12

Discovery phrases: apply lower third entrance animation, apply lower third animation, apply animation preset, add entrance animation, add exit animation, animate layer in, animate layer out, animate title entrance, apply fade in preset, apply fade out preset, apply slide up entrance, apply lower third in, make the title slide in, make title slide in, slide the title in, slide title in, title entrance animation, give the title an entrance, give title an entrance, stagger title and subtitle entrance animation, staggered layer entrance animation, animate multiple layers in sequence, apply animation preset to multiple layers

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Animation preset apply receipt includes layer id or layer ids, preset id, timing or staggered per-layer timings, affected targets, changed paths, validation result, and preview evidence.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: animationPreset, easing. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.layer.create

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 23

Discovery phrases: add a text layer to the timeline, add text layer, create text layer, add shape layer, create shape layer, add environment layer, create environment layer, add rain environment layer, create rain environment, add water environment layer, create water environment, add snow environment layer, create snow environment, add a cinematic snow environment, insert timeline layer, create timeline layer, new timeline layer, add layer

11 further optional arguments: layerId, receiptsRoot, shape, source, src, startMs, text, trackId, trackIndex, type, width. The complete contract, including descriptions and allowed values, is schemas/debug.json.

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer create receipt includes layer id, stack index, optional track ref, changed paths, inserted track refs, and validation result.

motion.timeline.layer.trim

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 9

Discovery phrases: trim selected layer duration, trim layer, move layer timing, retime layer, set layer start and duration, change clip trim, adjust layer timing

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer trim receipt includes layer id, old timing, new timing, changed paths, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

motion.timeline.layer.split

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: split clip at playhead, split selected layer at playhead, split timeline layer, split layer, cut layer at playhead, cut clip at playhead, razor clip, razor layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer split receipt includes original layer id, new layer id, split timestamp, segment timings, changed paths, track order updates, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

motion.timeline.layer.text.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: change title text, update title text, edit title text, set layer text, change layer text, edit text layer, update text layer, set timeline layer text

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer text receipt includes layer id, old/new text, changed paths, action, and validation result.

motion.timeline.layer.style.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: make title blue, make the title blue, make the title blue and preview it, change title color, set title color, set layer color, change layer style, set layer style, set title font size, change font size, set layer font size

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer style receipt includes layer id, property, old/new values, changed paths, action, and validation result.

motion.timeline.layer.transform.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: move layer, move title layer, set layer position, set layer x, set layer y, resize layer, set layer width, set layer height, scale layer, rotate layer, set layer opacity

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer transform receipt includes layer id, property, old/new values, changed paths, action, and validation result.

motion.timeline.layer.effect.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: blur layer, blur title layer, soften layer, set layer blur, change layer effect, set layer effect, set layer brightness, adjust layer brightness, set layer contrast, adjust layer contrast, set layer saturate, desaturate layer, set layer grayscale

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer effect receipt includes layer id, property, old/new values, changed paths, action, and validation result.

motion.timeline.layer.rich.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: set rich motion control, change rich motion control, set rich layer parameter, set environment intensity, change environment intensity, set rain intensity, change rain intensity, set snow intensity, change snow intensity, set water wave amplitude, change water wave amplitude, set snow turbulence, set rain wetness, set water caustics, set shader uniform, change shader uniform, set particle emitter parameter, change 3d scene parameter, set camera depth control, set motion blur shutter, set film grain control

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline rich-control receipt includes layer id, allow-listed control path, old/new values, changed paths, action, validation result, and preview evidence.

motion.timeline.layer.blend.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: set layer blend mode, change layer blend mode, set blend mode, change blend mode, set layer multiply, set layer screen, make layer multiply, make layer screen, set compositor blend mode, change compositor blend

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer blend receipt includes layer id, old/new blend mode, changed paths, action, and validation result.

Named value sets used here: blendMode. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.layer.crop.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 10

Discovery phrases: crop image layer, crop video layer, crop media layer, crop layer, set layer crop, set image crop, set video crop, set source crop, change source crop, adjust media crop

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer crop receipt includes layer id, old/new crop rectangles, changed paths, action, and validation result.

motion.timeline.layer.mask.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 12

Discovery phrases: mask layer, set layer mask, set rectangular mask, set rounded mask, round layer mask, clip layer mask, set mask inset, change layer mask, adjust layer mask, mask visual layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer mask receipt includes layer id, old/new mask shapes, changed paths, action, and validation result.

motion.timeline.layer.fit.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: fit image layer, fit video layer, set media fit, set image fit, set video fit, set object fit, change media fit, set layer fit, contain image layer, cover image layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer fit receipt includes layer id, old/new media fit, changed paths, action, and validation result.

Named value sets used here: mediaFit. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.layer.media.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: set layer media source, set image media source, set video media source, set audio media source, change layer media source, set layer source, change layer source, replace layer media, swap layer media, replace timeline layer source

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer media receipt includes layer id, old/new source refs, changed paths, action, and validation result.

motion.timeline.layer.name.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: rename selected layer, rename layer, rename timeline layer, set layer name, set selected layer name, change layer name, change selected layer name, edit layer name, label selected layer, set layer display name

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer name receipt includes layer id, old/new display name, changed paths, action, and validation result.

motion.timeline.layer.visibility.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: hide layer, show layer, hide timeline layer, show timeline layer, set layer visibility, toggle layer visibility, hide selected layer, show selected layer, hide product layer, show product layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer visibility receipt includes layer id, old/new visibility, changed paths, action, and validation result.

motion.timeline.layer.lock

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: lock layer, unlock layer, lock selected layer, unlock selected layer, lock timeline layer, unlock timeline layer, set layer lock, set layer locked, protect layer, unprotect layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer lock receipt includes layer id, old/new lock state, changed paths, action, and validation result.

motion.timeline.layer.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 5

Discovery phrases: delete selected layer from timeline, delete timeline layer, remove timeline layer, delete selected layer, remove selected layer, delete layer, remove layer, clear layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer delete receipt includes layer id, removed layer, changed paths, removed track refs, remaining count, and validation result.

motion.timeline.layer.duplicate

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: duplicate selected layer on timeline, duplicate selected layer, duplicate timeline layer, clone selected layer, copy selected layer, duplicate layer, clone layer, copy layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer duplicate receipt includes source layer id, new layer id, offset, changed paths, inserted track refs, and validation result.

motion.timeline.layer.reorder

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: bring selected layer forward, send selected layer backward, move selected layer forward, move selected layer backward, move layer forward, move layer backward, move layer to front, send layer to back, reorder layer, change layer stack order, layer z order, move selected layer in stack

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer reorder receipt includes layer id, old/new stack indexes, changed paths, reordered track refs, and validation result.

motion.timeline.cleanup

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 4

Discovery phrases: clean up stale timeline refs, cleanup stale timeline refs, clean timeline refs, cleanup timeline refs, fix stale timeline refs, repair timeline refs, clean up timeline, timeline cleanup, remove duplicate timeline refs

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline cleanup receipt includes removed stale refs, duplicate refs, duration change, changed paths, and validation result.

motion.timeline.track.create

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 18

Discovery phrases: create an overlay track, create timeline track, add timeline track, add track, new timeline track, create overlay track, add overlay track, create audio track, add audio track, create caption track, add caption track

6 further optional arguments: receiptsRoot, solo, track, trackId, type, volume. The complete contract, including descriptions and allowed values, is schemas/debug.json.

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track create receipt includes track id, stack index, attached layer ids, changed paths, and validation result.

motion.timeline.track.reorder

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: move music track to top, reorder timeline track, move timeline track, move selected timeline track, move track to top, move track up, move track down, change track order, change timeline track order, track stack order

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track reorder receipt includes track id, old/new stack indexes, old/new track order, changed paths, and validation result.

motion.timeline.track.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: delete timeline track, remove timeline track, delete selected timeline track, remove selected timeline track, delete track, remove track, remove empty track, delete empty track

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track delete receipt includes track id, removed track, detached layer ids, removed scene refs, changed paths, and validation result.

motion.timeline.track.rename

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: rename timeline track, rename selected timeline track, rename track, change timeline track name, change track name, edit timeline track name, edit track name

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track rename receipt includes track id, old/new name, changed paths, action, and validation result.

motion.timeline.track.lock

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: lock selected timeline track, unlock selected timeline track, lock timeline track, unlock timeline track, lock overlay track, unlock overlay track, prevent edits on track, allow edits on track, toggle track lock

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track lock receipt includes track id, old/new lock state, changed paths, action, and validation result.

motion.timeline.track.mute

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: mute selected timeline track, unmute selected timeline track, mute timeline track, unmute timeline track, mute music track, unmute music track, mute audio track, unmute audio track, silence track, restore track audio, toggle track mute

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track mute receipt includes track id, old/new mute state, changed paths, action, and validation result.

motion.timeline.track.solo

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: solo selected timeline track, unsolo selected timeline track, solo timeline track, unsolo timeline track, solo music track, unsolo music track, solo audio track, unsolo audio track, isolate track audio, toggle track solo

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track solo receipt includes track id, old/new solo state, changed paths, action, and validation result.

motion.timeline.track.volume

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: set music track volume, change music track volume, adjust music track volume, set audio track volume, change audio track volume, adjust audio track volume, lower music track volume, raise music track volume, set track gain, adjust track gain, track volume

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track volume receipt includes track id, old/new volume, changed paths, action, and validation result.

motion.timeline.track.fade

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: set music track fade in and fade out, set track fade in, set track fade out, change track fades, adjust track fade, fade audio track, track fade, music track fade

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track fade receipt includes track id, old/new fade values, changed paths, action, and validation result.

motion.timeline.track.pan

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: pan music track left, pan music track right, center music track pan, set music track pan, set audio track pan, change audio track pan, adjust audio track pan, balance music track, pan audio track, track pan, track balance

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline track pan receipt includes track id, old/new pan values, changed paths, action, and validation result.

motion.timeline.layer.ducking.set

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 12

Discovery phrases: duck music under voice, duck music when voice plays, set audio ducking, set layer ducking, sidechain music under dialogue, sidechain audio layer, lower music during narration, duck background music

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer ducking receipt includes layer id, trigger layer ids, old/new ducking controls, changed paths, action, and validation result.

Named value sets used here: duckingMode. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.layer.track.assign

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 7

Discovery phrases: move selected layer to captions track, move layer to track, assign layer to track, send layer to track, reorder layer on track, move layer between tracks, set layer track, change layer track, put title on overlay track, put captions on caption track

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline layer track assignment receipt includes layer id, old/new track ids, order indexes, changed paths, removed source track refs, and validation result.

motion.timeline.caption.import

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 12

Discovery phrases: import captions from srt, import subtitle file, import captions, add captions from transcript, add srt captions, add vtt captions

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Caption import receipt includes source format, cue count, inserted layer ids, track refs, changed paths, and validation result.

Named value sets used here: captionFormat. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.caption.upsert

Tier edit_motion. Mutates. Discoverable as an action on the timeline, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 12

Discovery phrases: edit caption at playhead, add caption at playhead, update caption text, set caption timing, change caption text, create caption layer

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Caption upsert receipt includes layer id, timing, text, track ref, changed paths, and validation result.

motion.timeline.transition.upsert

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 11

Discovery phrases: add slide transition with ease out, add timeline transition, set transition, update transition, add fade in transition, add wipe transition, change transition easing, set enter transition, set exit transition

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline transition receipt includes layer id, edge, transition type, duration, easing, changed path, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: easing, transitionDirection, transitionEdge, transitionType. Every allowed-value list is enforced on the wire, not merely advertised.

motion.timeline.transition.delete

Tier edit_motion. Mutates. Discoverable as an action on the timeline, preview, receipts, prompt surfaces.

• tier edit_motion
• domain timeline
• mutates yes
• arguments 6

Discovery phrases: delete transition at playhead, delete transition, remove transition, clear transition, remove enter transition, remove exit transition, delete fade transition, delete slide transition, delete wipe transition

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Timeline transition delete receipt includes layer id, edge, removed transition, changed path, and validation result.
2. Preview receipt includes output frame hash after the timeline edit.

Named value sets used here: transitionEdge. Every allowed-value list is enforced on the wire, not merely advertised.

motion.script.compile

Tier write_local. Mutates. Discoverable as an action on the prompt, preview, receipts surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 5

Discovery phrases: generate scripted video, scripted video from description frames, cut generate video, storyboard to motion, description frames in cut

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Script compile receipt includes source storyboard hash.
2. Render receipt includes output file hash, codec, duration, and dimensions.

motion.analysis.tracking.request

Tier write_local. Mutates. Discoverable as an action on the tracking, prompt, preview, receipts surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 10

Discovery phrases: track this video, run point tracking, run planar tracking, analyze camera motion, track footage for stabilization, create tracking analysis

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Tracking request persists a source-hashed lifecycle with confidence, residual, lost/recovered, solver, containment, and receipt evidence.
2. Inspect confirms the package-local video bytes still match the persisted source identity.

motion.analysis.tracking.inspect

Tier read_motion. Read-only. Discoverable as an action on the tracking, prompt, preview, receipts surfaces.

• tier read_motion
• domain authoring
• mutates no
• arguments 2

Discovery phrases: inspect tracking analysis, show tracking confidence, show lost tracking spans, check tracking source, tracking status

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Tracking inspection returns lifecycle attempts, last-good analysis, confidence spans, and current/stale source identity without mutation.

motion.analysis.tracking.apply

Tier edit_motion. Mutates. Discoverable as an action on the tracking, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 7

Discovery phrases: apply tracking stabilization, stabilize this footage, attach track to layer, use planar track for stabilization, apply tracked camera correction

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Apply compiles a current last-good track into ordinary transform keyframes, retains explicit confidence gaps, and stores an exact reversible attachment.
2. Verify confirms analysis id, source hash, and generated keyframes before preview or Cut handoff.

motion.analysis.tracking.detach

Tier edit_motion. Mutates. Discoverable as an action on the tracking, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 4

Discovery phrases: detach tracking stabilization, remove stabilization, restore transform before tracking, unlink tracked motion, undo attached track

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Detach restores the exact prior x, y, scale, and rotation keyframes and removes only the tracking attachment.

motion.analysis.tracking.verify

Tier read_motion. Read-only. Discoverable as an action on the tracking, timeline, prompt, preview, receipts surfaces.

• tier read_motion
• domain authoring
• mutates no
• arguments 3

Discovery phrases: verify tracking stabilization, check tracking attachment, check stabilized keyframes, verify track before cut handoff, is tracking current

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Tracking verification reports missing or drifted attachments, analysis ids, source bytes, and generated keyframes without mutation.

motion.keying.inspect

Tier read_motion. Read-only. Discoverable as an action on the keying, roto, prompt, preview surfaces.

• tier read_motion
• domain authoring
• mutates no
• arguments 2

Discovery phrases: inspect chroma key, show green screen controls, inspect layer keying, check roto mask, show key and roto state

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Inspection reports the bounded key controls, animated roto state, and tracking attachment without mutation.

motion.keying.apply

Tier edit_motion. Mutates. Discoverable as an action on the keying, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 6

Discovery phrases: key out green screen, apply chroma key, remove green background, key this footage, apply spill suppression, clean green screen matte

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Apply creates a copy-on-write package, validates bounded key and matte-cleanup controls, previews the keyed pixels, and emits a receipt.

motion.keying.remove

Tier edit_motion. Mutates. Discoverable as an action on the keying, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 6

Discovery phrases: remove chroma key, disable green screen key, restore unkeyed footage, clear layer keying

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Remove deletes only the chroma-key contract in a copy-on-write package and preserves the source package and roto mask.

motion.roto.upsert

Tier edit_motion. Mutates. Discoverable as an action on the roto, tracking, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 6

Discovery phrases: create roto mask, animate roto mask, update rotoscope path, attach tracking to roto, isolate subject with roto

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Upsert validates stable vertex identities, bounded frames and tangents, optional source-hashed tracking attachment, rendered mask evidence, and a mutation receipt.

motion.roto.tracking.detach

Tier edit_motion. Mutates. Discoverable as an action on the roto, tracking, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 6

Discovery phrases: detach roto tracking, unlink tracking from roto, keep roto frames remove tracking, remove tracked roto attachment

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Detach removes only the roto tracking attachment while preserving the exact animated vertex frames.

motion.roto.remove

Tier edit_motion. Mutates. Discoverable as an action on the roto, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 6

Discovery phrases: remove roto mask, delete rotoscope mask, clear subject mask, restore unmasked footage

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Remove deletes only the roto mask in a copy-on-write package and preserves chroma-key controls.

motion.compositing.graph.inspect

Tier read_motion. Read-only. Discoverable as an action on the compositing, prompt, preview, receipts surfaces.

• tier read_motion
• domain authoring
• mutates no
• arguments 1

Discovery phrases: inspect compositing graph, show node graph, check compositing graph, show graph compile diagnostics, inspect graph resource budget

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Inspection returns the editable graph, validation diagnostics, deterministic fingerprint, resource estimate, and matching compile metadata without mutation.

motion.compositing.graph.set

Tier edit_motion. Mutates. Discoverable as an action on the compositing, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 5

Discovery phrases: set compositing graph, compile node graph, create blend graph, add matte graph, apply graph effects, connect compositing nodes

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Set validates data-only nodes, typed ports, cycles, matte constraints, and resource budgets before creating one copy-on-write package.
2. Inspect confirms graph fingerprint and compile metadata; preview verifies the compiled MotionIR pixels before handoff.

motion.compositing.graph.remove

Tier edit_motion. Mutates. Discoverable as an action on the compositing, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 5

Discovery phrases: remove compositing graph, detach node graph, restore graph source layers, clear compiled graph

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Remove deletes generated graph output and compile metadata while restoring the exact editable source-layer visibility and preserving the source package.

motion.procedural.inspect

Tier read_motion. Read-only. Discoverable as an action on the procedural, timeline, prompt, receipts surfaces.

• tier read_motion
• domain authoring
• mutates no
• arguments 2

Discovery phrases: inspect procedural relationships, show linked properties, show relationship drivers, explain driven animation, inspect expressions without code

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Inspection returns readable source and target properties, enabled state, graph validation, resource estimates, and optional evaluated values without changing the package.

motion.procedural.relationship.set

Tier edit_motion. Mutates. Discoverable as an action on the procedural, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 11

Discovery phrases: link animation properties, create driven property, set procedural relationship, drive animation from audio, add deterministic wiggle, link layer values

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Set rejects arbitrary JavaScript, unknown node types, missing properties, cycles, and over-budget graphs before creating one copy-on-write package revision.
2. Inspect and preview confirm the readable relationship and evaluated pixels before downstream handoff.

motion.procedural.relationship.enabled.set

Tier edit_motion. Mutates. Discoverable as an action on the procedural, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 11

Discovery phrases: enable procedural relationship, disable procedural relationship, toggle driven property, mute animation link

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Enabled state changes in one package revision while preserving the relationship definition for reversible editing.

motion.procedural.relationship.bake

Tier edit_motion. Mutates. Discoverable as an action on the procedural, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 11

Discovery phrases: bake procedural animation, convert relationship to keyframes, freeze driven animation, bake expressions to keyframes, make procedural motion editable

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Bake samples deterministic values within the bounded frame budget, writes ordinary numeric keyframes, detaches only selected relationships, and records sample, keyframe, and fingerprint evidence in one receipt.

motion.procedural.relationship.detach

Tier edit_motion. Mutates. Discoverable as an action on the procedural, timeline, prompt, preview, receipts surfaces.

• tier edit_motion
• domain authoring
• mutates yes
• arguments 11

Discovery phrases: detach procedural relationship, remove animation link, unlink driven property, delete relationship without baking

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Detach removes the selected relationship without inventing keyframes and preserves all unrelated graph entries in one copy-on-write revision.

motion.scene3d.gltf.import

Tier write_local. Mutates. Discoverable as an action on the scene3d, prompt, preview, receipts, canvas, cut surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 4

Discovery phrases: import gltf model, import glb model, create motion package from 3d model, add static 3d mesh, render gltf in canvas, send gltf render to cut

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Import preserves the original source, denies network and external buffers, lowers bounded static triangles, and emits provenance receipts.
2. Preview verifies actual WebGL mesh pixels and resource evidence before Canvas editing or a rendered-media Cut handoff.

motion.lottie.import

Tier write_local. Mutates. No action entry — call it directly.

• tier write_local
• domain authoring
• mutates yes
• arguments 4
• action entry none

Any other argument is rejected: the call fails with invalid_args and the command does not run.

motion.dotlottie.import

Tier write_local. Mutates. No action entry — call it directly.

• tier write_local
• domain authoring
• mutates yes
• arguments 6
• action entry none

Any other argument is rejected: the call fails with invalid_args and the command does not run.

motion.source.import

Tier write_local. Mutates. Discoverable as an action on the receipts, prompt surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 8

Discovery phrases: source import, import source link, import article link, import repo link, import article link for storyboard, import source for storyboard, fetch article for video, fetch repo for video, prepare link for scripted video, turn link into storyboard source

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Source import receipt includes public URL, kind, Markdown path, source hash, truncation evidence, and safe-fetch policy.

motion.source.to_scripted_video

Tier write_local. Mutates. Discoverable as an action on the receipts, prompt surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 9

Discovery phrases: source to scripted video, source to storyboard, turn imported source into scripted video, turn imported source into storyboard, lower source into scripted-video json, make scripted video from imported source, prepare source storyboard for cut, source storyboard for script to cut

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. Source-to-scripted-video emits deterministic scripted-video JSON, source refs, review-required storyboard metadata, and receipt artifacts before Script-to-Cut.

motion.html.snippet.export

Tier write_local. Mutates. Discoverable as an action on the receipts, preview, prompt surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 3

Discovery phrases: html snippet export, export html snippet, export html css snippet, export standalone html composition, export hyperframes html snippet, hyperframes html export, browser lane html export

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. HTML snippet export receipt includes HTML path, sha256, layer timing metadata, and lossiness diagnostics.

motion.html.snippet.import

Tier write_local. Mutates. Discoverable as an action on the receipts, preview, prompt surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 3

Discovery phrases: html snippet import, import html snippet, import html css snippet, import standalone html composition, import hyperframes html snippet, hyperframes html import, browser lane html import

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. HTML snippet import receipt includes package path, validated layer timing, staged local asset digests, and discarded HTML/CSS feature diagnostics.

motion.otio.export

Tier write_local. Mutates. Discoverable as an action on the receipts, preview, prompt surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 3

Discovery phrases: otio export, export otio, export timeline as otio, export this timeline as otio, export this timeline as otio for premiere, opentimelineio export, editorial interchange export

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. OTIO export receipt includes timeline path, sha256, track/clip/gap counts, and lossiness diagnostics.

motion.otio.import

Tier write_local. Mutates. Discoverable as an action on the receipts, preview, prompt surfaces.

• tier write_local
• domain authoring
• mutates yes
• arguments 3

Discovery phrases: otio import, import otio, import opentimelineio, import opentimelineio edit into motion, import editorial timeline, open otio timeline, convert otio to motion

Any other argument is rejected: the call fails with invalid_args and the command does not run.

1. OTIO import receipt includes package path, layer/track counts, imported assets, and unsupported item warnings.

motion.template.catalog

Tier read_motion. Read-only. Discoverable as an action on the templateInspector, prompt surfaces.

• tier read_motion
• domain authoring
• mutates no
• arguments 15

Discovery phrases: list motion templates in generate, list motion templates, show template catalog, template catalog, browse motion templates

3 further optional arguments: targetLane, templateRoot, width. The complete contract, including descriptions and allowed values, is schemas/debug.json.

Any other argument is rejected: the call fails with invalid_args and the command does not run.