brainferno-mcp-bridge 0.1.0

package/dist/config.js

@@ -0,0 +1,172 @@
+/** Runtime configuration, read once at startup from the environment. */
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { defaultHandshakePath } from "./bridge/handshake.js";
+export const DEFAULT_ILLUSTRATOR_MCP_URL = "http://localhost:18412/v1/mcp";
+const LOG_LEVELS = ["error", "warn", "info", "debug"];
+const LEGACY_ENV_PREFIX = "ADOBE_CC_MCP_";
+const warnedLegacy = new Set();
+/** Read BRAINFERNO_MCP_X, falling back to the pre-rename ADOBE_CC_MCP_X with a one-time warning. */
+export function envValue(name) {
+    const v = process.env[name];
+    if (v !== undefined)
+        return v;
+    const legacy = name.replace(/^BRAINFERNO_MCP_/, LEGACY_ENV_PREFIX);
+    const l = process.env[legacy];
+    if (l !== undefined && !warnedLegacy.has(legacy)) {
+        warnedLegacy.add(legacy);
+        console.error(`[brainferno-mcp-bridge] WARN ${legacy} is deprecated; rename it to ${name}`);
+    }
+    return l;
+}
+/** Settings live in ~/.brainferno-mcp-bridge; copy config.json from the pre-rename ~/.adobe-cc-mcp once. */
+export function migrateLegacyUserDir(home = homedir()) {
+    const next = join(home, ".brainferno-mcp-bridge");
+    const old = join(home, ".adobe-cc-mcp");
+    try {
+        if (!existsSync(join(next, "config.json")) && existsSync(join(old, "config.json"))) {
+            mkdirSync(next, { recursive: true });
+            copyFileSync(join(old, "config.json"), join(next, "config.json"));
+            try {
+                chmodSync(join(next, "config.json"), 0o600);
+            }
+            catch { /* Windows */ }
+            return old;
+        }
+    }
+    catch {
+        /* best effort */
+    }
+    return null;
+}
+/** Keys the installer may write to `~/.brainferno-mcp-bridge/config.json` (mode 600). */
+/** Everything the installer can switch on or off. */
+export const INSTALLABLE_APPS = ["photoshop", "after_effects", "premiere", "illustrator", "audition", "media_encoder"];
+export function parseApps(raw, fallback = INSTALLABLE_APPS) {
+    if (raw === undefined || raw.trim() === "" || raw.trim().toLowerCase() === "all")
+        return [...fallback];
+    const aliases = {
+        ps: "photoshop",
+        photoshop: "photoshop",
+        ae: "after_effects",
+        aftereffects: "after_effects",
+        after_effects: "after_effects",
+        "after-effects": "after_effects",
+        ppro: "premiere",
+        pr: "premiere",
+        premiere: "premiere",
+        premierepro: "premiere",
+        ai: "illustrator",
+        illustrator: "illustrator",
+        au: "audition",
+        audition: "audition",
+        ame: "media_encoder",
+        mediaencoder: "media_encoder",
+        media_encoder: "media_encoder",
+        "media-encoder": "media_encoder",
+    };
+    const out = [];
+    for (const part of raw.split(/[,\s]+/)) {
+        const id = aliases[part.trim().toLowerCase()];
+        if (!id)
+            throw new Error(`Unknown app "${part}". Use: ${INSTALLABLE_APPS.join(", ")}`);
+        if (!out.includes(id))
+            out.push(id);
+    }
+    return out;
+}
+export function userConfigPath() {
+    return join(homedir(), ".brainferno-mcp-bridge", "config.json");
+}
+/** The user config file, or {} when missing/malformed. */
+export function readUserConfig() {
+    try {
+        const parsed = JSON.parse(readFileSync(userConfigPath(), "utf8"));
+        const out = {};
+        if (Array.isArray(parsed["enabledApps"])) {
+            const apps = parsed["enabledApps"].filter((a) => typeof a === "string" && INSTALLABLE_APPS.includes(a));
+            out.enabledApps = apps;
+        }
+        if (typeof parsed["illustratorKey"] === "string")
+            out.illustratorKey = parsed["illustratorKey"];
+        if (typeof parsed["illustratorUrl"] === "string")
+            out.illustratorUrl = parsed["illustratorUrl"];
+        if (typeof parsed["httpPort"] === "number")
+            out.httpPort = parsed["httpPort"];
+        if (typeof parsed["httpHost"] === "string")
+            out.httpHost = parsed["httpHost"];
+        if (typeof parsed["httpToken"] === "string")
+            out.httpToken = parsed["httpToken"];
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * The Illustrator delegate key: env first, then the user config file, so the
+ * user can paste it once without editing the client config. "" = disabled.
+ */
+function illustratorKeyFromEnvOrFile(file) {
+    const fromEnv = envValue("BRAINFERNO_MCP_ILLUSTRATOR_KEY");
+    if (fromEnv !== undefined && fromEnv !== "")
+        return fromEnv;
+    return file.illustratorKey ?? "";
+}
+function intFromEnv(name, fallback, { allowZero = false } = {}) {
+    const raw = envValue(name);
+    if (raw === undefined || raw === "")
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    const floor = allowZero ? 0 : 1;
+    if (!Number.isFinite(parsed) || parsed < floor) {
+        throw new Error(`${name} must be an integer >= ${floor}, got ${JSON.stringify(raw)}`);
+    }
+    return parsed;
+}
+function boolFromEnv(name) {
+    const raw = envValue(name);
+    return raw === "1" || raw === "true";
+}
+function logLevelFromEnv() {
+    const raw = envValue("BRAINFERNO_MCP_LOG_LEVEL");
+    if (raw === undefined || raw === "")
+        return "info";
+    if (!LOG_LEVELS.includes(raw)) {
+        throw new Error(`BRAINFERNO_MCP_LOG_LEVEL must be one of ${LOG_LEVELS.join(", ")}, got ${raw}`);
+    }
+    return raw;
+}
+export function loadConfig() {
+    const file = readUserConfig();
+    return {
+        // Port 0 is allowed so the OS can assign one (used in tests); the handshake
+        // file makes the real port discoverable regardless.
+        bridgePort: intFromEnv("BRAINFERNO_MCP_BRIDGE_PORT", 7897, { allowZero: true }),
+        bridgeToken: envValue("BRAINFERNO_MCP_BRIDGE_TOKEN") ?? "",
+        bridgeInsecure: boolFromEnv("BRAINFERNO_MCP_BRIDGE_INSECURE"),
+        evalTimeoutMs: intFromEnv("BRAINFERNO_MCP_EVAL_TIMEOUT_MS", 30_000),
+        // 0 disables the heartbeat.
+        heartbeatIntervalMs: intFromEnv("BRAINFERNO_MCP_HEARTBEAT_MS", 15_000, { allowZero: true }),
+        allowRawScripts: boolFromEnv("BRAINFERNO_MCP_ALLOW_RAW_SCRIPTS"),
+        handshakeFilePath: envValue("BRAINFERNO_MCP_HANDSHAKE_FILE") ?? defaultHandshakePath(),
+        allowedOrigins: (envValue("BRAINFERNO_MCP_ALLOWED_ORIGINS") ?? "")
+            .split(",")
+            .map((o) => o.trim())
+            .filter((o) => o !== ""),
+        illustratorMcpUrl: envValue("BRAINFERNO_MCP_ILLUSTRATOR_URL") ?? file.illustratorUrl ?? DEFAULT_ILLUSTRATOR_MCP_URL,
+        illustratorMcpKey: illustratorKeyFromEnvOrFile(file),
+        ffmpegPath: envValue("BRAINFERNO_MCP_FFMPEG") ?? "ffmpeg",
+        ffprobePath: envValue("BRAINFERNO_MCP_FFPROBE") ?? "ffprobe",
+        ameWebServicePath: envValue("BRAINFERNO_MCP_AME_WEBSERVICE") ?? "",
+        amePort: intFromEnv("BRAINFERNO_MCP_AME_PORT", 0, { allowZero: true }),
+        ameIdleMs: intFromEnv("BRAINFERNO_MCP_AME_IDLE_MS", 10 * 60_000, { allowZero: true }),
+        httpPort: intFromEnv("BRAINFERNO_MCP_HTTP_PORT", file.httpPort ?? 0, { allowZero: true }),
+        httpHost: envValue("BRAINFERNO_MCP_HTTP_HOST") ?? file.httpHost ?? "127.0.0.1",
+        httpToken: envValue("BRAINFERNO_MCP_HTTP_TOKEN") ?? file.httpToken ?? "",
+        enabledApps: parseApps(envValue("BRAINFERNO_MCP_APPS"), file.enabledApps ?? INSTALLABLE_APPS),
+        logLevel: logLevelFromEnv(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/drivers/ame-webservice.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Adobe Media Encoder's built-in "Remote AME" web service
+ * (`ame_webservice_console.exe`, shipped with every AME since CC 2014).
+ *
+ * The console starts a hidden AME renderer and serves a tiny XML-over-HTTP
+ * API: GET /server, GET/POST/DELETE /job, GET /history. One job at a time;
+ * sources can be media files, a .prproj (+ sequence GUID) or FCP XML; the
+ * encoder settings come from an .epr preset. Verified on AME 26.3.2 (Windows):
+ * listener up in ~5 s, a WAV→MP3 job accepted and finished in <5 s.
+ *
+ * Facts this driver is built on:
+ * - The service binds the address in `ame_webservice_config.ini` beside the
+ *   exe; with `ip` unset it picks a LAN adapter, not loopback. We probe every
+ *   local IPv4 address for the configured port.
+ * - Killing the console leaves the renderer alive: stop with a tree kill.
+ * - Job status strings seen: Queued, Encoding, Success; failures carry
+ *   "Fail"/"Error" and abort "Abort" in JobStatus, with <Details>.
+ */
+export interface AmeWebServiceOptions {
+    /** Path to ame_webservice_console(.exe); "" = auto-detect. */
+    exePath: string;
+    /** Port override; 0 = read `port` from the ini beside the exe (default 8080). */
+    port: number;
+    /** Extra command-line arguments for the console. */
+    extraArgs: string[];
+    /** Stop the service after this long without a job. 0 = never. */
+    idleMs: number;
+    /** For tests: fixed base URL of an already-running service; skips spawning. */
+    baseUrl?: string;
+}
+export interface AmeServerInfo {
+    serverStatus: string;
+    jobStatus: string;
+    jobId: string;
+    jobProgress: string;
+    details: string;
+    serverIp?: string;
+    serverPort?: string;
+}
+export interface AmeJobInfo {
+    jobId: string;
+    jobStatus: string;
+    jobProgress: string;
+    details: string;
+    sourcePresetPath?: string;
+    sourceFilePath?: string;
+    destinationPath?: string;
+}
+export interface AmeSubmitRequest {
+    sourcePath: string;
+    presetPath: string;
+    destinationPath: string;
+    sequenceGuid?: string;
+    overwrite?: boolean;
+    notificationTarget?: string;
+}
+export declare function isTerminalStatus(status: string): boolean;
+export declare function isSuccessStatus(status: string): boolean;
+/** First text inside <tag>…</tag>, or "" — the payloads are flat XML. */
+export declare function tag(xml: string, name: string): string;
+export declare function parseServer(xml: string): AmeServerInfo;
+export declare function parseJob(xml: string): AmeJobInfo;
+/** History payload: the current job fields plus <CompletedJobs><Job>…</Job></CompletedJobs>. */
+export declare function parseHistory(xml: string): AmeJobInfo[];
+export declare function buildManifest(r: AmeSubmitRequest): string;
+/** Newest "Adobe Media Encoder <year>" console beside the other Adobe apps. */
+export declare function detectConsoleExe(platform?: NodeJS.Platform): Promise<string | null>;
+/** `port = 8080` from the ini beside the exe; 8080 when unreadable. */
+export declare function portFromIni(exePath: string): Promise<number>;
+export declare function httpRequest(baseUrl: string, method: "GET" | "POST" | "DELETE", path: string, body?: string, timeoutMs?: number): Promise<{
+    status: number;
+    text: string;
+}>;
+/** Loopback first, then every non-internal IPv4 address — the service may bind either. */
+export declare function candidateHosts(): string[];
+export declare class AmeWebService {
+    private readonly options;
+    private child;
+    private baseUrl;
+    private idleTimer;
+    private starting;
+    private exe;
+    constructor(options: AmeWebServiceOptions);
+    get address(): string | null;
+    get isRunning(): boolean;
+    /**
+     * Raw node:http on purpose: the service parses header names case-sensitively
+     * and never answers a POST whose `content-length` is lowercase (as `fetch`
+     * sends it). Verified live on 26.3.2.
+     */
+    private http;
+    /** Find a service already answering on any local address (started by us or by the user). */
+    discover(port: number): Promise<string | null>;
+    private resolveExeAndPort;
+    /** Start the console if nothing answers yet; resolves with the base URL. */
+    ensureRunning(): Promise<string>;
+    private touch;
+    server(): Promise<AmeServerInfo>;
+    job(): Promise<AmeJobInfo>;
+    history(): Promise<AmeJobInfo[]>;
+    submit(req: AmeSubmitRequest, opts?: {
+        busyWaitMs?: number;
+        signal?: AbortSignal;
+    }): Promise<AmeJobInfo & {
+        submitResult: string;
+    }>;
+    cancel(jobId: string): Promise<AmeJobInfo>;
+    /** Poll /job until the given job reaches a terminal state. */
+    waitForJob(jobId: string, opts: {
+        timeoutMs: number;
+        signal?: AbortSignal;
+        onProgress?: (j: AmeJobInfo) => void;
+        intervalMs?: number;
+    }): Promise<AmeJobInfo>;
+    /** Stop the console we started (tree kill: the renderer it spawned goes too). */
+    stop(): Promise<void>;
+    get executable(): string | null;
+}

package/dist/drivers/ame-webservice.js

@@ -0,0 +1,356 @@
+import { spawn } from "node:child_process";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { request } from "node:http";
+import { networkInterfaces } from "node:os";
+import { dirname, join } from "node:path";
+import { log } from "../logging.js";
+const TERMINAL = /success|fail|error|abort|cancel/i;
+export function isTerminalStatus(status) {
+    return TERMINAL.test(status);
+}
+export function isSuccessStatus(status) {
+    return /success/i.test(status);
+}
+/** First text inside <tag>…</tag>, or "" — the payloads are flat XML. */
+export function tag(xml, name) {
+    const m = new RegExp(`<${name}>([\\s\\S]*?)</${name}>`).exec(xml);
+    return m ? decodeXml(m[1] ?? "") : "";
+}
+function decodeXml(s) {
+    return s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&").trim();
+}
+function encodeXml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+export function parseServer(xml) {
+    return {
+        serverStatus: tag(xml, "ServerStatus"),
+        jobStatus: tag(xml, "JobStatus"),
+        jobId: tag(xml, "JobId"),
+        jobProgress: tag(xml, "JobProgress"),
+        details: tag(xml, "Details"),
+        ...(tag(xml, "ServerIP") ? { serverIp: tag(xml, "ServerIP") } : {}),
+        ...(tag(xml, "ServerPort") ? { serverPort: tag(xml, "ServerPort") } : {}),
+    };
+}
+export function parseJob(xml) {
+    const j = { jobId: tag(xml, "JobId"), jobStatus: tag(xml, "JobStatus"), jobProgress: tag(xml, "JobProgress"), details: tag(xml, "Details") };
+    for (const [k, t] of [
+        ["sourcePresetPath", "SourcePresetPath"],
+        ["sourceFilePath", "SourceFilePath"],
+        ["destinationPath", "DestinationPath"],
+    ]) {
+        const v = tag(xml, t);
+        if (v)
+            j[k] = v;
+    }
+    return j;
+}
+/** History payload: the current job fields plus <CompletedJobs><Job>…</Job></CompletedJobs>. */
+export function parseHistory(xml) {
+    const out = [];
+    const re = /<Job>([\s\S]*?)<\/Job>/g;
+    let m;
+    while ((m = re.exec(xml)) !== null)
+        out.push(parseJob(m[1] ?? ""));
+    return out;
+}
+export function buildManifest(r) {
+    const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        "<!DOCTYPE manifest>",
+        '<manifest version="1.0">',
+        `<SourcePresetPath>${encodeXml(r.presetPath)}</SourcePresetPath>`,
+        `<SourceFilePath>${encodeXml(r.sourcePath)}</SourceFilePath>`,
+        `<DestinationPath>${encodeXml(r.destinationPath)}</DestinationPath>`,
+    ];
+    if (r.overwrite)
+        lines.push("<OverwriteDestinationIfPresent>true</OverwriteDestinationIfPresent>");
+    if (r.sequenceGuid)
+        lines.push(`<SequenceGUID>${encodeXml(r.sequenceGuid)}</SequenceGUID>`);
+    if (r.notificationTarget)
+        lines.push(`<NotificationTarget>${encodeXml(r.notificationTarget)}</NotificationTarget>`);
+    lines.push("</manifest>");
+    return lines.join("\n");
+}
+/** Newest "Adobe Media Encoder <year>" console beside the other Adobe apps. */
+export async function detectConsoleExe(platform = process.platform) {
+    const roots = platform === "win32" ? [join(process.env["ProgramFiles"] ?? "C:\\Program Files", "Adobe")] : platform === "darwin" ? ["/Applications"] : [];
+    for (const root of roots) {
+        let entries;
+        try {
+            entries = await readdir(root);
+        }
+        catch {
+            continue;
+        }
+        const versions = entries.filter((e) => /^Adobe Media Encoder/i.test(e)).sort().reverse();
+        for (const v of versions) {
+            const candidates = platform === "win32" ? [join(root, v, "ame_webservice_console.exe")] : [join(root, v, "ame_webservice_console"), join(root, v, `${v}.app`, "Contents", "MacOS", "ame_webservice_console")];
+            for (const c of candidates) {
+                try {
+                    await stat(c);
+                    return c;
+                }
+                catch {
+                    /* next */
+                }
+            }
+        }
+    }
+    return null;
+}
+/** `port = 8080` from the ini beside the exe; 8080 when unreadable. */
+export async function portFromIni(exePath) {
+    try {
+        const ini = await readFile(join(dirname(exePath), "ame_webservice_config.ini"), "utf8");
+        const m = /^\s*port\s*=\s*(\d+)/m.exec(ini);
+        if (m)
+            return Number(m[1]);
+    }
+    catch {
+        /* fall through */
+    }
+    return 8080;
+}
+export function httpRequest(baseUrl, method, path, body, timeoutMs = 15_000) {
+    const url = new URL(baseUrl + path);
+    return new Promise((resolve, reject) => {
+        const headers = { Host: url.host, Connection: "close" };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/xml";
+            headers["Content-Length"] = Buffer.byteLength(body);
+        }
+        const req = request({ host: url.hostname, port: Number(url.port) || 80, method, path: url.pathname + url.search, headers }, (res) => {
+            let text = "";
+            res.setEncoding("utf8");
+            res.on("data", (d) => (text += d));
+            res.on("end", () => resolve({ status: res.statusCode ?? 0, text }));
+        });
+        req.setTimeout(timeoutMs, () => req.destroy(new Error(`Media Encoder web service did not answer ${method} ${path} within ${Math.round(timeoutMs / 1000)} s`)));
+        req.on("error", reject);
+        req.end(body);
+    });
+}
+/** Loopback first, then every non-internal IPv4 address — the service may bind either. */
+export function candidateHosts() {
+    const hosts = ["127.0.0.1"];
+    for (const list of Object.values(networkInterfaces())) {
+        for (const i of list ?? []) {
+            if (i.family === "IPv4" && !i.internal && !hosts.includes(i.address))
+                hosts.push(i.address);
+        }
+    }
+    return hosts;
+}
+export class AmeWebService {
+    options;
+    child = null;
+    baseUrl = null;
+    idleTimer = null;
+    starting = null;
+    exe = null;
+    constructor(options) {
+        this.options = options;
+        if (options.baseUrl)
+            this.baseUrl = options.baseUrl;
+    }
+    get address() {
+        return this.baseUrl;
+    }
+    get isRunning() {
+        return this.baseUrl !== null;
+    }
+    /**
+     * Raw node:http on purpose: the service parses header names case-sensitively
+     * and never answers a POST whose `content-length` is lowercase (as `fetch`
+     * sends it). Verified live on 26.3.2.
+     */
+    http(method, path, body, timeoutMs = 15_000) {
+        if (!this.baseUrl)
+            return Promise.reject(new Error("Media Encoder web service is not running."));
+        return httpRequest(this.baseUrl, method, path, body, timeoutMs);
+    }
+    /** Find a service already answering on any local address (started by us or by the user). */
+    async discover(port) {
+        for (const host of candidateHosts()) {
+            const url = `http://${host}:${port}`;
+            try {
+                const res = await httpRequest(url, "GET", "/server", undefined, 1500);
+                if (res.status === 200 && /<ServerStatus>/.test(res.text))
+                    return url;
+            }
+            catch {
+                /* not here */
+            }
+        }
+        return null;
+    }
+    async resolveExeAndPort() {
+        const exe = this.options.exePath || (await detectConsoleExe());
+        const port = this.options.port || (exe ? await portFromIni(exe) : 8080);
+        return { exe, port };
+    }
+    /** Start the console if nothing answers yet; resolves with the base URL. */
+    async ensureRunning() {
+        if (this.baseUrl) {
+            try {
+                await this.http("GET", "/server", undefined, 3000);
+                this.touch();
+                return this.baseUrl;
+            }
+            catch {
+                this.baseUrl = null;
+            }
+        }
+        if (this.starting)
+            return this.starting;
+        this.starting = (async () => {
+            const { exe, port } = await this.resolveExeAndPort();
+            const found = await this.discover(port);
+            if (found) {
+                this.baseUrl = found;
+                log.info(`Media Encoder web service already running at ${found}`);
+                this.touch();
+                return found;
+            }
+            if (!exe)
+                throw new Error("Adobe Media Encoder's ame_webservice_console was not found. Install Media Encoder or set BRAINFERNO_MCP_AME_WEBSERVICE to its path.");
+            this.exe = exe;
+            log.info(`starting Media Encoder web service: ${exe} ${this.options.extraArgs.join(" ")}`);
+            this.child = spawn(exe, this.options.extraArgs, { stdio: "ignore", windowsHide: true, detached: process.platform !== "win32" });
+            this.child.on("exit", (code) => {
+                log.info(`Media Encoder web service exited (${code})`);
+                this.child = null;
+                this.baseUrl = null;
+            });
+            const deadline = Date.now() + 120_000;
+            while (Date.now() < deadline) {
+                await new Promise((r) => setTimeout(r, 2000));
+                if (!this.child)
+                    throw new Error("Media Encoder web service exited during startup.");
+                const url = await this.discover(port);
+                if (url) {
+                    this.baseUrl = url;
+                    this.touch();
+                    log.info(`Media Encoder web service up at ${url}`);
+                    return url;
+                }
+            }
+            await this.stop();
+            throw new Error(`Media Encoder web service did not answer on port ${port} within 120 s.`);
+        })();
+        try {
+            return await this.starting;
+        }
+        finally {
+            this.starting = null;
+        }
+    }
+    touch() {
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        if (this.options.idleMs > 0 && this.child) {
+            this.idleTimer = setTimeout(() => {
+                void this.stop().catch(() => undefined);
+            }, this.options.idleMs);
+            this.idleTimer.unref();
+        }
+    }
+    async server() {
+        const r = await this.http("GET", "/server");
+        this.touch();
+        return parseServer(r.text);
+    }
+    async job() {
+        const r = await this.http("GET", "/job");
+        this.touch();
+        return parseJob(r.text);
+    }
+    async history() {
+        const r = await this.http("GET", "/history");
+        this.touch();
+        return parseHistory(r.text);
+    }
+    async submit(req, opts = {}) {
+        const manifest = buildManifest(req);
+        const deadline = Date.now() + (opts.busyWaitMs ?? 30 * 60_000);
+        for (;;) {
+            // The service loads the source before answering; a .prproj comes in through
+            // Dynamic Link and can take minutes on a cold renderer.
+            const r = await this.http("POST", "/job", manifest, 10 * 60_000);
+            this.touch();
+            const info = parseJob(r.text);
+            const submitResult = tag(r.text, "SubmitResult") || (r.status === 200 ? "Accepted" : `HTTP ${r.status}`);
+            if (r.status === 200 && /accept/i.test(submitResult))
+                return { ...info, submitResult };
+            // One job at a time: "Busy" while another job (maybe submitted elsewhere) runs.
+            if (/busy/i.test(submitResult) && Date.now() < deadline && !opts.signal?.aborted) {
+                await new Promise((res) => setTimeout(res, 3000));
+                continue;
+            }
+            throw new Error(`Media Encoder refused the job (${submitResult}): ${info.details || r.text.slice(0, 300)}`);
+        }
+    }
+    async cancel(jobId) {
+        const r = await this.http("DELETE", `/job?jobID=${encodeURIComponent(jobId)}`);
+        this.touch();
+        return parseJob(r.text);
+    }
+    /** Poll /job until the given job reaches a terminal state. */
+    async waitForJob(jobId, opts) {
+        const deadline = Date.now() + opts.timeoutMs;
+        let last = null;
+        while (Date.now() < deadline) {
+            if (opts.signal?.aborted) {
+                await this.cancel(jobId).catch(() => undefined);
+                throw new Error("Media Encoder job cancelled");
+            }
+            const j = await this.job();
+            if (j.jobId === jobId || (!j.jobId && last)) {
+                last = j.jobId ? j : last;
+                if (j.jobId === jobId) {
+                    opts.onProgress?.(j);
+                    if (isTerminalStatus(j.jobStatus))
+                        return j;
+                }
+            }
+            if (j.jobId && j.jobId !== jobId && last && isTerminalStatus(last.jobStatus))
+                return last;
+            await new Promise((r) => setTimeout(r, opts.intervalMs ?? 1500));
+        }
+        throw new Error(`Media Encoder job ${jobId} did not finish within ${Math.round(opts.timeoutMs / 1000)} s (last status: ${last?.jobStatus ?? "unknown"}).`);
+    }
+    /** Stop the console we started (tree kill: the renderer it spawned goes too). */
+    async stop() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+        const child = this.child;
+        this.child = null;
+        this.baseUrl = this.options.baseUrl ?? null;
+        if (!child || child.pid === undefined)
+            return;
+        log.info("stopping Media Encoder web service");
+        if (process.platform === "win32") {
+            await new Promise((resolve) => {
+                const k = spawn("taskkill", ["/PID", String(child.pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+                k.on("close", () => resolve());
+                k.on("error", () => resolve());
+            });
+        }
+        else {
+            try {
+                process.kill(-child.pid, "SIGTERM");
+            }
+            catch {
+                child.kill("SIGTERM");
+            }
+        }
+    }
+    get executable() {
+        return this.exe;
+    }
+}
+//# sourceMappingURL=ame-webservice.js.map