@cyanheads/pixoo-mcp-server 1.0.0 → 1.1.0

package/dist/mcp-server/resources/definitions/pixoo-device-status.resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixoo-device-status.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-device-status.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,yBAAyB,2GAiCpC,CAAC"}
+{"version":3,"file":"pixoo-device-status.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-device-status.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,yBAAyB;;;;;;;;6BA2DpC,CAAC"}

package/dist/mcp-server/resources/definitions/pixoo-device-status.resource.js

@@ -11,6 +11,31 @@ export const pixooDeviceStatusResource = resource('pixoo://device/status', {
     description: 'Live snapshot of the connected Pixoo display: reachable, channel, brightness, screen state, and display size. Degrades gracefully when the device is unreachable — returns reachable: false instead of an error.',
     mimeType: 'application/json',
     params: z.object({}),
+    // No cacheHint: this is live device state, so every read must reach the device.
+    output: z.object({
+        reachable: z.boolean().describe('True when the device answered the status read.'),
+        channel: z
+            .string()
+            .optional()
+            .describe('Current channel name. Absent when the device is unreachable.'),
+        brightness: z
+            .number()
+            .optional()
+            .describe('Current brightness level (0–100). Absent when the device is unreachable.'),
+        screenOn: z
+            .boolean()
+            .optional()
+            .describe('True when the screen is on. Absent when the device is unreachable.'),
+        clockId: z
+            .number()
+            .optional()
+            .describe('Current clock face ID (faces channel only). Absent on other channels.'),
+        displaySize: z.number().describe('Configured display size in pixels (16, 32, or 64).'),
+        configuredIp: z
+            .string()
+            .nullable()
+            .describe('Configured PIXOO_IP value, or null when the server has no device configured.'),
+    }),
     async handler(_params, ctx) {
         const cfg = getServerConfig();
         const svc = getPixooService();

package/dist/mcp-server/resources/definitions/pixoo-device-status.resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"pixoo-device-status.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-device-status.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAQ,CAAC,uBAAuB,EAAE;IACzE,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,kNAAkN;IACpN,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAEpB,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG;QACxB,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,GAAG,CAAC,SAAS;YAC1B,YAAY,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;SAClC,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,uBAAuB;gBAC5B,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,qEAAqE;aACnF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"pixoo-device-status.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-device-status.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAQ,CAAC,uBAAuB,EAAE;IACzE,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,kNAAkN;IACpN,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,gFAAgF;IAEhF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QACjF,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;QAC3E,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0EAA0E,CAAC;QACvF,QAAQ,EAAE,CAAC;aACR,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,oEAAoE,CAAC;QACjF,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,uEAAuE,CAAC;QACpF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACtF,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8EAA8E,CAAC;KAC5F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG;QACxB,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,GAAG,CAAC,SAAS;YAC1B,YAAY,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;SAClC,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,uBAAuB;gBAC5B,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,qEAAqE;aACnF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/pixoo-icons.resource.d.ts

@@ -3,5 +3,13 @@
  * @module mcp-server/resources/definitions/pixoo-icons.resource
  */
 import { z } from '@cyanheads/mcp-ts-core';
-export declare const pixooIconsResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{}, z.core.$strip>, undefined, undefined>;
+export declare const pixooIconsResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    categories: z.ZodArray<z.ZodString>;
+    byCategory: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+    icons: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        category: z.ZodString;
+        viewBox: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
 //# sourceMappingURL=pixoo-icons.resource.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pixoo-icons.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-icons.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,kBAAkB,2GAoC7B,CAAC"}
+{"version":3,"file":"pixoo-icons.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-icons.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,kBAAkB;;;;;;;;6BAwD7B,CAAC"}

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

@@ -10,6 +10,23 @@ export const pixooIconsResource = resource('pixoo://reference/icons', {
     description: 'Built-in icon names organized by category (weather, arrows, status, media). Use icon names in pixoo_compose_scene elements with type "icon". Pass name to the icon element, or browse this resource to discover available names.',
     mimeType: 'application/json',
     params: z.object({}),
+    // Compile-time constants — safe for a shared cache to hold for a day.
+    cacheHint: { ttlMs: 86_400_000, cacheScope: 'public' },
+    output: z.object({
+        categories: z.array(z.string()).describe('Distinct icon category names.'),
+        byCategory: z
+            .record(z.string(), z.array(z.string()))
+            .describe('Icon names grouped by category.'),
+        icons: z
+            .array(z
+            .object({
+            name: z.string().describe('Icon name, usable as the icon element `name` argument.'),
+            category: z.string().describe('Category this icon belongs to.'),
+            viewBox: z.string().describe('SVG viewBox the icon path is drawn against.'),
+        })
+            .describe('A single registered icon.'))
+            .describe('Every registered icon in registry order.'),
+    }),
     handler(_params, _ctx) {
         const byCategory = getIconsByCategory();
         const iconList = ICON_NAMES.map((name) => {

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

@@ -1 +1 @@
-{"version":3,"file":"pixoo-icons.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-icons.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,yBAAyB,EAAE;IACpE,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,kOAAkO;IACpO,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAEpB,OAAO,CAAC,OAAO,EAAE,IAAI;QACnB,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO;gBACL,IAAI;gBACJ,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,SAAS;gBACtC,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,WAAW;aACvC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,UAAU,EAAE,eAAe;YAC3B,UAAU;YACV,KAAK,EAAE,QAAQ;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,yBAAyB;gBAC9B,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,kEAAkE;aAChF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"pixoo-icons.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-icons.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,yBAAyB,EAAE;IACpE,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,kOAAkO;IACpO,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE;IAEtD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACzE,UAAU,EAAE,CAAC;aACV,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;aACvC,QAAQ,CAAC,iCAAiC,CAAC;QAC9C,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACnF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAC5E,CAAC;aACD,QAAQ,CAAC,2BAA2B,CAAC,CACzC;aACA,QAAQ,CAAC,0CAA0C,CAAC;KACxD,CAAC;IAEF,OAAO,CAAC,OAAO,EAAE,IAAI;QACnB,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO;gBACL,IAAI;gBACJ,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,SAAS;gBACtC,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,WAAW;aACvC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,UAAU,EAAE,eAAe;YAC3B,UAAU;YACV,KAAK,EAAE,QAAQ;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,yBAAyB;gBAC9B,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,kEAAkE;aAChF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/pixoo-themes.resource.d.ts

@@ -3,5 +3,27 @@
  * @module mcp-server/resources/definitions/pixoo-themes.resource
  */
 import { z } from '@cyanheads/mcp-ts-core';
-export declare const pixooThemesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{}, z.core.$strip>, undefined, undefined>;
+export declare const pixooThemesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    themes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        background: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"gradient-v">;
+            from: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>]>;
+            to: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"solid">;
+            color: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>]>;
+        }, z.core.$strip>], "type">;
+        textPalette: z.ZodString;
+        accent: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>]>;
+        shadow: z.ZodBoolean;
+    }, z.core.$strip>>;
+    palettes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        from: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>]>;
+        to: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>]>;
+    }, z.core.$strip>>;
+    themeNames: z.ZodArray<z.ZodString>;
+    paletteNames: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, undefined>;
 //# sourceMappingURL=pixoo-themes.resource.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pixoo-themes.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-themes.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,mBAAmB,2GA0C9B,CAAC"}
+{"version":3,"file":"pixoo-themes.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-themes.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAmBrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;6BAyF9B,CAAC"}

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

@@ -4,12 +4,69 @@
  */
 import { resource, z } from '@cyanheads/mcp-ts-core';
 import { PALETTE_NAMES, PALETTES, THEME_NAMES, THEMES } from '../../../renderer/themes.js';
+/** Mirrors the toolkit's `ColorLike` union: hex/named string, packed integer, or RGB triple. */
+const ColorValueSchema = z
+    .union([
+    z.string().describe('CSS hex string (#RRGGBB) or a named color.'),
+    z.number().describe('Packed 24-bit RGB integer.'),
+    z
+        .tuple([
+        z.number().describe('Red channel 0–255.'),
+        z.number().describe('Green channel 0–255.'),
+        z.number().describe('Blue channel 0–255.'),
+    ])
+        .readonly()
+        .describe('Explicit RGB channel triple.'),
+])
+    .describe('A resolvable color value.');
 export const pixooThemesResource = resource('pixoo://reference/themes', {
     name: 'themes',
     title: 'Pixoo Themes & Palettes',
     description: 'Theme and palette registry with background gradients, default text palettes, accent colors, and swatch values. Use theme names in pixoo_display_text and pixoo_compose_scene.',
     mimeType: 'application/json',
     params: z.object({}),
+    // Compile-time constants — safe for a shared cache to hold for a day.
+    cacheHint: { ttlMs: 86_400_000, cacheScope: 'public' },
+    output: z.object({
+        themes: z
+            .array(z
+            .object({
+            name: z.string().describe('Theme name, usable as the `theme` argument.'),
+            background: z
+                .discriminatedUnion('type', [
+                z
+                    .object({
+                    type: z.literal('gradient-v').describe('Vertical gradient background.'),
+                    from: ColorValueSchema.describe('Gradient start color (top).'),
+                    to: ColorValueSchema.describe('Gradient end color (bottom).'),
+                })
+                    .describe('Vertical gradient background.'),
+                z
+                    .object({
+                    type: z.literal('solid').describe('Solid fill background.'),
+                    color: ColorValueSchema.describe('Fill color.'),
+                })
+                    .describe('Solid background.'),
+            ])
+                .describe('Background fill applied by the theme.'),
+            textPalette: z.string().describe('Default text palette name for this theme.'),
+            accent: ColorValueSchema.describe('Accent color for icons and highlights.'),
+            shadow: z.boolean().describe('True when the theme enables a text drop shadow.'),
+        })
+            .describe('A named scene theme.'))
+            .describe('All registered themes with background, palette, and accent settings.'),
+        palettes: z
+            .array(z
+            .object({
+            name: z.string().describe('Palette name, usable as the `palette` argument.'),
+            from: ColorValueSchema.describe('Ramp start color (top).'),
+            to: ColorValueSchema.describe('Ramp end color (bottom).'),
+        })
+            .describe('A named vertical color ramp.'))
+            .describe('All registered palettes as gradient stop pairs.'),
+        themeNames: z.array(z.string()).describe('Theme names in registry order.'),
+        paletteNames: z.array(z.string()).describe('Palette names in registry order.'),
+    }),
     handler(_params, _ctx) {
         const themes = Object.entries(THEMES).map(([name, def]) => ({
             name,

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

@@ -1 +1 @@
-{"version":3,"file":"pixoo-themes.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-themes.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,0BAA0B,EAAE;IACtE,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,+KAA+K;IACjL,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAEpB,OAAO,CAAC,OAAO,EAAE,IAAI;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI;YACJ,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/D,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,MAAM;YACN,QAAQ;YACR,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,aAAa;SAC5B,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,0BAA0B;gBAC/B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EACT,iFAAiF;aACpF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"pixoo-themes.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/pixoo-themes.resource.ts"],"names":[],"mappings":"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"}

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

@@ -8,22 +8,22 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     background: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         gradient: z.ZodObject<{
             type: z.ZodEnum<{
-                v: "v";
                 h: "h";
                 r: "r";
+                v: "v";
             }>;
             from: z.ZodString;
             to: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         theme: z.ZodEnum<{
+            claude: "claude";
             ember: "ember";
+            forest: "forest";
             ice: "ice";
-            neon: "neon";
-            claude: "claude";
-            mono: "mono";
             midnight: "midnight";
-            forest: "forest";
+            mono: "mono";
+            neon: "neon";
         }>;
     }, z.core.$strip>]>;
     elements: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -34,14 +34,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -51,29 +51,29 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         type: z.ZodLiteral<"text">;
         text: z.ZodString;
         x: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
-            left: "left";
             center: "center";
+            left: "left";
             right: "right";
         }>]>>;
         y: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
+            bottom: "bottom";
             center: "center";
             top: "top";
-            bottom: "bottom";
         }>]>>;
         color: z.ZodOptional<z.ZodString>;
         font: z.ZodOptional<z.ZodEnum<{
-            standard: "standard";
             compact: "compact";
+            standard: "standard";
         }>>;
         style: z.ZodOptional<z.ZodObject<{
             palette: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                claude: "claude";
                 ember: "ember";
-                ice: "ice";
-                neon: "neon";
                 fire: "fire";
+                ice: "ice";
                 lavender: "lavender";
-                claude: "claude";
                 mono: "mono";
+                neon: "neon";
             }>, z.ZodObject<{
                 from: z.ZodString;
                 to: z.ZodString;
@@ -91,14 +91,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -110,26 +110,26 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         d: z.ZodOptional<z.ZodString>;
         viewBox: z.ZodOptional<z.ZodString>;
         x: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
-            left: "left";
             center: "center";
+            left: "left";
             right: "right";
         }>]>>;
         y: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
+            bottom: "bottom";
             center: "center";
             top: "top";
-            bottom: "bottom";
         }>]>>;
         w: z.ZodOptional<z.ZodNumber>;
         h: z.ZodOptional<z.ZodNumber>;
         color: z.ZodOptional<z.ZodString>;
         palette: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
             ember: "ember";
-            ice: "ice";
-            neon: "neon";
             fire: "fire";
+            ice: "ice";
             lavender: "lavender";
-            claude: "claude";
             mono: "mono";
+            neon: "neon";
         }>>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
@@ -139,14 +139,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -161,8 +161,8 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         color: z.ZodOptional<z.ZodString>;
         gradient: z.ZodOptional<z.ZodObject<{
             type: z.ZodEnum<{
-                v: "v";
                 h: "h";
+                v: "v";
             }>;
             from: z.ZodString;
             to: z.ZodString;
@@ -176,14 +176,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -204,14 +204,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -232,14 +232,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -254,13 +254,13 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         value: z.ZodNumber;
         max: z.ZodNumber;
         palette: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
             ember: "ember";
-            ice: "ice";
-            neon: "neon";
             fire: "fire";
+            ice: "ice";
             lavender: "lavender";
-            claude: "claude";
             mono: "mono";
+            neon: "neon";
         }>>;
         trackColor: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
@@ -272,14 +272,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -294,8 +294,8 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         data: z.ZodArray<z.ZodNumber>;
         color: z.ZodOptional<z.ZodString>;
         kind: z.ZodOptional<z.ZodEnum<{
-            line: "line";
             bar: "bar";
+            line: "line";
         }>>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
@@ -305,14 +305,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -332,14 +332,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -360,14 +360,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -381,14 +381,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         w: z.ZodOptional<z.ZodNumber>;
         h: z.ZodOptional<z.ZodNumber>;
         fit: z.ZodOptional<z.ZodEnum<{
-            fill: "fill";
             contain: "contain";
             cover: "cover";
+            fill: "fill";
         }>>;
         kernel: z.ZodOptional<z.ZodEnum<{
-            nearest: "nearest";
             lanczos3: "lanczos3";
             mitchell: "mitchell";
+            nearest: "nearest";
         }>>;
     }, z.core.$strip>, z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
@@ -398,14 +398,14 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         effect: z.ZodOptional<z.ZodObject<{
             name: z.ZodEnum<{
                 blink: "blink";
+                drift: "drift";
+                "fade-in": "fade-in";
+                "fade-out": "fade-out";
                 float: "float";
+                pulse: "pulse";
                 "scroll-left": "scroll-left";
                 "scroll-right": "scroll-right";
-                pulse: "pulse";
                 twinkle: "twinkle";
-                drift: "drift";
-                "fade-in": "fade-in";
-                "fade-out": "fade-out";
             }>;
             amplitude: z.ZodOptional<z.ZodNumber>;
             period: z.ZodOptional<z.ZodNumber>;
@@ -417,8 +417,8 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         cols: z.ZodNumber;
         rows: z.ZodNumber;
         x: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
-            left: "left";
             center: "center";
+            left: "left";
             right: "right";
         }>]>>;
         y: z.ZodOptional<z.ZodNumber>;
@@ -432,10 +432,6 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     output: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     pushed: z.ZodBoolean;
-    previewData: z.ZodOptional<z.ZodString>;
-    previewMimeType: z.ZodOptional<z.ZodEnum<{
-        "image/png": "image/png";
-    }>>;
     frames: z.ZodNumber;
     layout: z.ZodArray<z.ZodObject<{
         element: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"background">]>;
@@ -448,16 +444,16 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
         }, z.core.$strip>;
         fits: z.ZodBoolean;
         action: z.ZodEnum<{
+            clipped: "clipped";
             none: "none";
-            "shrunk-to-compact": "shrunk-to-compact";
             scrolling: "scrolling";
-            wrapped: "wrapped";
+            "shrunk-to-compact": "shrunk-to-compact";
             truncated: "truncated";
-            clipped: "clipped";
+            wrapped: "wrapped";
         }>;
         font: z.ZodOptional<z.ZodEnum<{
-            standard: "standard";
             compact: "compact";
+            standard: "standard";
         }>>;
         scale: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -500,6 +496,11 @@ export declare const pixooComposeScene: import("@cyanheads/mcp-ts-core").ToolDef
     readonly code: JsonRpcErrorCode.InvalidParams;
     readonly when: "Icon name not found in the registry.";
     readonly recovery: "Check pixoo://reference/icons for available icon names and categories.";
+}, {
+    readonly reason: "invalid_output_path";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The output path is relative or contains traversal segments.";
+    readonly recovery: "Pass an absolute, already-normalized path (for example /tmp/scene.png), or omit output to use PIXOO_OUTPUT_DIR.";
 }], {
     readonly notice: z.ZodOptional<z.ZodString>;
 }>;

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,EAAiB,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAmT1F,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwS5B,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;AAmT3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiT5B,CAAC"}