@pebbly/aseprite-ai-artist 0.1.0

package/dist/bridge/bridge.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Standalone WebSocket bridge.
+ *
+ * Owns two ports and nothing else — it is a dumb relay with no knowledge of
+ * Aseprite semantics:
+ *   plugin port  : the Aseprite Lua extension dials in (at most one, last wins)
+ *   control port : MCP server processes dial in (N of them)
+ *
+ * It runs as its own process, detached from any MCP server, because agent hosts
+ * own the MCP server lifecycle and restart it freely. A bridge living inside the
+ * MCP process drops the Aseprite connection on every restart and duplicate
+ * processes fight over the listen port. See docs/adr/0002-standalone-bridge.md.
+ *
+ * Singleton by port ownership: whoever binds the control port first is the
+ * bridge; a loser of the bind race exits 0 without complaint.
+ */
+export interface BridgeOptions {
+    pluginPort?: number;
+    controlPort?: number;
+    version: string;
+    log?: (msg: string) => void;
+}
+export declare class Bridge {
+    private readonly pluginPort;
+    private readonly controlPort;
+    private readonly version;
+    private readonly log;
+    private pluginServer;
+    private controlServer;
+    private plugin;
+    private hello;
+    private since;
+    private clients;
+    private nextClientId;
+    constructor(opts: BridgeOptions);
+    /**
+     * Bind both ports. Resolves false when the control port is already taken,
+     * which means another bridge already owns this machine's Aseprite link.
+     */
+    start(): Promise<boolean>;
+    stop(): Promise<void>;
+    private onPluginConnect;
+    private onPluginMessage;
+    private onControlConnect;
+    private onControlMessage;
+    private stateFrame;
+    private broadcastState;
+}
+export declare class BridgeBindError extends Error {
+    readonly port: number;
+    constructor(port: number, cause: NodeJS.ErrnoException);
+}

package/dist/bridge/bridge.js

@@ -0,0 +1,230 @@
+/**
+ * Standalone WebSocket bridge.
+ *
+ * Owns two ports and nothing else — it is a dumb relay with no knowledge of
+ * Aseprite semantics:
+ *   plugin port  : the Aseprite Lua extension dials in (at most one, last wins)
+ *   control port : MCP server processes dial in (N of them)
+ *
+ * It runs as its own process, detached from any MCP server, because agent hosts
+ * own the MCP server lifecycle and restart it freely. A bridge living inside the
+ * MCP process drops the Aseprite connection on every restart and duplicate
+ * processes fight over the listen port. See docs/adr/0002-standalone-bridge.md.
+ *
+ * Singleton by port ownership: whoever binds the control port first is the
+ * bridge; a loser of the bind race exits 0 without complaint.
+ */
+import { WebSocketServer, WebSocket } from "ws";
+import { DEFAULT_CONTROL_PORT, DEFAULT_PLUGIN_PORT, isHello, makeNamespacedId, splitNamespacedId, } from "../lib/protocol.js";
+/**
+ * Frames larger than this are refused. A 64x64 pixel read is a few hundred KB;
+ * ws defaults to 100 MiB, which on an unauthenticated localhost socket is a
+ * one-line memory-exhaustion vector.
+ */
+const MAX_FRAME_BYTES = 16 * 1024 * 1024;
+/** Control clients are one per agent window; a hundred means something is wrong. */
+const MAX_CONTROL_CLIENTS = 64;
+export class Bridge {
+    pluginPort;
+    controlPort;
+    version;
+    log;
+    pluginServer = null;
+    controlServer = null;
+    plugin = null;
+    hello = null;
+    since = Date.now();
+    clients = new Map();
+    nextClientId = 1;
+    constructor(opts) {
+        this.pluginPort = opts.pluginPort ?? DEFAULT_PLUGIN_PORT;
+        this.controlPort = opts.controlPort ?? DEFAULT_CONTROL_PORT;
+        this.version = opts.version;
+        this.log = opts.log ?? (() => { });
+    }
+    /**
+     * Bind both ports. Resolves false when the control port is already taken,
+     * which means another bridge already owns this machine's Aseprite link.
+     */
+    async start() {
+        const control = await listen(this.controlPort);
+        if (!control)
+            return false;
+        this.controlServer = control;
+        const plugin = await listen(this.pluginPort);
+        if (!plugin) {
+            // Ports must move together; a split ownership would strand the extension.
+            control.close();
+            return false;
+        }
+        this.pluginServer = plugin;
+        this.controlServer.on("connection", (socket) => this.onControlConnect(socket));
+        this.pluginServer.on("connection", (socket) => this.onPluginConnect(socket));
+        this.log(`bridge up — plugin :${this.pluginPort}, control :${this.controlPort}, v${this.version}`);
+        return true;
+    }
+    async stop() {
+        for (const c of this.clients.values())
+            c.socket.close();
+        this.plugin?.close();
+        this.pluginServer?.close();
+        this.controlServer?.close();
+    }
+    // ── plugin side ────────────────────────────────────────────────────────────
+    onPluginConnect(socket) {
+        // Last connection wins: an Aseprite restart must not be locked out by the
+        // corpse of a half-open previous socket.
+        if (this.plugin && this.plugin.readyState === WebSocket.OPEN) {
+            this.log("plugin reconnected — dropping previous socket");
+            this.plugin.close();
+        }
+        this.plugin = socket;
+        this.since = Date.now();
+        socket.on("message", (raw) => this.onPluginMessage(raw.toString()));
+        socket.on("close", () => {
+            if (this.plugin === socket) {
+                this.plugin = null;
+                this.hello = null;
+                this.since = Date.now();
+                this.broadcastState();
+            }
+        });
+        socket.on("error", () => socket.close());
+        this.broadcastState();
+    }
+    onPluginMessage(raw) {
+        let frame;
+        try {
+            frame = JSON.parse(raw);
+        }
+        catch {
+            this.log(`dropped unparseable plugin frame (${raw.length} bytes)`);
+            return;
+        }
+        if (isHello(frame)) {
+            this.hello = frame;
+            this.since = Date.now();
+            this.broadcastState();
+            return;
+        }
+        const id = frame.id;
+        if (typeof id !== "string")
+            return;
+        const split = splitNamespacedId(id);
+        if (!split)
+            return;
+        const client = this.clients.get(split.clientId);
+        if (!client || client.socket.readyState !== WebSocket.OPEN)
+            return;
+        send(client.socket, { ...frame, id: split.originalId });
+    }
+    // ── control side ───────────────────────────────────────────────────────────
+    onControlConnect(socket) {
+        if (this.clients.size >= MAX_CONTROL_CLIENTS) {
+            send(socket, {
+                id: "connect",
+                ok: false,
+                error: {
+                    code: "too_large",
+                    message: `Refusing a ${MAX_CONTROL_CLIENTS + 1}th control client; something is opening connections in a loop.`,
+                },
+            });
+            socket.close();
+            return;
+        }
+        const id = this.nextClientId++;
+        this.clients.set(id, { id, socket });
+        socket.on("message", (raw) => this.onControlMessage(id, raw.toString()));
+        socket.on("close", () => this.clients.delete(id));
+        socket.on("error", () => socket.close());
+        // A client must know liveness before it sends anything.
+        send(socket, this.stateFrame());
+    }
+    onControlMessage(clientId, raw) {
+        let frame;
+        try {
+            frame = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (typeof frame.id !== "string")
+            return;
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        if (!this.plugin || this.plugin.readyState !== WebSocket.OPEN) {
+            // Answer on the plugin's behalf rather than letting the call hang. A
+            // timeout reads as "slow" to an agent; this reads as "stop and tell the user".
+            send(client.socket, {
+                id: frame.id,
+                ok: false,
+                error: {
+                    code: "not_connected",
+                    message: "Aseprite is not connected to the bridge. The extension is not running or Aseprite is closed.",
+                    details: { doNotFallBackToDisk: true },
+                },
+            });
+            return;
+        }
+        send(this.plugin, { ...frame, id: makeNamespacedId(clientId, frame.id) });
+    }
+    stateFrame() {
+        return {
+            type: "bridge_state",
+            pluginConnected: this.plugin?.readyState === WebSocket.OPEN,
+            hello: this.hello,
+            bridgeVersion: this.version,
+            since: this.since,
+        };
+    }
+    broadcastState() {
+        const frame = this.stateFrame();
+        for (const c of this.clients.values()) {
+            if (c.socket.readyState === WebSocket.OPEN)
+                send(c.socket, frame);
+        }
+    }
+}
+function send(socket, payload) {
+    try {
+        socket.send(JSON.stringify(payload));
+    }
+    catch {
+        /* a dead socket is handled by its own close handler */
+    }
+}
+export class BridgeBindError extends Error {
+    port;
+    constructor(port, cause) {
+        super(`Could not bind 127.0.0.1:${port}: ${cause.code ?? cause.message}`);
+        this.name = "BridgeBindError";
+        this.port = port;
+    }
+}
+/**
+ * Resolves the server on success, or null when the port is already taken —
+ * which is the normal "a bridge already runs" outcome. Any OTHER bind failure
+ * rejects: reporting an EACCES as "another bridge owns this port" sends the
+ * user looking for a process that does not exist.
+ */
+function listen(port) {
+    return new Promise((resolve, reject) => {
+        const server = new WebSocketServer({ host: "127.0.0.1", port, maxPayload: MAX_FRAME_BYTES });
+        const onError = (err) => {
+            server.removeListener("listening", onListening);
+            if (err.code === "EADDRINUSE")
+                resolve(null);
+            else
+                reject(new BridgeBindError(port, err));
+        };
+        const onListening = () => {
+            server.removeListener("error", onError);
+            server.on("error", () => { });
+            resolve(server);
+        };
+        server.once("error", onError);
+        server.once("listening", onListening);
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge/bridge.js.map

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

package/dist/bridge/client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Control client: the MCP server's half of the link to Aseprite.
+ *
+ * Responsibilities beyond "send JSON":
+ *  - spawn the bridge if nothing owns the control port yet (zero-setup goal);
+ *  - reconnect with backoff, because the bridge may be restarted under us;
+ *  - track `pluginConnected` from bridge_state so `preflight` can answer
+ *    truthfully without a round-trip to Aseprite.
+ */
+import { HelloFrame } from "../lib/protocol.js";
+export interface LiveClientOptions {
+    controlPort?: number;
+    pluginPort?: number;
+    /** Disable auto-spawning the bridge (useful in tests and CI). */
+    autoSpawnBridge?: boolean;
+    timeoutMs?: number;
+    log?: (msg: string) => void;
+}
+export declare class LiveClient {
+    private readonly controlPort;
+    private readonly pluginPort;
+    private readonly autoSpawn;
+    private readonly timeoutMs;
+    private readonly log;
+    private socket;
+    private pending;
+    private seq;
+    private reconnectDelay;
+    private reconnectTimer;
+    private closed;
+    private lastSpawnAt;
+    private state;
+    constructor(opts?: LiveClientOptions);
+    get bridgeConnected(): boolean;
+    get pluginConnected(): boolean;
+    get hello(): HelloFrame | null;
+    get features(): string[];
+    hasFeature(name: string): boolean;
+    /** Wait until the bridge link is up (not necessarily Aseprite). */
+    waitForBridge(ms?: number): Promise<boolean>;
+    /** Wait until Aseprite itself is attached. */
+    waitForPlugin(ms?: number): Promise<boolean>;
+    call<T = unknown>(cmd: string, args?: Record<string, unknown>): Promise<T>;
+    close(): void;
+    private rejectPending;
+    private connect;
+    private scheduleReconnect;
+    private onMessage;
+    /**
+     * Start the bridge as a detached child so it survives this MCP process.
+     * Losing the bind race is normal and silent — it means a bridge already runs.
+     */
+    private spawnBridge;
+}

package/dist/bridge/client.js

@@ -0,0 +1,214 @@
+/**
+ * Control client: the MCP server's half of the link to Aseprite.
+ *
+ * Responsibilities beyond "send JSON":
+ *  - spawn the bridge if nothing owns the control port yet (zero-setup goal);
+ *  - reconnect with backoff, because the bridge may be restarted under us;
+ *  - track `pluginConnected` from bridge_state so `preflight` can answer
+ *    truthfully without a round-trip to Aseprite.
+ */
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { WebSocket } from "ws";
+import { DEFAULT_CONTROL_PORT, LiveError, isBridgeState, isResult, notConnected, } from "../lib/protocol.js";
+const DEFAULT_TIMEOUT_MS = 20_000;
+const RECONNECT_BASE_MS = 250;
+const RECONNECT_MAX_MS = 5_000;
+/** Floor between bridge spawn attempts, so a failing spawn cannot become a fork bomb. */
+const SPAWN_COOLDOWN_MS = 10_000;
+export class LiveClient {
+    controlPort;
+    pluginPort;
+    autoSpawn;
+    timeoutMs;
+    log;
+    socket = null;
+    pending = new Map();
+    seq = 0;
+    reconnectDelay = RECONNECT_BASE_MS;
+    reconnectTimer = null;
+    closed = false;
+    lastSpawnAt = 0;
+    state = null;
+    constructor(opts = {}) {
+        this.controlPort = opts.controlPort ?? DEFAULT_CONTROL_PORT;
+        this.pluginPort = opts.pluginPort ?? this.controlPort - 1;
+        this.autoSpawn = opts.autoSpawnBridge ?? true;
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.log = opts.log ?? (() => { });
+        this.connect();
+    }
+    get bridgeConnected() {
+        return this.socket?.readyState === WebSocket.OPEN;
+    }
+    get pluginConnected() {
+        return this.bridgeConnected && this.state?.pluginConnected === true;
+    }
+    get hello() {
+        return this.state?.hello ?? null;
+    }
+    get features() {
+        return this.state?.hello?.features ?? [];
+    }
+    hasFeature(name) {
+        return this.features.includes(name);
+    }
+    /** Wait until the bridge link is up (not necessarily Aseprite). */
+    async waitForBridge(ms = 3_000) {
+        const deadline = Date.now() + ms;
+        while (Date.now() < deadline) {
+            if (this.bridgeConnected && this.state)
+                return true;
+            await sleep(50);
+        }
+        return this.bridgeConnected;
+    }
+    /** Wait until Aseprite itself is attached. */
+    async waitForPlugin(ms = 3_000) {
+        const deadline = Date.now() + ms;
+        while (Date.now() < deadline) {
+            if (this.pluginConnected)
+                return true;
+            await sleep(50);
+        }
+        return this.pluginConnected;
+    }
+    async call(cmd, args = {}) {
+        if (!this.bridgeConnected) {
+            await this.waitForBridge(2_000);
+            if (!this.bridgeConnected)
+                throw notConnected("Bridge process is not reachable.");
+        }
+        if (!this.pluginConnected)
+            throw notConnected();
+        const id = `r${++this.seq}`;
+        const frame = { id, cmd, args };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new LiveError("timeout", `Aseprite did not answer '${cmd}' within ${this.timeoutMs}ms.`, {
+                    cmd,
+                    doNotFallBackToDisk: true,
+                }));
+            }, this.timeoutMs);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            this.socket.send(JSON.stringify(frame));
+        });
+    }
+    close() {
+        this.closed = true;
+        if (this.reconnectTimer)
+            clearTimeout(this.reconnectTimer);
+        this.rejectPending(new LiveError("not_connected", "Client closed."));
+        this.socket?.close();
+    }
+    rejectPending(err) {
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    // ── internals ──────────────────────────────────────────────────────────────
+    connect() {
+        if (this.closed)
+            return;
+        const socket = new WebSocket(`ws://127.0.0.1:${this.controlPort}`);
+        this.socket = socket;
+        socket.on("open", () => {
+            this.reconnectDelay = RECONNECT_BASE_MS;
+            this.log(`control link up on :${this.controlPort}`);
+        });
+        socket.on("message", (raw) => this.onMessage(raw.toString()));
+        socket.on("error", () => {
+            // Suppressed: 'close' always follows and owns the retry path.
+        });
+        socket.on("close", () => {
+            this.state = null;
+            // Fail in-flight calls now. Letting each wait out its own 20s timeout
+            // turns a known disconnect into what an agent reads as "Aseprite is slow"
+            // — and slow is the reading that makes it try something else.
+            this.rejectPending(notConnected("The bridge connection dropped while this call was in flight."));
+            if (this.closed)
+                return;
+            if (this.autoSpawn) {
+                // Retry the spawn on a later reconnect too: a bridge that died after we
+                // started it would otherwise leave this client looping forever with no
+                // recovery short of the user restarting things by hand.
+                const now = Date.now();
+                if (now - this.lastSpawnAt > SPAWN_COOLDOWN_MS) {
+                    this.lastSpawnAt = now;
+                    this.spawnBridge();
+                }
+            }
+            this.scheduleReconnect();
+        });
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const delay = this.reconnectDelay;
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, RECONNECT_MAX_MS);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+        // A pending retry must never be the reason a process stays alive: the
+        // stdio transport owns the server's lifetime, and in tests an un-unref'd
+        // timer turns a failed assertion into a hang.
+        this.reconnectTimer.unref?.();
+    }
+    onMessage(raw) {
+        let frame;
+        try {
+            frame = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (isBridgeState(frame)) {
+            this.state = frame;
+            return;
+        }
+        if (!isResult(frame))
+            return;
+        const result = frame;
+        const pending = this.pending.get(result.id);
+        if (!pending)
+            return;
+        this.pending.delete(result.id);
+        clearTimeout(pending.timer);
+        if (result.ok) {
+            pending.resolve(result.data ?? {});
+        }
+        else {
+            const err = result.error;
+            pending.reject(new LiveError(err?.code ?? "aseprite_error", err?.message ?? "Aseprite reported an unspecified failure.", err?.details ?? {}));
+        }
+    }
+    /**
+     * Start the bridge as a detached child so it survives this MCP process.
+     * Losing the bind race is normal and silent — it means a bridge already runs.
+     */
+    spawnBridge() {
+        try {
+            const here = path.dirname(fileURLToPath(import.meta.url));
+            const cli = path.resolve(here, "..", "cli.js");
+            const child = spawn(process.execPath, [cli, "bridge", "--plugin-port", String(this.pluginPort), "--control-port", String(this.controlPort)], { detached: true, stdio: "ignore" });
+            child.unref();
+            this.log("spawned bridge process");
+        }
+        catch (err) {
+            this.log(`bridge spawn failed: ${err.message}`);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/bridge/client.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/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
+ */
+export {};