@pebbly/aseprite-ai-artist 0.1.0

package/dist/lib/skills.js

@@ -0,0 +1,112 @@
+/**
+ * Skills, served over MCP.
+ *
+ * Claude Code reads `skills/` out of the plugin directory directly. Codex,
+ * Gemini CLI and Cursor have no such concept — so without this, everyone except
+ * Claude Code gets raw tools and none of the craft that makes the tools produce
+ * decent sprites. Serving the same markdown as MCP resources *and* MCP prompts
+ * closes that gap with one source of truth on disk.
+ *
+ * Resources are the discovery surface (an agent can list and read them at will);
+ * prompts are the invocation surface (they show up as slash commands in clients
+ * that render them). Both point at the same file.
+ *
+ * Tracks the Skills Extension direction of the MCP Skills-over-MCP WG
+ * (SEP-2640, resources-based). When that lands in the SDK the transport here
+ * becomes the standard one; the on-disk format does not change.
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import path from "node:path";
+export function loadSkills(root) {
+    const dir = path.join(root, "skills");
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        const skillDir = path.join(dir, entry);
+        if (!statSync(skillDir).isDirectory())
+            continue;
+        const file = path.join(skillDir, "SKILL.md");
+        if (!existsSync(file))
+            continue;
+        const raw = readFileSync(file, "utf8");
+        const { frontmatter, body } = splitFrontmatter(raw);
+        out.push({
+            name: frontmatter.name ?? entry,
+            title: frontmatter.title ?? frontmatter.name ?? entry,
+            description: frontmatter.description ?? "",
+            body,
+            file,
+            assets: readdirSync(skillDir)
+                .filter((f) => f !== "SKILL.md" && statSync(path.join(skillDir, f)).isFile())
+                .map((f) => path.join(skillDir, f)),
+        });
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function loadRules(root) {
+    const dir = path.join(root, "rules");
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith(".md") && f !== "README.md")
+        .sort()
+        .map((f) => {
+        const file = path.join(dir, f);
+        const body = readFileSync(file, "utf8");
+        const name = f.replace(/\.md$/, "");
+        const heading = /^#\s+(.+)$/m.exec(body);
+        return { name, title: heading?.[1] ?? name, body, file };
+    });
+}
+/**
+ * Deliberately minimal YAML handling: skill frontmatter is flat `key: value`
+ * with optional quotes. Pulling in a YAML parser to read six keys would add a
+ * dependency to a package whose whole distribution pitch is `npx`, no install.
+ */
+function splitFrontmatter(raw) {
+    if (!raw.startsWith("---"))
+        return { frontmatter: {}, body: raw };
+    const end = raw.indexOf("\n---", 3);
+    if (end === -1)
+        return { frontmatter: {}, body: raw };
+    const header = raw.slice(3, end);
+    const body = raw.slice(end + 4).replace(/^\r?\n/, "");
+    const frontmatter = {};
+    for (const line of header.split(/\r?\n/)) {
+        const m = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line.trim());
+        if (!m || !m[1])
+            continue;
+        let value = (m[2] ?? "").trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        frontmatter[m[1]] = value;
+    }
+    return { frontmatter, body };
+}
+/**
+ * The server's `instructions` string — the one piece of guidance every MCP
+ * client sees, whether or not it understands skills or plugins. Keep it short:
+ * it is paid for on every session, so it carries only the rules an agent gets
+ * wrong catastrophically, and points at the skills for everything else.
+ */
+export function serverInstructions(skills) {
+    const catalogue = skills.map((s) => `  - ${s.name}: ${s.description}`).join("\n");
+    return `Aseprite AI Artist — draw pixel art in the user's OPEN Aseprite window.
+
+Non-negotiables:
+1. Call \`preflight\` before anything else. If ready is false, stop and tell the user. Never fall back to editing .aseprite/.png files on disk — the user would not see those changes and a later save would overwrite them.
+2. Call \`sprite_info\` before your first edit. Layer names, frame count and palette must come from the document, never from assumption.
+3. Batch. One \`draw\` call carrying every op is right; forty calls carrying one op each is wrong. Each call is one undo step for the user.
+4. Look at your work. After drawing, call \`look\` (op 'preview' to judge the read, op 'ascii' to verify exact pixels). Do not report a sprite finished without looking at it.
+5. Keep the palette. \`draw\` and \`recolor\` snap to the sprite's palette by default. If a colour you want is far from every palette entry, say so and ask before widening the palette.
+6. Run \`validate\` before declaring done.
+
+Craft rules live in the \`rules://\` resources (read \`rules://index\` first). Workflows live in the \`skill://\` resources and as prompts:
+${catalogue}
+
+Read the skill that matches the task before starting it.`;
+}
+//# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

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

package/dist/lib/version.d.ts

@@ -0,0 +1,4 @@
+/** Package version, read once from package.json so it cannot drift from npm. */
+export declare function packageVersion(): string;
+/** Root of the installed package, used to find bundled skills, rules and the extension. */
+export declare function packageRoot(): string;

package/dist/lib/version.js

@@ -0,0 +1,25 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+let cached = null;
+/** Package version, read once from package.json so it cannot drift from npm. */
+export function packageVersion() {
+    if (cached)
+        return cached;
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        const file = path.resolve(here, "..", "..", "package.json");
+        const pkg = JSON.parse(readFileSync(file, "utf8"));
+        cached = pkg.version ?? "0.0.0";
+    }
+    catch {
+        cached = "0.0.0";
+    }
+    return cached;
+}
+/** Root of the installed package, used to find bundled skills, rules and the extension. */
+export function packageRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "..");
+}
+//# sourceMappingURL=version.js.map

package/dist/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,gFAAgF;AAChF,MAAM,UAAU,cAAc;IAC5B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC3E,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LiveClient } from "./bridge/client.js";
+export interface CreateServerOptions {
+    controlPort?: number;
+    pluginPort?: number;
+    /** Enables the run_lua escape hatch. Off unless the operator opts in. */
+    allowLua?: boolean;
+    autoSpawnBridge?: boolean;
+    root?: string;
+}
+export interface RunningServer {
+    server: McpServer;
+    live: LiveClient;
+}
+export declare function createServer(opts?: CreateServerOptions): RunningServer;

package/dist/server.js

@@ -0,0 +1,144 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LiveClient } from "./bridge/client.js";
+import { loadRules, loadSkills, serverInstructions } from "./lib/skills.js";
+import { packageRoot, packageVersion } from "./lib/version.js";
+import { registerAssetTools } from "./tools/assets.js";
+import { registerCraftTools } from "./tools/craft.js";
+import { registerDrawTools } from "./tools/draw.js";
+import { registerEscapeTools } from "./tools/escape.js";
+import { registerLookTools } from "./tools/look.js";
+import { registerPaletteTools } from "./tools/palette.js";
+import { registerSessionTools } from "./tools/session.js";
+import { registerStructureTools } from "./tools/structure.js";
+export function createServer(opts = {}) {
+    const root = opts.root ?? packageRoot();
+    const skills = loadSkills(root);
+    const rules = loadRules(root);
+    const live = new LiveClient({
+        controlPort: opts.controlPort,
+        pluginPort: opts.pluginPort,
+        autoSpawnBridge: opts.autoSpawnBridge ?? true,
+        // stderr is the only channel that will not corrupt a stdio MCP session.
+        log: (msg) => process.stderr.write(`[aseprite-ai-artist] ${msg}\n`),
+    });
+    const server = new McpServer({
+        name: "aseprite-ai-artist",
+        version: packageVersion(),
+        title: "Aseprite AI Artist",
+    }, {
+        // Capabilities are left to the SDK to infer from what actually gets
+        // registered. Declaring `prompts` by hand while no prompt exists
+        // advertises a method that then answers -32601 Method not found.
+        instructions: serverInstructions(skills),
+    });
+    registerSessionTools(server, live);
+    registerLookTools(server, live);
+    registerDrawTools(server, live);
+    registerStructureTools(server, live);
+    registerPaletteTools(server, live);
+    registerCraftTools(server, live);
+    registerAssetTools(server, live);
+    registerEscapeTools(server, live, opts.allowLua ?? false);
+    registerSkillSurface(server, root, skills, rules);
+    return { server, live };
+}
+function registerSkillSurface(server, root, skills, rules) {
+    // ── rules ────────────────────────────────────────────────────────────────
+    server.registerResource("pixel-art-rules-index", "rules://index", {
+        title: "Pixel-art rulebook — index",
+        description: "The craft rules this server encodes: palette, shading, silhouette, animation, layer rigging and the review checklist. Read this before your first sprite in a session.",
+        mimeType: "text/markdown",
+    }, async () => ({
+        contents: [
+            {
+                uri: "rules://index",
+                mimeType: "text/markdown",
+                text: `# Pixel-art rulebook\n\n` +
+                    rules.map((r) => `- \`rules://${r.name}\` — ${r.title}`).join("\n") +
+                    `\n\nRead the rule that covers what you are about to do. These are the difference between a sprite that reads and one that looks generated.\n`,
+            },
+        ],
+    }));
+    server.registerResource("pixel-art-rule", new ResourceTemplate("rules://{name}", {
+        list: async () => ({
+            resources: rules.map((r) => ({
+                uri: `rules://${r.name}`,
+                name: r.name,
+                title: r.title,
+                mimeType: "text/markdown",
+            })),
+        }),
+    }), {
+        title: "Pixel-art rule",
+        description: "One chapter of the pixel-art rulebook.",
+        mimeType: "text/markdown",
+    }, async (uri, variables) => {
+        const name = String(variables.name);
+        const rule = rules.find((r) => r.name === name);
+        if (!rule)
+            throw new Error(`Unknown rule '${name}'. See rules://index.`);
+        return {
+            contents: [{ uri: uri.href, mimeType: "text/markdown", text: rule.body }],
+        };
+    });
+    // ── skills ───────────────────────────────────────────────────────────────
+    // Exposed twice on purpose: as resources so any agent can discover and read
+    // them, and as prompts so clients that render prompts get them as commands.
+    server.registerResource("skill", new ResourceTemplate("skill://{name}", {
+        list: async () => ({
+            resources: skills.map((s) => ({
+                uri: `skill://${s.name}`,
+                name: s.name,
+                title: s.title,
+                description: s.description,
+                mimeType: "text/markdown",
+            })),
+        }),
+    }), {
+        title: "Workflow skill",
+        description: "A step-by-step pixel-art workflow: what to inspect, what order to draw in, and how to check the result.",
+        mimeType: "text/markdown",
+    }, async (uri, variables) => {
+        const name = String(variables.name);
+        const skill = skills.find((s) => s.name === name);
+        if (!skill) {
+            throw new Error(`Unknown skill '${name}'. Available: ${skills.map((s) => s.name).join(", ")}.`);
+        }
+        return {
+            contents: [{ uri: uri.href, mimeType: "text/markdown", text: skill.body }],
+        };
+    });
+    for (const skill of skills) {
+        server.registerPrompt(skill.name, {
+            title: skill.title,
+            description: skill.description,
+            argsSchema: {},
+        }, async () => ({
+            description: skill.description,
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: skill.body },
+                },
+            ],
+        }));
+    }
+    // ── palette knowledge ────────────────────────────────────────────────────
+    server.registerResource("palette-presets", "knowledge://palettes", {
+        title: "Bundled palette presets",
+        description: "Named palettes available to the `palette` tool's 'preset' op, with notes on when each fits.",
+        mimeType: "application/json",
+    }, async () => ({
+        contents: [
+            {
+                uri: "knowledge://palettes",
+                mimeType: "application/json",
+                text: readFileSync(path.join(root, "knowledge", "palettes.json"), "utf8"),
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/assets.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 registerAssetTools(server: McpServer, live: LiveClient): void;

package/dist/tools/assets.js

@@ -0,0 +1,181 @@
+import { z } from "zod";
+import { fail, ok, targetShape } from "./kit.js";
+export function registerAssetTools(server, live) {
+    server.registerTool("reference", {
+        title: "Reference image",
+        description: "Bring an external image into the sprite as a reference layer, so you can trace proportions or sample colours from it. Ops: 'import' (place an image on a locked, semi-transparent layer above the art), 'sample_palette' (read its dominant colours without importing), 'list', 'remove'. " +
+            "Importing at a different size uses nearest-neighbour; a photo scaled down to 32×32 is a starting point for a silhouette, never a finished sprite.",
+        inputSchema: {
+            op: z.enum(["import", "sample_palette", "list", "remove"]),
+            sprite: targetShape.sprite,
+            path: z.string().optional().describe("Image file to read."),
+            name: z.string().optional().describe("Layer name. Default: 'reference'."),
+            x: z.number().int().default(0),
+            y: z.number().int().default(0),
+            fit: z
+                .enum(["none", "contain", "cover", "stretch"])
+                .default("contain")
+                .describe("How to size the image against the canvas."),
+            opacity: z.number().int().min(0).max(255).default(128),
+            colors: z.number().int().min(2).max(64).default(16).describe("For 'sample_palette'."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            op: z.string(),
+            layer: z.string().optional(),
+            width: z.number().int().optional(),
+            height: z.number().int().optional(),
+            palette: z
+                .array(z.object({ hex: z.string(), share: z.number() }))
+                .optional()
+                .describe("Dominant colours with their share of the image."),
+            references: z.array(z.string()).optional(),
+        },
+        annotations: { readOnlyHint: false, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("reference.apply", args);
+            return ok(data);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("export", {
+        title: "Export",
+        description: "Write game-ready files. Ops: 'png' (single frame), 'gif' (animation), 'spritesheet' (packed sheet plus a JSON atlas with per-frame and per-tag data), 'frames' (numbered PNGs), 'aseprite' (save a copy of the source). " +
+            "Spritesheet is what an engine actually consumes: pass `sheetType` and `byTag` to control layout. Exporting does not save the working document — use sprite_manage op 'save' for that.",
+        inputSchema: {
+            op: z.enum(["png", "gif", "spritesheet", "frames", "aseprite"]),
+            sprite: targetShape.sprite,
+            path: z
+                .string()
+                .describe("Output file path. For 'frames', a pattern containing {frame}, e.g. 'walk_{frame}.png' — Aseprite expands it into one file per frame, numbered from 0."),
+            frame: targetShape.frame,
+            scale: z.number().int().min(1).max(16).default(1).describe("Integer upscale, nearest-neighbour."),
+            sheetType: z
+                .enum(["horizontal", "vertical", "rows", "columns", "packed"])
+                .default("horizontal")
+                .describe("Spritesheet layout."),
+            byTag: z.boolean().default(false).describe("Split the sheet by animation tag."),
+            padding: z.number().int().min(0).max(16).default(0).describe("Pixels between frames; prevents bleed at non-integer zoom."),
+            trim: z.boolean().default(false).describe("Trim transparent margins; the atlas keeps the original offsets."),
+            includeJson: z.boolean().default(true).describe("Write a sibling JSON atlas for 'spritesheet'."),
+            layers: z.array(z.string()).optional().describe("Export only these layers."),
+            tags: z.array(z.string()).optional().describe("Export only these tags."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            op: z.string(),
+            files: z.array(z.string()),
+            width: z.number().int().optional(),
+            height: z.number().int().optional(),
+            frameCount: z.number().int().optional(),
+            frame: z.number().int().optional().describe("Which frame a single-frame export wrote. Defaults to the active frame, which is not always the one you drew on."),
+            atlas: z.string().nullish().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("export.run", args);
+            const files = data.files ?? [];
+            return ok(data, `Wrote ${files.length} file(s): ${files.join(", ")}`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("tileset", {
+        title: "Tilesets",
+        description: "Work with Aseprite tilemap layers. Ops:\n" +
+            "• 'list' — tilesets in the sprite.\n" +
+            "• 'create_layer' — a new empty tilemap layer on a given grid.\n" +
+            "• 'get' — tile count and, with a path, the tiles as one packed PNG.\n" +
+            "• 'stamp' — place tiles by grid coordinate. x/y are grid cells, not pixels.\n" +
+            "• 'pack' — turn a hand-painted mockup layer into a tileset plus a tilemap that reconstructs it exactly. Deduplicates identical cells; `tolerance` also merges near-identical ones. The canvas must be a whole number of tiles, and the source layer is hidden rather than deleted so you can compare.\n" +
+            "• 'export' — writes the packed PNG plus the file the engine reads: 'tiled' (.tsj tileset and a .tmj map that uses it), 'godot' (Godot 4 .tres TileSet), or 'json' (tile grid plus the tilemap layout).\n" +
+            "Painting a level by hand and packing it produces better tilesets than authoring tiles in isolation, because you see the whole picture while drawing. " +
+            "`layout: 'blob47'` adds a Tiled wangset for autotiling, and assumes the tileset is authored in canonical blob47 order after the empty tile — it refuses rather than writing a wangset that would autotile wrongly. " +
+            "Requires an extension build advertising the 'tileset' feature — check preflight first.",
+        inputSchema: {
+            op: z.enum(["list", "create_layer", "get", "stamp", "pack", "export"]),
+            ...targetShape,
+            name: z.string().optional(),
+            tileWidth: z.number().int().positive().max(256).default(16),
+            tileHeight: z.number().int().positive().max(256).default(16),
+            tiles: z
+                .array(z.object({ x: z.number().int(), y: z.number().int(), tile: z.number().int().min(0) }))
+                .optional()
+                .describe("For 'stamp'. x/y are tile-grid cells, not pixels."),
+            path: z.string().optional().describe("Output path for 'export' and 'get'."),
+            format: z.enum(["tiled", "godot", "json"]).default("tiled"),
+            layout: z.enum(["grid", "blob47"]).default("grid").describe("Autotile layout for 'export'."),
+            tolerance: z
+                .number()
+                .int()
+                .min(0)
+                .max(255)
+                .default(0)
+                .describe("For 'pack': maximum per-channel difference at which two cells count as the same tile. 0 means exact, which is also much faster — anything above 0 compares every cell against every tile found so far."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            op: z.string(),
+            tilesets: z
+                .array(z.object({ name: z.string(), tileCount: z.number().int(), tileWidth: z.number().int(), tileHeight: z.number().int() }))
+                .optional(),
+            tileCount: z.number().int().optional(),
+            tileWidth: z.number().int().optional(),
+            tileHeight: z.number().int().optional(),
+            columns: z.number().int().optional(),
+            rows: z.number().int().optional(),
+            files: z.array(z.string()).optional(),
+            layer: z.string().optional(),
+            sourceLayer: z.string().optional().describe("For 'pack': the mockup layer, now hidden."),
+            cellCount: z.number().int().optional().describe("For 'pack': grid cells examined."),
+            reusedExact: z.number().int().optional().describe("For 'pack': cells that matched an existing tile exactly."),
+            reusedFuzzy: z.number().int().optional().describe("For 'pack': cells merged by `tolerance`. A high number here with a low tolerance means the mockup has near-duplicate tiles worth cleaning up."),
+            skipped: z.number().int().optional().describe("For 'stamp': placements outside the grid or naming a tile that does not exist."),
+            format: z.string().optional(),
+            layout: z.string().optional(),
+        },
+        annotations: { readOnlyHint: false, openWorldHint: false },
+    }, async (args) => {
+        try {
+            if (!live.hasFeature("tileset")) {
+                return fail(new Error("This Aseprite extension build does not advertise the 'tileset' feature. Update the extension (npx @pebbly/aseprite-ai-artist install-extension) and restart Aseprite."));
+            }
+            const data = await live.call("tileset.apply", args);
+            return ok(data, describeTileset(args.op, data));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+function describeTileset(op, data) {
+    if (op === "pack") {
+        const cells = Number(data.cellCount ?? 0);
+        const tiles = Number(data.tileCount ?? 0);
+        const fuzzy = Number(data.reusedFuzzy ?? 0);
+        const lines = [
+            `${cells} cell(s) packed into ${tiles} tile(s) on '${String(data.layer)}'. '${String(data.sourceLayer)}' is hidden, not deleted — unhide it to compare.`,
+        ];
+        if (fuzzy > 0) {
+            lines.push(`${fuzzy} cell(s) were merged by tolerance, so the tilemap is an approximation of the mockup, not a copy.`);
+        }
+        if (tiles > cells / 2) {
+            lines.push(`That is a lot of unique tiles for ${cells} cells — usually a sign the mockup was painted without the grid in mind. Check the tile size before building on it.`);
+        }
+        return lines.join(" ");
+    }
+    if (op === "export") {
+        const files = data.files ?? [];
+        return `Wrote ${files.length} file(s) for ${String(data.format)}: ${files.join(", ")}`;
+    }
+    if (op === "stamp" && Number(data.skipped ?? 0) > 0) {
+        return `Placed ${String(data.tileCount)} tile(s); skipped ${String(data.skipped)} outside the ${String(data.columns)}x${String(data.rows)} grid or naming a tile that does not exist.`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=assets.js.map

package/dist/tools/assets.js.map

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

package/dist/tools/craft.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiveClient } from "../bridge/client.js";
+/**
+ * Operations that encode pixel-art craft rather than Aseprite mechanics.
+ *
+ * `recolor` exists because "make this darker" done naively — subtract from every
+ * channel — produces the muddy, plastic look that reads instantly as generated.
+ * A real shadow shifts hue toward the ambient (cool) and loses a little
+ * saturation; a highlight warms. That rule is applied here, in one place, so
+ * every skill and every agent gets it for free.
+ */
+export declare function registerCraftTools(server: McpServer, live: LiveClient): void;