@kenkaiiii/gg-editor 0.1.0

package/dist/core/hosts/premiere/ws-bridge.js

@@ -0,0 +1,303 @@
+/**
+ * WebSocket transport for the Premiere bridge — used by the **UXP** plugin.
+ *
+ * Why this exists separately from `PremiereHttpBridge`:
+ *
+ *   UXP plugins **cannot listen on TCP ports**. Adobe sandboxes the Node-ish
+ *   runtime they expose — `require("ws").Server` and `http.createServer` are
+ *   not reachable. So unlike the CEP path (panel = HTTP server, ggeditor =
+ *   HTTP client), the UXP path **flips the transport**:
+ *
+ *     - ggeditor (this side) hosts a localhost WebSocket server.
+ *     - The UXP plugin connects out to it on launch and stays connected.
+ *     - RPC requests flow ggeditor → plugin; responses come back on the same
+ *       socket, correlated by an integer `id`.
+ *
+ * Wire shape (mirrors the HTTP /rpc shape so the adapter doesn't care):
+ *
+ *   plugin → server (initial frame, exactly once):
+ *     { kind: "hello", product, panelKind: "uxp", version }
+ *
+ *   server → plugin (per RPC):
+ *     { id: "1", method: "get_timeline", params: {} }
+ *
+ *   plugin → server (response):
+ *     { id: "1", ok: true, result: ... }
+ *     { id: "1", ok: false, error: "..." }
+ *
+ * The bridge surfaces the same `health()` / `call()` API as `PremiereHttpBridge`
+ * so the dispatcher in `bridge.ts` can treat both transports uniformly.
+ */
+import { createServer } from "node:http";
+import { WebSocketServer } from "ws";
+const DEFAULT_PORT = 7437;
+const FALLBACK_PORTS = [7438, 7439, 7440, 7441, 7442, 7443];
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_HELLO_TIMEOUT_MS = 1500;
+/**
+ * Hosts a localhost WebSocket server. The Premiere UXP plugin connects out.
+ * Exactly one active socket at a time — if a second client connects, the
+ * older one is dropped (most recent connection wins, matches the "user
+ * relaunched the panel" expectation).
+ */
+export class PremiereWsBridge {
+    desiredPort;
+    host;
+    fallbackPorts;
+    httpServer;
+    wss;
+    boundPort;
+    socket;
+    hello;
+    waitingForHello = [];
+    nextId = 1;
+    pending = new Map();
+    constructor(opts = {}) {
+        this.desiredPort =
+            opts.port ??
+                (process.env.GG_EDITOR_PREMIERE_PORT
+                    ? parseInt(process.env.GG_EDITOR_PREMIERE_PORT, 10)
+                    : DEFAULT_PORT);
+        this.host = opts.host ?? DEFAULT_HOST;
+        this.fallbackPorts = opts.fallbackPorts ?? FALLBACK_PORTS;
+    }
+    /**
+     * The port the WS server is actually bound to (after fallback resolution).
+     * Undefined until `start()` resolves.
+     */
+    getPort() {
+        return this.boundPort;
+    }
+    /**
+     * Start the WS server. Tries `desiredPort` first, then each `fallbackPorts`
+     * entry. Resolves once a port is bound; rejects if every candidate is busy.
+     */
+    async start() {
+        if (this.boundPort !== undefined)
+            return this.boundPort;
+        const candidates = [this.desiredPort, ...this.fallbackPorts];
+        let lastErr;
+        for (const p of candidates) {
+            try {
+                await this.listenOn(p);
+                this.boundPort = p;
+                return p;
+            }
+            catch (e) {
+                lastErr = e;
+            }
+        }
+        throw new Error(`Could not bind WS server on any of ${candidates.join(", ")}: ` +
+            (lastErr?.message ?? "unknown"));
+    }
+    listenOn(port) {
+        return new Promise((resolve, reject) => {
+            const http = createServer();
+            const wss = new WebSocketServer({ server: http });
+            wss.on("connection", (ws) => this.onConnection(ws));
+            const onError = (err) => {
+                http.removeListener("error", onError);
+                try {
+                    wss.close();
+                }
+                catch {
+                    /* */
+                }
+                try {
+                    http.close();
+                }
+                catch {
+                    /* */
+                }
+                reject(err);
+            };
+            http.once("error", onError);
+            http.listen(port, this.host, () => {
+                http.removeListener("error", onError);
+                this.httpServer = http;
+                this.wss = wss;
+                resolve();
+            });
+        });
+    }
+    onConnection(ws) {
+        // Most-recent-wins: drop any prior socket so we never have two plugins
+        // racing to handle the same RPC id.
+        if (this.socket && this.socket !== ws) {
+            try {
+                this.socket.close(1000, "replaced by new client");
+            }
+            catch {
+                /* */
+            }
+        }
+        this.socket = ws;
+        this.hello = undefined;
+        ws.on("message", (data) => this.onMessage(ws, data.toString("utf8")));
+        ws.on("close", () => {
+            if (this.socket === ws) {
+                this.socket = undefined;
+                this.hello = undefined;
+                // Don't reject pending calls here — the plugin may reconnect quickly.
+                // The call's AbortSignal / timeout is the user's escape hatch.
+            }
+        });
+        ws.on("error", () => {
+            // Per `ws` docs, 'close' will follow.
+        });
+    }
+    onMessage(ws, raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (msg.kind === "hello") {
+            const hello = {
+                ok: true,
+                product: typeof msg.product === "string" ? msg.product : "gg-editor-premiere-panel",
+                port: this.boundPort ?? this.desiredPort,
+                kind: msg.panelKind === "cep" ? "cep" : "uxp",
+                ...(typeof msg.version === "string" ? { version: msg.version } : {}),
+            };
+            this.hello = hello;
+            const waiters = this.waitingForHello.splice(0);
+            for (const w of waiters)
+                w(hello);
+            return;
+        }
+        if (typeof msg.id !== "string")
+            return;
+        const pending = this.pending.get(msg.id);
+        if (!pending)
+            return;
+        this.pending.delete(msg.id);
+        if (pending.signal && pending.abortListener) {
+            pending.signal.removeEventListener("abort", pending.abortListener);
+        }
+        if (msg.ok === true) {
+            pending.resolve(msg.result);
+        }
+        else {
+            pending.reject(new Error(typeof msg.error === "string" ? msg.error : "panel error"));
+        }
+        void ws; // keep param for signature symmetry
+    }
+    /**
+     * Wait for the hello frame from a connected plugin. Returns the hello
+     * payload (mirrors `PanelHealth` so `bridge.ts` can treat WS + HTTP the
+     * same), or null if no plugin connects within `timeoutMs`.
+     */
+    async health(timeoutMs = DEFAULT_HELLO_TIMEOUT_MS) {
+        if (this.hello)
+            return this.hello;
+        return new Promise((resolve) => {
+            let settled = false;
+            const t = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                const idx = this.waitingForHello.indexOf(once);
+                if (idx >= 0)
+                    this.waitingForHello.splice(idx, 1);
+                resolve(null);
+            }, timeoutMs);
+            const once = (h) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(t);
+                resolve(h);
+            };
+            this.waitingForHello.push(once);
+        });
+    }
+    /**
+     * Round-trip an RPC. Throws if no plugin is connected, the call is
+     * aborted, or the plugin returns an error response.
+     */
+    async call(method, params = {}, opts = {}) {
+        if (opts.signal?.aborted) {
+            throw Object.assign(new Error("call aborted before send"), { name: "AbortError" });
+        }
+        if (!this.socket || this.socket.readyState !== this.socket.OPEN) {
+            throw new Error("Premiere UXP plugin not connected");
+        }
+        const id = String(this.nextId++);
+        const ws = this.socket;
+        return new Promise((resolve, reject) => {
+            const abortListener = () => {
+                if (!this.pending.has(id))
+                    return;
+                this.pending.delete(id);
+                reject(Object.assign(new Error("call aborted"), { name: "AbortError" }));
+            };
+            const entry = {
+                resolve: (v) => resolve(v),
+                reject,
+            };
+            if (opts.signal) {
+                entry.signal = opts.signal;
+                entry.abortListener = abortListener;
+                opts.signal.addEventListener("abort", abortListener, { once: true });
+            }
+            this.pending.set(id, entry);
+            try {
+                ws.send(JSON.stringify({ id, method, params }));
+            }
+            catch (e) {
+                this.pending.delete(id);
+                if (opts.signal)
+                    opts.signal.removeEventListener("abort", abortListener);
+                reject(e);
+            }
+        });
+    }
+    /**
+     * Stop accepting connections, close the active socket, and reject all
+     * pending calls. Safe to call multiple times.
+     */
+    shutdown() {
+        for (const [, p] of this.pending) {
+            if (p.signal && p.abortListener)
+                p.signal.removeEventListener("abort", p.abortListener);
+            p.reject(new Error("bridge shutting down"));
+        }
+        this.pending.clear();
+        const waiters = this.waitingForHello.splice(0);
+        for (const w of waiters)
+            w(null);
+        if (this.socket) {
+            try {
+                this.socket.close(1001, "going away");
+            }
+            catch {
+                /* */
+            }
+            this.socket = undefined;
+        }
+        if (this.wss) {
+            try {
+                this.wss.close();
+            }
+            catch {
+                /* */
+            }
+            this.wss = undefined;
+        }
+        if (this.httpServer) {
+            try {
+                this.httpServer.close();
+            }
+            catch {
+                /* */
+            }
+            this.httpServer = undefined;
+        }
+        this.boundPort = undefined;
+        this.hello = undefined;
+    }
+}
+//# sourceMappingURL=ws-bridge.js.map

package/dist/core/hosts/premiere/ws-bridge.js.map

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

package/dist/core/hosts/premiere/ws-bridge.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ws-bridge.test.d.ts.map

package/dist/core/hosts/premiere/ws-bridge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-bridge.test.d.ts","sourceRoot":"","sources":["../../../../src/core/hosts/premiere/ws-bridge.test.ts"],"names":[],"mappings":""}

package/dist/core/hosts/premiere/ws-bridge.test.js

@@ -0,0 +1,146 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { WebSocket } from "ws";
+import { PremiereWsBridge } from "./ws-bridge.js";
+/**
+ * Stand up the bridge on an ephemeral port range and connect a real `ws`
+ * client. Verifies:
+ *   - hello frame propagates to health()
+ *   - health() returns null when no plugin connects within the timeout
+ *   - call() round-trips id-keyed RPC
+ *   - call() throws when the plugin returns ok:false
+ *   - call() aborts cleanly on AbortSignal
+ *   - shutdown() rejects pending calls and unbinds the port
+ */
+let bridges = [];
+let clients = [];
+afterEach(async () => {
+    for (const c of clients) {
+        try {
+            c.close();
+        }
+        catch {
+            /* */
+        }
+    }
+    clients = [];
+    for (const b of bridges)
+        b.shutdown();
+    bridges = [];
+});
+function makeBridge() {
+    // Use a high random port range so we don't fight the real default.
+    const base = 17000 + Math.floor(Math.random() * 1000);
+    const b = new PremiereWsBridge({
+        port: base,
+        fallbackPorts: [base + 1, base + 2, base + 3, base + 4],
+    });
+    bridges.push(b);
+    return b;
+}
+function connect(port) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://127.0.0.1:${port}`);
+        clients.push(ws);
+        ws.once("open", () => resolve(ws));
+        ws.once("error", reject);
+    });
+}
+describe("PremiereWsBridge", () => {
+    it("start() binds to the desired port (or a fallback)", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        expect(typeof port).toBe("number");
+        expect(b.getPort()).toBe(port);
+    });
+    it("health() returns the hello payload after the plugin connects", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        const ws = await connect(port);
+        ws.send(JSON.stringify({
+            kind: "hello",
+            product: "gg-editor-premiere-panel",
+            panelKind: "uxp",
+            version: "0.2.0",
+        }));
+        const h = await b.health(2000);
+        expect(h?.ok).toBe(true);
+        expect(h?.kind).toBe("uxp");
+        expect(h?.product).toBe("gg-editor-premiere-panel");
+        expect(h?.version).toBe("0.2.0");
+        expect(h?.port).toBe(port);
+    });
+    it("health() returns null when no plugin connects within the timeout", async () => {
+        const b = makeBridge();
+        await b.start();
+        const h = await b.health(50);
+        expect(h).toBeNull();
+    });
+    it("call() round-trips a method invocation", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        const ws = await connect(port);
+        ws.send(JSON.stringify({ kind: "hello", product: "stub", panelKind: "uxp" }));
+        await b.health(2000);
+        ws.on("message", (data) => {
+            const msg = JSON.parse(data.toString("utf8"));
+            ws.send(JSON.stringify({
+                id: msg.id,
+                ok: true,
+                result: { method: msg.method, doubled: (msg.params.x ?? 0) * 2 },
+            }));
+        });
+        const r = await b.call("get_timeline", { x: 21 });
+        expect(r).toEqual({ method: "get_timeline", doubled: 42 });
+    });
+    it("call() rejects when the plugin returns ok:false", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        const ws = await connect(port);
+        ws.send(JSON.stringify({ kind: "hello", product: "stub", panelKind: "uxp" }));
+        await b.health(2000);
+        ws.on("message", (data) => {
+            const msg = JSON.parse(data.toString("utf8"));
+            ws.send(JSON.stringify({ id: msg.id, ok: false, error: "boom" }));
+        });
+        await expect(b.call("ping")).rejects.toThrow(/boom/);
+    });
+    it("call() throws when no plugin is connected", async () => {
+        const b = makeBridge();
+        await b.start();
+        await expect(b.call("ping")).rejects.toThrow(/not connected/);
+    });
+    it("call() honours an AbortSignal that fires while waiting for a reply", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        const ws = await connect(port);
+        ws.send(JSON.stringify({ kind: "hello", product: "stub", panelKind: "uxp" }));
+        await b.health(2000);
+        // Plugin never replies — abort while we wait.
+        const ctrl = new AbortController();
+        const p = b.call("ping", {}, { signal: ctrl.signal });
+        setTimeout(() => ctrl.abort(), 20);
+        await expect(p).rejects.toMatchObject({ name: "AbortError" });
+    });
+    it("shutdown() rejects pending calls and unbinds the port", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        const ws = await connect(port);
+        ws.send(JSON.stringify({ kind: "hello", product: "stub", panelKind: "uxp" }));
+        await b.health(2000);
+        const p = b.call("ping");
+        b.shutdown();
+        await expect(p).rejects.toThrow(/shutting down/);
+        expect(b.getPort()).toBeUndefined();
+    });
+    it("most-recent-wins: a new connection drops the previous one", async () => {
+        const b = makeBridge();
+        const port = await b.start();
+        const first = await connect(port);
+        const closed = new Promise((resolve) => first.once("close", () => resolve()));
+        const second = await connect(port);
+        second.send(JSON.stringify({ kind: "hello", product: "stub", panelKind: "uxp" }));
+        await b.health(2000);
+        await closed; // first socket got closed by the bridge
+    });
+});
+//# sourceMappingURL=ws-bridge.test.js.map

package/dist/core/hosts/premiere/ws-bridge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-bridge.test.js","sourceRoot":"","sources":["../../../../src/core/hosts/premiere/ws-bridge.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;;;;;;GASG;AAEH,IAAI,OAAO,GAAuB,EAAE,CAAC;AACrC,IAAI,OAAO,GAAgB,EAAE,CAAC;AAE9B,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,KAAK;QACP,CAAC;IACH,CAAC;IACD,OAAO,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtC,OAAO,GAAG,EAAE,CAAC;AACf,CAAC,CAAC,CAAC;AAEH,SAAS,UAAU;IACjB,mEAAmE;IACnE,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,IAAI,gBAAgB,CAAC;QAC7B,IAAI,EAAE,IAAI;QACV,aAAa,EAAE,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC;KACxD,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CACL,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,0BAA0B;YACnC,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,OAAO;SACjB,CAAC,CACH,CAAC;QACF,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACpD,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAErB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAI3C,CAAC;YACF,EAAE,CAAC,IAAI,CACL,IAAI,CAAC,SAAS,CAAC;gBACb,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE;aACjE,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAsC,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAErB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAmB,CAAC;YAChE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAErB,8CAA8C;QAC9C,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAErB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,MAAM,CAAC,CAAC,wCAAwC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/hosts/resolve/adapter.d.ts

@@ -0,0 +1,99 @@
+import type { ClipInfo, Frame, FrameRange, HostCapabilities, MarkerInfo, TimelineState } from "../../../types.js";
+import { type VideoHost } from "../types.js";
+/**
+ * DaVinci Resolve adapter.
+ *
+ * Drives Resolve through a long-lived Python sidecar (see ./bridge.ts and
+ * ./bridge-source.ts). The sidecar imports DaVinciResolveScript and exposes
+ * a JSON-line RPC over stdin/stdout. One process is shared across the whole
+ * session — first call pays the spawn cost (~300ms), all subsequent calls
+ * are sub-50ms round trips.
+ *
+ * Requirements:
+ *   - Resolve Studio (free version does not expose the API externally)
+ *   - DaVinci Resolve running with a project + timeline open
+ *   - Preferences → System → General → "External scripting using" set to Local
+ *   - Python 3 on PATH (python3 / python / py -3 — auto-detected)
+ *
+ * Capability map (verified against Resolve 20 API docs):
+ *   - canMoveClips: false (API only supports append-to-end)
+ *   - canScriptColor: true (nodes, LUTs, CDLs, primary corrections)
+ *   - canScriptAudio: false (Fairlight is essentially closed)
+ *   - canTriggerAI: partial (Magic Mask trigger only; transcribe returns bool)
+ *   - preferredImportFormat: edl (also FCPXML, AAF, DRT)
+ */
+export declare class ResolveAdapter implements VideoHost {
+    readonly name: "resolve";
+    readonly displayName = "DaVinci Resolve";
+    private cachedCapabilities?;
+    private bridge;
+    capabilities(): Promise<HostCapabilities>;
+    getTimeline(): Promise<TimelineState>;
+    addMarker(marker: MarkerInfo): Promise<void>;
+    cutAt(_track: number, _frame: Frame): Promise<void>;
+    rippleDelete(_track: number, _range: FrameRange): Promise<void>;
+    appendClip(track: number, mediaPath: string): Promise<ClipInfo>;
+    importTimeline(filePath: string): Promise<void>;
+    render(opts: {
+        preset: string;
+        output: string;
+    }): Promise<void>;
+    getMarkers(): Promise<MarkerInfo[]>;
+    createTimeline(opts: {
+        name: string;
+        fps: number;
+        width?: number;
+        height?: number;
+    }): Promise<void>;
+    importToMediaPool(paths: string[], bin?: string): Promise<void>;
+    setClipSpeed(clipId: string, speed: number): Promise<void>;
+    applyLut(clipId: string, lutPath: string, nodeIndex?: number): Promise<void>;
+    setPrimaryCorrection(clipId: string, cdl: {
+        slope?: [number, number, number];
+        offset?: [number, number, number];
+        power?: [number, number, number];
+        saturation?: number;
+        nodeIndex?: number;
+    }): Promise<void>;
+    copyGrade(sourceClipId: string, targetClipIds: string[]): Promise<void>;
+    listRenderPresets(): Promise<string[]>;
+    replaceClip(clipId: string, mediaPath: string): Promise<void>;
+    cloneTimeline(newName: string): Promise<{
+        name: string;
+    }>;
+    saveProject(): Promise<void>;
+    addTrack(kind: "video" | "audio" | "subtitle"): Promise<{
+        track: number;
+    }>;
+    setClipVolume(clipId: string, volumeDb: number): Promise<void>;
+    insertClipOnTrack(opts: {
+        mediaPath: string;
+        track: number;
+        recordFrame: number;
+        sourceInFrame?: number;
+        sourceOutFrame?: number;
+    }): Promise<ClipInfo>;
+    smartReframe(clipId: string, opts: {
+        aspect: "9:16" | "1:1" | "4:5" | "16:9" | "4:3";
+        frameInterest?: "all" | "keyframes" | "reference-frame";
+        referenceFrame?: number;
+    }): Promise<void>;
+    importSubtitles(srtPath: string): Promise<{
+        imported: boolean;
+        attached: boolean;
+        note?: string;
+    }>;
+    openPage(name: "media" | "cut" | "edit" | "fusion" | "color" | "fairlight" | "deliver"): Promise<void>;
+    /**
+     * Optional: explicitly close the bridge (e.g. on CLI shutdown). The bridge
+     * also dies when the parent process exits, so this is mostly for tests.
+     */
+    shutdown(): void;
+    /**
+     * Pre-flight reachability check. Validates the env we'd hand to the bridge
+     * before we try to spawn it, so capabilities() can report a clear reason
+     * without paying the spawn cost.
+     */
+    private checkReachable;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/core/hosts/resolve/adapter.d.ts.map

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