brainferno-mcp-bridge 0.1.0

package/dist/install/lib.js

@@ -0,0 +1,194 @@
+import { randomBytes } from "node:crypto";
+import { networkInterfaces } from "node:os";
+import { join } from "node:path";
+import { existsSync, readdirSync } from "node:fs";
+import { INSTALLABLE_APPS, parseApps } from "../config.js";
+export const APP_CHOICES = [
+    { id: "photoshop", label: "Photoshop", folder: /^Adobe Photoshop/i, needs: ["uxp"] },
+    { id: "after_effects", label: "After Effects", folder: /^Adobe After Effects/i, needs: ["cep"] },
+    { id: "premiere", label: "Premiere Pro", folder: /^Adobe Premiere Pro/i, needs: ["uxp"] },
+    { id: "illustrator", label: "Illustrator", folder: /^Adobe Illustrator/i, needs: ["illustrator-key"] },
+    { id: "audition", label: "Audition", folder: /^Adobe Audition/i, needs: ["cep"] },
+    { id: "media_encoder", label: "Media Encoder", folder: /^Adobe Media Encoder/i, needs: ["ame-ini"] },
+];
+/** Which of the six are installed, judged by their app folders. */
+export function detectInstalledApps(platform = process.platform) {
+    const root = platform === "win32" ? join(process.env["ProgramFiles"] ?? "C:\\Program Files", "Adobe") : platform === "darwin" ? "/Applications" : "";
+    if (!root || !existsSync(root))
+        return [];
+    let names;
+    try {
+        names = readdirSync(root);
+    }
+    catch {
+        return [];
+    }
+    return APP_CHOICES.filter((c) => names.some((n) => c.folder.test(n))).map((c) => c.id);
+}
+/** "1,3,5", "1 3", "all", or app names → app ids (in canonical order). */
+export function pickApps(answer, fallback) {
+    const a = answer.trim().toLowerCase();
+    if (a === "")
+        return [...fallback];
+    if (a === "all" || a === "*")
+        return [...INSTALLABLE_APPS];
+    if (/^[\d,\s]+$/.test(a)) {
+        const idx = a.split(/[,\s]+/).filter(Boolean).map(Number);
+        return APP_CHOICES.filter((_, i) => idx.includes(i + 1)).map((c) => c.id);
+    }
+    // Names like "ps, ae" — the config parser throws on unknown names.
+    return parseApps(answer);
+}
+export function appsNeed(apps, need) {
+    return APP_CHOICES.some((c) => apps.includes(c.id) && c.needs.includes(need));
+}
+export const DEFAULT_HTTP_PORT = 7898;
+export function randomToken() {
+    return randomBytes(24).toString("base64url");
+}
+/** Non-internal IPv4 addresses, the ones other machines can reach. */
+export function lanAddresses() {
+    const out = [];
+    for (const list of Object.values(networkInterfaces())) {
+        for (const i of list ?? [])
+            if (i.family === "IPv4" && !i.internal)
+                out.push(i.address);
+    }
+    return out;
+}
+/**
+ * The Illustrator MCP key as the user pasted it: either the bare `ilst_…` key or
+ * the whole `claude mcp add … --header "Authorization: Bearer ilst_…" …` line
+ * Illustrator shows. Returns null when nothing key-like is in there.
+ */
+export function extractIllustratorKey(input) {
+    const s = input.trim();
+    if (s === "")
+        return null;
+    const bearer = /Bearer\s+([A-Za-z0-9_.-]+)/i.exec(s);
+    if (bearer)
+        return bearer[1] ?? null;
+    if (/^[A-Za-z0-9_.-]{12,}$/.test(s))
+        return s;
+    return null;
+}
+/** The endpoint URL from a pasted `claude mcp add` line, if it carries one. */
+export function extractIllustratorUrl(input) {
+    const m = /(https?:\/\/[^\s"']+\/mcp)\b/i.exec(input);
+    return m ? (m[1] ?? null) : null;
+}
+/** Try an MCP initialize against Adobe's Illustrator endpoint with the key. */
+export async function checkIllustratorKey(url, key, timeoutMs = 4000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            signal: controller.signal,
+            headers: { authorization: `Bearer ${key}`, "content-type": "application/json", accept: "application/json, text/event-stream" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2025-03-26", capabilities: {}, clientInfo: { name: "brainferno-mcp-bridge-installer", version: "0.1.0" } } }),
+        });
+        if (res.status === 401 || res.status === 403)
+            return { ok: false, reason: "refused", detail: `HTTP ${res.status}` };
+        if (!res.ok)
+            return { ok: false, reason: "unexpected", detail: `HTTP ${res.status}` };
+        const text = await res.text();
+        const m = /"serverInfo"\s*:\s*\{[^}]*"name"\s*:\s*"([^"]+)"/.exec(text);
+        return { ok: true, serverName: m ? (m[1] ?? null) : null };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, reason: /ECONNREFUSED|abort|fetch failed/i.test(msg) ? "not-running" : "unexpected", detail: msg };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Apply the chosen mode to the user config file (other keys untouched). */
+export function mergeUserConfig(existing, mode, o = {}) {
+    const next = { ...existing };
+    if (o.apps !== undefined) {
+        const all = INSTALLABLE_APPS.every((a) => o.apps.includes(a));
+        if (all)
+            delete next.enabledApps;
+        else
+            next.enabledApps = INSTALLABLE_APPS.filter((a) => o.apps.includes(a));
+    }
+    if (o.illustratorKey !== undefined) {
+        if (o.illustratorKey === null)
+            delete next.illustratorKey;
+        else
+            next.illustratorKey = o.illustratorKey;
+    }
+    if (o.illustratorUrl !== undefined) {
+        if (o.illustratorUrl === null)
+            delete next.illustratorUrl;
+        else
+            next.illustratorUrl = o.illustratorUrl;
+    }
+    if (mode === "local") {
+        delete next.httpPort;
+        delete next.httpHost;
+        delete next.httpToken;
+        return next;
+    }
+    next.httpPort = o.port ?? existing.httpPort ?? DEFAULT_HTTP_PORT;
+    next.httpHost = o.host ?? "0.0.0.0";
+    next.httpToken = o.token ?? existing.httpToken ?? randomToken();
+    return next;
+}
+/**
+ * Media Encoder's web-service ini: local pins `ip = 127.0.0.1`; shared leaves
+ * the address to the service (it picks a LAN adapter). Other lines are kept.
+ */
+export function rewriteAmeIni(ini, mode) {
+    const lines = ini.split(/\r?\n/);
+    let seen = false;
+    const out = lines.map((line) => {
+        const m = /^\s*(#\s*)?ip\s*=\s*(.*)$/.exec(line);
+        if (!m)
+            return line;
+        seen = true;
+        return mode === "local" ? "ip = 127.0.0.1" : "#ip = 127.0.0.1";
+    });
+    if (!seen && mode === "local")
+        out.unshift("ip = 127.0.0.1");
+    const eol = ini.includes("\r\n") ? "\r\n" : "\n";
+    return out.join(eol);
+}
+export function platformPaths(platform, home, appData) {
+    if (platform === "win32") {
+        const roaming = appData ?? join(home, "AppData", "Roaming");
+        const pf = process.env["ProgramFiles"] ?? "C:\\Program Files";
+        return {
+            cepExtensionsDir: join(roaming, "Adobe", "CEP", "extensions"),
+            csxsDebugCommands: [11, 12, 13, 14].map((v) => ["reg", "add", `HKCU\\Software\\Adobe\\CSXS.${v}`, "/v", "PlayerDebugMode", "/t", "REG_SZ", "/d", "1", "/f"]),
+            ameIniCandidates: [2027, 2026, 2025, 2024].map((y) => join(pf, "Adobe", `Adobe Media Encoder ${y}`, "ame_webservice_config.ini")),
+        };
+    }
+    if (platform === "darwin") {
+        return {
+            cepExtensionsDir: join(home, "Library", "Application Support", "Adobe", "CEP", "extensions"),
+            csxsDebugCommands: [11, 12, 13, 14].map((v) => ["defaults", "write", `com.adobe.CSXS.${v}`, "PlayerDebugMode", "1"]),
+            ameIniCandidates: [2027, 2026, 2025, 2024].map((y) => join("/Applications", `Adobe Media Encoder ${y}`, "ame_webservice_config.ini")),
+        };
+    }
+    return { cepExtensionsDir: join(home, ".brainferno-mcp-bridge", "cep-extensions-unsupported"), csxsDebugCommands: [], ameIniCandidates: [] };
+}
+/** Windows Defender Firewall rule for the remote port, private networks only. */
+export function firewallCommands(platform, mode, port) {
+    if (platform !== "win32")
+        return [];
+    const name = "Brainferno MCP Bridge (remote MCP)";
+    const del = ["netsh", "advfirewall", "firewall", "delete", "rule", `name=${name}`];
+    if (mode === "local")
+        return [del];
+    return [del, ["netsh", "advfirewall", "firewall", "add", "rule", `name=${name}`, "dir=in", "action=allow", "protocol=TCP", `localport=${port}`, "profile=private"]];
+}
+/** The `claude mcp add` lines to print/run. */
+export function mcpAddCommands(o) {
+    const local = `claude mcp add --scope user brainferno -- node "${o.distIndex}"`;
+    const remote = o.mode === "shared" ? o.addresses.map((a) => `claude mcp add --scope user --transport http --header "Authorization: Bearer ${o.token}" brainferno http://${a}:${o.port}/mcp`) : [];
+    return { local, remote };
+}
+//# sourceMappingURL=lib.js.map

package/dist/install/lib.js.map

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

package/dist/jobs.d.ts

@@ -0,0 +1,117 @@
+/**
+ * In-memory job registry for anything that runs longer than a tool call
+ * should block: aerender, Premiere exports, and the cross-app pipelines.
+ *
+ * A job is a named list of steps run in order. Each step's result is kept,
+ * failures record which step broke and which tool recovers it, and a job can
+ * be cancelled between steps (process-lane steps also get an AbortSignal so
+ * a running ffmpeg/aerender is killed). Every job gets a private work folder
+ * under `<workRoot>/<jobId>/` for cross-app hand-offs.
+ */
+export type JobStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled";
+export type StepStatus = "pending" | "running" | "succeeded" | "failed" | "skipped";
+export interface JobContext {
+    readonly jobId: string;
+    readonly workDir: string;
+    readonly signal: AbortSignal;
+    /** Append a line to the job log (tail kept) and make it the progress message. */
+    log(message: string): void;
+    /** Report progress inside the current step (0–100). */
+    progress(message: string, percent?: number): void;
+    /** Record a file the job produced. */
+    artifact(path: string): void;
+}
+export interface JobStepDef {
+    name: string;
+    /** Tool to call by hand when this step fails. */
+    recoveryTool?: string;
+    /** Return false to skip this step (recorded as skipped). */
+    when?: (previous: unknown[]) => boolean;
+    run: (ctx: JobContext, previous: unknown[]) => Promise<unknown>;
+}
+export interface JobStep {
+    name: string;
+    status: StepStatus;
+    recoveryTool?: string;
+    startedAt?: number;
+    finishedAt?: number;
+    result?: unknown;
+    error?: string;
+}
+export interface JobFailure {
+    step: string;
+    message: string;
+    recoveryTool?: string;
+    completedSteps: string[];
+}
+export interface JobProgress {
+    step: string | null;
+    stepIndex: number;
+    stepCount: number;
+    percent: number;
+    message: string;
+}
+export interface Job {
+    id: string;
+    kind: string;
+    status: JobStatus;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    workDir: string;
+    steps: JobStep[];
+    progress: JobProgress;
+    artifacts: string[];
+    log: string[];
+    result?: unknown;
+    error?: JobFailure;
+}
+export declare class JobCancelledError extends Error {
+    constructor(jobId: string);
+}
+export declare class JobRegistry {
+    private readonly options;
+    private readonly jobs;
+    constructor(options: {
+        workRoot: string;
+        keep?: number;
+    });
+    /** Start a job now. Resolves `done` when it reaches a terminal state (never rejects). */
+    start(kind: string, steps: JobStepDef[], finalize?: (results: unknown[], job: Job) => unknown): {
+        job: Job;
+        done: Promise<Job>;
+    };
+    get(id: string): Job | undefined;
+    list(limit?: number): Job[];
+    /** Request cancellation. Returns false if the job is unknown or already finished. */
+    cancel(id: string): boolean;
+    /** Wait for a terminal state or the timeout; `onTick` fires every ~2 s with the live job. */
+    wait(id: string, timeoutMs: number, onTick?: (job: Job) => void): Promise<Job>;
+    private prune;
+    private execute;
+}
+export declare function isTerminal(status: JobStatus): boolean;
+/** JSON-safe view of a job for tool results (no internal handles, bounded log). */
+export declare function jobView(job: Job, options?: {
+    includeLog?: boolean;
+}): {
+    log?: string[] | undefined;
+    error?: JobFailure | undefined;
+    result?: {} | null | undefined;
+    jobId: string;
+    kind: string;
+    status: JobStatus;
+    createdAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+    elapsedSeconds: number;
+    progress: JobProgress;
+    steps: {
+        recoveryTool?: string | undefined;
+        error?: string | undefined;
+        name: string;
+        status: StepStatus;
+    }[];
+    artifacts: string[];
+    workDir: string;
+};

package/dist/jobs.js

@@ -0,0 +1,196 @@
+import { randomUUID } from "node:crypto";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+export class JobCancelledError extends Error {
+    constructor(jobId) {
+        super(`Job ${jobId} was cancelled.`);
+        this.name = "JobCancelledError";
+    }
+}
+const LOG_TAIL = 200;
+export class JobRegistry {
+    options;
+    jobs = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    /** Start a job now. Resolves `done` when it reaches a terminal state (never rejects). */
+    start(kind, steps, finalize) {
+        const id = randomUUID();
+        const job = {
+            id,
+            kind,
+            status: "queued",
+            createdAt: Date.now(),
+            workDir: join(this.options.workRoot, id),
+            steps: steps.map((s) => ({ name: s.name, status: "pending", ...(s.recoveryTool !== undefined ? { recoveryTool: s.recoveryTool } : {}) })),
+            progress: { step: null, stepIndex: 0, stepCount: steps.length, percent: 0, message: "queued" },
+            artifacts: [],
+            log: [],
+        };
+        const controller = new AbortController();
+        const done = this.execute(job, controller, steps, finalize);
+        this.jobs.set(id, { job, controller, done });
+        this.prune();
+        return { job, done };
+    }
+    get(id) {
+        return this.jobs.get(id)?.job;
+    }
+    list(limit = 50) {
+        return [...this.jobs.values()]
+            .map((r) => r.job)
+            .sort((a, b) => b.createdAt - a.createdAt)
+            .slice(0, limit);
+    }
+    /** Request cancellation. Returns false if the job is unknown or already finished. */
+    cancel(id) {
+        const rec = this.jobs.get(id);
+        if (!rec || isTerminal(rec.job.status))
+            return false;
+        rec.controller.abort(new JobCancelledError(id));
+        return true;
+    }
+    /** Wait for a terminal state or the timeout; `onTick` fires every ~2 s with the live job. */
+    async wait(id, timeoutMs, onTick) {
+        const rec = this.jobs.get(id);
+        if (!rec)
+            throw new Error(`No job ${id}. Call cc_list_jobs.`);
+        const deadline = Date.now() + timeoutMs;
+        let lastTick = 0;
+        while (!isTerminal(rec.job.status) && Date.now() < deadline) {
+            if (onTick && Date.now() - lastTick >= 2000) {
+                lastTick = Date.now();
+                onTick(rec.job);
+            }
+            await Promise.race([rec.done, sleep(500)]);
+        }
+        return rec.job;
+    }
+    prune() {
+        const keep = this.options.keep ?? 100;
+        if (this.jobs.size <= keep)
+            return;
+        const finished = [...this.jobs.entries()].filter(([, r]) => isTerminal(r.job.status)).sort((a, b) => a[1].job.createdAt - b[1].job.createdAt);
+        for (const [id] of finished.slice(0, this.jobs.size - keep))
+            this.jobs.delete(id);
+    }
+    async execute(job, controller, steps, finalize) {
+        const results = [];
+        const completed = [];
+        const setProgress = (i, message, within = 0) => {
+            job.progress = {
+                step: steps[i]?.name ?? null,
+                stepIndex: i,
+                stepCount: steps.length,
+                percent: steps.length === 0 ? 100 : Math.min(100, Math.round(((i + within / 100) / steps.length) * 100)),
+                message,
+            };
+        };
+        const ctx = (i) => ({
+            jobId: job.id,
+            workDir: job.workDir,
+            signal: controller.signal,
+            log: (m) => {
+                job.log.push(m);
+                if (job.log.length > LOG_TAIL)
+                    job.log.splice(0, job.log.length - LOG_TAIL);
+                setProgress(i, m, within(job));
+            },
+            progress: (m, p) => setProgress(i, m, p ?? within(job)),
+            artifact: (p) => {
+                if (!job.artifacts.includes(p))
+                    job.artifacts.push(p);
+            },
+        });
+        const within = (j) => (j.progress.stepIndex === job.progress.stepIndex ? Math.round(((j.progress.percent / 100) * steps.length - j.progress.stepIndex) * 100) : 0);
+        job.status = "running";
+        job.startedAt = Date.now();
+        try {
+            await mkdir(job.workDir, { recursive: true });
+        }
+        catch {
+            /* the work dir is a convenience; steps that need it will fail loudly */
+        }
+        for (let i = 0; i < steps.length; i++) {
+            const def = steps[i];
+            const step = job.steps[i];
+            if (controller.signal.aborted) {
+                job.status = "cancelled";
+                break;
+            }
+            if (def.when && !def.when(results)) {
+                step.status = "skipped";
+                results.push(undefined);
+                continue;
+            }
+            step.status = "running";
+            step.startedAt = Date.now();
+            setProgress(i, `${def.name}…`);
+            try {
+                const value = await def.run(ctx(i), results);
+                step.result = value;
+                step.status = "succeeded";
+                step.finishedAt = Date.now();
+                results.push(value);
+                completed.push(def.name);
+            }
+            catch (e) {
+                step.finishedAt = Date.now();
+                if (controller.signal.aborted || e instanceof JobCancelledError) {
+                    step.status = "skipped";
+                    job.status = "cancelled";
+                    break;
+                }
+                const message = e instanceof Error ? e.message : String(e);
+                step.status = "failed";
+                step.error = message;
+                job.status = "failed";
+                job.error = { step: def.name, message, completedSteps: completed, ...(def.recoveryTool !== undefined ? { recoveryTool: def.recoveryTool } : {}) };
+                break;
+            }
+        }
+        if (job.status === "running") {
+            job.status = "succeeded";
+            try {
+                job.result = finalize ? finalize(results, job) : results;
+            }
+            catch (e) {
+                job.status = "failed";
+                job.error = { step: "finalize", message: e instanceof Error ? e.message : String(e), completedSteps: completed };
+            }
+        }
+        for (const s of job.steps)
+            if (s.status === "pending")
+                s.status = "skipped";
+        job.finishedAt = Date.now();
+        job.progress = { ...job.progress, percent: job.status === "succeeded" ? 100 : job.progress.percent, message: job.status === "succeeded" ? "done" : job.status === "failed" ? `failed at ${job.error?.step ?? "?"}` : job.status };
+        return job;
+    }
+}
+export function isTerminal(status) {
+    return status === "succeeded" || status === "failed" || status === "cancelled";
+}
+/** JSON-safe view of a job for tool results (no internal handles, bounded log). */
+export function jobView(job, options = {}) {
+    return {
+        jobId: job.id,
+        kind: job.kind,
+        status: job.status,
+        createdAt: new Date(job.createdAt).toISOString(),
+        startedAt: job.startedAt !== undefined ? new Date(job.startedAt).toISOString() : null,
+        finishedAt: job.finishedAt !== undefined ? new Date(job.finishedAt).toISOString() : null,
+        elapsedSeconds: job.startedAt !== undefined ? Math.round(((job.finishedAt ?? Date.now()) - job.startedAt) / 1000) : 0,
+        progress: job.progress,
+        steps: job.steps.map((s) => ({ name: s.name, status: s.status, ...(s.error !== undefined ? { error: s.error } : {}), ...(s.recoveryTool !== undefined && s.status === "failed" ? { recoveryTool: s.recoveryTool } : {}) })),
+        artifacts: job.artifacts,
+        workDir: job.workDir,
+        ...(job.result !== undefined ? { result: job.result } : {}),
+        ...(job.error !== undefined ? { error: job.error } : {}),
+        ...(options.includeLog ? { log: job.log.slice(-40) } : {}),
+    };
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,8 @@
+import type { LogLevel } from "./config.js";
+export declare function setLogLevel(level: LogLevel): void;
+export declare const log: {
+    error: (message: string, detail?: unknown) => void;
+    warn: (message: string, detail?: unknown) => void;
+    info: (message: string, detail?: unknown) => void;
+    debug: (message: string, detail?: unknown) => void;
+};

package/dist/logging.js

@@ -0,0 +1,33 @@
+/**
+ * stdout is the MCP wire when running over stdio, so every diagnostic goes to
+ * stderr. Writing a stray console.log anywhere in this server corrupts the
+ * protocol stream — always use this logger.
+ */
+const RANK = { error: 0, warn: 1, info: 2, debug: 3 };
+let threshold = "info";
+export function setLogLevel(level) {
+    threshold = level;
+}
+function emit(level, message, detail) {
+    if (RANK[level] > RANK[threshold])
+        return;
+    const line = `[brainferno-mcp-bridge] ${level.toUpperCase()} ${message}`;
+    process.stderr.write(detail === undefined ? `${line}\n` : `${line} ${format(detail)}\n`);
+}
+function format(detail) {
+    if (detail instanceof Error)
+        return `${detail.name}: ${detail.message}`;
+    try {
+        return JSON.stringify(detail);
+    }
+    catch {
+        return String(detail);
+    }
+}
+export const log = {
+    error: (message, detail) => emit("error", message, detail),
+    warn: (message, detail) => emit("warn", message, detail),
+    info: (message, detail) => emit("info", message, detail),
+    debug: (message, detail) => emit("debug", message, detail),
+};
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,IAAI,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAEhF,IAAI,SAAS,GAAa,MAAM,CAAC;AAEjC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED,SAAS,IAAI,CAAC,KAAe,EAAE,OAAe,EAAE,MAAgB;IAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO;IAC1C,MAAM,IAAI,GAAG,2BAA2B,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,MAAM,CAAC,MAAe;IAC7B,IAAI,MAAM,YAAY,KAAK;QAAE,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;IACxE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,CAAC,OAAe,EAAE,MAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IAC5E,IAAI,EAAE,CAAC,OAAe,EAAE,MAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAC1E,IAAI,EAAE,CAAC,OAAe,EAAE,MAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAC1E,KAAK,EAAE,CAAC,OAAe,EAAE,MAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;CAC7E,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeServer } from "./bridge/socket.js";
+import type { Config } from "./config.js";
+import { AmeWebService } from "./drivers/ame-webservice.js";
+import { IllustratorDelegate } from "./drivers/illustrator-delegate.js";
+import { OsScriptBridge } from "./drivers/osscript.js";
+import { JobRegistry } from "./jobs.js";
+import { type AudioToolOptions } from "./tools/audio.js";
+/**
+ * Everything that lives once per process and is shared by every MCP session:
+ * the panel hub, the panel-less drivers, the job registry, the Media Encoder
+ * service. An McpServer (one per transport session) is cheap and is created
+ * on top of this with {@link createMcpServer}.
+ */
+export interface Runtime {
+    config: Config;
+    bridge: BridgeServer;
+    /** Illustrator is driven panel-less over COM/AppleScript, not through the hub. */
+    illustratorBridge: OsScriptBridge;
+    illustratorDelegate: IllustratorDelegate;
+    jobs: JobRegistry;
+    /** Media Encoder's headless web service, started on demand. */
+    mediaEncoder: AmeWebService;
+    audio: AudioToolOptions;
+}
+export interface BuiltServer extends Runtime {
+    server: McpServer;
+}
+export declare function buildRuntime(config: Config): Runtime;
+/**
+ * A new McpServer with every tool registered against the shared runtime.
+ * Tools are registered unconditionally: an application that has no panel
+ * connected still advertises its tools, and those tools return an actionable
+ * "not connected" error rather than vanishing from the tool list mid-session.
+ */
+export declare function createMcpServer(rt: Runtime): McpServer;
+/** Runtime plus one McpServer (the stdio session). */
+export declare function buildServer(config: Config): BuiltServer;