@cyanheads/pixoo-mcp-server 1.2.0 → 1.2.2

package/changelog/1.2.x/1.2.2.md

@@ -0,0 +1,40 @@
+---
+summary: "Adopts @cyanheads/pixoo-toolkit 0.10.0: animated GIF and WebP push as animations, images take a palette finish, scene elements take blend modes and stroke widths, and text gains a numerals face. Undecodable images fail as invalid_image, and filled circles and JPEG/WebP images render differently."
+breaking: false
+security: false
+---
+
+# 1.2.2 — 2026-09-26
+
+## Added
+
+- **`finish` on `pixoo_push_image` and scene `image` elements** reduces the image to a palette: `colors` (2–256) or `palette` (1–256 colors), plus `dither` (`none`, `bayer4`, `floyd-steinberg`) ([#27](https://github.com/cyanheads/pixoo-mcp-server/issues/27)). An animation's `colors` palette is shared across frames; a bad palette entry fails as `invalid_color`.
+- **`blend` on every `pixoo_compose_scene` element** — `normal` (default), `add`, `screen`, or `multiply` ([#29](https://github.com/cyanheads/pixoo-mcp-server/issues/29)).
+- **`strokeWidth` and `antialias` on `line` and outline `circle`; `strokeWidth` on a `rect` border**, growing inward (#29). Either on a shape that draws no stroke fails `-32602` naming it; a wide or anti-aliased stroke's layout box covers every pixel drawn.
+- **`font: "numerals"`** on `pixoo_display_text` and scene `text` — an 11×18 digit face drawing 0–9, space, and `: . - + / % ° ?`; any other character fails `-32602` naming it, and auto-fit never picks it ([#30](https://github.com/cyanheads/pixoo-mcp-server/issues/30)).
+- **`pixoo_push_image` `speed` input and `frames`, `sourceFrames`, `speed` output fields** for animated sources ([#28](https://github.com/cyanheads/pixoo-mcp-server/issues/28)).
+- **`pixoo_output_dir` and `pixoo_push_min_interval_ms` options in `manifest.json`**, so a Claude Desktop bundle install can set `PIXOO_OUTPUT_DIR` and `PIXOO_PUSH_MIN_INTERVAL_MS`.
+
+## Changed
+
+- **An animated GIF or WebP given to `pixoo_push_image` pushes as an animation** instead of its first frame, whatever its file extension (#28). Up to 40 frames, sampled evenly from a longer source, play at the source's total duration over the pushed frame count.
+- **Filled `circle` elements draw a rounder disc** (`dx² + dy² ≤ r² + r`, from the toolkit), so every filled circle's pixels change.
+- **JPEG and WebP images decode at full resolution before resizing** (from the toolkit), so their pushed pixels change.
+- **An image source that is read but does not decode fails as `-32602` `invalid_image`** naming the source and the decoder's reason, instead of an unclassified `-32603`, in `pixoo_push_image` and compose `image` and `sprite` elements ([#34](https://github.com/cyanheads/pixoo-mcp-server/issues/34)).
+- **`asset_not_found` carries its tool's declared recovery hint, reworded, on both image tools**, and a sprite `path` given as a URL says sprite sheets take a local path ([#51](https://github.com/cyanheads/pixoo-mcp-server/issues/51)).
+- **https image sources load from memory** — they render when the temp dir is unwritable, and an https SVG renders like the same local file instead of rasterizing at its intrinsic size ([#23](https://github.com/cyanheads/pixoo-mcp-server/issues/23)).
+- **A partially transparent pixel under `opacity` below 100 fades at its own alpha × opacity**, so soft-edged images no longer brighten as they fade (#29).
+- **`twinkle` renders the same frames for the same input**; its jitter comes from the frame index and element position ([#50](https://github.com/cyanheads/pixoo-mcp-server/issues/50)).
+- **`pixoo_display_text` reports `fits: false` for text leaving the panel on any edge** ([#49](https://github.com/cyanheads/pixoo-mcp-server/issues/49)), and a scrolling line reports `box.x: 0`, where its frame draws it ([#55](https://github.com/cyanheads/pixoo-mcp-server/issues/55)).
+- **`standard` and `compact` draw `° ← ↑ → ↓ ▲ ▼ ♥ · …` as glyphs** instead of `?` (#30).
+- **`Object.prototype` names such as `constructor` fail as `invalid_color`** on every color input of `pixoo_compose_scene`, `pixoo_display_text`, and `pixoo_overlay_text`, which now rejects them before any device call ([#32](https://github.com/cyanheads/pixoo-mcp-server/issues/32)).
+- **`pixoo_design_brief` and the design guide** describe dithering, anti-aliasing, the new glyphs and numerals face, a glow recipe, and the Pixoo-64's measured dark and mid-level response.
+
+## Fixed
+
+- **`pixoo_compose_scene` loads each distinct asset once per call** — elements sharing a sprite sheet, or an image source and placement, share one decode, and a URL is fetched once ([#52](https://github.com/cyanheads/pixoo-mcp-server/issues/52)).
+- **Standard text at scale 2 is 14 px tall** in the design brief and guide, which said 10 px.
+
+## Dependencies
+
+- `@cyanheads/pixoo-toolkit` ^0.8.2 → ^0.10.0, exempt from the `bunfig.toml` release-age hold beside the framework

package/dist/mcp-server/resources/definitions/pixoo-design-guide.resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixoo-design-guide.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-design-guide.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAwGrD,eAAO,MAAM,wBAAwB,2GAyBnC,CAAC"}
+{"version":3,"file":"pixoo-design-guide.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-design-guide.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA2GrD,eAAO,MAAM,wBAAwB,2GAyBnC,CAAC"}

package/dist/mcp-server/resources/definitions/pixoo-design-guide.resource.js

@@ -13,8 +13,10 @@ At typical viewing distance for a 64×64 LED display:
 - **Minimum eye size:** 1–2px across; 2×2 fills are more reliable than single pixels
 - **Minimum limb gap:** 2 rows between horizontal elements prevents blur
 - **Font choices:**
-  - Standard (5×7): default for all text. Readable at 1× scale. Excellent at 2× (10px tall = chunky block letters)
+  - Standard (5×7): default for all text. Readable at 1× scale. Excellent at 2× (14px tall = chunky block letters)
   - Compact (3×5): secondary text, captions, labels when space is tight
+  - Standard and compact both draw printable ASCII plus \`° ← ↑ → ↓ ▲ ▼ ♥ · …\` for units, trends, and separators
+  - Numerals (11×18): clocks and hero readouts. Draws 0–9, space, and \`: . - + / % ° ?\` only, each digit on one 13px advance so a changing value keeps its width. Auto-fit never picks it; text holding any other character is rejected, so units and labels go in their own standard or compact text element
   - Scale ≥2: decorative or hero use only — verify fit before pushing
 
 ## Palette Discipline
@@ -103,6 +105,7 @@ At typical viewing distance for a 64×64 LED display:
 - **getConfig() omits SelectIndex** on current Pixoo-64 firmware — use getChannel() for reliable channel reads
 - **Text overlays (pixoo_overlay_text)** persist across channel switches until explicitly cleared
 - **Discovery requires internet** — Divoom cloud endpoint even for local device control
+- **Dark and mid levels render darker than on a monitor** — on a Pixoo-64 at brightness 100, channel levels 0–4 stay dark, and mid-levels render darker than on an sRGB monitor, shifting muted warm colors toward red (\`#D97757\` reads red). Previews show the sRGB values pushed, not the panel's response.
 `;
 export const pixooDesignGuideResource = resource('pixoo://reference/design-guide', {
     name: 'design-guide',

package/dist/mcp-server/resources/definitions/pixoo-design-guide.resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"pixoo-design-guide.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-design-guide.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGpB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC,gCAAgC,EAAE;IACjF,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,uNAAuN;IACzN,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE;IAEtD,OAAO,CAAC,OAAO,EAAE,IAAI;QACnB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,gCAAgC;gBACrC,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,eAAe;gBACzB,WAAW,EACT,iFAAiF;aACpF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"pixoo-design-guide.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-design-guide.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGpB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC,gCAAgC,EAAE;IACjF,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,uNAAuN;IACzN,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE;IAEtD,OAAO,CAAC,OAAO,EAAE,IAAI;QACnB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,gCAAgC;gBACrC,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,eAAe;gBACzB,WAAW,EACT,iFAAiF;aACpF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/pixoo-compose-scene.tool.d.ts

@@ -29,6 +29,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     elements: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -47,7 +53,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"text">;
         text: z.ZodString;
         x: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
@@ -63,6 +75,7 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         color: z.ZodOptional<z.ZodString>;
         font: z.ZodOptional<z.ZodEnum<{
             compact: "compact";
+            numerals: "numerals";
             standard: "standard";
         }>>;
         style: z.ZodOptional<z.ZodObject<{
@@ -86,6 +99,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -104,7 +123,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"icon">;
         name: z.ZodOptional<z.ZodString>;
         d: z.ZodOptional<z.ZodString>;
@@ -134,6 +159,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -152,7 +183,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"rect">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -168,9 +205,16 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             to: z.ZodString;
         }, z.core.$strip>>;
         borderColor: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -189,16 +233,30 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"circle">;
         cx: z.ZodNumber;
         cy: z.ZodNumber;
         radius: z.ZodNumber;
         color: z.ZodOptional<z.ZodString>;
         fill: z.ZodOptional<z.ZodBoolean>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        antialias: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -217,16 +275,30 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"line">;
         x0: z.ZodNumber;
         y0: z.ZodNumber;
         x1: z.ZodNumber;
         y1: z.ZodNumber;
         color: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        antialias: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -245,7 +317,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"progress">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -267,6 +345,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -285,7 +369,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"sparkline">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -300,6 +390,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -318,7 +414,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"bitmap">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -327,6 +429,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -345,7 +453,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"pixels">;
         data: z.ZodArray<z.ZodObject<{
             x: z.ZodNumber;
@@ -355,6 +469,12 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -373,7 +493,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"image">;
         source: z.ZodString;
         x: z.ZodOptional<z.ZodNumber>;
@@ -390,9 +516,30 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             mitchell: "mitchell";
             nearest: "nearest";
         }>>;
+        finish: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            colors: z.ZodNumber;
+            dither: z.ZodDefault<z.ZodEnum<{
+                bayer4: "bayer4";
+                "floyd-steinberg": "floyd-steinberg";
+                none: "none";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            palette: z.ZodArray<z.ZodString>;
+            dither: z.ZodDefault<z.ZodEnum<{
+                bayer4: "bayer4";
+                "floyd-steinberg": "floyd-steinberg";
+                none: "none";
+            }>>;
+        }, z.core.$strict>]>>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         opacity: z.ZodOptional<z.ZodNumber>;
+        blend: z.ZodOptional<z.ZodEnum<{
+            add: "add";
+            multiply: "multiply";
+            normal: "normal";
+            screen: "screen";
+        }>>;
         dx: z.ZodOptional<z.ZodNumber>;
         dy: z.ZodOptional<z.ZodNumber>;
         effect: z.ZodOptional<z.ZodObject<{
@@ -411,7 +558,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-        animate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>>;
+        animate: z.ZodOptional<z.ZodObject<{
+            dx: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            dy: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            opacity: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>], null>>>;
+            visible: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodBoolean], null>>>;
+            color: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>], null>>>;
+        }, z.core.$strip>>;
         type: z.ZodLiteral<"sprite">;
         path: z.ZodString;
         cols: z.ZodNumber;
@@ -453,6 +606,7 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         }>;
         font: z.ZodOptional<z.ZodEnum<{
             compact: "compact";
+            numerals: "numerals";
             standard: "standard";
         }>>;
         scale: z.ZodOptional<z.ZodNumber>;
@@ -493,8 +647,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
 }, {
     readonly reason: "asset_not_found";
     readonly code: JsonRpcErrorCode.NotFound;
-    readonly when: "An image or sprite path could not be read.";
-    readonly recovery: "Verify the file path exists and is readable, or check the URL is reachable.";
+    readonly when: "An image source or sprite path could not be read, a sprite path was a URL, or an image URL could not be fetched.";
+    readonly recovery: "Pass an absolute path to an existing, readable image file, or for an image source a reachable https URL serving 10 MiB or less; sprite sheets take an absolute local path.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "invalid_image";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "An image source or sprite path was read but did not decode as an image.";
+    readonly recovery: "Each image source and sprite path must be a complete PNG, JPEG, GIF, WebP, AVIF, TIFF, or SVG image; a text file, an HTML page, or a truncated download will not decode.";
     readonly thrownBy: "service";
 }, {
     readonly reason: "invalid_color";

package/dist/mcp-server/tools/definitions/pixoo-compose-scene.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixoo-compose-scene.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/pixoo-compose-scene.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAqT3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmT5B,CAAC"}
+{"version":3,"file":"pixoo-compose-scene.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/pixoo-compose-scene.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAwb3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8T5B,CAAC"}