@pebbly/aseprite-ai-artist 0.1.0

package/dist/tools/session.js

@@ -0,0 +1,231 @@
+import { z } from "zod";
+import { fail, ok, targetShape } from "./kit.js";
+export function registerSessionTools(server, live) {
+    server.registerTool("preflight", {
+        title: "Preflight",
+        description: "Check that Aseprite is connected and report what this session can do. Call this FIRST in any pixel-art task and stop if `ready` is false — every editing tool writes into the user's open Aseprite window, and there is no useful fallback when that window is not there.",
+        inputSchema: {},
+        outputSchema: {
+            ready: z.boolean().describe("True only when Aseprite is attached and accepting commands."),
+            bridgeConnected: z.boolean(),
+            pluginConnected: z.boolean(),
+            asepriteVersion: z.string().nullish(),
+            extensionVersion: z.string().nullish(),
+            features: z.array(z.string()).describe("Optional capabilities this extension build supports."),
+            activeSprite: z
+                .object({
+                name: z.string(),
+                width: z.number().int(),
+                height: z.number().int(),
+                colorMode: z.string(),
+                frames: z.number().int(),
+                layers: z.number().int(),
+            })
+                .nullish(),
+            directive: z.string().describe("What to do next, in one sentence."),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => {
+        await live.waitForBridge(2_000);
+        if (!live.pluginConnected)
+            await live.waitForPlugin(1_500);
+        const base = {
+            bridgeConnected: live.bridgeConnected,
+            pluginConnected: live.pluginConnected,
+            asepriteVersion: live.hello?.asepriteVersion ?? null,
+            extensionVersion: live.hello?.extensionVersion ?? null,
+            features: live.features,
+        };
+        if (!live.pluginConnected) {
+            return ok({
+                ...base,
+                ready: false,
+                activeSprite: null,
+                directive: live.bridgeConnected
+                    ? "The bridge is running but Aseprite is not attached. Ask the user to open Aseprite with the aseprite-ai-artist extension installed, then call preflight again."
+                    : "The bridge is not running. Ask the user to run `npx @pebbly/aseprite-ai-artist doctor`.",
+            }, "NOT READY — Aseprite is not connected. Do not attempt to edit files on disk instead.");
+        }
+        try {
+            const site = await live.call("session.site");
+            const sprite = site.sprite;
+            return ok({
+                ...base,
+                ready: true,
+                activeSprite: sprite
+                    ? {
+                        name: String(sprite.name ?? "untitled"),
+                        width: Number(sprite.width ?? 0),
+                        height: Number(sprite.height ?? 0),
+                        colorMode: String(sprite.colorMode ?? "rgb"),
+                        frames: Number(sprite.frames ?? 0),
+                        layers: Number(sprite.layers ?? 0),
+                    }
+                    : null,
+                directive: sprite
+                    ? "Ready. Call sprite_info before your first edit so you are working from the real layer, frame and palette state."
+                    : "Ready, but no sprite is open. Use sprite_manage with op 'new' or 'open' first.",
+            }, sprite
+                ? `READY — Aseprite ${base.asepriteVersion}, active sprite ${String(sprite.name)} (${String(sprite.width)}×${String(sprite.height)}).`
+                : "READY — Aseprite is connected but no sprite is open.");
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("sprite_info", {
+        title: "Sprite info",
+        description: "Full structured state of a sprite: dimensions, colour mode, palette, every layer (with opacity, blend mode, visibility, group nesting), every frame with its duration, animation tags, slices and the current selection. Read this before editing — guessing at layer names or frame counts is the most common way an agent corrupts someone's file.",
+        inputSchema: {
+            sprite: targetShape.sprite,
+            includePalette: z.boolean().default(true).describe("Include the full palette as hex."),
+            includeSlices: z.boolean().default(false),
+        },
+        outputSchema: {
+            id: z.number().int().describe("Stable id for this open document. Pass it back as '#<id>'."),
+            name: z.string(),
+            filename: z.string().nullish(),
+            width: z.number().int(),
+            height: z.number().int(),
+            colorMode: z.enum(["rgb", "grayscale", "indexed"]),
+            transparentIndex: z.number().int().nullish(),
+            frameCount: z.number().int(),
+            layers: z.array(z.object({
+                name: z.string(),
+                index: z.number().int(),
+                visible: z.boolean(),
+                editable: z.boolean(),
+                opacity: z.number().int(),
+                blendMode: z.string(),
+                isGroup: z.boolean(),
+                isTilemap: z.boolean(),
+                parent: z.string().nullish(),
+                cels: z.array(z.number().int()).describe("1-based frames that have a cel on this layer."),
+            })),
+            frames: z.array(z.object({ number: z.number().int(), durationMs: z.number().int() })),
+            tags: z.array(z.object({
+                name: z.string(),
+                from: z.number().int(),
+                to: z.number().int(),
+                direction: z.string(),
+                repeats: z.number().int().nullish().describe("Loop count; 0 means forever."),
+            })),
+            palette: z.array(z.string()).optional(),
+            slices: z
+                .array(z.object({ name: z.string(), bounds: z.record(z.number()) }))
+                .optional(),
+            selection: z
+                .object({ x: z.number().int(), y: z.number().int(), width: z.number().int(), height: z.number().int() })
+                .nullish(),
+            activeLayer: z.string().nullish(),
+            activeFrame: z.number().int().nullish(),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("sprite.info", args);
+            return ok(data, describeSprite(data));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("sprite_manage", {
+        title: "Manage sprites",
+        description: "Open, create, focus, resize, save and close sprites in the running Aseprite session. Ops: 'list' (open documents), 'new', 'open', 'activate', 'save', 'save_as', 'close', 'resize_canvas', 'set_properties'. Canvas resize keeps existing pixels — pass an anchor to say where they land.",
+        inputSchema: {
+            op: z.enum([
+                "list",
+                "new",
+                "open",
+                "activate",
+                "save",
+                "save_as",
+                "close",
+                "resize_canvas",
+                "set_properties",
+            ]),
+            sprite: targetShape.sprite,
+            path: z.string().optional().describe("File path for 'open' and 'save_as'."),
+            width: z.number().int().positive().optional(),
+            height: z.number().int().positive().optional(),
+            colorMode: z.enum(["rgb", "grayscale", "indexed"]).optional().describe("For 'new'. Indexed keeps a sprite honest about its palette."),
+            anchor: z
+                .enum(["top_left", "top", "top_right", "left", "center", "right", "bottom_left", "bottom", "bottom_right"])
+                .default("center")
+                .describe("Where existing pixels sit after 'resize_canvas'."),
+            pixelAspect: z.string().optional().describe("e.g. '1:1' or '1:2'."),
+            force: z
+                .boolean()
+                .default(false)
+                .describe("Allow 'close' to discard unsaved changes. Ask the user before setting this."),
+        },
+        outputSchema: {
+            op: z.string(),
+            sprites: z
+                .array(z.object({
+                id: z.number().int(),
+                name: z.string(),
+                filename: z.string().nullish(),
+                width: z.number().int(),
+                height: z.number().int(),
+                colorMode: z.string(),
+                frames: z.number().int(),
+                layers: z.number().int(),
+                active: z.boolean(),
+                modified: z.boolean(),
+            }))
+                .optional(),
+            sprite: z.string().optional(),
+            id: z.number().int().optional().describe("Stable id of the affected document; pass it back as '#<id>'."),
+            path: z.string().optional(),
+            width: z.number().int().optional(),
+            height: z.number().int().optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        try {
+            if (args.op === "close" && !args.force) {
+                // A close that discards work is not recoverable through undo.
+                const info = await live.call("sprite.info", {
+                    sprite: args.sprite,
+                    includePalette: false,
+                });
+                if (info.modified) {
+                    return fail(new Error(`'${info.name ?? "This sprite"}' has unsaved changes. Save it first, or ask the user to confirm and call again with force: true.`));
+                }
+            }
+            const data = await live.call("sprite.manage", args);
+            const merged = { op: args.op, ...data };
+            // Hand back the unambiguous form: the display name of a fresh document
+            // is "Sprite" for every unsaved sprite at once, so an agent that feeds
+            // the name straight back can address the wrong one.
+            const hint = data.id === undefined ? "" : ` Refer to it as '#${String(data.id)}'.`;
+            return ok(merged, `${args.op}: ${String(data.sprite ?? "ok")}.${hint}`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+function describeSprite(data) {
+    const layers = data.layers?.length ?? 0;
+    const tags = data.tags ?? [];
+    const palette = data.palette?.length;
+    const bits = [
+        `${String(data.name)} ${String(data.width)}×${String(data.height)} ${String(data.colorMode)}`,
+        `${String(data.frameCount)} frame(s)`,
+        `${layers} layer(s)`,
+    ];
+    if (palette !== undefined)
+        bits.push(`${palette}-colour palette`);
+    if (tags.length > 0)
+        bits.push(`tags: ${tags.map((t) => t.name).join(", ")}`);
+    return bits.join(" · ");
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

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

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

package/dist/tools/structure.js

@@ -0,0 +1,218 @@
+import { z } from "zod";
+import { fail, ok, targetShape } from "./kit.js";
+/**
+ * Layers, frames, tags and cels — the skeleton an animator works against.
+ *
+ * Each is one tool with an `op` enum and a batch array, because these calls
+ * arrive in clusters: building a character rig is eight layers, and blocking in
+ * a walk cycle is eight frames with three different durations.
+ */
+const blendMode = z.enum([
+    "normal", "multiply", "screen", "overlay", "darken", "lighten",
+    "color_dodge", "color_burn", "hard_light", "soft_light", "difference",
+    "exclusion", "hue", "saturation", "color", "luminosity", "addition",
+    "subtract", "divide",
+]);
+const layerOpName = z.enum([
+    "list", "create", "rename", "delete", "reorder", "set",
+    "group", "ungroup", "merge", "duplicate", "activate",
+]);
+/** One layer operation. Used for both the single-op form and every `batch` entry. */
+const layerOp = z.object({
+    op: layerOpName,
+    name: z.string().optional(),
+    newName: z.string().optional(),
+    parent: z.string().optional().describe("Group layer to nest under."),
+    index: z.number().int().optional().describe("Target stack position; 0 is bottom."),
+    visible: z.boolean().optional(),
+    editable: z.boolean().optional(),
+    opacity: z.number().int().min(0).max(255).optional(),
+    blendMode: blendMode.optional(),
+    names: z.array(z.string()).optional().describe("For 'merge' and bulk 'group'."),
+});
+export function registerStructureTools(server, live) {
+    server.registerTool("layer", {
+        title: "Layers",
+        description: "Manage layers. Ops: 'list', 'create', 'rename', 'delete', 'reorder', 'set' (visibility/opacity/blend/lock), 'group', 'ungroup', 'merge', 'duplicate', 'activate'. " +
+            "Pass `batch` to run several in one undoable action — building a rig in one call is the normal use. " +
+            "A character that will be animated wants its parts on separate layers (head, torso, arm-far, arm-near, leg-far, leg-near) before any frames exist; splitting baked pixels apart later is far more work.",
+        inputSchema: {
+            op: layerOpName.optional().describe("Single operation. Use `batch` instead for several."),
+            sprite: targetShape.sprite,
+            name: z.string().optional(),
+            newName: z.string().optional(),
+            parent: z.string().optional().describe("Group layer to nest under."),
+            index: z.number().int().optional().describe("Target stack position for 'reorder'; 0 is bottom."),
+            visible: z.boolean().optional(),
+            editable: z.boolean().optional(),
+            opacity: z.number().int().min(0).max(255).optional(),
+            blendMode: blendMode.optional(),
+            names: z.array(z.string()).optional().describe("For 'merge' and bulk 'group'."),
+            batch: z
+                .array(layerOp)
+                .max(128)
+                .optional()
+                .describe("Operations applied in order, in one undoable action. Same shape as the single-op arguments."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            layers: z
+                .array(z.object({
+                name: z.string(),
+                index: z.number().int(),
+                visible: z.boolean(),
+                editable: z.boolean(),
+                opacity: z.number().int(),
+                blendMode: z.string(),
+                isGroup: z.boolean(),
+                isTilemap: z.boolean(),
+                parent: z.string().nullish(),
+                cels: z.array(z.number().int()).describe("1-based frames that have a cel on this layer."),
+            }))
+                .optional(),
+            applied: z.number().int().optional(),
+            activeLayer: z.string().nullish().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("layer.apply", args);
+            return ok(data, describeLayers(data));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("frame", {
+        title: "Frames",
+        description: "Manage animation frames. Ops: 'list', 'add', 'duplicate', 'delete', 'set_duration', 'activate', 'reorder'. " +
+            "Durations are milliseconds per frame and carry most of the life in a cycle — hold a contact pose longer than a pass pose. " +
+            "Use `count` to add several at once and `durations` to set a whole cycle's timing in one call.",
+        inputSchema: {
+            op: z.enum(["list", "add", "duplicate", "delete", "set_duration", "activate", "reorder"]),
+            sprite: targetShape.sprite,
+            frame: targetShape.frame,
+            count: z.number().int().positive().max(256).default(1),
+            afterFrame: z.number().int().positive().optional().describe("Insert position. Default: at the end."),
+            durationMs: z.number().int().positive().max(65535).optional(),
+            durations: z
+                .array(z.number().int().positive())
+                .optional()
+                .describe("Per-frame durations from frame 1, for 'set_duration'."),
+            toIndex: z.number().int().positive().optional().describe("For 'reorder'."),
+            linkCels: z
+                .boolean()
+                .default(false)
+                .describe("For 'duplicate': share the cel image instead of copying it, so edits apply to both."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            frameCount: z.number().int(),
+            frames: z
+                .array(z.object({ number: z.number().int(), durationMs: z.number().int() }))
+                .optional(),
+            activeFrame: z.number().int().optional(),
+            totalDurationMs: z.number().int().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("frame.apply", args);
+            const total = data.totalDurationMs;
+            const summary = typeof total === "number"
+                ? `${String(data.frameCount)} frame(s), ${total}ms total (${(1000 / Math.max(total / Number(data.frameCount || 1), 1)).toFixed(1)} fps average).`
+                : undefined;
+            return ok(data, summary);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("tag", {
+        title: "Animation tags",
+        description: "Manage animation tags — the named frame ranges a game engine imports as 'idle', 'walk', 'attack'. Ops: 'list', 'create', 'update', 'delete'. Tag every cycle before export; an untagged spritesheet is a pile of frames the engine cannot address.",
+        inputSchema: {
+            op: z.enum(["list", "create", "update", "delete"]),
+            sprite: targetShape.sprite,
+            name: z.string().optional(),
+            newName: z.string().optional(),
+            from: z.number().int().positive().optional().describe("First frame, 1-based, inclusive."),
+            to: z.number().int().positive().optional().describe("Last frame, 1-based, inclusive."),
+            direction: z.enum(["forward", "reverse", "pingpong", "pingpong_reverse"]).optional(),
+            repeats: z.number().int().min(0).optional().describe("Loop count; 0 means forever."),
+            color: z.string().optional().describe("Tag colour in the timeline, #rrggbb."),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            tags: z.array(z.object({
+                name: z.string(),
+                from: z.number().int(),
+                to: z.number().int(),
+                direction: z.string(),
+                frames: z.number().int(),
+                durationMs: z.number().int(),
+            })),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("tag.apply", args);
+            return ok(data);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("cel", {
+        title: "Cels",
+        description: "Manage cels — one layer's image on one frame. Ops: 'list', 'create', 'clear', 'delete', 'move', 'copy', 'link', 'unlink', 'set' (position/opacity). " +
+            "'move' is how you shift a whole limb between frames without redrawing it; 'link' shares one image across frames so a static part of a cycle stays in sync.",
+        inputSchema: {
+            op: z.enum(["list", "create", "clear", "delete", "move", "copy", "link", "unlink", "set"]),
+            ...targetShape,
+            toFrame: z.number().int().positive().optional(),
+            toLayer: z.string().optional(),
+            frames: z.array(z.number().int().positive()).optional().describe("For 'link' across a range."),
+            x: z.number().int().optional().describe("Cel origin, for 'set' and 'move'."),
+            y: z.number().int().optional(),
+            dx: z.number().int().optional().describe("Relative move."),
+            dy: z.number().int().optional(),
+            opacity: z.number().int().min(0).max(255).optional(),
+        },
+        outputSchema: {
+            sprite: z.string(),
+            cels: z
+                .array(z.object({
+                layer: z.string(),
+                frame: z.number().int(),
+                x: z.number().int(),
+                y: z.number().int(),
+                width: z.number().int(),
+                height: z.number().int(),
+                opacity: z.number().int(),
+                linked: z.boolean(),
+            }))
+                .optional(),
+            applied: z.number().int().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const data = await live.call("cel.apply", args);
+            return ok(data);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+function describeLayers(data) {
+    const layers = data.layers;
+    if (!layers)
+        return undefined;
+    return `${layers.length} layer(s), top to bottom: ${[...layers]
+        .reverse()
+        .map((l) => `${l.name}${l.isGroup ? "/" : ""}${l.visible ? "" : " (hidden)"}`)
+        .join(", ")}`;
+}
+//# sourceMappingURL=structure.js.map

package/dist/tools/structure.js.map

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

package/examples/mcp-configs/claude-code.json

@@ -0,0 +1,9 @@
+{
+  "//": "Claude Code — user scope goes in ~/.claude.json, project scope in .mcp.json. Prefer installing the plugin instead: /plugin marketplace add with-pebbly/aseprite-ai-artist",
+  "mcpServers": {
+    "aseprite-ai-artist": {
+      "command": "npx",
+      "args": ["-y", "@pebbly/aseprite-ai-artist@latest", "serve"]
+    }
+  }
+}

package/examples/mcp-configs/codex.toml

@@ -0,0 +1,13 @@
+# OpenAI Codex CLI — ~/.codex/config.toml (or .codex/config.toml in a trusted project).
+# Codex reads TOML; the JSON that Claude Code and Cursor use will not work here.
+#
+# Written for you by:  npx @pebbly/aseprite-ai-artist install codex
+
+[mcp_servers.aseprite-ai-artist]
+command = "npx"
+args = ["-y", "@pebbly/aseprite-ai-artist@latest", "serve"]
+
+# Optional: point at a non-default Aseprite, or move the ports.
+# [mcp_servers.aseprite-ai-artist.env]
+# ASEPRITE_AI_PLUGIN_PORT = "9931"
+# ASEPRITE_AI_CONTROL_PORT = "9932"

package/examples/mcp-configs/cursor.json

@@ -0,0 +1,9 @@
+{
+  "//": "Cursor — ~/.cursor/mcp.json for user scope, .cursor/mcp.json for a project.",
+  "mcpServers": {
+    "aseprite-ai-artist": {
+      "command": "npx",
+      "args": ["-y", "@pebbly/aseprite-ai-artist@latest", "serve"]
+    }
+  }
+}

package/examples/mcp-configs/gemini-cli.json

@@ -0,0 +1,9 @@
+{
+  "//": "Gemini CLI — ~/.gemini/settings.json for user scope, .gemini/settings.json for a project.",
+  "mcpServers": {
+    "aseprite-ai-artist": {
+      "command": "npx",
+      "args": ["-y", "@pebbly/aseprite-ai-artist@latest", "serve"]
+    }
+  }
+}

package/examples/mcp-configs/vscode.json

@@ -0,0 +1,10 @@
+{
+  "//": "VS Code — .vscode/mcp.json. Note the key is `servers`, not `mcpServers`, and the transport is explicit.",
+  "servers": {
+    "aseprite-ai-artist": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@pebbly/aseprite-ai-artist@latest", "serve"]
+    }
+  }
+}