diagram-tool 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# Diagram Tool — agent-drawn Excalidraw on localhost, synced via a context file
+
+No API key needed. Your coding agent is the LLM — `diagram-tool` only validates Mermaid, renders the scene, and serves the live UI.
+
+## Recommended: MCP server (any coding agent)
+
+```json
+{ "mcpServers": { "diagram-tool": { "command": "npx", "args": ["-y", "diagram-tool", "mcp"] } } }
+```
+
+Or auto-write it:
+
+```bash
+npm i -g diagram-tool        # or npx -y diagram-tool mcp (no install)
+diagram-tool mcp-install --agent auto   # auto|opencode|claude|cursor|vscode
+```
+
+Then ask your agent to draw something, open the returned `url` once — it live-updates on every render.
+
+Tools: `render_diagram(mermaidSource, prompt?, decorations?)` · `get_diagram()` · `list_libraries(query?)` · `list_library_items(library)` · resource `diagram-tool://guide`. Full authoring doc: [GUIDE.md](GUIDE.md) (also served to agents via the guide resource, so no LLM setup is needed).
+
+## The context file (source of truth)
+
+Everything revolves around `diagram-tool.context.json`:
+
+```json
+{ "version": 1, "rev": 3, "prompt": "...", "mermaidSource": "...",
+  "scene": { "type": "excalidraw", "version": 2, "elements": [...] } }
+```
+
+- MCP/CLI writes it on every render (bumps `rev`, writes `.excalidraw.json` + `.mmd` sidecars).
+- UI autosaves canvas edits back to it (`POST /api/scene`, debounced; stale `rev` → 409 + fresh copy).
+- UI subscribes to SSE `GET /api/live` (Hono server watches the file) and refetches on rev bumps, so agent edits appear in the open canvas without reload.
+
+## Shell fallback (no MCP)
+
+```bash
+diagram-tool render --no-serve   # re-derive scene from the context file's mermaidSource
+diagram-tool serve               # just the UI (default http://localhost:3000)
+```
+
+Agent loop without MCP: edit `mermaidSource` in the context file, run `diagram-tool render --no-serve`. Structural changes belong in `mermaidSource` + render; small canvas nudges can go straight into `scene.elements`.
+
+## Libraries (excalidraw-libs)
+
+`libraries/*.excalidrawlib` (v1 + v2) are served at `GET /api/libraries` for hand drag-drop, and composited server-side via `decorations` for agent renders. 6 payloads ship offline (network-topology, dev-ops, systemdesignicons, UML-ER, awesome-icons, system-icons); the full ~100-library catalog is searchable via `list_libraries` and fetched on demand into `~/.cache/diagram-tool/libraries/`.
+
+- `diagram-tool library list` — downloaded files + item count
+- `diagram-tool library add <name>` — download from libraries.excalidraw.com (e.g. `diagram-tool library add aws`)
+- Node icon classes also work: `class USER actor,icon_user` (slugs: `icon_user`, `icon_users`, `icon_home`, `icon_lock`, `icon_search`, `icon_chart`, `icon_email`, `icon_calendar`, `icon_location`, `icon_payment`)
+
+Rule of thumb: cloud/architecture/network diagrams get ≤6 icons; logic flowcharts and sequence/ER/class diagrams stay pure mermaid.
+
+## BYOK fallback (optional, needs a key)
+
+```bash
+cp .env.example .env   # OPENROUTER_API_KEY=sk-or-...
+diagram-tool "draw the request lifecycle of a REST API" --provider openrouter
+diagram-tool edit "add a retry step" --provider openrouter
+```
+
+Flags: `--provider openai|anthropic|google|ollama|openrouter`, `--model`, `--api-key`, `--base-url`, `--port`, `--no-serve`, `--context`.
+
+Pipeline: few-shot prompt → strict Mermaid parse → up to 2 self-repairs (parser error fed back) → `mermaid-to-excalidraw`. Server-side geometry is approximated from text length (jsdom `getBBox` shim); browser is truth.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+/**
+ * diagram-tool — CLI + localhost React canvas around one context file.
+ *
+ *   diagram-tool "draw a login flowchart"   # generate -> context file -> serve UI
+ *   diagram-tool edit "add a payment step"  # follow-up via CLI
+ *   diagram-tool render [file.mmd]          # re-derive scene from context (or file) mermaid
+ *   diagram-tool serve                      # just serve the UI
+ *
+ * UI edits autosave to the same context file. OpenCode loop: prompt OpenCode
+ * to edit diagram-tool.context.json's mermaidSource, then `diagram-tool render`.
+ */
+import { readFile } from "node:fs/promises";
+import { DEFAULT_CONTEXT, loadContext, saveContext } from "./context.js";
+import { convertToScene, generate } from "./diagram.js";
+import { serve } from "./server.js";
+import { runMcp } from "./mcp.js";
+import { DEFAULT_MODELS } from "./llm.js";
+const PROVIDERS = ["openai", "anthropic", "google", "ollama", "openrouter"];
+function help() {
+    return `diagram-tool — Mermaid -> Excalidraw on localhost, synced through a context file.
+No API key needed for MCP / render / serve (the agent is the LLM).
+
+Usage:
+  diagram-tool mcp [--context <file>] [--port <n>] [--no-serve]
+                                   MCP stdio server for any coding agent (recommended)
+  diagram-tool mcp-install [--agent auto|opencode|claude|cursor|vscode]
+                                   write the MCP snippet into your agent config
+  diagram-tool render [file.mmd]          re-derive scene from context (or given) mermaid, no LLM
+  diagram-tool serve                      serve the UI for the context file
+  diagram-tool library list               list downloaded libraries
+  diagram-tool library add <name>         download a library from libraries.excalidraw.com
+  diagram-tool "..." [options]            generate via BYOK provider (optional fallback, needs key)
+  diagram-tool edit "..." [options]       follow-up edit via BYOK provider
+
+Options:
+  --context <file>   context file (default ${DEFAULT_CONTEXT})
+  --agent <a>        mcp-install target (default auto)
+  --provider <p>     BYOK only: ${PROVIDERS.join("|")} (default $DIAGRAM_TOOL_PROVIDER or openai)
+  --model <name>     BYOK only (default per provider)
+  --api-key <key>    BYOK (or $OPENAI_API_KEY / $ANTHROPIC_API_KEY / $GOOGLE_API_KEY / $OPENROUTER_API_KEY)
+  --base-url <url>   proxy / Ollama host
+  --port <n>         (default 3000, $DIAGRAM_TOOL_PORT)
+  --no-serve         don't start the UI after generate/edit/render (mcp: file-only mode)
+
+Agent loop (no key): connect diagram-tool mcp, ask the agent to draw, open the
+returned url once — it live-updates. Shell fallback: edit "mermaidSource"
+in ${DEFAULT_CONTEXT}, then \`diagram-tool render --no-serve\`.`;
+}
+function parseFlags(argv) {
+    const flags = {
+        context: process.env.DIAGRAM_TOOL_CONTEXT || process.env.FORGE_CONTEXT || DEFAULT_CONTEXT,
+        provider: (process.env.DIAGRAM_TOOL_PROVIDER || process.env.FORGE_PROVIDER) || "openai",
+        model: process.env.DIAGRAM_TOOL_MODEL || process.env.FORGE_MODEL || "gpt-4.1-mini",
+        modelSet: !!(process.env.DIAGRAM_TOOL_MODEL || process.env.FORGE_MODEL),
+        port: Number(process.env.DIAGRAM_TOOL_PORT || process.env.FORGE_PORT || 3000),
+        serveAfter: true,
+        agent: "auto",
+    };
+    if (process.env.DIAGRAM_TOOL_API_KEY || process.env.FORGE_API_KEY) {
+        flags.apiKey = process.env.DIAGRAM_TOOL_API_KEY || process.env.FORGE_API_KEY;
+    }
+    if (process.env.DIAGRAM_TOOL_BASE_URL || process.env.FORGE_BASE_URL) {
+        flags.baseUrl = process.env.DIAGRAM_TOOL_BASE_URL || process.env.FORGE_BASE_URL;
+    }
+    const rest = [];
+    for (let i = 0; i < argv.length; i++) {
+        const t = argv[i];
+        const next = () => {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new Error(`flag ${t} needs a value`);
+            return v;
+        };
+        if (t === "--help" || t === "-h") {
+            console.log(help());
+            process.exit(0);
+        }
+        else if (t === "--context")
+            flags.context = next();
+        else if (t === "--agent")
+            flags.agent = next();
+        else if (t === "--provider")
+            flags.provider = next();
+        else if (t === "--model") {
+            flags.model = next();
+            flags.modelSet = true;
+        }
+        else if (t === "--api-key")
+            flags.apiKey = next();
+        else if (t === "--base-url")
+            flags.baseUrl = next();
+        else if (t === "--port")
+            flags.port = Number(next());
+        else if (t === "--no-serve")
+            flags.serveAfter = false;
+        else if (t.startsWith("--"))
+            throw new Error(`unknown flag ${t}`);
+        else
+            rest.push(t);
+    }
+    if (!flags.modelSet)
+        flags.model = DEFAULT_MODELS[flags.provider] ?? flags.model;
+    return { flags, rest };
+}
+async function main() {
+    try {
+        const env = await readFile(".env", "utf8");
+        for (const line of env.split("\n")) {
+            const m = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/.exec(line.trim());
+            if (!m || process.env[m[1]] !== undefined)
+                continue;
+            let v = m[2].trim();
+            if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'")))
+                v = v.slice(1, -1);
+            process.env[m[1]] = v;
+        }
+    }
+    catch {
+        /* no .env — fine */
+    }
+    const { flags: f, rest } = parseFlags(process.argv.slice(2));
+    if (!PROVIDERS.includes(f.provider))
+        throw new Error(`unknown provider "${f.provider}" (${PROVIDERS.join("|")})`);
+    const [cmd, ...cmdRest] = rest;
+    if (!cmd) {
+        console.log(help());
+        process.exit(1);
+    }
+    if (cmd === "serve") {
+        await serve(f.context, f.port);
+        return;
+    }
+    if (cmd === "mcp") {
+        await runMcp({ context: f.context, port: f.port, noServe: !f.serveAfter });
+        return;
+    }
+    if (cmd === "mcp-install") {
+        const { installMcp } = await import("./mcp-install.js");
+        await installMcp(f.agent);
+        return;
+    }
+    if (cmd === "library") {
+        const { readdir } = await import("node:fs/promises");
+        const { existsSync } = await import("node:fs");
+        const sub = cmdRest[0];
+        if (sub === "list" || !sub) {
+            const { loadLibraryItems, libraryDir } = await import("./library.js");
+            const dir = libraryDir();
+            if (!existsSync(dir)) {
+                console.log("no libraries/ directory");
+                return;
+            }
+            const files = (await readdir(dir)).filter((x) => x.endsWith(".excalidrawlib"));
+            const items = await loadLibraryItems(dir);
+            console.log(`${files.length} files, ${items.length} items:`);
+            for (const x of files)
+                console.log(`  ${x}`);
+            return;
+        }
+        if (sub === "add") {
+            const query = (cmdRest[1] ?? "").toLowerCase();
+            if (!query)
+                throw new Error("usage: diagram-tool library add <name>  (e.g. diagram-tool library add aws)");
+            console.error("fetching library index…");
+            const res = await fetch("https://raw.githubusercontent.com/excalidraw/excalidraw-libs/main/libraries.json");
+            if (!res.ok)
+                throw new Error(`index fetch failed: HTTP ${res.status}`);
+            const index = (await res.json());
+            const hit = index.find((l) => l.name.toLowerCase().includes(query));
+            if (!hit)
+                throw new Error(`no library matching "${query}" (try a shorter term)`);
+            const { mkdir, writeFile } = await import("node:fs/promises");
+            await mkdir("libraries", { recursive: true });
+            const url = `https://raw.githubusercontent.com/excalidraw/excalidraw-libs/main/libraries/${hit.source}`;
+            console.error(`downloading ${hit.name}…`);
+            const dl = await fetch(url);
+            if (!dl.ok)
+                throw new Error(`download failed: HTTP ${dl.status}`);
+            const dest = `libraries/${hit.source.split("/").pop()}`;
+            await writeFile(dest, Buffer.from(await dl.arrayBuffer()));
+            console.log(`added ${hit.name} -> ${dest} (restart diagram-tool serve to load)`);
+            return;
+        }
+        throw new Error(`unknown library command "${sub}" (list|add)`);
+    }
+    if (cmd === "render") {
+        const mmdFile = cmdRest[0];
+        let mermaidSource;
+        if (mmdFile) {
+            mermaidSource = (await readFile(mmdFile, "utf8")).trim();
+        }
+        else {
+            mermaidSource = (await loadContext(f.context)).mermaidSource;
+            if (!mermaidSource.trim())
+                throw new Error(`no mermaidSource in ${f.context} (and no file given)`);
+        }
+        const scene = await convertToScene(mermaidSource);
+        const next = await saveContext(f.context, { mermaidSource, elements: scene.elements });
+        console.log(`rendered rev ${next.rev} into ${f.context} (${scene.elements.length} elements)`);
+        if (f.serveAfter)
+            await serve(f.context, f.port);
+        return;
+    }
+    const isEdit = cmd === "edit";
+    const prompt = (isEdit ? cmdRest : rest).join(" ");
+    if (!prompt) {
+        console.log(help());
+        process.exit(1);
+    }
+    let existingMermaid;
+    if (isEdit) {
+        existingMermaid = (await loadContext(f.context)).mermaidSource;
+        if (!existingMermaid.trim())
+            throw new Error(`${f.context} has no mermaidSource to edit yet — generate first.`);
+    }
+    console.error(`asking ${f.provider}/${f.model} ...`);
+    const t0 = Date.now();
+    const r = await generate(prompt, {
+        provider: f.provider,
+        model: f.model,
+        ...(f.apiKey ? { apiKey: f.apiKey } : {}),
+        ...(f.baseUrl ? { baseUrl: f.baseUrl } : {}),
+        ...(existingMermaid ? { existingMermaid } : {}),
+    });
+    const next = await saveContext(f.context, {
+        prompt,
+        mermaidSource: r.mermaidSource,
+        elements: r.scene.elements,
+    });
+    console.error(`done in ${((Date.now() - t0) / 1000).toFixed(1)}s — rev ${next.rev} in ${f.context} (${r.scene.elements.length} elements${r.repaired ? `, repaired after ${r.attempts} attempts` : ""})`);
+    if (f.serveAfter)
+        await serve(f.context, f.port);
+}
+main().catch((e) => {
+    console.error(`error: ${e instanceof Error ? e.message : String(e)}`);
+    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/context.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The context file is the single source of truth shared by CLI, UI and agents.
+ * OpenCode workflow: read it, change `mermaidSource` (or `elements`), then run
+ * `diagram-tool render` to re-derive the scene — or just edit elements directly.
+ */
+export interface DiagramContext {
+    version: 1;
+    /** incremented on every write; UI polls this to pick up CLI/agent edits */
+    rev: number;
+    prompt: string;
+    mermaidSource: string;
+    scene: {
+        type: "excalidraw";
+        version: 2;
+        elements: unknown[];
+    };
+    updatedAt: string;
+}
+export declare const DEFAULT_CONTEXT = "diagram-tool.context.json";
+/** Pre-rename default. Read as fallback; first save migrates to DEFAULT_CONTEXT. */
+export declare const LEGACY_CONTEXT = "diagramforge.context.json";
+export declare function blankContext(prompt?: string): DiagramContext;
+export declare function loadContext(path: string): Promise<DiagramContext>;
+/** Applies patch, bumps rev, writes file + sidecars. Returns the new context. */
+export declare function saveContext(path: string, patch: Partial<Pick<DiagramContext, "prompt" | "mermaidSource">> & {
+    elements?: unknown[];
+}): Promise<DiagramContext>;

package/dist/context.js

@@ -0,0 +1,55 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+export const DEFAULT_CONTEXT = "diagram-tool.context.json";
+/** Pre-rename default. Read as fallback; first save migrates to DEFAULT_CONTEXT. */
+export const LEGACY_CONTEXT = "diagramforge.context.json";
+export function blankContext(prompt = "") {
+    return {
+        version: 1,
+        rev: 0,
+        prompt,
+        mermaidSource: "",
+        scene: { type: "excalidraw", version: 2, elements: [] },
+        updatedAt: new Date().toISOString(),
+    };
+}
+export async function loadContext(path) {
+    if (!existsSync(path) && path === DEFAULT_CONTEXT && existsSync(LEGACY_CONTEXT)) {
+        path = LEGACY_CONTEXT; // pre-rename file: read it, next save migrates
+    }
+    if (!existsSync(path))
+        return blankContext();
+    const raw = await readFile(path, "utf8");
+    const c = JSON.parse(raw);
+    if (!c.scene)
+        c.scene = { type: "excalidraw", version: 2, elements: [] };
+    if (typeof c.rev !== "number")
+        c.rev = 0;
+    if (typeof c.mermaidSource !== "string")
+        c.mermaidSource = "";
+    return c;
+}
+/** Applies patch, bumps rev, writes file + sidecars. Returns the new context. */
+export async function saveContext(path, patch) {
+    const prev = await loadContext(path);
+    const next = {
+        ...prev,
+        version: 1,
+        rev: prev.rev + 1,
+        updatedAt: new Date().toISOString(),
+        ...(patch.prompt !== undefined ? { prompt: patch.prompt } : {}),
+        ...(patch.mermaidSource !== undefined ? { mermaidSource: patch.mermaidSource } : {}),
+        scene: {
+            type: "excalidraw",
+            version: 2,
+            elements: patch.elements !== undefined ? patch.elements : prev.scene.elements,
+        },
+    };
+    await writeFile(path, JSON.stringify(next, null, 2));
+    // sidecars for direct import into excalidraw.com
+    const base = path.replace(/\.context\.json$/, "").replace(/\.json$/, "");
+    await writeFile(`${base}.excalidraw.json`, JSON.stringify({ ...next.scene, source: "diagram-tool", appState: {} }, null, 2));
+    await writeFile(`${base}.mmd`, (next.mermaidSource ? next.mermaidSource + "\n" : ""));
+    return next;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/diagram.d.ts

@@ -0,0 +1,51 @@
+import "./dom-shim.js";
+import { type LlmOpts } from "./llm.js";
+export interface Scene {
+    type: "excalidraw";
+    version: 2;
+    source: string;
+    elements: unknown[];
+    appState: Record<string, unknown>;
+}
+export declare function extractMermaid(raw: string): string;
+export declare function validateMermaid(source: string): Promise<string>;
+export declare function convertToScene(mermaidSource: string): Promise<Scene>;
+/** nodeId -> icon slug from `class NODE icon_slug` statements in the source. */
+export declare function parseIconClasses(mermaidSource: string): Map<string, string>;
+/**
+ * Dress node cards with library artwork: icon glyph fitted into the top of
+ * the box, node caption pinned to the bottom strip, all grouped for UI drag.
+ * Unknown slugs / missing libraries degrade to plain boxes (never throw).
+ */
+export declare function applyIcons(elements: Record<string, unknown>[], mermaidSource: string, libraryDir?: string): Promise<Record<string, unknown>[]>;
+/**
+ * Merge parallel arrows (same source id -> same target id) into one. The
+ * model sometimes emits one edge per action (generate/edit/render/serve),
+ * which renders as stacked duplicate arrows. Keeper = first arrow; labels
+ * are concatenated with " · " and surplus arrows + labels removed.
+ */
+export declare function dedupeArrows(elements: Record<string, unknown>[]): Record<string, unknown>[];
+/**
+ * Breathing space pass. The converter packs nodes per its own (often wrong)
+ * measurements, so labels collide. This iteratively pushes overlapping boxes
+ * apart and drags attached arrow endpoints + labels along (arrows here are
+ * free-floating: start/end are plain id refs, no live bindings).
+ */
+export declare function declutter(elements: Record<string, unknown>[]): Record<string, unknown>[];
+/**
+ * @excalidraw/mermaid-to-excalidraw v2 emits node text as a non-standard
+ * `label: { text, fontSize }` prop that the canvas ignores. Rewrite each into
+ * a real bound `text` element wired via containerId/boundElements.
+ */
+export declare function withBoundLabels(elements: Record<string, unknown>[]): Record<string, unknown>[];
+export interface GenerateOpts extends LlmOpts {
+    existingMermaid?: string;
+}
+export interface GenerateResult {
+    scene: Scene;
+    mermaidSource: string;
+    attempts: number;
+    repaired: boolean;
+}
+/** Prompt -> Mermaid -> validate (2 repairs, error fed back) -> Excalidraw scene. */
+export declare function generate(prompt: string, opts: GenerateOpts): Promise<GenerateResult>;