@pinepaper.studio/mcp-server 1.6.6 → 1.6.8

package/dist/tools/handlers/character.js

@@ -0,0 +1,315 @@
+/**
+ * `pinepaper_character` — a symbol and some beats become a figure that performs.
+ *
+ * This clears a PHANTOM. The tool was defined here and dispatched nowhere
+ * (b06fcde): advertised in tools/list, counted in the manifest, offered by a
+ * toolkit, and answering every call with UNKNOWN_TOOL. A missing tool is
+ * invisible; a phantom is a capability the model is told it has and plans
+ * around, and only discovers is absent at call time.
+ *
+ * NOTHING HERE REIMPLEMENTS THE PERFORMANCE. `resolveCharacter` composes the
+ * drawing across the concept's ancestry and hands it to the vendored
+ * `performCharacter`, which returns ops naming exactly two tools this package
+ * already emits. Those ops go through the EXISTING `generateCreateItem` and
+ * `generateKeyframeAnimate`, so there is no second code path to drift: a figure
+ * is created and keyframed by the same generators as everything else.
+ *
+ * ── THE ONE ADAPTATION, AND WHY IT IS NOT OPTIONAL ──────────────────────────
+ *
+ * The cloud's ops are written for the cloud's rasterizer, and the two renderers
+ * disagree about what `position` means next to `pathData`.
+ *
+ * `performCharacter` emits geometry ALREADY SHIFTED to canvas coordinates — a
+ * pigeon asked for at (470, 250) comes back with `pathData` in the 400-700
+ * range — and pairs it with `position: {x: 0, y: 0}`, which its own renderer
+ * ignores. PinePaper does not ignore it. `create('path', …)` treats pathData as
+ * the OTHER convention — a shape authored around its own origin and placed by
+ * (x, y) — and its guard is `params.x !== undefined`, which `0` satisfies. So
+ * the ops as the cloud writes them would move every part's centre to (0, 0) and
+ * stack the whole figure on the canvas origin.
+ *
+ * That is not hypothetical: PinePaper's own comment at that line records it,
+ * "measured on a rigged figure whose 27 parts all drew correctly and all landed
+ * on the canvas origin, stacked, while every other signal (item count,
+ * registry, attachments) said the scene was fine."
+ *
+ * So each part is converted to PinePaper's convention here: the pathData is
+ * shifted to sit around its own bbox centre, and that centre is passed as the
+ * position. Same pixels, stated the way this engine reads them. Converting
+ * rather than re-authoring keeps `performCharacter` the single source of the
+ * performance — the adaptation is a coordinate convention, not a second
+ * implementation.
+ */
+import { resolveCharacter } from '../../character/resolve.js';
+import { pathBBox, shiftPath } from '../../character/path-bbox.js';
+/**
+ * Restate one create op in PinePaper's pathData convention.
+ *
+ * A part whose pathData cannot be measured is passed through UNCHANGED rather
+ * than guessed at: it will be misplaced, which is visible, instead of being
+ * silently dropped, which is not.
+ */
+export function toEngineConvention(op, centres) {
+    if (op.tool === 'pinepaper_keyframe_animate') {
+        // TWO CHANGES, BOTH REQUIRED FOR THE OP TO VALIDATE OR BEHAVE.
+        //
+        // (1) SHAPE. The cloud writes FLAT keyframes — `{time, x, opacity, easing}`
+        // — because its own reader (`extractKfProps`) accepts either form. This
+        // package's `KeyframeSchema` does not: it requires `{time, properties}`,
+        // and a flat keyframe is rejected at validation. Copied verbatim, every
+        // character call would have failed zod with "properties: Required".
+        //
+        // (2) UNITS. Beats are seconds. The keyframe path carries a legacy
+        // heuristic that reads a time over 100 as milliseconds and divides, which
+        // is right for old scenes and would collapse a two-minute performance into
+        // its first tenth of a second. `timeUnits` is the documented way off it.
+        const kfs = (op.args.keyframes ?? []);
+        // (3) ORIGIN. The create branch below re-places each part at its path's
+        // BBOX CENTRE, because that is the point PinePaper's `position` names. The
+        // cloud's tracks are anchored on the depiction's DECLARED anchor instead —
+        // `baseX = at.x + p.at[0]*k` — and the two are not the same point. Left
+        // alone, every animated part jumps from its placed centre to its anchor the
+        // instant the t=0 keyframe evaluates: measured at 19.6px for a pigeon's
+        // beak, which detaches it from the head. That is the very failure the
+        // `carriedBy` machinery exists to prevent, arriving through the back door.
+        //
+        // A track is RELATIVE MOTION around a base, so re-basing it on the centre
+        // the item was actually placed at preserves every displacement and removes
+        // the snap. The alternative — recentring `pathData` on the anchor so the
+        // two agree by construction — also works, and was not chosen because it
+        // moves the scale and rotation pivot off the shape's centre, changing how
+        // every non-animated part renders to fix the animated ones.
+        //
+        // A part whose path could not be measured records no centre and is left
+        // exactly as it came: misplaced and visible, never silently adjusted.
+        const centre = centres?.get(String(op.args.itemId ?? ''));
+        const times = kfs.map((k) => (typeof k.time === 'number' ? k.time : Infinity));
+        const firstIdx = times.indexOf(Math.min(...times));
+        const baseline = (axis) => {
+            if (!centre || firstIdx < 0)
+                return null;
+            const first = kfs[firstIdx];
+            const flat = first?.[axis];
+            const nested = first?.properties?.[axis];
+            const v = typeof flat === 'number' ? flat : (typeof nested === 'number' ? nested : null);
+            return v === null ? null : (axis === 'x' ? centre.cx : centre.cy) - v;
+        };
+        const dx = baseline('x');
+        const dy = baseline('y');
+        const rebase = (props) => {
+            const out = { ...props };
+            if (dx !== null && typeof out.x === 'number')
+                out.x = out.x + dx;
+            if (dy !== null && typeof out.y === 'number')
+                out.y = out.y + dy;
+            return out;
+        };
+        return {
+            ...op,
+            args: {
+                ...op.args,
+                timeUnits: 'seconds',
+                keyframes: kfs.map((k) => {
+                    const { time, easing, properties, ...rest } = k;
+                    return {
+                        time,
+                        ...(typeof easing === 'string' ? { easing } : {}),
+                        properties: rebase({ ...(properties ?? {}), ...rest }),
+                    };
+                }),
+            },
+        };
+    }
+    if (op.tool !== 'pinepaper_create_item')
+        return op;
+    const props = (op.args.properties ?? {});
+    const d = props.pathData;
+    if (typeof d !== 'string' || !d)
+        return op;
+    const box = pathBBox(d);
+    if (!box)
+        return op;
+    const cx = (box.minX + box.maxX) / 2;
+    const cy = (box.minY + box.maxY) / 2;
+    // `groupId` IS DROPPED, NOT PASSED THROUGH. The cloud sets it so its own
+    // composition gate does not count a rigged figure as N competing elements —
+    // a cloud concern with a cloud reader. PinePaper's `create()` builds a path's
+    // `item.data` fresh (`{ shapeType: 'path' }`), so the field never arrives;
+    // and `item.data.groupId` means something else here — the engine mints it for
+    // real Paper groups and reads it as a COLLAGE id. Emitting a field that this
+    // engine either ignores or would misread is the phantom in miniature.
+    //
+    // The honest consequence: nothing in the emitted program says these thirteen
+    // parts are ONE figure. Wrapping them in a Paper group would say it and would
+    // also put one transform over all of them, which is the wrong trade for a
+    // performance keyed per part — the same reason text-effect glyphs are
+    // siblings joined by edges rather than a group. Filed, not faked.
+    const { groupId: _dropped, ...rest } = props;
+    return {
+        ...op,
+        args: {
+            ...op.args,
+            position: { x: cx, y: cy },
+            properties: { ...rest, pathData: shiftPath(d, -cx, -cy) },
+        },
+    };
+}
+/**
+ * Convert a whole program, not one op at a time.
+ *
+ * The keyframe tracks cannot be converted without knowing where the create ops
+ * actually placed each part, so the creates go first and record their centres.
+ * Converting op-by-op is what left the tracks anchored on a different point
+ * from the items they drive.
+ */
+export function convertOps(ops) {
+    const centres = new Map();
+    const converted = ops.map((op) => {
+        if (op.tool !== 'pinepaper_create_item')
+            return op;
+        const out = toEngineConvention(op);
+        const id = (op.args.properties ?? {}).id;
+        const pos = out.args.position;
+        // Only a part that was actually re-placed records a centre: an unmeasurable
+        // path is passed through untouched and must not re-base anything.
+        if (typeof id === 'string' && pos && out !== op)
+            centres.set(id, { cx: pos.x, cy: pos.y });
+        return out;
+    });
+    return converted.map((op) => (op.tool === 'pinepaper_keyframe_animate' ? toEngineConvention(op, centres) : op));
+}
+/**
+ * Plan a character call: ops in PinePaper's convention, or a refusal.
+ *
+ * Separated from the handler so it can be tested WITHOUT `handleToolCall`,
+ * which tries to reach a browser and times out at 5001ms.
+ */
+export function planCharacter(args) {
+    const r = resolveCharacter(args);
+    if (!r.ok)
+        return r;
+    return {
+        ...r,
+        ops: convertOps(r.ops),
+        concept: String(args.concept ?? ''),
+        root: figureRoot(r.parts),
+    };
+}
+/**
+ * The part the others hang off.
+ *
+ * `part_of_figure` points at a SIBLING, exactly as `glyph_of` points at the
+ * root glyph — there is no wrapper item, and inventing one would be the Paper
+ * group this design deliberately avoids. The body is the natural root because
+ * it is the part every other one is drawn against; failing that, the first in
+ * z-order, which is stable for a given concept.
+ */
+export function figureRoot(parts) {
+    if (!parts.length)
+        return null;
+    // The ink copies are duplicates of a source part and must never be the root.
+    const real = parts.filter((p) => !p.endsWith('__ink'));
+    const pool = real.length ? real : parts;
+    return pool.find((p) => p.endsWith('_body')) ?? pool[0] ?? null;
+}
+/**
+ * The whole performance as one program.
+ *
+ * Emitted as a single block with one history save at the end, like
+ * `batch_create`: thirteen parts and eight tracks are ONE authoring act, and
+ * thirteen undo steps to remove one pigeon is not what anybody means by undo.
+ *
+ * Every interpolated value goes through `JSON.stringify`. Prose is DATA — an
+ * apostrophe in a refusal message, interpolated into a single-quoted literal,
+ * once made every generated `auto_walk` program a SyntaxError.
+ */
+export function generateCharacterCode(plan, gen, parse) {
+    const out = [];
+    for (const note of plan.notes)
+        out.push(`// ${note.replace(/\r?\n/g, ' ')}`);
+    // ── THE PART IDS THE PERFORMANCE NAMES ARE NOT THE IDS THE ENGINE MINTS ────
+    //
+    // `performCharacter` names its parts `pigeon_eye`, `pigeon_head` … and keys
+    // every keyframe track on those names. PinePaper does not accept a
+    // caller-supplied id: `create()` never forwards `params.id` to
+    // `itemRegistry.register`, which mints `item_1`, `item_2` … of its own. So
+    // `addAnimation('pigeon_eye', …)` finds nothing — and it does not throw, it
+    // `console.warn`s, and production strips console.
+    //
+    // MEASURED, because the unit tests could not see it: thirteen parts rendered
+    // correctly at the right place and ZERO of them carried a keyframe. The
+    // figure appears, and simply never moves. Every signal short of reading the
+    // items said the call had succeeded.
+    //
+    // So the program binds each part to the id the engine actually assigned and
+    // the tracks reference that, which is what makes the performance run.
+    // On a CURRENT studio this map is the identity — FxTool's `create()` now
+    // honours a caller-supplied `id` (and suffixes rather than steals a taken
+    // one). It is kept because an MCP server talks to whatever studio is open,
+    // and on an older one the minted ids are all that exist. Reading the id back
+    // from the item is correct on both.
+    out.push('const __ppChar = {};');
+    // ONE AUTHORING ACT, ONE UNDO. Each generated op ends with its own
+    // `saveState()`, which for a thirteen-part figure is thirteen undo steps to
+    // remove one pigeon. The optional call means an older studio without
+    // batching still runs — it just undoes in pieces.
+    out.push('app.historyManager?.beginBatch?.();');
+    for (const op of plan.ops) {
+        // BLOCK-SCOPED, BECAUSE EVERY GENERATED CREATE DECLARES `const item`.
+        // Concatenated, thirteen parts are thirteen redeclarations in one scope and
+        // the whole program is a SyntaxError before a single shape is drawn — it
+        // does not draw twelve parts and fail on the last, it draws nothing.
+        if (op.tool === 'pinepaper_create_item') {
+            const partId = String(op.args.properties?.id ?? '');
+            const body = gen.generateCreateItem(parse.createItem(op.args));
+            // `itemId` is declared by the generated code inside this same block.
+            const bind = partId ? `\n__ppChar[${JSON.stringify(partId)}] = itemId;` : '';
+            out.push(`{\n${body}${bind}\n}`);
+        }
+        else if (op.tool === 'pinepaper_keyframe_animate') {
+            const partId = String(op.args.itemId ?? '');
+            // Generated against a placeholder, then the placeholder LITERAL is
+            // swapped for the lookup. A placeholder rather than the part id itself
+            // because the id also appears in the op's trailing result object, and a
+            // blanket string replace there would be a silent rewrite of something
+            // else — this way the only thing that can match is the token this
+            // function put in.
+            const token = `__PP_REF_${partId}__`;
+            const body = gen
+                .generateKeyframeAnimate(parse.keyframeAnimate({ ...op.args, itemId: token }))
+                .split(JSON.stringify(token)).join(`__ppChar[${JSON.stringify(partId)}]`)
+                .split(`'${token}'`).join(`__ppChar[${JSON.stringify(partId)}]`);
+            out.push(`{\n${body}\n}`);
+        }
+    }
+    // ── THE PARTS ARE ONE FIGURE, AND ONLY THE GRAPH CAN SAY SO ───────────────
+    //
+    // Nothing else in the program does. They are thirteen sibling paths; a Paper
+    // group would bind them and would also put ONE transform over all of them,
+    // which is wrong for a performance keyed per part — the same trade text
+    // effects make by joining glyphs with edges instead of grouping them.
+    //
+    // `part_of_figure` is an ANNOTATION: inert at frame time. It is deliberately
+    // not `part_of`, which cascades the parent's position — every carried part
+    // already has that motion baked into its own track by `carriedBy`, so the two
+    // together would move it twice.
+    if (plan.root) {
+        const bindings = plan.parts
+            .filter((p) => p !== plan.root)
+            .map((p) => ({ part: p, role: p.replace(/^[^_]+_/, '').replace(/__ink$/, '') }));
+        if (bindings.length) {
+            out.push([
+                `// ${bindings.length} parts bound into one figure, rooted on ${plan.root}`,
+                'if (app.addRelation) {',
+                ...bindings.map((b) => `  app.addRelation(__ppChar[${JSON.stringify(b.part)}], __ppChar[${JSON.stringify(plan.root)}],` +
+                    ` 'part_of_figure', { role: ${JSON.stringify(b.role)}, concept: ${JSON.stringify(plan.concept)} });`),
+                '}',
+            ].join('\n'));
+        }
+    }
+    out.push('app.historyManager?.endBatch?.(true);');
+    out.push(`// ${plan.parts.length} parts, ${plan.tracks} keyframe tracks`);
+    out.push(`return ${JSON.stringify({ parts: plan.parts, tracks: plan.tracks, notes: plan.notes })};`);
+    return out.join('\n\n');
+}
+//# sourceMappingURL=character.js.map

package/dist/tools/handlers/character.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.js","sourceRoot":"","sources":["../../../src/tools/handlers/character.ts"],"names":[],"mappings":"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"}

package/dist/tools/handlers.d.ts

@@ -23,6 +23,8 @@ export type ScreenshotMode = 'on_request' | 'always' | 'never';
  * Defaults to 'on_request' for optimal performance.
  */
 export declare function getScreenshotMode(): ScreenshotMode;
+export declare const ALWAYS_SAVE_FORMATS: Set<string>;
+export declare function getFileExtension(format: string): string;
 /**
  * Execution modes for tool behavior.
  *

package/dist/tools/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,oCAAoC,CAAC;AAuJ/F,OAAO,EAAE,WAAW,EAAW,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAI3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,YAAY,EAA0C,MAAM,uBAAuB,CAAC;AA4B7F;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AA+CD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA2ED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAwBhB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAqMzB;AAMD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CASR;AA0ED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAkBzB"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,oCAAoC,CAAC;AA8I/F,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,0BAA0B,EAG3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,YAAY,EAA0C,MAAM,uBAAuB,CAAC;AAgC7F;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AAaD,eAAO,MAAM,mBAAmB,aAAgD,CAAC;AAGjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvD;AAiHD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAuFD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAwBhB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAqMzB;AAMD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CASR;AAkFD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAkBzB"}