Removed value: -{
-  "description": "When the site is used outside this project: 'shared' changes it for everyone, 'fork' copies it for this project.",
-  "enum": [
-    "shared",
-    "fork"
-  ],
-  "type": "string"
-}

Previous value: -"The animation to edit when there is no element: @org/<slug> or an id. 'new' creates one (then pass scope, name and slug)."New value: +"The site to edit when there is no element; 'new' makes one (name, scope)."

Previous value: -"The revision you read and expect to edit from. If it has moved, the save is refused with stale_base, the current revision and the files changed since."New value: +"The revision you read; a save made since is refused (stale_base)."

Previous value: -"A one-line note that saves this revision, when it passes, as a version in the element's history in the editor (the user can preview and restore it there). Set it when you reach a state worth returning to, not on every draft."New value: +"A name for a state worth keeping (e.g. 'v1 layout'): labels the saved revision and adds it as a version to the animation's Generations history, where the user can find and restore it."

Previous value: -200New value: +80

Added value: +{
+  "description": "Move this project's uses even when the new version drops something they use (a removed or retyped parameter, action, cue or page, a new size); without it such a save moves nothing and lists `breaking`.",
+  "type": "boolean"
+}

Previous value: -"summary (default) returns the outcome and what changed; full adds the diff hunks and every probe thumbnail."New value: +"'full' adds the diff hunks and thumbnail records."

Previous value: -"Build and check the edits without saving. Returns a `preview` token; render it with get_clip(render: {preview})."New value: +"Check without saving; returns a preview token for get_clip render.preview."

Previous value: -"Operations, applied in order before `files`: delete and move (replace and write also work; files is the shorter way)."New value: +"Ops applied first: delete and move (replace and write work too)."

Removed value: -"replace: replace every occurrence instead of requiring one."

Removed value: -"write: the whole file."

Removed value: -"replace: the text to put in its place."

Removed value: -"replace: the exact text to find, copied from read_animation."

Removed value: -"replace: exact-match `old` → `new` in `path` (fails unless `old` occurs exactly once, or pass all: true). write: create or overwrite `path` with `content`. delete: remove `path`. move: rename `path` to `to`."

Removed value: -"File path inside the animation, e.g. 'entries/maya.js'."

Previous value: -"The animation element this edit is about. The edit starts from the revision that element shows, and every use in this project moves to the new revision when it passes."New value: +"The element whose page to edit (from the version it shows); a canvas Mograph is upgraded to a page first. Needs project_id."

Previous value: -"Per-file changes, each with exactly one of edits, content, patch or upload_id. Applied in order after `edits` and `patch`, all saved as ONE revision."New value: +"Per-file changes: exactly one of edits, content, patch or upload_id each."

Previous value: -"The whole file: a new file, or a full rewrite."New value: +"The whole file (new file or rewrite)."

Previous value: -"Search-and-replace edits for an existing file, applied in order (each sees the text the one before left). Prefer these over content for changes to existing files."New value: +"Exact-match replaces, applied in order."

Previous value: -"The exact text to find, copied from read_animation without the 'N| ' line numbers. Must occur exactly once unless replace_all."New value: +"Exact text to find (without the 'N| ' numbers); must occur once unless replace_all."

Previous value: -"Replace every occurrence instead of requiring exactly one."New value: +"Replace every occurrence."

Previous value: -"A unified diff of this one file ('@@ -a,b +c,d @@' hunks). Context and removed lines must match exactly; a hunk may sit at other line numbers."New value: +"A unified diff of this one file."

Previous value: -"File path inside the animation, e.g. 'entries/maya.js'."New value: +"File path in the site, e.g. 'index.html'."

Previous value: -"The mcp_upload_id (mup_…) of a text file sent with upload_file (file_name + its curl), used as the whole content, so a big file never goes inline. UTF-8 text, at most 256 KB."New value: +"A file sent with upload_file: text is used as the whole content (UTF-8, at most 2 MB); media (video, audio, image, font, model) is added as is (at most 200 MB)."

Previous value: -"Only with animation 'new' and scope 'library' (a save the user asked to keep for the workspace): the library folder, by path, e.g. 'Characters' or 'Characters/Presenters'. Missing folders are created (at most three levels)."New value: +"animation 'new' with scope 'library': folder path, e.g. 'Brand/Intros'."

Added value: +{
+  "description": "animation 'new' with scope 'element'.",
+  "type": "string"
+}

Previous value: -"Only with animation 'new': the display name."New value: +"animation 'new': its name."

Previous value: -"For a client working from files on disk: a unified diff of any number of files against the saved revision (`git diff`, `diff -u` or `diff -ruN`), run from the folder holding manifest.json. The server holds the base. New files (--- /dev/null), deletes and renames apply too. A hunk whose context no longer matches is refused with the saved lines around it; nothing is saved."New value: +"A unified diff of any number of files (git diff / diff -ruN), from the site folder."

Previous value: -"Put the animation on the canvas on the first passing save, as an animation element on this clip (the add_elements placement), and return its element_id: pass that on every later edit so each passing save updates the editor live. Needs project_id. Placing is per entry and clip: an entry already on that clip is not placed again (its element_id comes back); any other entry, or the same entry on another clip, is, and existing elements keep their own entries. Works for an existing animation too (animation: '@org/<slug>', or element_id + place.entry for another entry of the element's animation), and with no file changes at all it only places the latest revision. A failing save places nothing."New value: +"Put the saved page on a clip in this call (after a passing save): returns element_id. Needs project_id. Without file changes: places the site as it is."

Added value: +{
+  "description": "Or the clip by id.",
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -"Zero-based clip the animation belongs to. With continue_from: the clip it continues into (default the next)."New value: +"The clip, 0-based."

Previous value: -"An animation element on an earlier clip that this one carries on from across the cut: placed in its box. The same animation, or a fork of it, picks up at the second it reached (timing 'trim'); any other starts at its own 0 with its own settings."New value: +"An animation element of an earlier clip: carry it on into the next clip (or clip_index) from where it stopped, with its box, values and timeline."

Previous value: -"Seconds from the clip's start (default: the clip's end)."New value: +"Clip seconds; default the page's duration."

Previous value: -"Which entry to place (default: the only one, else 'main', else the first). Any entry not yet on that clip is placed, also of an animation already on the canvas."New value: +"Another page of the site, e.g. 'outro.html'."

Previous value: -"Box height, canvas pixels (default: the full canvas)."New value: +"Canvas px; default full frame."

Previous value: -"The element's label."New value: +"The element's label in the editor (default: the site's name, or site/entry)."

Previous value: -"Seconds from the clip's start (default 0)."New value: +"Clip seconds; default 0."

Previous value: -"Box width, canvas pixels (default: the full canvas)."New value: +"Canvas px; default full frame."

Previous value: -"Left edge, canvas pixels (default: centred)."New value: +"Canvas px; default 0."

Previous value: -"Top edge, canvas pixels (default: centred)."New value: +"Canvas px; default 0."

Previous value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "actions": {
-        "description": "Action clips to try, [{name, start, duration?, args?}], element-local seconds; duration defaults to the action's default_duration. Replaces the element's clips for this render.",
-        "items": {
-          "properties": {
-            "args": {
-              "additionalProperties": {},
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "duration": {
-              "type": "number"
-            },
-            "name": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "start": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "name",
-            "start"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "cues": {
-        "additionalProperties": {
-          "type": "number"
-        },
-        "description": "Cue times to try, key: seconds (element-local).",
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "duration": {
-        "description": "How long the entry plays in the preview, in seconds.",
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "entry": {
-        "description": "Which entry to show (default: the element's, or the animation's first).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "filmstrip": {
-        "anyOf": [
-          {
-            "const": true,
-            "type": "boolean"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "around": {
-                "description": "Center the window on a cue ('cue:land') or an action clip ('action:hop', by name or id) instead of from/to. On a whole clip, a cue several animations share is 'cue:land@<element name>'.",
-                "pattern": "^(cue|action):.+",
-                "type": "string"
-              },
-              "fps": {
-                "description": "Frames per second instead of a count, e.g. 8 over 2 s is 17, capped at 16.",
-                "exclusiveMinimum": 0,
-                "maximum": 60,
-                "type": "number"
-              },
-              "frames": {
-                "description": "How many frames across the window, first and last included (default 12, max 16).",
-                "maximum": 16,
-                "minimum": 2,
-                "type": "integer"
-              },
-              "from": {
-                "description": "Window start, element-local seconds, or clip seconds for a whole clip (default 0).",
-                "minimum": 0,
-                "type": "number"
-              },
-              "seam": {
-                "const": true,
-                "description": "get_clip of a whole clip only: the cut from this clip into the next, as the player shows it: this clip's last second, its transition, and the next clip's first second, in this clip's seconds; takes frames, no window. Every cut of the film at once: get_project({render: {seams: true}}).",
-                "type": "boolean"
-              },
-              "span": {
-                "description": "With around: the window's length in seconds (default 2 around a cue; the clip plus 0.5 around an action).",
-                "exclusiveMinimum": 0,
-                "type": "number"
-              },
-              "to": {
-                "description": "Window end, element-local seconds, or clip seconds for a whole clip (default the end).",
-                "exclusiveMinimum": 0,
-                "type": "number"
-              }
-            },
-            "type": "object"
-          }
-        ],
-        "description": "See motion in ONE image instead of four moments: frames spaced evenly across a window (default 12 over the whole animation), in reading order, each labelled with its element-local time, with a thin timeline under each row marking the frames, cues (lines) and action clips (bars). Read pacing, easing and whether a beat lands on its cue from it. true for the defaults, or {from, to} / {around: 'cue:<key>' | 'action:<name>', span}, with frames or fps. Replaces timestamps. On get_clip without element_id, animation or preview it shows the whole clip, every element drawn, in clip seconds, and the timeline also ticks each element's start and end."
-      },
-      "param_tracks": {
-        "additionalProperties": {
-          "items": {
-            "properties": {
-              "interpolation": {
-                "type": "string"
-              },
-              "t": {
-                "type": "number"
-              },
-              "value": {}
-            },
-            "required": [
-              "t",
-              "value"
-            ],
-            "type": "object"
-          },
-          "minItems": 1,
-          "type": "array"
-        },
-        "description": "Keyframed settings to try, key: [{t, value, interpolation?}], t in element-local seconds. Replaces that key's track for this render.",
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "parameter_values": {
-        "additionalProperties": {},
-        "description": "Settings to render with, merged over the element's own (key: value).",
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "timestamps": {
-        "anyOf": [
-          {
-            "minimum": 0,
-            "type": "number"
-          },
-          {
-            "items": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "maxItems": 12,
-            "minItems": 1,
-            "type": "array"
-          }
-        ],
-        "description": "Moments to show, element-local seconds (default four across its length)."
-      },
-      "video": {
-        "description": "For people: also a short low-resolution MP4 of the same window (the filmstrip's, or the animation's first 10 s), returned as video_url, a link valid for an hour. You can't watch it: judge motion from the filmstrip.",
-        "type": "boolean"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "element_id": {
+        "description": "Which use to render when the save moved several (default the first).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "filmstrip": {
+        "anyOf": [
+          {
+            "const": true,
+            "type": "boolean"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "around": {
+                "description": "Center the window on a cue ('cue:land') or an action clip ('action:hop', by name or id) instead of from/to. On a whole clip, a cue several animations share is 'cue:land@<element name>'.",
+                "pattern": "^(cue|action):.+",
+                "type": "string"
+              },
+              "fps": {
+                "description": "Frames per second instead of a count, e.g. 8 over 2 s is 17, capped at 16.",
+                "exclusiveMinimum": 0,
+                "maximum": 60,
+                "type": "number"
+              },
+              "frames": {
+                "description": "How many frames across the window, first and last included (default 12, max 16).",
+                "maximum": 16,
+                "minimum": 2,
+                "type": "integer"
+              },
+              "from": {
+                "description": "Window start, element-local seconds, or clip seconds for a whole clip (default 0).",
+                "minimum": 0,
+                "type": "number"
+              },
+              "seam": {
+                "const": true,
+                "description": "get_clip of a whole clip only: the cut from this clip into the next, as the player shows it: this clip's last second, its transition, and the next clip's first second, in this clip's seconds; takes frames, no window. Every cut of the film at once: get_project({render: {seams: true}}).",
+                "type": "boolean"
+              },
+              "span": {
+                "description": "With around: the window's length in seconds (default 2 around a cue; the clip plus 0.5 around an action).",
+                "exclusiveMinimum": 0,
+                "type": "number"
+              },
+              "to": {
+                "description": "Window end, element-local seconds, or clip seconds for a whole clip (default the end).",
+                "exclusiveMinimum": 0,
+                "type": "number"
+              }
+            },
+            "type": "object"
+          }
+        ],
+        "description": "See motion in ONE image instead of four moments: frames spaced evenly across a window (default 12 over the whole animation), in reading order, each labelled with its element-local time, with a thin timeline under each row marking the frames, cues (lines) and action clips (bars). Read pacing, easing and whether a beat lands on its cue from it. true for the defaults, or {from, to} / {around: 'cue:<key>' | 'action:<name>', span}, with frames or fps. Replaces timestamps. On get_clip without element_id or preview it shows the whole clip, every element drawn, in clip seconds, and the timeline also ticks each element's start and end. HTML animations (pages) are drawn from their page in every render, the next clip's across a seam included; their cues and actions are the page's."
+      },
+      "test": {
+        "additionalProperties": false,
+        "description": "Try other settings on the one animation rendered (element_id or preview), nothing saved: parameter_values, param_tracks, actions, cues, in element-local (page) seconds. For an HTML animation the page is drawn with them; check a value or a cue before setting it with update_elements.",
+        "properties": {
+          "actions": {
+            "description": "Action clips to try instead of the element's: [{name, start, duration?, args?}].",
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "args": {
+                  "additionalProperties": {},
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                },
+                "duration": {
+                  "exclusiveMinimum": 0,
+                  "type": "number"
+                },
+                "name": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "start": {
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "name",
+                "start"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "cues": {
+            "additionalProperties": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "description": "Cue times to try: {key: seconds}.",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "param_tracks": {
+            "additionalProperties": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "interpolation": {
+                    "type": "string"
+                  },
+                  "t": {
+                    "description": "Element-local (page) seconds.",
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "value": {}
+                },
+                "required": [
+                  "t",
+                  "value"
+                ],
+                "type": "object"
+              },
+              "minItems": 1,
+              "type": "array"
+            },
+            "description": "Keyframes to try for animatable parameters: {key: [{t, value, interpolation?}]}.",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "parameter_values": {
+            "additionalProperties": {},
+            "description": "Values to try, over the element's own (an image or video value: a URL or upload).",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "video": {
+        "description": "For people: also a short low-resolution MP4 of the same window (the filmstrip's, or the animation's first 10 s), returned as video_url, a link valid for an hour. You can't watch it: judge motion from the filmstrip.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  }
+]

Previous value: -"Every direct save already returns a small contact sheet (four moments). false skips it; true or an object asks for a larger one with your choice of entry, moments, a filmstrip and test settings (parameter_values, where an image setting may be an upload id or a URL; param_tracks, actions, cues). With a project it shows a placed use of the entry with that element's own settings; with dry_run the unsaved code; without project_id a plain background. Nothing about the preview is saved."New value: +"Omitted: the probe's contact sheet (the page at its defaults). true: render what the save produced IN PLACE -- the element it moved (a dry run: its unsaved page), cropped, at four moments. {filmstrip, video, test, element_id}: the same as a filmstrip, with a short MP4 link, or with test settings. false: no image."

Added value: +{
+  "description": "With dry_run: also render it in the probe (slower; returns its contact sheet).",
+  "type": "boolean"
+}

Previous value: -"Project the element is in. Needed with element_id."New value: +"The project: a passing save moves its uses (one undo step)."

Added value: +{
+  "description": "One line: what the user asked for (history).",
+  "type": "string"
+}

Previous value: -"Only with animation 'new': one element, this project (the default with project_id; every scene of the video can import it), or the workspace library, only when the user asks to reuse it in other videos."New value: +"animation 'new' only: 'project' (default with project_id), 'element' (with for_element), or 'library' ONLY when the user asks to keep it for other videos."

Previous value: -"Only with animation 'new': lowercase letters, digits and dashes; becomes @org/<slug>. Slugs are workspace-wide: one an animation of another project (or the library) holds is saved as the next free <slug>-N (the reply's animation and note say which, nothing to resend); one this project already holds is refused, naming it and a free slug."New value: +"animation 'new': its site name (a-z, 0-9, -)."

Previous value: -"Required when the animation is used outside this project: 'shared' changes it for everyone who updates, 'fork' copies it for this project first. Official and community animations always fork."New value: +"When the site is used outside this project: 'shared' changes it for everyone, 'fork' copies it for this project."

Removed value: -{
-  "description": "After a passing save, re-pin every animation that imports this one (a kit's scenes) to the new revision in the same call and move this project's uses of them; dependents_updated {report, project_uses_moved, note} says what moved. Left out: on for a project-scoped animation saved with project_id, off otherwise (a library animation's importers span the workspace: pass true).",
-  "type": "boolean"
-}

Previous value: -"Whole files sent with upload_file(file_names: [...]) and its one curl: each upload's file name is its path in the animation (e.g. 'entries/city.js'), and its text replaces or adds that file. Applied after files."New value: +"Whole files sent with upload_file(file_names); each upload's name is its path."

Added value: +{
+  "description": "How long to wait for the probe's verdict (default the server's).",
+  "maximum": 170,
+  "minimum": 0,
+  "type": "number"
+}