@pebbly/aseprite-ai-artist 0.1.0

package/dist/tools/look.js

@@ -0,0 +1,215 @@
+import { readFile, unlink } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { z } from "zod";
+import { filmstripLayout, renderAscii, renderDiff, } from "../lib/render.js";
+import { fail, ok, okWithImage, targetShape } from "./kit.js";
+/**
+ * The "see your own work" tool. Drawing without looking is how an agent ends up
+ * confidently reporting a finished sprite that is a smear of misplaced pixels.
+ */
+export function registerLookTools(server, live) {
+    server.registerTool("look", {
+        title: "Look at the sprite",
+        description: "See what is actually on the canvas. Ops:\n" +
+            "• 'preview' — a nearest-neighbour upscaled PNG of the active frame (~1024px long edge). Use for overall read: silhouette, colour, whether it looks like the thing.\n" +
+            "• 'ascii' — an exact text grid, one glyph per pixel with a colour legend and coordinate rulers. Use to verify precise pixel positions and values, to count cells, or on any client without vision. Capped at 64×64; pass a region to crop.\n" +
+            "• 'filmstrip' — every frame composited into one image. The only reliable way to review an animation, since a vision model reads just the first frame of a GIF.\n" +
+            "• 'diff' — a pixel-level text diff between two frames: '.' unchanged, '-' erased, glyph = the new colour. Use it to confirm exactly what an edit touched.\n" +
+            "Draw, then look, then fix. Do not report a sprite finished without looking at it.",
+        inputSchema: {
+            op: z.enum(["preview", "ascii", "filmstrip", "diff"]).default("preview"),
+            sprite: targetShape.sprite,
+            frame: targetShape.frame,
+            fromFrame: z.number().int().positive().optional().describe("Diff: the earlier frame."),
+            toFrame: z.number().int().positive().optional().describe("Diff: the later frame."),
+            region: z
+                .object({
+                x: z.number().int(),
+                y: z.number().int(),
+                width: z.number().int().positive(),
+                height: z.number().int().positive(),
+            })
+                .optional()
+                .describe("Crop. Required for 'ascii' on sprites larger than 64×64."),
+            layer: z
+                .string()
+                .optional()
+                .describe("Read a single layer instead of the composited image."),
+            scale: z
+                .number()
+                .int()
+                .positive()
+                .max(128)
+                .optional()
+                .describe("Integer upscale for image ops, 1-128 (clamped so the output stays under ~2048px). Omit it — the automatic choice targets a ~1024px long edge, which is what a vision model can actually read."),
+        },
+        outputSchema: {
+            op: z.string(),
+            sprite: z.string(),
+            width: z.number().int(),
+            height: z.number().int(),
+            scale: z.number().int().optional(),
+            text: z.string().optional().describe("The grid, for 'ascii' and 'diff'."),
+            legend: z.record(z.string()).optional().describe("glyph → #rrggbb."),
+            changedPixels: z.number().int().optional(),
+            totalPixels: z.number().int().optional(),
+            frames: z.number().int().optional(),
+            columns: z.number().int().optional(),
+            rows: z.number().int().optional(),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            switch (args.op) {
+                case "ascii": {
+                    const region = await readRegion(live, args);
+                    const view = renderAscii(region);
+                    return ok({
+                        op: "ascii",
+                        sprite: region.spriteName,
+                        width: view.width,
+                        height: view.height,
+                        text: view.text,
+                        legend: view.legend,
+                    }, `${view.width}×${view.height} at (${view.originX},${view.originY})\n\n${view.text}\n\nLegend: ${formatLegend(view.legend)}\n'.' = transparent`);
+                }
+                case "diff": {
+                    const from = args.fromFrame ?? 1;
+                    const to = args.toFrame ?? from + 1;
+                    const [before, after] = await Promise.all([
+                        readRegion(live, { ...args, frame: from }),
+                        readRegion(live, { ...args, frame: to }),
+                    ]);
+                    const view = renderDiff(before, after);
+                    return ok({
+                        op: "diff",
+                        sprite: before.spriteName,
+                        width: before.width,
+                        height: before.height,
+                        text: view.text,
+                        legend: view.legend,
+                        changedPixels: view.changed,
+                        totalPixels: view.total,
+                    }, `Frame ${from} → ${to}: ${view.changed} of ${view.total} pixels changed.\n\n${view.text}\n\nLegend: ${formatLegend(view.legend)}\n'.' unchanged  '-' erased`);
+                }
+                case "filmstrip": {
+                    const out = tempPng("filmstrip");
+                    const meta = await live.call("look.filmstrip", {
+                        sprite: args.sprite,
+                        path: out,
+                        scale: args.scale,
+                    });
+                    const layout = filmstripLayout(meta.frames);
+                    const image = await readAndClean(out);
+                    return okWithImage({
+                        op: "filmstrip",
+                        sprite: meta.sprite,
+                        width: meta.width,
+                        height: meta.height,
+                        scale: meta.scale,
+                        frames: meta.frames,
+                        columns: layout.cols,
+                        rows: layout.rows,
+                    }, image, `Filmstrip of ${meta.frames} frame(s), ${layout.cols}×${layout.rows} grid, ${meta.scale}× upscale. Read left to right, top to bottom; check timing and cross-frame volume drift.`);
+                }
+                default: {
+                    const out = tempPng("preview");
+                    const meta = await live.call("look.preview", {
+                        sprite: args.sprite,
+                        frame: args.frame,
+                        layer: args.layer,
+                        region: args.region,
+                        path: out,
+                        // Omitted scale means the extension picks one from the sprite size.
+                        scale: args.scale,
+                    });
+                    const image = await readAndClean(out);
+                    return okWithImage({
+                        op: "preview",
+                        sprite: meta.sprite,
+                        width: meta.sourceWidth,
+                        height: meta.sourceHeight,
+                        scale: meta.scale,
+                    }, image, `${meta.sprite} — ${meta.sourceWidth}×${meta.sourceHeight} shown at ${meta.scale}×. For exact pixel values use op 'ascii'.`);
+                }
+            }
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("read_pixels", {
+        title: "Read pixels",
+        description: "Read a rectangular region as structured data: a list of distinct colours plus a row-major index grid. Use this when you need to compute over pixels (sample a palette from art, find a silhouette edge, copy a region) rather than just look at them. For eyeballing, 'look' is cheaper.",
+        inputSchema: {
+            ...targetShape,
+            region: z
+                .object({
+                x: z.number().int(),
+                y: z.number().int(),
+                width: z.number().int().positive(),
+                height: z.number().int().positive(),
+            })
+                .optional()
+                .describe("Omit to read the whole canvas."),
+            composite: z
+                .boolean()
+                .default(true)
+                .describe("Read the flattened image. False reads only the target layer's cel."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            x: z.number().int(),
+            y: z.number().int(),
+            width: z.number().int(),
+            height: z.number().int(),
+            colors: z.array(z.string()).describe("Distinct colours; index 0 is fully transparent."),
+            grid: z.array(z.number().int()).describe("Row-major indices into `colors`."),
+            uniqueColors: z.number().int(),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const region = await readRegion(live, args);
+            return ok({
+                sprite: region.spriteName,
+                x: region.x,
+                y: region.y,
+                width: region.width,
+                height: region.height,
+                colors: region.colors,
+                grid: region.grid,
+                uniqueColors: Math.max(0, region.colors.length - 1),
+            }, `${region.width}×${region.height} region, ${Math.max(0, region.colors.length - 1)} distinct colour(s).`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+async function readRegion(live, args) {
+    const data = await live.call("pixels.read", {
+        sprite: args.sprite,
+        layer: args.layer,
+        frame: args.frame,
+        region: args.region,
+        composite: args.composite ?? true,
+    });
+    return { ...data, spriteName: data.sprite };
+}
+function tempPng(prefix) {
+    return path.join(tmpdir(), `aseprite-ai-artist-${prefix}-${Date.now()}-${process.pid}.png`);
+}
+async function readAndClean(file) {
+    const buf = await readFile(file);
+    await unlink(file).catch(() => { });
+    return { data: buf.toString("base64"), mimeType: "image/png" };
+}
+function formatLegend(legend) {
+    const entries = Object.entries(legend);
+    if (entries.length === 0)
+        return "(empty)";
+    return entries.map(([g, hex]) => `${g}=${hex}`).join("  ");
+}
+//# sourceMappingURL=look.js.map

package/dist/tools/look.js.map

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

package/dist/tools/palette.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiveClient } from "../bridge/client.js";
+export declare function registerPaletteTools(server: McpServer, live: LiveClient): void;

package/dist/tools/palette.js

@@ -0,0 +1,232 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { z } from "zod";
+import { buildRamp, contrastRatio, parseHex, snapToPalette } from "../lib/color.js";
+import { fail, hexColor, ok, targetShape } from "./kit.js";
+let presetCache = null;
+function presets() {
+    if (presetCache)
+        return presetCache;
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // dist/tools/palette.js → package root
+    const file = path.resolve(here, "..", "..", "knowledge", "palettes.json");
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    presetCache = parsed.presets;
+    return presetCache;
+}
+export function registerPaletteTools(server, live) {
+    server.registerTool("palette", {
+        title: "Palette",
+        description: "Read and shape the sprite's palette. Ops:\n" +
+            "• 'get' — current palette with per-colour usage counts.\n" +
+            "• 'set' — write specific indices, or replace the palette wholesale.\n" +
+            "• 'preset' — load a bundled palette (pico8, gameboy, gameboy-pocket, cga, 1bit, grayscale-8).\n" +
+            "• 'load' — read a .gpl/.hex/.pal/.png palette file from disk.\n" +
+            "• 'ramp' — generate a hue-shifted ramp from a base colour and append it. Shadows rotate toward blue, highlights toward orange; a ramp that only changes brightness is the clearest tell of machine-made pixel art.\n" +
+            "• 'analyze' — report ramp structure, contrast, near-duplicate entries and colours used in the art that are not in the palette.\n" +
+            "Decide the palette before drawing. Retro-fitting one onto finished art means repainting.",
+        inputSchema: {
+            op: z.enum(["get", "set", "preset", "load", "ramp", "analyze"]),
+            sprite: targetShape.sprite,
+            preset: z.string().optional().describe("Preset key for op 'preset'."),
+            path: z.string().optional().describe("Palette file for op 'load'."),
+            colors: z
+                .array(hexColor)
+                .optional()
+                .describe("For op 'set': the colours to write."),
+            startIndex: z
+                .number()
+                .int()
+                .min(0)
+                .default(0)
+                .describe("For op 'set': where `colors` starts. Ignored when `replace` is true."),
+            replace: z
+                .boolean()
+                .default(false)
+                .describe("For op 'set'/'preset': replace the whole palette instead of merging."),
+            base: hexColor.optional().describe("Base colour for op 'ramp'."),
+            steps: z.number().int().min(2).max(16).default(5).describe("Ramp length."),
+            spread: z
+                .number()
+                .min(0.1)
+                .max(1)
+                .default(0.55)
+                .describe("How far the ramp reaches into shadow and light."),
+            remapArt: z
+                .boolean()
+                .default(false)
+                .describe("When replacing a palette, repaint existing pixels to the nearest new colour instead of leaving them off-palette."),
+        },
+        outputSchema: {
+            op: z.string(),
+            sprite: z.string().optional(),
+            colors: z.array(z.string()).optional(),
+            size: z.number().int().optional(),
+            path: z.string().optional().describe("Palette file read by op 'load'."),
+            usage: z
+                .array(z.object({ index: z.number().int(), hex: z.string(), pixels: z.number().int() }))
+                .optional(),
+            ramp: z.array(z.string()).optional(),
+            analysis: z
+                .object({
+                size: z.number().int(),
+                unusedIndices: z.array(z.number().int()),
+                nearDuplicates: z.array(z.object({ a: z.string(), b: z.string(), deltaE: z.number() })),
+                offPaletteColors: z.array(z.object({ hex: z.string(), pixels: z.number().int() })),
+                lowestContrastPair: z
+                    .object({ a: z.string(), b: z.string(), ratio: z.number() })
+                    .nullish(),
+                verdict: z.string(),
+            })
+                .optional(),
+            availablePresets: z
+                .array(z.object({ key: z.string(), name: z.string(), size: z.number().int(), notes: z.string() }))
+                .optional(),
+        },
+        annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
+    }, async (args) => {
+        try {
+            switch (args.op) {
+                case "ramp": {
+                    if (!args.base)
+                        return fail(new Error("op 'ramp' needs a `base` colour."));
+                    const ramp = buildRamp(parseHex(args.base), args.steps, args.spread);
+                    const data = await live.call("palette.set", {
+                        sprite: args.sprite,
+                        colors: ramp,
+                        append: true,
+                    });
+                    return ok({ op: "ramp", ramp, ...data }, `Appended a ${args.steps}-step hue-shifted ramp from ${args.base}: ${ramp.join(" ")}`);
+                }
+                case "preset": {
+                    const key = (args.preset ?? "").toLowerCase();
+                    const table = presets();
+                    const chosen = table[key];
+                    if (!chosen) {
+                        return ok({
+                            op: "preset",
+                            availablePresets: Object.entries(table).map(([k, p]) => ({
+                                key: k,
+                                name: p.name,
+                                size: p.size,
+                                notes: p.notes,
+                            })),
+                        }, `Unknown preset '${args.preset ?? ""}'. Available: ${Object.keys(table).join(", ")}. Any other palette can be loaded from a file with op 'load'.`);
+                    }
+                    const data = await live.call("palette.set", {
+                        sprite: args.sprite,
+                        colors: chosen.colors,
+                        replace: args.replace !== false,
+                        remapArt: args.remapArt,
+                    });
+                    return ok({ op: "preset", colors: chosen.colors, size: chosen.colors.length, ...data }, `Loaded ${chosen.name} (${chosen.colors.length} colours). ${chosen.notes}`);
+                }
+                case "load": {
+                    if (!args.path)
+                        return fail(new Error("op 'load' needs a `path`."));
+                    const data = await live.call("palette.load", {
+                        sprite: args.sprite,
+                        path: args.path,
+                        replace: args.replace,
+                        remapArt: args.remapArt,
+                    });
+                    return ok({ op: "load", ...data });
+                }
+                case "set": {
+                    if (!args.colors || args.colors.length === 0) {
+                        return fail(new Error("op 'set' needs at least one colour."));
+                    }
+                    const data = await live.call("palette.set", {
+                        sprite: args.sprite,
+                        colors: args.colors,
+                        startIndex: args.startIndex,
+                        replace: args.replace,
+                        remapArt: args.remapArt,
+                    });
+                    return ok({ op: "set", ...data });
+                }
+                case "analyze": {
+                    const state = await live.call("palette.stats", { sprite: args.sprite });
+                    return ok({ op: "analyze", sprite: state.sprite, colors: state.colors, analysis: analyze(state) }, describeAnalysis(analyze(state)));
+                }
+                default: {
+                    const data = await live.call("palette.get", {
+                        sprite: args.sprite,
+                    });
+                    const colors = data.colors ?? [];
+                    return ok({ op: "get", ...data }, `${colors.length} colours: ${colors.join(" ")}`);
+                }
+            }
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+function analyze(state) {
+    const unusedIndices = state.usage.filter((u) => u.pixels === 0).map((u) => u.index);
+    const nearDuplicates = [];
+    for (let i = 0; i < state.colors.length; i++) {
+        const a = state.colors[i];
+        if (!a)
+            continue;
+        // Only compare forward, and only against the rest of the palette.
+        const rest = state.colors.slice(i + 1);
+        if (rest.length === 0)
+            continue;
+        const snap = snapToPalette(parseHex(a), rest);
+        if (snap.distance < 3) {
+            nearDuplicates.push({ a, b: snap.hex, deltaE: round(snap.distance) });
+        }
+    }
+    let lowestContrastPair = null;
+    const used = state.usage.filter((u) => u.pixels > 0).slice(0, 32);
+    for (let i = 0; i < used.length; i++) {
+        for (let j = i + 1; j < used.length; j++) {
+            const a = used[i];
+            const b = used[j];
+            const ratio = contrastRatio(parseHex(a.hex), parseHex(b.hex));
+            if (!lowestContrastPair || ratio < lowestContrastPair.ratio) {
+                lowestContrastPair = { a: a.hex, b: b.hex, ratio: round(ratio) };
+            }
+        }
+    }
+    const problems = [];
+    if (state.offPalette.length > 0) {
+        problems.push(`${state.offPalette.length} colour(s) in the art are not in the palette`);
+    }
+    if (nearDuplicates.length > 0) {
+        problems.push(`${nearDuplicates.length} near-duplicate palette entr(ies) (ΔE < 3)`);
+    }
+    if (state.colors.length > 64) {
+        problems.push(`${state.colors.length} colours is large for pixel art; most sprites read better under 32`);
+    }
+    return {
+        size: state.colors.length,
+        unusedIndices,
+        nearDuplicates,
+        offPaletteColors: state.offPalette,
+        lowestContrastPair,
+        verdict: problems.length === 0 ? "clean" : problems.join("; "),
+    };
+}
+function describeAnalysis(a) {
+    const lines = [`Palette: ${a.size} colours — ${a.verdict}.`];
+    if (a.offPaletteColors.length > 0) {
+        lines.push(`Off-palette: ${a.offPaletteColors
+            .slice(0, 8)
+            .map((c) => `${c.hex} (${c.pixels}px)`)
+            .join(", ")}. Use recolor op 'snap' to bring them in line.`);
+    }
+    if (a.nearDuplicates.length > 0) {
+        lines.push(`Near-duplicates: ${a.nearDuplicates.slice(0, 5).map((d) => `${d.a}≈${d.b}`).join(", ")}. Merging them makes ramps read more clearly.`);
+    }
+    if (a.unusedIndices.length > 0)
+        lines.push(`${a.unusedIndices.length} palette slot(s) unused.`);
+    return lines.join(" ");
+}
+function round(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=palette.js.map

package/dist/tools/palette.js.map

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

package/dist/tools/session.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiveClient } from "../bridge/client.js";
+export declare function registerSessionTools(server: McpServer, live: LiveClient): void;