@cyanheads/pixoo-mcp-server 1.2.1 → 1.3.0

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. Any other character (\`€\`, \`×\`, \`’\`, \`—\`, a newline inside one string, the invisible U+FE0F after \`♥\`) draws as \`?\`, and the response notice names it with its code point and element index
+  - 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/asset-source-schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Inputs that name an image asset: the image `source` of pixoo_push_image
+ * and of a scene `image` element, and a scene `sprite` element's `path`. Each must be a
+ * URL or an absolute local path — a relative path would resolve against the server's
+ * working directory, which a caller cannot see.
+ * @module mcp-server/tools/asset-source-schema
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** An image source: an absolute local path or an https URL. */
+export declare const ImageSourceSchema: z.ZodString;
+/** A sprite sheet path: an absolute local path. */
+export declare const SpritePathSchema: z.ZodString;
+//# sourceMappingURL=asset-source-schema.d.ts.map

package/dist/mcp-server/tools/asset-source-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-source-schema.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/asset-source-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAW3C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,aAG5B,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,aAE3B,CAAC"}

package/dist/mcp-server/tools/asset-source-schema.js

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Inputs that name an image asset: the image `source` of pixoo_push_image
+ * and of a scene `image` element, and a scene `sprite` element's `path`. Each must be a
+ * URL or an absolute local path — a relative path would resolve against the server's
+ * working directory, which a caller cannot see.
+ * @module mcp-server/tools/asset-source-schema
+ */
+import * as path from 'node:path';
+import { z } from '@cyanheads/mcp-ts-core';
+import { isRemoteSource } from '../../renderer/remote-image.js';
+/**
+ * True for a value that names the same asset whatever the server's working directory.
+ * An http URL passes: the loaders refuse it as `asset_not_found` with a message naming
+ * the https requirement, as they refuse a sprite path given as any URL.
+ */
+const namesAssetAbsolutely = (value) => isRemoteSource(value) || path.isAbsolute(value);
+/** An image source: an absolute local path or an https URL. */
+export const ImageSourceSchema = z.string().refine(namesAssetAbsolutely, {
+    error: 'Must be an absolute local path or an https URL, not a relative path, a ~ path, or a file:// URL.',
+});
+/** A sprite sheet path: an absolute local path. */
+export const SpritePathSchema = z.string().refine(namesAssetAbsolutely, {
+    error: 'Must be an absolute local path, not a relative path, a ~ path, or a file:// URL.',
+});
+//# sourceMappingURL=asset-source-schema.js.map

package/dist/mcp-server/tools/asset-source-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-source-schema.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/asset-source-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAW,EAAE,CACtD,cAAc,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAElD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE;IACvE,KAAK,EACH,kGAAkG;CACrG,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE;IACtE,KAAK,EAAE,kFAAkF;CAC1F,CAAC,CAAC"}

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

@@ -6,7 +6,7 @@ import { z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     background: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        gradient: z.ZodObject<{
+        gradient: z.ZodOptional<z.ZodObject<{
             type: z.ZodEnum<{
                 h: "h";
                 r: "r";
@@ -14,9 +14,8 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             }>;
             from: z.ZodString;
             to: z.ZodString;
-        }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-        theme: z.ZodEnum<{
+        }, z.core.$strict>>;
+        theme: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             ember: "ember";
             forest: "forest";
@@ -24,11 +23,17 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             midnight: "midnight";
             mono: "mono";
             neon: "neon";
-        }>;
-    }, z.core.$strip>]>;
+        }>>;
+    }, z.core.$strict>]>;
     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<{
@@ -46,14 +51,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"text">;
         text: z.ZodString;
         x: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
@@ -69,6 +74,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<{
@@ -83,15 +89,21 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             }>, z.ZodObject<{
                 from: z.ZodString;
                 to: z.ZodString;
-            }, z.core.$strip>]>>;
+            }, z.core.$strict>]>>;
             shadow: z.ZodOptional<z.ZodBoolean>;
             outline: z.ZodOptional<z.ZodBoolean>;
             scale: z.ZodOptional<z.ZodNumber>;
             color: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>>;
+    }, z.core.$strict>, 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<{
@@ -109,14 +121,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"icon">;
         name: z.ZodOptional<z.ZodString>;
         d: z.ZodOptional<z.ZodString>;
@@ -143,9 +155,15 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             mono: "mono";
             neon: "neon";
         }>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, 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<{
@@ -163,14 +181,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"rect">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -184,11 +202,18 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             }>;
             from: z.ZodString;
             to: z.ZodString;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         borderColor: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, 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<{
@@ -206,23 +231,31 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"circle">;
         cx: z.ZodNumber;
         cy: z.ZodNumber;
         radius: z.ZodNumber;
         color: z.ZodOptional<z.ZodString>;
         fill: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>, z.ZodObject<{
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        antialias: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, 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<{
@@ -240,23 +273,31 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"line">;
         x0: z.ZodNumber;
         y0: z.ZodNumber;
         x1: z.ZodNumber;
         y1: z.ZodNumber;
         color: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        antialias: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, 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<{
@@ -274,14 +315,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"progress">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -300,9 +340,15 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         }>>;
         trackColor: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, 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<{
@@ -320,14 +366,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"sparkline">;
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -339,9 +385,15 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             bar: "bar";
             line: "line";
         }>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, 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<{
@@ -359,22 +411,27 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"bitmap">;
         x: z.ZodNumber;
         y: z.ZodNumber;
         rows: z.ZodArray<z.ZodString>;
         palette: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, 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<{
@@ -392,23 +449,29 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"pixels">;
         data: z.ZodArray<z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
             color: z.ZodString;
-        }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>>;
+    }, z.core.$strict>, 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<{
@@ -426,14 +489,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"image">;
         source: z.ZodString;
         x: z.ZodOptional<z.ZodNumber>;
@@ -450,9 +512,30 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             mitchell: "mitchell";
             nearest: "nearest";
         }>>;
-    }, z.core.$strip>, z.ZodObject<{
+        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.$strict>, 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<{
@@ -470,14 +553,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
             phase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
         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>>;
+        }, z.core.$strict>>;
         type: z.ZodLiteral<"sprite">;
         path: z.ZodString;
         cols: z.ZodNumber;
@@ -491,7 +573,7 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         scale: z.ZodOptional<z.ZodNumber>;
         bodyColor: z.ZodOptional<z.ZodString>;
         darkColor: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>], "type">>;
+    }, z.core.$strict>], "type">>;
     frames: z.ZodDefault<z.ZodNumber>;
     speed: z.ZodDefault<z.ZodNumber>;
     push: z.ZodDefault<z.ZodBoolean>;
@@ -500,7 +582,7 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     pushed: z.ZodBoolean;
     frames: z.ZodNumber;
     layout: z.ZodArray<z.ZodObject<{
-        element: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"background">]>;
+        element: z.ZodNumber;
         type: z.ZodString;
         box: z.ZodObject<{
             x: z.ZodNumber;
@@ -510,15 +592,11 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         }, z.core.$strip>;
         fits: z.ZodBoolean;
         action: z.ZodEnum<{
-            clipped: "clipped";
             none: "none";
-            scrolling: "scrolling";
-            "shrunk-to-compact": "shrunk-to-compact";
-            truncated: "truncated";
-            wrapped: "wrapped";
         }>;
         font: z.ZodOptional<z.ZodEnum<{
             compact: "compact";
+            numerals: "numerals";
             standard: "standard";
         }>>;
         scale: z.ZodOptional<z.ZodNumber>;
@@ -559,8 +637,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;AAmW3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqT5B,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;AAie3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6T5B,CAAC"}