@pebbly/aseprite-ai-artist 0.1.0

package/dist/cli.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+/**
+ * One binary, several jobs:
+ *   serve              (default) speak MCP over stdio
+ *   bridge             run the singleton WebSocket relay
+ *   install <client…>  wire this server into an agent's config
+ *   install-extension  copy the Lua extension into Aseprite
+ *   doctor             tell the user exactly what is broken
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Bridge } from "./bridge/bridge.js";
+import { LiveClient } from "./bridge/client.js";
+import { createServer } from "./server.js";
+import { CLIENTS, configPath, install, mergeAgentsFile, } from "./install.js";
+import { installExtension, findAsepriteConfigDir } from "./extension.js";
+import { DEFAULT_CONTROL_PORT, DEFAULT_PLUGIN_PORT } from "./lib/protocol.js";
+import { packageVersion } from "./lib/version.js";
+function parseArgs(argv) {
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg.startsWith("--")) {
+            positional.push(arg);
+            continue;
+        }
+        const key = arg.slice(2);
+        const next = argv[i + 1];
+        if (next !== undefined && !next.startsWith("--")) {
+            flags[key] = next;
+            i++;
+        }
+        else {
+            flags[key] = true;
+        }
+    }
+    const command = positional.shift() ?? "serve";
+    return { command, positional, flags };
+}
+function num(flags, key, fallback) {
+    const raw = flags[key];
+    if (typeof raw !== "string")
+        return fallback;
+    const parsed = Number(raw);
+    return Number.isInteger(parsed) ? parsed : fallback;
+}
+async function main() {
+    const { command, positional, flags } = parseArgs(process.argv.slice(2));
+    if (flags.version || command === "version") {
+        process.stdout.write(`${packageVersion()}\n`);
+        return;
+    }
+    if (flags.help || command === "help") {
+        printHelp();
+        return;
+    }
+    const pluginPort = num(flags, "plugin-port", envPort("ASEPRITE_AI_PLUGIN_PORT", DEFAULT_PLUGIN_PORT));
+    const controlPort = num(flags, "control-port", envPort("ASEPRITE_AI_CONTROL_PORT", pluginPort + 1));
+    switch (command) {
+        case "serve":
+            return serve({ pluginPort, controlPort, allowLua: truthy(flags.allowLua ?? process.env.ASEPRITE_AI_ALLOW_LUA) });
+        case "bridge":
+            return runBridge({ pluginPort, controlPort });
+        case "install":
+            return runInstall(positional, flags);
+        case "install-extension":
+            return runInstallExtension(flags);
+        case "doctor":
+            return doctor({ pluginPort, controlPort });
+        default:
+            process.stderr.write(`Unknown command '${command}'.\n\n`);
+            printHelp();
+            process.exitCode = 2;
+    }
+}
+async function serve(opts) {
+    const { server, live } = createServer({
+        pluginPort: opts.pluginPort,
+        controlPort: opts.controlPort,
+        allowLua: opts.allowLua,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const shutdown = () => {
+        live.close();
+        // .finally() forwards a rejection, and nothing would catch it. Exit on both
+        // paths explicitly rather than relying on process.exit winning the race.
+        server.close().then(() => process.exit(0), () => process.exit(1));
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+async function runBridge(opts) {
+    const bridge = new Bridge({
+        pluginPort: opts.pluginPort,
+        controlPort: opts.controlPort,
+        version: packageVersion(),
+        log: (msg) => process.stderr.write(`[bridge] ${msg}\n`),
+    });
+    const started = await bridge.start();
+    if (!started) {
+        // Losing the race is the normal outcome when a bridge already runs.
+        process.stderr.write("[bridge] another bridge already owns these ports; exiting\n");
+        return;
+    }
+    const stop = () => bridge.stop().then(() => process.exit(0), () => process.exit(1));
+    process.on("SIGINT", stop);
+    process.on("SIGTERM", stop);
+    // Hold the process open; the WebSocket servers keep the loop alive anyway.
+    await new Promise(() => { });
+}
+async function runInstall(positional, flags) {
+    const requested = positional.length > 0 ? positional : (flags.all ? CLIENTS : []);
+    if (requested.length === 0) {
+        process.stderr.write(`Name at least one client, or pass --all.\nAvailable: ${CLIENTS.join(", ")}\n`);
+        process.exitCode = 2;
+        return;
+    }
+    const scope = flags.project ? "project" : "user";
+    const projectDir = typeof flags.dir === "string" ? flags.dir : process.cwd();
+    const dryRun = truthy(flags["dry-run"]);
+    const env = {};
+    if (typeof flags.aseprite === "string")
+        env.ASEPRITE_PATH = flags.aseprite;
+    if (truthy(flags.allowLua))
+        env.ASEPRITE_AI_ALLOW_LUA = "1";
+    const opts = {
+        scope: scope,
+        projectDir,
+        command: "npx",
+        args: ["-y", "@pebbly/aseprite-ai-artist@latest", "serve"],
+        env,
+        dryRun,
+    };
+    for (const name of requested) {
+        if (!CLIENTS.includes(name)) {
+            process.stderr.write(`Unknown client '${name}'. Available: ${CLIENTS.join(", ")}\n`);
+            process.exitCode = 2;
+            return;
+        }
+    }
+    for (const name of requested) {
+        try {
+            const result = install(name, opts);
+            if (dryRun) {
+                process.stdout.write(`\n# ${name} → ${result.file}\n${result.note ?? ""}\n`);
+            }
+            else {
+                process.stdout.write(`✓ ${name.padEnd(9)} ${result.file}\n`);
+            }
+        }
+        catch (err) {
+            process.stdout.write(`✗ ${name.padEnd(9)} ${err.message}\n`);
+            process.exitCode = 1;
+        }
+    }
+    if (truthy(flags.agents)) {
+        const target = typeof flags.agents === "string" ? flags.agents : `${projectDir}/AGENTS.md`;
+        const res = mergeAgentsFile(target, dryRun);
+        process.stdout.write(`${res.written ? "✓" : "·"} AGENTS.md ${res.file}\n`);
+    }
+    if (!dryRun) {
+        process.stdout.write("\nRestart the agent so it picks up the new server, then run `install-extension` if you have not already.\n");
+    }
+}
+async function runInstallExtension(flags) {
+    try {
+        const result = installExtension({
+            dryRun: truthy(flags["dry-run"]),
+            configDir: typeof flags.dir === "string" ? flags.dir : undefined,
+        });
+        process.stdout.write(`✓ extension → ${result.target}\n`);
+        process.stdout.write("Restart Aseprite. The extension connects on startup; check Edit ▸ Preferences ▸ Extensions if it does not appear.\n");
+    }
+    catch (err) {
+        process.stdout.write(`✗ ${err.message}\n`);
+        process.exitCode = 1;
+    }
+}
+async function doctor(opts) {
+    const lines = [`aseprite-ai-artist ${packageVersion()}`, ""];
+    const configDir = findAsepriteConfigDir();
+    lines.push(configDir
+        ? `✓ Aseprite config dir   ${configDir}`
+        : "✗ Aseprite config dir   not found — is Aseprite installed and has it been run once?");
+    const live = new LiveClient({
+        controlPort: opts.controlPort,
+        pluginPort: opts.pluginPort,
+        autoSpawnBridge: true,
+        log: () => { },
+    });
+    const bridgeUp = await live.waitForBridge(4_000);
+    lines.push(bridgeUp
+        ? `✓ Bridge                 ws://127.0.0.1:${opts.controlPort}`
+        : `✗ Bridge                 could not reach or start it on :${opts.controlPort}`);
+    const pluginUp = bridgeUp ? await live.waitForPlugin(4_000) : false;
+    lines.push(pluginUp
+        ? `✓ Aseprite extension     ${live.hello?.extensionVersion ?? "?"} on Aseprite ${live.hello?.asepriteVersion ?? "?"}`
+        : "✗ Aseprite extension     not connected — open Aseprite, or run `install-extension` and restart it");
+    if (pluginUp) {
+        lines.push(`  features               ${live.features.join(", ") || "(none)"}`);
+        try {
+            const site = await live.call("session.site");
+            lines.push(site.sprite
+                ? `✓ Active sprite          ${site.sprite.name ?? "untitled"}`
+                : "· Active sprite          none open (that is fine)");
+        }
+        catch (err) {
+            lines.push(`✗ Round trip             ${err.message}`);
+        }
+    }
+    lines.push("");
+    lines.push("Client config locations:");
+    for (const client of CLIENTS) {
+        lines.push(`  ${client.padEnd(9)} ${configPath(client, {
+            scope: "user",
+            projectDir: process.cwd(),
+            command: "",
+            args: [],
+            env: {},
+            dryRun: true,
+        })}`);
+    }
+    live.close();
+    process.stdout.write(lines.join("\n") + "\n");
+    process.exitCode = pluginUp ? 0 : 1;
+}
+function printHelp() {
+    process.stdout.write(`aseprite-ai-artist ${packageVersion()} — agent control layer for Aseprite
+
+Usage:
+  aseprite-ai-artist [serve]                 Speak MCP over stdio (what agents run)
+  aseprite-ai-artist bridge                  Run the WebSocket relay (usually auto-started)
+  aseprite-ai-artist install <client…>       Write MCP config for an agent
+  aseprite-ai-artist install-extension       Install the Aseprite Lua extension
+  aseprite-ai-artist doctor                  Diagnose a broken setup
+
+Clients: ${CLIENTS.join(", ")}
+
+Options:
+  --all                Install for every supported client
+  --project            Write project-scoped config instead of user-scoped
+  --dir <path>         Project directory (default: cwd)
+  --agents [path]      Also write an AGENTS.md section (default: ./AGENTS.md)
+  --aseprite <path>    Path to the Aseprite executable
+  --allowLua           Enable the run_lua escape hatch (arbitrary code in Aseprite)
+  --plugin-port <n>    Port the Aseprite extension dials (default ${DEFAULT_PLUGIN_PORT})
+  --control-port <n>   Port MCP servers dial (default ${DEFAULT_CONTROL_PORT})
+  --dry-run            Print what would change, write nothing
+  --version, --help
+
+Examples:
+  npx @pebbly/aseprite-ai-artist install --all --agents
+  npx @pebbly/aseprite-ai-artist install codex cursor --project
+  npx @pebbly/aseprite-ai-artist doctor
+`);
+}
+function truthy(value) {
+    return value === true || value === "1" || value === "true" || value === "yes";
+}
+function envPort(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    return Number.isInteger(parsed) ? parsed : fallback;
+}
+main().catch((err) => {
+    process.stderr.write(`${err.stack ?? String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/extension.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Installing the Aseprite side.
+ *
+ * Aseprite loads extensions from a per-user config directory whose location
+ * differs on every platform and moves between the store and standalone builds.
+ * Getting this wrong is the single most common reason a setup "does nothing",
+ * so the search order is explicit and `doctor` reports what it found.
+ */
+/** Candidate Aseprite user-config directories, most likely first. */
+export declare function asepriteConfigCandidates(): string[];
+export declare function findAsepriteConfigDir(): string | null;
+export interface InstallExtensionOptions {
+    dryRun?: boolean;
+    /** Override the Aseprite config directory. */
+    configDir?: string | undefined;
+}
+export interface InstallExtensionResult {
+    target: string;
+    files: string[];
+}
+export declare function installExtension(opts?: InstallExtensionOptions): InstallExtensionResult;

package/dist/extension.js

@@ -0,0 +1,65 @@
+/**
+ * Installing the Aseprite side.
+ *
+ * Aseprite loads extensions from a per-user config directory whose location
+ * differs on every platform and moves between the store and standalone builds.
+ * Getting this wrong is the single most common reason a setup "does nothing",
+ * so the search order is explicit and `doctor` reports what it found.
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import path from "node:path";
+import { packageRoot } from "./lib/version.js";
+const EXTENSION_DIR_NAME = "aseprite-ai-artist";
+/** Candidate Aseprite user-config directories, most likely first. */
+export function asepriteConfigCandidates() {
+    const home = homedir();
+    const env = process.env.ASEPRITE_USER_FOLDER;
+    const candidates = [];
+    if (env)
+        candidates.push(env);
+    switch (platform()) {
+        case "darwin":
+            candidates.push(path.join(home, "Library", "Application Support", "Aseprite"));
+            break;
+        case "win32": {
+            const appData = process.env.APPDATA ?? path.join(home, "AppData", "Roaming");
+            candidates.push(path.join(appData, "Aseprite"));
+            break;
+        }
+        default: {
+            const xdg = process.env.XDG_CONFIG_HOME ?? path.join(home, ".config");
+            candidates.push(path.join(xdg, "aseprite"));
+            // Steam and some distro builds keep a dotfile directory instead.
+            candidates.push(path.join(home, ".aseprite"));
+            break;
+        }
+    }
+    return candidates;
+}
+export function findAsepriteConfigDir() {
+    for (const dir of asepriteConfigCandidates()) {
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+export function installExtension(opts = {}) {
+    const configDir = opts.configDir ?? findAsepriteConfigDir();
+    if (!configDir) {
+        throw new Error(`Could not find Aseprite's config directory. Looked in:\n  ${asepriteConfigCandidates().join("\n  ")}\n` +
+            `Run Aseprite once so it creates the directory, or pass --dir <path>.`);
+    }
+    const source = path.join(packageRoot(), "extension");
+    if (!existsSync(source)) {
+        throw new Error(`Bundled extension is missing from the package at ${source}.`);
+    }
+    const target = path.join(configDir, "extensions", EXTENSION_DIR_NAME);
+    const files = readdirSync(source);
+    if (opts.dryRun)
+        return { target, files };
+    mkdirSync(path.dirname(target), { recursive: true });
+    cpSync(source, target, { recursive: true });
+    return { target, files };
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/install.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Client configuration writer.
+ *
+ * The four target agents disagree on file format (JSON vs TOML), file location,
+ * and key names — and getting any of them wrong produces a silent no-op rather
+ * than an error. Encoding that here means a user types one command instead of
+ * reading four sets of docs.
+ */
+export type ClientId = "claude" | "codex" | "gemini" | "cursor" | "vscode" | "windsurf";
+export declare const CLIENTS: ClientId[];
+export interface InstallOptions {
+    scope: "user" | "project";
+    projectDir: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    dryRun: boolean;
+}
+export interface InstallResult {
+    client: ClientId;
+    file: string;
+    written: boolean;
+    note?: string;
+}
+export declare function configPath(client: ClientId, opts: InstallOptions): string;
+export declare function install(client: ClientId, opts: InstallOptions): InstallResult;
+/**
+ * Write AGENTS.md guidance for clients with no plugin or skill system.
+ * Returns the block so callers can show it rather than write it.
+ */
+export declare function agentsMarkdown(): string;
+export declare function mergeAgentsFile(target: string, dryRun: boolean): {
+    written: boolean;
+    file: string;
+};

package/dist/install.js

@@ -0,0 +1,185 @@
+/**
+ * Client configuration writer.
+ *
+ * The four target agents disagree on file format (JSON vs TOML), file location,
+ * and key names — and getting any of them wrong produces a silent no-op rather
+ * than an error. Encoding that here means a user types one command instead of
+ * reading four sets of docs.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, renameSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { packageRoot } from "./lib/version.js";
+export const CLIENTS = ["claude", "codex", "gemini", "cursor", "vscode", "windsurf"];
+export function configPath(client, opts) {
+    const home = homedir();
+    const project = opts.projectDir;
+    switch (client) {
+        case "claude":
+            return opts.scope === "user"
+                ? path.join(home, ".claude.json")
+                : path.join(project, ".mcp.json");
+        case "codex":
+            return opts.scope === "user"
+                ? path.join(home, ".codex", "config.toml")
+                : path.join(project, ".codex", "config.toml");
+        case "gemini":
+            return opts.scope === "user"
+                ? path.join(home, ".gemini", "settings.json")
+                : path.join(project, ".gemini", "settings.json");
+        case "cursor":
+            return opts.scope === "user"
+                ? path.join(home, ".cursor", "mcp.json")
+                : path.join(project, ".cursor", "mcp.json");
+        case "vscode":
+            return path.join(project, ".vscode", "mcp.json");
+        case "windsurf":
+            return path.join(home, ".codeium", "windsurf", "mcp_config.json");
+    }
+}
+const SERVER_KEY = "aseprite-ai-artist";
+export function install(client, opts) {
+    const file = configPath(client, opts);
+    if (client === "codex")
+        return installToml(file, opts);
+    return installJson(client, file, opts);
+}
+function installJson(client, file, opts) {
+    const existing = readJson(file);
+    // VS Code's mcp.json uses `servers`; everyone else uses `mcpServers`.
+    const key = client === "vscode" ? "servers" : "mcpServers";
+    const servers = existing[key] ?? {};
+    const entry = {
+        command: opts.command,
+        args: opts.args,
+    };
+    if (Object.keys(opts.env).length > 0)
+        entry.env = opts.env;
+    // VS Code wants an explicit transport marker.
+    if (client === "vscode")
+        entry.type = "stdio";
+    const next = { ...existing, [key]: { ...servers, [SERVER_KEY]: entry } };
+    if (opts.dryRun) {
+        return { client, file, written: false, note: JSON.stringify(next[key], null, 2) };
+    }
+    backup(file);
+    writeAtomic(file, JSON.stringify(next, null, 2) + "\n");
+    return { client, file, written: true };
+}
+/**
+ * Codex uses TOML. Rewriting a whole TOML document without a parser risks
+ * mangling comments and unrelated tables, so this only ever appends or replaces
+ * the one `[mcp_servers.aseprite-ai-artist]` block and leaves the rest byte
+ * for byte as it was.
+ */
+function installToml(file, opts) {
+    const header = `[mcp_servers.${SERVER_KEY}]`;
+    const lines = [
+        header,
+        `command = ${tomlString(opts.command)}`,
+        `args = [${opts.args.map(tomlString).join(", ")}]`,
+    ];
+    if (Object.keys(opts.env).length > 0) {
+        lines.push("");
+        lines.push(`[mcp_servers.${SERVER_KEY}.env]`);
+        for (const [k, v] of Object.entries(opts.env))
+            lines.push(`${k} = ${tomlString(v)}`);
+    }
+    const block = lines.join("\n") + "\n";
+    if (opts.dryRun)
+        return { client: "codex", file, written: false, note: block };
+    let existing = existsSync(file) ? readFileSync(file, "utf8") : "";
+    // Anchored to the start of a line: a bare indexOf would also match the header
+    // text inside a comment or a string value and splice around the wrong offset.
+    const headerAt = new RegExp(`^\\s*${header.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*$`, "m").exec(existing);
+    const start = headerAt?.index ?? -1;
+    if (start !== -1) {
+        // Replace from our header up to the next top-level table that is not ours.
+        const rest = existing.slice(start + header.length);
+        const nextTable = rest.search(/\n\[(?!mcp_servers\.aseprite-ai-artist)/);
+        const end = nextTable === -1 ? existing.length : start + header.length + nextTable + 1;
+        existing = existing.slice(0, start) + existing.slice(end);
+    }
+    backup(file);
+    const separator = existing.length > 0 && !existing.endsWith("\n\n") ? "\n" : "";
+    writeAtomic(file, existing.trimEnd() + "\n" + separator + block);
+    return { client: "codex", file, written: true };
+}
+/**
+ * Write AGENTS.md guidance for clients with no plugin or skill system.
+ * Returns the block so callers can show it rather than write it.
+ */
+export function agentsMarkdown() {
+    const file = path.join(packageRoot(), "templates", "AGENTS.section.md");
+    if (existsSync(file))
+        return readFileSync(file, "utf8");
+    return "";
+}
+export function mergeAgentsFile(target, dryRun) {
+    const block = agentsMarkdown();
+    const marker = "<!-- aseprite-ai-artist:start -->";
+    const endMarker = "<!-- aseprite-ai-artist:end -->";
+    const wrapped = `${marker}\n${block.trim()}\n${endMarker}\n`;
+    let content = existsSync(target) ? readFileSync(target, "utf8") : "";
+    const start = content.indexOf(marker);
+    if (start !== -1) {
+        const end = content.indexOf(endMarker);
+        if (end !== -1)
+            content = content.slice(0, start) + content.slice(end + endMarker.length + 1);
+    }
+    const next = content.trimEnd() + (content.trim() ? "\n\n" : "") + wrapped;
+    if (dryRun)
+        return { written: false, file: target };
+    backup(target);
+    writeAtomic(target, next);
+    return { written: true, file: target };
+}
+function readJson(file) {
+    if (!existsSync(file))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        return typeof parsed === "object" && parsed !== null ? parsed : {};
+    }
+    catch (err) {
+        throw new Error(`${file} is not valid JSON, so it cannot be edited safely. Fix or move it, then retry. (${err.message})`);
+    }
+}
+/**
+ * Write through a sibling temp file and rename over the target.
+ *
+ * `~/.claude.json` is ~128KB and holds Claude Code's own project list, session
+ * and auth state. A plain writeFileSync that dies part-way — full disk, killed
+ * process — leaves that truncated and the user's whole setup broken. A rename
+ * on the same filesystem is atomic, so the file is either the old one or the
+ * new one, never half of either.
+ */
+function writeAtomic(file, contents) {
+    const dir = path.dirname(file);
+    mkdirSync(dir, { recursive: true });
+    const temp = path.join(dir, `.${path.basename(file)}.${process.pid}.tmp`);
+    try {
+        writeFileSync(temp, contents, "utf8");
+        renameSync(temp, file);
+    }
+    catch (err) {
+        try {
+            unlinkSync(temp);
+        }
+        catch {
+            /* the temp file may never have been created */
+        }
+        throw err;
+    }
+}
+/** Never overwrite someone's config without leaving them a way back. */
+function backup(file) {
+    if (!existsSync(file))
+        return;
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    copyFileSync(file, `${file}.bak-${stamp}`);
+}
+function tomlString(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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