@pixerate/editor 0.150.1 → 0.152.0

package/skills/pixerate-chart/SKILL.md

@@ -131,6 +131,18 @@ it changed.
 | `undo_chart` | Undo the last chart edit. Returns the label of what was undone and the next undo. |
 | `redo_chart` | Redo the last undone chart edit. |
 
+### Save and open
+
+The host may add the shared document tools (see `pixerate-agent-tools`). A chart document is the `ChartSpec`.
+
+| Tool | Use |
+| --- | --- |
+| `get_chart_document` | Take a copy of the whole chart as `{ kind, formatVersion, revision, document }` before a risky rewrite, or to hand it on. To read the chart, use `get_chart`: it is smaller and says more. Refuses very large documents. |
+| `load_chart_document` | Put back a copy from `get_chart_document` (its `document`, or the whole result). Checked first: when anything is wrong nothing changes and the error says what. One undo step (`undo_chart` brings the previous chart back). Every problem in the spec is refused, the same as `update_chart`; for data from a file use the import tools. |
+| `save_chart_document` | Save the chart under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |
+| `list_saved_chart_documents` | List saved charts (`key`, `name`, `savedAt`), newest first. |
+| `open_saved_chart_document` | Replace the chart with a saved one by `key`. One undo step. Ask before opening over changes the user has not saved. |
+
 ## Commands
 
 The `chart.*` commands (run with `run_command` / `run_commands`) mirror the tools. Prefer

package/skills/pixerate-parameters/SKILL.md

@@ -67,6 +67,18 @@ with `list_commands` (query "Parameters").
 | `parameters.undo` | Undo the last parameter change (a `parameters.set` call, preset, reset, randomize or keyframe toggle is one step). Disabled when there is nothing to undo. |
 | `parameters.redo` | Re-apply the change just undone. Disabled when there is nothing to redo. |
 
+## Save and open
+
+The host may add the shared document tools (see `pixerate-agent-tools`). A parameters document is `{ values, presets }`: every field value (missing ones take their defaults) and the user presets.
+
+| Tool | Use |
+| --- | --- |
+| `get_parameters_document` | Take a copy of the whole parameter set as `{ kind, formatVersion, revision, document }` before a risky rewrite, or to hand it on. To read the parameter set, use `parameters.list`: it is smaller and says more. Refuses very large documents. |
+| `load_parameters_document` | Put back a copy from `get_parameters_document` (its `document`, or the whole result). Checked first: when anything is wrong nothing changes and the error says what. One undo step (`parameters.undo` brings the previous values back). Unknown field ids and invalid values are refused. To change a few values use `parameters.set`. |
+| `save_parameters_document` | Save the parameter set under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |
+| `list_saved_parameters_documents` | List saved parameter sets (`key`, `name`, `savedAt`), newest first. |
+| `open_saved_parameters_document` | Replace the parameter set with a saved one by `key`. One undo step. Ask before opening over changes the user has not saved. |
+
 ## Pitfalls
 
 - With agent playback on, `parameters.set` visits each control it changes and types the value. Set related values in one call; results are unchanged.

package/skills/pixerate-vector/SKILL.md

@@ -455,6 +455,20 @@ the animation editor.
 | `update_effect` | Draw an effect group again with new `values` (`effect` "picture"); its place and transform are kept, but edits to its shapes are replaced. |
 | `remove_effect` | Keep the group's shapes as a plain group, detached from the effect. |
 
+### Save and open
+
+The host may add the shared document tools (see `pixerate-agent-tools`). A vector document is the `VectorDocument` (artboard size, nodes, symbols, constraints); the tool, selection and view are not part of it.
+
+| Tool | Use |
+| --- | --- |
+| `get_vector_document` | Take a copy of the whole vector document as `{ kind, formatVersion, revision, document }` before a risky rewrite, or to hand it on. To read the vector document, use `vector.list`: it is smaller and says more. Refuses very large documents. |
+| `load_vector_document` | Put back a copy from `get_vector_document` (its `document`, or the whole result). Checked first: when anything is wrong nothing changes and the error says what. One undo step (`undo_vector` brings the previous document back). For SVG markup use `vector.importSvg`. |
+| `undo_vector` | Undo the last vector edit (one command, one batch or one user gesture). Returns `undone` (the step's name) and whether more can be undone. Fails with "Nothing to undo." when there is nothing. |
+| `redo_vector` | Redo the last undone vector edit. |
+| `save_vector_document` | Save the vector document under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |
+| `list_saved_vector_documents` | List saved vector documents (`key`, `name`, `savedAt`), newest first. |
+| `open_saved_vector_document` | Replace the vector document with a saved one by `key`. One undo step. Ask before opening over changes the user has not saved. |
+
 ## Pitfalls
 
 The most common ones are below. Read [references/pitfalls.md](references/pitfalls.md) before working with connectors, frames, masks, filters, text, symbols, constraints, blends, gradient meshes or live corners.

package/skills/pixerate-video-editor/SKILL.md

@@ -254,6 +254,18 @@ and every write tool is refused with the reason.
 | `set_video_effect_transition` | Use a transition effect from the effects provider into a `clip` from the one ending where it starts (`duration` centred on the cut, `values`). Needs handles like a crossfade. For a cross dissolve, dip, wipe, push, slide or iris use the built-in `set_video_transition` instead. |
 | `set_video_effect_keyframes` | Animate one number `control` of a clip effect (or an effect clip's `generator`) with `keys` in clip ms, or `null` to stop animating it. |
 
+### Save and open
+
+The host may add the shared document tools (see `pixerate-agent-tools`). A video document is the `VideoProject` (assets point at their media; the media itself is not copied); the playhead is not part of it.
+
+| Tool | Use |
+| --- | --- |
+| `get_video_document` | Take a copy of the whole video project as `{ kind, formatVersion, revision, document }` before a risky rewrite, or to hand it on. To read the video project, use `get_video_project`: it is smaller and says more. Refuses very large documents. |
+| `load_video_document` | Put back a copy from `get_video_document` (its `document`, or the whole result). Checked first: when anything is wrong nothing changes and the error says what. One undo step (`undo_video` brings the previous project back). Refused while the editor is read-only. To change part of a project use `edit_video` or the per-operation tools. |
+| `save_video_document` | Save the video project under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |
+| `list_saved_video_documents` | List saved video projects (`key`, `name`, `savedAt`), newest first. |
+| `open_saved_video_document` | Replace the video project with a saved one by `key`. One undo step. Ask before opening over changes the user has not saved. |
+
 ## Pitfalls
 
 - With agent playback on, the cursor drags a moved or trimmed clip to its new time, clicks a track where a clip goes in, and clicks the ruler where a split, seek or marker lands. Give real `start` / `at` times in ms; results are unchanged.

package/dist/{chunk-Y4BWZB6J.cjs → chunk-462WGGXX.cjs}

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2;
 
-var _chunk2BSBFBOAcjs = require('./chunk-2BSBFBOA.cjs');
+var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
 
 
-var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
+var _chunk2BSBFBOAcjs = require('./chunk-2BSBFBOA.cjs');
 
 // src/tools/skills.ts
 function parseSkillFrontmatter(markdown) {

package/dist/{chunk-RFBFTLVN.js → chunk-EVXQNQND.js}

@@ -1,9 +1,9 @@
-import {
-  stripPrototypeKeys
-} from "./chunk-HF5QZS7Z.js";
 import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";
+import {
+  stripPrototypeKeys
+} from "./chunk-HF5QZS7Z.js";
 
 // src/tools/skills.ts
 function parseSkillFrontmatter(markdown) {